Skip to main content

tracers

Creates, updates, deletes, gets or lists a tracers resource.

Overview

Nametracers
TypeResource
Iddatadog.fleet.tracers

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
idstringStatus identifier. (example: done)
attributesobjectAttributes of the fleet tracers response containing the list of tracers.
typestringResource type. (example: status)

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
list_fleet_tracersselectpage_number, page_size, sort_attribute, sort_descending, filterRetrieve a paginated list of all fleet tracers.<br /><br />This endpoint returns telemetry-derived service names from the SDK telemetry pipeline.<br />These names may differ from span-derived names in APM and are useful for querying<br />service library configurations.<br />Use the page_number and page_size query parameters to paginate through results.

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.

NameDatatypeDescription
sitestringThe 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.
filterstringFilter string for narrowing down tracer results. (example: hostname:my-host OR env:prod)
page_numberinteger (int64)Page number for pagination (starts at 0).
page_sizeinteger (int64)Number of results per page (must be greater than 0 and less than or equal to 100).
sort_attributestringAttribute to sort by.
sort_descendingbooleanSort order (true for descending, false for ascending).

SELECT examples

Retrieve a paginated list of all fleet tracers.<br /><br />This endpoint returns telemetry-derived service names from the SDK telemetry pipeline.<br />These names may differ from span-derived names in APM and are useful for querying<br />service library configurations.<br />Use the page_number and page_size query parameters to paginate through results.

SELECT
id,
attributes,
type
FROM datadog.fleet.tracers
WHERE page_number = '{{ page_number }}'
AND page_size = '{{ page_size }}'
AND sort_attribute = '{{ sort_attribute }}'
AND sort_descending = '{{ sort_descending }}'
AND filter = '{{ filter }}'
;