Redis monitoramento integração

Nossa integração Redis reporta dados críticos de desempenho do seu servidor Redis para produtos New Relic. Você pode visualizar esses dados métricos e dados de inventário em um painel pré-construído, criar políticas de alertas e criar consultas e gráficos personalizados. Você também pode especificar chaves que são importantes para o seu aplicativo e obter informações sobre seu comprimento.

Continue lendo para instalar a integração e ver quais dados coletamos.

Compatibilidade e requisitos

Nossa integração é compatível com as versões do Redis 3.0 a 7.0.

Antes de instalar a integração, certifique-se de atender aos seguintes requisitos:

Uma conta New Relic . Não tem um? Cadastre-se gratuitamente! Não é necessário cartão de crédito.
Se o Redis não estiver em execução no Kubernetes ou no Amazon ECS, você deverá instalar o agente de infraestrutura em um host do sistema operacional Linux que esteja executando o Redis. De outra forma:
- Se estiver executando no Kubernetes, consulte estes requisitos.
- Se estiver executando no ECS, consulte estes requisitos.

A integração obtém dados executando comandos Redis:

ComandoINFO : Os dados do comando INFO preenchem dados métricos e alguns dados de inventário.
ComandoCONFIG GET : a maioria dos dados de inventário vem deste comando.
- Na instalação gerenciada Redis sem permissões para executar o comando CONFIG (por exemplo, AWS ElastiCache), a execução deste comando pode ser desabilitada com a opção de configuração config_inventory: false.
Aquisição do comprimento da chave: Dependendo do tipo de chave, estes comandos são usados:
- LLEN para list
- SCARD para set
- ZCOUNT para zset
- HLEN para o tipo hash .

Para a coleta de dados de comprimento de chave, o agente usa pipeline para minimizar o impacto no desempenho do Redis. No entanto, se você estiver coletando o comprimento de muitas chaves, o desempenho do Redis poderá ser afetado. Por esta razão, o agente inclui um limite de chave padrão (mas este limite pode ser sobrescrito).

Importante

Se você editou os nomes dos comandos Redis mencionados acima, a integração não será capaz de recuperar os dados do Redis.

Começo rápido

Instrua seu servidor Redis rapidamente e envie seus dados de telemetria com instalação guiada. Nossa instalação guiada cria um comando CLI personalizado para o seu ambiente que baixa e instala a CLI do New Relic e o agente de infraestrutura.

Pronto para começar? Clique em um desses botões para experimentar.

Instalação guiada

UE instalação guiada

Instalar e ativar

Para instalar a integração do Redis, siga as instruções para seu ambiente:

Notas Adicionais:

Advanced:
integração também estão disponíveis em formato tarball para permitir a instalação fora de um gerenciador de pacote.
On-host integrations do not automatically update.
Para obter melhores resultados, atualize regularmente o pacote de integração e o agente de infraestrutura.

' '

Instale o agente de infraestrutura e substitua a variável INTEGRATION_FILE_NAME por nri-redis.
Altere o diretório para a pasta integração configuração:
bash
```
$cd /etc/newrelic-infra/integrations.d
```
Copie o arquivo de configuração de amostra:
bash
```
$sudo cp redis-config.yml.sample redis-config.yml
```
Edite o arquivo redis-config.yml com base nos métodos de conexão do servidor Redis:
Se você se conectar usando soquete Unix, especifique unix_socket_path no arquivo de configuração. Se houver mais de uma instância do Redis usando soquetes Unix, certifique-se de definir use_unix_socket como true no arquivo de configuração.
Certifique-se de que o usuário que está executando a integração do Redis tenha as permissões corretas para acessar esse soquete Unix. As permissões do soquete Unix são definidas na configuração do Redis (valor de unixsocketperm).
Se necessário, defina outras configurações do arquivo de configuração com base na configuração do Redis, conforme descrito em Configuração.
Para ativar a análise automática de log e encaminhamento de erros Redis, copie (ou renomeie) o arquivo redis-log.yml.example para redis-log.yml. Não há necessidade de reiniciar o agente.
Example:
bash
```
$sudo cp /etc/newrelic-infra/logging.d/redis-log.yml.example /etc/newrelic-infra/logging.d/redis-log.yml
```

