Dépannage des opérations

Chaque section part de ce que vous voyez. Les journaux des services se trouvent dans le journal système : journalctl -u kyvernon-controller et journalctl -u kyvernon-agent. Le contrôleur écrit par défaut des lignes JSON (format dans [logging]).

Contrôleur qui ne démarre pas

Cause. L'unité ne démarre pas sans /etc/kyvernon/controller.toml. Une valeur hors de sa plage, une clé inconnue ou un fichier d'identifiants manquant arrête le service au démarrage.

Solution.

1. Vérifiez la configuration : sudo kyvernon-controller --config /etc/kyvernon/controller.toml check-config. Le message nomme la clé.
2. Lisez les dernières lignes du journal : journalctl -u kyvernon-controller -n 50.
3. Comparez le fichier au squelette /usr/share/kyvernon/controller.toml.example après une mise à niveau. Les clés des paramètres figurent dans Configuration.

Contrôleur non prêt

Cause. La vivacité et la disponibilité sont deux choses différentes. Le contrôleur est vivant lorsqu'il traite des requêtes, et prêt lorsque son magasin a un leader et qu'il a appliqué son état.

Solution.

1. Interrogez les deux : kyvernon system health et kyvernon system ready. ready se termine avec le code 1 lorsque le contrôleur n'est pas prêt. Les mêmes vérifications sont GET /healthz et GET /readyz.
2. S'il reste non prêt après un démarrage, lisez dans le journal le message sur le magasin.
3. kyvernon system metrics affiche les métriques du contrôleur au format texte Prometheus (GET /metrics). Elles demandent un jeton, sauf si anonymous = true dans [metrics].

Hôte qui ne se connecte pas

Cause. L'agent s'enregistre avec le jeton d'adhésion et vérifie le contrôleur grâce à son certificat. Un hôte qui affiche Déconnecté après le démarrage de l'agent est généralement dans l'un de ces cas : le jeton d'adhésion est erroné ou absent, le certificat de controller-ca.pem n'est pas le certificat d'amorçage du contrôleur, server_name ne figure pas parmi les noms de [tls] san du contrôleur, endpoint ou le port gRPC du contrôleur n'est pas joignable depuis l'hôte, le nom de l'hôte diffère du nom ajouté dans le cluster, ou un administrateur a déconnecté l'hôte.

Solution.

1. Lisez le journal sur l'hôte : sudo journalctl -u kyvernon-agent.service -n 50.
2. Comparez endpoint, ca_file, server_name et hostname dans /etc/kyvernon/agent.toml avec Installer depuis un dépôt hors ligne, étape 3.
3. Vérifiez que /etc/kyvernon/join-token existe et qu'il est identique au jeton du contrôleur.
4. Un hôte qui a perdu son certificat, par exemple après une réinstallation ou en supprimant /var/lib/kyvernon/agent/identity, est refusé sous le même nom. Ajoutez-le de nouveau avec --force : Hôtes.
5. Vérifiez si un administrateur a déconnecté l'hôte, et reconnectez-le avec Reconnecter.

Hôte qui ne répond pas

Cause. Le contrôleur affiche Ne répond pas lorsqu'aucun signal de présence n'arrive d'un hôte qui était connecté : l'agent s'est arrêté, l'hôte est hors service, ou le réseau entre les deux est interrompu. Les machines virtuelles de l'hôte ne sont pas arrêtées par un agent arrêté.

Solution.

1. Vérifiez la machine et l'agent : systemctl status kyvernon-agent.service sur l'hôte.
2. Vérifiez le réseau entre l'hôte et l'adresse gRPC du contrôleur.
3. Redémarrez l'agent et vérifiez que l'hôte affiche Connecté. D'ici là, les opérations qui ont besoin de l'hôte échouent, par exemple la console avec error.console.host_disconnected.

Mise sous tension refusée

Cause. La licence ou la mémoire de l'hôte ne le permet pas. L'identifiant du message indique laquelle.

Solution.

1. error.licence.limit_running_vms : Licence.
2. error.host.insufficient_memory, error.vm.exceeds_host_cpu ou error.vm.exceeds_host_memory : Capacité.
3. error.host_in_maintenance : choisissez un autre hôte ou quittez le mode maintenance.

Session de sauvegarde en échec

Cause. Une session se termine en ABORTED ou EXPIRED, ou une requête est refusée avec une clé backup.*.

Solution. Le reason de la session est une clé de message. Sauvegarder une machine virtuelle liste les clés qu'un client doit gérer et ce qu'il faut faire pour chacune.

Données pour le support

Lorsque vous contactez le support, transmettez l'identifiant de message de l'erreur, son correlationId (aussi dans l'en-tête x-request-id de la réponse), l'heure et la sortie de kyvernon about. L'identifiant de corrélation figure dans les journaux et dans les enregistrements d'audit de la requête.

Voir aussi

• Référence des codes d'erreur
• Configuration