Registos e armazenamento

Ler o registo

1. Abre Settings > Logs (Definições > Registos). O proprietário e os administradores veem-no.
2. Escolhe um Level (nível): Every line (todas as linhas), Warnings and errors (alertas e erros) ou Errors only (só erros).
3. Escreve em Text (texto) para manteres as linhas com essas palavras. Maiúsculas e minúsculas não contam.
4. Define From (de) e To (até) para limitares os dias; o dia de To está incluído. Clica em Apply (aplicar).
5. Muda de página com Newer (mais recentes) e Older (mais antigas), 100 linhas de cada vez, das mais recentes para as mais antigas. Deves ver só as linhas que correspondem.

Partilhar o registo

1. Em Settings > Logs, clica em Download (transferir). Recebes as linhas mais recentes, até 2 MB, num ficheiro de texto.
2. Anexa-o onde pedires ajuda. Vê Obter suporte.

As chaves, os tokens e as palavras-passe já aparecem ocultados como [hidden]. Mesmo assim, lê o ficheiro uma vez antes de o publicares: os nomes dos títulos, das pastas e o endereço do teu servidor continuam visíveis.

Onde ficam os ficheiros

Settings > This app > Storage (Definições > Esta app > Armazenamento) lista cada caminho tal como o HolyArrs o vê, com o espaço livre do respetivo disco. No Docker, são caminhos dentro do contentor.

Caminho	Contém
Pasta de configuração	Todos os dados do HolyArrs
holyarrs.db	Base de dados principal
holyarrs-events.db	Base de dados do Histórico
Pastas de cópias de segurança, imagens e registos	Dentro da pasta de configuração
Pastas da Biblioteca, pasta onde o gestor de transferências guarda	Os teus ficheiros multimédia e as transferências

“free space unknown” (espaço livre desconhecido) significa que o sistema não o indicou.

O ficheiro de registo é logs/holyarrs.log, na pasta de configuração. Aos 5 MB passa para logs/holyarrs.log.1, por isso os registos ficam perto dos 10 MB. docker logs holyarrs mostra o mesmo resultado.

Se não funcionar

Sintoma: a página Registos não aparece. Causa: só o proprietário e os administradores a veem. Solução: pede a um deles.

Sintoma: um caminho parece errado. Causa: no Docker, o Armazenamento mostra caminhos do contentor. Solução: compara com os teus mapeamentos de volumes. Vê Pastas.

Para especialistas

Como os níveis são deduzidos

O nível vem das palavras da linha. “failed”, “crashed” e “error” marcam erros. “could not”, “refused” e “timed out” marcam alertas.

O que é ocultado

Cada linha é ocultada quando é escrita, e outra vez quando é lida ou transferida:

• Todas as chaves, tokens, palavras-passe e ligações de webhook guardados, também nas formas com caracteres de escape de ligação e em base64.
• Valores antigos. Quando um segredo muda ou é removido, os dois ficheiros de registo são reescritos com ele ocultado antes de o valor antigo ser deitado fora.
• Nomes e palavras-passe em ligações: http://user:pass@host passa a http://[hidden]@host.
• Parâmetros de ligação como apikey=, token=, passkey=, password=.
• Pares com um nome de segredo: chave de API, token, palavra-passe, segredo, cookie, autorização, código de configuração. Os valores entre aspas são ocultados até às aspas finais.
• Tokens bearer e basic, chaves de API do HolyArrs (hak_...), o código de configuração da primeira execução e cadeias longas que parecem tokens.

As quebras de linha e os códigos de cor do terminal dentro dos valores aparecem com escape, por isso um valor não consegue fingir uma linha nova. Os valores guardados de 4 ou 5 caracteres só são ocultados como palavra inteira, e nunca quando são uma palavra comum como admin ou test.

API

Rota	Quem	O quê
GET /api/v1/app/storage	Change settings (alterar definições)	Caminhos com espaço livre
GET /api/v1/logs?level=&q=&from=&to=&offset=&limit=	Proprietário, administradores	Linhas e um total
GET /api/v1/logs/download	Proprietário, administradores	Os 2 MB mais recentes em texto simples

As chaves de API precisam do âmbito admin nas três.

Relacionado

• Obter suporte
• Verificações de saúde
• Cópias de segurança