3.15.1　JP1/IM - Agentによる性能監視機能

■ 主な取得項目

Windows exporterの主な取得項目は，Windows exporterのメトリック定義ファイル（初期状態）およびWindows exporter（サービス監視）のメトリック定義ファイル（初期状態）で定義しています。詳細については，マニュアル「JP1/Integrated Management 3 - Manager コマンド・定義ファイル・APIリファレンス」（2.　定義ファイル）の「Windows exporterのメトリック定義ファイル（metrics_windows_exporter.conf）」および「Windows exporter（サービス監視）のメトリック定義ファイル（metrics_windows_exporter_service.conf）」を参照してください。

メトリック定義ファイルには，取得項目を追加できます。定義ファイル内で記述するPromQL文で指定できるメトリックを，次に示します。なお，表内の「コレクタ」の詳細については，表下の「コレクタ」の説明を参照してください。

注※

プロセス名が設定されますが，「.exe」は省略されます。

■ コレクタ

Windows exporterには，CPU，メモリーなどの監視対象のリソースごとに，「コレクタ」と呼ばれる収集処理が内蔵されています。

上記の表に示すメトリックを取得項目として追加する場合は，使用するメトリックに対応するコレクタを有効にする必要があります。また，収集しないメトリックのコレクタを無効にして，不要な収集を抑止することもできます。

コレクタごとの有効・無効化は，Windows exporterのコマンドラインの「--collectors.enabled」オプション，または，Windows exporter設定ファイル（jpc_windows_exporter.yml）の項目「collectors.enabled」で指定できます。

Windows exporterのコマンドラインのオプションについては，マニュアル「JP1/Integrated Management 3 - Manager コマンド・定義ファイル・APIリファレンス」の「サービス定義ファイル（jpc_プログラム名_service.xml）」（2.　定義ファイル）の，「windows_exporterコマンドのオプション」の説明を参照してください。

Windows exporter設定ファイルの項目「collectors.enabled」については，マニュアル「JP1/Integrated Management 3 - Manager コマンド・定義ファイル・APIリファレンス」の「Windows exporter設定ファイル（jpc_windows_exporter.yml）」（2.　定義ファイル）の，項目「collectors」の説明を参照してください。

■ 監視対象サービスの指定

Windows exporterのサービス監視機能を使用する場合，監視する対象のサービスは，Windows exporter設定ファイル（jpc_windows_exporter.yml）の項目「services-where」で指定します。

Windows exporter設定ファイルの項目「services-where」については，マニュアル「JP1/Integrated Management 3 - Manager コマンド・定義ファイル・APIリファレンス」の「Windows exporter設定ファイル（jpc_windows_exporter.yml）」（2.　定義ファイル）の，項目「services-where」の説明を参照してください。

Windows exporterのserviceコレクタが出力するメトリックの，nameラベルの値には，サービス名が設定されます。監視対象のサービス名に半角大文字が含まれる場合，半角小文字に変換して設定されます。全角大文字が含まれる場合，全角小文字に変換して設定されます。

■JP1/IM - Agentのサービスの監視について

JP1/IM - Agentのサービスのサービス名については，マニュアル「JP1/Integrated Management 3 - Manager 運用ガイド」の「10.1 JP1/IM - Agentのサービス」を参照してください。論理ホスト環境の場合のサービス名については，マニュアル「JP1/Integrated Management 3 - Manager 構築ガイド」の「7.3.6 統合エージェントホストでのJP1/IM - Agentの新規インストール（Windowsの場合）」を参照してください。

なお，サービス監視機能で，Prometheus serverとWindows exporterのサービスを監視することはできません。

■ 主な取得項目

Node exporterの主な取得項目は，Node exporterのメトリック定義ファイル（初期状態）およびNode exporter（サービス監視）のメトリック定義ファイル（初期状態）で定義しています。詳細については，マニュアル「JP1/Integrated Management 3 - Manager コマンド・定義ファイル・APIリファレンス」（2.　定義ファイル）の「Node exporterのメトリック定義ファイル（metrics_node_exporter.conf）」および「Node exporter（サービス監視）のメトリック定義ファイル（metrics_node_exporter_service.conf）」を参照してください。

メトリック定義ファイルには，取得項目を追加できます。定義ファイル内で記述するPromQL文で指定できるメトリックを，次に示します。なお，表内の「コレクタ」の詳細については，表下の「コレクタ」の説明を参照してください。

■ コレクタ

Node exporterには，CPU，メモリーなどの監視対象のリソースごとに，「コレクタ」と呼ばれる収集処理が内蔵されています。

上記の表に示すメトリックを取得項目として追加する場合は，使用するメトリックに対応するコレクタを有効にする必要があります。また，収集しないメトリックのコレクタを無効にして，不要な収集を抑止することもできます。

コレクタごとの有効・無効化は，Node exporterのコマンドラインのオプションで指定できます。有効化するコレクタを「--collector.コレクタ名」のオプション，無効化するコレクタを「--no-collector.コレクタ名」のオプションで指定します。

Node exporterのコマンドラインのオプションについては，マニュアル「JP1/Integrated Management 3 - Manager コマンド・定義ファイル・APIリファレンス」の「ユニット定義ファイル（jpc_プログラム名.service）」（2.　定義ファイル）の，「node_exporterコマンドのオプション」の説明を参照してください。

■ 監視対象サービスの指定

Node exporterのサービス監視機能を使用する場合，監視する対象のサービスは，Node exporterのユニット定義ファイル（jpc_node_exporter.service）の項目「services-where」で指定します。このファイルで指定した監視対象のサービスのうち，次のどちらかの条件を満たすサービスのパフォーマンスデータを収集します。

• 監視対象のサービスの自動起動が有効である（systemctl enableを実行している）

• 監視対象のサービスの自動起動が無効であるが，状態が実行中（active）である

自動起動が無効であるサービスのパフォーマンスデータは，サービスが停止している間収集されません。そのため，自動起動が無効で停止しているサービスを監視対象とする場合は，IM管理ノードのツリー情報の作成を行う前に，監視対象のサービスを一度起動してパフォーマンスデータを収集してください。

ユニット定義ファイルについては，マニュアル「JP1/Integrated Management 3 - Manager コマンド・定義ファイル・APIリファレンス」の「ユニット定義ファイル（jpc_プログラム名.service）」（2.　定義ファイル）の，「node_exporterコマンドのオプション」の項目「--collector.systemd.unit-include」の説明を参照してください。

■JP1/IM - Agentのサービスの監視について

JP1/IM - Agentのサービスのユニット定義ファイル名については，マニュアル「JP1/Integrated Management 3 - Manager 運用ガイド」の「10.1 JP1/IM - Agentのサービス」を参照してください。論理ホスト環境の場合のユニット定義ファイル名については，マニュアル「JP1/Integrated Management 3 - Manager 構築ガイド」の「8.3.6 統合エージェントホストでのJP1/IM - Agentの新規インストール（UNIXの場合）」を参照してください。

なお，サービス監視機能で，Prometheus serverとNode exporterのサービスを監視することはできません。

■ 主な取得項目

Process exporterの主な取得項目は，Process exporterのメトリック定義ファイル（初期状態）で定義しています。詳細については，マニュアル「JP1/Integrated Management 3 - Manager コマンド・定義ファイル・APIリファレンス」の「Process exporterのメトリック定義ファイル（metrics_process_exporter.conf）」を参照してください。

メトリック定義ファイルには，取得項目を追加できます。定義ファイル内で記述するPromQL文で指定できるメトリックを，次に示します。

重要

• マルチバイトを含むプロセス名の監視はできません。

• Process exporterは，一度収集した情報に対して，プロセスの停止後も出力を続けます。収集情報にプロセスIDを含めた場合，プロセスが再起動してプロセスIDが変更されるたびに，新しい時系列データが増え，不要なデータが大量に増加します。そのため，バージョン13-00では，デフォルトの収集対象（groupname）にプロセスIDを含みません。同一のコマンドラインのプロセスを分けて管理したい場合は，引数の順番を変えるなどの運用，または，プロセスIDでの運用（ただし，収集情報が増え続けることを避けるために定期的な再起動が必要です）を推奨します。

  なお，Windows exporterは，収集情報にプロセスIDを含むため，Windows exporterの収集情報とは差異があります。

• Process exporterは，監視対象プロセスの監視を行う際にデフォルトでは監視対象プロセスの子プロセスを含めて監視し，子プロセスを含めた稼働情報を取得します。

  子プロセスを含めないようにするためには，Process exporterのユニット定義ファイルを編集する必要があります。

  詳細については，マニュアル「JP1/Integrated Management 3 - Manager 構築ガイド」の「2.19.2(6)(d)子プロセスを監視対象から外す設定（オプション）」を参照ください。

■ 前提条件

Node exporter for AIXが使用するポートは，JP1/IM - AgentのPrometheus server以外からアクセスされないように，ファイアウォールやネットワーク構成などで保護することが前提条件となります。

Node exporter for AIXが使用するポートについては，マニュアル「JP1/Integrated Management 3 - Manager 運用ガイド」の「10.4.2(1)サービスの登録の有効化」の，「node_exporter_aixコマンドのオプション」の説明を参照してください。

■ 監視対象の条件

Node exporter for AIXをインストールするホストのサポートOSについては，リリースノートを参照してください。

WPAR環境はサポート対象外です。

同一ホスト上でNode exporter for AIXの複数起動はサポート対象外です（物理ホストと論理ホストで両方起動する場合も含みます）。

次の条件を満たす場合だけ，監視対象のAIXホストの論理ホスト構成がサポート対象となります。

• Prometheusから監視対象のAIXホストのホスト名が一意に名前解決できる

注　監視対象のAIXホストに複数のIPアドレスが割り当たっている場合，すべてのIPアドレスでNode exporter for AIXにアクセスできます。

