3.15.6　製品プラグイン

(a)　ターゲットとなる構成情報のSIDの種類と使用できる機能

JP1/IM - Agentが作成するIM管理ノードに対応する構成情報のSIDの形式は，監視に使用するアドオンプログラムの種類に応じて異なります。

Exporterの種類ごとの，構成情報のSIDの種類と使用できる機能を，次に示します。

(b)　統合エージェント基盤のSIDの作成条件

インテリジェント統合管理基盤から統合エージェント基盤の構成を取得し，次のSIDを作成します。

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

• 統合エージェント制御基盤SID

ユーザーが，監視対象を監視するためにユーザー独自のPrometheusやユーザー独自のFluentdを使用し，統合エージェントをインストールしていない場合，そのホストの統合エージェント制御基盤SIDは作成しません。

JP1/IM - Managerが階層構成で，統合マネージャーでIM管理ノード作成実行機能が実行された場合，下位マネージャーが管理する構成も取得します。そのため，下位マネージャーのインテリジェント統合管理基盤にアクセスできる必要があります。階層構成のJP1/IM - Managerの前提条件については，インテリジェント統合管理基盤の「3.5.8 複数拠点の監視」を参照してください。

(c)　統合エージェント基盤以外のIM管理ノードの作成条件

JP1/IM - Agentは，統合エージェント基盤以外のIM管理ノードを，JP1/IM - Managerのトレンドデータ管理DBに保存されているトレンドデータから作成します。そのため，ユーザーは，使用するアドオンプログラムのサービスを起動し，1分程度待ったあと^※，IM管理ノードを作成する操作を行います。

注※

Prometheus設定ファイル（jpc_prometheus_server.yml）のscrape_intervalの値を変更している場合は，その値の時間だけ待ってから操作で行います。

jddcreatetreeコマンドの実行時に，トレンドデータ管理DBに保存されていない状態のアドオンプログラム，または，ユーザー独自のPrometheusもしくはFluentdに対するIM管理ノードは作成されません。

次のどちらかに該当する場合，トレンドデータ管理DBにメトリックが保存されていない状態になります。

• アドオンプログラム，または，ユーザー独自のPrometheusもしくはFluentdのサービスを，停止または削除した状態で，トレンドデータ管理DBの保存期間（デフォルト32日）を過ぎる

• アドオンプログラム，または，ユーザー独自のPrometheusもしくはFluentdのサービスを，停止または削除した状態で，トレンドデータ管理DBのサイズ上限によりメトリックが削除される^※

  注※

  トレンドデータ管理DBのメトリックの削除については，「2.7.2(3)トレンドデータの削除」を参照してください。

Yet another cloudwatch exporterを使用する場合，AWS上でタグの設定が必要です。詳細については，「3.15.6(1)(k) Yet another cloudwatch exporterのIM管理ノードの作成」を参照してください。

ユーザー独自のPrometheusまたはFluentdを使用する場合でも，トレンドデータ管理DBにトレンドデータが保存されていればIM管理ノードを作成します。

JP1/IM - Managerが階層構成で，統合マネージャーでIM管理ノード作成実行機能が実行された場合，下位マネージャー配下のIM管理ノードは，下位マネージャーのトレンドデータ管理DBに保存されているトレンドデータから作成します。そのため，下位マネージャーのインテリジェント統合管理基盤にアクセスできる必要があります。また，下位マネージャーのトレンドデータ管理DBにメトリックが保存されている必要があります。

• 階層構成のJP1/IM - Managerの前提条件については，「3.5.8 複数拠点の監視」の「(1)前提条件」を参照してください。

• JP1/IM - Managerが管理する各種情報については，「3.6 WebGUI（統合オペレーション・ビューアー）を使用した運用」の「3.6.1 概要」を参照してください。

(d)　停止中のサービスに対するIM管理ノードの作成と運用

メンテナンスなどの理由により，統合エージェントホスト，アドオンプログラム，または，ユーザー独自のPrometheusやFluentdのサービスを一時的に停止していても，IM管理ノードは作成されます。ただし，トレンドデータベースの保存期間を過ぎる，または，サイズ上限によりメトリックが削除されてしまった場合は，IM管理ノードは作成されなくなります。意図せずIM管理ノードが削除された場合，サービスを起動してメトリックがトレンドデータ管理DBに保存された状態でIM管理ノードのツリー情報の作成と反映操作を行うことで，再びIM管理ノードが作成されるようになります。

(e)　構成の変更または削除におけるIM管理ノードの作成と運用

