hosting

GET `/v1/sites/{siteId}/apm/traces/{traceId}`

Show where one kept request's milliseconds went.

Authentifizierung

Senden Sie einen API-Schlüssel als Bearer-Token. Der Schlüssel muss über die Berechtigung sites.view verfügen; ein Schlüssel ohne diese wird mit 403 statt 404 abgelehnt.

Dieser Endpunkt erfordert keine Organisations-ID. Ihr Schlüssel identifiziert bereits die zugehörige Organisation, und die Antwort ist entsprechend eingeschränkt.

Ausprobieren

Ersetzen Sie alles in spitzen Klammern durch Ihre eigenen Werte und den Platzhalter für den Schlüssel durch einen Schlüssel aus Ihrem Dashboard.

curl -X GET https://api.zinndigital.com/v1/sites/{siteId}/apm/traces/{traceId} \
  -H "Authorization: Bearer zdk_live_…"

Angemeldet? Die API-Konsole in Ihrem Dashboard trägt automatisch Ihre echte Organisations-ID sowie Ihren eigenen Schlüssel ein und führt die Anfrage gegen die Live-API aus, sodass Sie die tatsächliche Antwort sehen können. Öffnen Sie diesen Endpunkt in der API-Konsole

Details

The function-level breakdown for one stored request: which WordPress plugin, PHP extension, PHP function or SQL query consumed the time, heaviest first, with the call site relative to the site's own document root. ⭐ SQL literals arrive already redacted by the vendor (`WHERE autoload IN ('xxx')`) and are neither restored nor re-redacted here. That redaction is why a slow query can be shown to a customer at all. ⛔ A trace past retention answers `404` rather than `410`: the customer's next action is identical, and a distinct code would be an oracle for which trace ids ever existed. Requires `sites.view` and the `request_profiling` entitlement. A trace belonging to another site answers `404`, never another tenant's data.

Parameter

Name	Typ	Erforderlich	Was es ist
`siteId (path)`	`Uuid`	Ja	Site ID (UUIDv7).
`traceId (path)`	`string`	Ja	One of our own trace ids, from `id` on the list row. ⭐ A UUID, unlike the sibling live surface's vendor task id: this is a primary key we minted, so a non-UUID really is *"no su…

Antwort

Name	Typ	Erforderlich	Was es ist
`id`	`string`	Ja	—
`transaction`	`string`	Ja	—
`method`	`string`	Ja	—
`path`	`string`	Ja	The path as traced, before normalisation — so a developer can reproduce the exact request, which the grouped transaction label deliberately cannot express.
`duration_ms`	`integer`	Ja	—
`throttled_ms`	`integer`	Ja	—
`io_throttled_ms`	`integer`	Ja	—
`hit_limits`	`boolean`	Ja	—
`has_error`	`boolean`	Ja	—
`error_text`	`string`	Ja	—
`cache_miss_reasons`	`string[]`	Ja	Why this request bypassed the page cache; empty when it was cacheable.
`started_at`	`string`	Ja	—
`costs`	`SiteApmTraceCost[]`	Ja	—

Fehler, die dieser Endpunkt zurückgeben kann

401 · 403 · 404 · 422 · 429

GET /v1/sites/{siteId}/apm/traces/{traceId}