Nuestra integración de Redis informa datos de rendimiento críticos de su servidor Redis a los productos New Relic. Puede ver estos datos métricos y datos de inventario en un panel prediseñado, crear políticas de alertas y crear consultas y gráficos personalizados. También puede especificar claves que sean importantes para su aplicación y obtener información sobre su longitud.
Continúe leyendo para instalar la integración y ver qué datos recopilamos.
Compatibilidad y requisitos
Nuestra integración es compatible con las versiones de Redis desde 3.0 a 7.0.
Antes de instalar la integración, asegúrese de cumplir con los siguientes requisitos:
Una cuenta New Relic . ¿No tienes uno? ¡Registrate gratis! No se requiere tarjeta de crédito.
Si Redis no se ejecuta en Kubernetes o Amazon ECS, debe instalar el agente de infraestructura en un host del sistema operativo Linux que ejecute Redis. De lo contrario:
- Si se ejecuta en Kubernetes, consulte estos requisitos.
- Si se ejecuta en ECS, consulte estos requisitos.
La integración obtiene datos ejecutando comandos de Redis:
Comando
INFO
: los datos del comando INFO completan los datos métricos y algunos datos de inventario.Comando
CONFIG GET
: la mayoría de los datos de inventario provienen de este comando.- En instalación Redis administrada sin permisos para ejecutar el comando
CONFIG
(por ejemplo, AWS ElastiCache), se puede deshabilitar la ejecución de este comando con la opción de configuraciónconfig_inventory: false
.
- En instalación Redis administrada sin permisos para ejecutar el comando
Adquisición de longitud de clave: Dependiendo del tipo de clave se utilizan estos comandos:
Para la recopilación de datos de longitud de clave, el agente utiliza canalización para minimizar el impacto en el rendimiento de Redis. Sin embargo, si recopila la longitud de muchas claves, el rendimiento de Redis puede verse afectado. Por este motivo, el agente incluye un límite de claves predeterminado (pero este límite se puede sobrescribir).
Importante
Si editó los nombres de los comandos de Redis mencionados anteriormente, la integración no podrá recuperar los datos de Redis.
Inicio rápido
Instrumente su servidor Redis rápidamente y envíe sus telemetry data con instalación guiada. Nuestra instalación guiada crea un comando CLI personalizado para su entorno que descarga e instala la CLI de New Relic y el agente de infraestructura.
¿Listo para comenzar? Haga clic en uno de estos botones para probarlo.
Instalar y activar
Para instalar la integración de Redis, siga las instrucciones para su entorno:
Notas adicionales:
Advanced:
integración también están disponibles en formato tarball para permitir la instalación fuera de un administrador de paquetes.
On-host integrations do not automatically update.
Para obtener mejores resultados, actualice periódicamente el paquete de integración y el agente de infraestructura.
' '
¿Te ha ayudado este documento con la instalación?
Cree un usuario de New Relic para su servidor Redis
Si utiliza Redis 6+ y utiliza listas de control de acceso (ACL) para controlar el acceso a su instancia, es posible que desee crear un usuario newrelic
para la integración. Utilice este comando para crear y otorgar los permisos necesarios a su usuario:
ACL SETUSER newrelic on >'YOUR_SELECTED_PASSWORD' ~* +INFO +CONFIG|GET +SELECT +TYPE +LLEN +SCARD +ZCOUNT +HLEN
Configurar la integración
Hay varias formas de configurar la integración, dependiendo de cómo se instaló:
- Si está habilitado a través de Kubernetes: consulte Supervisar servicios que se ejecutan en Kubernetes.
- Si está habilitado a través de Amazon ECS: consulte Servicios de monitorización que se ejecutan en ECS.
- Si está instalado en el host: edite la configuración en el archivo de configuración YAML de la integración
redis-config.yml
.
Utilice la configuración YAML para colocar las credenciales de inicio de sesión requeridas y configurar cómo se recopilan sus datos, según su configuración y preferencias.
El archivo de configuración tiene configuraciones comunes aplicables a todas las integraciones, como interval
, timeout
, inventory_source
. Para obtener más información sobre estas configuraciones comunes, consulte nuestro formato de configuración YAML.
Importante
Si todavía estás usando nuestros archivos de configuración/definición legacy, usa nuestro formato de configuración estándar más antiguo.
Las configuraciones específicas relacionadas con Redis se definen usando la sección env
del archivo de configuración. Estas configuraciones controlan la conexión a su instancia Redis, así como otras configuraciones y características de seguridad.
Configuración de instancia de Redis
La integración Redis recopila información métrica(M) e Inventario(I). En la tabla, utilice la columna Applies To para las configuraciones disponibles para cada colección:
' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' '
Configuración | Descripción | Por defecto | Se aplica a |
---|---|---|---|
HOSTNAME | Nombre del host del servidor Redis . | host local | M/I |
PORT | Puerto donde escucha el servidor Redis. | 6379 | M/I |
USERNAME | Nombre de usuario que se utilizará al conectarse al servidor Redis. Úselo solo con Redis 6+ si ACL está habilitado. | N/A | M/I |
PASSWORD | Contraseña que se utilizará al conectarse al servidor Redis. Úselo solo con servidores Redis si | N/A | M/I |
UNIX_SOCKET_PATH | Ruta al archivo de socket Unix en el que escucha el servidor Redis. Utilice esto en lugar de nombre de host/Puerto. | N/A | M/I |
USE_UNIX_SOCKET | Configúrelo en | false | M/I |
USE_TLS | Utilice TLS cuando se comunique con el servidor Redis. | false | M/I |
TLS_INSECURE_SKIP_VERIFY | Deshabilite la verificación del nombre del servidor cuando se conecte a través de TLS. | false | M/I |
KEYS | Lista de claves para recuperar sus longitudes. | N/A | M |
KEYS_LIMIT | Número máximo de claves para recuperar sus longitudes. | 30 | M |
CONFIG_INVENTORY | Configúrelo en "falso" en entornos donde el comando Redis CONFIG no está permitido (por ejemplo, AWS o ElastiCache). | verdadero | I |
RENAMED_COMMANDS | Asigne los comandos predeterminados de Redis a su forma renombrada. | N/A | M/I |
Habilite el monitoreo de múltiples inquilinos. | verdadero | M/I | |
METRICS | Establezca en | false | |
INVENTORY | Configúrelo en | false |
Los valores para estas configuraciones se pueden definir de varias maneras:
- Agregue el valor directamente al archivo de configuración. Esta es la forma más común.
- Reemplace los valores de las variables de entorno utilizando la notación
{{}}
. Esto requiere el agente de infraestructura 1.14.0+. Para obtener más información sobre esto, consulte más sobre las variables de entorno de paso a través del agente de infraestructura. - Utilice la administración de secretos para proteger la información confidencial, como las contraseñas, de modo que no quede expuesta en texto sin formato en el archivo de configuración. Para obtener más información, consulte gestión de secretos.
Etiquetas y atributos personalizados
También puedes decorar tu métrica con etiquetas. Las etiquetas le permiten agregar valor par principal atributo a su métrica para que pueda consultar, filtrar o agrupar su métrica.
Aunque nuestro archivo de configuración de muestra predeterminado incluye ejemplos de etiquetas, son opcionales. Puede eliminar, modificar o agregar otros nuevos.
labels: env: production role: load_balancer
Configuración de ejemplo
Buscar y utilizar datos
Los datos de este servicio se informan a un dashboard de integración.
Métrica se adjuntan a los tipos de eventos RedisSample
y RedisKeyspaceSample
. Puede consultar estos datos para fines de resolución de problemas o para crear gráficos y paneles personalizados.
Para obtener más información sobre cómo encontrar y utilizar sus datos, consulte Comprender los datos de integración.
Datos métricos
La integración Redis recopila los siguientes atributos métricos:
Redis muestra métrica
Estos atributos están adjuntos al tipo de evento RedisSample
:
Nombre | Descripción |
---|---|
| Número de esclavos conectados. |
| Duración de la última operación de reescritura de AOF en milisegundos. |
| Booleano que representa el estado de la última operación de reescritura en segundo plano de AOF. |
| Booleano que representa el estado de la última operación de escritura AOF. |
| Número de claves desalojadas debido al límite máximo de memoria por segundo. |
| Número de eventos de caducidad de clave por segundo. |
| Número de búsquedas exitosas de claves en el diccionario principal por segundo. |
| Número de búsquedas fallidas de claves en el diccionario principal por segundo. |
| Duración de la última operación de bifurcación en milisegundos. |
| Booleano. Un indicador que indica que se está guardando RDB. |
| Número de cambios desde el último volcado. |
| Booleano que representa el estado de la última operación de guardado de RDB. |
| Duración de la última operación de guardado de RDB en milisegundos. |
| Timestamp basada en la época del último guardado exitoso de RDB en segundos. |
| Recuento del número de veces que los esclavos se han sincronizado completamente con este maestro. |
| Recuento del número de veces que no se pudieron completar sincronizaciones parciales. |
| Recuento del número de veces que se han completado sincronizaciones parciales. |
| Número de clientes pendientes de una llamada de bloqueo ( |
| El búfer de entrada más grande entre las conexiones de clientes actuales. |
| La lista de salida más larga entre las conexiones de clientes actuales. |
| Número de comandos procesados por el servidor por segundo. |
| Número de conexiones de clientes (excluyendo conexiones de esclavos). |
| Número de conexiones aceptadas por el servidor por segundo. |
| Número total de bytes de entrada por segundo. |
| Número total de bytes de salida por segundo. |
| Número global de canales pub/sub con suscripción de cliente. |
| Número global de patrones de publicación/suscripción con suscripciones de clientes. |
| Número de conexiones por segundo rechazadas debido al límite de maxclients. |
| Número de milisegundos desde el inicio del servidor Redis. |
| Relación entre |
| La cantidad de memoria en bytes disponible en la instancia donde se ejecuta Redis. |
| CPU del sistema consumida por el servidor Redis en milisegundos. |
| CPU del sistema consumida por los procesos en segundo plano en milisegundos. |
| CPU del usuario consumida por el servidor Redis en milisegundos. |
| CPU del usuario consumida por los procesos en segundo plano en milisegundos. |
| El número total de bytes asignados por Redis utilizando su asignador (ya sea |
| Número de bytes utilizados por el motor Lua. |
| La memoria máxima consumida por Redis en bytes. |
| Número de bytes que Redis asignó según lo ve el sistema operativo (también conocido como tamaño del conjunto residente). Este es el número informado por herramientas como |
Keyspace métrica
La integración Redis recopila los siguientes metadatos y métricas keyspace . Estos atributos están adjuntos al tipo de evento RedisKeyspaceSample
:
Nombre | Descripción |
---|---|
| El tiempo de vida promedio (TTL) en milisegundos de las claves que tienen una caducidad establecida en la base de datos sobre la que se informa. |
| Número de claves en la base de datos sobre las que se informa. |
| Índice de la base de datos de Redis, que es el número entero (normalmente un número entre |
| Número de claves con vencimiento en la base de datos sobre las que se informa. |
Datos de inventario
Los datos de inventario incluyen todo lo informado por el comando CONFIG GET
de Redis, con la excepción de requirepass
, que almacena la contraseña del servidor de Redis. Para obtener más información sobre los datos de inventario, consulte Comprender los datos de inventario.
Otros datos del sistema
La integración Redis recopila estos atributos adicionales sobre su servicio Redis :
Nombre | Descripción |
---|---|
| La versión del servidor Redis. Ejemplo: |
| Ya sea |
Comprueba el código fuente
Esta integración es software de código abierto. Eso significa que puedes explorar su código fuente y enviar mejoras, o crear tu propia bifurcación y compilarla.