Coletando Crash Dumps com o Utilitário Kdump

Se você estiver usando uma imagem de plataforma Oracle Linux, o Kdump será instalado e totalmente configurado ou parcialmente configurado. Você pode alterar a quantidade de memória reservada no kernel para salvar o despejo de memória, também chamado de reserva de memória crashkernel. No Oracle Linux 8 e versões anteriores, a reserva de memória padrão é definida para ajustar automaticamente: GRUB_CMDLINE_LINUX="crashkernel=auto". No entanto, crashkernel=auto não é suportado para o Oracle Linux 9, portanto, você deve definir uma quantidade específica de memória reservada usando o parâmetro crashkernel.

Para definir a reserva de memória para um despejo de memória:

1. Em uma linha de comando, usando privilégios administrativos, estabeleça conexão com a instância usando SSH.
2. Edite o arquivo /etc/default/grub para definir a memória reservada. Por exemplo:
   • Defina a reserva de memória como 64 MB, por exemplo:

     GRUB_CMDLINE_LINUX="crashkernel=64MB"

   • Defina a quantidade de memória reservada como variável usando a sintaxe crashkernel=<range1>:<size1>,<range2>:<size2>. Por exemplo:

     GRUB_CMDLINE_LINUX="crashkernel=512M-2G:64M,2G-:128M"

   • Defina um valor de deslocamento para a memória reservada. Como a reserva crashkernel ocorre no início do processo de inicialização, alguns sistemas exigem que você reserve memória com um determinado deslocamento fixo. Quando um deslocamento fixo é especificado, a memória reservada começa nesse ponto. Por exemplo, para reservar 128 MB de memória, começando em 16 MB:

     GRUB_CMDLINE_LINUX="crashkernel=128M@16M"

3. Salve as alterações e atualize a configuração do grub:

   sudo grub2-mkconfig -o /boot/grub2/grub.cfg

4. Reinicialize a instância para aplicar alterações.

Usando o /etc/kdump.conf, você pode alterar o local em que os arquivos de despejo de memória são salvos, transferi-los via SSH ou exportá-los para um compartilhamento de rede.

1. Em uma linha de comando, usando privilégios administrativos, estabeleça conexão com a instância usando SSH.
2. Edite o arquivo de configuração no arquivo /etc/kdump.conf e remova o caractere de comentário # no início de cada linha que você deseja ativar.
   • Altere o diretório padrão (/var/oled/crash) para os arquivos de despejo de memória, por exemplo:

     path /usr/local/<cores>

   • Transfira arquivos de despejo de memória através de uma conexão de shell segura, por exemplo:

     ssh <user@example.com>
     sshkey /root/.ssh/<mykey>

   • Defina os arquivos de despejo de memória a serem exportados para um compartilhamento de rede compatível, por exemplo:

     nfs <example.com>:/<output>

   Consulte o arquivo kdump.conf.5 no arquivo /usr/share/man/man5/kdump.conf.5.gz para obter mais informações.

3. Quando terminar, salve as alterações e reinicie o serviço kdump.

   sudo systemctl restart kdump.service 

4. Reinicialize a instância para aplicar alterações.

Por padrão, se o Kdump não conseguir enviar seu resultado para os locais de saída configurados, ele reinicializará o servidor. Esta ação exclui todos os dados que foram coletados para o dump. Para evitar esse resultado, altere a configuração do Kdump.

1. Em uma linha de comando, usando privilégios administrativos, estabeleça conexão com a instância usando SSH.
2. Edite /etc/kdump.conf para cancelar o comentário e altere o valor default no arquivo da seguinte forma:

   default dump_to_rootfs

   A opção dump_to_rootfs tenta salvar o resultado em um diretório local, o que pode ser útil se um compartilhamento de rede for inacessível. Em vez disso, você pode usar shell para copiar os dados manualmente da linha de comando.

   Observação
   
   

   As opções poweroff, restart e halt também são válidas para o estado de falha padrão do kdump. No entanto, a execução dessas ações fará com que você perca os dados coletados se essas ações forem executadas. Consulte o arquivo kdump.conf.5 no arquivo /usr/share/man/man5/kdump.conf.5.gz para obter mais informações.

