Chapitre 10. Dépannage des problèmes de surveillance

Procédure

1. Interrogez le nom métrique et vérifiez que le projet est correct:

   1. Dans la perspective Développeur de la console Web, cliquez sur Observer et allez dans l’onglet Metrics.
   2. Choisissez le projet pour lequel vous souhaitez afficher les métriques dans la liste Projet:

   3. Choisissez une requête existante dans la liste Sélectionner la requête, ou exécutez une requête personnalisée en ajoutant une requête PromQL au champ Expression.

      Les métriques sont affichées dans un graphique.

      Les requêtes doivent être faites sur une base par projet. Les métriques affichées concernent le projet que vous avez sélectionné.

2. Assurez-vous que le pod que vous voulez des métriques sert activement les métriques. Exécutez la commande oc exec suivante dans un pod pour cibler le podIP, le port et /metrics.

   $ oc exec <sample_pod> -n <sample_namespace> -- curl <target_pod_IP>:<port>/metrics

   Copy to Clipboard Toggle word wrap
   Note

   Il faut exécuter la commande sur un pod installé.

   L’exemple suivant affiche un résultat avec une métrique de version valide.

   Exemple de sortie

     % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                    Dload  Upload   Total   Spent    Left  Speed
   # HELP version Version information about this binary-- --:--:-- --:--:--     0
   # TYPE version gauge
   version{version="v0.1.0"} 1
   100   102  100   102    0     0  51000      0 --:--:-- --:--:-- --:--:-- 51000

   Copy to Clipboard Toggle word wrap

   La sortie invalide indique qu’il y a un problème avec l’application correspondante.

3. Lorsque vous utilisez un CRD PodMonitor, vérifiez que le CRD PodMonitor est configuré pour pointer vers les bons pods à l’aide de la correspondance d’étiquette. Consultez la documentation de Prometheus Operator pour plus d’informations.

4. Lorsque vous utilisez un CRD ServiceMonitor, et si le point de terminaison /metrics de la pod affiche des données métriques, suivez ces étapes pour vérifier la configuration:

   1. Assurez-vous que le service est pointé vers le point de terminaison correct /metrics. Les étiquettes de service de cette sortie doivent correspondre aux étiquettes de surveillance des services et au point de terminaison /metrics défini par le service dans les étapes suivantes.

      $ oc get service

      Copy to Clipboard Toggle word wrap

      Exemple de sortie

      apiVersion: v1
      kind: Service 

      1

      
      metadata:
        labels: 

      2

      
          app: prometheus-example-app
        name: prometheus-example-app
        namespace: ns1
      spec:
        ports:
        - port: 8080
          protocol: TCP
          targetPort: 8080
          name: web
        selector:
          app: prometheus-example-app
        type: ClusterIP

      Copy to Clipboard Toggle word wrap

      1

      Indique qu’il s’agit d’une API de service.

      2

      Indique les étiquettes utilisées pour ce service.

   2. Interrogez les points de terminaison serviceIP, port et /metrics pour voir si les mêmes métriques de la commande curl que vous avez exécutée sur le pod précédemment:

      1. Exécutez la commande suivante pour trouver le service IP:

         $ oc get service -n <target_namespace>

         Copy to Clipboard Toggle word wrap

      2. Interrogez le point de terminaison /metrics:

         $ oc exec <sample_pod> -n <sample_namespace> -- curl <service_IP>:<port>/metrics

         Copy to Clipboard Toggle word wrap

         Les métriques valides sont retournées dans l’exemple suivant.

         Exemple de sortie

         % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                        Dload  Upload   Total   Spent    Left  Speed
         100   102  100   102    0     0  51000      0 --:--:-- --:--:-- --:--:--   99k
         # HELP version Version information about this binary
         # TYPE version gauge
         version{version="v0.1.0"} 1

         Copy to Clipboard Toggle word wrap

   3. Faites correspondre l’étiquette pour vérifier que l’objet ServiceMonitor est configuré pour pointer vers le service souhaité. À cette fin, comparez l’objet Service de l’oc obtient la sortie de service à l’objet ServiceMonitor à partir de la sortie Servicemonitor. Les étiquettes doivent correspondre pour que les métriques soient affichées.

      À titre d’exemple, à partir des étapes précédentes, notez comment l’objet Service a l’application: l’étiquette prometheus-example-app et l’objet ServiceMonitor a la même application: prometheus-example-app label.

5. Lorsque tout semble valide et que les métriques sont toujours indisponibles, veuillez contacter l’équipe d’assistance pour obtenir de l’aide.