アドオンプログラム，または，ユーザー独自のPrometheusやFluentdに対して，構成の変更または削除を行っても，トレンドデータ管理DBからそれらのメトリックが削除されないかぎり，構成の変更前または削除前のIM管理ノードが作成されます。構成の変更前または削除前のIM管理ノードを作成しない手順については，マニュアル「JP1/Integrated Management 3 - Manager 構築ガイド」の「1.21.2(16) IM管理ノードのツリー情報の作成と反映（Windowsの場合）（必須）」および「2.19.2(17) IM管理ノードのツリー情報の作成と反映（Linuxの場合）（必須）」を参照してください。

(f)　プロパティ表示

JP1/IM - Managerの統合オペレーション・ビューアーのノード詳細領域に，JP1/IM - AgentのIM管理ノードのプロパティを表示します。

JP1/IM - AgentがIM管理ノードのプロパティとして設定する値を，次に示します。なお，ここに記載しないSIDにはプロパティを設定しません。

（凡例）

−：該当なし

注※1

各プロパティの値が255文字を超える場合，256文字目以降は切り捨てて表示します。

注※2

JP1/IM - Agentが同梱するBlackbox exporterのIM管理ノードの場合だけ表示します。

注※3

Yet another cloudwatch exporterのメトリックに，「dimension_任意の文字列」ラベルが存在しない場合は登録しません。複数存在する場合は，その数だけ登録します。

Prometheusのホスト名

PrometheusSIDまたはAlertmanagerSIDの場合，Prometheus serverがセットアップされているホスト名を設定します。それ以外の場合，IM管理ノードに対応するExporterをスクレイプしているPrometheus serverのホスト名を設定します。

スクレイプジョブ名

Prometheus設定ファイル（jpc_prometheus_server.yml）のscrape_configsで，job_nameに設定している値が入ります。

jp1_pc_exporterの値

Prometheus設定ファイル（jpc_prometheus_server.yml）のscrape_configsで，jp1_pc_exporterに設定している値が入ります。値が設定されていない場合は，「Unknown Exporter」が入ります。

jp1_pc_moduleの値

Prometheus設定ファイル（jpc_prometheus_server.yml）のscrape_configsで，paramsのmoduleに設定している値が入ります。

アカウント文字列

AWS定義ファイル（aws_settings.conf）で指定した，監視するアカウントIDに対応するAWSアカウント文字列の値が入ります。

リージョン名

Yet another cloudwatch exporterのメトリックに含まれるregionラベルの値が入ります。

AWS名前空間名

Yet another cloudwatch exporterのメトリック定義ファイル（metrics_ya_cloudwatch_exporter.conf）に設定している，SIDに対応するトレンドデータのメトリックの，cloud_srvメンバーに設定されている値が入ります。

jp1_pc_addon_program

Fluentdの監視定義ファイルでjp1_pc_addon_programに設定している値が入ります。値が設定されていない場合は，「Fluentd」が入ります。

(g)　構成情報のSIDの形式

JP1/IM - Agentが作成するIM管理ノードに対応する構成情報のSIDの形式を，次に示します。

URLエンコードした文字列が255を超える場合は，ターゲットとなる構成情報のSIDの構造化IDを分割します。255文字目までを構造化IDの名称に設定し，残りの文字列を下位の構造化IDの名称に設定します。

Pホスト名

Prometheus serverがセットアップされているホストのホスト名を，URLエンコードした文字列です。

Eホスト名

Exporterがセットアップされているホストのホスト名を，URLエンコードした文字列です。

Iホスト名

監視対象ホストのホスト名を，URLエンコードした文字列です。

Blackbox exporter（ICMP監視）のディスカバリ設定ファイル（file_sd_config_blackbox_icmp.yml）で，targetsにIPアドレスを指定した場合，リモート監視ホストSIDとリモートエージェントSIDのIホスト名はIPアドレスとなります。

Fluentdの場合，監視定義ファイルのinstanceに指定した値です。

jp1_pc_nodelabel

Prometheus設定ファイル（jpc_prometheus_server.yml）のscrape_configsで，jp1_pc_nodelabelに設定している値をURLエンコードした文字列です。

EC2ホストSID，EC2のCloudWatchSID，EC2以外のCloudWatchSIDの場合，AWSのリソースのjp1_pc_nodelabelに設定した値をURLエンコードした文字列です。

Fluentdの場合，監視定義ファイルのjp1_pc_nodelabelに設定した値をURLエンコードした文字列です。

jp1_pc_remote_monitor_instance

ディスカバリ設定ファイルで，jp1_pc_remote_monitor_instanceに設定している値の「:」（コロン）より後ろの文字列をURLエンコードした文字列です。relabel_configsでjp1_pc_remote_monitor_instanceの値を変更している場合は，変更後の値をURLエンコードした文字列です。

jp1_pc_nodelabel_fluentd

Fluentdの監視定義ファイルのjp1_pc_nodelabel_fluentdに設定した値をURLエンコードした文字列です。

AWS名前空間名

