Redis

Redis es un almacén avanzado de clave-valor de código abierto. A menudo se lo denomina servidor de estructura de datos, ya que los valores pueden contener strings, hashes, listas, conjuntos y conjuntos ordenados. Para obtener más información, visita redis.io.

Requisitos previos

Para recopilar y transferir la telemetría de Redis, debes instalar el agente de operaciones versión 2.7.0 o posterior.

Configura el agente de operaciones para Redis

Sigue las instrucciones en Configura el agente de operaciones y agrega los elementos necesarios para recopilar registros de tus instancias de Redis y reinicia el agente.

Configuración de ejemplo

El siguiente comando crea el archivo de configuración para recopilar y transferir registros de Redis y reinicia el agente de operaciones en Linux.

sudo tee /etc/google-cloud-ops-agent/config.yaml > /dev/null << EOF
logging:
  receivers:
    redis:
      type: redis
  service:
    pipelines:
      redis:
        receivers:
        - redis
metrics:
  receivers:
    redis:
      type: redis
      address: localhost:6379
      collection_interval: 60s
      password: Strong_Password123
  service:
    pipelines:
      redis:
        receivers:
        - redis
EOF
sudo service google-cloud-ops-agent restart

Configura la recopilación de registros

A fin de transferir registros desde nginx, debes crear receptores para los registros que nginx produce y, luego, crear una canalización para los receptores nuevos. A fin de configurar un receptor para tus registros redis, especifica los siguientes campos:

Campo	Predeterminada	Descripción
type		Este valor debe ser redis.
include_paths	[/var/log/redis/redis-server.log, /var/log/redis_6379.log, /var/log/redis/redis.log, /var/log/redis/default.log, /var/log/redis/redis_6379.log]	Una lista de rutas de acceso del sistema de archivos que se leerán mediante la visualización del final de cada archivo. Se puede usar un comodín (*) en las rutas. Por ejemplo, /var/log/redis/*.log.
exclude_paths	[]	Una lista de patrones de ruta de acceso del sistema de archivos que se excluirán del conjunto que coincide con include_paths.
wildcard_refresh_interval	1m0s	El intervalo en el que se actualizan las rutas de acceso a archivos comodín en include_paths. Como una duración, por ejemplo, 30s, 2m. Esta propiedad puede ser útil en entornos de procesamiento de registro altos, en los que los archivos de registro se rotan más rápido que el intervalo predeterminado.

¿Qué se registra?

Los registros contienen los siguientes campos en el LogEntry:

Campo	Tipo	Descripción
jsonPayload.roleChar	string	Carácter de función de Redis (X, C, S, M)
jsonPayload.role	string	Traducido del carácter de función de Redis (sentinel, RDB/AOF_writing_child, slave, principal)
jsonPayload.level	string	Nivel de entrada de registro
jsonPayload.pid	número	ID de proceso
jsonPayload.message	string	Mensaje del registro
severity	string (LogSeverity)	Nivel de entrada de registro (traducido)
timestamp	string (Timestamp)	Hora en la que se registró la entrada

Configura la recopilación de métricas

A fin de recopilar métricas de Redis, debes crear un receptor para las métricas de Redis y, luego, crear una canalización destinada al receptor nuevo. A fin de configurar un receptor para las métricas de Redis, especifica los siguientes campos:

Campo	Predeterminada	Descripción
type		Este valor debe ser redis.
address	localhost:6379	La URL que expone Redis.
collection_interval	60s	Un valor time.Duration, como 30s o 5m.
password		La contraseña usada para conectarse al servidor.

Qué se supervisa

En la siguiente tabla, se proporciona una lista de métricas que el agente de operaciones recopila de la instancia de Redis.

Tipo de métrica
Categoría, tipo Recursos supervisados	Etiquetas
workload.googleapis.com/redis.clients.blocked
GAUGE, INT64 gce_instance
workload.googleapis.com/redis.clients.connected
GAUGE, INT64 gce_instance
workload.googleapis.com/redis.clients.max_input_buffer
GAUGE, INT64 gce_instance
workload.googleapis.com/redis.clients.max_output_buffer
GAUGE, INT64 gce_instance
workload.googleapis.com/redis.commands.processed
CUMULATIVE, INT64 gce_instance
workload.googleapis.com/redis.connections.received
CUMULATIVE, INT64 gce_instance
workload.googleapis.com/redis.connections.rejected
CUMULATIVE, INT64 gce_instance
workload.googleapis.com/redis.cpu.time
CUMULATIVE, DOUBLE gce_instance	state
workload.googleapis.com/redis.keys.evicted
CUMULATIVE, INT64 gce_instance
workload.googleapis.com/redis.keys.expired
CUMULATIVE, INT64 gce_instance
workload.googleapis.com/redis.keyspace.hits
CUMULATIVE, INT64 gce_instance
workload.googleapis.com/redis.keyspace.misses
CUMULATIVE, INT64 gce_instance
workload.googleapis.com/redis.latest_fork
GAUGE, INT64 gce_instance
workload.googleapis.com/redis.memory.fragmentation_ratio
GAUGE, DOUBLE gce_instance
workload.googleapis.com/redis.memory.lua
GAUGE, INT64 gce_instance
workload.googleapis.com/redis.memory.peak
GAUGE, INT64 gce_instance
workload.googleapis.com/redis.memory.rss
GAUGE, INT64 gce_instance
workload.googleapis.com/redis.memory.used
GAUGE, INT64 gce_instance
workload.googleapis.com/redis.net.input
CUMULATIVE, INT64 gce_instance
workload.googleapis.com/redis.net.output
CUMULATIVE, INT64 gce_instance
workload.googleapis.com/redis.rdb.changes_since_last_save
GAUGE, INT64 gce_instance
workload.googleapis.com/redis.replication.backlog_first_byte_offset
GAUGE, INT64 gce_instance
workload.googleapis.com/redis.replication.offset
GAUGE, INT64 gce_instance
workload.googleapis.com/redis.slaves.connected
GAUGE, INT64 gce_instance

Panel de muestra

Puedes ver las métricas de esta integración mediante un panel de Cloud Monitoring de muestra. Completa los procedimientos que se indican en Instala paneles de muestra para importar el panel Descripción general de Redis de la Biblioteca de muestra y ver los gráficos que muestran en sus métricas de Redis.

Verifica la configuración

Puedes usar el Explorador de registros y el Explorador de métricas para verificar que configuraste de forma correcta el receptor de Redis. El agente de operaciones puede tardar uno o dos minutos en comenzar a recopilar los registros y las métricas.

Para verificar que se transfieran los registros, ve a Explorador de registros y ejecuta la siguiente consulta a fin de ver los registros de Redis:

resource.type="gce_instance"
logName=("projects/PROJECT_ID/logs/redis")

Para verificar que las métricas se transfieran, ve a Explorador de métricas y ejecuta la siguiente consulta en la pestaña MQL.

fetch gce_instance
| metric 'workload.googleapis.com/redis.connections.received'
| align rate(1m)
| every 1m