Piattaforma automatizzata Dell: come recuperare un pacchetto di log per la risoluzione dei problemi

Questo strumento è stato creato per raccogliere tutti i registri Kubernetes della piattaforma di automazione Dell per le installazioni on-premise. Raccoglie inoltre i registri Kubernetes nativi e la descrizione dei pod nei relativi stati correnti. Raccoglie i registri di sistema e journald registro. Dopo la raccolta, crea un tarball da fornire al team di progettazione. Non è progettato per essere utilizzato per le installazioni Software as a Service (SAAS) della Dell Automation Platform.

Questo strumento attraversa la piattaforma di automazione Dell e Knative pod ed elenca i contenitori all'interno. Vedere l'esempio riportato di seguito per chiarimento. 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

Ad esempio, l'utente ottiene la seguente struttura di file all'interno del 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

Quindi questi file sono memorizzati nella seguente struttura:

namespace/pod-name/namespace-container.log

Utilizzo:
Innanzitutto, l'utente deve connettersi e accedere alla macchina virtuale della piattaforma di automazione Dell.

Quindi l'utente deve abilitare i privilegi root (sudo -i o su se abilitato).

Per raccogliere tutti i registri pertinenti, l'utente deve scaricare l'allegato denominato logs_pkb.zip da questo articolo alla macchina virtuale della piattaforma di automazione Dell.

Estrarre il contenuto del programma di installazione.

unzip logs_pkb.zip -d logs-tool

Passare a tale directory ed eseguire lo script:

./logs.sh

Dopo l'esecuzione, l'utente visualizza un messaggio informativo sullo spazio disponibile e un prompt per procedere (immettere "y" per continuare):

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.

A partire dalla versione 1.0-rc, lo strumento di raccolta dei log rileva se NativeEdge o Dell Automation Platform è installato in un namespace non predefinito. Se lo strumento non trova un namespace standard, richiede all'utente di immettere un namespace Orchestrator valido. Vedere gli esempi riportati di seguito

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:

Se è presente un'installazione del namespace predefinito, lo strumento mostrerà quali namespace sono presenti nell'elenco per la raccolta:

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

Eventi di acquisizione:

A partire dalla versione 0.9-beta dello strumento, all'utente vengono richieste informazioni sull'acquisizione degli eventi di EdgeOrchestrator/Dell Automation Platform:

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

In questo modo gli eventi vengono acquisiti da EdgeOrchestrator/Dell Automation Platform direttamente nei log tarball e migliora la risoluzione dei problemi. Si consiglia di ottenere gli eventi di EdgeOrchestrator/Dell Automation Platform se si dispone di spazio sufficiente sul computer.

Nel caso in cui l'utente disponga di istruzioni aggiuntive, può controllare le opzioni disponibili dello script prima di eseguire:

./logs.sh -h

L'utente può controllare la versione corrente con:

logs.sh -v

Ignorare la raccolta del database

./logs.sh --skip-database

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

Questo strumento è utilizzabile su TUTTE le installazioni on-premise della piattaforma di automazione Dell versione 1.0 e successive.
Questo strumento è utilizzabile su TUTTE le versioni 2.0 e successive di NativeEdge Orchestrator.