openclaw/agents/opsec/HEARTBEAT.md
Glucksberg 035ece4732 feat: Sistema de Falsos Positivos v1.1 - Production Ready
 Implementadas TODAS as melhorias do code review:

🔒 Segurança:
- Input sanitization completa (_validatePattern, _validateId)
- Try-catch em todas operações RegExp
- Atomic file writes para data integrity

 Performance:
- Cache de RegExp compiladas (Map-based)
- Busca otimizada O(n) → O(1) para patterns conhecidos
- Cleanup automático de dados antigos

🧪 Qualidade:
- Suite de testes completa (13 tests, 100% pass)
- Error handling robusto com graceful degradation
- CLI melhorada com validação completa

🚀 Funcionalidades:
- Auto-classificação ML-ready com rate limiting
- Export de training data para machine learning
- Slack/Discord alerts formatados
- Estatísticas detalhadas por severidade
- Relatórios ricos para análise

📊 Arquivos:
- scripts/false-positive-manager.cjs (v1.1 - Core logic)
- scripts/check-false-positive.sh (Enhanced shell script)
- tests/false-positive-manager.test.js (Test suite completa)
- docs/false-positives-v1.1.md (Documentação)
- SOUL.md (Integração no workflow de alertas)

Score: 9.4/10 - Enterprise Grade Production Ready 
2026-01-28 20:20:05 +00:00

59 lines
1.4 KiB
Markdown

# HEARTBEAT.md - CloudFarm Health Monitor
## Checklist de Monitoramento
Execute estas verificações a cada heartbeat. Se encontrar problemas, envie alerta pro grupo.
### 1. Backend CloudFarm
```bash
# Verificar se processo está rodando
pm2 status cloudfarm-api 2>/dev/null | grep -E "online|stopped|error"
# Verificar logs de erro recentes (últimos 5 min)
pm2 logs cloudfarm-api --lines 50 --nostream 2>/dev/null | grep -iE "error|exception|fatal|crash" | tail -5
```
### 2. MongoDB
```bash
# Verificar conexão
mongosh --eval "db.adminCommand('ping')" --quiet 2>/dev/null || echo "MongoDB: FALHA"
```
### 3. Erros 5xx nos logs
```bash
# Contar erros HTTP 5xx recentes
pm2 logs cloudfarm-api --lines 200 --nostream 2>/dev/null | grep -E "status.*5[0-9]{2}|HTTP 5" | wc -l
```
## Critérios de Alerta
| Condição | Ação |
|----------|------|
| Processo stopped/error | 🚨 Alerta CRÍTICO |
| Erros 5xx > 5 em 5min | ⚠️ Alerta WARNING |
| Exceptions nos logs | 📋 Reportar resumo |
| Tudo OK | HEARTBEAT_OK |
## Formato do Alerta
Se encontrar problema:
```
🔒 *OpSec Health Check*
⚠️ *Status*: [CRÍTICO/WARNING]
📍 *Sistema*: CloudFarm Backend
🕐 *Horário*: [timestamp]
💥 *Problema*:
[descrição]
🔧 *Ação sugerida*:
[recomendação]
```
## Notas
- Não alerte para erros já conhecidos/esperados
- Agrupe múltiplos erros similares
- Se tudo estiver OK, responda apenas: HEARTBEAT_OK