Referência de métricas do OpenTelemetry do Elasticsearch

Este guia de referência fornece uma visão geral abrangente de todas as métricas coletadas pela integração do Elasticsearch com OpenTelemetry, ajudando você a entender quais dados estão disponíveis para monitorar a saúde e o desempenho do seu cluster.

Métricas-chave em um relance

Monitore a integridade e o desempenho do seu cluster Elasticsearch com estas métricas essenciais:

Categoria de métrica	O que ele mede	Prioridade
Integridade do cluster	`elasticsearch.cluster.health` - Status geral do cluster (verde/amarelo/vermelho)	🔴 Crítico
Status do shard	`elasticsearch.cluster.shards` - Shards não atribuídos, realocando ou inicializando	🔴 Crítico
Disponibilidade do nó	`elasticsearch.cluster.data_nodes` - Nós de dados ativos no cluster	🔴 Crítico
Uso do heap da JVM	`jvm.memory.heap.utilization` - Porcentagem de uso da memória	🔴 Crítico
Desempenho da pesquisa	`elasticsearch.node.operations.time` - Latência de consulta e busca	🟡 Importante
Uso de recursos	`system.cpu.utilization` , `system.memory.usage` - Recursos do sistema host	🔵 Monitoramento

Referência completa de métricas

A integração coleta mais de 50 métricas no cluster, nó, JVM e infraestrutura de host. Expanda as seções abaixo para especificações detalhadas das métricas.

Dica

Para o catálogo completo de métricas disponíveis, consulte a documentação do OpenTelemetry elasticsearchreceiver e hostmetricsreceiver.

Métrica	Descrição	Atributo
`elasticsearch.cluster.health`	O status de integridade do cluster.	—
`elasticsearch.cluster.in_flight_fetch`	Operações de busca de shard ainda em andamento.	—
`elasticsearch.cluster.nodes`	Contagem total de nós do cluster.	—
`elasticsearch.cluster.data_nodes`	O número de nós de dados no cluster.	—
`elasticsearch.cluster.shards`	O número de fragmentos no cluster.	—
`elasticsearch.cluster.pending_tasks`	Tarefas pendentes no nível do cluster aguardando execução.	—
`elasticsearch.cluster.state_update.time`	Tempo cumulativo gasto na atualização do estado do cluster.	`state` (qualquer) `type` (computação, context_construction, commit, conclusão, master_apply, notificação)

aggregation

(primary_shards | total)

aggregation

(primary_shards | total)

operation

(index, delete, get, query, fetch, scroll, suggest, merge, refresh, flush, warmer)

aggregation

(primary_shards | total)

Métrica	Descrição	Atributo
`elasticsearch.index.documents`	Documentos por índice, divididos por estado.	`state` (ativo \| excluído) `aggregation` (primary_shards \| total)
`elasticsearch.index.operations.merge.current`	Operações de mesclagem de segmento ativas.	`aggregation` (primary_shards \| total)
`elasticsearch.index.operations.time`	Tempo gasto em operações no nível do índice.	`operation` (index, delete, get, query, fetch, scroll, suggest, merge, refresh, flush, warmer) `aggregation` (primary_shards \| total)
`elasticsearch.index.shards.size`	O tamanho dos fragmentos atribuídos a este índice.
`elasticsearch.index.segments.count`	Número de segmentos de um índice.
`elasticsearch.index.operations.completed`	O número de operações concluídas para um índice.

