shelly-exporter
Exportador Prometheus para dispositivos Shelly (Gen1/Gen2) escrito en Rust. Proporciona métricas completas de consumo energético, temperatura, WiFi y estado del sistema. Bajo consumo de recursos.
Ficha actualizada 27 sept 2026, 19:12 · upstream 27 sept 2026, 18:46 · release v0.2.0
Qué es shelly-exporter
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
shelly-exporter es un exportador Prometheus diseñado específicamente para dispositivos inteligentes Shelly, soportando tanto la generación Gen1 como la Gen2. Implementado en Rust con enfoque en eficiencia de recursos, consume solo 1 core CPU y 1GB RAM en funcionamiento típico.
El software ofrece detección automática de generación de dispositivo mediante endpoints HTTP, descubrimiento opcional vía mDNS (en desarrollo), y métricas detalladas incluyendo consumo instantáneo, energía acumulada, temperatura del hardware, señal WiFi RSSI y estado de conmutadores. Incluye soporte para autenticación básica en dispositivos que lo requieren.
La implementación incluye integración nativa con Docker y Docker Compose, con configuración flexible mediante variables de entorno o argumentos CLI. Proporciona dashboard de Grafana predefinido y documentación completa para despliegue en entornos autoalojados.
- Monitorización energética residencial con Shelly Plus/Pro para análisis de consumo
- Detección de anomalías térmicas en dispositivos IoT mediante métricas de temperatura
- Integración con Prometheus/Grafana para dashboards de domótica empresarial
- Auditoría de estado de firmware y disponibilidad de actualizaciones
- Implementación en Rust garantiza bajo consumo de memoria y alta eficiencia
- Soporte nativo para autenticación básica en dispositivos Shelly protegidos
- Métricas detalladas incluyendo power factor, frecuencia AC y energía total
- Detección automática de generación Gen1/Gen2 sin configuración manual
- Compatible con múltiples instancias mediante variables SHELLY_HOSTS
- Descubrimiento mDNS marcado como 'coming soon' en README actual
- Requiere acceso HTTP directo a API de dispositivos Shelly
- No soporta descubrimiento automático sin configuración manual inicial
- Dependencia de firmware compatible con endpoints HTTP
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.
Desplegar en entorno seguro con autenticación habilitada si los dispositivos lo requieren. Configurar SHELLY_POLL_INTERVAL=60 para reducir carga en redes domésticas saturadas. Asegurar que el puerto 9925 esté expuesto correctamente en firewall. Para producción, considerar usar Docker Compose con restart: unless-stopped y variables de entorno cifradas.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
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.