1つのPrometheus serverで監視できるNode exporter for AIXの上限については，「付録D.1 インテリジェント統合管理基盤を使用する上での制限値一覧」のJP1/IM - Agentの制限値一覧を参照してください。

■ 主な取得項目

JP1/IM - Agentが同梱するNode exporter for AIXの主な取得項目は，Node exporter for AIXのメトリック定義ファイル（初期状態）で定義しています。詳細については，マニュアル「JP1/Integrated Management 3 - Manager コマンド・定義ファイル・APIリファレンス」の「Node exporter for AIXのメトリック定義ファイル（metrics_node_exporter_aix.conf）」（2.　定義ファイル）を参照してください。

メトリック定義ファイルには，取得項目を追加できます。定義ファイル内で記述するPromQL文で指定できるメトリックを，次に示します。

Node exporter for AIXは，CPU，メモリーなどの監視対象のリソースごとに収集されます。監視対象のリソースごとの収集の有効・無効化は，Node exporter for AIXのコマンドラインのオプションで指定できます。

Node exporter for AIXのコマンドラインのオプションについては，マニュアル「JP1/Integrated Management 3 - Manager 運用ガイド」の「10.4.2(1)サービスの登録の有効化」の，「node_exporter_aixコマンドのオプション」の説明を参照してください。

プロセスの情報の収集には，Script exporterを使用します。設定方法については，マニュアル「JP1/Integrated Management 3 - Manager 構築ガイド」の「1.23.2(4)(e)監視対象ホスト（AIX）上のプロセス監視（オプション）」を参照してください。

監視対象のAIXホストのログファイルの監視には，JP1/Baseのログファイルトラップ機能を使用します。

■ Node exporter for AIXのログに関する注意事項

Node exporter for AIXのログファイルは，OSのシステムログに出力します。そのため，出力先はOSのシステムログの設定に従います。Node exporter for AIXのログを出力するOSのシステムログの出力先を変更する手順については，マニュアル「JP1/Integrated Management 3 - Manager 構築ガイド」の「1.23.2(4)(f)Node exporter for AIXのログ出力先の変更（オプション）」を参照してください。

■ SMTやMicro-Partitioningを使用した環境での注意事項

SMT（Simultaneous multithreading）やMicro-Partitioningを使用した環境では，Node exporter for AIXのCPU使用率（cpu_used_rate）のメトリックの値の計算には物理CPUの割り当て量が含まれませんが，sarコマンドで表示されるCPU使用率の計算には物理CPUの割り当て量が含まれます。

そのため，Node exporter for AIXのCPU使用率（cpu_used_rate）のメトリックの値が，sarコマンドの出力結果より低く表示されることがあります。

■ 主な取得項目

Yet another cloudwatch exporterの主な取得項目は，Yet another cloudwatch exporterのメトリック定義ファイル（初期状態）で定義しています。詳細については，マニュアル「JP1/Integrated Management 3 - Manager コマンド・定義ファイル・APIリファレンス」の「Yet another cloudwatch exporterのメトリック定義ファイル（metrics_ya_cloudwatch_exporter.conf）」（2.　定義ファイル）を参照してください。

■ 収集できるCloudWatchメトリック

「3.15.6(1)(k)Yet another cloudwatch exporterのIM管理ノードの作成」に記載しているJP1/IM - AgentのYet another cloudwatch exporterが監視対象としてサポートするAWSの名前空間名のメトリックを収集できます。

収集するメトリックは，Yet another cloudwatch exporter設定ファイル（jpc_ya_cloudwatch_exporter.yml）に，AWSサービス名およびCloudWatchメトリック名を記述して指定します。

AWS/EC2サービスのCloudWatchメトリックの，CPUUtilizationとDiskReadBytesを収集する場合のYet another cloudwatch exporter設定ファイルの記述例を，次に示します。

discovery:
  exportedTagsOnMetrics:
    ec2:
      - jp1_pc_nodelabel
  jobs:
  - type: ec2
    regions:
      - ap-northeast-1
    period: 60
    length: 300
    delay: 60
    nilToZero: true
    searchTags:
      - key: jp1_pc_nodelabel
        value: .*
    metrics:
      - name: CPUUtilization
        statistics:
        - Maximum
      - name: DiskReadBytes
        statistics:
        - Maximum

Yet another cloudwatch exporter設定ファイルの記述内容については，マニュアル「JP1/Integrated Management 3 - Manager コマンド・定義ファイル・APIリファレンス」の「Yet another cloudwatch exporter設定ファイル（jpc_ya_cloudwatch_exporter.yml）」（2.　定義ファイル）を参照してください。

また，Yet another cloudwatch exporter設定ファイルで設定したメトリックを使用して，Yet another cloudwatch exporterのメトリック定義ファイルに，新たなメトリックを追加することもできます。

定義ファイル内で記述するPromQL文で指定するメトリックおよびラベルは，次に示す名称規則に従ったものを使用します。

■Exporterのメトリックの名称規則

Yet another cloudwatch exporterは，CloudWatchのメトリック名称を，次に示すルールで自動変換したものを，Exporterのメトリック名として扱います。また，PromQL文で指定するメトリックは，Exporterのメトリック名を使用して記述します。

"aws_"^※1＋名前空間^※2＋"_"＋CloudWatchメトリック^※2＋"_"＋統計タイプ^※2

注※1

名前空間が"aws_"で始まらない場合に付加されます。

注※2

Yet another cloudwatch exporter設定ファイル（jpc_ya_cloudwatch_exporter.yml）で設定した名称を示します。次に示すルールで変換されます。

• キャメルケースの表記からスネークケースの表記に変換されます。

  キャメルケースとは，「CamelCase」や「camelCase」のように単語の区切りを大文字にする記法のことです。

  スネークケースとは，「snake_case」のように単語の区切りを"_"にする記法のことです。

• 次に示す記号は"_"に変換されます。

  半角空白，半角コンマ，タブ，/，\，半角ピリオド，-，:，=，全角左二重引用符，@，<，>

• "%"は"_percent"に変換されます。

■Exporterのラベルの名称規則

Yet another cloudwatch exporterは，CloudWatchのディメンション・タグ名称を，次に示すルールで自動変換したものを，Exporterのラベル名として扱います。また，PromQL文で指定するラベルは，Exporterのラベル名を使用して記述します。

• ディメンションの場合

  "dimension"＋"_"＋ディメンションの名称^※

• タグの場合

  "tag"＋"_"＋タグの名称^※

• カスタムタグの場合

  "custom_tag_"＋"_"＋カスタムタグの名称^※

注※

Yet another cloudwatch exporter設定ファイル（jpc_ya_cloudwatch_exporter.yml）で設定した名称を示します。

■ AWSアカウントでのIAMユーザーのポリシーについて

AWS CloudWatchに接続するためは，次に示すアクセス許可のポリシーを作成して，IAMユーザーに割り当てる必要があります。

"tag:GetResources",
"cloudwatch:GetMetricData",
"cloudwatch:GetMetricStatistics",
"cloudwatch:ListMetrics"

JSON形式の情報の設定手順については，マニュアル「JP1/Integrated Management 3 - Manager 構築ガイド」の「2.19.2(8)(b) CloudWatchに接続するための設定を変更する（Linuxの場合）（オプション）」を参照してください。

■ 環境変数HTTPS_PROXY

Yet another cloudwatch exporterからプロキシ経由でCloudWatchに接続する場合に指定する環境変数です。環境変数HTTPS_PROXYに設定できるURLはhttpだけです。なお，サポートする認証方式はBasic認証だけです。

環境変数HTTPS_PROXYを設定することで，プロキシ経由でAWS CloudWatchに接続できます。設定例を次に示します。

HTTPS_PROXY=http://username:password@proxy.example.com:5678

■ JP1/IM - Agentでサポートしていない監視対象の対応方法について

JP1/IM - Agentで監視できない製品やメトリックがある場合は，ユーザー独自のExporterなどを使用してデータを取得する必要があります。

■ 主な取得項目

Promitorの主な取得項目は，Promitorのメトリック定義ファイル（初期状態）で定義しています。詳細については，マニュアル「JP1/Integrated Management 3 - Manager コマンド・定義ファイル・APIリファレンス」の「Promitorのメトリック定義ファイル（metrics_promitor.conf）」を参照してください。

■ 収集できるメトリック

Promitorは監視対象として次に示すサービスのメトリクスを収集できます。

収集するメトリックは，Promitor Scraper設定ファイル（metrics-declaration.yaml）に記述して指定します。

Promitor Scraper設定ファイルに指定するメトリックを変更する場合は，マニュアル「JP1/Integrated Management 3 - Manager 構築ガイド」で，「1.21.2(8)Promitorの設定」の「(d)取得対象の設定（必須）」の「■監視メトリクスの変更（オプション）」を参照してください。

また，Promitor Scraper設定ファイルに設定したメトリックを使用して，Promitorのメトリック定義ファイルに，新たなメトリックを追加することもできます。定義ファイル内で記述するPromQL文に，Promitor Scraper設定ファイルに設定したメトリックを指定できます。

（凡例）

○：オートディスカバリの対象です。

−：オートディスカバリの対象外です。

■ Promitorが使用するAzure SDKのサポート状況の確認

Promitorは，Azure SDK for .NETを使用しています。Azure SDKのサポート終了は12か月前に通知されます。Azure SDKのライフサイクルについては，下記のWebサイトのライフサイクルに関するFAQを参照してください。

https://learn.microsoft.com/ja-jp/lifecycle/faq/azure#azure-sdk-----------

また，Azure SDKのライブラリのバージョンのライフサイクルについては，下記のWebサイトで検索できます。

https://azure.github.io/azure-sdk/releases/latest/all/dotnet.html

■ アカウント情報に必要な権限

