Skip to main content
GET
Listar trazas
Requiere la acción de IAM telemetry:ReadTraces. Consulte permisos de telemetría para obtener la lista completa, lo que cubre cada una y un ejemplo de directiva.

Autorizaciones

Authorization
string
header
requerido

Un token bearer de OAuth 2.0, enviado como Authorization: Bearer <token>. Esta es la forma recomendada de autenticación.

Obtén el token intercambiando el par de claves de acceso de una cuenta de servicio en POST /v1/oauth/token con grant_type=client_credentials. Es el flujo estándar de credenciales de cliente; las bibliotecas compatibles con OAuth pueden obtener y renovar el token por ti.

Los tokens duran una hora por defecto. El mismo par de claves de acceso también sirve como credencial AWS SigV4 para el endpoint de objetos compatible con S3, que solo acepta ese método de autenticación.

Parámetros de consulta

from
string<date-time>
requerido

Límite inferior en el intervalo start_time (inclusive)

Ejemplo:

"2026-01-15T00:00:00Z"

to
string<date-time>
requerido

Límite superior en intervalo start_time (exclusivo); debe ser después de y dentro de 31d

Ejemplo:

"2026-01-16T00:00:00Z"

service
string

Filtrar por service.name

Ejemplo:

"api-gateway"

operation
string

Filtrar por nombre de intervalo (operación)

Ejemplo:

"GET /api/users"

status_code
enum<string>

Filtrar por código de estado

Opciones disponibles:
UNSET,
OK,
ERROR
Ejemplo:

"ERROR"

min_duration_ms
number<double>

Filtrar a las trazas cuya duración de extremo a extremo es al menos este número de ms

Rango requerido: x >= 0
Ejemplo:

100

limit
integer
predeterminado:50

Número máximo de artículos a devolver. Un valor por encima del máximo se le aplica en lugar de rechazarlo, por lo que una página más corta que la que solicitaste es normal — page until meta.has_more es falso, no hasta que una página se vea corta.

Rango requerido: 1 <= x <= 100
marker
string

Cursor de paginación opaco. Hacer eco del valor meta.marker de la página anterior para buscar la siguiente; no construirlo ni analizarlo. La forma interna del token varía según el punto final (un ID de recurso, una marca de tiempo, etc.) y no se garantiza su estabilidad entre versiones.

Respuesta

Página de resúmenes de trazas

traces
object[]
meta
object