Logs no Astra

Os logs ajudam você a resolver problemas de transmissão, monitorar a saúde do serviço e entender o que acontece com os seus streams. O Astra agrupa as mensagens de log por nível de gravidade:

• error: problemas críticos que interrompem a entrada do stream ou quebram alguma funcionalidade
• warning: problemas no stream que podem afetar a qualidade da reprodução ou causar falhas
• info: eventos normais do serviço, como inicialização, desligamento, informação de versão ou ativação de streams
• debug: informações técnicas detalhadas sobre o processamento do stream. Desativado por padrão. Ative nas configurações de log ou com a opção de linha de comando --debug
• Log de acesso HTTP: registra todas as requisições ao servidor HTTP do Astra em um arquivo separado

Interface web

Abra os logs na interface web clicando em Log no menu principal:

• Buscar: filtra as mensagens para encontrar rapidamente erros ou eventos específicos
• Configurações: controla quais informações são registradas
• Limpar: remove as mensagens da tela. Os arquivos de log no servidor não são afetados

Configurações de log

Mude o que é registrado em Log → Settings:

• API Access: registra cada requisição à API para acompanhar quem faz mudanças no seu serviço
• Debug: registra informações técnicas detalhadas sobre o processamento do stream para diagnosticar problemas complexos

Onde fica o arquivo de log

Onde o Astra grava os logs depende de como você iniciou o serviço:

• Configuração padrão do serviço com astra init: os logs vão para /var/log/astra.log
• Configuração personalizada do serviço com astra init <port> <service>: os logs vão para /var/log/<service>.log
• Modo console: os logs aparecem apenas na saída do console

Rotação de logs

O Astra controla o tamanho do arquivo de log automaticamente. Quando um arquivo de log chega a 2MB, o Astra cria um arquivo novo e mantém uma versão anterior como backup.

Mensagens comuns

Estes artigos podem ajudar você a entender as mensagens de log mais comuns:

• ERROR: CC - perda ou excesso de pacotes em streams MPEG-TS
• ERROR: PES - pacotes PES corrompidos em streams MPEG-TS