Redis

L'integrazione Redis raccoglie metriche relative alle prestazioni e all'utilizzo. Le metriche relative alle prestazioni sono incentrate su CPU, memoria e velocità effettiva di rete, mentre le metriche di utilizzo si concentrano su chiavi, comandi e replica. L'integrazione raccoglie anche i log Redis e li analizza in un payload JSON. Durante questo processo, i simboli per ruolo e livello vengono trasformati in un formato leggibile dall'uomo.

Per ulteriori informazioni su Redis, consulta redis.io.

Prerequisiti

Per raccogliere e importare la telemetria Redis, devi installare l'agente operativo versione 2.7.0 o successiva.

Questo ricevitore supporta Redis versione 6.2.

Configurazione dell'agente operativo per Redis

Segui la guida per configurare l'agente operativo, aggiungi gli elementi necessari per raccogliere i log dalle istanze Redis e riavvia l'agente.

Configurazione di esempio

Il comando seguente crea il file di configurazione per raccogliere e importare i log per Redis e riavvia l'agente operativo su 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
      password: Strong_Password123
  service:
    pipelines:
      redis:
        receivers:
        - redis
EOF
sudo service google-cloud-ops-agent restart

Configura la raccolta dei log

Per importare i log da Redis, devi creare dei destinatari per i log prodotti da Redis e poi creare una pipeline per i nuovi destinatari. Per configurare un ricevitore per i log redis, specifica i seguenti campi:

Campo predefinita Descrizione
type Questo valore deve essere 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] Un elenco di percorsi di filesystem da leggere mettendo in coda ogni file. Nei percorsi è possibile utilizzare un carattere jolly (*), ad esempio /var/log/redis/*.log.
exclude_paths [] Un elenco di pattern di file system da escludere dall'insieme corrispondente da include_paths.
wildcard_refresh_interval 60s L'intervallo a cui vengono aggiornati i percorsi dei file con caratteri jolly in include_paths. È indicato come durata, ad esempio 30s o 2m. Questa proprietà potrebbe essere utile in presenza di velocità effettiva di logging elevate, in cui i file di log vengono ruotati più rapidamente rispetto all'intervallo predefinito.

Che cosa viene registrato

I log Redis contengono i seguenti campi in LogEntry:

Campo Tipo Descrizione
jsonPayload.roleChar string Carattere del ruolo Redis (X, C, S, M)
jsonPayload.role string Tradotto dal carattere del ruolo Redis (sentinel, RDB/AOF_writing_child, slave, master)
jsonPayload.level string Livello di voce di log
jsonPayload.pid number ID processo
jsonPayload.message string Messaggio di log
severity stringa (LogSeverity) Livello di voce di log (tradotto)
timestamp stringa (Timestamp) L'ora in cui la voce è stata registrata

Configurazione della raccolta di metriche

Per raccogliere metriche da Redis, devi creare un ricevitore per le metriche Redis e quindi creare una pipeline per il nuovo destinatario. Per configurare un ricevitore per le metriche Redis, specifica i seguenti campi:

Campo predefinita Descrizione
type Questo valore deve essere redis.
address localhost:6379 L'URL esposto da Redis.
collection_interval 60s Un valore time.Duration, ad esempio 30s o 5m.
password La password utilizzata per la connessione al server.
insecure true Consente di stabilire se utilizzare o meno una connessione TLS sicura. Se questo criterio viene impostato su false, TLS viene attivato.
insecure_skip_verify false Consente di scegliere se saltare o meno la verifica del certificato. Se insecure è impostato su true, il valore di insecure_skip_verify non viene utilizzato.
cert_file Percorso del certificato TLS da utilizzare per le connessioni TLS richieste.
key_file Percorso della chiave TLS da utilizzare per le connessioni TLS richieste.
ca_file Percorso del certificato CA. In qualità di client, verifica il certificato del server. Se vuoto, il destinatario utilizza la CA radice del sistema.

Che cosa viene monitorato

La seguente tabella fornisce l'elenco delle metriche che l'agente operativo raccoglie dall'istanza Redis.

Tipo di metrica
Tipo, tipo
Risorse monitorate
Etichette
workload.googleapis.com/redis.clients.blocked
GAUGEINT64
gce_instance
 
workload.googleapis.com/redis.clients.connected
GAUGEINT64
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
CUMULATIVEINT64
gce_instance
 
workload.googleapis.com/redis.connections.received
CUMULATIVEINT64
gce_instance
 
workload.googleapis.com/redis.connections.rejected
CUMULATIVE, INT64
gce_instance
 
workload.googleapis.com/redis.cpu.time
CUMULATIVEDOUBLE
gce_instance
state
workload.googleapis.com/redis.keys.evicted
CUMULATIVEINT64
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
CUMULATIVEINT64
gce_instance
 
workload.googleapis.com/redis.latest_fork
GAUGEINT64
gce_instance
 
workload.googleapis.com/redis.memory.fragmentation_ratio
GAUGEDOUBLE
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
GAUGEINT64
gce_instance
 
workload.googleapis.com/redis.memory.used
GAUGEINT64
gce_instance
 
workload.googleapis.com/redis.net.input
CUMULATIVE, INT64
gce_instance
 
workload.googleapis.com/redis.net.output
CUMULATIVEINT64
gce_instance
 
workload.googleapis.com/redis.rdb.changes_since_last_save
GAUGEINT64
gce_instance
 
workload.googleapis.com/redis.replication.backlog_first_byte_offset
GAUGE, INT64
gce_instance
 
workload.googleapis.com/redis.replication.offset
GAUGEINT64
gce_instance
 
workload.googleapis.com/redis.slaves.connected
GAUGE, INT64
gce_instance
 

Dashboard di esempio

Puoi visualizzare le metriche di questa integrazione utilizzando una dashboard di Cloud Monitoring di esempio. Completa le procedure di installazione di dashboard di esempio per importare la dashboard Panoramica di GCE Redis dalla libreria di esempio e visualizza i grafici che mostrano le metriche Redis.

Verificare la configurazione

Puoi utilizzare Esplora log e Esplora metriche per verificare di aver configurato correttamente il ricevitore Redis. L'avvio della raccolta di log e metriche da parte dell'agente operativo potrebbe richiedere uno o due minuti.

Per verificare l'importazione dei log, vai a Esplora log ed esegui la query seguente per visualizzare i log Redis:

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


Per verificare l'importazione delle metriche, accedi a Metrics Explorer ed esegui la query seguente nella scheda MQL.

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

Passaggi successivi

Per una panoramica su come utilizzare Ansible per installare l'agente operativo, configurare un'applicazione di terze parti e installare una dashboard di esempio, guarda il video dedicato a l'agente operativo per risolvere i problemi delle applicazioni di terze parti.