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 systémový protokol a journald Přihlásit se také. 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í automatizační platformou Dell a Knative lusky a seznamy nádob uvnitř. Vysvětlení viz příklad níže. 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ř 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

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í root (sudo -i nebo su pokud je povoleno).

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 souboru .zip.

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)?

Tím se události z nástroje EdgeOrchestrator / Dell Automation Platform zaznamenávají přímo do protokolů tarball a zlepšuje řešení 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

Přeskočení sběru databáze

./logs.sh --skip-database

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

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.