Datadog

Overblik

Forbind Datadog, så AI-klienter kan liste monitors, inspicere incidents, søge events og køre korte metric-queries - uden at lime API-nøgler ind i prompts.

Integrationen er read-first. Mute af monitors eller ændring af incidents er ikke tilgængeligt.

Forudsætninger

• En Datadog-konto med ret til at oprette API- og application keys
• En stackgate.ai-konto
• Datadog-sitet for organisationen (US1, US3, US5, EU, AP1, AP2 eller Gov)

Sådan får du credentials

1. Log ind på Datadog på det site, der matcher organisationen (EU: app.datadoghq.eu).
2. Åbn Organization Settings → API Keys og opret eller kopier en API key. Den identificerer organisationen.
3. Åbn Organization Settings → Application Keys og opret en application key. Den er bruger-scopet og kræves til read/management-endpoints.
4. Giv application key mindst disse scopes (navne kan variere lidt pr. site):
   • monitors_read
   • events_read / events read
   • timeseries_query / metrics read
   • incident_read (kræves til Incident Management-værktøjer)
5. I stackgate.ai: åbn Mine integrationer → Datadog.
6. Klik Activate, indsæt API key og application key, og vælg det site, der matcher jeres Datadog-org. Forkert site giver 403 selv med gyldige nøgler.
7. Gem. stackgate.ai tester API-nøglen (/api/v1/validate) og et read-kald med application key, før credentials gemmes.

Se Datadog API-dokumentationen og API and Application Keys.

Credentials-reference

Brug med AI-klienter

• Dedikeret endpoint: POST /mcp/datadog med et Sanctum bearer-token
• Private gateway: én config til alle integrationer - brug datadog__*-navngivne værktøjer
• Business gateway: samme namespaced værktøjer, når Datadog er slået til for virksomheden

Vigtige værktøjer:

• list_monitors, get_monitor - find alerting monitors og inspicér queries
• search_events - events i et påkrævet POSIX start/end-vindue
• query_metrics - timeseries for et påkrævet from/to-vindue (hold det til få timer)
• list_incidents, get_incident - Incident Management-status og commander-kontekst

Efter connect: brug Edit tool access til at begrænse værktøjer (fx kun monitors).

Se Dokumentation for HTTP-autentificering og private gateway.

Test integrationen

List Datadog-monitors, der er i Alert.
Vis events de sidste to timer med tag env:prod.
Query avg:system.cpu.user{*} for den sidste time.
List åbne Datadog-incidents.

Typiske værktøjer: list_monitors, search_events, query_metrics, list_incidents.

Fejlfinding

Datadog rate limits varierer pr. endpoint og org-plan (ofte hundredvis til tusindvis af requests pr. time). Foretræk paginerede list-værktøjer og korte query-vinduer.

Sikkerhed og tilbagekaldelse

• Disconnect i Mine integrationer → Datadog sletter de gemte nøgler fra stackgate.ai.
• Tilbagekald eller rotér nøgler i Datadog Organization Settings → API Keys / Application Keys.
• Nøgler gemmes krypteret. Tool calls audit-logges. Nøgler accepteres aldrig som tool-argumenter.

Begrænsninger

• Read-only MVP: ingen mute-, downtime- eller incident-update-værktøjer.
• Metric- og event-værktøjer kræver et eksplicit tidsvindue.
• Application keys er bruger-scopede; adgang følger brugerens Datadog-rettigheder.
• Gov- og regionale sites skal vælges eksplicit. Der er intet felt til custom base URL.