GetTrace - Application Real-Time Monitoring Service - Centro de documentación de Alibaba Cloud

Consulta los detalles de un rastro.

Descripción de la operación

Nota

Debe utilizar el SDK de Application Real-Time Monitoring Service (ARMS) para Java V2.7.24.

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
TraceID	string	Sí	El ID del rastro. Puede iniciar sesión en la consola de ARMS y obtener el ID del rastro en la página Consulta de rastros o en la pestaña Instantánea de interfaz.	ac14001a15954493811405707d****
RegionId	string	Sí	El ID de la región.	cn-hangzhou
StartTime	integer	No	El inicio del intervalo de tiempo a consultar. Unidad: milisegundos. Nota Si el ID del rastro tiene una longitud de 30 caracteres, este parámetro es opcional. De lo contrario, este parámetro es obligatorio.	1623827602000
EndTime	integer	No	El fin del intervalo de tiempo a consultar. Unidad: milisegundos. Nota Si el ID del rastro tiene una longitud de 30 caracteres, este parámetro es opcional. De lo contrario, este parámetro es obligatorio.	1623827603000
PageNumber	integer	No	El número de página.	1
PageSize	integer	No	El número de entradas en cada página. Valor máximo: 100.	10

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object
RequestId	string	El ID de la solicitud.	6A9AEA84-7186-4D8D-B498-4585C6A2****
Spans	array<object>	Los detalles del rastro.
	array<object>
SpanId	string	El ID del span.	1234
OperationName	string	El nombre del span rastreado.	/api/demo
ResultCode	string	El código de estado.	222
Timestamp	integer	La marca de tiempo generada cuando se creó el span.	1590388651
RpcType	integer	El tipo de modo de llamada a procedimiento remoto (RPC). 0: entrada HTTP 25: llamada HTTP 1: llamada de High-speed Service Framework (HSF) 2: aprovisionamiento de HSF 40: llamada a API local 60: llamada a MySQL 62: llamada a Oracle 63: llamada a PostgreSQL 70: llamada a Redis 4: llamada a Taobao Distributed Data Layer (TDDL) 5: llamada a Tair 13: envío de mensajes MetaQ 252: recepción de mensajes MetaQ 3: envío de notificaciones 254: recepción de notificaciones 7: llamada a Apache Dubbo 8: aprovisionamiento de Apache Dubbo 19: llamada a SOFARPC 18: aprovisionamiento de SOFARPC 11: llamada a Distributed Service Framework (DSF) 12: aprovisionamiento de DSF -1: llamada desconocida	1
ServiceIp	string	La dirección IP del host donde reside la aplicación.	172.20.XX.XX
HaveStack	boolean	Indica si se proporcionó una pila de métodos. `true`: Se proporcionó una pila de métodos. `false`: No se proporcionó ninguna pila de métodos.	false
ParentSpanId	string	El ID del span principal.	18
Duration	integer	La cantidad de tiempo consumida por el rastro. Unidad: milisegundos.	1000
RpcId	string	El ID del modo RPC.	0
ServiceName	string	El nombre de la aplicación.	arms-demo
TraceID	string	El ID del rastro.	ac14001a15954493811405707d****
TagEntryList	array<object>	Las etiquetas del rastro.
	object
Key	string	La clave de la etiqueta.	http.status.code
Value	string	El valor de la etiqueta.	200
LogEventList	array<object>	Los eventos de registro en el rastro.
	array<object>
Timestamp	integer	La marca de tiempo cuando se generó el evento de registro.	1590388651
TagEntryList	array<object>	Las etiquetas del rastro.
	object
Key	string	La clave de la etiqueta.	http.status.code
Value	string	El valor de la etiqueta.	200
Children	array<object>	Los spans secundarios del span actual.
	object	Los detalles del span secundario.	[ { "ParentSpanId":"c33603355032xxxx", "ServiceIp":"10.208.xxx.xxx", "OperationName":"/product/toy/8ac7ddeb-1c3c-4911-850c-665a5a0xxxx", "RpcType":0, "Duration":2, "TagEntryList":[ { "Value":"10.208.0.xxx", "Key":"source.ip" } ], "Timestamp":1652669026201, "HaveStack":true, "LogEventList":[ ], "ServiceName":"xxxxxx", "RpcId":"0.2", "TraceID":"ea1ad000a1165266902619685xxxxx", "Children":[ ], "ResultCode":"0", "SpanId":"7069ab30d7cbxxxx" } ]

Ejemplos

Respuesta exitosa

JSON Formato

{
  "RequestId": "6A9AEA84-7186-4D8D-B498-4585C6A2****",
  "Spans": [
    {
      "SpanId": "1234",
      "OperationName": "/api/demo",
      "ResultCode": "222",
      "Timestamp": 1590388651,
      "RpcType": 1,
      "ServiceIp": "172.20.XX.XX",
      "HaveStack": false,
      "ParentSpanId": "18",
      "Duration": 1000,
      "RpcId": "0",
      "ServiceName": "arms-demo",
      "TraceID": "ac14001a15954493811405707d****",
      "TagEntryList": [
        {
          "Key": "http.status.code",
          "Value": "200"
        }
      ],
      "LogEventList": [
        {
          "Timestamp": 1590388651,
          "TagEntryList": [
            {
              "Key": "http.status.code",
              "Value": "200"
            }
          ]
        }
      ],
      "Children": [
        [
          {
            "ParentSpanId": "c33603355032xxxx",
            "ServiceIp": "10.208.xxx.xxx",
            "OperationName": "/product/toy/8ac7ddeb-1c3c-4911-850c-665a5a0xxxx",
            "RpcType": 0,
            "Duration": 2,
            "TagEntryList": [
              {
                "Value": "10.208.0.xxx",
                "Key": "source.ip"
              }
            ],
            "Timestamp": 1652669026201,
            "HaveStack": true,
            "LogEventList": [],
            "ServiceName": "xxxxxx",
            "RpcId": "0.2",
            "TraceID": "ea1ad000a1165266902619685xxxxx",
            "Children": [],
            "ResultCode": "0",
            "SpanId": "7069ab30d7cbxxxx"
          }
        ]
      ]
    }
  ]
}

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.