Automatisert Dell-plattform: Slik henter du en loggbunt for feilsøking

Dette verktøyet opprettes for å samle inn alle Dell Automation Platform Kubernetes-logger for On Prem-installasjoner. Den samler også inn innebygde Kubernetes-logger og samler podbeskrivelse i deres nåværende tilstander. Den samler også systemlogg og journallogg. Etter innsamling skaper den en tarball for å gi til ingeniørteamet. Den er ikke utformet for å brukes til installasjon av Software as a Service (SAAS) Dell Automation Platform.

Dette verktøyet går gjennom Dell Automation Platform og Knative pods og viser beholderne inni. Se eksempel nedenfor for 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

For eksempel får brukeren følgende filstruktur inne i 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

Så disse filene lagres i følgende struktur:

namespace/pod-name/namespace-container.log

Bruk:
Først må brukeren koble til og logge på den virtuelle Dell Automation Platform-maskinen.

Deretter må brukeren aktivere root-privilegier (sudo -i eller su hvis aktivert).

Brukeren må laste ned vedlegget som heter logs_pkb.zip fra denne artikkelen, til den virtuelle Dell Automation Platform-maskinen for å innhente alle relevante logger.

Pakk ut innholdet i arkivet:

unzip logs_pkb.zip -d logs-tool

Gå til den katalogen og kjør skriptet:

./logs.sh

Etter utførelse ser brukeren en informasjonsmelding om ledig plass og en melding om å fortsette (skriv inn 'y' for å fortsette):

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.

Fra og med versjon 1.0-rc oppdager logginnsamlingsverktøyet om NativeEdge eller Dell Automation Platform er installert i et ikke-standard navneområde. Hvis verktøyet ikke finner et standard navneområde, blir brukeren bedt om å angi et gyldig Orchestrator-navneområde. Se eksempel nedenfor:

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:

Hvis det er standard navnerom installasjon, verktøyet kommer til å vise hvilke navneområder er i listen for samling:

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

Hendelser som fanger:

Fra og med versjon 0.9-beta av verktøyet blir brukeren spurt om hendelsesregistrering for EdgeOrchestrator/Dell Automation Platform:

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

Dette fanger opp hendelser fra EdgeOrchestrator/Dells automatiseringsplattform direkte til loggtarballen og forbedrer feilsøkingen. Det anbefales å få EdgeOrchestrator-/Dell Automation Platform-hendelser hvis du har nok plass på maskinen.

Hvis brukeren har flere instruksjoner, kan brukeren sjekke tilgjengelige alternativer for skriptet før du kjører:

./logs.sh -h

Brukeren kan sjekke gjeldende versjon med:

logs.sh -v

Dette verktøyet kan brukes på ALLE On Prem Dell Automation Platform-installasjoner versjon 1.0 og nyere.
Dette verktøyet kan brukes på ALLE NativeEdge Orchestrator-versjoner, 2.0 og nyere.