Dells automatiserade plattform: Så här hämtar du ett loggpaket för felsökning

Det här verktyget skapades för att samla in alla Kubernetes-loggar för Dell Automation Platform för lokala installationer. Den samlar också in interna Kubernetes-loggar och samlar in poddbeskrivning i deras aktuella tillstånd. Den samlar även in systemlogg och journalförd logg. Efter insamlingen skapas en tarboll som teknikteamet kan tillhandahålla. Den är inte utformad för att användas för Software as a Service (SAAS) Dell Automation Platform-installationer.

Det här verktyget går igenom Dell Automation Platform och Knative-poddar och listar behållarna inuti. Se exemplet nedan 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

Användaren får till exempel följande filstruktur i tarbollen:

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

Så dessa filer lagras i följande struktur:

namespace/pod-name/namespace-container.log

Användning:
Först måste användaren ansluta och logga in på den virtuella maskinen på Dell Automation Platform.

Sedan måste användaren aktivera root-privilegier (sudo -i eller su om det är aktiverat).

För att samla in alla relevanta loggar måste användaren ladda ner bilagan med namnet logs_pkb.zip från den här artikeln till den virtuella Dell Automation Platform-maskinen.

Extrahera innehållet i arkivet:

unzip logs_pkb.zip -d logs-tool

Gå till katalogen och kör skriptet:

./logs.sh

Efter körningen ser användaren ett informationsmeddelande om tillgängligt utrymme och en uppmaning att fortsätta (ange "y" för att fortsätta):

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.

Från och med version 1.0-rc identifierar logginsamlingsverktyget om NativeEdge eller Dell Automation Platform är installerat i ett namnutrymme som inte är standard. Om verktyget inte hittar något standardnamnområde uppmanas användaren att ange ett giltigt Orchestrator-namnområde. Se exempel nedan:

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:

Om det finns en standardinstallation av namnrymder visar verktyget vilka namnrymder som finns i listan för samling:

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

Händelser som samlar in:

Från och med version 0.9-beta av verktyget tillfrågas användaren om EdgeOrchestrator/Dell Automation Platform händelseregistrering:

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

Detta samlar in händelser från EdgeOrchestrator/Dell Automation Platform direkt till loggarnas tarboll och förbättrar felsökningen. Vi rekommenderar att du hämtar EdgeOrchestrator/Dell Automation Platform-händelser så att du har tillräckligt med utrymme på datorn.

Om användaren har ytterligare instruktioner kan användaren kontrollera tillgängliga alternativ för skriptet innan det körs:

./logs.sh -h

Användaren kan kontrollera aktuell version med:

logs.sh -v

Det här verktyget kan användas på ALLA lokala installationer av Dell Automation Platform i version 1.0 och senare.
Det här verktyget kan användas på ALLA NativeEdge Orchestrator-versioner, 2.0 och senare.