Prometheus: Configuration de Prometheus Blackbox Exporter

Cette documentation fait partie du guide Blackbox Exporter. Consultez le guide complet ici : Comment utiliser Prometheus Blackbox Exporter pour sonder les endpoints HTTP et ICMP (ping).

👋 Bienvenue dans la documentation Stackhero !

Stackhero vous propose une plateforme Prometheus cloud entièrement gérée, conçue pour la fiabilité et la simplicité :

• Alert Manager est intégré, ce qui vous permet d’acheminer les alertes directement vers Slack, Mattermost, PagerDuty et d’autres destinations populaires.
• Un serveur email dédié vous permet d’envoyer un nombre illimité d’alertes par email sans configuration supplémentaire.
• Blackbox est inclus, vous permettant de sonder les protocoles HTTP, ICMP, TCP et autres pour une surveillance complète.
• Configurez votre instance rapidement grâce à l’éditeur de fichier de configuration en ligne. Plus besoin de gérer le YAML manuellement.
• Appliquez les mises à jour en un seul clic. Stackhero s’occupe du processus de mise à niveau pour vous, réduisant ainsi les interruptions et les interventions manuelles.
• Performance élevée et sécurité renforcée sont incluses grâce à votre propre infrastructure privée et dédiée.

Mettez votre instance en service en environ 5 minutes. Stackhero s’occupe de l’installation pour que vous puissiez vous concentrer sur la surveillance, pas sur la maintenance. Essayez l’hébergement Prometheus cloud sur Stackhero pour simplifier vos flux de travail de monitoring et d’alerting.

La mise en place du Blackbox Exporter implique de travailler avec deux fichiers clés : blackbox-exporter.yml pour les paramètres de base et prometheus.yml pour définir comment Prometheus extrait les données de l'exporter.

Configuration du cœur de Blackbox Exporter

La configuration de base, trouvée dans le fichier blackbox-exporter.yml, spécifie quels protocoles prendre en charge et comment ils doivent être surveillés.

Sur Stackhero pour Prometheus, ce fichier est préconfiguré pour prendre en charge à la fois la surveillance ICMP et la surveillance HTTP/HTTPS (via les requêtes GET et POST) dès le départ. Si vous avez besoin d'adapter ce fichier pour des scénarios plus avancés, vous pouvez consulter des exemples de configuration dans le répertoire Blackbox Exporter et consulter la documentation officielle pour plus de conseils.

Configuration de la cible de Prometheus Blackbox Exporter

La plupart de votre configuration se fera dans le fichier prometheus.yml, où vous instruisez Prometheus pour extraire des données de Blackbox Exporter comme tout autre exporter.

Par exemple, considérez la configuration ci-dessous qui vérifie les réponses ICMP (ping) de prometheus.io et grafana.com toutes les 15 secondes (comme défini par le scrape_interval). Vous pouvez ajouter ce bloc à votre fichier prometheus.yml dans la section scrape_configs et mettre à jour le tableau targets avec les noms de domaine ou adresses IP que vous souhaitez surveiller :

  - job_name: "blackbox-icmp"
    metrics_path: "/blackbox-exporter/probe"
    params:
      module: [ "icmp" ]
    relabel_configs:
      - source_labels: [ "__address__" ]
        target_label: "__param_target"
      - source_labels: [ "__param_target" ]
        target_label: "instance"
      - target_label: "__address__"
        replacement: "prometheus-blackbox-exporter:9115"
    static_configs:
      - targets: [ "prometheus.io", "grafana.com" ]

De même, la configuration ci-dessous surveille les serveurs HTTP. Dans cette configuration, si le statut de réponse HTTP n'est pas dans la plage 2xx, la cible est signalée comme erronée. Vous pouvez insérer ce bloc dans votre fichier prometheus.yml sous la section scrape_configs et mettre à jour le tableau targets avec les URLs que vous souhaitez surveiller :

  - job_name: "blackbox-http"
    metrics_path: "/blackbox-exporter/probe"
    params:
      module: [ "http_2xx" ]
    relabel_configs:
      - source_labels: [ "__address__" ]
        target_label: "__param_target"
      - source_labels: [ "__param_target" ]
        target_label: "instance"
      - target_label: "__address__"
        replacement: "prometheus-blackbox-exporter:9115"
    static_configs:
      - targets: [ "https://prometheus.io/", "https://grafana.com/" ]

Une fois vos tâches de scraping configurées, vous pouvez consulter les journaux de débogage dans l'interface Blackbox. Le lien vers l'interface est disponible sur votre tableau de bord Stackhero, offrant des informations précieuses sur les résultats des sondages.

Interface Blackbox montrant les résultats des derniers sondages