hosting
GET /v1/sites/{siteId}/apm/traces/{traceId}
Show where one kept request's milliseconds went.
身份验证
请将 API 密钥作为 bearer 令牌发送。该密钥必须具有 sites.view 权限;缺少该权限的密钥将被拒绝并返回 403 状态码,而非 404。
此端点不需要组织 ID。您的密钥已用于识别其所属的组织,且响应范围也仅限于该组织。
免费试用
将尖括号中的内容替换为您自己的值,并将键占位符替换为您仪表板中的一个键。
curl -X GET https://api.zinndigital.com/v1/sites/{siteId}/apm/traces/{traceId} \
-H "Authorization: Bearer zdk_live_…"已登录?您仪表板中的 API 控制台会自动填入您真实的组织 ID 和您自己的密钥,并针对实时 API 运行请求,以便您查看实际的响应。 在 API 控制台中打开此端点
详细信息
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.
参数
| 名称 | 类型 | 必填 | 内容简介 |
|---|---|---|---|
siteId (path) | Uuid | 是 | Site ID (UUIDv7). |
traceId (path) | string | 是 | 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… |
响应
| 名称 | 类型 | 必填 | 内容简介 |
|---|---|---|---|
id | string | 是 | — |
transaction | string | 是 | — |
method | string | 是 | — |
path | string | 是 | 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 | 是 | — |
throttled_ms | integer | 是 | — |
io_throttled_ms | integer | 是 | — |
hit_limits | boolean | 是 | — |
has_error | boolean | 是 | — |
error_text | string | 是 | — |
cache_miss_reasons | string[] | 是 | Why this request bypassed the page cache; empty when it was cacheable. |
started_at | string | 是 | — |
costs | SiteApmTraceCost[] | 是 | — |
此端点可能返回的错误
401 · 403 · 404 · 422 · 429