← Blog

PrintStash v0.6.6: métricas y comprobaciones de salud

PrintStash v0.6.6 añadió métricas de Prometheus, una salida de salud más útil y plantillas de Unraid.

versión

PrintStash v0.6.6 se centró en operar el servidor: métricas que se pueden recolectar, más datos de diagnóstico de salud, una vía de instalación en Unraid y recuperación de los escaneos que se quedaron a medias durante un reinicio.

Métricas de Prometheus

La API expuso el formato de texto de Prometheus en /metrics. Las métricas iniciales cubrían la latencia de las peticiones HTTP por plantilla de ruta, los resultados de las ingestas completadas y el estado en directo de las impresoras por proveedor.

El endpoint estaba abierto por defecto, pensado para una red interna de confianza. Configurar VAULT_METRICS_TOKEN exigía un token Bearer estático por parte del recolector.

Los nombres de métrica actuales y una configuración mínima de Prometheus están en la guía de monitorización.

Salida de salud más útil

/api/v1/health añadió los contadores de ingesta en segundo plano y el estado de los escaneos de volúmenes compartidos. Se unieron a las secciones que ya había de base de datos, almacenamiento, copias de seguridad y proveedores de impresora, lo que hizo el endpoint más útil que una simple respuesta de proceso vivo.

Plantillas de Unraid

El repositorio ganó metadatos de Community Applications, plantillas XML para la API y el frontend, y una guía de configuración específica de Unraid. La instalación creaba una red de Docker printstash compartida, arrancaba la API antes del frontend y terminaba en el asistente de configuración normal.

La secuencia actual está documentada en ejecutar PrintStash en Unraid.

Los escaneos interrumpidos se recuperan

Si el backend se paraba durante un escaneo de un volumen compartido, ese escaneo podía quedarse marcado como running después del arranque. El planificador lo saltaba entonces de forma indefinida.

La v0.6.6 pasaba los escaneos huérfanos en estado running a un estado de error durante el arranque. El siguiente escaneo programado o manual podía continuar con normalidad.