Prometheus: Prometheus Blackbox Exporterの設定

このドキュメントはBlackbox Exporterガイドの一部です。完全なガイドはこちらからご覧いただけます：Prometheus Blackbox Exporterを使用してHTTPおよびICMP（ping）エンドポイントをプローブする方法。

👋 Stackheroドキュメントへようこそ！

Stackheroは、信頼性とシンプルさを重視したフルマネージドのPrometheusクラウドプラットフォームを提供しています：

• Alert Managerが標準搭載されており、Slack、Mattermost、PagerDutyなどの主要なサービスへ直接アラートをルーティングできます。
• 専用のメールサーバーにより、追加設定なしで無制限のメールアラートを送信可能です。
• Blackboxが含まれており、HTTP、ICMP、TCPなど様々なプロトコルの監視が可能です。
• オンライン設定ファイルエディタでインスタンスを迅速に設定できます。YAMLを手動で管理する必要はありません。
• ワンクリックでアップデートを適用可能。Stackheroがアップグレードプロセスを自動で管理し、ダウンタイムや手動作業を最小限に抑えます。
• 専用のプライベートインフラストラクチャによる高いパフォーマンスと強固なセキュリティを実現しています。

約5分で導入完了。Stackheroがセットアップを担当するため、運用ではなく監視に集中できます。PrometheusクラウドホスティングをStackheroでぜひお試しください。監視・アラート運用を効率化します。

Blackbox Exporterのセットアップには、blackbox-exporter.ymlというコア設定ファイルと、Prometheusがエクスポーターからデータを取得する方法を定義するprometheus.ymlという2つの主要なファイルを使用します。

Blackbox Exporterコアの設定

blackbox-exporter.ymlファイルにあるコア設定では、サポートするプロトコルとその監視方法を指定します。

Stackhero for Prometheusでは、このファイルはICMP監視とHTTP/HTTPS監視（GETおよびPOSTリクエスト経由）をサポートするように事前設定されています。より高度なシナリオに合わせてこのファイルを調整する必要がある場合は、Blackbox Exporterリポジトリの設定例を確認し、公式ドキュメントを参照してください。

Prometheus Blackbox Exporterターゲットの設定

ほとんどの設定はprometheus.ymlファイルで行われ、他のエクスポーターと同様にPrometheusにBlackbox Exporterからデータを取得するよう指示します。

たとえば、以下の設定はprometheus.ioとgrafana.comから15秒ごとにICMP（ping）応答を確認します（scrape_intervalで定義されています）。このブロックをprometheus.ymlファイルのscrape_configsセクションに追加し、監視したいドメイン名やIPアドレスでtargets配列を更新できます。

  - 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" ]

同様に、以下の設定はHTTPサーバーを監視します。この設定では、HTTP応答ステータスが2xx範囲にない場合、ターゲットがエラーとしてフラグされます。このブロックをprometheus.ymlファイルのscrape_configsセクションに挿入し、監視したいURLでtargets配列を更新できます。

  - 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/" ]

スクレイプジョブが設定されたら、Blackbox UIでデバッグログを確認できます。UIへのリンクはStackheroダッシュボードで利用可能で、プローブ結果に関する貴重な洞察を提供します。

最新のスクレイプ結果を示すBlackbox UI