Tutorial do Debian 13 / Gerenciar o journal e testar a rotação de logs com logrotate

O Debian 13 gerencia logs distinguindo entre registros do journal consultados com journalctl e logs de arquivos que os aplicativos escrevem diretamente. Primeiro, você exporta os registros necessários para a solução de problemas e, para logs de arquivos, é necessário definir rotação, compactação e o número de arquivos conservados de acordo com o método de reabertura do programa. Este tutorial demonstra a operação do logrotate com arquivos e serviços dedicados sem excluir os logs operacionais.

Distinguir o journal dos logs de aplicativos em arquivos

systemd-journald coleta a saída padrão e erros dos serviços, bem como mensagens do sistema, em diários com campos. journalctl é uma ferramenta para visualizar os registros armazenados. Por outro lado, arquivos de log de aplicativos localizados, por exemplo, em /var/log/nginx podem ser abertos e escritos pelo próprio programa, e o logrotate normalmente os renomeia, comprime e mantém.

Alvo Principais ferramentas Itens a verificar
Diário systemd Configurações do journalctl e journald Serviço, inicialização, tempo, prioridade, local de armazenamento e política de tamanho
Logs de arquivos de programas Configurações do aplicativo e logrotate Caminho do arquivo, propriedade e arquivos abertos, reabertura na rotação e tempo de compressão

Não exclua arquivos de journal com rm como se fossem arquivos de texto comuns nem os inclua no logrotate. Se os arquivos de log forem deletados mas o espaço permanecer, isso também está relacionado a arquivos deletados que ainda estão abertos. Use o laboratório de diagnóstico de espaço em disco e arquivos excluídos ainda abertos para comparar df e du, e primeiro identifique os serviços que escrevem logs.

Filtrar por serviço, inicialização e período

Determine o serviço e o horário em que o problema ocorreu e consulte da seguinte forma. Substitua o exemplo de tempo pelo horário real da falha do servidor. A saída pode incluir informações como contas, endereços e tokens, portanto, revise antes de compartilhar externamente.

sudo journalctl --list-boots --no-pager
sudo journalctl -b -u nginx.service -n 50 --no-pager
sudo journalctl -b -u nginx.service --since '2026-11-16 22:00:00' --until '2026-11-16 23:00:00' -o short-iso --no-pager
sudo journalctl -b -p warning --no-pager
sudo journalctl -b -k --no-pager

-b seleciona a inicialização atual, -b -1 seleciona a inicialização salva anteriormente. Primeiro verifique a existência com --list-boots. -u é para serviços, -k é para mensagens do kernel, -p warning limita o escopo a avisos e prioridades mais graves. Se você especificar o nível de erro, pode perder pistas no nível de informação, então não olhe apenas para isso desde o início.

A VM de prática possuía registros de inicializações anteriores preservados e o journalctl --disk-usage reportou 40MiB combinando arquivos ativos e arquivados. Esta é a observação no exemplo atual e não a retenção padrão para todos os servidores Debian. Permissões de consulta e filtros podem ser verificados no manual do journalctl do Debian.

Para um serviço de usuário, use journalctl --user -u UNIT, substituindo UNIT pelo nome real do serviço. Se o acesso ao journal do sistema estiver restrito, use sudo para a consulta necessária em vez de adicionar a conta a um grupo com privilégios amplos por conveniência.

Criar o serviço completo de gravação de logs

Este é um ambiente de prática dedicado para Debian 13, systemd 257, Python 3 e logrotate 3.22. O exemplo abaixo assume uma VM com um usuário comum lfstudent. Se estiver usando uma conta diferente, altere User e Group da unidade e o proprietário indicado pela diretiva create do logrotate para a mesma conta existente. Você pode verificar se a conta existe com id lfstudent.

Prepare após a instalação e verificação do caminho. Se um nome dedicado já existir, pare sem sobrescrever arquivos existentes. Este arquivo apenas registra dados de prática e não está vinculado aos logs existentes do Nginx.