Yet another cloudwatch exporterのメトリック定義ファイル（metrics_ya_cloudwatch_exporter.conf）で，cloud_srvメンバーに指定した値です。スラッシュ（/）は，ハイフン（-）に変更して指定します。

Azureサービス名

Azure監視のメトリック定義ファイルで，cloud_srvメンバーに指定した値です。

コンポーネント名

コンテナ監視のメトリック定義ファイルで，moduleメンバーに指定した値です。

構成情報のSIDの文字列（先頭の「JP1PC」はJP1/IM - Agentで固定文字列）の意味を，次に示します。

(h)　統合エージェントごとのIM管理ノード

統合エージェントが同梱するExporterの種類に応じて，作成するIM管理ノードが異なります。Exporterの種類ごとのIM管理ノードの作成可否を，次に示します。

（凡例）

〇：IM管理ノードを作成する

−：IM管理ノードを作成しない

注※1

JP1/IM - Manager（インテリジェント統合管理基盤）に直接接続する場合が該当します。

注※2

Prometheus設定ファイル（jpc_prometheus_server.yml）で指定する内容に応じて，作成する場合と作成しない場合があります。

(i)　ツリーの形式

JP1/IM - Managerの統合オペレーション・ビューアーのツリーに表示する内容は，監視に使用するExporterの種類に応じて異なります。

JP1/IM - Managerの統合オペレーション・ビューアーでは，JP1/IM - Agentが作成するIM管理ノードは，次に示すツリーで表示されます。

All Systems
├ BizSystem※1
│  ├ 統合マネージャーホスト名
│  │ └ Management Applications※2
│  │    ├ Metric forwarder(Prometheus server)※3
│  │    ├ Alert forwarder(Alertmanager)※4
│  │    ├ AWS metric collector(Yet another cloudwatch exporter)※6
│  │    ├ Synthetic metric collector(Blackbox exporter)※6
│  │    └ Azure metric collector(Promitor)※6
│  ├ 監視対象ホスト名またはコンテナ名
│  │ ├ Management Applications※2
│  │ │ ├ JP1/IM agent control base※7
│  │ │ ├ Metric forwarder(Prometheus server)※3
│  │ │ ├ Alert forwarder(Alertmanager)※4
│  │ │ ├ Linux metric collector(Node exporter)※5
│  │ │ ├ Windows metric collector(Windows exporter)※5
│  │ │ ├ Synthetic metric collector(Blackbox exporter)※6
│  │ │ ├ Linux process metric collector(Process exporter)※5
│  │ │ ├ Script metric collector(Script exporter)※5
│  │ │ ├ jp1_pc_nodelabelの値※8
│  │ │ └ Log trapper(Fluentd)※9
│  │ ├ Platform※2
│  │ │ ├ Linux metric collector(Node exporter)※10
│  │ │ ├ Windows metric collector(Windows exporter)※10
│  │ │ └ jp1_pc_nodelabelの値※10
│  │ ├ Service※2
│  │ │ ├ サービス名※24
│  │ │ └ ユニットファイル名※25
│  │ ├ Enterprise※2
│  │ │ ├ SAP Syslog extractor(jr3lget)※26
│  │ │ └ SAP CCMS Alert extractor(jr3alget)※26
│  │ ├ jp1_pc_categoryで指定したカテゴリ※11
│  │ │ └ jp1_pc_nodelabelの値※12
│  │ └ jp1_pc_categoryで指定したカテゴリ※2
│  │    └ jp1_pc_nodelabelの値※13
│  ├ 監視対象のホスト名またはIPアドレス※14
│  │ └ Platform※2
│  │    └ Synthetic metric collector(Blackbox exporter(ICMP))※15
│  ├ HTTP/HTTPSで監視するホストのホスト名※16
│  │ └ ServiceResponse※2
│  │    └ jp1_pc_nodelabelの値※15
│  ├ AWS上のホストのホスト名※17
│  │ └ Platform※2
│  │    ├ AWS metric collector(Yet another cloudwatch exporter)※18
│  │    └ Yet another cloudwatch exporter
│  ├ 監視対象のホスト名※27
│  │ ├ Management Applications※2
│  │ │ └ AIX metric collector(Node exporter for AIX)※5
│  │ └ Platform※2
│  │    └ AIX metric collector(Node exporter for AIX)※10
│  ├ Azure上のホストのホスト名※20
│  │ └ Platform※2
│  │    └ Promitor※21
│  └ SAPシステムのインスタンス名※28 ※29
│     └ Enterprise※2 ※28
│        ├ SAP Syslog※28
│        └ SAP CCMS Alert※28
├ JP1/IM - Agentホスト
│  └ Management Applications
│     └ OracleDB metric collector(OracleDB exporter)※30
├ Oracle Databaseホスト
│  └ Database
│     ├ 監視対象（任意の名称）※31
│     │         ：
│     └ 監視対象（任意の名称）
├ Amazon Simple Storage Service
│   └ ストレージ名※19
│ ：
├ Kubernetes
│  ├ Clusters
│  │ └ クラスタ名※22
│  ├ Namespaces
│  │ └ Namespace名※22
│  ├ DaemonSets
│  │ └ DaemonSet名※22
│  ├ StatefulSets
│  │ └ StatefulSet名※22
│  ├ ReplicaSets
│  │ └ ReplicaSets名※22
│  ├ CronJobs
│  │ └ CronJob名※22
│  │ Pods
│  │ └ Pod名※22
│  └ Nodes
│     └ ノード名※22
├ Azure Kubernetes Service
│  └ クラスタ名※23
│ ：
└ システム名
    └ リソース名

