Dell NativeEdge: Abrufen des Protokollpakets für NativeEdge Orchestrator und Dell Automation Platform für das Troubleshooting

Dieses Tool wurde erstellt, um alle Kubernetes-Protokolle von NativeEdge Orchestrator und Dell Automation Platform zu erfassen. Außerdem werden native Kubernetes-Protokolle und Pod-Beschreibungen in ihrem aktuellen Status erfasst. Außerdem werden Systemprotokolle und Journalprotokolle erfasst. Nach der Erfassung wird ein Tarball erstellt, der dem Engineering-Team zur Verfügung gestellt wird.

Dieses Tool durchläuft NativeEdge- oder Dell Automation Platform- und Knative-Pods und listet die darin enthaltenen Container auf. Siehe Beispiel unten für 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

Zum Beispiel erhält der Benutzer die folgende Dateistruktur innerhalb des Tarballs:

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

Diese Dateien werden also in der folgenden Struktur gespeichert:

namespace/pod-name/namespace-container.log

Verwendung:
Zuerst muss der Nutzer eine Verbindung zu Ihrem NativeEdge Orchestrator (Dell Automation Platform)-Computer herstellen und sich dort anmelden.

Dann muss der Nutzer Root-Berechtigungen aktivieren (sudo -i oder su, falls aktiviert).

Um alle relevanten Protokolle zu erfassen, müssen NutzerInnen den Anhang logs_pkb.zip aus diesem Artikel auf den NativeEdge Orchestrator herunterladen.

Extrahieren Sie den Inhalt des Archivs:

unzip logs_pkb.zip -d logs-tool

Navigieren Sie zu diesem Verzeichnis und führen Sie das Skript aus:

./logs.sh

Nach der Ausführung wird dem Nutzer eine Informationsmeldung über den verfügbaren Speicherplatz und eine Aufforderung zum Fortfahren angezeigt (geben Sie zum Fortfahren "y" ein):

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.

Ab Version 1.0-rc erkennt das Protokollerfassungstool, ob NativeEdge oder Dell Automation Platform in einem nicht standardmäßigen Namespace installiert ist. Wenn das Tool keinen Standard-Namespace findet, wird der Nutzer aufgefordert, einen gültigen Orchestrator-Namespace einzugeben. Siehe Beispiel unten:

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:

Wenn eine standardmäßige Namespace-Installation vorhanden ist, zeigt das Tool an, welche Namespaces in der Liste für die Erfassung enthalten sind:

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

Erfassung von Veranstaltungen:

Ab Version 0.9-Beta des Tools werden NutzerInnen zur Erfassung von Ereignissen durch EdgeOrchestrator/Dell Automation Platform aufgefordert:

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

Dadurch werden Ereignisse vom EdgeOrchestrator/Dell Automation Platform direkt im Protokoll-Tarball erfasst und das Troubleshooting verbessert. Es wird empfohlen, EdgeOrchestrator/Dell Automation Platform-Ereignisse in Sie einzubinden, wenn genügend Speicherplatz auf dem Computer vorhanden ist.

Falls der Benutzer zusätzliche Anweisungen hat, kann er die verfügbaren Optionen des Skripts überprüfen, bevor er Folgendes ausführt:

./logs.sh -h

Der Benutzer kann die aktuelle Version mit folgendem Befehl überprüfen:

logs.sh -v