pooml
Pooml es un servidor de observabilidad autohospedado en un único binario Go sobre SQLite. Proporciona ingestión de logs y métricas, dashboards SQL, alertas y acceso MCP para IA, sin dependencias pesadas como ELK o Prometheus.
Ficha actualizada 27 sept 2026, 10:37 · upstream 27 sept 2026, 10:20 · release v0.3.1
Qué es pooml
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Pooml (Poor Man's Logger) es una herramienta de observabilidad diseñada para autohospedaje en VPS o instancias pequeñas. Funciona sobre SQLite con dos archivos de base de datos principales y una interfaz web, evitando la complejidad de stacks como ELK o pares Prometheus+Grafana. Está construido en Go y soporta despliegue mediante binario directo, Docker o systemd.
La plataforma ingesta logs vía HTTP (compatible con FluentBit) o OTLP, detectando automáticamente formatos JSON, CLF o texto plano. Las métricas se almacenan como contadores y gauges, normalizando histogramas a series de suma y conteo para consultas SQL directas. Incluye un motor de alertas basado en reglas SQL que envía notificaciones a Pushover u Once Campfire.
Destaca su integración con IA mediante un servidor MCP (@pooml/mcp) que permite a modelos como Claude consultar logs y métricas directamente usando SQL, sin DSLs propensos a alucinaciones. El sistema incluye retención configurable, copias de seguridad a S3 compatibles (AWS, MinIO, R2) y autobservabilidad mediante endpoints Prometheus internos.
- Observabilidad para proyectos personales o equipos pequeños que no requieren infraestructura empresarial.
- Ingestión centralizada de logs desde FluentBit o servicios HTTP sin configurar ELK.
- Consultas SQL directas a métricas y logs para análisis ad-hoc o dashboards personalizados.
- Integración con asistentes de IA (MCP) para diagnóstico automático de incidentes mediante consultas SQL.
- Monitorización de aplicaciones en VPS con retención configurable y copias de seguridad cifradas a S3.
- Arquitectura monolítica en un único binario Go, sin dependencias externas complejas.
- Base de datos SQLite con soporte FTS5 para búsqueda full-text en logs.
- Normalización de métricas a contadores y gauges para consultas SQL optimizadas.
- Integración nativa con MCP para permitir a LLMs consultar datos directamente vía SQL.
- Alertas basadas en reglas SQL ejecutables sobre señales de métricas o logs.
- Copias de seguridad a S3 compatibles con cifrado y retención inmutable (sin permisos de borrado).
- No acepta contribuciones externas; el proyecto mantiene control total del código y dirección.
- Las métricas ricas como histogramas nativos se normalizan a sumas y conteos, perdiendo buckets originales.
- Requiere configuración manual de variables de entorno para encriptación y secretos (POOML_ENCRYPTION_KEY).
- La API de consulta SQL está deshabilitada por defecto y requiere habilitación explícita con autenticación separada.
- El despliegue binario en Linux requiere compilación con la build tag sqlite_fts5 para funcionalidad completa.
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.
Recomendado desplegar en VPS o instancia pequeña. Usar volumen persistente para POOML_DB_DIR (/data). Separar puertos: 8080 para ingestión API, 8081 para UI. Configurar POOML_UI_SECRET y POOML_ENCRYPTION_KEY con mínimo 32 caracteres. Habilitar POOML_METRICS_ENABLED solo si se requiere autobservabilidad. Para binarios, usar tag sqlite_fts5 en compilación Go. Asegurar que el directorio de datos tenga permisos correctos (uid 1001) para evitar crash-loops en Docker.
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.