v1

latestOpenAPI 3.0.02026-07-141,4077,1665.2 MB
Fleet Automation

List tracers for a specific agent

Retrieve a paginated list of tracers for a specific agent.

This endpoint returns tracers associated with a given agent key, identified by the agent's hostname. Use this to discover telemetry-derived service names for a particular host.

get/api/unstable/fleet/agents/{agent_key}/tracers

Path parameters

agent_keystring required

The unique identifier (agent key) for the Datadog Agent.

Query parameters

page_numberinteger

Page number for pagination (starts at 0).

page_sizeinteger

Number of results per page (must be greater than 0 and less than or equal to 100).

sort_attributestring

Attribute to sort by.

sort_descendingboolean

Sort order (true for descending, false for ascending).

Response

OK

Example response

{
  "data": {
    "attributes": {
      "tracers": [
        {
          "env": "production",
          "hostname": "my-hostname",
          "language": "java",
          "language_version": "17.0.1",
          "remote_config_status": "connected",
          "service": "inventory-service",
          "service_hostname": "my-service-host",
          "service_version": "2.1.0",
          "tracer_version": "1.32.0"
        }
      ]
    },
    "id": "done",
    "type": "status"
  },
  "meta": {
    "total_filtered_count": 42
  }
}