Automatizovaná platforma Dell: Jak načíst balíček protokolů pro odstraňování problémů

Tento nástroj je vytvořen za účelem shromažďování všech protokolů Kubernetes platformy Dell Automation Platform pro místní instalace. 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. Není určen k použití pro instalace softwaru jako služby (SAAS) Dell Automation Platform.

Tento nástroj prochází pody Dell Automation Platform a Knative a uvádí seznam kontejnerů, které se v nich nacházejí. 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

Použití:
Uživatel se nejprve musí připojit a přihlásit k virtuálnímu počítači Dell Automation Platform.

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

Pokud chce uživatel shromáždit všechny relevantní protokoly, musí si stáhnout přílohu s názvem logs_pkb.zip z tohoto článku do virtuálního počítače platformy Dell Automation Platform.

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

Tento nástroj lze použít u VŠECH lokálních instalací automatizační platformy Dell verze 1.0 a vyšší.
Tento nástroj lze použít ve VŠECH verzích nástroje NativeEdge Orchestrator 2.0 a vyšších.