Dell NativeEdge: Як отримати пакет журналів NativeEdge Orchestrator і Dell Automation Platform для усунення несправностей
Summary: У цій статті пояснюється, як отримати пакет журналів для усунення проблем із NativeEdge Orchestrator і Dell Automation Platform.
Instructions
Цей інструмент створений для збору всіх журналів Kubernetes NativeEdge Orchestrator і Dell Automation Platform. Він також збирає рідні логи Kubernetes і збирає опис подів у їхньому поточному стані. Він також збирає системний журнал і журнальований журнал. Після збору він створює архів для надсилання команді інженерів.
Цей інструмент обходить поди 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
Наприклад, користувач отримує наступну файлову структуру всередині архіву:
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-бета інструменту, користувачеві пропонується про фіксацію подій 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