Dell NativeEdge: Come recuperare il bundle dei registri di NativeEdge Orchestrator e Dell Automation Platform per la risoluzione dei problemi

Questo strumento è stato creato per raccogliere tutti i registri Kubernetes di NativeEdge Orchestrator e Dell Automation Platform. Raccoglie inoltre i registri Kubernetes nativi e la descrizione dei pod nei relativi stati correnti. Raccoglie anche il registro di sistema e il registro journald. Dopo la raccolta, crea un tarball da fornire al team di progettazione.

Questo strumento attraversa i pod NativeEdge o Dell Automation Platform e Knative ed elenca i container al suo interno. Vedere l'esempio seguente per 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

Uso:
Innanzitutto, l'utente deve connettersi e accedere al computer NativeEdge Orchestrator (Dell Automation Platform).

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 di questo articolo nel computer NativeEdge Orchestrator.

Estrarre il contenuto dell'archivio:

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 l'esempio riportato 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 nel tarball dei registri e viene migliorata 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