PromitorからAzureに接続する方式には，サービスプリンシパル方式とマネージドID方式があります。サービスプリンシパルおよびマネージドIDに割り当てる権限については，マニュアル「JP1/Integrated Management 3 - Manager 構築ガイド」の「1.21.2(8)Promitorの設定」の「(a)Azureに接続するための設定（必須）」を参照してください。

■ 主な取得項目

Blackbox exporterの主な取得項目は，Blackbox exporterのメトリック定義ファイル（初期状態）で定義しています。詳細については，マニュアル「JP1/Integrated Management 3 - Manager コマンド・定義ファイル・APIリファレンス」の「Blackbox exporterのメトリック定義ファイル（metrics_blackbox_exporter.conf）」（2.　定義ファイル）を参照してください。

メトリック定義ファイルには，取得項目を追加できます。定義ファイル内で記述するPromQL文で指定できるメトリックを，次に示します。

■ 監視対象とのIP通信

IPv4通信だけに対応しています。

■ 監視対象との暗号化通信

HTTP監視では，TLSによる暗号化通信を行えます。この場合，Blackbox exporterは，監視対象（TLSサーバ）に対してTLSクライアントとして動作します。

TLSによる暗号化通信を使用する場合は，Blackbox exporter設定ファイル（jpc_blackbox_exporter.yml）の項目「tls_config」で指定します。また，次に示す証明書ファイルおよびキーファイルを，準備する必要があります。

使用できるTLSバージョンと暗号スイートのサポート範囲を，次に示します。

■ 稼働情報の収集に関するタイムアウト

（通常状態で）応答が遅いネットワーク環境では，タイムアウト時間を調整することにより，稼働情報を収集できます。

Prometheus serverでは，Prometheus設定ファイル（jpc_prometheus_server.yml）の項目「scrape_timeout」で，スクレイプ要求のタイムアウト時間を指定できます。

詳細については，マニュアル「JP1/Integrated Management 3 - Manager コマンド・定義ファイル・APIリファレンス」の「Prometheus設定ファイル（jpc_prometheus_server.yml）」（2.　定義ファイル）の，項目「scrape_timeout」の説明を参照してください。

また，Blackbox exporterから監視対象へ接続するときのタイムアウト時間は，上記の「scrape_timeout」で指定した値の0.5秒前となります。

■ 証明書の有効期限

HTTPS監視による稼働情報の収集を行う場合，Exporterは監視対象から証明書リスト（サーバ証明書とサーバ証明書を証明する証明書リスト）を受け取ります。

Blackbox exporterでは，最も期限が近い証明書の有効期限（UNIX時間）を，probe_ssl_earliest_cert_expiryメトリクスとして収集できます。

また，「probe_ssl_earliest_cert_expiryメトリクスの値」−「PromQLのtime()関数の値」の計算値で，期限までの残りの秒数を算出できるため，「3.15.1(3)パフォーマンスデータの監視・通知機能」の機能を使用して，期限が近い証明書を監視できます。

■ HTTP監視時のHTTPリクエストヘッダーのUser-Agentの値

HTTP監視時のHTTPリクエストヘッダーに含まれるUser-Agentのデフォルト値は，次のとおりです。

• バージョン13-00以前の場合

  "Go-http-client/1.1"

• バージョン13-00-01以降の場合

  "Blackbox Exporter/0.24.0"

Blackbox exporter設定ファイル（jpc_blackbox_exporter.yml）の項目「headers」の設定で，User-Agentの値を変更できます。

User-Agentの値を「"My-Http-Client"」に変更する場合の例を，次に示します。

modules:
  http:
    prober: http
    http:
      headers:
        User-Agent: "My-Http-Client"

詳細については，マニュアル「JP1/Integrated Management 3 - Manager コマンド・定義ファイル・APIリファレンス」の「Blackbox exporter設定ファイル（jpc_blackbox_exporter.yml）」（2.　定義ファイル）の，項目「headers」の説明を参照してください。

■ HTTP1.1名前ベースバーチャルホストの対応について

Blackbox exporterは，HTTP1.1名前ベースバーチャルホストおよびTLSのServer Name Indication（SNI）に対応しています。1つのHTTP/HTTPSサーバを複数のHTTP/HTTPSサーバに見せかけた仮想ホストに対する監視ができます。

■ TLSサーバ認証とクライアント認証について

Blackbox exporterのHTTPS監視では，Blackbox exporter設定ファイル（jpc_blackbox_exporter.yml）の項目「ca_file」に記述したCA証明書と，サーバとのHTTPS通信開始時（TLSハンドシェイク時）にサーバが送信したサーバ証明書を使用して，サーバ認証を行います。

送信された証明書が正しくない場合（サーバ名が正しくない，有効期限が切れている，自己証明書を使用している など），HTTPS通信を開始できず，監視はエラーになります。

また，HTTPS通信開始時（TLSハンドシェイク時）に，監視対象サーバから証明書の送信要求があると，Blackbox exporter設定ファイル（jpc_blackbox_exporter.yml）の項目「cert_file」に記述したクライアント証明書を監視対象サーバに送信します。

送信された証明書を，サーバが検証して不正と認識し，TLSプロトコルを通じて，Blackbox exporterにエラーを返却した場合（または，通信の切断などで通信を継続できない場合），監視はエラーになります。

監視対象サーバでの，クライアント証明書に関する検証内容および不正時の動作については，監視対象サーバ（または，ロードバランサなどの中継機器）の仕様を確認してください。

なお，サーバ認証時の証明書に関する不正の検知については，Blackbox exporter設定ファイル（jpc_blackbox_exporter.yml）の項目「insecure_skip_verify」に「true」を指定すると，エラーにならずにHTTPS通信を開始できます。ただし，その場合，サーバでのクライアント認証に関する検証の動作は無効となります。

詳細については，マニュアル「JP1/Integrated Management 3 - Manager コマンド・定義ファイル・APIリファレンス」の「Blackbox exporter設定ファイル（jpc_blackbox_exporter.yml）」（2.　定義ファイル）の，項目「insecure_skip_verify」の説明を参照してください。

Subject Alternative Nameにホスト名が設定されていない証明書では，サーバ認証を行うことができません。

■ Cookie情報について

Blackbox exporterでは，監視対象から送信されてきたCookie情報を，次のHTTP通信のリクエストで使用しません。

■ HTTP通信のレスポンスボディーに含まれるコンテンツから参照する外部リソースについて

Blackbox exporterでは，HTTP通信のレスポンスボディーに含まれるコンテンツから参照する外部リソース（サブフレーム，画像など）は，監視範囲に含めません。

■ HTTP通信のレスポンスボディーに含まれるコンテンツの監視について

Blackbox exporterでは，コンテンツのパース（解析）を行わないため，HTTP通信のレスポンスボディーに含まれるコンテンツ内の構文（HTML，javascriptなど）による実行結果や実行時間は，監視結果に反映されません。

■ HTTP監視の監視先がBasic認証ありでリダイレクトする場合の注意事項

Blackbox exporterのHTTP監視の監視先がBasic認証ありでリダイレクトする場合，Blackbox exporterは，リダイレクト元とリダイレクト先に同じBasic認証のユーザー名とパスワードを送付します。このため，リダイレクト元とリダイレクト先の両方でBasic認証を行う場合，リダイレクト元とリダイレクト先で，同じユーザー名とパスワードを設定しておく必要があります。

■ 主な取得項目

Script exporterの主な取得項目は，Script exporterのメトリック定義ファイル（初期状態）で定義しています。詳細については，マニュアル「JP1/Integrated Management 3 - Manager コマンド・定義ファイル・APIリファレンス」の「Script exporterのメトリック定義ファイル（metrics_script_exporter.conf）」を参照してください。

メトリック定義ファイルには，取得項目を追加できます。定義ファイル内で記述するPromQL文で指定できるメトリックを，次に示します。

■ 監視対象の条件

JP1/IM - Agentが監視対象してサポートとするOracle Databaseの構成を次に示します。

• Oracle Databaseの構成

  • 非クラスタの場合

    非CDB構成およびCDB構成

  • Oracle RACの場合

    CDB構成

OracleDB exporterは，1つのプロセスで1つのサービスに接続するため，監視対象が複数存在する場合は，OracleDB exporterを複数起動します。

注

• Oracle RAC One NodeおよびOracle Database Cloud Serviceはサポート対象外です。

• Oracle Database側のHAクラスタ構成はサポート対象外です。

• データベース・キャラクタ・セット

  Oracle Databaseのデータベース・キャラクタ・セットは次のどれかを設定します。

  • AL32UTF8（Unicode UTF-8）

  • JA16SJIS（日本語 SJIS）

  • ZHS16GBK（簡体字中国語 GBK）

■ 取得項目

JP1/IM - Agentが同梱するOracleDB exporterで取得できるメトリックは，OracleDB exporterのデフォルトで定義されているメトリックとcache_hit_ratioです。

OracleDB exporterの取得項目は，OracleDB exporterのメトリック定義ファイル（初期状態）で定義しています。詳細については，マニュアル「JP1/Integrated Management 3 - Manager コマンド・定義ファイル・APIリファレンス」の「OracleDB exporterのメトリック定義ファイル（metrics_oracledb_exporter.conf）」（2.　定義ファイル）を参照してください。

定義ファイル内で記述するPromQL文で指定できるメトリックを，次の表に示します。各メトリックの値は，Oracle Databaseに対して表内に示すSQL文を実行して取得します。メトリックの詳細を確認する場合は，データソースのSQL文を元にOracle社にお問い合わせください。

注※1

PDB環境では，データ取得元のv$resource_limitのテーブルが空になるため，取得できません。

注※2

PDB環境では，データ取得元のv$waitclassmetricのテーブルが空になるため，取得できません。

重要

