Puede recopilar métrica sobre su instancia de Redis con el recolector OpenTelemetry. El recolector es un componente de OpenTelemetry que recopila, procesa y exporta telemetry data a New Relic (o cualquier backend de observabilidad). El receptor de Redis está diseñado para recuperar datos de Redis INFO de una única instancia de Redis, construir métricas a partir de esos datos y enviarlos al siguiente consumidor en un intervalo configurable.
Después de seguir los pasos de instalación, verá estos datos métricos en un panel prediseñado, creará una política de alertas y creará consultas y gráficos personalizados.
Requisitos previos
Para comenzar a recolectar Redis métrica, debe registrarse para obtener una cuenta gratuita de New Relic.
Una vez que te hayas registrado, asegúrate de haber configurado:
- El componente receptorRedis , como recolector, requiere acceso a Redis a través de un extremo. La versión mínima recomendada es la v0.83.0.
- El recolector de OpenTelemetry siguiendo los documentos de OpenTelemetry
Instalar el recolector OpenTelemetry
Instalar una distribución OpenTelemetry
Necesitará instalar el recolector OpenTelemetry Contrib Distro. Si está utilizando otra distribución, confirme que la distribución elegida tenga los siguientes componentes:
Procesador de detección de recursos
Importante
Si su distribución no tiene estos componentes, entonces el archivo de configuración del siguiente paso no se aplica.
Configurar el recolector OpenTelemetry
Actualice o cree un nuevo archivo llamado config.yaml
. Inserte el siguiente fragmento en su nuevo archivo:
receivers: redis: endpoint: "<YOUR_REDIS_HOSTNAME>:<REDIS_PORT>" metrics: # Enable redis.maxmemory optional metric redis.maxmemory: enabled: true
processors: # This is needed since redis receiver is not currently adding any means to understand to which redis server the metrics are referring to attributes/redis_metrics: include: match_type: regexp metric_names: # Notice that if with single or without quotes just one backslash is needed 'redis\..*' - "redis\\..*" actions: - action: upsert key: server.address value: "<YOUR_REDIS_HOSTNAME>" - action: upsert key: server.port value: "<REDIS_PORT>" # resource and resource-detection processors allow decorating the metrics with host attributes resource: attributes: - key: host.id from_attribute: host.name action: insert resourcedetection: detectors: ["env", "system"] resourcedetection/cloud: detectors: ["gcp", "ec2", "azure"] timeout: 2s override: false
exporters: otlphttp: endpoint: https://otlp.nr-data.net headers: api-key: <NEW_RELIC_LICENSE_KEY>
service: telemetry: logs: pipelines: metrics: receivers: [redis] processors: - resourcedetection - resourcedetection/cloud - resource - attributes/redis_metrics exporters: [otlphttp]
- Reemplace el
NEW_RELIC_LICENSE_KEY
en el archivo con sus propios valores. Para obtener más información, consulte la clave de licencia de New Relic. - Dado que el receptor OTel no adjunta ningún identificador a Redis métrica, se necesita un procesador de atributos para decorar métrica con metadatos
server.address
yserver.port
. Los atributosserver.address
yserver.port
son necesarios para poder consultar y facetar datos diferenciando entre servidores Redis y crear entidad New Relic. - Además, se necesitan canalizaciones separadas con diferentes instancias de
resource/redis_metrics
en caso de que se monitoreen varios servidores Redis desde un único recolector de hotel para decorar cada instancia con los metadatos correspondientes.
Para ver otras opciones de configuración, consulte:
Ejecute el recolector
Ejecute el recolector OpenTelemetry (la forma de ejecutarlo puede variar según el método de instalación elegido). Ejemplo:
/usr/bin/otelcol-contrib --config ./config.yaml
Explora tus datos
Telemetry data que se originan en el receptor OpenTelemetry Redis, si están decorados correctamente, generan la entidad Redis . Las entidades son cualquier cosa que informe datos a New Relic y se identifique mediante un ID de entidad único.
Su entidad de monitor son los controladores de características como entidad Explorer, carga de trabajo y Lookout. Consulte este documento para obtener más información sobre cómo beneficiarse de estas experiencias.
Consulta tus datos con métrica explorer
Puede utilizar el explorador métrico para comprobar la métrica que se está ingiriendo. Todas las métricas reportadas por el receptor redis comienzan con el prefijo "redis."
.
La siguiente consulta NRQL muestra ejemplos que le ayudarán a consultar la métrica que recibió:
Listado del número de actualizaciones métricas ingeridas por nombre de métrica:
SELECT count(*) FROM Metric WHERE metricName LIKE 'redis.%' and instrumentation.provider='opentelemetry' facet metricName LIMIT maxConsultar una métrica específica facetada por host:
SELECT average(redis.commands.processed) FROM Metric WHERE instrumentation.provider='opentelemetry' FACET host.name TIMESERIESListado de dimensiones disponibles para una métrica determinada:
SELECT keyset() FROM Metric WHERE metricName = 'redis.commands.processed'Para obtener una lista de todas las métricas admitidas, consulte la referencia métrica del receptor redis.
¿Que sigue?
Con sus informes de datos de Redis a New Relic, puede instalar el de telemetría de Redis Open dashboard. Esto le brinda una experiencia dashboard prediseñada para que pueda rastrear y monitor su infraestructura de Redis.
Si busca ayuda con otros casos de uso del recolector, consulte el repositorio newrelic-OpenTelemetry-examples .