Logs e armazenamento

Ler o log

1. Abra Settings > Logs (configurações > logs). O dono e os administradores veem essa página.
2. Escolha um Level (nível): Every line (todas as linhas), Warnings and errors (avisos e erros) ou Errors only (só erros).
3. Digite em Text (texto) para ficar só com as linhas que têm essas palavras. Maiúsculas e minúsculas não fazem diferença.
4. Defina From (de) e To (até) para limitar os dias; o dia de To entra. Clique em Apply (aplicar).
5. Mude de página com Newer (mais novas) e Older (mais antigas), 100 linhas por vez, as mais novas primeiro. Você deve ver só as linhas que correspondem.

Compartilhar o log

1. Em Settings > Logs, clique em Download (baixar). Você recebe as linhas mais novas, até 2 MB, em um arquivo de texto.
2. Anexe o arquivo onde você pede ajuda. Veja Obter suporte.

Chaves, tokens e senhas já saem mascarados como [hidden]. Mesmo assim, leia o arquivo uma vez antes de postar: nomes de títulos, pastas e o endereço do seu servidor continuam visíveis.

Onde os arquivos ficam

Settings > This app > Storage (configurações > este app > armazenamento) lista cada caminho como o HolyArrs enxerga, com o espaço livre no disco. No Docker, esses são caminhos de dentro do container.

Caminho	Guarda
Pasta de configuração	Todos os dados do HolyArrs
holyarrs.db	Banco de dados principal
holyarrs-events.db	Banco de dados do Histórico
Pastas de backups, imagens e logs	Dentro da pasta de configuração
Pastas da Biblioteca, pasta onde o gerenciador de downloads salva	Sua mídia e seus downloads

“free space unknown” (espaço livre desconhecido) quer dizer que o sistema não informou.

O arquivo de log é logs/holyarrs.log, na pasta de configuração. Com 5 MB ele vira logs/holyarrs.log.1, então os logs ficam perto de 10 MB. docker logs holyarrs mostra a mesma saída.

Se não funcionar

Sintoma: a página Logs não aparece. Causa: só o dono e os administradores veem essa página. Solução: peça a um deles.

Sintoma: um caminho parece errado. Causa: no Docker, Storage mostra caminhos do container. Solução: compare com seus mapeamentos de volume. Veja Pastas.

Para especialistas

Como o nível é deduzido

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

O que é mascarado

Toda linha é mascarada ao ser escrita, e de novo ao ser lida ou baixada:

• Toda chave, token, senha e link de webhook salvos, inclusive nas formas escapadas para link e em base64.
• Valores antigos. Quando um segredo muda ou é removido, os dois arquivos de log são reescritos com ele mascarado antes de o valor antigo ser descartado.
• Nomes e senhas em links: http://user:pass@host vira http://[hidden]@host.
• Parâmetros de link como apikey=, token=, passkey=, password=.
• Pares com nome de segredo: API key, token, password, secret, cookie, authorization, setup code. Valores entre aspas são mascarados até a aspa de fechamento.
• Tokens bearer e basic, chaves de API do HolyArrs (hak_...), o código de configuração da primeira execução e sequências longas com cara de token.

Quebras de linha e códigos de cor de terminal dentro de valores aparecem escapados, então um valor não consegue fingir uma linha nova. Valores salvos de 4 ou 5 caracteres só são mascarados 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 configurações)	Caminhos com espaço livre
GET /api/v1/logs?level=&q=&from=&to=&offset=&limit=	Dono, administradores	Linhas e um total
GET /api/v1/logs/download	Dono, administradores	Os 2 MB mais novos em texto puro

As chaves de API precisam do escopo admin para as três.

Relacionados

• Obter suporte
• Verificações de saúde
• Backups