Métricas
Visão geral
A seção APM > Métricas exibe pontos de dados de métricas coletados de seus aplicativos e serviços.
Uma métrica é uma medição (por exemplo, duração de uma solicitação, número de pedidos processados ou uso de memória). Os aplicativos enviam seus valores como pontos de dados que contêm o valor (ou valores agregados) medido em um momento específico. Uma métrica é semelhante a um item do Zabbix, e um ponto de dados é semelhante a um valor desse item.
Um ponto de dados pode ser de um dos seguintes tipos:
- Gauge - um valor medido em um momento específico (por exemplo, uso atual de memória).
- Sum - uma soma de medições ao longo de um período (por exemplo, número total de solicitações).
- Histograma - o número de medições ao longo de um período que se enquadram em cada uma de várias faixas de valores fixas, chamadas de buckets (por exemplo, quantas solicitações levaram de 0 a 100 ms, de 100 a 250 ms ou de 250 a 500 ms).
- Histograma exponencial - semelhante a um histograma, mas cada bucket é mais amplo que o anterior pelo mesmo fator (por exemplo, 1-2 ms, 2-4 ms, 4-8 ms).
Cada ponto de dados é produzido por um serviço (por exemplo, zabbix-frontend; nomeado pelo atributo de recurso service.name do OpenTelemetry) e por um escopo de instrumentação, a parte do código que o criou (por exemplo, uma biblioteca que mede a duração de solicitações HTTP).
Para fornecer contexto sobre cada medição, os pontos de dados também têm atributos de chave-valor: atributos do ponto de dados descrevem o que foi medido e distinguem pontos de dados da mesma métrica (por exemplo, http.request.method: POST), enquanto atributos de recurso descrevem o serviço e o ambiente em que ele é executado (por exemplo, host.name: eabf8c2a5ddc).
Para obter mais detalhes sobre métricas, consulte a documentação do OpenTelemetry.
A seção APM > Métricas contém os seguintes elementos:
- Botão Modo quiosque - exibe apenas o conteúdo da página, sem o menu e o cabeçalho.
- Seletor de período - seleciona o período para o qual os pontos de dados serão exibidos.
- Filtro - exibe apenas os pontos de dados de seu interesse.
- Lista de métricas - exibe os pontos de dados.
- Detalhes da métrica - exibe os detalhes do ponto de dados selecionado.
Lista de métricas
Cada linha na lista de métricas representa um ponto de dados.
Os pontos de dados são exibidos em uma tabela personalizável.
O botão 
Personalizar tabela, no cabeçalho da tabela, permite mostrar, ocultar ou reordenar colunas e redefinir o layout para o padrão.
Você também pode redimensionar cada coluna arrastando sua borda direita; clique duas vezes na borda para redefinir o tamanho.
Todas as personalizações são aplicadas imediatamente e lembradas para o usuário atual.
A lista de métricas pode conter as seguintes colunas:
Cada coluna, exceto Tipo, 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; para obter a lista de colunas, consulte Colunas de dados de telemetria compatíveis.
A maioria das colunas tem o mesmo nome que na fonte de dados (por exemplo, Nome da métrica corresponde à coluna MetricName).
Quando os nomes diferem, a coluna da fonte de dados é especificada na tabela abaixo.
| Coluna | Descrição |
|---|---|
| Nome da métrica | Métrica à qual o ponto de dados pertence (por exemplo, http.server.duration). |
| Tipo | Tipo do ponto de dados: Gauge, Sum, Histogram ou Exponential histogram. Determinado pela tabela de métricas que contém o ponto de dados. |
| Unidade | Unidade, se houver, dos valores da métrica (por exemplo, s ou By; consulte UCUM).Coluna da fonte de dados: MetricUnit. |
| Nome do serviço | Serviço que produziu o ponto de dados. |
| Nome do escopo | Escopo de instrumentação que produziu o ponto de dados. |
| Hora de início | Data e hora em que o período de medição do ponto de dados começou. Coluna da fonte de dados: StartTimeUnix. |
| Soma/Valor | Soma de todas as medições (Histogram, Exponential histogram) ou o valor (Gauge, Sum) do ponto de dados. |
| Contagem | Número de medições em um ponto de dados Histogram ou Exponential histogram. |
| Hora | Data e hora do ponto de dados; para pontos de dados Sum, Histogram e Exponential histogram, o fim do período de medição. Coluna da fonte de dados: TimeUnix. |
| Flags | Flags do ponto de dados: 0 - nenhuma flag está definida. 1 - nenhum valor foi registrado para o ponto de dados. |
| Temporalidade da agregação | Como os valores de um ponto de dados Sum, Histogram ou Exponential histogram são agregados ao longo do tempo: Não especificada - não especificada. Delta - agregados durante o período desde o ponto de dados anterior. Cumulativa - agregados durante o período desde a hora de início. |
| Descrição da métrica | Descrição, se houver, da métrica. |
| Atributos | Atributos do ponto de dados. Clique no botão de três pontos  para exibir todos os atributos. |
| Atributos do recurso | Atributos do recurso do ponto de dados. Clique no botão de três pontos para exibir todos os atributos. |
| Atributos do escopo | Atributos do escopo de instrumentação. Clique no botão de três pontos para exibir todos os atributos. |
Detalhes da métrica
Clique em um ponto de dados na lista de métricas para abrir o painel de detalhes da métrica, que exibe todas as informações sobre o ponto de dados.
O painel de detalhes da métrica pode conter as seguintes seções:
| Seção | Descrição |
|---|---|
| Informações básicas | Nome da métrica, tipo, unidade, nome do serviço e hora de início. |
| Histograma | Buckets (por exemplo, > 5 - 10), cada um com o número de medições nele.Exibido somente para pontos de dados do tipo Histograma. |
| Histograma exponencial | Buckets (por exemplo, >= 249.7885 - 249.7887), cada um com o número de medições nele.Exibido somente para pontos de dados do tipo Histograma exponencial. |
| Informações da métrica | Valores do ponto de dados, que dependem do tipo, além da descrição da métrica, hora, flags e URL do esquema do recurso. |
| Atributos | Atributos do ponto de dados. |
| Atributos do recurso | Atributos do recurso. |
| Atributos do escopo | Atributos, se houver, do escopo de instrumentação. |
| Escopo | Nome, versão e URL do esquema do escopo de instrumentação. |
Usando o filtro
Você pode usar o filtro para exibir apenas os pontos de dados nos quais está interessado.
Para filtrar por atributos, insira a chave do atributo, selecione o operador e insira o valor do atributo.
Os seguintes operadores são compatíveis:
- Contém - (padrão) o valor do atributo contém a string inserida.
- É igual a - o valor do atributo é igual à string inserida.
- Não contém - o valor do atributo não contém a string inserida.
- Não é igual a - o valor do atributo não é igual à string inserida.
- Existe - o atributo com a chave inserida existe.
- Não existe - o atributo com a chave inserida não existe.
Se você adicionar várias condições, selecione como avaliá-las:
- E/Ou - (padrão) todas as condições devem ser atendidas; as condições com a mesma chave de atributo são combinadas com Ou.
- Ou - pelo menos uma condição deve ser atendida.