Métrica	Descrição	Atributo
`elasticsearch.node.cache.count`	Acertos e erros do cache de consulta em todos os fragmentos do nó.	`type` (acerto \| falha)
`elasticsearch.node.cache.evictions`	Evicções de cache de nó.	`cache_name` (fielddata \| query)
`elasticsearch.node.cache.memory.usage`	Uso de memória cache em bytes.	`cache_name` (fielddata \| query)
`elasticsearch.node.cluster.io`	E/S de rede interna do cluster em bytes.	`direction` (recebido \| enviado)
`elasticsearch.node.documents`	Documentos hospedados pelo nó.	`state` (ativo \| excluído)
`elasticsearch.node.disk.io.read`	Taxa de transferência de leitura de disco (KiB) em todos os armazenamentos de arquivos.	—
`elasticsearch.node.disk.io.write`	Taxa de transferência de gravação em disco (KiB) em todos os armazenamentos de arquivos.	—
`elasticsearch.node.fs.disk.available`	Disco disponível para a JVM.	—
`elasticsearch.node.fs.disk.total`	Capacidade total do disco no nó.	—
`elasticsearch.node.http.connections`	Conexões HTTP atendidas pelo nó.	—
`elasticsearch.node.ingest.documents.current`	Documentos sendo ingeridos no momento.	—
`elasticsearch.node.ingest.operations.failed`	Falhas cumulativas de ingestão.	—
`elasticsearch.node.open_files`	Descritores de arquivo abertos em uso.	—
`elasticsearch.node.operations.completed`	Operações concluídas pelo nó.	`operation` (índice, exclusão, obtenção, consulta, busca, rolagem, sugestão, mesclagem, atualização, liberação, aquecedor)
`elasticsearch.node.operations.current`	Operações em andamento.	`operation` (mesmo conjunto)
`elasticsearch.node.operations.get.completed`	Acertos e erros GET.	`result` (acerto \| falha)
`elasticsearch.node.operations.time`	Tempo gasto em operações por um nó..	`Operation` (indexar \| excluir\| obter\| consultar\| buscar\| rolar\| sugerir\| mesclar\| atualizar\| descarregar\| aquecer)
`elasticsearch.node.shards.reserved.size`	Crescimento previsto do shard devido a recuperações.	—
`elasticsearch.node.shards.size`	O tamanho dos shards atribuídos a este nó.	—

Métrica	Descrição	Atributo
`elasticsearch.os.cpu.load_avg.1m`	Média de carga do sistema operacional de um minuto.	—
`elasticsearch.os.cpu.load_avg.5m`	Média de carga do sistema operacional em cinco minutos.	—
`elasticsearch.os.cpu.load_avg.15m`	Média de carga do sistema operacional nos últimos quinze minutos.	—
`elasticsearch.os.cpu.usage`	Uso recente da CPU para todo o sistema ou -1 se não for suportado.
`elasticsearch.os.memory`	Uso de memória física conforme visto pelo Elasticsearch.	`state` (livre \| usado)
`jvm.gc.collections.count`	Total de execuções de coleta de lixo.	`name` (nome do coletor)
`jvm.gc.collections.elapsed`	Tempo gasto na coleta de lixo.	`name` (nome do coletor)
`jvm.memory.heap.max`	Memória heap máxima disponível.	—
`jvm.memory.heap.used`	Memória heap atualmente em uso.	—
`jvm.memory.heap.utilization`	Fração do uso de memória heap.	—
`jvm.threads.count`	Contagem de threads JVM ativos.	—

Métrica	Descrição	Atributo
`system.cpu.time`	Tempo cumulativo da CPU dividido por estado.	`cpu` (CPU lógica) `state` (ocioso\| interrupção\| nice\| softirq\| steal\| sistema\| usuário\| espera)
`system.cpu.utilization`	Diferença no system.cpu.time desde a última medição por CPU lógica, dividida pelo tempo decorrido (valor no intervalo [0,1]).	`cpu` (CPU lógica) `state` (mesmo conjunto que acima)
`system.cpu.load_average.1m`	Média de carga do sistema de um minuto.	—
`system.cpu.load_average.5m`	Média de carga do sistema em cinco minutos.	—
`system.cpu.load_average.15m`	Média de carga do sistema de quinze minutos.	—
`system.memory.utilization`	Taxa de utilização da memória.	`state` (usado)
`system.memory.usage`	Bytes de memória em uso..	`state` (buffered\| cached\| inactive\| free\| slab_reclaimable\| slab_unreclaimable\| used)
`system.disk.io`	Taxa de transferência de E/S de disco por dispositivo.	`device` (disco) `direction` (leitura \| escrita)
`system.disk.operations`	Operações de disco por dispositivo.	`device` `direction` (leitura \| gravação)
`system.filesystem.usage`	Capacidade do sistema de arquivos por estado.	`device` `state` (usado \| livre \| reservado)
`system.filesystem.utilization`	Taxa de utilização do sistema de arquivos.	`device` `state` (usado)
`system.network.io`	Bytes de rede por interface.	`interface` `direction` (receive \| transmit)
`system.network.packets`	Pacotes de rede por interface.	`interface` `direction` (receive \| transmit)
`process.cpu.utilization`	Porcentagem do tempo total da CPU usado pelo processo desde a última coleta, expressa como um valor entre 0 e 1.	`process.pid` (PID) `process.executable.name` (nome binário) `process.owner` (usuário) `state` (usuário \| sistema \| outro)

