Objeto de trace APM
Os objetos a seguir estão diretamente relacionados à API apmtrace.
Cada propriedade, exceto span_count e error_count, corresponde a uma coluna na tabela otel_traces da fonte de dados de telemetria.
A maioria das propriedades corresponde à coluna com o mesmo nome (por exemplo, a propriedade span_name corresponde à coluna SpanName).
Quando os nomes são diferentes, as colunas da fonte de dados são especificadas nas tabelas abaixo.
Para obter a lista de colunas, consulte Colunas de dados de telemetria compatíveis.
Trace de APM
O objeto de trace de APM representa um trace (o caminho percorrido por uma solicitação através de suas aplicações e serviços). Um trace consiste em um ou mais spans; cada span representa uma única operação.
O objeto de trace de APM baseia-se no span raiz do trace (o span que inicia o trace e não tem um span pai).
Todas as propriedades contêm dados do span raiz, exceto span_count e error_count, que são calculadas a partir de todos os spans do trace.
O objeto de trace de APM tem as seguintes propriedades:
| Property | Type | Description |
|---|---|---|
| timestamp | integer | Horário Unix (em nanossegundos) em que o span raiz foi iniciado. Comportamento da propriedade: - somente leitura |
| traceid | string | ID do trace, compartilhado por todos os spans que pertencem ao trace. Comportamento da propriedade: - somente leitura |
| spanid | string | ID do 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 raiz (por exemplo, POST /zabbix.php).Comportamento da propriedade: - somente leitura |
| span_kind | string | Função do span raiz. Valores possíveis: Unspecified - o tipo do span não foi especificado;Internal - operação executada dentro de uma aplicação;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 raiz (por exemplo, zabbix-nginx), 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 raiz (por exemplo, host.name: eabf8c2a5ddc).Comportamento da propriedade: - somente leitura |
| scope_name | string | Nome do escopo de instrumentação que produziu o span raiz. 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 raiz (por exemplo, http.method: POST).Comportamento da propriedade: - somente leitura |
| duration | integer | Duração do trace em nanossegundos. Comportamento da propriedade: - somente leitura |
| status_code | string | Status da operação representada pelo span raiz. Valores possíveis: Unset - nenhum status explícito foi atribuído ao span raiz;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 raiz. Comportamento da propriedade: - somente leitura |
| events | array | Array de objetos event do span raiz, ou seja, pontos notáveis no tempo durante a operação (por exemplo, exceções). Comportamento da propriedade: - somente leitura |
| links | array | Array de objetos link do span raiz, que apontam para spans relacionados no mesmo trace ou em outro trace. Comportamento da propriedade: - somente leitura |
| span_count | integer | Número total de spans no trace. Comportamento da propriedade: - somente leitura |
| error_count | integer | Número de spans no trace com status_code definido como Error.Comportamento da propriedade: - somente leitura |
Evento
O objeto de evento tem as seguintes propriedades.
| Property | Type | Description |
|---|---|---|
| timestamp | integer | Hora Unix (em nanossegundos) em que o evento ocorreu. Coluna da fonte de dados: Events.Timestamp |
| name | string | Nome do evento. Coluna da fonte de dados: Events.Name |
| attributes | object | Atributos de chave-valor com informações adicionais, se houver, sobre o evento. Coluna da fonte de dados: Events.Attributes |
Link
O objeto link tem as seguintes propriedades.
| Property | Type | Description |
|---|---|---|
| traceid | string | ID do trace que contém o span vinculado. Coluna da fonte de dados: Links.TraceId |
| spanid | string | ID do span vinculado. Juntamente com traceid, identifica exclusivamente o span vinculado.Coluna da fonte de dados: Links.SpanId |
| trace_state | string | Estado do trace, se houver, do span vinculado (consulte W3C Trace Context). Coluna da fonte de dados: Links.TraceState |
| attributes | object | Atributos de chave-valor com informações adicionais sobre o link. Coluna da fonte de dados: Links.Attributes |