host-agent
Solución todo-en-uno en un solo contenedor que combina controlador adaptativo de ventiladores Dell PowerEdge con exportadores Prometheus completos (node_exporter, cadvisor, ipmi_exporter, smartctl_exporter, nvidia_gpu_exporter) y vmagent para monitorización directa.
Ficha actualizada 28 sept 2026, 3:43 · upstream 28 sept 2026, 3:17 · release v0.1.5
Qué es host-agent
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
host-agent es una solución todo-en-uno diseñada para funcionar en cualquier host Linux sin necesidad de orquestación compleja. Combina un controlador adaptativo de ventiladores Dell PowerEdge con múltiples exportadores Prometheus (node_exporter, cadvisor, ipmi_exporter, smartctl_exporter, nvidia_gpu_exporter) y vmagent en una sola imagen Docker. La arquitectura utiliza s6 para supervisión de procesos y permite despliegue directo sin configuración centralizada.
El proyecto incluye un controlador de ventiladores adaptativo con dos capas: una capa PID rápida que cicla cada 15s emitiendo candidatos de velocidad por clase, y una capa lenta de intención que ajusta los objetivos cada 10 minutos hacia el equilibrio real del chasis. Cada sub-servicio detecta automáticamente su hardware al inicio y se auto-desactiva si no está presente, lo que permite usar la misma imagen en un Dell R730xd con GPU Tesla, un servidor Unraid con hardware de consumo o una VM Debian sin componentes exóticos.
La solución soporta perfiles específicos por chasis (13 incluidos, 4 probados en hardware real) y emite métricas nativas en Prometheus sobre el puerto 9100. Incluye soporte específico para Unraid con mapeo de slots de disco a etiquetas Linux y detección automática de actualizaciones pendientes en Debian/Ubuntu mediante apt-status.
- Reemplazar el controlador de ventiladores stock de Dell PowerEdge con curvas PID adaptativas por clase
- Monitorización completa de hardware (CPU, GPU NVIDIA, discos SMART, IPMI) en un solo contenedor
- Integración nativa con Prometheus/VictoriaMetrics/Grafana Cloud mediante vmagent para telemetría remota
- Soporte específico para entornos Unraid con mapeo de slots de disco a etiquetas Linux en dashboards
- Detección automática de componentes y desactivación de servicios no presentes para compatibilidad multi-hardware
- Imagen single-container que elimina la necesidad de orquestación compleja o múltiples contenedores
- Exportadores que se auto-desactivan si el hardware no está presente, permitiendo despliegue universal
- Controlador de ventiladores adaptativo con dos capas: PID rápido y ajuste lento por intención operativa
- Soporte nativo para múltiples arquitecturas de hardware (Dell R730xd, Unraid, Debian VM) sin cambios de imagen
- Cero dependencias Go externas usando solo stdlib para builds limpios y sin vendor
- Requiere acceso root y privilegios elevados (--privileged) para acceder a /dev/ipmi0 y módulos kernel
- Funcionalidad de controlador de ventiladores limitada exclusivamente a hardware Dell IPMI
- Dependencia de módulos kernel IPMI que deben estar cargados manualmente en algunos sistemas (modprobe ipmi_devintf)
- No incluye Docker Compose por defecto, requiere archivo externo o docker run manual para despliegue estándar
- Configuración de Prometheus requiere URL remota explícita y credenciales si el endpoint requiere autenticación
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Establecer hostname antes del arranque para etiquetado correcto en Prometheus. Usar la opción Unraid XML si se gestiona con ese sistema operativo. Montar volúmenes read-only (/sys, /run/docker.sock) para seguridad. Configurar credenciales TLS en PROMETHEUS_REMOTE_WRITE_* si el endpoint requiere autenticación. Verificar compatibilidad de kernel IPMI antes de ejecutar en hardware Dell.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.