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

Obtém os detalhes de vários rastros.

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

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

arms:GetMultipleTrace

none

*Todos os recursos.

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Sim	O ID da região.	cn-hangzhou
TraceIDs	array	Sim	A lista de IDs de rastros.	ac1400a115951745017447033d****
	string	Não	O ID do rastro. Você deve especificar no mínimo um e no máximo nove IDs de rastro. Você pode obter os IDs de rastro na página Consulta de rastros no console do ARMS.	ac1400a115951745017447033d****
StartTime	integer	Sim	O timestamp em que o rastro começa, em milissegundos.	1657692507000
EndTime	integer	Sim	O timestamp em que o rastro termina, em milissegundos.	1663999380000
PageNumber	integer	Não	O número da página. As páginas começam em 1.	1
PageSize	integer	Não	O número de entradas por página. Valor máximo: 1000.	10

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	2983BEF7-4A0D-47A2-94A2-8E9C5E63****
MultiCallChainInfos	array<object>	As informações sobre vários rastros.
	array<object>
TraceID	string	O ID do rastro.	ac1400a115951745017447033d****
Spans	array<object>	Os detalhes do rastro.
	array<object>
SpanId	string	O ID do span.	1234
OperationName	string	O nome da operação instrumentada.	/demo/queryNotExistDB/11
ResultCode	string	O código de retorno.	1
Timestamp	integer	O timestamp.	1595174501747
RpcType	integer	O tipo de RPC. Valores válidos: -2: front -3: app 0: http 25: http_client 1: hsf_client 2: hsf 40: local 41: async 52: DB2 53: Informix 54: SequoiaDB 55: Gbase 56: GaussDB 57: KingBase 58: infuxdb 59: clickhouse 60: mysql 61: mysql 62: oracle 63: postgresql 64: mongodb 65: ppas 66: sqlserver 67: mariadb 68: dmdb 69: oceanbase 70: redis 71: memcached 72: elasticsearch 73: kudu 4: tddl 5: tair 13: mq_client 252: mq 23: kafka_client 256: kafka 3: notify_client 254: notify 7: dubbo_client 8: dubbo 11: dsf_client 12: dsf 9: grpc 10: grpc_client 16: thrift 17: thrift_client 18: sofa 19: sofa_client -1: unknown 98: user_method 100: root 101: client 102: server 103: producer 104: consumer 105: db 106: xtrace_other 1301: schedulerx 1302: XXL_Job 1303: Spring_Scheduled 1304: Quartz 1305: ElasticJob 1308: Jdk_Timer	0
ServiceIp	string	O endereço IP da máquina onde a aplicação está implantada.	172.20.XX.XX
HaveStack	boolean	Especifica se uma pilha de métodos está disponível. Valores válidos: true: Uma pilha de métodos está disponível. false: Nenhuma pilha de métodos está disponível.	true
ParentSpanId	string	O ID do span pai.	18
Duration	integer	A duração do span, em milissegundos.	11
RpcId	string	O ID de RPC.	0.1
ServiceName	string	O nome da aplicação.	arms-k8s-demo-subcomponent
TraceID	string	O ID do rastro.	ac1400a115951745017447033d****
TagEntryList	array<object>	A lista de tags do span.
	object
Key	string	A chave da tag.	http.status.code
Value	string	O valor da tag.	200
LogEventList	array<object>	Os eventos de log no span.
	array<object>
Timestamp	integer	O timestamp em que o log é gerado.	1595174501747
TagEntryList	array<object>	A lista de tags do span.
	object
Key	string	A chave da tag.	http.status.code
Value	string	O valor da tag.	200

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "2983BEF7-4A0D-47A2-94A2-8E9C5E63****",
  "MultiCallChainInfos": [
    {
      "TraceID": "ac1400a115951745017447033d****",
      "Spans": [
        {
          "SpanId": "1234",
          "OperationName": "/demo/queryNotExistDB/11",
          "ResultCode": "1",
          "Timestamp": 1595174501747,
          "RpcType": 0,
          "ServiceIp": "172.20.XX.XX",
          "HaveStack": true,
          "ParentSpanId": "18",
          "Duration": 11,
          "RpcId": "0.1",
          "ServiceName": "arms-k8s-demo-subcomponent",
          "TraceID": "ac1400a115951745017447033d****",
          "TagEntryList": [
            {
              "Key": "http.status.code",
              "Value": "200"
            }
          ],
          "LogEventList": [
            {
              "Timestamp": 1595174501747,
              "TagEntryList": [
                {
                  "Key": "http.status.code",
                  "Value": "200"
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}

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.