Naar hoofdinhoud gaan
Lees distributed tracing-gegevens met de Public API (V2): som performance- en error-traces op, haal de spans van een enkele trace op, inspecteer geaggregeerde acties en service-afhankelijkheden, en analyseer trage events. Alle eindpunten authenticeren met uw persoonlijke API-token. De trace-eindpunten gebruiken een site_ids-array zodat ze in één verzoek over meerdere sites kunnen zoeken. De meeste lijst- en detail-eindpunten delen de TracesQuery-body en retourneren ofwel trace-samenvattingen ofwel spans, beschreven aan het einde van deze pagina.

​
Een trace lokaliseren

Vind de performance-acties en error-incidenten waarin een trace voorkomt, over sites heen. 
POST /api/v2/tracing/locator
De request body neemt site_ids (een string-array) en trace_id (een string). In ruil ontvangt u een TraceLocation met performance-entries (site_id, namespace, action_name) en errors-entries (site_id, incident_number, exception_name).

​
De spans van een trace ophalen

Retourneert elke span in een trace. 
POST /api/v2/tracing/trace
De request body neemt site_ids (een string-array) en trace_id (een string), en retourneert een array van spans. 
{
  "site_ids": ["YOUR-SITE-ID"],
  "trace_id": "YOUR-TRACE-ID"
}
De eindpunten POST /api/v2/tracing/trace/performance en POST /api/v2/tracing/trace/error retourneren de spans van een performance- of error-trace met behulp van de TracesQuery-body.

​
Traces opsommen

Som performance- of error-traces op. 
POST /api/v2/tracing/traces/performance
POST /api/v2/tracing/traces/errors
Beide nemen de TracesQuery-body en retourneren een array van trace- samenvattingen. 
{
  "site_ids": ["YOUR-SITE-ID"],
  "action_name": "POST /api/users",
  "namespace": "web",
  "from": "2026-06-22T00:00:00Z",
  "to": "2026-06-22T23:59:59Z",
  "pagination": { "per_page": 50, "order": "DESC", "cursor": "Time" }
}
pagination neemt per_page, order en een cursor-sleutel. Stel cursor in op Time om te pagineren op tracetijd of Duration om te pagineren op totale traceduur.

​
TracesQuery

VeldTypeVereistBeschrijving
site_idsstring[]JaSites om op te vragen.
paginationobjectJaPaginatie-instellingen. Stel cursor in op Time of Duration.
digestsstring[]NeeFilter op trace-digests.
action_namestringNeeFilter op actienaam.
namespacestringNeeFilter op namespace.
querystringNeeVrije-tekst zoekquery.
durationnumber (ms)NeeFilter op minimale duur.
fromstring (ISO 8601)NeeStartpunt van het tijdsbereik.
tostring (ISO 8601)NeeEindpunt van het tijdsbereik.
ttlnumberNeeRetentiegrens in seconden.

​
Performance-acties opsommen

Som performance-acties op met geaggregeerde metrics. 
POST /api/v2/tracing/actions
De request body neemt site_id, from, to en de optionele filters namespaces (array), revision en action. U krijgt een array van actie-rijen terug, elk met namespace, action, digest, mean (ms), throughput, error_rate (0–100) en has_npo (of er een N+1-query is gedetecteerd).

​
Edges voor service-afhankelijkheden

Breng distributed tracing-relaties tussen acties en services in kaart. 
POST /api/v2/tracing/action_edges
POST /api/v2/tracing/site_edges
action_edges retourneert de upstream (callers) en downstream (callees) edges voor een gefocuste actie. De body neemt site_id, namespace (in "<service>/<namespace>"-vorm, zoals "PublicApi/web"), action, from en to. site_edges retourneert upstream-, downstream- en internal-edges voor een gefocuste site. De body neemt site_id, from en to. Elke edge meldt de peer-service, het aantal verzoeken (count), error_count, mean (ms), en p_90- / p_95-duren. Actie-edges bevatten ook de peer namespace, action, span-soorten en edge_type (SYNC of ASYNC).

​
Trage events

Analyseer trage operaties binnen traces, zoals trage databasequery’s. 
POST /api/v2/tracing/slow_events
POST /api/v2/tracing/slow_events/actions
slow_events retourneert geaggregeerde trage events. De body neemt site_id, from, to, een optionele span_kind, wanted_attributes, excluded_attributes en een limit (standaard 100). Elk resultaat heeft een digest, count, mean (ms), impact-score en attributes. slow_events/actions somt de acties op waarin een traag event voorkomt, op digest. De body neemt site_id, from, to en digest. Elk resultaat heeft een action_name, namespace, count, trace_id en start_time.

​
Velden van trace-samenvattingen

De lijst-eindpunten retourneren trace-samenvattingen met deze velden:
VeldTypeBeschrijving
trace_idstringIdentificator voor de hele trace.
span_idstringIdentificator voor de hoofdspan.
site_idstringSite waar de trace bij hoort.
namespacestringNamespace, zoals web of background.
action_namestringActienaam, zoals POST /api/users.
revisionstringDeploy-revisie die actief was bij vastlegging.
timestring (ISO 8601)Wanneer de trace eindigde.
durationnumberTotale duur in milliseconden.
tagsobjectDoor gebruiker gedefinieerde tags uit span-attributen.
has_npobooleanOf er een N+1-query is gedetecteerd.

​
Span-velden

De trace-detail-eindpunten retourneren spans. Elke span bevat timing (start_time, end_time, duration in ms), identiteit (trace_id, span_id, parent_span_id, digest) en context (service_name, namespace, revision, action_name, span_name, span_kind, scope_name, scope_version). De status wordt gerapporteerd met status_code (zoals OK of ERROR) en status_message. Gestructureerde details worden geretourneerd als objecten en arrays: resource_attributes en span_attributes (objects), events (met events.timestamp, events.name en events.attributes arrays), en links (met links.trace_id, links.span_id, links.trace_state en links.attributes arrays). subtrace_root geeft aan of de span een aparte servicegrens begint.