Repository navigation
docs(integrations): rewrite the Datadog page as a webhook alert-source guide - #147
Merged
Merged
Conversation
…e guide The page described dashboard links from services, which no longer exist. Rewrite it after grafana.md around what OpsiMate does with Datadog today: receiving monitor alerts at POST /api/v1/alerts/custom/datadog. Cover the webhook URL (and the X-API-Token header), setting up the webhook with the in-app custom payload, attaching it to monitors, how the payload is read, auto-resolve on Recovered, tag parsing, severity from tags or priority, and that the Configure form isn't needed for ingestion. Change the front-matter tags to [Alerts] and keep the official resources. Closes OpsiMate/OpsiMate#1091
|
@Apu-Emdad is attempting to deploy a commit to the idan lodzki's projects Team on Vercel. A member of the Team first needs to authorize it. |
Contributor
|
Warning Review limit reachedYou've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository. Next included review available in 59 minutes. View limit details
Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. Comment |
- Use $ALERT_CYCLE_KEY for "id": $ID is a new event ID per notification, so recoveries never matched the triggering alert - Use $ALERT_PRIORITY (monitor priority P1-P5) instead of $PRIORITY (event priority normal/low) for severity - Point the API Documentation link at https://docs.datadoghq.com/api/ - Spell Datadog consistently in the title and resources Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Issue Reference
Closes OpsiMate/OpsiMate#1091
What Was Changed
Rewrote
opsimate-docs/docs/integrations/datadog.md, following the structure ofgrafana.md. I checked it againstcreateCustomDatadogAlert,DatadogAlertWebhookSchemaandDatadogSetupModal.tsxin the main repo:http://<your-opsimate-host>:3001/api/v1/alerts/custom/datadog?api_token={your_api_token}, plus theX-API-Tokenheader alternative (the auth middleware reads either).API_TOKENsection the Grafana page has.opsimate-alerts, paste the URL, then paste the custom payload exactly as the in-app guide shows it. Optionally add"priority": "$PRIORITY"for priority-based severity.@webhook-opsimate-alertsin Notify, then trigger a test.id,titleanddateare required, otherwise HTTP 400.ididentifies and updates the alert.titlebecomes the name andmessagethe summary.linkbecomes a "View in Datadog" link.alert_transitioncontainingRecoveredresolves the alert with the sameid.key:valueentry in$TAGSbecomes a tag, and entries without exactly one:are skipped.severity:tag wins. Otherwise priority is used: P1 → critical, P2–P3 → warning, P4–P5 → info. Unknown or missing → warning.tagschanged from[Links, Monitoring Data]to[Alerts].Why Was It Changed
The page described dashboard links from services, which no longer exist, and said nothing about the webhook that is how OpsiMate actually gets Datadog alerts today.
Screenshots
Previewed locally, and
npm run buildpasses with no broken-link or anchor warnings. A screenshot will be added in a follow-up comment.Additional Context (Optional)
The in-app guide's note still says only "the first tag" from
$TAGSis used. The server actually keeps everykey:valuetag, and this page documents the server behaviour.