• OracleDB exporterを使用する前に，データソースとなるSQL文をSQL*Plusコマンドなどで実行し，必要な情報が表示できることを確認してください。確認の際には，OracleDB exporterからOracle Databaseへの接続に使用するユーザーを使用してください。

• JP1/IM - Agentが提供するOracleDB exporterは，任意のメトリック（カスタムメトリック）を収集する機能をサポートしていません。

■ Oracle Databaseを監視するための条件

OracleDB exporterでOracle Databaseを監視する場合，Oracle Databaseに次の設定が行われている必要があります。

JP1/IM - Agentホスト側にOracle Clientなどをインストールする必要はありません。

• Oracleリスナー

  • Oracleリスナーとサービス名で監視対象に接続できるように設定する。

  • Oracleリスナーは暗号化なしの接続要求を受け付けるように構成する。

• Oracle Database

  Oracle Databaseのデータベース・キャラクタ・セットには次のどれかを設定します。

  • AL32UTF8（Unicode UTF-8）

  • JA16SJIS（日本語SJIS）

  • ZHS16GBK（簡体字中国語GBK）

• Oracle Databaseへのアクセスに使用するユーザー

  • Oracle Databaseへの接続に使用するユーザーに下記の権限を付与されている必要があります。

    ・ログイン権限

    ・次のテーブルへのSELECT権限

    dba_tablespace_usage_metrics

    dba_tablespaces

    v$system_wait_class

    v$asm_diskgroup_stat

    v$datafile

    v$sysstat

    v$process

    v$waitclassmetric

    v$session

    v$resource_limit

  • Oracle Databaseへの接続に使用するユーザー

    ユーザー名に指定できる文字種，最大長については，「■環境変数」を参照してください。

  • Oracle Databaseへの接続に使用するユーザーのパスワード

    パスワードに使用できる文字種を次に示します。

    ・英大文字，英小文字，数字，@，+，'，! ，$，:，.，(，)，~，-，_

    ・パスワードの長さは1から30バイトまでです。

■ Oracle Databaseのパスワードの難読化

JP1/IM - Agentに同梱しているOracleDB exporterでは，OracleDB exporterからOracle Databaseにアクセスするためパスワードを，シークレット難読化機能で管理します。詳細については，「3.15.10 シークレット難読化機能」を参照してください。

■ Oracle Databaseのログファイルに関する注意事項

OracleDB exporterでOracle Databaseを監視すると，ログファイルが大量に生成される場合があります。そのため，Oracle Database管理者は，ログファイルを定期的に削除することを検討する必要があります。

下記に更新日が古い「.trc」または「.trm」ファイルを削除するためのコマンドラインの例を示します。必要に応じて，このようなコマンドを定期的に実行して不要なログを削除するなどを検討してください。

環境変数「$ORACLE_BASE」および「%ORACLE_BASE%」は必要に応じて設定してください。

■ 環境変数

OracleDB exporterを使用する場合は必須で設定する環境変数を，次に示します。

■環境変数「DATA_SOURCE_NAME」（必須）

OracleDB exporterの接続先を次の形式で指定します。デフォルトの値はありません。

• Windowsの場合

oracle://ユーザー名@ホスト名:ポート/サービス名?connection timeout=10[&instance name=インスタンス名]

• Linuxの場合

oracle://ユーザー名@ホスト名:ポート/サービス名?connection timeout=10[&instance name=インスタンス名]

ユーザー名

• Oracleリスナーに接続するためのユーザー名を指定します。最大30文字まで指定できます。

• 英大文字，数字，アンダースコア，ドル記号，シャープ記号，ピリオド，アットマークを使用できます。英小文字は使用できないため，注意してください。

• Linuxの場合，ユニット定義ファイルにユーザー名を記載するときに，シャープ記号を「%%23」に置き換えます。例えば，CDBの共通ユーザーの場合は，「C##USER」を「C%%23%%23USER」として指定します。

• Windowsの場合，サービス定義ファイルにユーザー名を記載するときに，シャープ記号を「%23」に置き換えます。例えば，CDBの共通ユーザーの場合は，「C##USER」を「C%23%23USER」として指定します。

ホスト名

• 監視対象のOracle Databaseホストのホスト名を指定します。最大253文字まで指定できます。

• 英大文字，英小文字，数字，ハイフン，ピリオドを使用できます。

ポート

• Oracleリスナーに接続するためのポート番号を指定します。

サービス名

• Oracleリスナーのサービス名を指定します。最大64文字まで指定できます。

• 英大文字，英小文字，数字，アンダースコア，ハイフン，ピリオドを使用できます。

オプション

次のオプションを指定できます。複数指定する場合は，Windowsでは「&amp;」，Linuxでは「&」でつなげます。

• connection timeout=数字

  コネクションタイムアウトを秒数で指定します。このオプションの指定は必須です。

  必ず10を指定してください。10以外の値を指定，または，このオプションを指定しなかった場合は，Prometheus serverのスクレイプがタイムアウトとなり，OracleDB exporterが稼働している場合でもupメトリックが0になる場合があります。

• instance name=インスタンス名

  接続するインスタンス名を指定します。このオプションの指定は任意です。

（指定例）

oracle://orauser@orahost:1521/orasrv?connection timeout=10

• Windowsの場合

oracle://orauser@orahost:1521/orasrv?connection timeout=10&instance name=orcl1

• Linuxの場合

oracle://orauser@orahost:1521/orasrv?connection timeout=10&instance name=orcl1

■環境変数「DATA_SOURCE_NAME」（必須）

JP1/IM - Agentのインストール先ディレクトリ下のjp1imaディレクトリをフルパスで指定します。

論理ホストの場合は，JP1/IM - Agentの共有ディレクトリ下のjp1imaディレクトリをフルパスで指定します。

（指定例）

• Windowsの場合

C:\Program files\Hitachi\jp1ima

• Linuxの場合

/opt/jp1ima

■ 注意事項

• OracleDB exporterを停止する前に，監視対象のOracle Databaseインスタンスおよびコンテナを停止しようとすると，OracleのNORMALシャットダウンでは終了しない場合があります。事前にOracleDB exporterを停止するか，IMMEDIATEシャットダウンでOracle Databaseを停止してください。

• OracleDB exporterを停止してから，Oracle Databaseインスタンスおよびコンテナの構成変更やメンテナンスを実施してください。

■ 主な取得項目

監視対象が出力するログファイルから数値化する定義は，ログメトリクス定義ファイル（fluentd_任意の名前_logmetrics.conf）で行います。定義によって数値化したデータ（ログメトリクス）が取得項目となります。

ログメトリクス定義ファイルの詳細については，マニュアル「JP1/Integrated Management 3 - Manager コマンド・定義ファイル・APIリファレンス」の「ログメトリクス定義ファイル（fluentd_任意の名前_logmetrics.conf）」を参照してください。

■ サンプルファイル

ログメトリクス機能を使用する場合のサンプルファイルについて説明します。サンプルファイルをコピーして使用する場合は，改行コードに注意してください。改行コードについては，マニュアル「JP1/Integrated Management 3 - Manager コマンド・定義ファイル・APIリファレンス」の「2. 定義ファイル」の各ファイルの説明を参照してください。このサンプルファイルは，下記の「■サンプルファイルの想定条件」に従うサンプルファイルであるため，実際の監視対象に応じて，各ファイルを複製し，設定値を書き換えてください。

■サンプルファイルの想定条件

ここで説明するサンプルファイルは，JP1/IM - Agentがインストールされている監視対象ホスト「HostA」（統合エージェントホスト）が存在し，HostAで稼働しているアプリケーション「WebAppA」が，次に示すログファイルを出力している場合を想定しています。

・ControllerLog.log

対象ログメッセージ1に示すように，WebAppAのHTTPエンドポイントのリクエスト処理の開始時に，そのエンドポイントを利用するというログメッセージが出力される。ログメッセージには，リクエスト処理時に取り扱うレコードの数も出力されている。

＜対象ログメッセージ1＞

：
2022-10-19 10:00:00 [INFO] c.b.springbootlogging.LoggingController : endpoint "/register" started. Target record: 5.
：

サンプルファイルでは，ログメッセージの正規表現を指定することで，対象ログメッセージ1と合致するログメッセージの数を計上し，ログメトリクス1「registerへのリクエスト数」として，JP1/IMの統合オペレーション・ビューアーの［トレンド］タブに表示する。

このログメトリクス1の定義では，ログメトリクスタイプとしてcounterを利用する。

また，ログメッセージの正規表現を指定することで，対象ログメッセージ1から「Target record」の数を抽出して累計し，ログメトリクス2「登録されたレコード数」として，JP1/IMの統合オペレーション・ビューアーの［トレンド］タブに表示する。

このログメトリクス2の定義では，ログメトリクスタイプとしてcounterを利用する。

Fluentdのworker（複数プロセス起動機能）は，監視対象とするログファイルの数だけ用意します。ログメトリクス機能に関するworkerの設定については，マニュアル「JP1/Integrated Management 3 - Manager コマンド・定義ファイル・APIリファレンス」の「ログメトリクス定義ファイル（fluentd_任意の名前_logmetrics.conf）」を参照してください。ここでは，Fluentdのworkerが11個起動しているものとし，ControllerLog.logをFluentdの「workerのid」が10のworkerで監視しているものとします。

また，サンプルファイルでは，次に示すIM管理ノードのツリーを想定しています。

All Systems
└ ホストA
　 └ Application Server
　　　└ WebAppA

■サンプルファイルの対象ファイル

サンプルファイルの対象ファイルを次に示します。

• 統合マネージャーホスト

  ・ユーザー独自のメトリック定義ファイル

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

  ・Prometheus設定ファイル

  ・ユーザー独自のディスカバリ設定ファイル

  ・ログメトリクス定義ファイル

  ・Fluentdのログ監視対象定義ファイル

■「ユーザー独自のメトリック定義ファイル」のサンプルファイル

