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

Consulta rastros por página. Você pode consultar rastros por intervalo de tempo, nome da aplicação, endereço IP, nome do span ou tag.

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
StartTime	integer	Sim	O início do intervalo de tempo a ser consultado. Unidade: milissegundos.	1595174400000
EndTime	integer	Sim	O fim do intervalo de tempo a ser consultado. Unidade: milissegundos.	1595210400000
RegionId	string	Sim	O ID da região.	cn-hangzhou
ServiceName	string	Não	O nome da aplicação.	arms-k8s-demo-subcomponent
OperationName	string	Não	O nome do span rastreado.	/demo/queryNotExistDB/11
MinDuration	integer	Não	A quantidade mínima de tempo consumida pelos rastros. Unidade: milissegundos.	2
Reverse	boolean	Não	Especifica se os resultados da consulta devem ser classificados em ordem cronológica ou em ordem cronológica inversa. Valor padrão: false. true: classifica os resultados da consulta em ordem cronológica inversa. false: classifica os resultados da consulta em ordem cronológica.	false
ServiceIp	string	Não	O endereço IP do host onde a aplicação reside.	172.20.XX.XX
PageNumber	integer	Não	O número da página a ser retornada.	1
PageSize	integer	Não	O número de entradas a serem retornadas em cada página. Valor máximo: 100.	5
Pid	string	Não	O ID da aplicação.	b590lhguqs@9781be0f44dXXXX
ExclusionFilters	array<object>	Não	As condições de filtro.
	object	Não
Key	string	Não	A chave usada para filtrar os resultados da consulta.	http.status_code
Value	string	Não	O valor da chave usada para filtrar os resultados da consulta.	404
Tags	array<object>	Não	A lista de tags.
	object	Não
Key	string	Não	A chave da tag. Os seguintes campos predefinidos do sistema são fornecidos: traceId: o ID do rastro. serverApp: o nome da aplicação do servidor. clientApp: o nome da aplicação do cliente. service: o nome da interface. rpc: o tipo da chamada. msOfSpan: a duração excede um valor específico. clientIp: o endereço IP do cliente. serverIp: o endereço IP do servidor. isError: especifica se a chamada é anormal.	http.status_code
Value	string	Não	O valor da tag.	200
IsError	boolean	Não	Especifica se devem ser incluídos os rastros de chamadas anormais. true: Não false (padrão): Sim	false

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	4C518054-852F-4023-ABC1-4AF95FF7****
PageBean	object	A estrutura retornada.
PageNumber	integer	O número da página retornada.	1
PageSize	integer	O número de entradas retornadas por página.	5
Total	integer	O número total de entradas retornadas.	1601
TraceInfos	array<object>	Os detalhes dos rastros retornados.
	object
OperationName	string	The name of the traced span.	/demo/queryException/12
ServiceIp	string	The IP address of the host where the application resides.	172.20.XX.XX
Duration	integer	The amount of time consumed by the trace. Unit: milliseconds.	679
Timestamp	integer	The timestamp.	1595174436994
ServiceName	string	The name of the application.	arms-k8s-demo-subcomponent
TraceID	string	The trace ID.	ac1400a115951744369947025d****
SpanID	string	The span ID of the trace.	be3d6dcf5750e***

Exemplos

Resposta de sucesso

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 erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.