Migration Guides

Step 1: Create a11ops Workspaces

Create a workspace for each PagerDuty service you want to migrate:

1. Log in to a11ops dashboard
2. Create a new workspace (e.g., “Production API”, “Database”)
3. Note the workspace API key
4. Add team members who were on the PagerDuty service

Step 2: Update Integration Endpoints

Replace PagerDuty integration URLs with a11ops webhooks:

Step 3: Update Alert Payloads

Modify your alert sending code:

// PagerDuty payload
{
  "routing_key": "YOUR_INTEGRATION_KEY",
  "event_action": "trigger",
  "payload": {
    "summary": "Database CPU high",
    "severity": "error",
    "source": "monitoring",
    "custom_details": { ... }
  }
}

// a11ops payload (simpler!)
{
  "title": "Database CPU high",
  "severity": "high",
  "source": "monitoring",
  "metadata": { ... }
}

Step 4: Test and Validate

1. Send test alerts to verify integration
2. Confirm team members receive notifications
3. Run both systems in parallel for 1-2 days
4. Gradually migrate services one by one
5. Decommission PagerDuty services after validation