Tutorial do Rocky Linux 10 / Logs no Rocky Linux 10: journalctl, retenção e logrotate

Para gerenciar logs no Rocky Linux 10, identifique os caminhos de coleta de journals e logs de arquivos, filtre eventos por serviço, boot ou tempo, e configure a retenção para cada método de armazenamento. Os journals são gerenciados pelo journald, enquanto os logs de arquivos precisam ser verificados tanto pelas operações do programa quanto pelo logrotate. Este artigo demonstra como visualizar, rotacionar, compactar e revisar os resultados de retenção em journals e arquivos de prática separados sem excluir logs existentes.

Distinguir o journal, os logs em arquivos e o uso de armazenamento

O systemd-journald registra a saída dos serviços e os eventos do sistema no journal estruturado e é visualizado usando journalctl. O rsyslog ou aplicativos podem registrar arquivos de texto separados. Como o mesmo evento pode ser transmitido por múltiplos caminhos ou um programa pode registrar em apenas um local, a ausência de um único arquivo não significa que todo o log está ausente.

rpm -q systemd logrotate rsyslog
systemctl is-active systemd-journald rsyslog
sudo journalctl --disk-usage
df -hT /var/log
sudo du -xsh /var/log

O ambiente de laboratório de origem era Rocky Linux 10.2, systemd 257, logrotate 3.22.0, rsyslog 8.2510.0. Os comandos foram executados em um guest Linux de uma VM dedicada. O uso inicial do journal examinado era de 8M, e o uso do diretório de /var/log era de 13M. df mostra todo o sistema de arquivos root ao qual esse caminho pertence, portanto, não precisa coincidir com esses valores.

Como verificar O que ele mostra Pontos a distinguir ao interpretar
df -hT /var/log Capacidade e uso do sistema de arquivos ao qual esse caminho pertence Este não é o tamanho apenas do diretório /var/log.
du -xsh /var/log Uso da árvore de diretórios dentro do mesmo sistema de arquivos Pode haver diferenças em relação a 'df' dependendo de permissões, montagens separadas ou arquivos que estão abertos mas foram deletados.
journalctl --disk-usage Uso de arquivos ativos e arquivados do diário selecionado Este não é o valor combinado incluindo logs de texto regulares e outros dados de aplicação.

Se o espaço for insuficiente, primeiro investigue qual sistema de arquivos e caminho de coleção cresceram. Antes de verificar a causa e os requisitos de retenção, não delete todo o /var/log nem faça limpeza em lote do diário padrão. Exporte as evidências de falha necessárias para um local seguro e, em seguida, revise a política de retenção e os resultados reais da rotação.

Prepare um diário de prática dedicado separado do registro padrão.

Desta vez, usaremos um namespace de diário chamado lf-course24. Um namespace permite que você escolha uma instância de coleção separada e espaço de armazenamento, para que você possa praticar sem alterar as configurações do diário padrão existente. Se você excluir o --namespace=lf-course24, a consulta, rotação e os alvos de limpeza serão diferentes, então mantenha-o nos comandos subsequentes.

Se um caminho somente para prática já existir, não o sobrescreva; verifique o estado anterior primeiro. O diretório de backup e as configurações de namespace abaixo são usados apenas para esta prática.

sudo bash <<'BASH'
set -eu
test ! -e /root/lf-course24
test ! -e /etc/systemd/journald@lf-course24.conf.d
mkdir -m 700 /root/lf-course24
cp -a /etc/logrotate.conf /root/lf-course24/logrotate-original.conf
cp -a /etc/logrotate.d /root/lf-course24/logrotate-original.d
systemd-analyze cat-config systemd/journald.conf > /root/lf-course24/journald-original.txt
mkdir -m 755 /etc/systemd/journald@lf-course24.conf.d
BASH
sudoedit /etc/systemd/journald@lf-course24.conf.d/10-course.conf

O conteúdo completo do arquivo de configuração é o seguinte. Para os caminhos de arquivo suportados e definições de opções, consulte o manual oficial journald.conf .

[Journal]
Storage=persistent
SystemMaxUse=16M
SystemKeepFree=16M
SystemMaxFileSize=1M
MaxRetentionSec=1day
ForwardToSyslog=no

