Dell NativeEdge: Sådan henter du NativeEdge Orchestrator- og Dell Automation Platform Logs-pakken til fejlfinding

Dette værktøj er udviklet til at indsamle alle NativeEdge Orchestrator- og Dell Automation Platform Kubernetes-logfiler. Den indsamler også oprindelige Kubernetes-logge og pod-beskrivelser i deres aktuelle tilstand. Det indsamler system log og journaled log samt. Efter indsamling opretter den en tarball, der skal leveres til ingeniørteamet.

Dette værktøj gennemsøger NativeEdge eller Dell Automation Platform og Knative-pods og viser beholderne indeni. Se eksemplet 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 brugeren følgende filstruktur inde 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 filer gemmes i følgende struktur:

namespace/pod-name/namespace-container.log

Brug:
Først skal brugeren oprette forbindelse og logge på din NativeEdge Orchestrator-maskine (Dell Automation Platform).

Derefter skal brugeren aktivere root-privilegier (sudo -i eller su, hvis aktiveret).

For at indsamle alle relevante logfiler skal brugeren downloade den vedhæftede fil kaldet logs_pkb.zip fra denne artikel til NativeEdge Orchestrator-maskinen.

Uddrag indholdet af arkivet:

unzip logs_pkb.zip -d logs-tool

Gå til den mappe, og kør scriptet:

./logs.sh

Efter udførelse ser brugeren en informativ meddelelse om ledig plads og en prompt om at fortsætte (indtast 'y' for at fortsætte):

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 version 1.0 registrerer værktøjet til indsamling af logfiler, om NativeEdge eller Dell Automation Platform er installeret i et navneområde, der ikke er standard. Hvis værktøjet ikke finder et standardnavneområde, bliver brugeren bedt om at angive et gyldigt 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 der er standardinstallation af navneområde, viser værktøjet, hvilke navneområder der er på listen til indsamling:

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

Begivenheder fanger:

Fra og med version 0.9-beta af værktøjet bliver brugeren spurgt om registrering af hændelser i EdgeOrchestrator/Dell Automation Platform:

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

Den registrerer hændelser fra EdgeOrchestrator/Dell Automation-platformen direkte til træstammernes tarball og forbedrer fejlfindingen. Det anbefales at hente EdgeOrchestrator/Dell Automation Platform-hændelser, hvis du har plads nok på maskinen.

Hvis brugeren har yderligere instruktioner, kan brugeren kontrollere tilgængelige indstillinger i scriptet, før han kører:

./logs.sh -h

Brugeren kan kontrollere den aktuelle version med:

logs.sh -v