24.3. Dépannage d'OVN-Kubernetes

Procédure

1. Examinez les détails de la sonde de préparation ovnkube-master en exécutant la commande suivante :

   $ oc get pods -n openshift-ovn-kubernetes -l app=ovnkube-master \
   -o json | jq '.items[0].spec.containers[] | .name,.readinessProbe'

   La sonde de préparation des conteneurs de base de données nord et sud du pod ovnkube-master vérifie l'état de santé du cluster Raft qui héberge les bases de données.

2. Examinez les détails de la sonde de préparation ovnkube-node en exécutant la commande suivante :

   $ oc get pods -n openshift-ovn-kubernetes -l app=ovnkube-master \
   -o json | jq '.items[0].spec.containers[] | .name,.readinessProbe'

   Le conteneur ovnkube-node dans le pod ovnkube-node dispose d'une sonde de préparation pour vérifier la présence du fichier de configuration CNI ovn-kubernetes, dont l'absence indiquerait que le pod ne fonctionne pas ou n'est pas prêt à accepter des demandes de configuration de pods.

3. Affichez tous les événements, y compris les échecs des sondes, pour l'espace de noms à l'aide de la commande suivante :

   $ oc get events -n openshift-ovn-kubernetes

4. Afficher les événements pour ce seul pod :

   $ oc describe pod ovnkube-master-tp2z8 -n openshift-ovn-kubernetes

5. Affiche les messages et les statuts de l'opérateur du réseau de clusters :

   $ oc get co/network -o json | jq '.status.conditions[]'

6. Affichez le statut ready de chaque conteneur dans les pods ovnkube-master en exécutant le script suivant :

   $ for p in $(oc get pods --selector app=ovnkube-master -n openshift-ovn-kubernetes \
   -o jsonpath='{range.items[*]}{" "}{.metadata.name}'); do echo === $p ===;  \
   oc get pods -n openshift-ovn-kubernetes $p -o json | jq '.status.containerStatuses[] | .name, .ready'; \
   done

   Note

   On s'attend à ce que tous les états des conteneurs soient signalés comme étant true. L'échec d'une enquête sur l'état de préparation fait passer le statut à false.

Procédure (UI)

1. Dans la Administrator sélectionnez Observe Alerting. Les trois pages principales de l'interface utilisateur d'alerte dans cette perspective sont les suivantes Alerts, Silences, et Alerting Rules sont les trois pages principales de l'interface utilisateur des alertes dans cette perspective.
2. Consultez les règles pour les alertes OVN-Kubernetes en sélectionnant Observe Alerting Alerting Rules.

Procédure

1. Pour visualiser les alertes actives ou en cours de déclenchement, exécutez les commandes suivantes.

   1. Définissez la variable d'environnement alert manager route en exécutant la commande suivante :

      $ ALERT_MANAGER=$(oc get route alertmanager-main -n openshift-monitoring \
      -o jsonpath='{@.spec.host}')

   2. Emettez une requête curl à l'API de route du gestionnaire d'alertes avec les détails d'autorisation corrects demandant des champs spécifiques en exécutant la commande suivante :

      $ curl -s -k -H "Authorization: Bearer \
      $(oc create token prometheus-k8s -n openshift-monitoring)" \
      https://$ALERT_MANAGER/api/v1/alerts \
      | jq '.data[] | "\(.labels.severity) \(.labels.alertname) \(.labels.pod) \(.labels.container) \(.labels.endpoint) \(.labels.instance)"'

2. Affichez les règles d'alerte en exécutant la commande suivante :

   $ oc -n openshift-monitoring exec -c prometheus prometheus-k8s-0 -- curl -s 'http://localhost:9090/api/v1/rules' | jq '.data.groups[].rules[] | select(((.name|contains("ovn")) or (.name|contains("OVN")) or (.name|contains("Ovn")) or (.name|contains("North")) or (.name|contains("South"))) and .type=="alerting")'