注※1

システムノードを示します。ユーザーがシステムノードを定義している場合に作成されます。

注※2

カテゴリを示します。

注※3

PrometheusSIDを示します。

注※4

AlertmanagerSIDを示します。

注※5

エージェントサービスSIDを示します。

注※6

リモート監視サービスSIDを示します。

注※7

統合エージェント制御基盤SIDを示します。

注※8

エージェントサービスSID（ユーザー独自のExporter）を示します。

注※9

ログ監視サービスSIDを示します。

注※10

エージェントSIDを示します。

注※11

カテゴリ（ユーザー独自のExporter，Script exporter，ログメトリクス）を示します。

注※12

エージェントSID（ユーザー独自のExporter，Script exporter，ログメトリクス）を示します。

注※13

ログ監視対象のSIDを示します。

注※14

Blackbox exporter（ICMP監視）のディスカバリ設定ファイル（file_sd_config_blackbox_icmp.yml）のtargetsで，ホスト名を指定した場合はホスト名，IPアドレスを指定した場合はIPアドレスが表示されます。

注※15

リモートエージェントSIDを示します。

注※16

エージェントホストSIDを示します。

注※17

EC2ホストSIDを示します。

ラベルには，AWSのjp1_pc_nodelabelタグに設定されている文字列が表示されます。

注※18

EC2のCloudWatchSIDを示します。

注※19

EC2以外のCloudWatchSIDを示します。

EC2以外のIM管理ノードの場合，「JP1CS-AWS名前空間名」をオブジェクトルートノード種別としたオブジェクトルートノードを作成します。

ラベルには，AWSのjp1_pc_nodelabelタグに設定されている文字列が表示されます。

注※20

AzureVMホストSIDを示します。

ラベルには，メトリクスのjp1_pc_nodelabelに設定されている文字列が表示されます。

注※21

AzureVMのAzureMonitorSIDを示します。

注※22

KubernetesのSIDを示します。

「JP1CS-コンポーネント名」をオブジェクトルートノード種別としたオブジェクトルートノードを作成します。

クラスタ以外のコンポーネントの場合，ラベルには，メトリクスのjp1_pc_nodelabelに設定されている文字列が表示されます。

クラスタは，メトリクスにjp1_pc_prome_clusternameが存在する場合にIM管理ノードが表示されます。ラベルにはjp1_pc_prome_clusternameに設定されている文字列が表示されます。

注※23

AzureVM以外のAzureMonitorSIDを示します。

VM以外のIM管理ノードの場合，「JP1CS-Azureサービス名」をオブジェクトルートノード種別としたオブジェクトルートノードを作成します。

ラベルには，メトリクスのjp1_pc_nodelabelに設定されている文字列が表示されます。

注※24

エージェントSID（Windows環境でサービス監視を行っている場合）を示します。

サービス監視（Windows環境）のIM管理ノードのラベル名（jp1_pc_nodelabelの値）には，Windowsの管理ツールのサービス画面で，サービスのプロパティを開いたときに「サービス名：」に表示される値を設定します。サービス名に半角大文字が含まれる場合，半角小文字に変換して設定します。全角大文字が含まれる場合，全角小文字に変換して設定します。jp1_pc_nodelabelの値の長さの上限は，URLエンコードしたときの文字列で234バイトです（すべてマルチバイト文字の場合の上限は26文字です）。上限を超える場合，Prometheus設定ファイル（jpc_prometheus_server.yml）のmetric_relabel_configsで，jp1_pc_nodelabelの値を変更する必要があります。設定方法については，マニュアル「JP1/Integrated Management 3 - Manager 構築ガイド」の「1.21.2(3)(g)IM管理ノードのラベル名（jp1_pc_nodelabelの値）が上限を超える場合の設定をする（Windowsの場合）（オプション）」を参照してください。

注※25

エージェントSID（Linux環境でサービス監視を行っている場合）を示します。

