Automatisierte Dell Plattform: Abrufen eines Protokollpakets für das Troubleshooting

Dieses Tool wurde erstellt, um alle Dell Automation Platform Kubernetes-Protokolle für On-Premise-Installationen zu sammeln. 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. Es ist nicht für die Verwendung für Software as a Service (SAAS)-Installationen der Dell Automation Platform vorgesehen.

Dieses Tool durchläuft die 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 Ihrer virtuellen Maschine der Dell Automation Platform herstellen und sich bei ihr anmelden.

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

Um alle relevanten Protokolle zu erfassen, muss der Nutzer den Anhang logs_pkb.zip aus diesem Artikel auf die virtuelle Maschine der Dell Automation Platform 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

Dieses Tool kann auf ALLEN On-Premise-Installationen der Dell Automation Platform ab Version 1.0 verwendet werden.
Dieses Tool kann auf ALLEN NativeEdge Orchestrator-Versionen ab Version 2.0 verwendet werden.