Storage=persistent é a configuração para selecionar um caminho de armazenamento permanente, e SystemMaxUse · SystemKeepFree são condições relativas ao uso e ao espaço restante. SystemMaxFileSize trata do tamanho de arquivo individual, e MaxRetentionSec é uma configuração que limita o período de retenção. Não use os valores pequenos da prática como valores recomendados para um servidor de produção. Eles devem ser determinados de acordo com o volume real de geração de logs, período de análise e espaço em disco disponível.

Devido à rotação de arquivos, unidades de exclusão e arquivos ativos, o uso momentâneo não pode ser interpretado como um limite máximo em bytes exatos. A verificação da fonte conferiu o carregamento das configurações e a gestão manual da rotação/contagem de arquivos, mas não realizou testes para o processo de exclusão automática após um dia ou testes de carga atingindo o limite de 16M. ForwardToSyslog=no é uma configuração para desabilitar o encaminhamento deste journal de prática para o syslog, e as configurações padrão do rsyslog são mantidas.

Abra um arquivo com sudoedit /root/lf-course24/write-journal.py e salve o seguinte exemplo em Python. O Python 3 é necessário, e ele gera 300 linhas de log diferenciadas de acordo com os argumentos 1–4.

import sys

def main():
    batch=sys.argv[1]
    if batch not in {'1','2','3','4'}:
        raise ValueError('Use lab batch 1 to 4')
    for number in range(300):
        print(f'LF24-BATCH{batch}-{number:03d} '+ 'x'*128, flush=True)
if __name__=='__main__':
    main()

O loop a seguir executa quatro lotes como um serviço único separado, alternando após os três primeiros lotes. A saída padrão do serviço é enviada para o diário deste namespace. Não use comandos para reiniciar o daemon de diário padrão.

bash <<'BASH'
set -euo pipefail
for batch in 1 2 3 4; do
  sudo systemd-run --quiet --wait --collect \
    --unit="lf-course24-batch${batch}" \
    --property=LogNamespace=lf-course24 \
    --property=StandardOutput=journal \
    /usr/bin/python3 /root/lf-course24/write-journal.py "$batch"
  sudo journalctl --namespace=lf-course24 --sync
  if test "$batch" -lt 4; then
    sudo journalctl --namespace=lf-course24 --rotate
  fi
done
BASH

Quando uma nova instância de namespace é iniciada, ela lê configurações dedicadas. Em situações em que você está modificando uma instância já em execução, é necessário considerar separadamente como as configurações são aplicadas e os serviços que estão atualmente gerando saída. Não repita este comando cegamente em um nome de laboratório existente.

Encontre diários por serviço, inicialização, tempo e prioridade.

Após criar os logs do laboratório, tente restringir as condições de pesquisa. -b representa a inicialização atual, -u representa a unidade, e --since representa o horário de início. -n 3 permite visualizar as três últimas linhas, e --no-pager permite pular o programa de paginação.

sudo journalctl --namespace=lf-course24 -b \
  -u lf-course24-batch4.service -n 3 --no-pager -o short-iso
sudo journalctl --namespace=lf-course24 -b \
  -u lf-course24-batch4.service --since '10 minutes ago' --no-pager -q -o cat
sudo journalctl --namespace=lf-course24 -b \
  -u lf-course24-batch4.service -p warning --no-pager -q -o cat

No laboratório de origem, os últimos logs foram LF24-BATCH4-297 ~ 299, e uma consulta de intervalo de 10 minutos imediatamente após a criação produziu 300 linhas. -p warning seleciona itens de prioridade de aviso ou maior, e nesta saída de teste, não houve linhas. A ausência de resultados da pesquisa significa que não há itens correspondentes às condições, não que o serviço esteja operando normalmente. Verifique o namespace, nome da unidade, inicialização, intervalo de tempo e permissões juntos.

Ao exportar mensagens necessárias para um arquivo, considere também as permissões de redirecionamento do shell do usuário atual. Abaixo está um exemplo de salvamento em um caminho de laboratório acessível apenas pelo root. Os logs operacionais reais podem conter valores sensíveis, como informações de usuário e tokens, portanto, você deve verificar o conteúdo e as permissões antes de usá-los em postagens públicas ou para distribuição externa.

sudo sh -c 'journalctl --namespace=lf-course24 -b -u lf-course24-batch4.service --no-pager -q -o cat > /root/lf-course24/batch4-export.txt'
sudo wc -l /root/lf-course24/batch4-export.txt

