K-Forge / K-Forge/Beetle

Normalizar señales

Open
#173 0 comments 0 reactions 1 assignee Claimed by @RodriKonrad View on GitHub
fase-1
Dominant language
Shell
Stars
1
Forks
0
PR merge metrics
No merged PRs in 30d

Description

## Qué es esta tarea

Definir un formato de diccionario único al que se convierten todas las señales del monitor y del trigger, independientemente de su origen. Es la interfaz entre la capa de detección y el detector (Fase 2).

## Qué se debe hacer

- Definir la estructura del diccionario de señal:
```python
{
"timestamp": "2026-08-12T03:41:00Z",
"signal_type": "service_failed",
"value": "postgresql.service",
"threshold": "active",
"crossed": True
}
```
- Implementar la conversión desde cada fuente (systemctl, df, free, ss, uptime, journalctl)
- Cada tipo de señal (`disk_full`, `memory_low`, `service_failed`, `port_down`, `high_load`) tiene su propio mapeo
- Validar que todas las señales se normalizan sin pérdida de información relevante

## Por qué importa

El detector (Fase 2) necesita una entrada uniforme para aplicar lógica de persistencia, umbrales y máquina de estados. Sin normalización, cada tipo de señal requeriría lógica ad hoc en el detector — más código, más bugs, más difícil de extender.

## Criterio de avance

Todas las lecturas del monitor y del trigger se convierten al diccionario normalizado. El detector puede consumirlas sin saber de qué fuente vinieron.

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.