サービス監視（Linux環境）のIM管理ノードのラベル名（jp1_pc_nodelabelの値）には，サービス監視（Linux環境）のユニットファイル名（Systemdに登録しているユニットファイルのファイル名）を設定します。jp1_pc_nodelabelの値の長さの上限は，URLエンコードしたときの文字列で234バイトです（すべてマルチバイト文字の場合の上限は26文字です）。上限を超える場合，Prometheus設定ファイル（jpc_prometheus_server.yml）のmetric_relabel_configsで，jp1_pc_nodelabelの値を変更する必要があります。設定方法については，マニュアル「JP1/Integrated Management 3 - Manager 構築ガイド」の「2.19.2(3)(g)IM管理ノードのラベル名（jp1_pc_nodelabelの値）が上限を超える場合の設定をする（Linuxの場合）（オプション）」を参照してください。

注※26

SAPシステム監視のメトリック送信機能（Script exporter）で作成されるノードです。

注※27

AIXのホスト名を示します。

注※28

SAPシステム監視のメトリック送信機能（Fluentd）で作成されるノードです。

注※29

SAPシステム監視のログ監視機能（Fluentd）で監視するSAPシステムのインスタンス名を示します。テキスト形式のログファイルの監視定義ファイルの項目「instance」に設定されるホスト名が表示されます。

注※30

複数プロセスを起動した場合でも1つだけ表示します。

注※31

CDB構成の場合，デフォルトのツリー表示では，ルートコンテナとPDBはで順不同で同列に表示されます。

エージェントSID，リモートエージェントSID，および，ログ監視対象のSIDについては，監視対象ごとにツリーSIDを作成します。監視対象を複数の異なるアドオンプログラムで監視する場合，１つのツリーSIDで表示します。ツリーSIDは同一になります。例えば，Blackbox exporterでWebサーバを外形監視し，そのWebサーバのログをFluentdでログ監視した場合，同一のツリーSIDになります。

次の値がすべて同じ場合，同じ監視対象と判定します。

• 監視対象ホストのホスト名（構成情報のSIDの，_HOST_の名称）

• IM管理ノードのラベル名

• IM管理ノードのカテゴリID

■IM管理ノードのラベル名とカテゴリIDについて

ラベル名とカテゴリIDの値をユーザーが設定するのは，監視方法が次の場合です。それ以外の監視方法のラベル名とカテゴリIDについては，上記のツリーの表示を参照してください。

• Blackbox exporterのHTTP/HTTPS監視の場合

  ディスカバリ設定ファイルのtargetsにラベル名を設定し，jp1_pc_categoryにカテゴリIDを設定します。

• ユーザー独自のExporterの場合

  Prometheus設定ファイル（jpc_prometheus_server.yml）のスクレイプ定義で，jp1_pc_nodelabelにラベル名を設定し，ユーザー独自のディスカバリ設定ファイルのjp1_pc_categoryにカテゴリIDを設定します。

• Fluentdのログ監視の場合

  テキストファイルの監視定義ファイルまたはWindowsイベントログの監視定義ファイルの[Metric Settings]セクションで，jp1_pc_nodelabelにラベル名を設定し，jp1_pc_categoryにカテゴリIDを設定します。

イベント一覧，トレンド情報表示などのJP1/IM - Managerの機能について，同一のツリーSIDが存在する場合，すでに作成済みのツリーSIDの付与情報に対して，新たに作成したツリーSIDの付与情報は，次の表のように対処されます。

(j)　コンテナ環境でのIM管理ノードの表示

コンテナ内に，統合エージェント，または，ユーザー独自のPrometheusやFluentdをインストールする場合，統合オペレーション・ビューアーでは，コンテナ名がホスト名としてツリーで表示されます。

(k)　Yet another cloudwatch exporterのIM管理ノードの作成

Yet another cloudwatch exporterのメトリック定義ファイル（metrics_ya_cloudwatch_exporter.conf）に設定しているメトリックのうち，Yet another cloudwatch exporterで監視が行われている，かつ，AWS上でjp1_pc_nodelabelタグが設定されたリソースに対して，IM管理ノードを作成します。

JP1/IM - AgentのYet another cloudwatch exporterが監視対象としてサポートするAWSの名前空間を，次に示します。

注※

AWS CloudWatchが，メトリクスをディメンションごとに分類した分類名です。CloudWatchのWebページで確認できます。

Yet another cloudwatch exporterで監視対象を指定する方法には，Auto-discovery configurationとstatic configurationの2種類がありますが，JP1/IM - Agentでは，Auto-discovery configurationで監視対象を指定しているリソースに対してだけ，IM管理ノードを作成できます。CloudWatch上で確認できるリソース全体やグループ化されたメトリックに対しては，IM管理ノードを作成しません。

