16 Surveillance et alertes #

Astuce

Cette section explique comment modifier la configuration des images de conteneur utilisées lors du déploiement ou de la mise à jour de services. Elle n'inclut pas les commandes nécessaires au déploiement ou au redéploiement des services.

La méthode recommandée pour déployer la pile de surveillance consiste à appliquer sa spécification comme décrit dans le Section 5.4.3.8, « Déploiement de la pile de surveillance ».

Pour déployer des images de conteneur personnalisées ou locales, celles-ci doivent être définies dans cephadm. Pour ce faire, vous devez exécuter la commande suivante :

cephuser@adm > ceph config set mgr mgr/cephadm/OPTION_NAME VALUE

Dans laquelle OPTION_NAME correspond à l'un des noms suivants :

Si aucune option n'est définie ou si le paramètre a été supprimé, les images suivantes sont utilisées comme VALUE :

Par exemple :

cephuser@adm > ceph config set mgr mgr/cephadm/container_image_prometheus prom/prometheus:v1.4.1

Note

Si vous définissez une image personnalisée, la valeur par défaut sera remplacée (mais pas écrasée). La valeur par défaut change lorsque des mises à jour sont disponibles. Si vous définissez une image personnalisée, vous ne pourrez pas mettre à jour automatiquement le composant pour lequel vous avez configuré l'image personnalisée. Vous devez mettre à jour manuellement la configuration (nom de l'image et balise) pour pouvoir installer des mises à jour.

Si vous choisissez plutôt de suivre les recommandations, vous pouvez réinitialiser l'image personnalisée que vous avez définie auparavant, après quoi la valeur par défaut sera de nouveau utilisée. Utilisez ceph config rm pour réinitialiser l'option de configuration :

cephuser@adm > ceph config rm mgr mgr/cephadm/OPTION_NAME

Par exemple :

cephuser@adm > ceph config rm mgr mgr/cephadm/container_image_prometheus

Comme indiqué dans la Section 16.1, « Configuration d'images personnalisées ou locales », cephadm est fourni avec les URL des images de conteneur recommandées et testées, lesquelles sont utilisées par défaut.

Si vous mettez à jour les paquetages Ceph, de nouvelles versions de ces URL peuvent être fournies. Cette opération met simplement à jour l'emplacement à partir duquel les images de conteneur sont extraites, mais ne met à jour aucun service.

Une fois les URL des nouvelles images de conteneur mises à jour, que ce soit manuellement comme décrit dans la Section 16.1, « Configuration d'images personnalisées ou locales » ou automatiquement via une mise à jour du paquetage Ceph, les services de surveillance peuvent être mis à jour.

Pour ce faire, utilisez ceph orch redeploy comme suit :

cephuser@adm > ceph orch redeploy node-exporter
cephuser@adm > ceph orch redeploy prometheus
cephuser@adm > ceph orch redeploy alertmanager
cephuser@adm > ceph orch redeploy grafana

Il n'existe actuellement aucune commande unique permettant de mettre à jour tous les services de surveillance. L'ordre dans lequel ces services sont mis à jour n'a pas d'importance.

Note

Si vous utilisez des images de conteneur personnalisées, les URL spécifiées pour les services de surveillance ne seront pas modifiées automatiquement en cas de mise à jour des paquetages Ceph. Si vous avez spécifié des images de conteneur personnalisées, vous devrez indiquer manuellement les URL des nouvelles images de conteneur, notamment si vous utilisez un registre local de conteneurs.

Les URL des images de conteneur recommandées à utiliser sont indiquées dans la Section 16.1, « Configuration d'images personnalisées ou locales ».

Pour désactiver la pile de surveillance, exécutez les commandes suivantes :

cephuser@adm > ceph orch rm grafana
cephuser@adm > ceph orch rm prometheus --force   # this will delete metrics data collected so far
cephuser@adm > ceph orch rm node-exporter
cephuser@adm > ceph orch rm alertmanager
cephuser@adm > ceph mgr module disable prometheus

Le back-end Ceph Dashboard a besoin de l'URL de Grafana pour pouvoir vérifier l'existence des tableaux de bord Grafana avant même que le front-end ne les charge. En raison de la nature de l'implémentation de Grafana dans Ceph Dashboard, cela signifie que deux connexions fonctionnelles sont nécessaires pour pouvoir afficher les graphiques Grafana dans Ceph Dashboard :

Cela dit, il se peut qu'en raison de votre environnement, le navigateur de l'utilisateur puisse difficilement accéder directement à l'URL configurée dans Ceph Dashboard. Pour résoudre ce problème, vous pouvez configurer une URL distincte qui sera uniquement utilisée pour indiquer au front-end (le navigateur de l'utilisateur) l'URL à utiliser pour accéder à Grafana.

Pour modifier l'URL renvoyée au front-end, exécutez la commande suivante :

cephuser@adm > ceph dashboard set-grafana-frontend-api-url GRAFANA-SERVER-URL

Si aucune valeur n'est définie pour cette option, elle sera simplement redéfinie sur la valeur de l'option Grafana_API_URL, laquelle est définie automatiquement et mise à jour périodiquement par cephadm. Si elle est définie, elle indiquera au navigateur d'utiliser cette URL pour accéder à Grafana.

Le module Prometheus Manager est un module intégré à Ceph qui étend les fonctionnalités de Ceph. Le module lit les (méta)données de Ceph concernant son état et sa santé, et fournit à Prometheus les données (récupérées) dans un format exploitable.

