GetTrace - Application Real-Time Monitoring Service: Central de Documentação do Alibaba Cloud

Consulta os detalhes de um trace.

Descrição da operação

Nota

Você deve usar o SDK do Application Real-Time Monitoring Service (ARMS) para Java V2.7.24.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
TraceID	string	Sim	O ID do trace. Você pode fazer logon no console do ARMS e obter o ID do trace na página Consulta de traces ou na guia Snapshot de interface.	ac14001a15954493811405707d****
RegionId	string	Sim	O ID da região.	cn-hangzhou
StartTime	integer	Não	O início do intervalo de tempo a ser consultado. Unidade: milissegundos.\n\n> Se o ID do trace tiver 30 caracteres de comprimento, este parâmetro é opcional. Caso contrário, este parâmetro é obrigatório.	1623827602000
EndTime	integer	Não	O fim do intervalo de tempo a ser consultado. Unidade: milissegundos.\n\n> Se o ID do trace tiver 30 caracteres de comprimento, este parâmetro é opcional. Caso contrário, este parâmetro é obrigatório.	1623827603000
PageNumber	integer	Não	O número da página.	1
PageSize	integer	Não	O número de entradas em cada página. Valor máximo: 100.	10

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	6A9AEA84-7186-4D8D-B498-4585C6A2****
Spans	array<object>	Os detalhes do trace.
	array<object>
SpanId	string	O ID do span.	1234
OperationName	string	O nome do span rastreado.	/api/demo
ResultCode	string	O código de status.	222
Timestamp	integer	O timestamp em que o span foi gerado.	1590388651
RpcType	integer	O tipo do modo de chamada de procedimento remoto (RPC).\n\n* 0: entrada HTTP\n* 25: chamada HTTP\n* 1: chamada do High-speed Service Framework (HSF)\n* 2: provedor HSF\n* 40: chamada de API local\n* 60: chamada MySQL\n* 62: chamada Oracle\n* 63: chamada PostgreSQL\n* 70: chamada Redis\n* 4: chamada do Taobao Distributed Data Layer (TDDL)\n* 5: chamada Tair\n* 13: envio de mensagem MetaQ\n* 252: recebimento de mensagem MetaQ\n* 3: envio de notificação\n* 254: recebimento de notificação\n* 7: chamada Apache Dubbo\n* 8: provedor Apache Dubbo\n* 19: chamada SOFARPC\n* 18: provedor SOFARPC\n* 11: chamada do Distributed Service Framework (DSF)\n* 12: provedor DSF\n* -1: chamada desconhecida.	1
ServiceIp	string	O endereço IP do host no qual a aplicação reside.	172.20.XX.XX
HaveStack	boolean	Indica se uma pilha de métodos foi fornecida.\n\n* `true`: Uma pilha de métodos foi fornecida.\n* `false`: Nenhuma pilha de métodos foi fornecida.	false
ParentSpanId	string	O ID do span pai.	18
Duration	integer	A quantidade de tempo consumida pelo trace. Unidade: milissegundos.	1000
RpcId	string	O ID do modo RPC.	0
ServiceName	string	O nome da aplicação.	arms-demo
TraceID	string	O ID do trace.	ac14001a15954493811405707d****
TagEntryList	array<object>	As tags do trace.
	object
Key	string	The key of the tag.	http.status.code
Value	string	The value of the tag.	200
LogEventList	array<object>	Os eventos de log no trace.
	array<object>
Timestamp	integer	The timestamp when the log event was generated.	1590388651
TagEntryList	array<object>	The tags of the trace.
	object
Key	string	The key of the tag.	http.status.code
Value	string	The value of the tag.	200
Children	array<object>	Os spans filhos do span atual.
	object	Os detalhes do span filho.	[ { "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" } ]

Exemplos

Resposta de sucesso

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 erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.