docs(zabbix): add Trigger on-call pages section#3016
Conversation
Document a JavaScript Webhook media type that forwards Zabbix triggers to Datadog On-Call. The script posts to the V2 webhook intake with the canonical event envelope (matching DataDog/dd-source nagios/success_basecase.json: data.type/data.attributes, integration_id, aggregation_key, nested attributes.status, namespaced zabbix.source) and uses the oncall_team query parameter for routing. Includes a state-to-status mapping (PROBLEM + High/Disaster -> error, Average/Warning/Information/Not-classified -> warn, OK -> ok) and configuration for the media type, user, and action. Tracks BGL-1967. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This comment has been minimized.
This comment has been minimized.
|
Open question for reviewers: the V2 webhook intake VRL ( Worth adding a short "Payload limits" note to this section, or is the sanitizer's fail-open behavior fine to leave undocumented? |
|
Created DOCS-14513 for editorial review. |
@Kyle-Neale As those limits might vary I don't think it's worth documenting for now |
CI's README validator only accepts ASCII; en-dash and em-dash in the state-to-status mapping table were rejected.
Summary
Adds a "Trigger on-call pages" section to
zabbix/README.mddocumenting how to forward Zabbix triggers to Datadog On-Call using theoncall_teamquery parameter on the V2 events webhook intake.Implementation uses a JavaScript Webhook media type (Zabbix's native notification surface, parallel to the existing legacy
Datadogmedia type already documented in the same README). The script builds the V2 envelope client-side, so no VRL transformer is required.Notes for reviewers
DataDog/dd-sourcenagios/success_basecase.json): JSON:API envelope (data.type+data.attributes),integration_id: "zabbix", nestedattributes.status(warn/error/ok), and azabbix.sourcenamespaced object — analogous tonagios.sourcein the canonical example.error; PROBLEM + Warning/Average/Information/Not-classified →warn(no silent drops); OK →ok(resolves the page via sharedaggregation_key).integrations-core#22991(Nagios), same feature family from the EvMgt On-Call swap-and-go RFC.Tracks BGL-1967.
Test plan
🤖 Generated with Claude Code