Plate-forme automatisée Dell : Récupération d’un bundle de logs à des fins de dépannage

Cet outil est créé pour collecter tous les journaux Kubernetes de la plate-forme d’automatisation Dell pour les installations sur site. Il collecte également les logs Kubernetes natifs et recueille la description des pods dans leur état actuel. Il collecte également les journaux système et journaux. Après la collecte, il crée un fichier Tarball à fournir à l’équipe d’ingénierie. Il n’est pas conçu pour être utilisé pour les installations de la plate-forme d’automatisation Dell Software as a Service (SAAS).

Cet outil parcourt Dell Automation Platform et les pods Knative et répertorie les conteneurs qu’ils contiennent. Voir l’exemple ci-dessous pour 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

Par exemple, l’utilisateur obtient la structure de fichiers suivante dans l’archive 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

Ces fichiers sont donc stockés dans la structure suivante :

namespace/pod-name/namespace-container.log

Utilisation:
Tout d’abord, l’utilisateur doit se connecter à votre machine virtuelle de plate-forme d’automatisation Dell.

Ensuite, l’utilisateur doit activer les privilèges root (sudo -i ou su si activé).

Pour collecter tous les journaux pertinents, l’utilisateur doit télécharger la pièce jointe appelée logs_pkb.zip de cet article sur la machine virtuelle de la plate-forme d’automatisation Dell.

Extrayez le contenu de l’archive :

unzip logs_pkb.zip -d logs-tool

Accédez à ce répertoire et exécutez le script :

./logs.sh

Après l’exécution, l’utilisateur voit s’afficher un message d’information sur l’espace disponible et une invite à poursuivre (saisissez « y » pour continuer) :

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.

À partir de la version 1.0, l’outil de collecte de journaux rc détecte si NativeEdge ou Dell Automation Platform est installé dans un espace de nommage autre que celui par défaut. Si l’outil ne trouve pas d’espace de nommage standard, il invite l’utilisateur à saisir un espace de nommage Orchestrator valide. Voir l’exemple ci-dessous :

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:

S’il existe une installation d’espace de nommage par défaut, l’outil affichera les espaces de nommage qui se trouvent dans la liste pour la collecte :

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

Capture d’événements :

À partir de la version 0.9-bêta de l’outil, l’utilisateur est invité à propos de la capture des événements EdgeOrchestrator/Dell Automation Platform :

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

Cela capture les événements d’EdgeOrchestrator/Dell Automation Platform directement dans l’archive tar des journaux et améliore le dépannage. Nous vous conseillons de décrocher les événements EdgeOrchestrator/Dell Automation Platform si vous disposez de suffisamment d’espace sur la machine.

Si l’utilisateur dispose d’instructions supplémentaires, il peut vérifier les options disponibles du script avant d’exécuter :

./logs.sh -h

L’utilisateur peut vérifier la version actuelle avec :

logs.sh -v

Cet outil est utilisable sur TOUTES les installations de Dell Automation Platform sur site, versions 1.0 et ultérieures.
Cet outil est utilisable sur TOUTES les versions de NativeEdge Orchestrator 2.0 et versions ultérieures.