Автоматизована платформа Dell: Як отримати Log Bundle для усунення несправностей

Цей інструмент створений для збору всіх логів Kubernetes Dell Automation Platform для локальних інсталяцій. Він також збирає рідні журнали Kubernetes і опис капсул у їхньому поточному стані. Він також збирає системний і журналований журнал. Після збору він створює тарбол для передачі інженерній команді. Він не призначений для встановлення платформи Dell Automation Platform за програмним забезпеченням як послугою (SAAS).

Цей інструмент проходить через платформу Dell Automation Platform і Knative pods, а також містить контейнери всередині. Дивіться приклад нижче для 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

Наприклад, користувач отримує таку структуру файлу всередині тарболу:

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

Отже, ці файли зберігаються у такій структурі:

namespace/pod-name/namespace-container.log

Використання:
Спочатку користувач повинен підключитися та увійти у віртуальну машину Dell Automation Platform.

Тоді користувач повинен увімкнути root rights (sudo -i або su, якщо увімкнено).

Щоб зібрати всі відповідні журнали, користувач повинен завантажити вкладення під назвою logs_pkb.zip з цієї статті на віртуальну машину Dell Automation Platform.

Витягніть вміст архіву:

unzip logs_pkb.zip -d logs-tool

Перейдіть у цю директорію і запустіть скрипт:

./logs.sh

Після виконання користувач бачить інформаційне повідомлення про вільний простір і пропозицію продовжити (введіть '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.

Починаючи з версії 1.0, інструмент збору журналів rc виявляє, чи встановлені NativeEdge або Dell Automation Platform у нестандартному просторі назв. Якщо інструмент не знаходить стандартний простір назв, він просить користувача ввести дійсний простір імен Orchestrator. Дивіться приклад нижче:

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:

Якщо встановлено простір імен за замовчуванням, інструмент покаже, які простори імен є у списку для колекції:

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

Події, що охоплюють:

Починаючи з версії 0.9 бета-версії інструменту, користувач отримує запити про захоплення подій EdgeOrchestrator/Dell Automation Platform:

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

Це фіксує події з платформи EdgeOrchestrator/Dell Automation безпосередньо до тарболу логів і покращує процес усунення несправностей. Рекомендується запускати події EdgeOrchestrator/Dell Automation Platform, якщо у вас достатньо місця на комп'ютері.

Якщо користувач має додаткові інструкції, він може перевірити доступні опції скрипту перед запуском:

./logs.sh -h

Користувач може перевірити поточну версію за з:

logs.sh -v

Цей інструмент доступний у ВСІХ версіях інсталяцій Dell Automation Platform On Prem — 1.0 і вище.
Цей інструмент доступний у ВСІХ версіях NativeEdge Orchestrator, 2.0 і вище.