Utilisez cette section à titre de référence, pour vous aider lorsque vous utilisez VMware Cloud Director Container Service Extension en tant qu'administrateur du fournisseur de services.

Dépannage avec les journaux

Cette section décrit les fichiers journaux importants et leur emplacement pour VMware Cloud Director Container Service Extension 4.0. Vous pouvez vous aider de ces fichiers journaux lorsque vous effectuez un dépannage ou que vous retentez des opérations à la suite d'erreurs dues à l'échec de scripts de machine virtuelle éphémère.

Tableau 1. Bundles de journaux
Composant Journal Description Emplacement Pris en charge par Syslog Remarques
Serveur VMware Cloud Director Container Service Extension cse.log Journal du serveur VMware Cloud Director Container Service Extension qui collecte toutes les sorties et erreurs standard à un même emplacement. Il inclut l'état d'exécution de la création, de la suppression et du signal de pulsation du cluster, ainsi que les événements et les erreurs qui sont enregistrés dans le RDE. /root/cse.log Oui Cet emplacement de fichier se trouve dans une machine virtuelle sur laquelle le fichier OVA du serveur VMware Cloud Director Container Service Extension est déployé et dans laquelle CSE fonctionne.
Serveur VMware Cloud Director Container Service Extension cse-wire.log Contient les demandes et les réponses générées par le SDK VMware Cloud Director. Consultez ce journal lorsque vous déboguez des pannes inattendues dans l'environnement du client. /root/cse-wire.log Non
Pour activer la journalisation du câble, procédez comme suit :
  1. Ouvrez une session sur la machine virtuelle contenant le fichier OVA VMware Cloud Director Container Service Extension.
  2. Ouvrez /root/config.toml.
  3. Entrez la ligne suivante :wire_logging_enabled = true.
    Note : Pour désactiver la journalisation du câble, commentez cette ligne.
  4. Utilisez la commande suivante pour redémarrer le service VMware Cloud Director Container Service Extension : systemctl restart cse.service.
VM de démarrage cloud-final.err Collecte tous les états et commandes qui sont exécutés pour créer et supprimer des clusters sur des machines virtuelles éphémères, ainsi que les étapes suivantes permettant de s'assurer que le cluster cible est autogérable. Si la création et la suppression du cluster réussissent, toutes les commandes sont enregistrées. En cas d'échec le message d'erreur est enregistré avant l'annulation de l'opération. /var/log/cloud-final.err
Note : Ce journal se trouve dans la VM de démarrage. Il est nécessaire de se connecter à la VM de démarrage.
Oui Définissez autoRepairOnErrors: Off. Il s'agit d'un paramètre pris en charge par l'interface utilisateur au moment de la création du cluster. Vous le trouverez dans l'onglet Paramètres de débogage de l'interface utilisateur.
VM de démarrage cloud-final.out Il s'agit d'un fichier sur la machine virtuelle éphémère qui enregistre toutes les sorties standard qui se produisent lors des téléchargements de modules, et pendant les opérations clusterctl init, kubectl machines, apply. /var/log/cloud-final.out
Note : Ce journal se trouve dans la VM de démarrage. Il est nécessaire de se connecter à la VM de démarrage.
Oui Définissez autoRepairOnErrors: Off. Il s'agit d'un paramètre pris en charge par l'interface utilisateur au moment de la création du cluster. Vous le trouverez dans l'onglet Paramètres de débogage de l'interface utilisateur.
VM de démarrage, cluster Kubernetes Interpréteur de commandes de dépistage :

Exécuter k8s-log-bundle.sh		 Collecte des journaux à partir d'espaces CAPVCD. S'il n'y a aucune erreur lors de l'exécution du script de machine virtuelle éphémère et que kubectl get machines continue d'exécuter une boucle en suspens, l'utilisateur peut utiliser ce script pour passer à l'étape de dépannage suivante afin d'effectuer une analyse des causes profondes du problème. https://github.com/vmware/cloud-provider-for-cloud-director/blob/main/scripts/generate-k8s-log-bundle.sh Non Il s'agit d'un fichier de script bash. Assurez-vous d'effectuer les opérations suivantes avant d'exécuter le script :
  • Téléchargez le fichier kubeconfig du cluster.
  • Exporter KUBECONFIG=<full-path-of-kube-config>
VM de démarrage, cluster Kubernetes Journaux CAPVCD : 
export KUBECONFIG=/path/to/kubeconfig

