Objeto de span do APM

Os objetos a seguir estão diretamente relacionados à API apmspan.

Cada propriedade corresponde a uma coluna na tabela otel_traces da fonte de dados de telemetria. Para obter a lista de colunas, consulte Colunas de dados de telemetria compatíveis.

Span de APM

O objeto de span de APM representa um span (uma única operação dentro de um trace, como uma solicitação HTTP, uma consulta ao banco de dados ou uma chamada de função).

Os spans formam uma hierarquia, começando pelo span raiz, que representa a primeira operação da solicitação. Todos os outros spans são spans filhos do span durante o qual a operação correspondente foi iniciada.

O objeto de span de APM tem as seguintes propriedades:

Propriedade Tipo Descrição
timestamp integer Hora Unix (em nanossegundos) em que o span foi iniciado.

Comportamento da propriedade:
- somente leitura
traceid string ID do trace ao qual o span pertence.

Comportamento da propriedade:
- somente leitura
spanid string ID do span.

Comportamento da propriedade:
- somente leitura
parent_spanid string ID do span pai.
Vazio para o span raiz.

Comportamento da propriedade:
- somente leitura
trace_state string Dados adicionais, se houver, anexados ao trace pelas ferramentas de tracing (consulte W3C Trace Context).

Comportamento da propriedade:
- somente leitura
span_name string Nome da operação representada pelo span (por exemplo, mysqli_query).

Comportamento da propriedade:
- somente leitura
span_kind string Função do span.

Valores possíveis:
Unspecified - o tipo do span não foi especificado;
Internal - operação executada dentro de um aplicativo;
Server - tratamento de uma solicitação recebida;
Client - solicitação de saída;
Producer - criação de uma operação assíncrona (por exemplo, envio de uma mensagem);
Consumer - processamento de uma operação assíncrona.

Comportamento da propriedade:
- somente leitura
service_name string Nome do serviço que produziu o span (por exemplo, zabbix-frontend), obtido do atributo de recurso service.name do OpenTelemetry.

Comportamento da propriedade:
- somente leitura
resource_attributes object Atributos de recurso de chave-valor do span (por exemplo, host.name: eabf8c2a5ddc).

Comportamento da propriedade:
- somente leitura
scope_name string Nome do escopo de instrumentação que produziu o span.

Comportamento da propriedade:
- somente leitura
scope_version string Versão do escopo de instrumentação.

Comportamento da propriedade:
- somente leitura
span_attributes object Atributos do span de chave-valor do span (por exemplo, db.system: mysql).

Comportamento da propriedade:
- somente leitura
duration integer Duração do span em nanossegundos.

Comportamento da propriedade:
- somente leitura
status_code string Status da operação representada pelo span.

Valores possíveis:
Unset - nenhum status explícito foi atribuído ao span;
Ok - a operação foi concluída com sucesso;
Error - a operação foi concluída com um erro.

Comportamento da propriedade:
- somente leitura
status_message string Informações adicionais, se houver, sobre o status do span.

Comportamento da propriedade:
- somente leitura
events array Array de objetos event do span, ou seja, pontos relevantes no tempo durante a operação (por exemplo, exceções).

Comportamento da propriedade:
- somente leitura
links array Array de objetos link do span, que apontam para spans relacionados no mesmo trace ou em outro trace.

Comportamento da propriedade:
- somente leitura