Atributos de recurso por tipo de implantação

Todas as métricas do Elasticsearch incluem atributos de recurso (tags) que ajudam você a organizar e filtrar seus dados no New Relic. Os atributos específicos dependem de como você implantou o Elasticsearch:

Atributos comuns (todas as implantações)

Cada implantação inclui estes identificadores principais do Elasticsearch:

Atributo	Descrição
`elasticsearch.cluster.name`	O nome exclusivo do seu cluster Elasticsearch
`elasticsearch.node.name`	Identificador de nó individual do Elasticsearch

Implantações baseadas em host

Para o Elasticsearch executado diretamente em hosts ou VMs, você verá atributos adicionais de infraestrutura do host:

Atributo	Descrição
`host.name`	Nome do host onde o Elasticsearch está sendo executado
`os.type`	Sistema operacional (linux, windows, darwin)

Implantações do Kubernetes

As implantações do Kubernetes incluem atributos adicionais de orquestração de contêineres para visibilidade aprimorada:

Atributo	Descrição
`k8s.cluster.name`	Nome do seu cluster Kubernetes
`k8s.namespace.name`	O namespace onde o Elasticsearch está sendo executado
`k8s.pod.name`	O nome específico do pod do Elasticsearch
`k8s.pod.uid`	Identificador único do pod
`k8s.deployment.name`	Nome da implantação do Kubernetes (se estiver usando Deployment)

Usando atributos de recurso de forma eficaz

Esses atributos permitem cenários de monitoramento poderosos:

Gerenciamento de múltiplos ambientes:

Filtrar dashboards por elasticsearch.cluster.name para produção vs staging
Criar políticas de alerta específicas do cluster
Compare o desempenho em diferentes ambientes

Correlação de infraestrutura:

Use host.name ou k8s.pod.name para correlacionar com o monitoramento de infraestrutura
Acompanhe a utilização de recursos no nível do host ou do pod
Identifique padrões de desempenho em sua infraestrutura

Monitoramento específico para Kubernetes:

Monitore o Elasticsearch em vários namespaces
Rastreie os eventos do ciclo de vida do pod e seu impacto no desempenho
Crie alertas com base na integridade da implantação do Kubernetes

Próximos passos

Agora que você entende quais métricas estão disponíveis, aqui estão seus próximos passos para um monitoramento eficaz do Elasticsearch:

Instalação e configuração:

Instalação no host - Configure o monitoramento para o Elasticsearch em execução em hosts/VMs
Instalação no Kubernetes - Configure o monitoramento para o Elasticsearch em execução no Kubernetes

Configurar monitoramento e alertas:

Visualize seus dados - Saiba como acessar dashboards e explorar suas métricas do Elasticsearch no New Relic
Criar alertas - Configure o monitoramento proativo com o modo guiado ou condições de alerta NRQL
Consultas NRQL - Escreva consultas personalizadas para analisar seus dados de desempenho do Elasticsearch

Esta tradução de máquina é fornecida para sua comodidade.

Referência de métricas do OpenTelemetry do Elasticsearch

Métricas-chave em um relance

Referência completa de métricas

Dica

Métricas de cluster(elasticsearchreceiver)

Métricas de atividade do índice (elasticsearchreceiver)

Métricas de atividade e carga de trabalho do nó (elasticsearchreceiver)

Métricas JVM & OS relatadas pelo Elasticsearch (elasticsearchreceiver)

Métricas da infraestrutura do host (hostmetricsreceiver)

Atributos de recurso por tipo de implantação

Atributos comuns (todas as implantações)

Implantações baseadas em host

Implantações do Kubernetes

Usando atributos de recurso de forma eficaz

Próximos passos

Esta tradução de máquina é fornecida para sua comodidade.

Referência de métricas do OpenTelemetry do Elasticsearch

Métricas-chave em um relance.css-21sua1{background:none;border:none;width:0;padding:0;}

Referência completa de métricas

Dica

Métricas de atividade do índice (elasticsearchreceiver)

Métricas de atividade e carga de trabalho do nó (elasticsearchreceiver)

Métricas JVM & OS relatadas pelo Elasticsearch (elasticsearchreceiver)

Métricas da infraestrutura do host (hostmetricsreceiver)

Atributos de recurso por tipo de implantação

Atributos comuns (todas as implantações)

Implantações baseadas em host

Implantações do Kubernetes

Usando atributos de recurso de forma eficaz

Próximos passos

Métricas-chave em um relance