Como coletar informações de depuração com o sosreport

O Container-Optimized OS inclui o utilitário sosreport, que coleta informações sob demanda para ajudar a depurar problemas em uma instância de máquina virtual do Container-Optimized OS. As informações são coletadas e armazenadas localmente no sistema de arquivos da instância. O Google não coleta nem armazena esses dados em outro lugar.

Se você abrir um caso de suporte com o suporte do Google Cloud devido a problemas com a instância, talvez seja necessário fornecer os dados sosreport como parte da investigação. Esta página mostra como coletar essas informações.

Observação: criar o relatório consome recursos de CPU e memória, e armazenar o relatório consome espaço em disco e recurso de largura de banda de I/O no nó. A quantidade de recursos consumidos não pode ser estimada facilmente.

Observação: ao solucionar problemas de disponibilidade e inicialização de nós, coletar sosreport pode ser difícil. O reparo automático de nós será encerrado e criará novamente o nó após algum tempo de indisponibilidade. Consulte Como desativar o reparo automático de nós se a coleta de sosreport não puder ser feita antes do encerramento do nó pelo reparo automático. Se o reparo automático não puder ser desativado porque o cluster está no canal de lançamento, entre em contato com o Cloud Customer Care para receber ajuda.

A saída de sosreport é armazenada sem criptografia em um arquivo .tar.xz. O arquivo pode conter informações de identificação pessoal (PII), pois ele coleta dados de muitos componentes críticos do sistema (por exemplo, journald). O arquivo pode ser inspecionado na instância, e a maioria do conteúdo está em texto simples. A ferramenta sosreport é de código aberto, e você pode revisar o código.

Como coletar os dados do sosreport

Para criar um relatório, use SSH para se conectar à instância de máquina virtual relevante usando o comando gcloud compute ssh:

gcloud compute ssh [INSTANCE_NAME]

Em seguida, execute o seguinte comando sosreport:

sudo sos report --all-logs --batch --tmp-dir=/var

Observação :no Container-Optimized OS 85 e em versões anteriores, o sosreport pode ser coletado usando o comando sudo sosreport --all-logs --batch --tmp-dir=/var

É possível alterar o diretório em que o relatório está armazenado passando um diretório diferente para a opção --tmp-dir. Você também pode alterar o comportamento padrão do comando editando /etc/sos.conf na instância.

A saída é armazenada em um arquivo .tar.xz no diretório especificado usando a opção --tmp-dir. O local e a soma de verificação do arquivo .tar.xz são mostrados em STDOUT.

Your sosreport has been generated and saved in:
  /var/sosreport-cos-20181106231224.tar.xz

The checksum is: 5a8b97c6020346a688254c8b04ef86ec

Como visualizar os dados coletados

O relatório pertence a root e não pode ser lido por outros usuários. Use os seguintes comandos para alterar o proprietário para seu usuário atual e torná-lo legível por você. Não torná-lo legível.

TARBALL=[PATH/TO/TARBALL]
sudo chown $(whoami) $TARBALL
chmod +r $TARBALL

Em seguida, se você quiser visualizar o conteúdo do relatório no nó, poderá extraí-lo executando o comando abaixo:

tar xvf $TARBALL

Os arquivos de relatório individuais agora estão disponíveis em um diretório no mesmo local que o .tar.xz. É possível visualizar os registros usando comandos como less ou comandos como grep para encontrar informações neles.

Observação: se você planeja compartilhar o relatório com o Google, não modifique nenhum arquivo no relatório. Se você precisar modificar alguns arquivos, informe também o que foi modificado ao compartilhar o relatório.

Fazer o download do relatório

Para fazer o download do relatório para sua máquina local, use o comando gcloud compute scp:

gcloud compute scp $(whoami)@[INSTANCE_NAME]:[PATH/TO/FILE] [LOCAL/PATH/TO/DIRECTORY]