Redis Monitor

Scopo & Intento dell'utente: Redis Monitor offre visibilità in tempo reale su istanze Redis su nodi singoli, cluster o servizi gestiti. Utente tipo: site reliability engineers, sviluppatori, DBAs e personale operazioni che devono rilevare pressione di memoria, picchi di latenza, alto throughput di comandi e ritardo di replica. Lo strumento legge dati INFO di Redis, INFO REPLICATION e statistiche correlate tramite connessioni autenticata; è in sola lettura e non invasivo, pensato per controlli di salute continui e pianificazione della capacità.

Logica centrale & Funzionalità: Obbligatorio: connessione a Redis tramite host, porta e credenziali; interrogazioni INFO periodiche; metriche aggregate in una serie temporale; derivazione di utilizzo (es. used_memory / maxmemory), throughput (commands_per_sec) e percentili di latenza. Opzionale/Avanzato: aggregazione multi-istanza per cluster, soglie di allerta, tendenze storiche, esportazione JSON/CSV, hook di integrazione. Funzionalità includono metriche di memoria, client connessi, total_commands_processed, instantaneous_ops_per_sec, p95_latency, replication_lag, stato di persistenza, latency samples.

Ingressi & Uscite: Ingressi: host (string), port (int), username (string, opz), password (string, opz), use_tls (bool), tls_ca (string, opz), sampling_interval_sec (int), metrics_to_collect (array di stringhe), instance_name (string, opz). Uscite: metrics_report con timestamp ISO 8601, instance_id, host, port, metrics (oggetto) incluse used_memory_bytes, maxmemory_bytes, used_memory_peak_bytes, connected_clients, total_commands_processed, instantaneous_ops_per_sec, p95_latency_us, replication_lag_seconds, last_save_status. Tempi ISO 8601; memoria in byte; latenza in microsecondi; valori mancanti null.

Algoritmi & Calcoli: Dati provenienti da blocchi INFO; calcoli basati su delta: commands_per_sec = (current_total_commands − previous_total_commands) / interval. memory_utilization = used_memory / maxmemory * 100, se maxmemory > 0; altrimenti null. latency_p95 = percentile(latency_samples_ms, 95) nell’intervallo di campionamento. replication_lag_seconds derivano da master_last_io_seconds_ago se disponibile; altrimenti null. Lo strumento non esegue comandi oltre INFO e PING.

Errori & Casi limite: Host non raggiungibile, errore di autenticazione o TLS handshake causano un errore di connessione con timestamp e rimedi. In cluster, topologia rilevata e metriche aggregate per nodo. Input mancanti o tipi errati provocano validazioni; dati parziali mostrati come null. Versioni Redis più vecchie possono omettere campi INFO; i calcoli si limitano ai campi disponibili.

Industria/Regione & Localizzazione: Metriche in unità standard: memoria in byte, tempo in secondi, latenza in microsecondi. Timestamp ISO. Distribuzioni regionali possono usare UTC o ora locale config. Nessuna valuta.
Assunzioni & Esclusioni: Lettura esclusiva di INFO e PING; nessuna modifica di dati o configurazioni Redis. Non sostituisce Redis Slow Log o strumenti AOF/BGSAVE; nessuna responsabilità per allarmi.