Datadog MCP Server

Was ist der Datadog MCP Server?

Der Datadog MCP Server ist ein spezieller Server für das Model Context Protocol (MCP), der als Brücke zwischen KI-gestützten Agenten oder LLM-basierten Anwendungen und der Datadog API fungiert. Indem er eine Reihe von MCP-Tools bereitstellt, die auf Datadogs Überwachungs-, Metrik-, Dashboard-, Ereignis-, Protokoll- und Vorfallmanagement-Funktionen gemappt sind, ermöglicht dieser Server standardisierte, sichere und dynamische Interaktionen mit Datadog-Daten. Dadurch werden optimierte Workflows, automatisierte Fehlerbehebung und verbesserte Beobachtungsaufgaben innerhalb von KI-Systemen unterstützt.

So konfigurieren Sie

Um den Datadog MCP Server zu konfigurieren, benötigen Sie:

Node.js (Version 16+)
Datadog API- und Anwendungs-Schlüssel

1. Richten Sie die Anmeldeinformationen mit Umgebungsvariablen ein:

Erstellen Sie eine .env-Datei:

DD_API_KEY=your_api_key_here
DD_APP_KEY=your_app_key_here
DD_SITE=datadoghq.com
DD_LOGS_SITE=datadoghq.com   # optional
DD_METRICS_SITE=datadoghq.com   # optional

ODER

2. Geben Sie die Anmeldeinformationen als Befehlszeilenargumente an:

datadog-mcp-server --apiKey=your_api_key --appKey=your_app_key --site=datadoghq.com

Für mehrregionale oder dienstspezifische Domains verwenden Sie bei Bedarf --logsSite und --metricsSite.
Wenn Sie sich mit Claude Desktop verbinden, schreiben Sie die Konfiguration in claude_desktop_config.json (der Speicherort variiert je nach Betriebssystem). Verwenden Sie entweder die globale Site oder geben Sie logsSite/metricsSite für eine detailliertere Konfiguration an.

So verwenden Sie

Installation
```
npm install -g datadog-mcp-server
```
Oder führen Sie es direkt über npx aus.

Starten Sie den Server

datadog-mcp-server --apiKey=YOUR_API_KEY --appKey=YOUR_APP_KEY --site=YOUR_DD_SITE

Oder verwenden Sie Ihre Umgebungsvariablen (.env).

Integrieren Sie ihn mit Ihrem KI-Agenten, MCP-Client oder einem Tool wie Claude Desktop oder MCP Inspector.
- Konfigurieren Sie die Konfigurationsdatei von Claude Desktop, um diesen Server zu starten (siehe oben).
- Oder führen Sie einen Inspector für die manuelle Erkundung aus:
```
npx @modelcontextprotocol/inspector datadog-mcp-server --apiKey=your_api_key --appKey=your_app_key
```
Greifen Sie auf die Werkzeuge zu
- Verwenden Sie das MCP-Protokoll – z. B. den Endpunkt /tools/list –, um verfügbare Funktionen zu entdecken.
- Rufen Sie Aktionen über den Endpunkt /tools/call auf und übergeben Sie Argumente (siehe Beispiele).

Hauptmerkmale

Vollständige Abdeckung von Datadogs Überwachungs-, Dashboard-, Metrik-, Ereignis-, Protokoll- und Vorfall-APIs über MCP-Tools
Sichere Konfiguration von Anmeldeinformationen und bewährte Praktiken bei der Datenhandhabung
Flexible Endpunktkonfiguration für globale und regionsspezifische Datadog-Sites
Ausführbare MCP-Tools zum Abrufen von Monitoren, Dashboards, Ereignissen und Protokollen sowie zur erweiterten Protokollsuchen und -aggregation
Umfassende Fehlerbehandlung und klare Meldungen bei API- oder Authentifizierungsproblemen
Plug-and-Play-Integration mit KI-Assistenten, Claude Desktop oder benutzerdefinierten MCP-Clients
Leichtgewichtig, einfach auf lokalen Maschinen oder Servern bereitzustellen

Anwendungsfälle

KI-Agenten oder Co-Piloten stellen Überwachungsdaten und Dashboards direkt aus Datadog bereit
Automatisierte Vorfallmanagement-Assistenten rufen kontextbezogene Informationen ab und zeigen Vorfälle oder verwandte Protokolle auf Anfrage an
Alarme und Protokolle können über natürliche Sprachabfragen in LLM-gestützten Workflows abgerufen, gefiltert und aggregiert werden
On-Demand-Metriken-Erkundung und Dashboard-Abruf für Fehlerbehebung oder Berichterstattung
Sofortige Abfrage und Visualisierung von aktuellen Anwendungsfehlern, Zuständen oder Anomalien über MCP-kompatible UIs

