4.5. Activation du fichier journal des requêtes pour Prometheus

Conditions préalables

• Vous avez installé l'OpenShift CLI (oc).

• If you are enabling the query log file feature for Prometheus in the openshift-monitoring project:

  • Vous avez accès au cluster en tant qu'utilisateur ayant le rôle cluster-admin.
  • Vous avez créé l'objet cluster-monitoring-config ConfigMap .

• If you are enabling the query log file feature for Prometheus in the openshift-user-workload-monitoring project:

  • Vous avez accès au cluster en tant qu'utilisateur ayant le rôle cluster-admin, ou en tant qu'utilisateur ayant le rôle user-workload-monitoring-config-edit dans le projet openshift-user-workload-monitoring.
  • Vous avez créé l'objet user-workload-monitoring-config ConfigMap .

Procédure

• To set the query log file for Prometheus in the openshift-monitoring project:

  1. Modifiez l'objet cluster-monitoring-config ConfigMap dans le projet openshift-monitoring:

     $ oc -n openshift-monitoring edit configmap cluster-monitoring-config

  2. Ajouter queryLogFile: <path> pour prometheusK8s sous data/config.yaml:

     apiVersion: v1
     kind: ConfigMap
     metadata:
       name: cluster-monitoring-config
       namespace: openshift-monitoring
     data:
       config.yaml: |
         prometheusK8s:
           queryLogFile: <path> 1

     1

     Le chemin complet vers le fichier dans lequel les requêtes seront enregistrées.

  3. Enregistrez le fichier pour appliquer les modifications.

     Avertissement

     Lorsque vous enregistrez les modifications apportées à une carte de configuration de surveillance, les pods et autres ressources du projet concerné peuvent être redéployés. Les processus de surveillance en cours dans ce projet peuvent également être redémarrés.

  4. Vérifiez que les pods du composant sont en cours d'exécution. L'exemple de commande suivant répertorie l'état des modules dans le projet openshift-monitoring:

     $ oc -n openshift-monitoring get pods

  5. Lire le journal des requêtes :

     oc -n openshift-monitoring exec prometheus-k8s-0 -- cat <path>

     Important

     Rétablissez le paramètre dans la carte de configuration après avoir examiné les informations de requête consignées.

• To set the query log file for Prometheus in the openshift-user-workload-monitoring project:

  1. Modifiez l'objet user-workload-monitoring-config ConfigMap dans le projet openshift-user-workload-monitoring:

     $ oc -n openshift-user-workload-monitoring edit configmap user-workload-monitoring-config

  2. Ajouter queryLogFile: <path> pour prometheus sous data/config.yaml:

     apiVersion: v1
     kind: ConfigMap
     metadata:
       name: user-workload-monitoring-config
       namespace: openshift-user-workload-monitoring
     data:
       config.yaml: |
         prometheus:
           queryLogFile: <path> 1

     1

     Le chemin complet vers le fichier dans lequel les requêtes seront enregistrées.

  3. Enregistrez le fichier pour appliquer les modifications.

     Note

     Les configurations appliquées à l'objet user-workload-monitoring-config ConfigMap ne sont pas activées à moins qu'un administrateur de cluster n'ait activé la surveillance pour les projets définis par l'utilisateur.

     Avertissement

     Lorsque vous enregistrez les modifications apportées à une carte de configuration de surveillance, les pods et autres ressources du projet concerné peuvent être redéployés. Les processus de surveillance en cours dans ce projet peuvent également être redémarrés.

  4. Vérifiez que les pods du composant sont en cours d'exécution. L'exemple de commande suivant répertorie l'état des modules dans le projet openshift-user-workload-monitoring:

     $ oc -n openshift-user-workload-monitoring get pods

  5. Lire le journal des requêtes :

     oc -n openshift-user-workload-monitoring exec prometheus-user-workload-0 -- cat <path>

     Important

     Rétablissez le paramètre dans la carte de configuration après avoir examiné les informations de requête consignées.