Na verificação, foi confirmado que a mensagem exportada consistia em 300 linhas. As definições de filtros e as opções de saída, rotação e limpeza podem ser encontradas no manual oficial do journalctl.

O significado real da rotação do journal e dos limites de contagem de arquivos

--rotate é a operação de converter o arquivo atualmente ativo em um arquivo arquivado e abrir um novo arquivo ativo. Não confunda a rotação em si com a exclusão de logs anteriores. Por outro lado, --vacuum-files é um comando de limpeza que pode deletar arquivos arquivados antigos. O seguinte é executado apenas em logs de prática dedicados que podem ser deletados.

sudo journalctl --namespace=lf-course24 --disk-usage
sudo journalctl --namespace=lf-course24 --sync
sudo journalctl --namespace=lf-course24 --vacuum-files=1
sudo journalctl --namespace=lf-course24 --disk-usage

No comportamento testado do systemd 257, --vacuum-files=1 não significava 'mantendo um arquivo arquivado'. O limite de contagem de arquivos também afeta o arquivo ativo, mas as operações de exclusão se aplicam apenas aos arquivos arquivados. Há casos em que não pode ser reduzido ao número especificado porque o arquivo ativo não pode ser removido.

Essa prática começou com um arquivo ativo e três arquivos arquivados contendo os três lotes anteriores. Ao aplicar um limite de contagem de arquivos de 1, todos os três arquivos arquivados foram deletados, restando apenas o arquivo ativo. Os lotes 1, 2 e 3 tinham 0 linhas cada, e o lote 4 no arquivo ativo foi confirmado com 300 linhas. O uso mudou de cerca de 1,5M para 1M.

--disk-usage mostra o uso real de diários ativos e arquivados juntos. Como o tamanho lógico do arquivo na lista de arquivos e o espaço realmente alocado no disco podem diferir, a soma dos tamanhos dos arquivos pode ser diferente. Projete com critérios de capacidade, período e contagem juntos, e armazene separadamente os logs necessários antes da exclusão.

Verifique o logrotate com arquivos separados e arquivos de status.

Use uma configuração de logrotate separada para logs de arquivos gerais. Em vez de registrar no existente /etc/logrotate.d ou compartilhar arquivos de status do sistema, apenas gire um arquivo dedicado. Se os seguintes diretórios já existirem, investigue-os primeiro sem sobrescrever.

sudo mkdir -m 750 /var/log/lf-course24
sudoedit /root/lf-course24/logrotate.conf

O conteúdo completo do arquivo de configuração é o seguinte. size 1k determina em tempo de execução se o arquivo excede a condição de tamanho, e rotate 2 especifica manter dois arquivos rotacionados. Incluindo o arquivo de log atual, pode haver três arquivos, então isso não deve ser confundido com a opção de contagem de arquivos do journal.

/var/log/lf-course24/application.log {
    size 1k
    rotate 2
    compress
    missingok
    notifempty
    create 0640 root root
}

compress comprime arquivos rotacionados, e create define as permissões e a propriedade do novo arquivo de log atual. missingok permite arquivos ausentes, e notifempty impede a rotação de arquivos vazios. Como os arquivos de prática são escritos pelo root, use essa propriedade, mas essas configurações não são necessariamente aplicadas às contas de serviço operacionais reais.

Abra o arquivo com sudoedit /root/lf-course24/write-file.py e salve o exemplo inteiro para criar o arquivo de teste abaixo. O log atual com conteúdo existente não é sobrescrito, e o próximo lote é criado no arquivo vazio após a rotação.

import sys
from pathlib import Path

def main():
    batch=sys.argv[1]
    if batch not in {'1','2','3'}:
        raise ValueError('Use lab batch 1 to 3')
    path=Path('/var/log/lf-course24/application.log')
    if path.exists() and path.stat().st_size:
        raise RuntimeError('Refusing to overwrite a nonempty log')
    with path.open('w') as stream:
        for number in range(20):
            stream.write(f'FILE24-BATCH{batch}-{number:02d} '+ 'y'*128+'\n')
    path.chmod(0o640)
if __name__=='__main__':
    main()

Primeiro, crie o lote 1 e depois verifique apenas o plano de execução no modo de depuração.

