Redis Monitor

Propósito & Intenção do Usuário: O Redis Monitor oferece visibilidade em tempo real de instâncias Redis em nós únicos, clusters ou serviços gerenciados. Usuários-alvo: engenheiros de confiabilidade, desenvolvedores, DBAs e equipes de operações que precisam detectar pressão de memória, picos de latência, alto throughput de comandos e atraso de réplica. A ferramenta lê dados INFO do Redis, INFO REPLICATION e estatísticas relacionadas por meio de conexões autenticadas; é somente leitura e não intrusiva, criada para verificações contínuas de saúde e planejamento de capacidade.

Lógica central & Funcionalidades: Obrigatório: conexão ao Redis via host, porta e credenciais; consultas INFO periódicas; métricas agregadas em séries temporais; derivação de uso (por exemplo, used_memory / maxmemory), throughput (commands_per_sec) e percentis de latência. Opcional/Avançado: agregação multi-instância para clusters, limites de alerta, tendências históricas, exportação JSON/CSV, hooks de integração. Funções: métricas de memória, clientes conectados, total_commands_processed, instantaneous_ops_per_sec, p95_latency, replication_lag, status de persistência, latency samples.

Entradas & Saídas: Entradas: host (string), port (int), username (string, opcional), password (string, opcional), use_tls (bool), tls_ca (string, opcional), sampling_interval_sec (int), metrics_to_collect (array de strings), instance_name (string, opcional). Saídas: metrics_report com timestamp ISO 8601, instance_id, host, port, metrics (objeto) incluindo 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. Timestamps ISO 8601; memória em bytes; latência em microssegundos; valores ausentes null.

Algoritmos & Cálculos: Dados de INFO; cálculos baseados em delta: commands_per_sec = (current_total_commands − previous_total_commands) / interval. memory_utilization = used_memory / maxmemory * 100, se maxmemory > 0; senão null. latency_p95 = percentil(latency_samples_ms, 95) na janela de amostra. replication_lag_seconds a partir de master_last_io_seconds_ago se disponível; senão null. Apenas INFO e PING são usados.

Erros & Casos Limites: Host inalcançável, erro de autenticação ou TLS-handshake gera erro de conexão com carimbo de tempo e orientações de mitigação. Clusters são reconhecidos e métricas por nó são agregadas. Entradas ausentes ou tipos incorretos aciona validação; dados parciais aparecem como null. Versões Redis mais antigas podem omitir campos INFO; cálculos limitam-se aos campos disponíveis.

Indústria/Região & Localização: Métricas em unidades padrão: memória em bytes, tempo em segundos, latência em microssegundos. Carimbos de tempo ISO. Implementações regionais podem usar UTC ou hora local via configuração; moeda não aplicável.

Supostos & Exclusões: Leitura apenas de INFO e PING; não modifica dados ou configuração do Redis. Não substitui Redis Slow Log ou ferramentas AOF/BGSAVE; não é responsável por roteamento de alertas.