sudo apt install logrotate python3
id lfstudent
for p in /var/log/lf-log29 /var/backups/lf-debian13-29 /usr/local/libexec/lf-log29-writer.py /etc/systemd/system/lf-log29.service; do
    if test -e "$p"; then echo "Already exists: $p" >&2; exit 1; fi
done
sudo install -d -m 755 /var/log/lf-log29 /usr/local/libexec
sudo install -d -m 700 /var/backups/lf-debian13-29
sudo install -m 640 -o lfstudent -g lfstudent /dev/null /var/log/lf-log29/app.log

Salve todo o seguinte programa Python. Ele mantém o arquivo aberto enquanto escreve. Em SIGHUP (o sinal de hang-up), ele solicita fechamento e reabertura do mesmo caminho na próxima iteração. A execução está limitada a 6.000 iterações, aproximadamente dez minutos, para permitir a realização das etapas. Nem todos os serviços gerais suportam reabertura com SIGHUP.

sudo tee /usr/local/libexec/lf-log29-writer.py > /dev/null <<'PY'
import os,signal,time
path='/var/log/lf-log29/app.log'
reopen=True
running=True
def hup(signum,frame):
    global reopen
    reopen=True
def stop(signum,frame):
    global running
    running=False
signal.signal(signal.SIGHUP,hup)
signal.signal(signal.SIGTERM,stop)
f=None
try:
    for number in range(6000):
        if not running: break
        if reopen:
            if f is not None: f.close()
            f=open(path,'a',buffering=1)
            reopen=False
            print(f'<6>opened inode={os.fstat(f.fileno()).st_ino}',flush=True)
        f.write(f'line={number:04d} sample log record\n')
        time.sleep(.1)
finally:
    if f is not None: f.close()
    print('<6>writer stopped',flush=True)
PY

Confirme que id lfstudent seja bem-sucedido antes de preparar arquivos; pare se a conta ou qualquer etapa de instalação falhar. Após salvar a unidade, verifique-a com sudo systemd-analyze verify /etc/systemd/system/lf-log29.service antes de daemon-reload e start.

Salve toda a unidade a seguir. A saída padrão registra o inode do arquivo aberto, e o arquivo registra entradas numeradas. A reabertura do arquivo é solicitada pelo HUP enviado através do ExecReload. Se aplicado como está em um programa real que não suporta isso, ele pode ser encerrado, portanto a documentação do programa deve ser verificada.

sudo tee /etc/systemd/system/lf-log29.service > /dev/null <<'UNIT'
[Unit]
Description=LF log rotation lab 29
[Service]
Type=exec
User=lfstudent
Group=lfstudent
ExecStart=/usr/bin/python3 /usr/local/libexec/lf-log29-writer.py
ExecReload=/bin/kill -HUP $MAINPID
SyslogIdentifier=lf-log29
UNIT
sudo chmod 644 /usr/local/libexec/lf-log29-writer.py
sudo systemctl daemon-reload
sudo systemctl start lf-log29.service
sleep 1
sudo systemctl is-active lf-log29.service
sudo tail /var/log/lf-log29/app.log
sudo journalctl -b -u lf-log29.service -n 10 --no-pager

O arquivo recebe linhas numeradas, como line=0000 sample log record. No journal, opened inode= é seguido pelo número do inode aberto. Se o programa foi encerrado durante a prática, verifique os logs e o status e, em seguida, reinicie apenas o serviço dedicado. Faça distinção entre encerramento normal ao atingir o tempo máximo de execução do exemplo e erros de permissão.

Criar uma configuração independente do logrotate e verificar o modo de depuração

As configurações de prática são colocadas como arquivos independentes na pasta de backup, não em /etc/logrotate.d. Portanto, o temporizador diário do sistema não lida automaticamente com este exemplo, e apenas a verificação manual é realizada. Usar um --state separado também não altera o arquivo de estado padrão do sistema.