・ファイル名：metrics_logmatrics1.conf

・記述内容

[
  {
    "name":"logmetrics_request_endpoint_register",
    "default":true,
    "promql":"logmetrics_request_endpoint_register and $jp1im_TrendData_labels",
    "resource_en":{
      "category":"HTTP",
      "label":"request_num_of_endpoint_register",
      "description":"The request number of endpoint register",
      "unit":"request"
    },
    "resource_ja":{
      "category":"HTTP",
      "label":"registerへのリクエスト数",
      "description":"The request number of endpoint register",
      "unit":"リクエスト"
    }
  },
  {
    "name":"logmetrics_num_of_registeredrecord",
    "default":true,
    "promql":"logmetrics_num_of_registeredrecord and $jp1im_TrendData_labels",
    "resource_en":{
      "category":"DB",
      "label":"logmetrics_num_of_registeredrecord",
      "description":"The number of registered record",
      "unit":"record"
    },
    "resource_ja":{
      "category":"DB",
      "label":"登録されたレコード数",
      "description":"The number of registered record",
      "unit":"レコード"
    }
  }
]

注

格納先ディレクトリ，記述内容，およびファイル名は，「ユーザー独自のメトリック定義ファイル（metrics_任意のPrometheusトレンド名.conf）」の形式に従っています。

■「Prometheus設定ファイル」のサンプルファイル

・ファイル名：jpc_prometheus_server.yml

・記述内容

global:
　：
（略）
　：
scrape_configs:
  - job_name: 'LogMetrics'
    
    file_sd_configs:
      - files:
        - 'user/user_file_sd_config_logmetrics.yml'
    
    relabel_configs:
      - target_label: jp1_pc_nodelabel
        replacement: Log trapper(Fluentd)
    
    metric_relabel_configs:
      - target_label: jp1_pc_nodelabel
        replacement: ControllerLog
      - source_labels: ['__name__']
        regex: 'logmetrics_request_endpoint_register|logmetrics_num_of_registeredrecord'
        action: 'keep'
      - regex: (jp1_pc_multiple_node|jp1_pc_agent_create_flag)
        action: labeldrop
 
　：
（略）
　：

注

格納先ディレクトリおよび記述内容は，「Prometheus設定ファイル（jpc_prometheus_server.yml）」の形式に従っています。新規にファイルを作成する必要はなく，インストール時に生成されるPrometheus設定ファイル（jpc_prometheus_server.yml）に，ログメトリクス機能のためのscrape_configsの定義を追加します。

■「ユーザー独自のディスカバリ設定ファイル」のサンプルファイル

・ファイル名：user_file_sd_config_logmetrics.yml

・記述内容

- targets:
  - HostA:24830
  labels:
    jp1_pc_exporter: logmetrics
    jp1_pc_category: WebAppA
    jp1_pc_trendname: logmetrics1
    jp1_pc_multiple_node: "{__name__=~'logmetrics_.*'}"
    jp1_pc_agent_create_flag: false

注

格納先ディレクトリおよび記述内容は，「ユーザー独自のディスカバリ設定ファイル（file_sd_config_任意の名前.yml）」の形式に従っています。

targetsのポート番号は，ControllerLog.logをFluentdの「workerのid」 が10のworkerで監視しているため，下記の「■「ログメトリクス定義ファイル」のサンプルファイル」のportで設定した「24820」に対して，ControllerLog.logを監視しているworkerのポート番号が24820+10=24830となります。

■「ログメトリクス定義ファイル」のサンプルファイル

・ファイル名：fluentd_WebAppA_logmetrics.conf

・記述内容

## Input
<worker 10>
  <source>
    @type prometheus
    bind '0.0.0.0'
    port 24820
    metrics_path /metrics
  </source>
