Automatisert Dell-plattform: Slik henter du en loggpakke 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 systemlogg og journald logg også. 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 lister beholderne inni. Se eksemplet nedenfor for avklaring. 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

Brukeren får for eksempel 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 rotrettigheter (sudo -i eller su hvis den er aktivert).

For å samle inn alle relevante logger må brukeren laste ned vedlegget som heter logs_pkb.zip fra denne artikkelen til den virtuelle Dell Automation Platform-maskinen.

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 eksemplene 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/Dell Automation Platform direkte til loggene tarball 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

Hoppe over databasesamling

./logs.sh --skip-database

Skipping PostgreSQL database dump (--skip-database flag set)

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.