Zautomatyzowana platforma Dell: Pobieranie pakietu dzienników w celu rozwiązywania problemów

Narzędzie to zostało utworzone w celu gromadzenia wszystkich dzienników platformy Kubernetes platformy Dell Automation Platform dla instalacji On Prem. 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. Nie jest on przeznaczony do instalacji oprogramowania jako usługi (SAAS) platformy Dell Automation Platform.

To narzędzie przeszukuje zasobniki platformy Dell Automation Platform i Knative oraz 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

Użycia:
Najpierw użytkownik musi połączyć się z maszyną wirtualną Dell Automation Platform i zalogować się do niej.

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 wirtualnej Dell Automation Platform.

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

To narzędzie jest dostępne w przypadku WSZYSTKICH instalacji lokalnych platformy Dell Automation Platform w wersji 1.0 lub nowszej.
To narzędzie jest dostępne we WSZYSTKICH wersjach programu NativeEdge Orchestrator w wersji 2.0 lub nowszej.