Agente

El agente de OBSIDIUM es un componente ligero desarrollado en Python encargado de recopilar métricas del sistema y enviarlas de forma segura al servidor central.

Descripción general

El agente se ejecuta en cada nodo cliente y funciona de manera autónoma, realizando tareas de monitorización y transmisión de datos sin intervención manual.

Características

• Consumo mínimo de recursos.
• Ejecución continua en segundo plano.
• Comunicación segura mediante HTTPS/VPN.
• Arquitectura extensible para nuevas métricas.

Instalación

Una vez descargado el agente desde OBSIDIUM:

python agent.py

Configuración

El agente utiliza un archivo de configuración para definir el comportamiento y la conexión con el servidor.

{
  "server": "10.0.0.1",
  "port": 8080,
  "interval": 5,
  "token": "API_KEY"
}

• server: IP privada del servidor OBSIDIUM dentro del túnel creado por la VPN.
• port: Puerto del servicio.
• interval: Intervalo de envío en segundos.
• token: Clave de autenticación.

Métricas recopiladas

• Uso de CPU (%)
• Uso de memoria (%)
• Espacio en disco
• Estado de servicios

Formato de datos enviados

El agente envía los datos en formato JSON al servidor:

{
  "hostname": "server-01",
  "cpu": 35.5,
  "memory": 62.3,
  "disk": 80.1,
  "services": {
    "nginx": "running",
    "mysql": "running"
  },
  "timestamp": "2026-04-13T10:00:00Z"
}

Endpoint

POST /api/metrics

Autenticación

El agente se autentica mediante token incluido en la cabecera HTTP:

Authorization: Bearer API_KEY

Funcionamiento interno

1. Recopila métricas del sistema.
2. Serializa los datos en JSON.
3. Establece conexión segura con el servidor.
4. Envía los datos periódicamente.

Gestión de errores

• Reintentos automáticos en caso de fallo de conexión.
• Logs locales para diagnóstico.
• Validación de respuesta del servidor.

Ejemplo de ejecución

python agent.py --config config.json