sudo python3 /root/lf-course24/write-file.py 1
sudo sha256sum /var/log/lf-course24/application.log
sudo logrotate --debug --state /root/lf-course24/logrotate.state /root/lf-course24/logrotate.conf
sudo sha256sum /var/log/lf-course24/application.log

Nessa verificação, os hashes anteriores e posteriores à execução eram iguais, e os arquivos comprimidos e de estado não foram criados. Mesmo que a saída de depuração mostre planos como renaming ou Creating new state, isso não significa que as alterações reais foram concluídas. As opções de execução real e arquivos de estado são diferenciadas no manual oficial do logrotate.

Agora, realmente gire o lote 1, depois crie e gire os lotes 2 e 3 em ordem. Como esta é uma prática baseada no tamanho, a opção de execução forçada não é utilizada.

sudo logrotate --verbose --state /root/lf-course24/logrotate.state /root/lf-course24/logrotate.conf
for batch in 2 3; do
  sudo python3 /root/lf-course24/write-file.py "$batch"
  sudo logrotate --verbose --state /root/lf-course24/logrotate.state /root/lf-course24/logrotate.conf
done
sudo stat -c '%a %U:%G %s %n' /var/log/lf-course24/application.log /var/log/lf-course24/application.log.1.gz /var/log/lf-course24/application.log.2.gz
sudo gzip -cd /var/log/lf-course24/application.log.1.gz | head -n 1
sudo gzip -cd /var/log/lf-course24/application.log.2.gz | head -n 1

O resultado real foi que o arquivo atual tinha 0 bytes, permissão 640, proprietário root, com 20 linhas do lote 3 restantes em .1.gz e 20 linhas do lote 2 restantes em .2.gz. O lote 1 mais antigo foi removido. Quando executado novamente no arquivo atual vazio, ele não foi rotacionado.

Esta configuração é a condição que o logrotate verifica quando é executado. Especificar size 1k nem sempre mantém o arquivo abaixo de 1 KiB. Na operação real, é necessário verificar tanto o intervalo de execução da programação quanto a quantidade gerada. Este exercício é uma verificação de execução manual e não alterou o temporizador do sistema nem as configurações globais.

Aplicar rotação aos serviços em execução e limpar o laboratório

Como o programa de teste único termina de escrever e sai, mesmo que você renomeie o arquivo e crie um novo, o próximo lote usará o novo arquivo. Um daemon em execução contínua pode continuar a escrever no arquivo previamente aberto. Você precisa verificar o método oficial de reabertura/recarregamento do serviço operacional e recursos como postrotate no logrotate, e não deve considerar este teste uma verificação da reabertura de logs por um daemon.

copytruncate não é uma solução adequada para todos os programas. Revise as condições no manual, como a possibilidade de perda entre operações de copiar e recortar. Em vez de excluir indiscriminadamente os logs existentes ou forçar a parada do serviço para evitar problemas, verifique o método de registro do serviço junto com permissões de arquivo, rótulos SELinux e comportamento pós-rotação.

Ao terminar o exercício, pare apenas a instância de diário dedicada e o socket. Não há necessidade de parar o systemd-journald.service ou rsyslog padrão.

sudo journalctl --namespace=lf-course24 --sync
sudo systemctl stop systemd-journald@lf-course24.service systemd-journald@lf-course24.socket systemd-journald-varlink@lf-course24.socket
sudo cp -a /etc/systemd/journald@lf-course24.conf.d/10-course.conf /root/lf-course24/journald-namespace.conf
sudo rm -- /etc/systemd/journald@lf-course24.conf.d/10-course.conf
sudo rmdir /etc/systemd/journald@lf-course24.conf.d
systemctl is-active systemd-journald rsyslog

Os logs de teste, exportações e arquivos de status são mantidos como registros de prática, se necessário. Na verificação da origem, os caminhos e as listas de arquivos de log do namespace dedicado foram conferidos. O arquivo de configuração desse namespace foi copiado para backup, os hashes foram comparados e, em seguida, apenas esse arquivo original e seu diretório de configuração vazio foram removidos; os logs não foram apagados. As configurações padrão do diário, as configurações existentes do logrotate, arquivos de configuração individuais e fstab correspondiam às de antes do trabalho, e o journald padrão, rsyslog, SSH e firewall estavam ativos.