</worker>
##対象ログメッセージ1の抽出
<worker 10>
  <source>
    @type tail
    @id logmetrics_counter
    path /usr/lib/WebAppA/ControllerLog/ControllerLog.log
    tag WebAppA.ControllerLog
    pos_file ../data/fluentd/tail/ControllerLog.pos
    read_from_head true
    <parse>
      @type regexp
      expression /^(?<logtime>[^\[]*) \[(?<loglebel>[^\]]*)\] (?<class>[^\[]*) : endpoint "\/register" started. Target record: (?<record_num>\d[^\[]*).$/
      time_key logtime
      time_format %Y-%m-%d %H:%M:%S
      types record_num:integer
    </parse>
  </source>
 
## Output
##ログメトリクス1とログメトリクス2の定義
  <match WebAppA.ControllerLog>
    @type prometheus
    <metric>
      name logmetrics_request_endpoint_register
      type counter
      desc The request number of endpoint register
    </metric>
    <metric>
      name logmetrics_num_of_registeredrecord
      type counter
      desc The number of registered record
      key record_num
      <labels>
      loggroup ${tag_parts[0]}
      log ${tag_parts[1]}
      </labels>
    </metric>
  </match>
</worker>

注

格納先ディレクトリおよび記述内容は，「ログメトリクス定義ファイル（fluentd_任意の名前_logmetrics.conf）」の形式に従っています。

■「Fluentdのログ監視対象定義ファイル」のサンプルファイル

・ファイル名：jpc_fluentd_common_list.conf

・記述内容

## [Target Settings]
　：
（略）
　：
@include user/fluentd_WebAppA_logmetrics.conf

注

格納先ディレクトリおよび記述内容は，「JP1/IM - Agentの定義ファイル」の「Fluentdのログ監視対象定義ファイル（jpc_fluentd_common_list.conf）」の形式に従っています。新規にファイルを作成する必要はなく，インストール時に生成されるFluentdのログ監視対象定義ファイル（jpc_fluentd_common_list.conf）に，ログメトリクス機能のためのincludeの定義を追加します。

■ 前提条件

Webシナリオ監視機能を使用する場合，次の前提条件があります。

• 前提ブラウザー

  Webシナリオの作成および監視を行うホストには，次のブラウザーを事前にインストールする必要があります。

  • Google Chrome

  • Microsoft Edge

  また，上記のブラウザーから監視対象にアクセスできる必要があります。

  上記のブラウザーは，Webシナリオの作成，および，Webシナリオを使用したWebシナリオ監視で使用します。

• エージェントホスト

  Webシナリオを作成するホスト，および，Webシナリオの監視を行うホストは，同一とすることを推奨します。

  Webシナリオファイルを別ホストに移行する場合は，マニュアル「JP1/Integrated Management 3 - Manager 運用ガイド」の「1.5.1(9)(c) Webシナリオファイルの別ホストへの移行」の手順を実施する必要があります。

  また，Webシナリオ監視機能を使用できるエージェントホストは，Windows版JP1/IM - AgentをインストールしたWindowsホストだけです。

• Web exporter

  Web exporterが使用する待ち受けポートには，JP1/IM - AgentのPrometheus server以外からアクセスされないように，ファイアウォールやネットワーク構成などで保護する必要があります。Web exporterが使用するポートについては，マニュアル「JP1/Integrated Management 3 - Manager コマンド・定義ファイル・APIリファレンス」の「サービス定義ファイル（jpc_プログラム名_service.xml）」（2. 定義ファイル）の，「web_exporterコマンドのオプション」の説明を参照してください。

■ ネットワーク構成

ユーザー操作のWebシナリオに沿って監視するため，監視対象のWebコンテンツを利用するユーザーに近いネットワーク上のホストに，JP1/IM - Agentをインストールすることを推奨します。JP1/IM - Agentから監視対象までのネットワーク経路が，Webコンテンツを利用するユーザーと大きく異なると，中継機器の故障などによる監視異常を検知しにくくなります。

■ 機能一覧

Webシナリオ監視機能は，ユーザーのブラウザー画面での操作を自動再生し，再生時間を計測することで，ユーザーの体感上のレスポンスタイムを監視する機能です。

Webシナリオ監視機能は，Web操作のシナリオに基づいたWeb操作のレスポンスのパフォーマンス情報を収集するWeb稼働情報収集機能と，Web操作のシナリオ（Webシナリオ）の作成を支援するWebシナリオ作成支援機能で構成されます。

■ Webシナリオ作成支援機能

Webシナリオ作成支援機能は，Webシナリオ作成機能を起動すると，ブラウザーを起動し，ユーザーがブラウザーで操作した内容を，Webシナリオとして記録します。

■作成できるシナリオ

次の操作を記録したWebシナリオを使用して，Webコンテンツを監視できます。

• トップページを表示する操作

  トップページを表示する操作だけです。ほかの操作は特にありません。

• ログイン画面でログオンするための操作

  ユーザー名とパスワードを入力し，ログオンボタンをクリックする操作です。

• ログオフ画面でのログオフボタンの操作

■ Webシナリオ作成機能（playwright codegen）

Webシナリオ作成機能は，Web操作のシナリオ（Webシナリオ）の作成を支援する機能を提供します。Webシナリオ作成機能は，OSSのPlaywrightを使用しています。

■前提条件

ユーザーがplaywrightコマンドを手動で実行する際は，カレントフォルダをPlaywrightの作業フォルダとする必要があります。Playwrightの作業フォルダについては，「付録A.4(3) 統合エージェントホスト（Windows）」を参照してください。

Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）を持つユーザーで実行する必要があります。

■Codegenの開始

Webシナリオ作成機能は，PlaywrightのCodegenを使用します。

Codegenを実行するユーザーは，Web exporterの実行ユーザーと同一ユーザーにする必要があります。

playwright codegenコマンドを使用して，Webシナリオ作成機能を実行します。

playwright codegenコマンドは，Webサイトのページを開いて，ユーザーの操作に応じてコードを生成するコマンドです。ユーザーがターミナル上で実行できます。

Webシナリオ作成機能が起動すると，レコーディングが開始します。

npx playwright codegen --target playwright-test --channel チャネル --lang ロケール URL -o ./tests/Webシナリオファイル名

Codegenを実行すると，監視対象のWebサイトとやり取りをするためのブラウザーのウィンドウと，Webシナリオコードの記録を行うPlaywright Inspectorの2つのウィンドウが開きます。

ユーザーがCodegenを実行し，ブラウザーで操作を実行すると，Playwrightは，操作に応じてコードを生成します。

playwright codegenコマンドに指定するパラメーターの詳細については，次に示す表を参照してください。

• npx playwright codegenコマンドのオプション

  項目名	説明	変更可否	JP1/IM - Agentでユーザーが設定する内容	JP1/IM - Agentの初期値
  -o ファイル名 または --output ファイル名	生成したスクリプトをファイルに保存します。	◎	出力先のWebシナリオファイルのファイル名のパスを，コマンド実行ディレクトリからの相対パスで指定します。 指定しない場合，Codegenの終了時に，スクリプトは破棄されます。生成したスクリプトは，ユーザーがテキストファイルなどにコピーする必要があります。 ファイル名には，次の規則があります。 ファイル名は「文字列.spec.ts」の形式で指定する必要があります。 ファイル名に使用できる文字は，半角英数字とアンダースコア（_）だけです。 パラメーターに指定できるバイト数の上限は256バイトです。 ネットワークドライブ上のフォルダおよびファイルは指定できません。指定した場合，ネットワークの障害や遅延の際に，動作を保証できません（Windowsの場合）。 次のようなパス名は指定できません。 ・先頭が「-」（ハイフン）のファイル名 ・環境依存文字を含むフォルダ名またはファイル名 存在しないファイルを指定した場合は，新規にファイルが作成されます。 既に存在するファイル名を指定した場合は，ファイルが上書きされます。 出力したWebシナリオファイルの格納先については，「付録A.4(3) 統合エージェントホスト（Windows）」を参照してください。	./tests/Webシナリオファイル名
  --target 言語	スクリプト生成時の言語を選択します。	△	なし	なし
  --channel チャネル	Chromiumのディストリビューションチャネルを指定します。	◎	Codegenを実行する場合のブラウザーとして，次のどちらかを指定します。 "chrome" Google Chromeを使用する場合に指定します。 "msedge" Microsoft Edgeを使用する場合に指定します。	なし
  --lang 言語	言語とロケールを指定します。 ＜指定例＞ "ja-JP"	◎	テスト実行時の言語コードに合わせて，次のどれかを指定します。 "en-US" "ja-JP" "zh-CN" "th" 指定しない場合，テスト実行時の言語コードと異なる言語コードでWebシナリオが生成され，本来成功するWebシナリオが失敗することがあります。	なし
  --proxy-server プロキシ	プロキシサーバを指定します。 ＜指定例＞ "http://myproxy:3128" "socks5://myproxy:8080"	〇	リクエストに使用されるプロキシを指定します。 ドメイン全体を253文字以内の半角英数字で指定します。	なし
  --proxy-bypass バイパスプロキシ	バイパスするプロキシのコンマ区切りのドメインを指定します。 ＜指定例＞ ".com,chromium.org,.domain.com"	〇	プロキシの迂回用のドメインを253文字以内の半角英数字で指定します。	なし
  URL	監視対象のURLを指定します。	〇	ドメイン全体を253文字以内の半角英数字で指定します。 URLは次の形式で指定します。 プロトコル://ホスト名:ポート番号	なし

（凡例）

◎：設定必須　〇：変更可　△：変更不可

■画面操作の記録

マウスのクリック，文字入力，HTML操作などの操作を記録する場合は，レコーディングが開始済みの状態で，記録したい操作をブラウザーのウィンドウ上で実施します。操作に合わせて，WebシナリオコードがPlaywright Inspectorのウィンドウ上に生成されます。

Webシナリオとして記録し計測できるブラウザーの操作や動作を，次の表に示します。

表3‒38　Webシナリオとして記録し計測できるブラウザーの操作や動作

分類		操作	記録	備考	codegenが記録するコードの例
マウス操作	−	−	−	マウス操作そのものは記録しないが，マウス操作によって発生するボタン操作などとして記録されます。	−
	クリック	〇	〇	−	await page.getByRole('button', { name: 'ログイン' }).click();
	ダブルクリック	〇	〇	−	await page.getByRole('button', { name: 'クリア' }).dblclick();
	副ボタンクリック	〇	〇	−	await page.locator('body').click({ button: 'right' });
キーボード操作（キー入力操作）	−	−	−	−	−
	文字入力	〇	〇	入力中の値はリアルタイムで反映されます。入力後の値がHTML操作などとして記録されます。	await page.locator('input[name="username"]').fill('username');
	ショートカットキー入力	−	−	ブラウザー操作と同じです。	ブラウザー操作と同じです。
	アクセラレートキー入力	−	−
	その他のキー入力	−	−
ブラウザー操作	−	−	−	−	−
	次の項目移動 ［TAB］	〇	〇	HTML内の要素が選択されている場合だけ記録されます。	await page.locator('body').press('Tab');
	前の項目移動 ［Shift］＋［TAB］	〇	〇		await page.locator('body').press('Shift+Tab');
	次のページへ移動 ［Alt］＋［→］	〇	〇	キーボード操作は無効です。ページ遷移は記録されます。	await page.goto('URL');
	前のページへ移動 ［Alt］＋［←］ ［BackSpace］	〇	〇
	コンテキストメニュー表示 ［右クリック］ ［Shit］＋［F10］	〇	〇	−	await page.locator('body').press('Shift+F10');
	上スクロール ［↑］	〇	〇	−	await page.locator('body').press('ArrowUp');
	下スクロール ［↓］	〇	〇	−	await page.locator('body').press('ArrowDown');
	ページ上スクロール ［PageUP］	〇	〇	−	await page.locator('body').press('PageUp');
	ページ下スクロール ［PageDown］	〇	〇	−	await page.locator('body').press('PageDown');
	ページ先頭へ移動 ［HOME］	〇	〇	−	await page.locator('body').press('Home');
	ページ末尾へ移動 ［END］	〇	〇	−	await page.locator('body').press('End');
	中止操作 ［ESC］	〇	〇	−	await page.locator('body').press('Escape');
	リンククリック操作［Enter］ ［クリック］	〇	〇	HTML操作のリンク操作と同じです。ページ遷移は記録されます。	HTML操作のリンク操作と同じです。
	複数選択操作 ［Ctrl］＋［クリック］	〇	〇	−	await page.getByRole('listbox').selectOption(['apple', 'banana', 'orange']);
	切り取り ［Ctrl］＋［X］	〇	〇	−	await page.locator('body').press('Control+x');
	コピー ［Ctrl］＋［C］	〇	〇	−	await page.locator('body').press('Control+c');
	貼り付け ［Ctrl］＋［V］	〇	〇	−	await page.locator('body').press('Control+v');
	すべて選択 ［Ctrl］＋［A］	〇	〇	−	await page.locator('body').press('Control+a');
ダイアログ操作	−	−	−	操作そのものは記録できないことがありますが，ページ遷移は記録します。	await page.goto('URL');
	テキスト入力	〇	※1	−	−
	ボタン操作	〇	※1	−	−
	その他の入力項目	〇	※1	−	−
HTML操作	−	−	−	入力操作，ページ遷移に関係する操作を記録します。	−
	リンク操作	〇	〇	−	−
	INPUT TEXT操作（テキスト入力）	〇	〇	−	await page.getByLabel('Name (4 to 8 characters):').fill('test');
	INPUT PASSWORD操作（パスワード入力）	〇	〇	−	await page.getByLabel('パスワード(8文字以上):').fill('pwdtest1');
	INPUT CHECKBOX	〇	〇	−	await page.getByRole('checkbox').check();
	INPUT RADIO	〇	〇	−	await page.getByLabel('リンゴ').check();
	INPUT SUBMIT	〇	〇	−	await page.getByRole('button', { name: '送信' }).click();
	INPUT RESET	〇	〇	−	await page.getByRole('button', { name: 'フォームをリセット' }).click();
	INPUT BUTTON	〇	〇	−	await page.getByRole('button', { name: 'テスト' }).click();
スクリプト操作	−	−	−	ページ遷移，HTML操作，ボタン操作を伴わないスクリプトの内部処理は記録しませんが，スクリプトの処理によって発生するページ遷移，HTML操作，ボタン操作を記録します。※2	−
	ページ遷移操作	〇	〇	スクリプトの内部で実装している操作そのものは記録できないことがありますが，ページ遷移は記録します。	−

（凡例）

「操作」欄　〇：操作できる　−：該当しない

「記録」欄　〇：記録対象　−：該当しない

上記以外　−：該当しない

注※1

ダイアログに入力された値やボタン押下による操作結果をもとに記録しますが，ダイアログによっては正しく記録できないことがあります。必ず，Webシナリオ作成後に実行を行い，正しく実行できるかどうかを確認してください。

ダイアログが開いたまま停止するなどして，正しくWebシナリオ実行が進まないダイアログには対応できません。

注※2

スクリプトの処理によって発生するページ遷移，HTML操作，ボタン操作のタイミングによっては，記録できないこともあります。

必ず，Webシナリオ作成後に実行を行い，正しく実行できるかどうかを確認してください。

上記の表に記載のない操作や動作については，Webシナリオとして記録し計測することはできません。

なお，ダイアログ表示による認証（テキスト入力がユーザーIDとパスワード以外のもの），およびActiveXコントロール内での認証には対応していません。また，ftpプロトコルをサポートしていません。

■アサートの記録

アサートとは，Webサイトに表示される要素が，期待する内容と一致するかをチェックする操作のことです。Codegenを実行してWebシナリオを作成している際に，ブラウザーのウィンドウに表示される要素をクリックして，Webシナリオにアサートを追加すると，Webシナリオ実行時にブラウザーのウィンドウ上に表示される要素が，Codegenの実行時にブラウザーのウィンドウ上に表示されていた要素と一致するかどうかを判定します。

アサートには，次の種類があります。

• assert visibility

  要素が存在することをアサートします。

• assert text

  要素に特定のテキストが含まれていることをアサートします。

• assert value

  要素に特定の値があることをアサートします。

Webシナリオにアサートを追加する場合は，assert visibility，assert text，assert valueのどれかのボタンをクリックし，アサート対象の要素をブラウザーのウィンドウ上で選択します。選択した要素に対して，アサートを実行するコードがPlaywright Inspectorのウィンドウ上に生成されます。

■レコーディングの一時停止

レコーディングを一時停止する場合は，Recordボタンをクリックします。Recordボタンを再度クリックすると，レコーディングが再開します。

■生成したWebシナリオコードの保存

Webシナリオ作成機能を終了すると，Webシナリオ作成機能の開始時にコマンドラインのオプションで指定したWebシナリオファイルに，生成したWebシナリオが保存されます。

■Codegenの終了

Webシナリオ作成機能を終了するときは，playwright codegenコマンドを実行したターミナルで，［Ctrl］＋［C］キーを押して終了するか，Webシナリオ作成機能の起動時に開いたブラウザーのウィンドウを閉じます。

■Codegen画面の構成

playwright codegenコマンドを使用して，Webシナリオ作成機能を実行すると，次の画面が表示されます。

• ブラウザーのウィンドウ

  Webシナリオの実行対象のWebサイトが表示されます。クリックや入力の操作を，Webページを操作することで記録します。

  Webページの操作の記録に使用するボタンと操作方法を，次の表に示します。詳細については，Playwrightのドキュメントを参照してください。

  項番	ボタン	操作方法
  1	−	タブを移動させる際に，このボタンをドラッグします。
  2	Record	このボタンをクリックすると，レコーディングを停止または再開します。
  3	assert visibility	このボタンをクリックしてから，要素が可視であることをアサートする要素を選択します。 再度このボタンをクリックすると，通常の操作記録に戻ります。
  4	assert text	このボタンをクリックしてから，要素に特定のテキストが含まれていることをアサートする要素を選択します。 再度このボタンをクリックすると，通常の操作記録に戻ります。
  5	assert value	このボタンをクリックしてから，要素に特定の値があることをアサートする要素を選択します。 再度このボタンをクリックすると，通常の操作記録に戻ります。

• Playwright Inspectorのウィンドウ

  Webシナリオのレコーディングができます。

  Webシナリオのレコーディングに使用するボタンと操作方法を，次に示します。詳細については，Playwrightのドキュメントを参照してください。

  項番	ボタン	操作方法
  1	Record	「ブラウザーのウィンドウ」と同じです。
  2	assert visibility	「ブラウザーのウィンドウ」と同じです。
  3	assert text
  4	assert value

■注意事項

1. Webシナリオ作成機能で作成されるWebシナリオを使用して，HTTPのステータスコードを使用した判定はできません。そのため，「404 "Not Found"」や「500 "内部サーバー エラー"」が返却された場合，Webページへの遷移が成功したと判定されることがあります。

2. Webシナリオ作成機能で，Webページが遷移することを確認する場合，次のようなWebシナリオを使用したときは，ページ遷移の成功または失敗を感知できません。

   ＜確認したい動作の例＞

   統合オペレーション・ビューアーのログインページ（URL：'http://ホスト名:20703/login'）で，登録済みのユーザー名とパスワードを入力して，正常にログインできることを確認します。

   ＜CodegenがWebシナリオに出力するコードの例（一部）＞

   test('test', async ({ page }) => {
     await page.goto('http://ホスト名:20703/login');
     await page.locator('input[name="username"]').fill('ユーザー名');
     await page.locator('input[name="password"]').fill('パスワード');
     await page.getByRole('button', { name: 'ログイン'}).click();
   });

   上記のWebシナリオを再生した場合，［ログイン］ボタンをクリックする操作を再生したあと，ログイン後の画面に遷移したかどうかにかかわらず，再生を終了します。そのため，ページ遷移の成功または失敗を感知できません。

   ページ遷移が成功したことを確認する対策は，次のとおりです。

   Codegenのアサートを使用して，ページ遷移後に，そのページに独自の要素が表示されていることをアサートする操作を追加します。

   アサートの記録方法については，「■アサートの記録」を参照してください。

   上記の例を修正したWebシナリオの例を，次に示します。

   ＜CodegenがWebシナリオに出力するコードの例（一部）＞
   test('test', async ({ page }) => {
     await page.goto('http://ホスト名:20703/login');
     await page.locator('input[name="username"]').fill('ユーザー名');
     await page.locator('input[name="password"]').fill('パスワード');
     await page.getByRole('button', { name: 'ログイン' }).click();
     await expect(page.getByRole('button', { name: 'ログアウト' })).toBeVisible();
   });

   上記の修正したWebシナリオの例では，ログインの処理後に遷移するページに，そのページで表示されるはずの［ログアウト］ボタンが表示されていることをアサートする操作を追加しています。［ログアウト］ボタンのアサートに失敗した場合は，ログイン後のページ遷移が失敗したことを検知できます。

3. CodegenでURLの遷移を記録するとき，指定したURLでアクセスした際に，別の新しいURLへ転送（リダイレクト^※）された場合，リダイレクト元へのURL遷移は記録されず，リダイレクト先へのURL遷移だけが記録されることがあります。

   指定したURLのサーバによって，別のURLへリダイレクトされる動作をCodegenで記録した場合は，リダイレクト元から先へのリダイレクトを監視範囲に含めることができません。

   注※

   HTTPステータスコード（300番台）とLocationヘッダーフィールドを使用したHTTPプロトコルで実現するリダイレクトを指します。

   リダイレクト元へのURL遷移は記録されず，リダイレクト先へのURL遷移だけが記録される例を，次に示します。

   • 監視対象サイトの移転などにより，サーバがURLから新しいURLへリダイレクトさせる場合

   • Codegenで指定したURLの末尾にスラッシュ（/）が抜けており，サーバが自動的にスラッシュを追加して正しいURLにリダイレクトした場合

   なお，次に示すようなHTTPプロトコルが関与しないリダイレクトについては，この注意事項に該当せず，リダイレクト元のURL遷移とリダイレクト先のURL遷移が記録されます。

   • HTMLの<meta>要素を使用するHTMLリダイレクト

   • JavaScriptなどのクライアントスクリプトによって，window.locationプロパティにURL文字列を設定することで実行される，JavaScriptのリダイレクト

■ Web稼働情報収集機能（Web exporter）

Web稼働情報収集機能（Web exporter）は，Prometheus serverからのスクレイプ要求を契機に，Webシナリオ実行機能で，事前に作成したWebシナリオファイルのシナリオを実行し，実行結果をスクレイプ結果として返信します。シナリオ実行時の詳細な動きはトレースとして出力し，トレースビューアー機能でユーザーが閲覧できます。

■取得項目

Web exporter（Web稼働情報収集機能）で取得できるメトリックは，probe_webscena_success（稼働情報の収集の成否^※1）とprobe_webscena_duration_seconds（Webシナリオの実行にかかった秒数^※2）です。

注※1

収集のための準備（プロセス起動など）を含めた収集全体の成否を意味します。

注※2

収集に失敗した場合，メトリックの値を取得できないことがあります。

Web exporterの取得項目は，Web exporterのメトリック定義ファイル（metrics_web_exporter.conf）で定義しています。詳細については，マニュアル「JP1/Integrated Management 3 - Manager コマンド・定義ファイル・APIリファレンス」の「Web exporterのメトリック定義ファイル（metrics_web_exporter.conf）」（2. 定義ファイル）を参照してください。

■監視対象を一時的に停止する場合の監視について

停電やメンテナンスで，監視対象を一時的に停止する間，異常検知を抑止するには，該当する監視対象に対する稼働情報の収集を停止する必要があります。

稼働情報の収集は，Web exporterのディスカバリ設定ファイル（jpc_file_sd_config_web.yml）のtargetsで該当する監視対象を削除することで停止できます。詳細については，マニュアル「JP1/Integrated Management 3 - Manager コマンド・定義ファイル・APIリファレンス」の「Web exporterのディスカバリ設定ファイル（jpc_file_sd_config_web.yml）」（2. 定義ファイル）を参照してください。

■ Webシナリオ実行機能

playwrightを使用して，Webシナリオ実行機能を実行します。

Playwright exporter設定ファイルに，Webシナリオ実行機能に関するパラメーターを指定します。

Playwright設定ファイルについては，マニュアル「JP1/Integrated Management 3 - Managerコマンド・定義ファイル・APIリファレンス」の「Playwright設定ファイル（jpc_playwright.config.ts）」（2. 定義ファイル）を参照してください。

■トレース

Webシナリオ実行機能では，Webシナリオ実行時のトレースを，次に示すWeb exporterのトレースファイルに出力します。Webシナリオファイル内の各操作の実行結果やHTTP通信のトレースが出力されます。

• 物理ホストの場合

  Agentパス\logs\web_exporter\trace\Webシナリオファイル名-test-プロジェクト名-リトライ回数_世代番号\trace.zip

• 論理ホストの場合

  共有フォルダ\jp1ima\logs\web_exporter\trace\Webシナリオファイル名-test-プロジェクト名-リトライ回数_世代番号\trace.zip

Webシナリオファイル名

Webシナリオファイル名の末尾が「.spec.ts」である場合は，「.spec.ts」を除いた文字列が格納されます。

プロジェクト名

Playwright設定ファイルのnameパラメーターに指定した文字列が格納されます。

空白，制御文字，および次の文字は，「-」（ハイフン）に変換されます。

! " # $ % & ' ( ) * + , . / : ; < = > ? @ [ \ ] ^ _ { | } ~

リトライ回数

Playwright設定ファイルのretriesパラメーターの値が1以上の場合に使用されます。Webシナリオ実行失敗時のリトライ回数に応じて，retry1，retry2，retry3，・・・の文字列が格納されます。

「-リトライ回数」の部分は，リトライをしたときにだけ付与されます。そのため，スクレイプごとのWebシナリオ初回実行時のトレースには付与されません。

世代番号

4桁の数字が格納されます。

保存するトレースの世代数については，「JP1/Integrated Management 3 - Manager コマンド・定義ファイル・APIリファレンス」の「Web exporter設定ファイル（jpc_web_exporter.yml）」（2. 定義ファイル）の項目「tracenum」を参照してください。

トレースのファイルサイズは数MBです（監視対象のコンテンツの内容によって大きく異なります）。インテリジェント統合管理基盤へのログイン・ログオフを行うWebシナリオの場合は，1シナリオ当たり約2MBです。6分間隔で2000世代，リトライ回数0を保持した場合（デフォルト），約4GBのディスク容量が必要になります。

■トレースビューアー

Web exporterのトレースファイルは，トレースビューアーで参照できます。

トレースビューアーは，異常を検知したときの詳細を調査するときに使用します。

トレースビューアーの詳細については，「3.15.1(1)(n)トレースビューアー機能（playwright show-trace）」を参照してください。

■ ほかの監視機能を組み合わせた監視について

Webシナリオ監視機能は，Webコンテンツに対して，ユーザー視点での監視を行えますが，HTTP通信に関する細かい監視（名前解決の時間や証明書の有効期限）や監視対象側の内部の監視は実施できません。そのため，異常が発生した場合，Webシナリオ監視機能で取得するメトリックの情報だけでは，原因の調査はできません。

上記に対処するには，例えば，Blackbox exporterの外形監視によるHTTP通信の監視や，Fluentdのログ監視機能による監視対象側の内部（HTTPサーバやDBサーバ）の監視を併用する必要があります。

■ TLS通信で使用する公開鍵基盤（PKI：Public Key Infrastructure）の証明書の扱いについて

監視対象がHTTPSサーバの場合，下記の証明書をOSに登録してください（Windowsの場合は証明書ストアに登録します）。

• サーバ証明書を発行した認証局のCA証明書

• クライアント証明書（HTTPSサーバがTLSハンドシェイク時にクライアント証明書を要求する場合）および秘密鍵

OSへの登録方法については，ご使用のOSのドキュメントを参照してください。

■ パスワードを使用するHTTP認証を行うWebシナリオについて

監視対象のWebコンテンツが，ユーザー名とパスワードによるHTTP認証（Basic認証など）を必要とする場合，Webシナリオ作成機能のURLの入力欄に，ユーザー名とパスワードを次のように入力してください。

http://ユーザー名:パスワード@ドメイン名:ポート/Webコンテンツのパス

■ パスワードの扱いについて

HTTP認証およびWebコンテンツ独自の認証（入力フォームでユーザー名とパスワードの入力を要求する場合）で使用するパスワードは，Web exporter設定ファイル，Webシナリオファイル，およびトレースファイルに格納されます。障害調査の資料として依頼先に提供するときは，ユーザーがパスワード部分を別の文字列に置き換えるなどのマスキングをして，漏洩しないように対処してください。

■ HTTPプロキシの設定

JP1/IM - Agentホストから監視対象に通信するために，HTTPプロキシサーバを設定するときは，Playwright設定ファイル（jpc_playwright.config.ts）の項目「proxy」を設定してください。

Playwright設定ファイルの詳細については，マニュアル「JP1/Integrated Management 3 - Manager コマンド・定義ファイル・APIリファレンス」の「Playwright設定ファイル（jpc_playwright.config.ts）」（2. 定義ファイル）を参照してください。

設定ファイルの編集方法については，マニュアル「JP1/Integrated Management 3 - Manager 構築ガイド」の「1.19.3(1)(a) 共通の設定方法」の「設定ファイルを編集する（Windowsの場合）」を参照してください。

■ Webシナリオの確認について

Webシナリオ監視機能では，Webシナリオを単独でテストする機能は提供していません。実際にWebシナリオの監視を行い，正常に監視できることを確認してください。正常か否かは，probe_webscena_successのメトリックを参照してください。

■ タイムアウトの設定とタイムアウトになったときのユーザー作業について

Webシナリオ作成支援機能では，長すぎる稼働情報の収集（Webシナリオ実行時間の収集）に対して，タイムアウトによる中断を行います。

タイムアウトに関するパラメーターを次に示します。

注※1

Prometheus設定ファイルのパラメーターについては，マニュアル「JP1/Integrated Management 3 - Manager コマンド・定義ファイル・APIリファレンス」の「Prometheus設定ファイル（jpc_prometheus_server.yml）」（2. 定義ファイル）を参照してください。

注※2

web_exporterコマンドのオプションについては，マニュアル「JP1/Integrated Management 3 - Manager コマンド・定義ファイル・APIリファレンス」の「サービス定義ファイル（jpc_プログラム名_service.xml）」（2. 定義ファイル）を参照してください。

タイムアウトの設定は必ず適用され，タイムアウト時間を超過したときに収集は中断されます。そのため，収集が中断されずに無限に継続されることはありません。

タイムアウト時間は，scrape_timeoutの時間から--timeout-offset（0.5秒）を減算した時間となります。

このタイムアウト時間は，稼働情報の収集に必要な処理の実行時間を含んだ時間である必要があります。稼働情報の収集には，Webシナリオに従ったWebコンテンツの操作（ブラウザー操作）を含みます。

実際には，ブラウザーやそのほかのプロセスの起動処理があるため，実際のWebシナリオ実行にかかる時間より30秒ほど多めにタイムアウトを設定することを推奨します。

なお，タイムアウトで処理が中断された場合，次に示すどれかのメッセージがログに出力されます。このとき，probe_webscena_successメトリックが0（失敗）となる場合と，メトリックが送信されない場合があります。次に示すログファイルを確認して，タイムアウトで処理が中断していないかを確認してください。

タイムアウトになった場合でも起動した子プロセスは終了するため，ユーザーが終了する必要はありません。

■ 注意事項

• Webシナリオ監視機能では，次に示す監視はできません。

  • JP1/IM - AgentがサポートするブラウザーをサポートしていないWebコンテンツの監視

  • Webシナリオ作成時と異なる動きをするWebコンテンツの監視

  • HTTPステータスコードの監視

  • 認証に外部の認証プロバイダを使用しているWebサイトの監視

• 稼働情報の収集中にタイムアウトが発生した場合，ブラウザーのプロセスが終了せずに残ることがあります。その場合は，ユーザーが該当するプロセスを停止する必要があります。詳細については，「■タイムアウトの設定とタイムアウトになったときのユーザー作業について」を参照してください。

■ 前提条件

VMware exporterが使用するポートは，JP1/IM - AgentのPrometheus server以外からアクセスされないように，ファイアウォールやネットワーク構成などで保護することが前提条件となります。

VMware exporterが使用するポートについては，マニュアル「JP1/Integrated Management 3 - Manager コマンド・定義ファイル・APIリファレンス」の「サービス定義ファイル（jpc_プログラム名_service.xml）」（2. 定義ファイル）の，「vmware_exporterコマンドのオプション」の説明を参照してください。

■ 監視対象の条件

• VMware vCenterServerは監視対象外です。

• VMware exporterの監視対象はVMware ESXiです。サポートするVMware ESXiのバージョンについては，リリースノートを参照してください。

• VMware ESXiで管理するデータストア名^※は，ホスト名と同じ名称にしてください。データストア名とホスト名を別の名称とした場合，データストアとハイパーバイザーでそれぞれ別のノードが作成されてしまい，取得できるメトリックが分断されてしまいます。

  データストアとハイパーバイザーでノードが分かれた場合の各ノードで取得できるメトリックは，下記となります。

  • データストア

    vmware_host_size，vmware_host_used，vmware_host_free，vmware_datastore_used_percent

  • ハイパーバイザー

    vmware_host_size，vmware_host_used，vmware_host_free，vmware_datastore_used_percent以外のhost用メトリック

  各メトリックおよび説明については，マニュアル「JP1/Integrated Management 3 - Manager コマンド・定義ファイル・APIリファレンス」（2. 定義ファイル）の「VMware exporterのホスト用メトリック定義ファイル（metrics_vmware_exporter_host.conf）」および「VMware exporterのVM用メトリック定義ファイル（metrics_vmware_exporter_vm.conf）」を参照してください。

  注※ データストアが複数ある場合は「ホスト名_任意の文字列」としてください。

• VMware ESXiで管理するVM名は重複させないでください。VM名が重複すると，同一ノードに複数の監視結果が表示されてしまい，個別の監視ができなくなるため，VM名は必ずユニークな名前に設定してください。

■ 取得項目

JP1/IM - Agentが同梱するVMware exporterで取得できるメトリックは，VMware exporterのデフォルトで定義されているメトリックです。

VMware exporterの取得項目は，VMware exporterのホスト用メトリック定義ファイルおよびVM用メトリック定義ファイルで定義しています。詳細については，マニュアル「JP1/Integrated Management 3 - Manager コマンド・定義ファイル・APIリファレンス」（2.　定義ファイル）の「VMware exporterのホスト用メトリック定義ファイル（metrics_vmware_exporter_host.conf）」および「VMware exporterのVM用メトリック定義ファイル（metrics_vmware_exporter_vm.conf）」を参照してください。

各メトリックの値は，OSSのpyVmomiを使用し，VMwareが公式に提供しているvRealize Operationsのメトリックを使用して取得しています。各メトリックが使用するvRealize Operationsのメトリックを，次の表に示します。