Referência de métricas do Redis (OpenTelemetry)

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

Métricas-chave em um relance

Monitore a integridade e o desempenho da sua instância do Redis com estas métricas essenciais:

Categoria de métrica	O que ele mede	Prioridade
Utilização da memória	`redis.memory.used` , `redis.maxmemory` — Consumo atual de memória versus limite configurado	Crítico
Taxa de ocorrência no cache	`redis.keyspace.hits` , `redis.keyspace.misses` — Proporção de buscas de chaves bem-sucedidas	Crítico
Evicções de chaves	`redis.keys.evicted` — Chaves removidas devido à pressão de memória	Crítico
Comandos/s	`redis.commands` , `redis.commands.processed` — taxas de transferência de comandos sendo executados	Importante
Clientes conectados	`redis.clients.connected` , `redis.clients.blocked` — Conexões ativas e em espera	Importante
Taxa de fragmentação	`redis.memory.fragmentation_ratio` — Proporção entre a memória alocada pelo sistema operacional e a memória alocada pelo Redis	Monitoramento
Integridade do cluster	`redis.cluster.state` , `redis.cluster.slots_ok` , `redis.cluster.known_nodes` — Status geral do cluster e cobertura de slots (apenas modo Cluster)	Crítico

Referência completa de métricas

A integração coleta mais de 30 métricas de instância em comandos, memória, keyspace, conexões e replicação — além de 9 métricas específicas de cluster para implantações do Redis Cluster. Expanda as seções abaixo para obter especificações detalhadas das métricas.

Dica

Para o catálogo upstream completo, consulte a documentação do redisreceiver do OpenTelemetry.

Métrica	Descrição	Atributo
`redis.clients.blocked`	Número de clientes pendentes em uma chamada de bloqueio.	—
`redis.clients.connected`	Número de conexões de clientes (excluindo réplicas).	—
`redis.clients.max_input_buffer`	Maior buffer de entrada entre as conexões de cliente atuais (bytes).	—
`redis.clients.max_output_buffer`	Lista de saída mais longa entre as conexões de cliente atuais (bytes).	—

Métrica	Descrição	Atributo
`redis.commands`	Número de comandos processados por segundo (instantâneo).	—
`redis.commands.processed`	Número total de comandos processados pelo servidor.	—
`redis.cmd.calls`	Número total de chamadas para um comando.	`cmd`
`redis.cmd.latency`	Latência de execução de comando (segundos).	`cmd` , `percentile`
`redis.cmd.usec`	Tempo total para todas as execuções de um comando (microssegundos).	`cmd`

Métrica	Descrição	Atributo
`redis.memory.used`	Total de bytes alocados pelo Redis usando seu alocador.	—
`redis.memory.peak`	Pico de memória consumida pelo Redis (bytes).	—
`redis.memory.rss`	Número de bytes alocados conforme visto pelo sistema operacional.	—
`redis.memory.lua`	Número de bytes usados pelo mecanismo Lua.	—
`redis.memory.fragmentation_ratio`	Proporção de memória alocada pelo sistema operacional em relação à memória alocada pelo Redis.	—
`redis.maxmemory`	O valor da diretiva de configuração maxmemory (bytes).	—

Métrica	Descrição	Atributo
`redis.keyspace.hits`	Número de pesquisas bem-sucedidas de chaves no dicionário principal.	—
`redis.keyspace.misses`	Número de falhas na pesquisa de chaves no dicionário principal.	—
`redis.keys.evicted`	Número de chaves despejadas devido ao limite máximo de memória.	—
`redis.keys.expired`	Número total de eventos de expiração de chave.	—
`redis.db.keys`	Número de chaves do keyspace.	`db`
`redis.db.expires`	Número de chaves de keyspace com uma expiração.	`db`
`redis.db.avg_ttl`	TTL médio das chaves de keyspace (milissegundos).	`db`

Métrica	Descrição	Atributo
`redis.connections.received`	Número total de conexões aceitas pelo servidor.	—
`redis.connections.rejected`	Número de conexões rejeitadas devido ao limite máximo de clientes.	—
`redis.net.input`	Número total de bytes lidos da rede.	—
`redis.net.output`	Número total de bytes gravados na rede.	—

Métrica	Descrição	Atributo
`redis.slaves.connected`	Número de réplicas conectadas.	—
`redis.replication.offset`	O deslocamento de replicação atual do servidor (bytes).	—
`redis.replication.backlog_first_byte_offset`	O deslocamento mestre do buffer de backlog de replicação (bytes).	—
`redis.role`	Função de replicação desta instância do Redis.	—

