agent_tracers

Creates, updates, deletes, gets or lists an agent_tracers resource.

Overview

Name	agent_tracers
Type	Resource
Id	datadog.fleet.agent_tracers

Fields

The following fields are returned by SELECT queries:

list_fleet_agent_tracers

Name	Datatype	Description
id	string	Status identifier. (example: done)
attributes	object	Attributes of the fleet tracers response containing the list of tracers.
type	string	Resource type. (example: status)

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
list_fleet_agent_tracers	select	agent_key	page_number, page_size, sort_attribute, sort_descending	Retrieve a paginated list of tracers for a specific agent.<br /><br />This endpoint returns tracers associated with a given agent key, identified by the<br />agent's hostname. Use this to discover telemetry-derived service names for a particular host.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
agent_key	string	The unique identifier (agent key) for the Datadog Agent.
site	string	The Datadog site (region) for your organization, for example datadoghq.com, us3.datadoghq.com, us5.datadoghq.com, ap1.datadoghq.com, ap2.datadoghq.com, datadoghq.eu, ddog-gov.com. Resolved from the DD_SITE environment variable when set. Optional: defaults to datadoghq.com, or the value of the DD_SITE environment variable when set; a WHERE value overrides both.
page_number	integer (int64)	Page number for pagination (starts at 0).
page_size	integer (int64)	Number of results per page (must be greater than 0 and less than or equal to 100).
sort_attribute	string	Attribute to sort by.
sort_descending	boolean	Sort order (true for descending, false for ascending).

SELECT examples

list_fleet_agent_tracers

Retrieve a paginated list of tracers for a specific agent.<br /><br />This endpoint returns tracers associated with a given agent key, identified by the<br />agent's hostname. Use this to discover telemetry-derived service names for a particular host.

SELECT
id,
attributes,
type
FROM datadog.fleet.agent_tracers
WHERE agent_key = '{{ agent_key }}' -- required
AND page_number = '{{ page_number }}'
AND page_size = '{{ page_size }}'
AND sort_attribute = '{{ sort_attribute }}'
AND sort_descending = '{{ sort_descending }}'
;