{"command":{"effect":"read","timeoutSeconds":30,"inputSchema":{"type":"object","description":"To retrieve a single trace and all of its spans, send a GET request to `/v2/insights/query/{region}/traces/{trace_id}`.\nOnly spans that started within the lookup window are returned. The window defaults to the last 7 days and can be narrowed with the `from` and `to` query parameters; it must not exceed 7 days, and `from` must not be after `to`. Spans are returned ordered by start time. At most 10,000 spans are returned; `truncated` is `true` when the trace has more.\nA trace ID with no spans in the window returns `404`, as do malformed or uppercase trace IDs. A trace is only resolvable in the region that ingested it; querying another region also returns `404`.\nSupported regions are `ams2`, `ams3`, `atl1`, `blr1`, `fra1`, `lon1`, `mem1`, `nyc1`, `nyc2`, `nyc3`, `ric1`, `sfo1`, `sfo2`, `sfo3`, `sgp1`, `syd1`, and `tor1`. Requests time out after 60 seconds.\nErrors produced by the traces service (`400`, and `404` when no trace is found) have a `text/plain` body containing a short message. Authentication and authorization errors (`401`, `403`), rate limiting (`429`), and routing errors (for example, `404` for an unknown region) come from the API gateway and use the standard JSON error object with `id` and `message`. `403` is also returned for accounts that are in a trial or not in good standing. If the regional traces backend cannot be reached, the response is `502` with a `text/plain` body.\nJSON field names use snake_case (`trace_id`, `span_id`, `start_time`, `end_time`, `duration_ns`, `service_name`, `status_code`, `parent_span_id`).","properties":{"path":{"type":"object","properties":{"region":{"type":"string","examples":["nyc3"],"description":"The datacenter region slug for the query."},"trace_id":{"type":"string","examples":["7b0b4e56abab38362b24e5498eb9ec64"],"description":"The OpenTelemetry trace ID to retrieve, as 32 lowercase hexadecimal characters. IDs are matched exactly; an ID with no spans in the lookup window returns `404`. Malformed or uppercase IDs are not rejected with `400`; they also return `404`."}},"required":["region","trace_id"],"additionalProperties":false},"query":{"type":"object","properties":{"from":{"type":"string","examples":["24h"],"description":"Start of the trace lookup window. Accepts a relative time (`now`, a bare duration such as `24h` to look back from now, or `now-2h`) or an absolute time (RFC3339, or a Unix epoch integer in seconds, milliseconds, microseconds, or nanoseconds). Defaults to 7 days before now."},"to":{"type":"string","examples":["now"],"description":"End of the trace lookup window, in the same formats as `from`. Defaults to now."}},"required":[],"additionalProperties":false}},"required":["path"],"additionalProperties":false},"name":"Retrieve an existing trace","id":"digitalocean.insights_get_trace","example":{"path":{"region":"nyc3","trace_id":"7b0b4e56abab38362b24e5498eb9ec64"}},"maxRequests":1,"summary":false}}