なお，AWS上で，IM管理ノードの作成対象のリソース，またはリソースに設定されているjp1_pc_nodelabelタグを削除した場合，IM管理ノードは作成されなくなります。

また，タグの編集が終わってから，タグの情報がCloudWatchに反映されるまで，10分程度待つ必要があります。

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

Yet another cloudwatch exporterを使用して監視を行う場合は，監視したいリソースのメトリックがCloudWatchで表示されていることを確認した上で，Prometheeus serverとYet another cloudwatch exporterのサービスを起動したあと，Prometheus設定ファイル（jpc_prometheus_server.yml）の項目「scrape_interval」に設定した時間（デフォルト：1分）が経過してから，jddcreatetreeコマンドおよびjddupdatetreeコマンド（構成変更モード（-cオプション）を指定）を実行してください。コマンドの実行後は，統合オペレーション・ビューアーのツリーに表示されるYet another cloudwatch exporterのIM管理ノードに過不足がないかを確認します。

表示されるIM管理ノードに過不足がある場合の対処方法については，マニュアル「JP1/Integrated Management 3 - Manager 運用ガイド」の「12.5.3(73)Yet another cloudwatch exporterのIM管理ノードが作成されない」を参照してください。

(l)　複数のスクレイプ定義で同じ監視対象を監視する構成について

Blackbox exporterおよびYet another cloudwatch exporterは，インストール先でないホストやリソースをリモートで監視するExporterです。同じExporterの複数のスクレイプ定義で同じ監視対象を監視したり，リモートで監視する同じExporterを別々のホストにセットアップして同じ監視対象を監視したりする設定をサポートしていません。設定した場合，統合オペレーション・ビューアーに表示されるIM管理ノードのツリーSIDが同一になります。そのため，［トレンド］タブで表示するトレンドデータは，どのExporterが収集した値か不定になります。

(m)　IM管理ノードとメトリックのラベルについて

「3.15.6(1)(c)統合エージェント基盤以外のIM管理ノードの作成条件」に示すとおり，トレンドデータ管理DBに保存されているトレンドデータからIM管理ノードを作成します。トレンドデータにはメトリックの情報が含まれており，メトリックごとにラベルが付与されています。

メトリックに付与するラベルは，次の定義ファイルで設定します。

• ディスカバリ設定ファイル

  Exporterごとの共通のラベルを設定します。詳細については，マニュアル「JP1/Integrated Management 3 - Manager コマンド・定義ファイル・APIリファレンス」（2.　定義ファイル）の各Exporterのディスカバリ設定ファイルを参照してください。

• Prometheus設定ファイル

  ディスカバリ設定ファイルで設定できないラベルやメトリックごとにラベルの値を変更する必要があるラベルを設定します。詳細については，マニュアル「JP1/Integrated Management 3 - Manager コマンド・定義ファイル・APIリファレンス」の「Prometheus設定ファイル（jpc_prometheus_server.yml）」（2.　定義ファイル）を参照してください。

(n)　JP1資源グループの設定について

JP1/IM - Agentが作成するIM管理ノードについては，JP1資源グループの設定を行いません。JP1資源グループによる参照・操作の制限を行いたい場合はシステムノード定義ファイル（imdd_systemnode.conf）でJP1資源グループを設定したシステムを定義し，JP1/IM - Agentのホストを割り当ててください。

システムノード定義ファイル（imdd_systemnode.conf）の詳細については，「システムノード定義ファイル（imdd_systemnode.conf）」（2.　定義ファイル）を参照してください。

(a)　前提条件

JP1/IM - Agentは，JP1/IM - Managerのトレンドデータ管理DBに保存しているパフォーマンスデータから，トレンドデータを作成して返却します。統合エージェントの機能を使用して，パフォーマンスデータをトレンドデータ管理DBに保存していない場合は，トレンドデータを返却できません。

JP1/IM - Managerが階層構成で，統合マネージャーでトレンド情報表示機能が実行された場合，下位マネージャー配下のIM管理ノードは，下位マネージャーのトレンドデータ管理DBに保存されているパフォーマンスデータから，トレンドデータを作成して返却します。そのため，下位マネージャーのインテリジェント統合管理基盤にアクセスできる必要があります。また，下位マネージャーのトレンドデータ管理DBにパフォーマンスデータが保存されている必要があります。

• 階層構成のJP1/IM - Managerの前提条件については，「3.5.8 複数拠点の監視」の「(1)前提条件」を参照してください。

• JP1/IM - Managerが管理する各種情報については，「3.6 WebGUI（統合オペレーション・ビューアー）を使用した運用」の「3.6.1 概要」を参照してください。

(b)　インスタンス名（グラフの凡例として表示する文字列）

