Dell NativeEdge: Jak načíst balíček protokolů nástroje NativeEdge Orchestrator a Dell Automation Platform pro odstraňování problémů

Tento nástroj je vytvořen ke shromažďování všech protokolů Kubernetes nástroje NativeEdge Orchestrator a Dell Automation Platform. Shromažďuje také nativní protokoly Kubernetes a shromažďuje popis podů v jejich aktuálním stavu. Shromažďuje také systémové protokoly a žurnálované protokoly. Po sběru vytvoří tarball, který poskytne technickému týmu.

Tento nástroj prochází pody NativeEdge nebo Dell Automation Platform a Knative a vypíše kontejnery uvnitř. Viz níže uvedený příklad pro 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

Uživatel například získá následující strukturu souborů uvnitř tarballu:

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

Tyto soubory jsou tedy uloženy v následující struktuře:

namespace/pod-name/namespace-container.log

Zvyk:
Nejprve se uživatel musí připojit a přihlásit k počítači NativeEdge Orchestrator (Dell Automation Platform).

Poté musí uživatel povolit oprávnění uživatele root (sudo -i nebo su, pokud jsou povolena).

Aby bylo možné shromáždit všechny relevantní protokoly, musí uživatel stáhnout přílohu s názvem logs_pkb.zip z tohoto článku do počítače NativeEdge Orchestrator.

Rozbalte obsah archivu:

unzip logs_pkb.zip -d logs-tool

Přejděte do tohoto adresáře a spusťte skript:

./logs.sh

Po spuštění se uživateli zobrazí informační zpráva o dostupném místě a výzva k pokračování (pokračujte zadáním "y"):

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.

Od verze 1.0-rc nástroj pro shromažďování protokolů zjišťuje, zda je systém NativeEdge nebo Dell Automation Platform nainstalován v jiném než výchozím oboru názvů. Pokud nástroj nenajde standardní jmenný prostor, vyzve uživatele k zadání platného jmenného prostoru nástroje Orchestrator. Viz příklad níže:

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:

Pokud je k dispozici výchozí instalace oboru názvů, nástroj zobrazí, které obory názvů jsou v seznamu pro kolekci:

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

Zachycení událostí:

Od verze 0.9-beta nástroje se uživateli zobrazí výzva ohledně zachycení událostí EdgeOrchestrtor/Dell Automation Platform:

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

To zaznamenává události z nástroje EdgeOrchestrtor/Dell Automation Platform přímo do tarballu protokolů a zlepšuje odstraňování problémů. Doporučuje se získat události EdgeOrchestrator/Dell Automation Platform, pokud máte na počítači dostatek místa.

V případě, že má uživatel další instrukce, může před spuštěním zkontrolovat dostupné možnosti skriptu:

./logs.sh -h

Uživatel může zkontrolovat aktuální verzi pomocí:

logs.sh -v