Baixe a imagem do instalador nri-redis .MSI em:
https://download.newrelic.com/infrastructure_agent/windows/integrations/nri-redis/nri-redis-amd64.msi
Para instalar a partir do prompt de comando do Windows, execute:
bash
```
$msiexec.exe /qn /i PATH\TO\nri-redis-amd64.msi
```
ou clique duas vezes no arquivo no Explorer.
No diretório integração, C:\Program Files\New Relic\newrelic-infra\integrations.d\, crie uma cópia do arquivo de configuração de amostra executando:
bash
```
$copy redis-win-config.yml.sample redis-win-config.yml
```
Edite o arquivo redis-win-config.yml conforme descrito nas definições de configuração.

Este documento ajudou você na instalação?

Crie um usuário New Relic para seu servidor Redis

Se você estiver usando o Redis 6+ e listas de controle de acesso (ACLs) para controlar o acesso à sua instância, convém criar um usuário newrelic para a integração. Use este comando para criar e conceder as permissões necessárias ao seu usuário:

bash

$ACL SETUSER newrelic on >'YOUR_SELECTED_PASSWORD' ~* +INFO +CONFIG|GET +SELECT +TYPE +LLEN +SCARD +ZCOUNT +HLEN

Configurar a integração

Existem diversas formas de configurar a integração, dependendo de como ela foi instalada:

Se habilitado via Kubernetes: consulte Monitorar serviços em execução no Kubernetes.
Se habilitado via Amazon ECS: consulte Monitorar serviços em execução no ECS.
Se instalado no host: edite a configuração no arquivo de configuração YAML da integração redis-config.yml.

Use a configuração YAML para colocar as credenciais de login necessárias e configurar como seus dados são coletados, dependendo de sua configuração e preferência.

O arquivo de configuração possui configurações comuns aplicáveis a todas as integração, como interval, timeout, inventory_source. Para saber mais sobre essas configurações comuns, consulte nosso formato de configuração YAML.

Importante

Se você ainda estiver usando nossos arquivos de configuração/definição de legado, use nosso foramt de configuração padrão mais antigo.

Configurações específicas relacionadas ao Redis são definidas usando a seção env do arquivo de configuração. Essas configurações controlam a conexão com sua instância Redis, bem como outras configurações e recursos de segurança.

Configurações de instância do Redis

A integração Redis coleta informações métricas(M) e de inventário(I). Na tabela, use a coluna Applies To para as configurações disponíveis para cada coleção:

' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' '

Contexto	Descrição	Padrão	Aplica-se a
`HOSTNAME`	Nome do servidor Redis do host.	`localhost`	MI
`PORT`	Porta onde o servidor Redis está escutando.	`6379`	MI
`USERNAME`	Nome de usuário a ser usado ao conectar-se ao servidor Redis. Use apenas com Redis 6+ se a ACL estiver habilitada.	N/A	MI
`PASSWORD`	Senha a ser usada ao conectar-se ao servidor Redis. Use somente com servidores Redis se `REQUIREPASS` ou ACL estiver ativado.	N/A	MI
`UNIX_SOCKET_PATH`	Caminho para o arquivo de soquete Unix no qual o servidor Redis está escutando. Use isto em vez de nome do Host/Port.	N/A	MI
`USE_UNIX_SOCKET`	Defina como `true` para identificar exclusivamente a entidade do monitor ao usar soquetes Unix.	`false`	MI
`USE_TLS`	Use TLS ao se comunicar com o servidor Redis.	`false`	MI
`TLS_INSECURE_SKIP_VERIFY`	Desative a verificação do nome do servidor ao conectar-se por TLS.	`false`	MI
`KEYS`	Lista das chaves para recuperar seus comprimentos.	N/A	M
`KEYS_LIMIT`	Número máximo de chaves para recuperar seus comprimentos.	`30`	M
`CONFIG_INVENTORY`	Defina como 'false' em ambientes onde o comando Redis CONFIG não é permitido (por exemplo, AWS ou ElastiCache).	`true`	EU
`RENAMED_COMMANDS`	Mapeie os comandos padrão do Redis para seu formato renomeado.	N/A	MI
`REMOTE_MONITORING`	Habilite o monitoramento de multilocação.	`true`	MI
`METRICS`	Defina como `true` para ativar a coleta somente de métricas.	`false`
`INVENTORY`	Defina como `true` para ativar a coleta somente de inventário.	`false`

Os valores para estas configurações podem ser definidos de diversas maneiras:

