Dell NativeEdge：如何擷取 NativeEdge Orchestrator 和 Dell 自動化平台記錄套裝以進行故障診斷

此工具旨在收集所有 NativeEdge Orchestrator 和 Dell Automation Platform Kubernetes 記錄。它也會收集原生 Kubernetes 記錄，並收集目前狀態的 Pod 說明。它還收集系統日誌和日誌日誌。收集後，它會創建一個壓縮包提供給工程團隊。

此工具會遍歷 NativeEdge 或 Dell 自動化平台和 Knative Pod，並列出其中的容器。請參閱以下 hzp-product-svc 的範例：

root@labmachine01:/nas/tools# kubectl get po -n hzp hzp-product-svc-00001-deployment-5695678c66-79zwm -o jsonpath="{.spec.containers[*].name}"
hzp-ese-svc hzp-product-svc queue-proxy hzp-iam-proxy

例如，使用者在壓縮包內獲得以下文件結構：

root@labmachine01:/nas/tools# tar -tf /tmp/native_edge_eo-logs_default_2023-08-30T07-13-39.750/native_edge_eo-logs_default_2023-08-30T07-13-39.750.tar.gz | grep product
./native_edge_eo-logs_default_2023-08-30T07-13-39.750/hzp/hzp-product-svc-00001-deployment-5695678c66-79zwm/
./native_edge_eo-logs_default_2023-08-30T07-13-39.750/hzp/hzp-product-svc-00001-deployment-5695678c66-79zwm/hzp-iam-proxy.current.log
./native_edge_eo-logs_default_2023-08-30T07-13-39.750/hzp/hzp-product-svc-00001-deployment-5695678c66-79zwm/hzp-product-svc.current.log
./native_edge_eo-logs_default_2023-08-30T07-13-39.750/hzp/hzp-product-svc-00001-deployment-5695678c66-79zwm/hzp-product-svc-00001-deployment-5695678c66-79zwm.hzp-iam-proxy-init.init.log
./native_edge_eo-logs_default_2023-08-30T07-13-39.750/hzp/hzp-product-svc-00001-deployment-5695678c66-79zwm/hzp-product-svc-00001-deployment-5695678c66-79zwm.describe
./native_edge_eo-logs_default_2023-08-30T07-13-39.750/hzp/hzp-product-svc-00001-deployment-5695678c66-79zwm/hzp-ese-svc.previous.log
./native_edge_eo-logs_default_2023-08-30T07-13-39.750/hzp/hzp-product-svc-00001-deployment-5695678c66-79zwm/queue-proxy.current.log
./native_edge_eo-logs_default_2023-08-30T07-13-39.750/hzp/hzp-product-svc-00001-deployment-5695678c66-79zwm/queue-proxy.previous.log
./native_edge_eo-logs_default_2023-08-30T07-13-39.750/hzp/hzp-product-svc-00001-deployment-5695678c66-79zwm/hzp-ese-svc.current.log
./native_edge_eo-logs_default_2023-08-30T07-13-39.750/hzp/hzp-product-svc-00001-deployment-5695678c66-79zwm/hzp-product-svc.previous.log
./native_edge_eo-logs_default_2023-08-30T07-13-39.750/hzp/hzp-product-svc-00001-deployment-5695678c66-79zwm/hzp-iam-proxy.previous.log

因此，這些檔案以以下結構儲存：

namespace/pod-name/namespace-container.log

用法：
首先，使用者必須連線並登入您的 NativeEdge Orchestrator （Dell 自動化平台） 機器。

然後，使用者必須啟用根權限 （如果已啟用，請使用 sudo -i 或 su）。

若要收集所有相關記錄，使用者必須將本文中名為 logs_pkb.zip 的附件下載至 NativeEdge Orchestrator 機器。

擷取存檔的內容：

unzip logs_pkb.zip -d logs-tool

移至該目錄並執行指令檔：

./logs.sh

執行後，使用者會看到有關可用空間的資訊訊息和繼續操作的提示 （輸入「y」以繼續）：

This script will access your local k3s secrets (secret values are not going to be printed).
This script will collect all logs from all pods in NativeEdge-controlled namespaces and archive it in tarball.
Please press "y" if you agree with this.
You have 69G available on your storage. Consider that logs may require to have more that 1Gb of free space.

從版本 1.0-rc 開始，記錄收集工具會偵測 NativeEdge 或 Dell 自動化平台是否安裝在非預設命名空間中。如果工具找不到標準命名空間，它會提示使用者輸入有效的業務流程協調程式命名空間。請參閱以下範例：

Available namespaces:
- default
- nativeedge
- kube-node-lease
- kube-public
- kube-system
- longhorn-system
- metallb-system
Warning: Namespace 'hzp' not found.
Please enter the namespace containing the 'nativeedge' containers:

如果有預設的命名空間安裝，該工具將顯示哪些命名空間在集合清單中：

Namespace 'hzp' found. Logs will be collected from following namespaces:
- hzp
- kube-system
- istio-system
- knative-eventing
- knative-serving
- longhorn-system

事件擷取：

從工具的 0.9 版開始，系統會提示使用者有關 EdgeOrchestrator/Dell 自動化平台事件擷取：

Do you want to collect the EO events (WARNING: this may require significant space on disk)?

此功能會將事件從 EdgeOrchestrator/Dell 自動化平台直接擷取至記錄壓縮包，並改善故障診斷。建議在您擁有足夠空間的機器中取得 EdgeOrchestrator/Dell 自動化平台事件。

如果使用者有其他說明，使用者可以在執行之前檢查指令檔的可用選項：

./logs.sh -h

使用者可以使用以下方式檢查目前版本：

logs.sh -v