Métrica	Descrição	Atributo
`redis.uptime`	Número de segundos desde a inicialização do servidor Redis.	—
`redis.cpu.time`	Tempo de CPU consumido pelo Redis (segundos).	`state`
`redis.latest_fork`	Duração da última operação de fork (microssegundos).	—
`redis.rdb.changes_since_last_save`	Número de alterações desde o último dump do RDB.	—

Métrica de cluster

Essas métricas estão disponíveis apenas durante o monitoramento do Redis no modo Cluster. Elas exigem a ativação das métricas do cluster no receptor do Redis (todas as métricas do cluster estão desativadas por padrão) ou o uso da abordagem do receptor do Prometheus com redis_exporter --is-cluster.

Métrica	Descrição	Tipo
`redis.cluster.state`	Status de saúde geral do cluster. 1 = OK (todos os slots servidos), 0 = FAIL (um ou mais slots indisponíveis).	Medidor
`redis.cluster.slots_assigned`	Número de slots de hash mapeados para nós. Deve ser 16.384 para um cluster totalmente operacional.	Medidor
`redis.cluster.slots_ok`	Número de slots que atendem ativamente a requests sem problemas.	Medidor
`redis.cluster.slots_pfail`	Número de slots no estado PFAIL (falha provável) — suspeita-se que um nó esteja inacessível, mas ainda não confirmado.	Medidor
`redis.cluster.slots_fail`	Número de slots em estado FAIL confirmado — NÃO atendendo ao tráfego.	Medidor
`redis.cluster.known_nodes`	Número total de nós (mestres + réplicas) visíveis no cluster.	Medidor
`redis.cluster.node.count`	Número de nós mestre servindo atualmente slots de hash.	Medidor
`redis.cluster.stats_messages_sent`	Total de mensagens do barramento do cluster enviadas (ping, pong, meet, fail). O tráfego constante indica um protocolo gossip saudável.	Cumulativo
`redis.cluster.stats_messages_received`	Total de mensagens do barramento do cluster recebidas de nós pares. Uma queda repentina indica uma possível partição de rede.	Cumulativo

Dica

Todos os nós em um Cluster do Redis relatam métricas do cluster idênticas (CLUSTER INFO retorna os mesmos dados de qualquer nó). Você pode ativar o monitoramento do cluster em todos os nós para resiliência ou em um único nó para minimizar dados redundantes. Para a abordagem do receptor do Prometheus, use redis_exporter --is-cluster, que coleta automaticamente essas métricas.

Atributos de recurso

Os atributos de recurso são anexados a todas as métricas e ajudam você a filtrar e agrupar seus dados no New Relic.

Atributo	Descrição
`server.address`	Nome do host ou IP do servidor Redis
`server.port`	Número da porta do servidor Redis
`redis.instance.id`	Identificador personalizado para a instância do Redis
`redis.version`	Versão do servidor Redis
`host.name`	Nome do host onde o coletor está sendo executado
`host.id`	Identificador exclusivo do host
`k8s.cluster.name`	Nome do cluster do Kubernetes
`k8s.namespace.name`	Namespace do Kubernetes
`k8s.pod.name`	Nome do pod do Kubernetes
`redis.cluster.name`	Nome do Redis Cluster definido pelo usuário (presente apenas nas métricas de cluster)
`instrumentation.provider`	Sempre `opentelemetry`
`otel.library.name`	Nome da biblioteca de instrumentação

Próximos passos:

Instalação no host: configure o monitoramento para o Redis em execução em hosts/VMs
Instalação no Kubernetes: configure o monitoramento para o Redis no Kubernetes
Visualize seus dados: Explore dashboards e configure alertas
Solucionar problemas: resolva problemas comuns com a coleta de dados

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

Referência de métricas do Redis (OpenTelemetry)

Métricas-chave em um relance

Referência completa de métricas

Dica

Métricas do cliente

Métricas de comando

Métrica de memória

Métrica keyspace

Métricas de conexão e rede

Métricas de replicação

Métricas de servidor e persistência

Métrica de cluster

Dica

Atributos de recurso

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

Referência de métricas do Redis (OpenTelemetry)

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 comando

Métrica de memória

Métrica keyspace

Métricas de conexão e rede

Métricas de replicação

Métricas de servidor e persistência

Métrica de cluster

Dica

Atributos de recurso

Métricas-chave em um relance