Dell Automated Platform: So rufen Sie ein Protokoll-Bundle für das Troubleshooting ab
Summary: In diesem Artikel wird erläutert, wie Sie ein Protokoll-Bundle abrufen, um Probleme zu beheben. Dell Automatisierungsplattform (On-Prem)
Instructions
Dieses Tool wurde erstellt, um alle Kubernetes-Protokolle der Dell Automation Platform für On-Premise-Installationen zu erfassen. Außerdem werden native Kubernetes-Protokolle und Pod-Beschreibungen im aktuellen Status erfasst. Er erfasst Systemprotokolle und journald Protokoll. 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 SAAS (Software as a Service) Dell Automation Platform-Installationen konzipiert.
Dieses Tool durchläuft die Dell Automation Platform und Knative Pods und listet die darin enthaltenen Container auf. Eine Erläuterung finden Sie im nachfolgenden Beispiel. 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
Der Nutzer erhält beispielsweise die folgende Dateistruktur im tarball:
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:
Zunächst muss der Nutzer eine Verbindung herstellen und sich bei Ihrer virtuellen Maschine der Dell Automation Platform anmelden.
Anschließend muss der Nutzer Root-Berechtigungen aktivieren (sudo -i oder su falls aktiviert).
Um alle relevanten Protokolle zu erfassen, muss der Nutzer den Anhang mit dem Namen logs_pkb.zip von diesem Artikel zur virtuellen Maschine der Dell Automation Platform.
Extrahieren Sie den Inhalt des Installationsprogramms.
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 "y" ein, um fortzufahren):
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 Standard-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-systemAufzeichnung der folgenden Ereignisse:
Ab Version 0.9-Beta des Tools werden NutzerInnen zur Erfassung von EdgeOrchestrator/Dell Automation Platform-Ereignissen aufgefordert:
Do you want to collect the EO events (WARNING: this may require significant space on disk)?
Dadurch werden Ereignisse aus dem EdgeOrchestrator/der Dell Automation Platform direkt in den Protokollen erfasst tarball und verbessert das Troubleshooting. Es wird empfohlen, EdgeOrchestrator/Dell Automation Platform-Ereignisse abzurufen, wenn genügend Speicherplatz auf dem Rechner vorhanden ist.
Falls der Nutzer zusätzliche Anweisungen hat, kann er die verfügbaren Optionen des Skripts überprüfen, bevor er Folgendes ausführt:
./logs.sh -h
NutzerInnen können die aktuelle Version mit folgenden Voraussetzungen überprüfen:
logs.sh -v
Überspringen der Datenbankerfassung
--skip-database Kennzeichen
./logs.sh --skip-database
Skipping PostgreSQL database dump (--skip-database flag set)
Additional Information
Dieses Tool kann auf ALLEN On-Premise-Installationen der Dell Automation Platform Version 1.0 und höher verwendet werden.
Dieses Tool kann auf ALLEN NativeEdge Orchestrator-Versionen ab Version 2.0 verwendet werden.