Datadog - AgentCat

Overview

Integrate AgentCat with Datadog for monitoring and alerting. Events are sent as both logs and metrics for comprehensive observability.

Prerequisites

A Datadog account with an API key
Your Datadog site (e.g., datadoghq.com for US, datadoghq.eu for EU)

Configuration

agentcat.track(server, null, {
  exporters: {
    datadog: {
      type: "datadog",
      apiKey: process.env.DD_API_KEY,
      site: "datadoghq.com",
      service: "my-mcp-server",
      env: "production"
    }
  }
})

agentcat.track(server, None, agentcat.AgentCatOptions(
  exporters={
    "datadog": {
      "type": "datadog",
      "api_key": os.getenv("DD_API_KEY"),
      "site": "datadoghq.com",
      "service": "my-mcp-server",
      "env": "production"
    }
  }
))

agentcat.Track(s, "", &agentcat.Options{
    Exporters: map[string]any{
        "datadog": map[string]any{
            "type":    "datadog",
            "apiKey":  os.Getenv("DD_API_KEY"),
            "site":    "datadoghq.com",
            "service": "my-mcp-server",
            "env":     "production",
        },
    },
})

Configuration Fields

Field	Type	Required	Description
`api_key` / `apiKey`	string	Yes	Your Datadog API key
`site`	string	Yes	Datadog site (e.g., “datadoghq.com”, “datadoghq.eu”)
`service`	string	Yes	Service name for grouping
`env`	string	No	Environment name (default: “production”)

Field Mapping

Trace and Span IDs

AgentCat Field	Datadog Field	Format
`session_id`	`trace_id`	Numeric - last 64 bits of SHA256 hash
`event_id`	`span_id`	Numeric - SHA256 hash

Logs

Each event creates a log entry with the following structure:

Field	Value	Description
`message`	`"{event_type} - {resource_name}"`	Combined event type and resource (e.g., “tools/call - get_weather”)
`service`	Your configured service name	From exporter configuration
`ddsource`	`"agentcat"`	Fixed source identifier
`ddtags`	Comma-separated string	Includes `env`, `event_type`, `resource`, and `error` tags
`timestamp`	Unix timestamp in milliseconds	Event occurrence time
`status`	`"error"` or `"info"`	Based on `is_error` flag

MCP Event Data

All AgentCat event fields are preserved in the mcp object:

Field	Description
`mcp.session_id`	Session identifier
`mcp.event_id`	Event identifier
`mcp.event_type`	Event type (e.g., “tools/call”)
`mcp.resource`	Resource name
`mcp.duration_ms`	Duration in milliseconds
`mcp.user_intent`	User’s intent (if captured)
`mcp.actor_id`	User identifier (if identified)
`mcp.actor_name`	User name (if identified)
`mcp.client_name`	MCP client name
`mcp.client_version`	MCP client version
`mcp.server_name`	Server name
`mcp.server_version`	Server version
`mcp.is_error`	Error flag (boolean)
`mcp.error`	Error details (if applicable)

Metrics

Metric Name	Type	Description
`mcp.events.count`	count	Total number of events
`mcp.event.duration`	gauge	Event duration in milliseconds
`mcp.errors.count`	count	Number of error events

All metrics include the following tags for filtering and grouping:

Tag	Example Value	Source
`service`	`"my-mcp-server"`	Exporter configuration
`env`	`"production"`	Exporter configuration
`event_type`	`"tools.call"`	Event type (slashes replaced with dots)
`resource`	`"get_weather"`	Resource name

​Overview

​Prerequisites

​Configuration

​Configuration Fields

​Field Mapping

​Trace and Span IDs

​Logs

​MCP Event Data

​Metrics