Documentación de SUSE Edge|Solución de errores|Recopilación de diagnóstico para la asistencia

52 Recopilación de diagnóstico para la asistencia

 

Al ponerse en contacto con el servicio de asistencia técnica de SUSE, es fundamental proporcionar información de diagnóstico completa.

Información esencial que se debe recopilar
 

  • Descripción detallada del problema: ¿Qué ha ocurrido?, ¿cuándo?, ¿qué estaba haciendo?, ¿cuál es el comportamiento esperado?, y ¿cuál es el comportamiento real?

  • Pasos para reproducir el problema: ¿Puede reproducir el problema de forma fiable? Si es así, indique los pasos exactos.

  • Versiones de los componentes: Versión de SUSE Edge, versiones de los componentes (RKE2/K3, EIB, Metal3, Elemental, etc.).

  • Registros relevantes:

    • Resultado de journalctl (filtrado por servicio, si es posible, o registros de arranque completos).

    • Registros de pod de Kubernetes (registros kubectl).

    • Registros de componente de Metal³/Elemental.

    • Registros de creación de EIB y otros registros

  • Información del sistema:

    • uname -a

    • df -h

    • ip a

    • /etc/os-release

  • Archivos de configuración: archivos de configuración relevantes para Elemental, Metal3, EIB, tales como valores de charts de helm, mapas de configuración, etc.

  • Información de Kubernetes: nodos, servicios, despliegues, etc.

  • Objetos de Kubernetes afectados: BMH, MachineRegistration, etc.

Cómo recopilar la información
 

  • Registros: redirija la salida del comando a archivos (por ejemplo, journalctl -u k3s > k3s_logs.txt).

  • Recursos de Kubernetes: use kubectl get <recurso> -o yaml > <nombre_de_recurso>.yaml para obtener definiciones YAML detalladas.

  • Información del sistema: recopile los resultados de los comandos indicados anteriormente.

  • SL Micro: consulte en la guía de resolución de problemas de SUSE Linux Micro cómo recopilar información del sistema para obtener asistencia con supportconfig.

  • RKE2/Rancher: consulte el artículo The Rancher v2.x Linux log collector script (Guion de recopilación de registros de Linux de Rancher v2.x) para ejecutar dicho guion.

  • Edge (Nessie): Nessie 1.0.0 es una potente herramienta de diagnóstico diseñada para recopilar registros y datos de configuración de entornos SUSE Edge. Recopila información completa tanto del sistema host como de los clústeres de Kubernetes, lo que la convierte en una herramienta muy valiosa para la resolución de problemas y la asistencia técnica.

    • Nessie cuenta con dos "modos": uno de kubernetes y otro de sistema.

      • Para recopilar registros de un clúster de SUSE Edge, ejecute (siempre que tenga acceso local al archivo kubeconfig):

        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
        Nota

        Ajuste las vías del archivo k3s.yaml/rke2.yaml si fuera necesario. Consulte el archivo Nessie para obtener más información. Debería poder ejecutar este contenedor en modo sin privilegios si dispone de los permisos adecuados (normalmente, los archivos k3s.yaml / rke2-server.yaml son propiedad del usuario root).

      • Para recopilar registros en el modo de sistema del sistema operativo actual, ejecute:

        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
        Nota

        Consulte el archivo Nessie para obtener más información sobre cómo ejecutar Nessie en su entorno. Del mismo modo, debería poder ejecutar este contenedor en modo sin privilegios siempre que tenga los permisos adecuados.

Póngase en contacto con el servicio de asistencia. Consulte el artículo How-to effectively work with SUSE Technical Support (Cómo trabajar eficazmente con el servicio de asistencia técnica de SUSE) y el manual de asistencia técnica disponible en SUSE Technical Support Handbook para obtener más detalles sobre cómo ponerse en contacto con el servicio de asistencia técnica de SUSE.