5.3　トレンド表示とアラートで扱うメトリックの追加

JP1/IM - Agentのトレンド表示とアラートで扱うメトリックを追加できます。

トレンド表示で扱うメトリックについては，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「3.15.6(3)メトリック一覧の返却」および「3.15.6(4)トレンドデータの返却」，アラートで扱うメトリックについては，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「3.15.1(3)パフォーマンスデータの監視・通知機能」を参照してください。

メトリックを追加するための設定手順を，次に示します。

Exporterの設定

追加するメトリックをExporterが収集していない場合，収集するための設定を行います。設定方法はExporterごとに異なります。詳細については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「3.15.1(1)(i)Blackbox exporter（外形監視機能）」，「3.15.1(1)(d)Node exporter（Linux性能情報収集機能）」，「3.15.1(1)(c)Windows exporter（Windows性能情報収集機能）」，および「3.15.1(1)(g)Yet another cloudwatch exporter（Amazon CloudWatch性能情報収集機能）」で，主な取得項目について説明している個所を参照してください。

設定を行ったあと，Exporterを再起動します（Blackbox exporterの場合は，再起動の代わりにリロードを実行してもかまいません）。
Prometheus設定ファイルの編集

Prometheus設定ファイル（jpc_prometheus_server.yml）のスクレイプ定義で，metric_relabel_configsの設定を変更し，PromQL文で使用するExporterのメトリックが削除されないようにします。具体的には，metric_relabel_configsのregexでExporterのメトリック名を羅列している個所に，Exporterで新たに使用するメトリック名を追加します。すでに追加されている場合は追加不要です。

Yet another cloudwatch exporterで「aws_ec2_network_in_average」メトリックを追加する場合の指定例を，次に示します（下線部分を追加します）。
```
- job_name: 'jpc_cloudwatch'
・・・
  metric_relabel_configs:
・・・
    - source_labels: ['__name__','jp1_pc_nodelabel']
      regex: '(aws_ec2_network_in_average|aws_ec2_cpuutilization_average|…);.+$'
action: 'keep'
```
Prometheus設定ファイルの詳細については，マニュアル「JP1/Integrated Management 3 - Manager コマンド・定義ファイル・APIリファレンス」の「Prometheus設定ファイル（jpc_prometheus_server.yml）」（2.　定義ファイル）を参照してください。
アラート設定ファイルの編集（アラートで扱うメトリックを追加する場合）

アラート設定ファイルのアラートの定義にメトリックを追加し，追加したメトリックを使用したPromQL文をアラートの条件式に記述します。

アラート設定ファイルの詳細については，マニュアル「JP1/Integrated Management 3 - Manager コマンド・定義ファイル・APIリファレンス」の「アラート設定ファイル（jpc_alerting_rules.yml）」（2.　定義ファイル）を参照してください。
Prometheus serverのサービスの再起動またはリロード

Prometheus設定ファイルおよびアラート設定ファイルを編集したホストのPrometheus serverのサービスを再起動，または，リロードします。
メトリック定義ファイルの編集（トレンド表示で扱うメトリックを追加する場合）

メトリック一覧の返却機能では，メトリック定義ファイルに定義されているメトリックを返却します。メトリック定義ファイルは，Exporterごとに存在します。メトリックを追加したいIM管理ノードのExporterを確認し，該当するExporterのメトリック定義ファイルに，メトリックの定義を追加します。

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

メトリック定義ファイルを編集したあと，次のどれかの操作を行ったときに，更新したメトリック定義ファイルの情報が反映されます。
- 統合オペレーション・ビューアーで［トレンド］タブを再表示
- 統合オペレーション・ビューアーで［ダッシュボード］を再表示
- JP1/IM - Managerのメトリック一覧取得APIを実行
- JP1/IM - Managerの時系列データ取得APIを実行

ページの先頭へ

5.3 トレンド表示とアラートで扱うメトリックの追加

5.3　トレンド表示とアラートで扱うメトリックの追加