52 Coletando diagnósticos para o suporte #

Ao contatar o suporte da SUSE, é essencial passar todas as informações de diagnóstico.

Informações essenciais para coletar #

Descrição detalhada do problema: o que aconteceu, quando aconteceu, o que você estava fazendo, qual era o comportamento esperado e qual foi o comportamento real?
Etapas de reprodução: você pode reproduzir o problema de maneira confiável? Se puder, faça uma lista das etapas exatas.
Versões dos componentes: as versões do SUSE Edge e dos componentes (RKE2/K3, EIB, Metal³, Elemental etc.).
Registros relevantes:
- Saída do journalctl (filtrada por serviço, se possível, ou os registros completos de inicialização)
- Registros do pod Kubernetes (registros do kubectl)
- Registros do componente Metal³/Elemental
- Registros do build do EIB e outros registros
Informações do sistema:
- uname -a
- df -h
- ip a
- /etc/os-release
Arquivos de configuração: arquivos de configuração relevantes para Elemental, Metal³ e EIB, como valores de gráficos Helm, mapas de configuração etc.
Informações do Kubernetes: nós, serviços, implantações etc.
Objetos do Kubernetes afetados: BMH, MachineRegistration etc.

Como fazer a coleta #

Dos registros: redirecione a saída do comando para os arquivos (por exemplo, journalctl -u k3s > k3s_logs.txt).
Dos recursos do Kubernetes: use kubectl get <recurso> -o yaml > <nome_do_recurso>.yaml para obter as definições detalhadas do YAML.
Das informações do sistema: colete a saída dos comandos listados acima.
Do SL Micro: consulte a documentação do Guia de Solução de Problemas do SUSE Linux Micro sobre como reunir as informações do sistema para o suporte com supportconfig.
Do RKE2/Rancher: consulte o artigo The Rancher v2.x Linux log collector script para executar o script do coletor de registros do Linux para Rancher v2.x.
Para Edge (Nessie): o Nessie 1.0.0 é uma ferramenta de diagnóstico avançada desenvolvida para coletar registros e dados de configurações dos ambientes SUSE Edge. Ele reúne informações abrangentes do sistema host e dos clusters Kubernetes, o que o torna essencial para solução de problemas e suporte.
- O Nessie tem dois "modos"; um de kubernetes e outro de sistema.
  - Para coletar registros de um cluster SUSE Edge, execute (considerando que você tenha acesso ao arquivo kubeconfig localmente):
    podman run --rm --privileged \ -v /etc/rancher/k3s/k3s.yaml:/etc/rancher/k3s/k3s.yaml:ro \ -v /var/log/journal:/var/log/journal:ro \ -v /run/systemd:/run/systemd:ro \ -v /etc/machine-id:/etc/machine-id:ro \ -v /tmp:/tmp \ -e NESSIE_LOG_DIR="/tmp" \ -e NESSIE_ZIP_DIR="/tmp" \ registry.suse.com/edge/3.5/nessie:1.0.0
    Nota
    Ajuste os caminhos do arquivo k3s.yaml/rke2.yaml se necessário. Consulte Nessie para obter mais informações. Você poderá executar este contêiner em um modo sem privilégios se tiver as devidas permissões (em geral, os arquivos k3s.yaml/rke2-server.yaml são de propriedade do usuário root).
  - Para coletar os registros no modo de sistema usando o sistema operacional real, execute:
    podman run --rm --privileged \ -v /var/log/journal:/var/log/journal:ro \ -v /run/systemd:/run/systemd:ro \ -v /etc/machine-id:/etc/machine-id:ro \ -v /tmp:/tmp \ -e NESSIE_LOG_DIR="/tmp" \ -e NESSIE_ZIP_DIR="/tmp" \ -e NESSIE_VERBOSE="1" \ -e NESSIE_SKIP_POD_LOGS="true" \ -e NESSIE_SKIP_K8S_CONFIGS="true" \ -e NESSIE_SKIP_METRICS="true" \ registry.suse.com/edge/3.5/nessie:1.0.0
    Nota
    Consulte Nessie para obter mais detalhes e informações de como executar o Nessie em seu ambiente. Da mesma forma, você poderá executar este contêiner no modo sem privilégios se tiver as devidas permissões.

Contatar o suporte. Leia o artigo disponível em How-to effectively work with SUSE Technical Support (Como trabalhar de maneira eficiente com o suporte técnico da SUSE) e o manual de suporte localizado em SUSE Technical Support Handbook (Manual de Suporte Técnico da SUSE) para obter mais detalhes sobre como contatar o suporte da SUSE.