Dell NativeEdge: Извлечение пакета журналов NativeEdge Orchestrator и платформы автоматизации Dell для поиска и устранения неисправностей

Этот инструмент создан для сбора всех журналов Kubernetes NativeEdge Orchestrator и Dell Automation Platform. Он также собирает собственные журналы Kubernetes и описывает модули pod в их текущем состоянии. Кроме того, собираются системный журнал и журнальные журналы. После сбора данных создается tar-архив для предоставления команде инженеров.

Этот инструмент просматривает модули NativeEdge или Dell Automation Platform и Knative и выводит список контейнеров внутри них. См. пример ниже для 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

Например, пользователь получает следующую файловую структуру внутри tar-архива:

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

Употребление:
Сначала пользователь должен подключиться и войти в свой компьютер NativeEdge Orchestrator (Dell Automation Platform).

Затем пользователь должен включить привилегии root (sudo -i или su, если включено).

Чтобы собрать все соответствующие журналы, пользователь должен скачать вложение с именем logs_pkb.zip из этой статьи на компьютер NativeEdge Orchestrator.

Извлеките содержимое архива:

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-beta инструмента, пользователю предлагается перехватить события EdgeOrchestrator/Dell Automation Platform:

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

Это позволяет записывать события из EdgeOrchestrator/Dell Automation Platform непосредственно в архив журналов и облегчает поиск и устранение неисправностей. Рекомендуется получать события EdgeOrchestrator/Dell Automation Platform в, если на компьютере достаточно места.

В случае, если у пользователя есть дополнительные инструкции, он может проверить доступные опции скрипта перед запуском:

./logs.sh -h

Пользователь может проверить текущую версию с помощью следующей команды:

logs.sh -v