Adicione o valor diretamente ao arquivo de configuração. Esta é a forma mais comum.
Substitua os valores das variáveis de ambiente usando a notação {{}} . Isso requer o agente de infraestrutura 1.14.0+. Para saber mais sobre isso, consulte mais sobre variáveis de ambiente de passagem do agente de infraestrutura.
Use o gerenciamento de segredos para proteger informações confidenciais, como senhas, para que não sejam expostas em texto simples no arquivo de configuração. Para obter mais informações, consulte gerenciamento de segredos.

Etiquetas e atributo personalizado

Você também pode decorar sua métrica com etiquetas. Os rótulos permitem adicionar atributo de par de valor principal à sua métrica para que você possa consultar, filtrar ou agrupar sua métrica.

Embora nosso arquivo de configuração de amostra padrão inclua exemplos de rótulos, eles são opcionais. Você pode remover, modificar ou adicionar novos.

labels:
  env: production
  role: load_balancer

Exemplo de configuração

Esta é a configuração básica usada para coletar métricas e inventário do seu localhost:

integrations:
  - name: nri-redis
    env:
      METRICS: true
      HOSTNAME: localhost
      PORT: 6379
      REMOTE_MONITORING: true
    interval: 15s
    labels:
      environment: production

  - name: nri-redis
    env:
      INVENTORY: true
      HOSTNAME: localhost
      PORT: 6379
      REMOTE_MONITORING: true
    interval: 60s
    labels:
      environment: production
    inventory_source: config/redis

Esta configuração se conecta ao Redis usando autenticação básica. Substitua my_password pela sua senha REQUIREPASS :

integrations:
  - name: nri-redis
    env:
      METRICS: true
      HOSTNAME: localhost
      PORT: 6379
      PASSWORD: "my_password"
      REMOTE_MONITORING: true
    interval: 15s
    labels:
      environment: production

  - name: nri-redis
    env:
      INVENTORY: true
      HOSTNAME: localhost
      PORT: 6379
      PASSWORD: "my_password"
      REMOTE_MONITORING: true
    interval: 60s
    labels:
      environment: production
    inventory_source: config/redis

No Redis 6+, você pode proteger sua instância com listas de controle de acesso (ACLs). Para ACLs, substitua os valores USERNAME e PASSWORD pelas suas credenciais:

integrations:
  - name: nri-redis
    env:
      METRICS: true
      HOSTNAME: localhost
      PORT: 6379
      USERNAME: my_user
      PASSWORD: "my_password"
      REMOTE_MONITORING: true
    interval: 15s
    labels:
      environment: production

  - name: nri-redis
    env:
      INVENTORY: true
      HOSTNAME: localhost
      PORT: 6379
      USERNAME: my_user
      PASSWORD: "my_password"
      REMOTE_MONITORING: true
    interval: 60s
    labels:
      environment: production
    inventory_source: config/redis

Use para se conectar ao Redis com TLS. Você pode adicionar TLS_INSECURE_SKIP_VERIFY : true para desativar a verificação do nome do servidor:

integrations:
  - name: nri-redis
    env:
      METRICS: true
      HOSTNAME: localhost
      PORT: 6379
      USE_TLS: true
      REMOTE_MONITORING: true
    interval: 15s
    labels:
      environment: production

Use para conectar-se ao Redis usando um arquivo de soquete. Esta é uma alternativa para uma conexão TCP nome do host/Porta:

integrations:
  - name: nri-redis
    env:
      METRICS: true
      UNIX_SOCKET_PATH: /var/run/redis/redis.sock
      USE_UNIX_SOCKET: true
      REMOTE_MONITORING: true
    interval: 15s
    labels:
      environment: production

Use isto para coletar sua métrica/inventário se você usou rename-command para proteger sua instância:

integrations:
  - name: nri-redis
    env:
      METRICS: true
      HOSTNAME: localhost
      PORT: 6379
      RENAMED_COMMANDS: '{"CONFIG":"b840fc9f15f59e41cb7be6c52","LLEN":"c940fc2d15f59e41cb7be6c21"}'
      REMOTE_MONITORING: true
    interval: 15s
    labels:
      environment: production

  - name: nri-redis
    env:
      INVENTORY: true
      HOSTNAME: localhost
      PORT: 6379
      RENAMED_COMMANDS: '{"CONFIG":"b840fc9f15f59e41cb7be6c52"}'
      REMOTE_MONITORING: true
    interval: 60s
    labels:
      environment: production
    inventory_source: config/redis

Use isto se precisar coletar métricas de dois servidores Redis diferentes usando a mesma integração.