Procédure

1. Visualiser le journal d'un pod spécifique :

   $ oc logs -f <nom_du_pod> -c <nom_du_conteneur> -n <espace_de_noms>

   où :

   -f

   Facultatif : Spécifie que la sortie suit ce qui est écrit dans les journaux.

   <pod_name>

   Spécifie le nom du module.

   <container_name>

   Facultatif : Spécifie le nom d'un conteneur. Lorsqu'un module a plus d'un conteneur, vous devez spécifier le nom du conteneur.

   <namespace>

   Spécifie l'espace de noms dans lequel le module est exécuté.

   Par exemple :

   $ oc logs ovnkube-master-7h4q7 -n openshift-ovn-kubernetes

   $ oc logs -f ovnkube-master-7h4q7 -n openshift-ovn-kubernetes -c ovn-dbchecker

   Le contenu des fichiers journaux est imprimé.

2. Examinez les entrées les plus récentes dans tous les conteneurs des modules ovnkube-master:

   $ for p in $(oc get pods --selector app=ovnkube-master -n openshift-ovn-kubernetes \
   -o jsonpath='{range.items[*]}{" "}{.metadata.name}'); \
   do echo === $p ===; for container in $(oc get pods -n openshift-ovn-kubernetes $p \
   -o json | jq -r '.status.containerStatuses[] | .name');do echo ---$container---; \
   oc logs -c $container $p -n openshift-ovn-kubernetes --tail=5; done; done

3. Affichez les 5 dernières lignes de chaque journal dans chaque conteneur d'un pod ovnkube-master à l'aide de la commande suivante :

   $ oc logs -l app=ovnkube-master -n openshift-ovn-kubernetes --all-containers --tail 5

Procédure

1. Dans la console OpenShift Container Platform, naviguez vers Workloads Pods ou naviguez vers le pod par le biais de la ressource que vous souhaitez étudier.
2. Sélectionnez le projet openshift-ovn-kubernetes dans le menu déroulant.
3. Cliquez sur le nom du module que vous souhaitez examiner.
4. Cliquez Logs. Par défaut, pour le site ovnkube-master, les journaux associés au conteneur northd sont affichés.
5. Utilisez le menu déroulant pour sélectionner les journaux pour chaque conteneur à tour de rôle.

Procédure

1. Pour dresser la liste des objets PodNetworkConnectivityCheck en cours, entrez la commande suivante :

   $ oc get podnetworkconnectivitychecks -n openshift-network-diagnostics

2. Affichez le succès le plus récent pour chaque objet de connexion à l'aide de la commande suivante :

   $ oc get podnetworkconnectivitychecks -n openshift-network-diagnostics \
   -o json | jq '.items[]| .spec.targetEndpoint,.status.successes[0]'

3. Affichez les échecs les plus récents pour chaque objet de connexion à l'aide de la commande suivante :

   $ oc get podnetworkconnectivitychecks -n openshift-network-diagnostics \
   -o json | jq '.items[]| .spec.targetEndpoint,.status.failures[0]'

4. Affichez les pannes les plus récentes pour chaque objet de connexion à l'aide de la commande suivante :

   $ oc get podnetworkconnectivitychecks -n openshift-network-diagnostics \
   -o json | jq '.items[]| .spec.targetEndpoint,.status.outages[0]'

   Le contrôleur de vérification de la connectivité enregistre également les mesures de ces vérifications dans Prometheus.

5. Affichez toutes les mesures en exécutant la commande suivante :

   $ oc exec prometheus-k8s-0 -n openshift-monitoring -- \
   promtool query instant  http://localhost:9090 \
   '{component="openshift-network-diagnostics"}'

6. Voir la latence entre le pod source et le service openshift api pour les 5 dernières minutes :

   $ oc exec prometheus-k8s-0 -n openshift-monitoring -- \
   promtool query instant  http://localhost:9090 \
   '{component="openshift-network-diagnostics"}'