PagerDuty - Extract Environment from Incident Title

This repository contains a webhook, implemented using CloudFlare Workers, which will extract an environment value from the incident title upon incident creation and store the value in a custom field named environment.

Installation

1. Ensure that you have a Custom Field set up with the name environment, a Schema created containing that Field and that the Schema is assigned to the relevant Services in your PagerDuty account.
2. Create a read-write PagerDuty REST API Key.
3. Create a webhook with the expected URL of the webhook. Make note of the generated secret.
4. Deploy the worker by running npm run deploy:production
5. Use wrangler to set these two secrets:

• PD_API_KEY - The REST API Key
• PD_WEBHOOK_SECRET - The secret for the webhook

For example:

$ wrangler secret put PD_API_KEY

Once done, wrangler secret list should show the following:

[
  {
    "name": "PD_API_KEY",
    "type": "secret_text"
  },
  {
    "name": "PD_WEBHOOK_SECRET",
    "type": "secret_text"
  }
]

Logging Setup

This webhook can optionally emit events to AWS EventBridge and have those events routed to AWS CloudWatch. To activate this:

1. Copy terraform.tfvars.sample to terraform.tfvars and edit as necessary.
2. Run terraform plan and terraform apply
3. Run setup-logging-variables-prod.sh to create the relevant secrets in Cloudflare Workers.

This will create a Log Group named /aws/events/extract-environment-from-title-webhook.prod (unless you've changed the event_source variable name)