kubectl get pods -A (copy CAPVCD pod name) 
kubectl logs -n kube-system CAPVCD-POD-NAME
 Journaux pour CAPVCD Non Activez les journaux de câble, par exemple pour les demandes HTTP et les réponses HTTP vers et depuis VMware Cloud Director, dans les journaux de l'espace CAPVCD.
kubectl set env -n capvcd-system deployment/capvcd-controller-manager GOVCD_LOG_ON_SCREEN=true -oyaml.
Pour désactiver la journalisation du câble, utilisez la commande suivante :
kubectl set env -n capvcd-system deployment/capvcd-controller-manager GOVCD_LOG_ON_SCREEN-
Note : L'activation des journaux de câble pollue les journaux. L'activation des journaux de câble n'est nécessaire que pour déboguer les pannes.
Cluster Kubernetes Sortie CPI pour les journaux CPI 
export KUBECONFIG=/path/to/kubeconfig
kubectl get pods -A (copy CPI pod name)
kubectl logs -n kube-system CPI-POD-NAME
 Journaux pour les espaces CPI Non Activez les journaux de câble, les demandes HTTP et les réponses HTTP vers et depuis VMware Cloud Director dans les journaux de l'espace CPI.

kubectl set env -n kube-system deployment/vmware-cloud-director-ccm GOVCD_LOG_ON_SCREEN=true -oyaml

Pour désactiver la journalisation du câble, utilisez la commande suivante : 
kubectl set env -n kube-system deployment/vmware-cloud-director-ccm GOVCD_LOG_ON_SCREEN-
Note : L'activation des journaux de câble pollue les journaux. L'activation des journaux de câble n'est nécessaire que pour déboguer les pannes.
Cluster Kubernetes Journaux CSI 
export KUBECONFIG=/path/to/kubeconfig

kubectl get pods -A (copy CSI controller pod name or CSI node-plugin pod name) 
kubectl logs -n kube-system CSI-POD-NAME -c vcd-csi-plugin
 Journaux pour CSI Non Activez les journaux de câble, les demandes HTTP et les réponses HTTP vers et depuis VMware Cloud Director dans les journaux de l'espace CSI. 
kubectl set env -n kube-system StatefulSet/csi-vcd-controllerplugin -c vcd-csi-plugin GOVCD_LOG_ON_SCREEN=true -oyaml
kubectl set env -n kube-system DaemonSet/csi-vcd-nodeplugin -c vcd-csi-plugin GOVCD_LOG_ON_SCREEN=true -oyaml
Pour désactiver la journalisation du câble, utilisez la commande suivante : 
kubectl set env -n kube-system StatefulSet/csi-vcd-controllerplugin -c vcd-csi-plugin GOVCD_LOG_ON_SCREEN-
kubectl set env -n kube-system DaemonSet/csi-vcd-nodeplugin -c vcd-csi-plugin GOVCD_LOG_ON_SCREEN-
Note : L'activation des journaux de câble pollue les journaux. L'activation des journaux de câble n'est nécessaire que pour déboguer les pannes.
Cluster Kubernetes Journaux du Projecteur RDE
export KUBECONFIG=/path/to/kubeconfig
kubectl get pods -A (copy CSI controller pod name or CSI node-plugin pod name)
kubectl logs -n kube-system CSI-POD-NAME -c vcd-csi-plugin
Journaux pour le projecteur RDE Non Activez les journaux de câble, les demandes HTTP et les réponses HTTP vers et depuis VMware Cloud Director dans les journaux de l'espace du projecteur RDE. 
kubectl set env -n rdeprojector-system deployment/rdeprojector-controller-manager GOVCD_LOG_ON_SCREEN=true -oyaml

Pour désactiver la journalisation du câble, utilisez la commande suivante :

kubectl set env -n capvcd-system deployment/rdeprojector-controller-manager GOVCD_LOG_ON_SCREEN-
Cluster Kubernetes via l'API RDE de cluster utilisant l'Outil Postman 
GET https://{{base_url}}/cloudapi/1.0.0/entities/types/vmware/capvcdCluster/1.1.0
Découvrez l'entité qui correspond au nom du cluster.

Rechercher entity->status->VcdKe→errorSet : il s'agit d'un tableau JSON qui contient les erreurs rencontrées pendant le fonctionnement du cluster		 Non HTTP GET