O primeiro exemplo de instância está coletando apenas KEY_1 e KEY_2 do banco de dados 0 Redis . O segundo exemplo de instância mostra como coletar de diferentes bancos de dados com {"DB":"KEYS"}.

integrations:
  - name: nri-redis
    env:
      METRICS: true
      HOSTNAME: redis_host_1
      PORT: 6379
      KEYS: '["KEY_1","KEY_2"]'
      REMOTE_MONITORING: true
    interval: 15s
    labels:
      environment: production

  - name: nri-redis
    env:
      METRICS: true
      HOSTNAME: redis_host_2
      PORT: 6379
      KEYS: '{"0":["KEY_1","KEY_2"],"1":["KEY_3"]}'
      REMOTE_MONITORING: true
    interval: 15s
    labels:
      environment: production

Encontre e use dados

Os dados deste serviço são reportados para um dashboard de integração.

Métrica estão anexadas aos tipos de evento RedisSample e RedisKeyspaceSample . Você pode consultar esses dados para fins de resolução de problemas ou para criar gráficos e dashboards personalizados.

Para saber mais sobre como encontrar e usar seus dados, consulte Compreender os dados de integração.

Dados métricos

A integração Redis recolhe os seguintes dados métricos atributo:

Métrica de amostra Redis

Estes atributos estão anexados ao tipo de evento RedisSample :

Nome	Descrição
`cluster.connectedSlaves`	Número de escravos conectados.
`db.aofLastRewriteTimeInMilliseconds`	Duração da última operação de reescrita AOF em milissegundos.
`db.aofLastBgrewriteStatus`	Booleano que representa o status da última operação de reescrita em segundo plano AOF.
`db.aofLastWriteStatus`	Booleano que representa o status da última operação de gravação AOF.
`db.evictedKeysPerSecond`	Número de chaves despejadas devido ao limite máximo de memória por segundo.
`db.expiredKeysPerSecond`	Número de eventos de expiração de chave por segundo.
`db.keyspaceHitsPerSecond`	Número de pesquisas bem-sucedidas de chaves no dicionário principal por segundo.
`db.keyspaceMissesPerSecond`	Número de falhas na pesquisa de chaves no dicionário principal por segundo.
`db.latestForkUsecMilliseconds`	Duração da última operação de bifurcação em milissegundos.
`db.rdbBgsaveInProgress`	Boleano. Um sinalizador indicando que um salvamento do RDB está em andamento.
`db.rdbChangesSinceLastSave`	Número de alterações desde o último despejo.
`db.rdbLastBgsaveStatus`	Booleano que representa o status da última operação de salvamento do RDB.
`db.rdbLastBgsaveTimeMilliseconds`	Duração da última operação de salvamento do RDB em milissegundos.
`db.rdbLastSaveTime`	Carimbo de data timestamp baseado na época do último salvamento bem-sucedido do RDB em segundos.
`db.syncFull`	Contagem do número de vezes que os escravos foram totalmente sincronizados com este mestre.
`db.syncPartialErr`	Contagem do número de vezes que as sincronizações parciais não foram concluídas.
`db.syncPartialOk`	Contagem do número de vezes que as sincronizações parciais foram concluídas.
`net.blockedClients`	Número de clientes pendentes em uma chamada bloqueada (`BLPOP`, `BRPOP`, `BRPOPLPUSH`).
`net.clientBiggestInputBufBytes`	O maior buffer de entrada entre as conexões atuais do cliente.
`net.clientLongestOutputList`	A lista de saída mais longa entre as conexões atuais do cliente.
`net.commandsProcessedPerSecond`	Número de comandos processados pelo servidor por segundo.
`net.connectedClients`	Número de conexões de clientes (excluindo conexões de escravos).
`net.connectionsReceivedPerSecond`	Número de conexões aceitas pelo servidor por segundo.
`net.inputBytesPerSecond`	Número total de bytes de entrada por segundo.
`net.outputBytesPerSecond`	Número total de bytes gerados por segundo.
`net.pubsubChannels`	Número global de canais pub/sub com assinatura de cliente.
`net.pubsubPatterns`	Número global de padrão pub/sub com assinatura do cliente.
`net.rejectedConnectionsPerSecond`	Número de conexões por segundo rejeitadas devido ao limite máximo de clientes.
`software.uptimeMilliseconds`	Número de milissegundos desde o início do servidor Redis.
`system.memFragmentationRatio`	Razão entre `used_memory_rss` e `used_memory`.
`system.totalSystemMemoryBytes`	A quantidade de memória em bytes disponível na instância em que o Redis está em execução.
`system.usedCpuSysMilliseconds`	CPU do sistema consumida pelo servidor Redis em milissegundos.
`system.usedCpuSysChildrenMilliseconds`	CPU do sistema consumida pelos processos em segundo plano em milissegundos.
`system.usedCpuUserMilliseconds`	CPU do usuário consumida pelo servidor Redis em milissegundos.
`system.usedCpuUserChildrenMilliseconds`	CPU do usuário consumida pelos processos em segundo plano em milissegundos.
`system.usedMemoryBytes`	O número total de bytes alocados pelo Redis usando seu alocador (padrão `libc`, `jemalloc` ou um alocador alternativo como `tcmalloc`).
`system.usedMemoryLuaBytes`	Número de bytes usados pelo mecanismo Lua.
`system.usedMemoryPeakBytes`	O pico de memória consumida pelo Redis em bytes.
`system.usedMemoryRssBytes`	Número de bytes que o Redis alocou conforme visto pelo sistema operacional (também conhecido como tamanho do conjunto residente). Este é o número relatado por ferramentas como `top(1)` e `ps(1)`.

