Zautomatyzowana platforma firmy Dell: pobieranie pakietu dzienników na potrzeby 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 dziennik systemowy i journald dziennik również. 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.

Narzędzie obsługuje platformę automatyzacji firmy Dell Knative strąki i listy pojemników w środku. Patrz poniższy przykład w celu wyjaśnienia. 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 w 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

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

namespace/pod-name/namespace-container.log

Stosowanie:
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 włączono).

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ść pliku .zip.

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

Spowoduje to przechwytywanie zdarzeń z platformy EdgeOrchestrator/Dell Automation Platform bezpośrednio do dzienników tarball 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

Pomijanie zbierania bazy danych

./logs.sh --skip-database

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

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.