3. Quando terminar, salve as alterações e reinicie o serviço kdump.

   sudo systemctl restart kdump.service

4. Reinicialize a instância para aplicar alterações.

Teste a configuração do Kdump travando o kernel que aciona o serviço para coletar um despejo de memória. Em seguida, revise o despejo de memória.

1. Em uma linha de comando, usando privilégios administrativos, estabeleça conexão com a instância usando SSH.
2. Verifique se o Kdump está em execução:

   systemctl is-active kdump

3. Inicie a falha no console ou na linha de comando:

   echo 1 > /proc/sys/kernel/sysrq
   echo c > /proc/sysrq-trigger

   Isso força o kernel a travar e os arquivos de dump são copiados para o diretório /var/oled/crash/<ip-address>-<YYYY-MM-DD>-<HH:MM:SS>, por padrão, ou para o local que você selecionou na configuração.
4. Reinicialize a instância.
5. Reconecte-se à instância usando SSH e revise os arquivos de dump na /var/oled/crash/<ip-address>-<YYYY-MM-DD>-<HH:MM:SS>:
   • O buffer de mensagens do kernel inclui as informações mais essenciais sobre a falha do sistema e sempre é submetido a dump primeiro no arquivo vmcore-dmesg.txt. Isso é útil quando uma tentativa de obter o arquivo vmcore completo falha, por exemplo, por causa da falta de espaço no local de destino.
   • À medida que a ferramenta kexec é inicializada no segundo kernel e captura o conteúdo da memória do kernel com falha, ela também grava no arquivo kexec-dmes.log para que você possa rastrear o processo. Por exemplo, no final do arquivo, você pode ver o processo de salvamento do despejo de memória:

     ...
     Feb 07 16:28:19 linux9 systemd[1]: Starting Kdump Vmcore Save Service...
     Feb 07 16:28:19 linux9 kdump[504]: Kdump is using the default log level(3).
     Feb 07 16:28:19 linux9 kdump[541]: saving to /kdumproot/var/oled/crash/127.0.0.1-2025-02-07-16:28:19/
     Feb 07 16:28:19 linux9 kdump[546]: saving vmcore-dmesg.txt to /kdumproot/var/oled/crash/127.0.0.1-2025-02-07-16:28:19/
     Feb 07 16:28:19 linux9 kdump[552]: saving vmcore-dmesg.txt complete
     Feb 07 16:28:19 linux9 kdump[554]: saving vmcore
     Feb 07 16:28:21 linux9 kdump.sh[555]: 
     Checking for memory holes                         : [  0.0 %] /                  
     ...
     Copying data                                      : [100.0 %] \           eta: 0s
     Feb 07 16:28:21 linux9 kdump.sh[555]: The dumpfile is saved to /kdumproot/var/oled/crash/127.0.0.1-2025-02-07-16:28:19//vmcore-incomplete.
     Feb 07 16:28:21 linux9 kdump.sh[555]: makedumpfile Completed.
     Feb 07 16:28:21 linux9 kdump[559]: saving vmcore complete
     Feb 07 16:28:21 linux9 kdump[561]: saving the /run/initramfs/kexec-dmesg.log to /kdumproot/var/oled/crash/127.0.0.1-2025-02-07-16:28:19//

   • O arquivo vmcore contém as informações de despejo de memória. Para analisar o dump de memória, você precisa de um utilitário que possa ler o formato de arquivo vmcore. Consulte Analisando Despejos de Pane para obter informações sobre como usar o utilitário crash.

Você pode usar o utilitário crash para analisar os despejos de memória coletados pelo Kdump. Nas imagens da plataforma Oracle Linux, o crash é instalado por padrão. Para outras instâncias do Linux, use a linha de comando para instalá-la: sudo dnf install crash.