SUSE Edge 文档|查错|收集支持团队所需的诊断信息

52 收集支持团队所需的诊断信息

 

联系 SUSE 支持团队时，提供全面的诊断信息至关重要。

需收集的基本信息
 

  • 详细问题描述：发生了什么、何时发生、操作过程、预期行为及实际行为。

  • 重现步骤：能否稳定重现问题？如果可以，请列出确切步骤。

  • 组件版本：SUSE Edge 版本、各组件版本（RKE2/K3、EIB、Metal3、Elemental 等）。

  • 相关日志：

    • journalctl 输出（尽可能按服务过滤，或提供完整的引导日志）。

    • Kubernetes Pod 日志 (kubectl logs)。

    • Metal³/Elemental 组件日志。

    • EIB 构建日志及其他日志。

  • 系统信息：

    • uname -a

    • df -h

    • ip a

    • /etc/os-release

  • 配置文件：Elemental、Metal3、EIB 的相关配置文件，例如 Helm chart 值文件、configmap 等。

  • Kubernetes 信息：节点、服务、部署等。

  • 受影响的 Kubernetes 对象：BMH、MachineRegistration 等。

收集方式
 

  • 对于日志：将命令输出重定向到文件（例如，使用 journalctl -u k3s > k3s_logs.txt）。

  • 对于 Kubernetes 资源：使用 kubectl get <resource> -o yaml > <resource_name>.yaml 获取详细的 YAML 定义。

  • 对于系统信息：收集上述命令的输出。

  • 对于 SL Micro：参考 SUSE Linux Micro 查错指南文档，了解如何使用 supportconfig 收集支持团队所需的系统信息。

  • 对于 RKE2/Rancher：参考《The Rancher v2.x Linux log collector script》一文，运行 Rancher v2.x Linux 日志收集器脚本。

  • 对于 Edge (Nessie)：Nessie 1.0.0 是一款功能强大的诊断工具，专用于收集 SUSE Edge 环境中的日志和配置数据，可从主机系统和 Kubernetes 群集中采集全面的信息，是查错和技术支持的重要工具。

    • Nessie 支持两种模式：Kubernetes 模式和系统模式。

      • 要从 SUSE Edge 群集收集日志，请运行以下命令（前提是您可在本地访问 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
        注意
        注意

        您可以根据需要调整 k3s.yaml/rke2.yaml 文件的路径。有关详细信息，请参见 Nessie 文档。如果您拥有适当的权限，可在非特权模式下运行该容器（k3s.yaml / rke2-server.yaml 文件通常归 root 用户所有）。

      • 要在系统模式下从操作系统本身收集日志，请运行以下命令：

        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
        注意
        注意

        请务必查看 Nessie 文档，了解更多详细信息以及如何在您的环境中运行 Nessie。同理，如果拥有适当的权限，可在非特权模式下运行该容器。

联系支持团队：有关如何联系 SUSE 支持团队的详细信息，请参见《How-to effectively work with SUSE Technical Support》一文，以及 SUSE Technical Support Handbook 页面中提供的支持手册。