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 le journal système et journald log également. 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 couvre la plate-forme d’automatisation Dell et Knative pods et répertorie les conteneurs qu’ils contiennent. Voir l’exemple ci-dessous pour plus de précisions. 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 le fichier 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

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 à la machine virtuelle Dell Automation Platform.

Extrayez le contenu du programme d'installation.

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 les exemples 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 les logs tarball 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

Ignorer la collecte de base de données

./logs.sh --skip-database

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

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.