Métrica keyspace

A integração Redis coleta os seguintes metadados e métricas keyspace . Estes atributos estão anexados ao tipo de evento RedisKeyspaceSample :

Nome	Descrição
`db.avgTtl`	O tempo médio de vida (TTL) em milissegundos de chaves que têm uma expiração definida no banco de dados que está sendo relatado.
`db.keys`	Número de chaves no banco de dados que estão sendo relatadas.
`db.keyspace`	Índice do banco de dados Redis, que é o número inteiro (geralmente um número entre `0` e `15`). Formato: `db` seguido do índice do banco de dados. Por exemplo: `db0`, `db1`, `db2`, etc.
`db.expires`	Número de chaves com expiração no banco de dados que está sendo relatado.

Dados de inventário

Os dados de inventário incluem tudo o que é relatado pelo comando Redis CONFIG GET, com exceção de requirepass, que armazena a senha do servidor Redis. Para obter mais informações sobre dados de inventário, consulte Compreender os dados de inventário.

Outros dados do sistema

A integração Redis coleta estes atributos adicionais sobre o seu serviço Redis :

Nome	Descrição
`software.version`	A versão do servidor Redis. Exemplo: `3.2.3`.
`cluster.role`	`master` ou `slave,` dependendo da função do nó Redis que está sendo monitorado.

Verifique o código-fonte

Esta integração é um software de código aberto. Isso significa que você pode navegar pelo código-fonte e enviar melhorias, ou criar seu próprio fork e construí-lo.

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

Compatibilidade e requisitos

Importante

Começo rápido

Instalar e ativar

SEC

Kubernetes

Linux

Conecte-se com soquete Unix

Conecte-se com TCP

Windows

Este documento ajudou você na instalação?

Crie um usuário New Relic para seu servidor Redis

Configurar a integração

Importante

Configurações de instância do Redis

Etiquetas e atributo personalizado

Exemplo de configuração

Configuração básica

Autenticação básica

Autenticação Redis 6+ ACL

Métrica somente com conexão TLS

Conexão somente métrica via soquete

Usando comandos renomeados

Monitoramento multi-instância com filtragem de chaves

Encontre e use dados

Dados métricos

Métrica de amostra Redis

Métrica keyspace

Dados de inventário

Outros dados do sistema

Verifique o código-fonte

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

Redis monitoramento integração

Compatibilidade e requisitos .css-21sua1{background:none;border:none;width:0;padding:0;}

Importante

Começo rápido

Instalar e ativar

Kubernetes

Linux

Windows

Este documento ajudou você na instalação?

Crie um usuário New Relic para seu servidor Redis

Configurar a integração

Importante

Configurações de instância do Redis

Etiquetas e atributo personalizado

Exemplo de configuração

Configuração básica

Autenticação básica

Autenticação Redis 6+ ACL

Métrica somente com conexão TLS

Conexão somente métrica via soquete

Usando comandos renomeados

Monitoramento multi-instância com filtragem de chaves

Encontre e use dados

Dados métricos

Métrica de amostra Redis

Métrica keyspace

Dados de inventário

Outros dados do sistema

Verifique o código-fonte

Compatibilidade e requisitos