Dell NativeEdge: Pobieranie zestawu dzienników oprogramowania NativeEdge Orchestrator i Dell Automation Platform na potrzeby rozwiązywania problemów

Narzędzie to służy do gromadzenia wszystkich dzienników Kubernetes oprogramowania NativeEdge Orchestrator i Dell Automation Platform. Zbiera również natywne dzienniki Kubernetes i zbiera opis zasobników w ich bieżących stanach. Zbiera również dziennik systemowy i dziennik. Po zebraniu tworzy archiwum tar, które ma zostać udostępnione zespołowi inżynierów.

To narzędzie przeszukuje zasobniki NativeEdge lub Dell Automation Platform oraz Knative i wyświetla listę znajdujących się w nich kontenerów. Zobacz przykład poniżej dla 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

Na przykład, użytkownik otrzymuje następującą strukturę plików wewnątrz archiwum:

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

Pliki te są więc przechowywane w następującej strukturze:

namespace/pod-name/namespace-container.log

Zwyczaj:
Najpierw użytkownik musi nawiązać połączenie i zalogować się do komputera z oprogramowaniem NativeEdge Orchestrator (Dell Automation Platform).

Następnie użytkownik musi włączyć uprawnienia użytkownika root (sudo -i lub su, jeśli są włączone).

Aby zebrać wszystkie odpowiednie dzienniki, użytkownik musi pobrać załącznik o nazwie logs_pkb.zip z tego artykułu do maszyny NativeEdge Orchestrator.

Wyodrębnij zawartość archiwum:

unzip logs_pkb.zip -d logs-tool

Przejdź do tego katalogu i uruchom skrypt:

./logs.sh

Po wykonaniu tej czynności użytkownik widzi komunikat informacyjny o dostępnym miejscu oraz monit o kontynuowanie (wpisz "y", aby kontynuować):

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.

Począwszy od wersji 1.0-rc, narzędzie do zbierania dzienników wykrywa, czy platforma NativeEdge lub Dell Automation Platform jest zainstalowana w niedomyślnej przestrzeni nazw. Jeśli narzędzie nie znajdzie standardowej przestrzeni nazw, monituje użytkownika o wprowadzenie prawidłowej przestrzeni nazw programu Orchestrator. Zobacz przykład poniżej:

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:

Jeśli istnieje domyślna instalacja przestrzeni nazw, narzędzie pokaże, które przestrzenie nazw znajdują się na liście do kolekcji:

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

Rejestrowanie zdarzeń:

Począwszy od wersji 0.9-beta narzędzia, użytkownik jest pytany o przechwytywanie zdarzeń EdgeOrchestrator/Dell Automation Platform:

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

Powoduje to przechwytywanie zdarzeń z platformy automatyzacji EdgeOrchestrator/Dell bezpośrednio do archiwum dzienników i usprawnia rozwiązywanie problemów. Zaleca się, aby zdarzenia EdgeOrchestrator/Dell Automation Platform były pobierane, jeśli na komputerze jest wystarczająca ilość miejsca.

W przypadku, gdy użytkownik posiada dodatkowe instrukcje, może sprawdzić dostępne opcje skryptu przed uruchomieniem:

./logs.sh -h

Użytkownik może sprawdzić aktualną wersję za pomocą:

logs.sh -v