Connectors
PagerDuty Connector
Ingest PagerDuty incidents and notes into CortexDB.
Tails PagerDuty incidents and their log entries / notes and writes them to CortexDB as experiences.
Two ways to run this connector
Self-hosted — pip install 'cortexdb-connectors[pagerduty]' then cortexdb-sync sync pagerduty.
Managed — CortexDB runs the connector as a worker. See the Connectors overview.
1. Prepare credentials
PagerDuty → Integrations → API Access Keys → create a read-only REST API key and copy it.
What gets written
Each incident (as an issue/observation) and note becomes a POST /v1/experience on the resolved
scope (default org:<org>/source:pagerduty), with an entity reference to the incident and metadata
(status, urgency, service).
Corrected fields
- The
idempotency_keyuses thepd:prefix (pd:<incident_id>:<log_entry_id>). - Notes link to their incident via a
thread=…label, notcontext.preceded_by.
Run it yourself
pip install 'cortexdb-connectors[pagerduty]'
pip install cortexdb-cli && cortexdb init
export PAGERDUTY_API_KEY=... # required
cortexdb-sync --api-url http://localhost:3141 sync pagerduty
cortexdb-sync --api-url http://localhost:3141 watch pagerduty --interval 120