Автоматизированная платформа Dell: Как получить пакет журналов для поиска и устранения неисправностей

Этот инструмент создан для сбора всех журналов Kubernetes платформы автоматизации Dell Automation Platform для локальных установок. Он также собирает собственные журналы Kubernetes и описывает модули pod в их текущем состоянии. Кроме того, собираются системный журнал и журнальные журналы. После сбора данных создается tar-архив для предоставления команде инженеров. Он не предназначен для использования в системе «ПО как услуга» (Saas) на платформе автоматизации Dell.

Этот инструмент просматривает модули 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

Использования:
Сначала пользователь должен подключиться и войти в виртуальную машину платформы автоматизации Dell.

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

Чтобы собрать все необходимые журналы, пользователь должен загрузить вложение logs_pkb.zip из этой статьи на виртуальную машину платформы автоматизации Dell.

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

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

Этот инструмент можно использовать на ВСЕХ локальных установках платформы автоматизации Dell Automation Platform версии 1.0 и выше.
Этот инструмент можно использовать на ВСЕХ версиях NativeEdge Orchestrator 2.0 и выше.