Potencialize seu agente
Instalação do publicador. Não é um endpoint do PlugMCP.
Host a copy with our keys and logs.
Ainda não há uma versão empacotada no registro. Siga o README do repositório.
URL remota ou um comando na sua máquina? Como as duas instalações diferem
Rodar no PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
AbrirAn MCP (Model Context Protocol) server that lets AI assistants like Claude query Datadog APM for error traces, search logs, and generate actionable debugging workflows.
<UUID>, <TS>, <IP>, <HEX>, <ID>firstOccurrence, lastOccurrence)ServiceErrorView)Requirements: Java 21+, Maven 3.8+
curl -fsSL https://raw.githubusercontent.com/waabox/datadog-mcp-server/main/install.sh | bash
The installer will:
~/.claude/apps/mcp/ (removing older versions)waabox-datadog-mcp as a user-scoped MCP server in ~/.claude.jsontrace.list_error_traces)Search for error traces in a specific service.
Natural Language Prompts:
"List error traces for payment-service from the last hour"
"Show me the last 10 errors in order-service today"
"Find errors in api-gateway between 2pm and 3pm in staging environment"
"What errors occurred in user-service yesterday?"
Parameters:
Example Response:
{
"success": true,
"count": 3,
"traces": [
{
"traceId": "abc123def456789",
"service": "payment-service",
"resourceName": "POST /api/v1/payments",
"errorMessage": "Connection timeout to payment gateway",
"timestamp": "2024-01-15T14:32:15Z",
"duration": "2.45s"
}
]
}
trace.inspect_error_trace)Get detailed diagnostic information about a specific trace, including all spans, logs, and an actionable debugging workflow.
Natural Language Prompts:
"Inspect trace abc123def456789 in payment-service"
"Analyze the error trace xyz789 and help me debug it"
"Show me the full details of trace abc123 from order-service in the last hour"
"Generate a diagnostic workflow for trace def456 in checkout-service"
Parameters:
Example Response:
{
"success": true,
"traceId": "abc123def456789",
"service": "payment-service",
"involvedServices": ["api-gateway", "payment-service", "fraud-detection", "notification-service"],
"totalErrors": 2,
"isDistributedError": true,
"traceSummary": {
"duration": "1.24s",
"spanCount": 28,
"errorSpanCount": 2,
"startTime": "2024-01-15T14:32:15Z"
},
"serviceErrors": [
{
"serviceName": "payment-service",
"errorCount": 1,
"primaryError": "PaymentGatewayException: Connection refused",
"errorTypes": ["PaymentGatewayException"]
},
{
"serviceName": "fraud-detection",
"errorCount": 1,
"primaryError": "TimeoutException: Request timed out after 5000ms",
"errorTypes": ["TimeoutException"]
}
],
"workflow": "# Diagnostic Workflow\n\n## Error Summary\n..."
}
trace.extract_scenario)Extract a structured test scenario from a trace for debugging and unit test generation. This tool analyzes the execution flow and identifies the exact location in the code where the error occurred.
Natural Language Prompts:
"Extract the scenario from trace abc123 in order-service"
"Analyze trace xyz789 and help me create a unit test"
"Show me the execution flow and error location for trace def456"
"What's the test scenario for this failing trace?"
Parameters:
Example Response:
{
"success": true,
"traceId": "abc123def456789",
"entryPoint": {
"method": "POST",
"path": "/api/orders",
"body": "{\"product_id\": \"123\", \"quantity\": 5}"
},
"executionFlow": [
{
"order": 1,
"spanId": "span1",
"service": "api-gateway",
"operation": "POST /api/orders",
"type": "http",
"durationMs": 1240
},
{
"order": 2,
"spanId": "span2",
"parentSpanId": "span1",
"service": "order-service",
"operation": "OrderController.createOrder",
"type": "internal",
"durationMs": 1100
},
{
"order": 3,
"spanId": "span3",
"parentSpanId": "span2",
"service": "order-service",
"operation": "SELECT * FROM products WHERE id = ?",
"type": "db",
"durationMs": 45
},
{
"order": 4,
"spanId": "span4",
"parentSpanId": "span2",
"service": "order-service",
"operation": "OrderService.validateStock",
"type": "internal",
"durationMs": 12,
"isError": true
}
],
"errorContext": {
"service": "order-service",
"operation": "OrderService.validateStock",
"exceptionType": "InsufficientStockException",
"message": "Not enough stock: requested 5, available 2",
"location": {
"className": "com.example.order.OrderService",
"methodName": "validateStock",
"fileName": "OrderService.java",
"lineNumber": 142
},
"spanTags": {
"product_id": "123",
"quantity": "5"
}
},
"relevantData": {
"product_id": "123",
"quantity": "5",
"user_id": "456"
},
"suggestedTestScenario": {
"given": "Data: product_id=123, quantity=5",
"when": "Request: POST /api/orders with body",
"then": "InsufficientStockException is thrown with message 'Not enough stock: requested 5, available 2'"
},
"involvedServices": ["api-gateway", "order-service"],
"stepCount": 4,
"totalDurationMs": 1240
}
Workflow: From Trace to Unit Test
1. User: "Extract scenario from trace abc123 in order-service"
2. Claude analyzes the trace and responds:
"Based on the trace, here's what happened:
Entry Point: POST /api/orders with body {"product_id": "123", "quantity": 5}
Execution Flow:
1. api-gateway → POST /api/orders (1240ms)
2. order-service → OrderController.createOrder (1100ms)
3. order-service → SELECT * FROM products WHERE id = ? (45ms)
4. order-service → OrderService.validateStock ❌ (12ms)
Error: InsufficientStockException at OrderService.java:142
Message: 'Not enough stock: requested 5, available 2'
Where is the order-service codebase? I can look at the code and suggest a unit test."
3. User provides codebase path
4. Claude reads the code and proposes:
"@Test
void whenValidatingStock_givenQuantityExceedsAvailable_shouldThrowException() {
// Given
Product product = new Product("123", "Test Product", 2);
OrderRequest request = new OrderRequest("123", 5);
// When / Then
InsufficientStockException ex = assertThrows(
InsufficientStockException.class,
() -> orderService.validateStock(request, product)
);
assertEquals("Not enough stock: requested 5, available 2", ex.getMessage());
}"
log.search_logs)Search for logs with various filters and optional pattern summarization.
Natural Language Prompts:
"Search ERROR logs in payment-service from the last hour"
"Find all logs mentioning 'timeout' in order-service today"
"Show me WARNING and ERROR logs in api-gateway between 2pm and 4pm"
"Summarize the log patterns in notification-service from yesterday"
"Search logs with query 'user_id:12345' in user-service"
Parameters:
Example Response (full mode):
{
"success": true,
"count": 45,
"logs": [
{
"timestamp": "2024-01-15T14:32:15Z",
"level": "ERROR",
"service": "payment-service",
"message": "Failed to process payment: Connection timeout to gateway.example.com",
"host": "prod-payment-01",
"traceId": "abc123def456789"
}
]
}
Example Response (summarize mode):
{
"success": true,
"totalLogs": 150,
"uniquePatterns": 8,
"groups": [
{
"pattern": "Failed to process payment: Connection timeout to *",
"level": "ERROR",
"count": 45,
"firstOccurrence": "2024-01-15T14:00:00Z",
"lastOccurrence": "2024-01-15T14:45:00Z"
},
{
"pattern": "Request completed successfully in * ms",
"level": "INFO",
"count": 89,
"firstOccurrence": "2024-01-15T14:00:00Z",
"lastOccurrence": "2024-01-15T14:59:00Z"
}
]
}
log.correlate)Find all logs associated with a specific trace ID and optionally include trace details.
Natural Language Prompts:
"Correlate logs for trace abc123 in payment-service"
"Show me all logs related to trace xyz789 from the last hour"
"Get trace details and associated logs for trace def456 in order-service"
"Find logs for trace abc123 without trace details"
Parameters:
Example Response:
{
"success": true,
"traceId": "abc123def456789",
"trace": {
"service": "payment-service",
"resourceName": "POST /api/v1/payments",
"duration": "542.00ms",
"spanCount": 12,
"services": ["api-gateway", "payment-service", "database-service"],
"hasErrors": true
},
"logs": [
{
"timestamp": "2024-01-15T14:32:15.123Z",
"level": "INFO",
"message": "Processing payment request for order #12345"
},
{
"timestamp": "2024-01-15T14:32:15.456Z",
"level": "ERROR",
"message": "Payment gateway returned error: insufficient_funds",
"attributes": {
"order_id": "12345",
"amount": "99.99"
}
}
],
"logCount": 2
}
apm.service_health)Get the health of a service over a time window, compared with the previous window of the same length, with a degraded/not-degraded verdict.
Natural Language Prompts:
"What's the health of payment-service over the last hour?"
"Is order-service degraded right now?"
"Compare checkout-service error rate and latency to the previous hour"
Parameters:
Example Response:
{
"success": true,
"service": "payments",
"env": "prod",
"operation": "servlet.request",
"operationSource": "detected",
"window": {"from": "2026-09-23T13:00:00Z", "to": "2026-09-23T14:00:00Z"},
"baseline": {"from": "2026-09-23T12:00:00Z", "to": "2026-09-23T13:00:00Z"},
"metrics": {
"hits": {"current": 12000, "baseline": 11800, "deltaPct": 1.7},
"errors": {"current": 340, "baseline": 20, "deltaPct": 1600.0},
"errorRate": {"current": 2.83, "baseline": 0.17, "deltaPct": 1564.7},
"latencyP50": {"current": 45.0, "baseline": 42.0, "deltaPct": 7.1},
"latencyP95": {"current": 310.0, "baseline": 290.0, "deltaPct": 6.9},
"latencyP99": {"current": 900.0, "baseline": 850.0, "deltaPct": 5.9}
},
"degraded": true,
"signals": ["error rate 0.17% -> 2.83%"],
"notes": []
}
apm.top_resources)Rank a service's resources (endpoints) by errors, error rate, latency, or traffic.
Natural Language Prompts:
"What are the top failing endpoints in payment-service over the last hour?"
"Rank order-service resources by p95 latency"
"Which checkout-service endpoints get the most traffic?"
Parameters:
Example Response:
{
"success": true,
"service": "payments",
"env": "prod",
"operation": "servlet.request",
"operationSource": "detected",
"window": {"from": "...", "to": "..."},
"sortBy": "errors",
"count": 1,
"resources": [
{"resource": "post_/api/checkout", "hits": 4200, "errors": 310, "errorRate": 7.38,
"latencyP50": 120.0, "latencyP95": 850.0, "latencyP99": 2100.0}
],
"notes": []
}
The API key and application key need the timeseries_query permission in addition to the current APM and logs read permissions.
Resource names in apm.top_resources come from trace metrics, where Datadog normalizes tag values: lowercase, with spaces and braces replaced by _. For example, GET /presales/{eventCode}/validate is returned as get_/presales/_eventcode_/validate. Translate it back before using it in span or log searches.
1. "List error traces for payment-service from the last 30 minutes"
→ Identifies recent errors and their trace IDs
2. "Inspect trace abc123 in payment-service from the last hour"
→ Gets full diagnostic with spans, logs, and workflow
3. "Correlate logs for trace abc123 in payment-service"
→ Shows all logs associated with this specific request
1. "Search ERROR logs in order-service from today, summarize patterns"
→ Groups similar errors to identify patterns
2. "List error traces for order-service from the last 6 hours with limit 50"
→ Gets more traces to analyze the pattern
3. "Inspect trace xyz789 in order-service"
→ Deep dive into a specific occurrence
1. "Inspect trace abc123 in api-gateway from the last hour"
→ Shows all services involved in the distributed trace
2. "Search ERROR logs in downstream-service with query 'trace_id:abc123'"
→ Finds related errors in downstream services
You need two keys from Datadog: an API Key and an Application Key.
MCP Server)abcd1234abcd1234abcd1234abcd1234)Note: The API Key is different from the Key ID. Copy the actual key value, not the UUID.
MCP Server)apm_read - Read APM traces and spanslogs_read_data - Read log datatimeseries_query - Query APM trace metrics (apm.service_health, apm.top_resources)abcd1234abcd1234abcd1234abcd1234abcd1234)Note: Copy the actual key value from the KEY column, not the Key ID.
Set these in your MCP configuration:
git clone https://github.com/waabox/datadog-mcp-server.git
cd datadog-mcp-server
mvn clean package
The JAR appears in:
target/datadog-mcp-server-1.3.0.jar
Add this to your ~/.claude.json:
{
"mcpServers": {
"waabox-datadog-mcp": {
"command": "java",
"args": ["-jar", "/Users/YOUR_USER/.claude/apps/mcp/datadog-mcp-server.jar"],
"env": {
"DATADOG_API_KEY": "your-api-key-here",
"DATADOG_APP_KEY": "your-app-key-here",
"DATADOG_SITE": "datadoghq.com"
}
}
}
}
Replace YOUR_USER with your username and update the keys with your actual Datadog credentials.
You can run the MCP server as a Docker container, which removes the need for a local Java installation.
git clone https://github.com/waabox/datadog-mcp-server.git
cd datadog-mcp-server
docker build -t datadog-mcp-server .
Add this to your ~/.claude.json:
{
"mcpServers": {
"waabox-datadog-mcp": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"--env", "DATADOG_API_KEY=your-api-key-here",
"--env", "DATADOG_APP_KEY=your-app-key-here",
"--env", "DATADOG_SITE=datadoghq.com",
"datadog-mcp-server"
]
}
}
}
Replace the key values with your actual Datadog credentials.
To pick up new changes from the repository, rebuild with --no-cache:
docker build --no-cache -t datadog-mcp-server .
MIT License
LLM-optimized MCP server for Datadog APM, logs, and metrics. Delivers structured, token-efficient trace and log insights designed specifically for AI-driven debugging—not just raw Datadog data.
Ferramentas
Ainda não há lista de ferramentas. Servidores remotos recebem uma após a primeira verificação de saúde.
Perguntas frequentes
Copie nesta página a configuração stdio para Cursor, Claude Desktop, Claude Code ou VS Code. Ela usa a instalação do publicador, não um proxy do PlugMCP.
Este registro não lista nenhuma variável de ambiente obrigatória.
Datadog roda localmente via stdio.
Última verificação: 2026-10-28. LLM-optimized MCP server for Datadog APM, logs, and metrics. Delivers structured, token-efficient trace and log insights designed specifically for AI-driven debugging—not just raw Datadog data.