Objeto de métrica APM

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

Cada propriedade, exceto type, corresponde a uma coluna nas tabelas de métricas (otel_metrics_gauge, otel_metrics_sum, otel_metrics_histogram e otel_metrics_exponential_histogram) da fonte de dados de telemetria. A maioria das propriedades corresponde à coluna com o mesmo nome (por exemplo, a propriedade metric_name corresponde à coluna MetricName). 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.

Métrica de APM

O objeto de métrica de APM representa um ponto de dados de uma métrica (o valor ou os valores agregados de uma medição em um momento específico).

O objeto de métrica de APM tem as seguintes propriedades:

Propriedade Tipo Descrição
type integer Tipo do ponto de dados.

Valores possíveis:
0 - Gauge;
1 - Sum;
2 - Histogram;
3 - Histograma exponencial.

O tipo é determinado pela tabela que contém o ponto de dados: otel_metrics_gauge, otel_metrics_sum, otel_metrics_histogram ou otel_metrics_exponential_histogram.

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

Comportamento da propriedade:
- somente leitura
resource_schema_url string URL, se houver, do schema do OpenTelemetry dos atributos do recurso.

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

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

Comportamento da propriedade:
- somente leitura
scope_attributes object Atributos de chave-valor do escopo de instrumentação.

Comportamento da propriedade:
- somente leitura
scope_schema_url string URL, se houver, do schema do OpenTelemetry do escopo de instrumentação e de seus atributos.

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

Comportamento da propriedade:
- somente leitura
metric_name string Nome da métrica à qual o ponto de dados pertence (por exemplo, http.server.request.duration).

Comportamento da propriedade:
- somente leitura
metric_description string Descrição, se houver, da métrica.

Comportamento da propriedade:
- somente leitura
metric_unit string Unidade, se houver, dos valores da métrica (por exemplo, s ou By; consulte UCUM).

Comportamento da propriedade:
- somente leitura
attributes object Atributos do ponto de dados de chave-valor (por exemplo, http.request.method: POST).

Comportamento da propriedade:
- somente leitura
start_time_unix integer Hora Unix (em nanossegundos) em que o período de medição do ponto de dados começou.

Comportamento da propriedade:
- somente leitura
time_unix integer Hora Unix (em nanossegundos) do ponto de dados.
Para pontos de dados Sum, Histogram e Histograma exponencial, corresponde ao fim do período de medição.

Comportamento da propriedade:
- somente leitura
value float Valor do ponto de dados.
Aplica-se a pontos de dados Gauge e Sum.

Padrão: 0.

Comportamento da propriedade:
- somente leitura
flags integer Máscara de bits dos sinalizadores do ponto de dados.
Se o bit menos significativo estiver definido (valor 1), nenhum valor foi registrado para o ponto de dados.

Comportamento da propriedade:
- somente leitura
exemplars array Matriz de objetos exemplar, ou seja, medições individuais mantidas como exemplos, com o trace e o span durante os quais foram registradas.

Comportamento da propriedade:
- somente leitura
aggregation_temporality integer Como os valores do ponto de dados são agregados ao longo do tempo.
Aplica-se a pontos de dados Sum, Histogram e Histograma exponencial.

Valores possíveis:
0 - (padrão) Não especificado;
1 - Delta (agregado ao longo do período desde o ponto de dados anterior);
2 - Cumulativo (agregado ao longo do período desde start_time_unix).

Comportamento da propriedade:
- somente leitura
is_monotonic boolean Indica se a soma pode apenas aumentar ou permanecer igual ao longo do tempo.
Aplica-se a pontos de dados Sum.

Padrão: false.

Comportamento da propriedade:
- somente leitura
count integer Número de medições no ponto de dados.
Aplica-se a pontos de dados Histogram e Histograma exponencial.

Padrão: 0.

Comportamento da propriedade:
- somente leitura
sum float Soma de todas as medições no ponto de dados.
Aplica-se a pontos de dados Histogram e Histograma exponencial.

Padrão: 0.

Comportamento da propriedade:
- somente leitura
bucket_counts array Matriz de inteiros com o número de medições em cada bucket do histograma.
Os buckets são definidos por explicit_bounds.
Aplica-se a pontos de dados Histogram.

Padrão: [].

Comportamento da propriedade:
- somente leitura
explicit_bounds array Matriz de números de ponto flutuante com os limites entre os buckets do histograma.
Aplica-se a pontos de dados Histogram.

Padrão: [].

Comportamento da propriedade:
- somente leitura
min float Menor valor entre as medições no ponto de dados.
Aplica-se a pontos de dados Histogram e Histograma exponencial.

Padrão: 0.

Comportamento da propriedade:
- somente leitura
max float Maior valor entre as medições no ponto de dados.
Aplica-se a pontos de dados Histogram e Histograma exponencial.

Padrão: 0.

Comportamento da propriedade:
- somente leitura
scale integer Escala do histograma exponencial, que determina os limites e a resolução dos buckets.
Uma escala maior fornece buckets mais estreitos e uma resolução mais precisa; uma escala menor fornece buckets mais largos e uma resolução mais grosseira.
Aplica-se a pontos de dados Histograma exponencial.

Padrão: 0.

Comportamento da propriedade:
- somente leitura
zero_count integer Número de medições no bucket zero do histograma exponencial.
Aplica-se a pontos de dados Histograma exponencial.

Padrão: 0.

Comportamento da propriedade:
- somente leitura
positive_bucket_counts array Matriz de inteiros com o número de medições positivas em cada bucket do histograma exponencial.
Os limites dos buckets são determinados por scale; o índice do primeiro bucket é definido em positive_offset.
Aplica-se a pontos de dados Histograma exponencial.

Padrão: [].

Comportamento da propriedade:
- somente leitura
positive_offset integer Índice do primeiro bucket em positive_bucket_counts.
Aplica-se a pontos de dados Histograma exponencial.

Padrão: 0.

Comportamento da propriedade:
- somente leitura
negative_bucket_counts array Matriz de inteiros com o número de medições negativas em cada bucket do histograma exponencial.
Os limites dos buckets são determinados por scale; o índice do primeiro bucket é definido em negative_offset.
Aplica-se a pontos de dados Histograma exponencial.

Padrão: [].

Comportamento da propriedade:
- somente leitura
negative_offset integer Índice do primeiro bucket em negative_bucket_counts.
Aplica-se a pontos de dados Histograma exponencial.

Padrão: 0.

Comportamento da propriedade:
- somente leitura

Exemplar

O objeto exemplar tem as seguintes propriedades:

Propriedade Tipo Descrição
traceid string ID, se houver, do trace durante o qual a medição foi registrada.
Coluna da fonte de dados: Exemplars.TraceId.
spanid string ID, se houver, do span durante o qual a medição foi registrada.
Coluna da fonte de dados: Exemplars.SpanId.
value float Valor da medição.
Coluna da fonte de dados: Exemplars.Value.
time_unix integer Horário Unix (em nanossegundos) em que a medição foi registrada.
Coluna da fonte de dados: Exemplars.TimeUnix.
filtered_attributes object Atributos de chave-valor da medição que não estão incluídos nos attributes do ponto de dados.
Coluna da fonte de dados: Exemplars.FilteredAttributes.