• メトリックに，次に示す名前のラベルとメトリック定義ファイルのdrop_legend_labels^※1で指定したラベル以外のラベルが設定されている場合，そのラベル名のメンバーを持つオブジェクトをJSON形式に変換し，先頭の「{」と末尾の「}」を削除した文字列をインスタンス名として返却します（例：「"core":"0,0","mode":"idle"」）。次に示す名前のラベルとメトリック定義ファイルのdrop_legend_labels^※1で指定したラベル以外のラベルを設定されていない場合は，インスタンス名を返却しません。

  __name__，instance，job，jp1_pc_nodelabel，jp1_pc_prome_hostname，jp1_pc_exporter，jp1_pc_remote_monitor_instance，jp1_pc_category，jp1_pc_trendname，jp1_pc_module，jp1_pc_rm_agent_create_flag，jp1_pc_agent_create_flag，jp1_pc_multiple_node，jp1_pc_nodelabel_fluentd，jp1_pc_addon_program，account_id^※2，region^※2，name^※2

  注※1

  メトリック定義ファイルのdrop_legend_labelsについては，マニュアル「JP1/Integrated Management 3 - Manager コマンド・定義ファイル・APIリファレンス」の「Node exporterのメトリック定義ファイル（metrics_node_exporter.conf）」（2.　定義ファイル）を参照してください。

  注※2

  Yet another cloudwatch exprorerの場合にだけ該当します。

• インスタンス名が249文字を超える場合，250文字目以降を削除します。

• インスタンス名とする249文字目までが同じになる文字列が複数存在する場合，末尾に項番「#n」（n=1,2,3…）を付与します。

(c)　取得するパフォーマンスデータについて

JP1/IM - Managerのトレンドデータ管理DBに保存されているパフォーマンスデータの中で，どのパフォーマンスデータをトレンドデータとして返却するかは，メトリック定義ファイルのpromqlに設定するPromQL文で指定します。

promqlの初期値については，マニュアル「JP1/Integrated Management 3 - Manager コマンド・定義ファイル・APIリファレンス」（2.　定義ファイル）の，各Exporterのメトリック定義ファイルについて説明している個所で，各メトリックの設定内容（初期状態）を記載している表の「メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）」の説明を参照してください。

PromQL文に関する注意事項については，マニュアル「JP1/Integrated Management 3 - Manager コマンド・定義ファイル・APIリファレンス」の「PromQL文に関する注意事項」（2.　定義ファイル）を参照してください。

メトリック定義ファイルのpromqlの値に含まれる文字列「$jp1im_TrendData_labels」は，パフォーマンスデータを取得するときに，取得対象を絞り込むためのPromQL文に置き換えられます。例えば，次のようにpromqlの値に「$jp1im_TrendData_labels」を含む文字列を指定することで，トレンドデータを返却するIM管理ノードのパフォーマンスデータだけを，トレンドデータとして取得できます。

■promqlに指定する文字列

(windows_memory_available_bytes and $jp1im_TrendData_labels) / (1024*1024)

■「$jp1im_TrendData_labels」の置き換え後の文字列

(windows_memory_available_bytes and {jp1_pc_prome_hostname="Prometheusのホスト名",job="スクレイプジョブ名",instance="instanceラベルの値"}) / (1024*1024)

なお，promqlの値に「$jp1im_TrendData_labels」が含まれない場合，取得対象が絞り込まれず，正しくトレンドデータが返却されないことがあります。

また，「$jp1im_TrendData_labels」の置き換え後の文字列は，IM管理ノードによって異なります。詳細については，マニュアル「JP1/Integrated Management 3 - Manager コマンド・定義ファイル・APIリファレンス」の「Node exporterのメトリック定義ファイル（metrics_node_exporter.conf）」（2.　定義ファイル）に記載している「■$jp1im_TrendData_labelsの置き換え」の説明を参照してください。

JP1/IM - Managerが階層構成で，統合マネージャーでトレンド情報表示機能が実行された場合，下位マネージャー配下のIM管理ノードについても統合マネージャーのメトリック定義ファイルに設定されている必要があります。

(d)　インスタンスごとのデータ数の上限について

インスタンスごとのデータ数の上限値は，JP1/IM - Managerから引数で渡されます。インスタンスごとの返却データは，「収集期間の時間数÷インスタンスごとのデータ数の上限値」の間隔で返却します。インスタンスごとの返却データの数は，引数の上限値を超えず，このメソッドの戻り値「countPerInstance」は，常に「false」になります。

(e)　パフォーマンスデータの時刻について

トレンドデータは，パフォーマンスデータごとに時刻を設定して返却しますが，この時刻は，パフォーマンスデータを収集，格納した時刻ではなく，開始時刻から終了時刻までを等間隔で刻んだ時刻となります。等間隔の時間は，「（時系列データ取得APIの終了時刻−時系列データ取得APIの開始時刻）÷インスタンス当たりのデータ数の上限」により算出します。統合オペレーション・ビューアーの［トレンド］タブでトレンドデータを表示した場合，インスタンス当たりのデータ数の上限は60となります。