FAQ

Q1: Ich erhalte einen Fehler 403 Forbidden beim Ausführen des Servers.

Stellen Sie sicher, dass sowohl der API-Schlüssel als auch der Anwendungs-Schlüssel gültig sind, zum richtigen Datadog-Konto gehören, die erforderlichen Berechtigungen haben und entweder als Umgebungsvariablen oder als Befehlszeilenargumente korrekt gesetzt sind. Überprüfen Sie auch, ob der Endpunkt (--site) mit Ihrer Datadog-Region übereinstimmt.

Q2: Wie verbinde ich den Server mit Claude Desktop oder einem ähnlichen Agenten?

Konfigurieren Sie die claude_desktop_config.json mit dem Eintrag für den Datadog MCP-Server, indem Sie den Befehl und die Argumente mit Ihren Datadog-Anmeldeinformationen und der Region angeben. Stellen Sie sicher, dass Ihre Schlüssel und Endpunkte korrekt sind.

Q3: Kann ich unterschiedliche Endpunkte für Datadog-Protokolle und -Metriken verwenden?

Ja. Geben Sie --logsSite und --metricsSite als Befehlszeilenargumente oder Umgebungsvariablen (DD_LOGS_SITE, DD_METRICS_SITE) an. Dies ist besonders nützlich für Organisationen mit speziellen Endpunkten pro Dienst.

Q4: Ist es sicher, diesen Server auf meinem lokalen Rechner auszuführen?

Ja, der Datadog MCP Server ist für eine sichere lokale Bereitstellung konzipiert. Die Schlüssel werden aus Umgebungsvariablen oder Argumenten gelesen und nicht anderswo gespeichert. Schützen Sie immer Ihre Anmeldeinformationen.

Q5: Was soll ich tun, wenn meine Abfragen keine Ergebnisse zurückgeben oder inkorrekt erscheinen?

Überprüfen Sie die Syntax und Filter für Ihre Abfragen (z. B. Zeitrahmen, Status, Dienstnamen). Stellen Sie sicher, dass Ihre Schlüssel Zugriff auf die relevanten Daten haben und dass die gesetzten Endpunkte mit der Region Ihrer Daten übereinstimmen.

Tool Name	Beschreibung
get-monitors	Ruft eine Liste von Monitoren ab, die optional nach Zuständen oder Tags gefiltert werden kann, und unterstützt die Begrenzung der Ergebnisse für eine gezielte Übersicht über den Monitorstatus.
get-monitor	Ruft detaillierte Informationen für einen bestimmten Monitor anhand seiner Datadog-Überwachungs-ID ab, einschließlich Konfiguration und aktuellem Zustand.
get-dashboards	Listet alle Dashboards auf, die in Ihrem Datadog-Konto zugänglich sind, für umfassende Erkundung oder Enumeration.
get-dashboard	Gibt die vollständige Definition und Details eines bestimmten Dashboards anhand seiner Dashboard-ID zurück und unterstützt tiefere Einblicke und Integrationen.
get-metrics	Zählt verfügbare Metriken, einschließlich Namen und grundlegender Metadaten für in Datadog verfügbare Metriken.
get-metric-metadata	Ruft vollständige Metadaten für eine bestimmte Datadog-Metrik ab, einschließlich Beschreibung, Typ und unterstützte Abfrageoptionen.
get-events	Durchsucht Datadog-Ereignisse innerhalb eines bestimmten Zeitrahmens mit optionalen Filtern für Ereignistyp oder Attribute.
get-incidents	Ruft eine Liste aktueller oder vergangener Vorfälle im Datadog Incident Management ab und ermöglicht das Abfragen und Filtern nach Zustand oder anderen Kriterien.
search-logs	Führt eine Protokollsuchen mit erweiterten Abfragefiltern, Sortierung und Ergebnisschätzung durch – ideal für Debugging oder Audit-Flows.
aggregate-logs	Führt Analysen und Aggregationsabfragen über Protokolle aus, sodass Gruppenzählungen, erweiterte Berechnungen und Aufschlüsselungen nach Feldern (Facetten) ermöglicht werden.