IBM Cloud Docs
メトリックを送信するための Windows の構成

メトリックを送信するための Windows の構成

IBM Cloudで IBM Cloud Monitoring サービスのインスタンスをプロビジョンした後、Windows の Prometheus バンドルを使用して、Windows システムからメトリックを収集できます。

Windows Prometheus バンドルは、 Prometheus エージェント および Windows Exporter をインストールして構成する包括的なパッケージです。これにより、メトリックを IBM Cloud Monitoring インスタンスに送信できます。

Windows Prometheus バンドルの主要機能

Windows Prometheus バンドルは、以下の機能を提供します。

  • ビジュアル・インストール・ウィザード。

  • コレクターの対話式有効化。

  • Windows サービスとして実行される Prometheus エージェントおよび Windows エクスポーター。

  • IBM Cloud Monitoringで簡単に識別できるように、Windows ドメインおよびインスタンス・ホスト名を使用してエンリッチされたメトリック。

  • Windows ホスト概要、Windows IIS、および Windows SQL Server用にデフォルトで提供されるダッシュボードとアラート。

デフォルト・コレクター

ウィザードを使用してインストールするときにすべてのデフォルトを受け入れると、以下のコレクターが使用可能になります。

デフォルトのコレクター
コレクター 説明
cpu CPU メトリック
cs コンピューター・システム・メトリック
logical_disk ディスクのメトリック
os オペレーティング・システムのメトリック
system システム・メトリック
net ネットワーク・インターフェースのメトリック

Microsoft ISS または Microsoft MSSQL を使用している場合は、ウィザードまたはインストール中のコマンド・ラインで、これらのコレクターを有効にすることができます。 ​ 構成可能なすべてのコレクターは、 Prometheus エクスポーターの資料に記載されています。

構成

Windows システムのモニターを開始するには、以下を実行します。

  1. Windows Prometheus バンドル・バイナリー・インストーラーを 最新プロジェクト・リリース からダウンロードします。

  2. Windows システムでインストーラーを実行します。

  3. ウィザードで、 リモート書き込み用の取り込みエンドポイントモニター API トークン を構成します。

  4. 次へ をクリックします。

  5. 「ホスト構成」 では、ポートまたは IP の値を変更しないでください。 Windows ファイアウォールに必要な追加の CLI フラグ またはリモート IP アドレスを指定します。

  6. 次へ をクリックします。

  7. メトリックの生成を有効にするコレクターを選択します。

    ウィンドウズ・エクスポーターの選択
    の選択

    最もよく使用されるメトリックを選択できます。 追加の Windows Exporter メトリックは、コンマ区切りリストとして追加できます。

  8. Prome制御形式のメトリックは、他のプロセスによってシステム上のファイルに書き込むことができます。 これらのメトリックをエクスポートして IBM Cloud Monitoring に送信するには、 Prometheus metrics from files を選択し、メトリックが配置されているディレクトリーを指定します。

  9. Install をクリックし、Finish をクリックしてインストールを完了する。

  10. IBM Cloud Monitoring インスタンスに移動し、 Microsoft Windows ダッシュボードおよびアラート の使用を開始します。

デフォルトのダッシュボード Windows Host Overview を使用して、Windows メトリックを表示できます。 このデフォルト・ダッシュボードは、 「ダッシュボード」 > 「アプリケーション」 セクションにあります。 Windows Process Overview ダッシュボードは、 process メトリックが有効になっている場合に使用できます。 Windows Services Overview ダッシュボードは、 service メトリックが有効になっている場合に使用できます。 使用可能なデフォルト・アラートについては、 「アラート」 > 「ライブラリー」Windows を検索することもできます。

Windows メトリックス・
の例* Windows メトリックス・
の例* Windows メトリックス・ダッシュボードの例

コマンドラインを使ったインストール

コマンド・ラインまたは PowerShellを使用して、複数のマシンにわたる Windows Prometheus バンドルのインストールを自動化できます。 ​ 例えば、以下のコマンドを使用できます。

msiexec /i windows_exporter-1.0.0-x64.msi ENABLED_COLLECTORS=cpu,os SYSDIG_URL="https://eu-gb.monitoring.cloud.ibm.com/prometheus/remote/write" SYSDIG_TOKEN="yyyyyyy-zzzz-zzzz-zzzz-xxxxxxxx" /qn

このコマンドは、 cpu および os コレクターを含む Windows Prometheus バンドルをインストールします。

コマンド行オプション

以下のコマンド行オプションが使用可能です。

ENABLED_COLLECTORS
コレクター のコンマ区切りのリスト。
SYSDIG_URL
IBM Cloud Monitoring 地域の Prometheus エンドポイント ( https://eu-gb.monitoring.cloud.ibm.com/prometheus/remote/write の形式)。
COMPUTER_NAME
(オプション) Windows エクスポーターによって生成されたメトリック内のラベル instance をカスタム値でオーバーライドします。 デフォルト値は、 COMPUTERNAME Windows 環境変数に保管されているコンピューター名です。
PROMETHEUS_PORT
(オプション) Prometheus ポート。 デフォルト値は 9090です。
WINDOWS_EXPORTER_LISTEN_ADDR
(オプション) Windows エクスポーターの IP アドレス。 デフォルト値は 0.0.0.0です。
WINDOWS_EXPORTER_LISTEN_PORT
(オプション) Windows エクスポーター・ポート。 デフォルト値は 9182です。
WINDOWS_EXPORTER_EXTRA_FLAGS
(オプション): Windows Exporter 追加の CLI フラグ。 デフォルト値は空文字列。
WINDOWS_EXPORTER_FIREWALL_REMOTE_ADDR
(オプション): Windows ファイアウォール例外リスト (許可リスト) のリモート IP アドレスをコンマで区切ったリスト。 デフォルト値は、任意のリモート・アドレスを許可する空ストリングです。
TEXTFILE_DIR
textfile コレクターがファイルを検索するローカル・フォルダー。 これは、 textfile コレクターが有効になっている場合にのみ使用されます。

構成の更新

構成済みのメトリック・コレクターを追加または削除する必要がある場合は、ウィザードを実行し、 「変更」 オプションを選択して、必要な変更を加えることができます。

オプションで、 C:\Program Files\windows_exporter ディレクトリー内の config.yml ファイルを編集できます。 変更を保存した後、 windows_exporter.exe サービスを再始動する必要があります。

バンドルの削除

以下のコマンドを使用して、Windows システムから Windows Prometheus バンドルをアンインストールします。

msiexec /x windows_exporter-1.0.0-x64.msi /qn

ウィザードを実行して 「削除」 オプションを選択することにより、Windows Prometheus バンドルをアンインストールすることもできます。