■統合オペレーション・ビューアーの［トレンド］タブに表示するトレンドデータの時刻の例

前提条件を次に示します。

• Prometheus serverがトレンドデータを収集した時刻

  1つ目のデータの収集時刻：2022/02/19 12:15:00

  2つ目のデータの収集時刻：2022/02/19 12:16:00

  3つ目のデータの収集時刻：2022/02/19 12:17:00

  　　：

• 統合オペレーション・ビューアーの［トレンド］タブで表示するトレンドデータの時刻の範囲

  開始時刻：2022/02/19 12:15:30

  終了時刻：2022/02/19 13:15:30

統合オペレーション・ビューアーの［トレンド］タブでトレンドデータを表示した場合，インスタンス当たりのデータ数の上限は60であるため，前提条件より，表示範囲の開始時刻から終了時刻までの時間（終了時刻−開始時刻）は60分，等間隔の時間（（終了時刻−開始時刻）÷インスタンス当たりのデータ数の上限）は1分となります。

これにより，統合オペレーション・ビューアーの［トレンド］タブに表示するトレンドデータの時刻（返却するトレンドデータに設定する時刻）は，次に示すとおり，表示範囲の開始時刻を起点とした1分刻みの時刻となります。

1つ目のデータの表示時刻：2022/02/19 12:15:30

2つ目のデータの表示時刻：2022/02/19 12:16:30

3つ目のデータの表示時刻：2022/02/19 12:17:30

　　：

(f)　収集したパフォーマンスデータとトレンドデータの関係

トレンドデータの返却機能では，指定した収集期間の中で，一定の収集間隔で収集するパフォーマンスデータに対して，一定の出力間隔で過去5分間に収集したパフォーマンスデータがトレンドデータとして出力します。過去5分間に収集したパフォーマンスデータが前回の出力時と同じデータの場合は，そのデータで補完してトレンドデータを出力します。過去5分間に収集したパフォーマンスデータが存在しない場合は，データを補完しません。

また，Exporterが停止しているなど，パフォーマンスデータが収集できない場合は，トレンドデータを出力しません。

(g)　トレンドデータの出力期間に未来の期間が含まれる場合の注意事項

トレンドデータの出力期間に未来の期間が含まれると，トレンドデータの返却機能の使用時刻（現在時刻）より未来の期間に出力されたトレンドデータの出力時刻は，未来の時刻となります。トレンドデータの出力時刻が未来の時刻となることを抑止したい場合は，トレンドデータの出力期間に未来の期間を含めないようにしてください。

(h)　アラートとトレンドデータの関係

アラートルールの評価は，Prometheusがパフォーマンスデータを収集した時点で行うため，アラートの通知時刻は，アラートの評価を行ったパフォーマンスデータの収集時刻となります。アラートの通知時刻でトレンドデータを突き合わせるときは，出力時刻が未来方向に直近のトレンドデータと突き合わせる必要があります。

(i)　メトリック値のリセットについて

OSの再起動によって，パフォーマンスデータがリセットされるメトリックがあります。このようなメトリックをトレンド表示する際，表示期間にOSの再起動が含まれていた場合，瞬間的に飛びぬけた値（大きな値，小さな値，またはマイナスの値）が表示されたり，グラフが極端な変化を示したりすることがあります。

このような場合は，OSの再起動などが行われていないか確認し，該当する時間帯のデータは無視するようにしてください。

(a)　パフォーマンスデータを監視して発行するJP1イベントの属性

パフォーマンスデータを監視して，アラートの異常条件を満たしたとき，または，満たさなくなったときに発行するJP1イベントの属性に設定される値を，次に示します。属性は，次に示すもの以外はJP1/IM - Agentと共通です。JP1/IM - Agentの属性については，マニュアル「JP1/Integrated Management 3 - Manager コマンド・定義ファイル・APIリファレンス」の「3.2.3(1) パフォーマンスデータを監視して発行するJP1イベントの属性」を参照してください。それ以外の属性の値については，マニュアル「JP1/Integrated Management 3 - Manager コマンド・定義ファイル・APIリファレンス」で，「5.6.4 イベント発行」のAPIの説明を参照してください。

注

すべての拡張属性値の合計の長さの上限は10,000バイトです。

(a)　ファイル名

• hitachi_jp1_pccs2_alert_attr_ja.conf（日本語）

• hitachi_jp1_pccs2_alert_attr_en.conf（英語）

(b)　属性

JP1/IM - Agentが発行するJP1イベントの属性の詳細については，「3.15.6(5)(a)パフォーマンスデータを監視して発行するJP1イベントの属性」を参照してください。