Hitachi

JP1 Version 13 JP1/Integrated Management 3 - Manager コマンド・定義ファイル・APIリファレンス


Blackbox exporter(HTTP/HTTPS監視)のディスカバリ設定ファイル(jpc_file_sd_config_blackbox_http.yml)

〈このページの構成〉

形式

YAML形式で記述します。

- targets:
  - 監視対象ホスト名:IM管理ノードのラベル名:URL
  ・・・
  labels:
    jp1_pc_exporter: JPC Blackbox Exporter
    jp1_pc_category: serviceResponse
    jp1_pc_trendname: blackbox_exporter
    jp1_pc_remote_monitor_instance: インストールホスト名: Synthetic metric collector(Blackbox exporter)

ファイル

jpc_file_sd_config_blackbox_http.yml

jpc_file_sd_config_blackbox_http.yml.model(モデルファイル)

file_sd_config_blackbox_httpで始まるモジュール名.yml(ユーザーが作成)

格納先ディレクトリ

■統合エージェントホスト

Windowsの場合

  • 物理ホストのとき

    Agentパス\conf\

  • 論理ホストのとき

    共有フォルダ\jp1ima\conf\

Linuxの場合

  • 物理ホストのとき

    /opt/jp1ima/conf/

  • 論理ホストのとき

    共有ディレクトリ/jp1ima/conf/

説明

Prometheus serverがHTTP/HTTPS監視でスクレイプするBlackbox exporterを設定するファイルです。

Blackbox exporter設定ファイル(jpc_blackbox_exporter.yml)に,HTTP/HTTPS監視を行うモジュールを新たに定義した場合は,このディスカバリ設定ファイルのモデルファイルをコピーし,監視対象に応じて,次の名称でディスカバリ設定ファイルを作成します。

file_sd_config_blackbox_モジュール名.yml

Blackbox exporterで監視を行う場合の設定については,マニュアル「JP1/Integrated Management 3 - Manager 構築ガイド」の「1.21.2(6) Blackbox exporterの設定」を参照してください。

文字コード

UTF-8(BOM無し)

改行コード

Windowsの場合:CR+LF

Linuxの場合:LF

定義の反映時期

Prometheus serverのリロードAPIを実行,または,再起動したとき,Prometheus serverがスクレイプする対象となります。そのあと,jddcreatetreeコマンドおよびjddupdatetreeコマンドを実行したとき,統合オペレーション・ビューアーのツリーの表示内容に反映されます。

記述内容

- 監視対象ホスト名:IM管理ノードのラベル名:URL

監視対象ホスト名IM管理ノードのラベル名URLは,「:」(コロン)で区切って指定します。

監視対象ホスト名は,1〜255文字の制御文字以外の文字で,監視対象のWebサーバのホスト名を指定します。FQDN形式も指定できます。「localhost」は指定できません。

IM管理ノードのラベル名は,1〜255文字の「:」(コロン)および制御文字を含まない文字で,統合オペレーション・ビューアーのIM管理ノードのラベル名に表示する文字列を指定します。URLをエンコードしたときの文字列が,234バイト以内(すべてマルチバイト文字の場合の上限は26文字)となるようにしてください。

URLは,1〜2,083文字の制御文字以外の文字で,監視するURLを指定します。URLに含まれるホスト名の代わりにIPアドレスを指定することもできますが,IPアドレスを指定した場合,監視対象の証明書の検証を有効にすることはできません(Blackbox exporter設定ファイル(jpc_blackbox_exporter.yml)のtls_configのinsecure_skip_verifyに「false」を設定することはできません)。また,Blackbox exporter設定ファイル(jpc_blackbox_exporter.yml)のtls_configのinsecure_skip_verifyに「true」を設定するため,次に示すメトリックを監視できません。

  • probe_ssl_last_chain_expiry_timestamp_seconds

定義例

- targets:
  - hostB: Metric forwarder(Prometheus server) healthy:http://hostB:20713/-/healthy
  - hostB: Alert forwarder(Alertmanager) healthy:http://hostB:20714/-/healthy
  labels:
    jp1_pc_exporter: JPC Blackbox Exporter
    jp1_pc_category: serviceResponse
    jp1_pc_trendname: blackbox_exporter
    jp1_pc_remote_monitor_instance: hostA: Synthetic metric collector(Blackbox exporter)