Todos los productos
Search
Centro de documentos

Application Real-Time Monitoring Service:SearchTracesByPage

Última actualización: Sep 01, 2026

Consulta trazas por página. Puede consultar trazas por rango de tiempo, nombre de aplicación, dirección IP, nombre de span o etiqueta.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

No se requiere autorización para esta operación. Si experimenta problemas al ejecutarla, póngase en contacto con el soporte técnico.

Parámetros de la solicitud

Parámetro

Tipo

Obligatorio

Descripción

Ejemplo

StartTime

integer

Sí

El inicio del rango de tiempo a consultar. Unidad: milisegundos.

1595174400000

EndTime

integer

Sí

El fin del rango de tiempo a consultar. Unidad: milisegundos.

1595210400000

RegionId

string

Sí

El ID de la región.

cn-hangzhou

ServiceName

string

No

El nombre de la aplicación.

arms-k8s-demo-subcomponent

OperationName

string

No

El nombre del span rastreado.

/demo/queryNotExistDB/11

MinDuration

integer

No

La cantidad mínima de tiempo consumida por las trazas. Unidad: milisegundos.

2

Reverse

boolean

No

Especifica si se deben ordenar los resultados de la consulta en orden cronológico o en orden cronológico inverso. Valor predeterminado: false.

  • true: ordena los resultados de la consulta en orden cronológico inverso.

  • false: ordena los resultados de la consulta en orden cronológico.

false

ServiceIp

string

No

La dirección IP del host donde reside la aplicación.

172.20.XX.XX

PageNumber

integer

No

El número de la página a devolver.

1

PageSize

integer

No

El número de entradas a devolver en cada página. Valor máximo: 100.

5

Pid

string

No

El ID de la aplicación.

b590lhguqs@9781be0f44dXXXX

ExclusionFilters

array<object>

No

Las condiciones de filtro.

object

No

Key

string

No

La clave que se utiliza para filtrar los resultados de la consulta.

http.status_code

Value

string

No

El valor de la clave que se utiliza para filtrar los resultados de la consulta.

404

Tags

array<object>

No

La lista de etiquetas.

object

No

Key

string

No

La clave de la etiqueta. Se proporcionan los siguientes campos predefinidos del sistema:

  • traceId: el ID de la traza.

  • serverApp: el nombre de la aplicación del servidor.

  • clientApp: el nombre de la aplicación cliente.

  • service: el nombre de la interfaz.

  • rpc: el tipo de llamada.

  • msOfSpan: la duración excede un valor específico.

  • clientIp: la dirección IP del cliente.

  • serverIp: la dirección IP del servidor.

  • isError: especifica si la llamada es anómala.

http.status_code

Value

string

No

El valor de la etiqueta.

200

IsError

boolean

No

Especifica si se deben incluir las trazas de llamadas anómalas.

  • true: No

  • false (predeterminado): Sí

false

Elementos de la respuesta

Elemento

Tipo

Descripción

Ejemplo

object

RequestId

string

El ID de la solicitud.

4C518054-852F-4023-ABC1-4AF95FF7****

PageBean

object

La estructura devuelta.

PageNumber

integer

El número de página de la página devuelta.

1

PageSize

integer

El número de entradas devueltas por página.

5

Total

integer

El número total de entradas devueltas.

1601

TraceInfos

array<object>

Los detalles de las trazas devueltas.

object

OperationName

string

El nombre del span rastreado.

/demo/queryException/12

ServiceIp

string

La dirección IP del host donde reside la aplicación.

172.20.XX.XX

Duration

integer

La cantidad de tiempo consumida por la traza. Unidad: milisegundos.

679

Timestamp

integer

La marca de tiempo.

1595174436994

ServiceName

string

El nombre de la aplicación.

arms-k8s-demo-subcomponent

TraceID

string

El ID de la traza.

ac1400a115951744369947025d****

SpanID

string

El ID de span de la traza.

be3d6dcf5750e***

Ejemplos

Respuesta exitosa

JSON Formato

{
  "RequestId": "4C518054-852F-4023-ABC1-4AF95FF7****",
  "PageBean": {
    "PageNumber": 1,
    "PageSize": 5,
    "Total": 1601,
    "TraceInfos": [
      {
        "OperationName": "/demo/queryException/12",
        "ServiceIp": "172.20.XX.XX",
        "Duration": 679,
        "Timestamp": 1595174436994,
        "ServiceName": "arms-k8s-demo-subcomponent",
        "TraceID": "ac1400a115951744369947025d****",
        "SpanID": "be3d6dcf5750e***"
      }
    ]
  }
}

Códigos de error

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.