sudo tee /var/backups/lf-debian13-29/logrotate.conf > /dev/null <<'CONF'
/var/log/lf-log29/app.log {
    size 100
    rotate 2
    compress
    delaycompress
    missingok
    notifempty
    create 0640 lfstudent lfstudent
    sharedscripts
    postrotate
        /usr/bin/systemctl reload lf-log29.service
    endscript
}
CONF
sudo chmod 600 /var/backups/lf-debian13-29/logrotate.conf
sudo logrotate --debug --state /var/backups/lf-debian13-29/logrotate.state /var/backups/lf-debian13-29/logrotate.conf
sudo ls -l /var/log/lf-log29

--debug mostra a lógica, mas não altera arquivos de logs ou de estado. Na verificação de execução, o processo de escrita foi temporariamente pausado para comparar hashes, confirmando que o conteúdo dos arquivos, arquivos rotacionados e arquivos de estado separados não mudam. Os leitores não precisam interromper o processo operacional para esta verificação. O fato de o hash do arquivo em escrita ter mudado não significa que o debug modificou o arquivo.

Diretivas Significado e critérios de seleção
size 100 Este é um limite pequeno de prática baseado em 100 bytes. Não é uma função de monitoramento de rotação em tempo real exatamente nesse tamanho.
rotate 2 Mantenha dois backups rotacionados. A configuração não garante dois dias.
compress / delaycompress Comprimir, mas adiar a compressão do arquivo mais recente até a próxima rotação.
create 0640 Especifique as permissões e propriedade do novo log ativo.
postrotate Neste exemplo, solicite recarregamento para que o serviço abra um novo arquivo após a rotação.

O manual do logrotate do Debian descreve as opções suportadas e o comportamento de depuração/estado. Verifique a precedência ao combinar condições, como size e daily. Um limite de tamanho pequeno não impede um crescimento substancial entre as invocações quando o logrotate é executado apenas uma vez por dia.

Verificar rotação, compressão e reabertura do arquivo

A seguir está a primeira rotação com --force aplicada apenas à configuração dedicada. É uma execução forçada para esclarecer as condições ao testar inicialmente e não é usada para toda a configuração de produção.

sudo logrotate --verbose --force --state /var/backups/lf-debian13-29/logrotate.state /var/backups/lf-debian13-29/logrotate.conf
sleep 1
sudo ls -li /var/log/lf-log29
sudo tail /var/log/lf-log29/app.log
sudo journalctl -b -u lf-log29.service -n 15 --no-pager

Durante a primeira rotação, o arquivo existente se torna app.log.1 e o novo app.log possui um inode diferente. Este programa abre o novo caminho na próxima iteração após receber HUP. Nesse curto intervalo, as linhas gravadas no arquivo anterior podem permanecer no arquivo arquivado anterior. O que é importante é se os registros subsequentes continuam a ir para o novo arquivo ativo. Durante a verificação, até comparamos se o inode do descritor de arquivo aberto em /proc correspondia ao inode do arquivo ativo.

Execute o bloco a seguir duas vezes, dando três rotações no total. Após cada rotação, espere brevemente para verificar se o conteúdo apareceu no arquivo ativo. Se o novo arquivo estiver vazio, ele pode pular a rotação devido a notifempty, e se o programa tiver saído, o reload pós-rotação pode falhar.

sudo logrotate --verbose --force --state /var/backups/lf-debian13-29/logrotate.state /var/backups/lf-debian13-29/logrotate.conf
sleep 1
sudo ls -li /var/log/lf-log29
sudo gzip -t /var/log/lf-log29/app.log.2.gz
sudo gzip -cd /var/log/lf-log29/app.log.2.gz | head
Número de rotações Registro ativo Arquivos
Primeiro Retomar escrita em app.log app.log.1, ainda não comprimido
Segundo Gravado em novo app.log app.log.1 e app.log.2.gz
Terceiro Gravado em novo app.log Manter duas versões de backup, remover o conteúdo do backup mais antigo primeiro

Nas três rotações reais, a verificação do gzip passou e o app.log.3.gz não permaneceu. Os números de inode podem ser reutilizados, então não espere que eles aumentem globalmente. Se você apenas renomear sem reabrir, o processo pode continuar a escrever no inode anterior. O copytruncate não é usado como uma solução geral para todos os programas porque existe a possibilidade de perder registros entre a cópia e o truncamento.

