Todos os produtos
Search
Central de documentação

Application Real-Time Monitoring Service:SearchTraces

Última atualização: Jul 04, 2026

Consulta traces por tempo, nome do aplicativo, endereço IP, nome do span e tag.

Descrição da operação

Nota

No máximo, 100 entradas de dados podem ser retornadas cada vez que esta operação é chamada. Se você quiser consultar todos os traces existentes, recomendamos que chame a operação SearchTracesByPage. Para mais informações, consulte SearchTracesByPage.

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 do aplicativo.

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 traces. 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 o aplicativo reside.

172.20.XX.XX

Pid

string

Não

O ID do aplicativo.

b590lhguqs@9781be0f44dXXXX

Tag

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:

  • serverApp: o nome do aplicativo de servidor.

  • clientApp: o nome do aplicativo cliente.

  • service: o nome da operação.

  • 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.

  • hasTprof: contém apenas profiling de thread.

http.status_code

Value

string

Não

O valor da tag.

200

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

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

RequestId

string

O ID da solicitação.

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

TraceInfos

array<object>

Os detalhes dos traces retornados.

object

OperationName

string

O nome do span rastreado.

get***

ServiceIp

string

O endereço IP do host onde o aplicativo reside.

172.20.**.**

Duration

integer

A quantidade de tempo consumida pelo trace. Unidade: milissegundos.

6

Timestamp

integer

O timestamp.

1595174436993

ServiceName

string

O nome do aplicativo.

arms-k8s-demo-subcomponent

TraceID

string

O ID do trace.

ac1400a115951744369937024d****

SpanID

string

O ID do span. Você pode obtê-lo na página Trace Explorer do console do ARMS.

be3d6dcf5750e***

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "4C518054-852F-4023-ABC1-4AF95FF7****",
  "TraceInfos": [
    {
      "OperationName": "get***",
      "ServiceIp": "172.20.**.**",
      "Duration": 6,
      "Timestamp": 1595174436993,
      "ServiceName": "arms-k8s-demo-subcomponent",
      "TraceID": "ac1400a115951744369937024d****",
      "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.