Registros y almacenamiento

Leer el registro

1. Abre Settings > Logs (Ajustes > Registros). Lo ven el propietario y los administradores.
2. Elige un Level (nivel): Every line (todas las líneas), Warnings and errors (advertencias y errores) o Errors only (solo errores).
3. Escribe en Text (texto) para quedarte con las líneas que tienen esas palabras. No importan las mayúsculas.
4. Pon From (desde) y To (hasta) para limitar los días; To está incluido. Haz clic en Apply (aplicar).
5. Pasa de página con Newer (más recientes) y Older (más antiguas), de 100 en 100 líneas, las más recientes primero. Deberías ver solo las líneas que coinciden.

Compartir el registro

1. En Settings > Logs, haz clic en Download (descargar). Recibes las líneas más recientes, hasta 2 MB, como archivo de texto.
2. Adjúntalo donde pidas ayuda. Consulta Obtener soporte.

Las claves, los tokens y las contraseñas ya están ocultos como [hidden]. Aun así, lee el archivo una vez antes de publicarlo: los nombres de títulos, las carpetas y la dirección de tu servidor siguen a la vista.

Dónde se guardan los archivos

Settings > This app > Storage (Ajustes > Esta app > Almacenamiento) muestra cada ruta tal como la ve HolyArrs, con el espacio libre de su disco. En Docker son rutas dentro del contenedor.

Ruta	Contiene
Carpeta de configuración	Todos los datos de HolyArrs
holyarrs.db	Base de datos principal
holyarrs-events.db	Base de datos del Historial
Carpetas de copias de seguridad, imágenes y registros	Dentro de la carpeta de configuración
Carpetas de la Biblioteca, carpeta de guardado del gestor de descargas	Tus archivos multimedia y tus descargas

“free space unknown” (espacio libre desconocido) significa que el sistema no lo indicó.

El archivo de registro es logs/holyarrs.log, en la carpeta de configuración. Al llegar a 5 MB pasa a logs/holyarrs.log.1, así que los registros se quedan cerca de 10 MB. docker logs holyarrs muestra la misma salida.

Si no funciona

Síntoma: falta la página Logs. Causa: solo la ven el propietario y los administradores. Solución: pídeselo a uno de ellos.

Síntoma: una ruta parece incorrecta. Causa: en Docker, Storage muestra rutas del contenedor. Solución: compárala con tus mapeos de volúmenes. Consulta Carpetas.

Para expertos

Cómo se deducen los niveles

El nivel sale de las palabras de la línea. “failed”, “crashed” y “error” marcan errores. “could not”, “refused” y “timed out” marcan advertencias.

Qué se oculta

Cada línea se enmascara al escribirse, y otra vez al leerse o descargarse:

• Cada clave, token, contraseña y enlace de webhook guardado, también en sus formas escapadas para enlaces y en base64.
• Valores antiguos. Cuando un secreto cambia o se elimina, los dos archivos de registro se reescriben con él oculto antes de descartar el valor antiguo.
• Nombres y contraseñas en enlaces: http://user:pass@host pasa a ser http://[hidden]@host.
• Parámetros de enlace como apikey=, token=, passkey=, password=.
• Pares con un nombre de secreto: API key, token, password, secret, cookie, authorization, setup code. Los valores entre comillas se ocultan hasta la comilla de cierre.
• Tokens bearer y basic, claves de API de HolyArrs (hak_...), el código de configuración del primer inicio y cadenas largas con aspecto de token.

Los saltos de línea y los códigos de color de terminal dentro de los valores se muestran escapados, así que un valor no puede simular una línea nueva. Los valores guardados de 4 o 5 caracteres se ocultan solo como palabra completa, y nunca cuando son una palabra común como admin o test.

API

Ruta	Quién	Qué
GET /api/v1/app/storage	Change settings (cambiar ajustes)	Rutas con espacio libre
GET /api/v1/logs?level=&q=&from=&to=&offset=&limit=	Propietario, administradores	Líneas y un total
GET /api/v1/logs/download	Propietario, administradores	Los 2 MB más recientes como texto sin formato

Las claves de API necesitan el alcance admin para las tres.

Relacionado

• Obtener soporte
• Comprobaciones de salud
• Copias de seguridad