Exportar o journal e preservar os logs antes da limpeza

Ao preservar logs para investigação, registre filtros, fusos horários e condições de inicialização juntos. O texto é fácil de ler, e o formato de exportação pode ser usado ao manter os campos do diário juntos. O fato de um arquivo de exportação ter sido criado não significa que ele foi re-registrado no diário principal.

sudo systemctl stop lf-log29.service
sudo journalctl --sync
sudo journalctl -b -u lf-log29.service -o short-iso --no-pager | sudo tee /var/backups/lf-debian13-29/service-journal.txt > /dev/null
sudo journalctl -b -u lf-log29.service -o export --no-pager | sudo tee /var/backups/lf-debian13-29/service-journal.export > /dev/null
sudo cp -a /var/log/lf-log29/app.log /var/log/lf-log29/app.log.1 /var/log/lf-log29/app.log.2.gz /var/backups/lf-debian13-29/
sudo ls -lh /var/backups/lf-debian13-29

Na prática, os registros de reabertura e as mensagens de término normal do programa de gravação foram incluídas no diário exportado, e logs de arquivos e backups comprimidos também foram copiados separadamente. Se houver arquivos pulados devido a rotações intermediárias, preserve de acordo com a lista real e não trate o backup como completo enquanto ignorar falhas de cópia.

Rever a política de retenção e remover o laboratório

A política de armazenamento do journald é verificada com as configurações de mesclagem da seguinte forma. Storage=auto altera o método de armazenamento dependendo da presença do diretório de diário permanente, etc. Para preservar inicializações anteriores, verifique também se está realmente armazenado permanentemente e se é gravável.

systemd-analyze cat-config systemd/journald.conf
sudo journalctl --disk-usage
systemctl cat logrotate.timer
systemctl list-timers logrotate.timer --no-pager

SystemMaxUse e RuntimeMaxUse no journald são as políticas de uso para o armazenamento permanente e de tempo de execução, respectivamente, e MaxRetentionSec é um item que limita o período de retenção de registros antigos. Os dados podem ser removidos antes devido a limites de capacidade, portanto, não garante um período mínimo de retenção. Com base no manual de configuração de retenção do journald no Debian, você decide junto sobre a disponibilidade de espaço em disco, volume de geração de logs e período de retenção necessário.

Ao realmente alterar a política, faça backup das configurações existentes e especifique a seção [Journal] em um arquivo .conf separado gerenciado por você em /etc/systemd/journald.conf.d, depois verifique o resultado mesclado. Aplique executando sudo systemctl restart systemd-journald e verifique o status do serviço e erros de log. Ao reverter, apenas remova o drop-in que você criou e aplique novamente. Logs que já foram excluídos de acordo com a política de retenção não são restaurados ao reverter as configurações, portanto, primeiro preserve quaisquer registros necessários externamente.

Esta prática não alterou a política de retenção existente do journald nem excluiu o diário operacional usando vacuum. A função vacuum do journalctl exclui apenas arquivos de journal arquivados. Como --disk-usage também inclui arquivos ativos, o total pode não cair imediatamente para o limite solicitado. Não exclua logs em massa antes da investigação apenas porque o armazenamento é insuficiente.

Pare o serviço de prática, verifique a cópia e só então limpe os arquivos dedicados. Como nada foi adicionado a /etc/logrotate.d, outras regras do temporizador do sistema permanecem em vigor.

sudo rm -- /etc/systemd/system/lf-log29.service /usr/local/libexec/lf-log29-writer.py
sudo systemctl daemon-reload
sudo rm -- /var/log/lf-log29/app.log /var/log/lf-log29/app.log.1 /var/log/lf-log29/app.log.2.gz
sudo rmdir /var/log/lf-log29

Após a verificação, o serviço dedicado e o caminho do log foram removidos, e as evidências juntamente com os arquivos de configuração e estado foram preservadas em /var/backups/lf-debian13-29. Apenas regras com tamanho real apropriado, cronograma de execução e comandos de recarregamento são adicionadas ao logrotate operacional, e a rotação forçada de 100 bytes desta prática não é usada como padrão operacional.