Note

Le module Prometheus Manager doit être redémarré pour que les modifications apportées à la configuration soient appliquées.

cephuser@adm > ceph config set mgr mgr/prometheus/server_addr 0.0.0.0

cephuser@adm > ceph config set mgr mgr/prometheus/server_port 9283

16.5.2 Configuration du paramètre scrape_interval #

 

Par défaut, le module Prometheus Manager est configuré avec un intervalle de récupération de 15 secondes. Nous vous déconseillons d'utiliser un intervalle de récupération inférieur à 10 secondes. Pour configurer un intervalle de récupération différent dans le module Prometheus, définissez le paramètre scrape_interval sur la valeur souhaitée :

Important

Pour fonctionner correctement et ne causer aucun problème, le paramètre scrape_interval de ce module doit toujours être défini de manière à correspondre à l'intervalle de récupération de Prometheus.

cephuser@adm > ceph config set mgr mgr/prometheus/scrape_interval 15

cephuser@adm > ceph config set mgr mgr/prometheus/stale_cache_strategy return

cephuser@adm > ceph config set mgr mgr/prometheus/stale_cache_strategy fail

cephuser@adm > ceph config set mgr mgr/prometheus/rbd_stats_pools "pool1,pool2,poolN"

cephuser@adm > ceph config set mgr mgr/prometheus/rbd_stats_pools_refresh_interval 600

Le modèle de sécurité de Prometheus part du principe que les utilisateurs non approuvés ont accès au noeud d'extrémité HTTP et aux journaux de Prometheus. Les utilisateurs non approuvés ont accès à l'ensemble des (méta)données collectées par Prometheus et contenues dans la base de données, ainsi qu'à diverses informations opérationnelles et de débogage.

Cependant, l'API HTTP de Prometheus est limitée aux opérations en lecture seule. Les configurations ne peuvent pas être modifiées à l'aide de l'API et les secrets ne sont pas exposés. Prometheus dispose par ailleurs de mesures intégrées pour limiter l'impact des attaques par déni de service.

Si vous voulez être informé des alertes Prometheus via des trappes SNMP, vous pouvez installer le webhook SNMP de Prometheus Alertmanager via cephadm. Pour ce faire, vous devez créer un fichier de spécification de service et de placement incluant le contenu suivant :

Note

Pour plus d'informations sur les fichiers de service et de placement, reportez-vous au Section 5.4.2, « Spécification de service et de placement ».

service_type: container
service_id: prometheus-webhook-snmp
placement:
    ADD_PLACEMENT_HERE
image: registry.suse.com/ses/7/prometheus-webhook-snmp:latest
args:
    - "--publish 9099:9099"
envs:
    - ARGS="--debug --snmp-host=ADD_HOST_GATEWAY_HERE"
    - RUN_ARGS="--metrics"
EOF

Utilisez cette spécification de service pour que le service s'exécute en utilisant ses paramètres par défaut.

Vous devez publier le port sur lequel le récepteur Prometheus écoute en utilisant l'argument de ligne de commande --publish HOST_PORT:CONTAINER_PORT lors de l'exécution du service, car le port n'est pas exposé automatiquement par le conteneur. Pour ce faire, vous pouvez ajouter les lignes suivantes à la spécification :

args:
    - "--publish 9099:9099"

Vous pouvez également connecter le conteneur au réseau hôte en utilisant l'argument de ligne de commande --network=host.

args:
    - "--network=host"

Si le récepteur de trappes SNMP n'est pas installé sur le même hôte que le conteneur, vous devez également spécifier le nom de domaine complet (FQDN) de l'hôte SNMP. Utilisez la passerelle réseau du conteneur pour pouvoir recevoir des trappes SNMP en dehors du conteneur/hôte :

envs:
    - ARGS="--debug --snmp-host=CONTAINER_GATEWAY"

envs:
    - ARGS="--debug --snmp-host=CONTAINER_GATEWAY"
    - RUN_ARGS="--metrics --port=9101"

files:
    etc/prometheus-webhook-snmp.conf:
        - "debug: True"
        - "snmp_host: ADD_HOST_GATEWAY_HERE"
        - "metrics: True"
volume_mounts:
    etc/prometheus-webhook-snmp.conf: /etc/prometheus-webhook-snmp.conf

cephuser@adm > ceph orch apply -i SERVICE_SPEC_FILE

16.7.2 Configuration de Prometheus Alertmanager pour SNMP #

 

Enfin, Prometheus Alertmanager doit être configuré spécifiquement pour les trappes SNMP. Si ce service n'a pas encore été déployé, créez un fichier de spécification de service. Vous devez remplacer IP_OR_FQDN par l'adresse IP ou le nom de domaine complet de l'hôte sur lequel le webhook SNMP de Prometheus Alertmanager a été installé. Par exemple :

Note

Si vous avez déjà déployé ce service, redéployez-le avec les paramètres ci-dessous pour vous assurer qu'Alertmanager est configuré correctement pour SNMP.

  service_type: alertmanager
  placement:
    hosts:
    - HOSTNAME
  webhook_configs:
    - 'http://IP_OR_FQDN:9099/'

Appliquez la spécification de service à l'aide de la commande suivante :

cephuser@adm > ceph orch apply -i SERVICE_SPEC_FILE