Jellystat: Estadísticas avanzadas para Jellyfin
Introducción
Jellystat es una aplicación orientada a la obtención de métricas y estadísticas avanzadas para servidores Jellyfin. Permite analizar actividad de usuarios, sesiones activas, historial de reproducción y patrones de consumo del catálogo multimedia.
Dentro del stack multimedia, actúa como capa de observabilidad funcional sobre Jellyfin, aportando visibilidad histórica que el servidor base no expone de forma estructurada.
Enfoque general / Arquitectura
El despliegue se realiza mediante dos contenedores: la aplicación Jellystat y una base de datos PostgreSQL dedicada. Jellystat consulta el servidor Jellyfin y almacena la información procesada en la base de datos para generar paneles y estadísticas persistentes.
La separación entre aplicación y base de datos permite mantener persistencia independiente y facilita mantenimiento o migraciones futuras.
Desarrollo
Qué se hizo y por qué
Se desplegó Jellystat como servicio complementario a Jellyfin con base de datos propia, evitando reutilizar bases de datos existentes para mantener aislamiento lógico.
La elección de PostgreSQL responde a los requisitos oficiales del proyecto y garantiza almacenamiento consistente de métricas históricas.
El servicio se mantiene en red interna sin exposición pública directa, dado que no es un componente crítico de acceso externo sino una herramienta de análisis.
Configuración utilizada
La configuración contempla:
- Contenedor PostgreSQL con volumen persistente para datos.
- Contenedor Jellystat con variables de entorno para conexión a base de datos.
JWT_SECRETdefinido explícitamente para generación segura de tokens.- Red dedicada (
JellyStat_NET) para aislamiento lógico.
Validación
Tras el despliegue se comprobó:
- Acceso a la interfaz web en el puerto configurado.
- Conexión correcta con la base de datos.
- Sincronización inicial con el servidor Jellyfin.
- Generación de métricas y paneles tras actividad real de reproducción.
Decisiones importantes
- Base de datos dedicada. Evita acoplamiento innecesario con otros servicios.
- Exposición limitada a red interna. No requiere publicación externa.
- Persistencia explícita del volumen PostgreSQL. Las métricas históricas dependen de ello.
Resumen breve
Jellystat añade una capa de análisis y estadísticas persistentes sobre Jellyfin mediante una arquitectura compuesta por aplicación y base de datos dedicada. Permite obtener visibilidad histórica de uso sin modificar el servidor multimedia principal.