2.7.2　トレンドデータ管理DB

■ ユースケース「月次で削除対象のトレンドデータ（時系列データ）を出力・保存」

次のことを実施します。

1. 時系列データ取得のAPIに指定する，IM管理ノードのSIDおよびメトリックを，事前にリスト化する。

   ●出力対象のJP1/IM - AgentのSIDの確認

   IM管理ノード情報取得のAPIなどを利用して，時系列データを出力するJP1/IM - AgentのSIDを確認します。

   JP1/IM - AgentのSIDは，PrometheusSID（_JP1PC-IMB_統合エージェント管理基盤のホスト名/_JP1PC-M_Pホスト名/_HOST_Pホスト名/_PROMETHEUS_）やエージェントSID（_JP1PC-IMB_統合エージェント管理基盤のホスト名/_JP1PC-M_Pホスト名/_JP1PC-AHOST_Iホスト名/_HOST_Iホスト名/_JP1PC-A_jp1_pc_nodelabel）のノードから特定します。

   Pホスト名：Prometheus serverがセットアップされているホストのホスト名

   Iホスト名：監視対象ホストのホスト名

   jp1_pc_nodelabel：Prometheus設定ファイル（jpc_prometheus_server.yml）のscrape_configsで，jp1pc_nodelabelに設定している値

   IM管理ノード情報取得のAPIの詳細については，マニュアル「JP1/Integrated Management 3 - Manager コマンド・定義ファイル・APIリファレンス」の「5.8.3　IM管理ノード情報取得」を参照してください。

   Windowsのコマンドプロンプト上で，OSSのcurlコマンドを利用して，IM管理ノード情報取得のAPIを実行する場合のイメージを，次に示します。

   ・ログインのAPIを実行

   curl -XPOST -H "Content-Type: application/json" -c 出力先のテキストファイルAのパス -d "{\"user\":\"JP1ユーザー名\",\"password\":\"パスワード\"}" http://ホスト名:20703/im/api/v1/login

   ・IM管理ノード情報取得のAPIを実行

   curl -GET -H "Content-Type: application/json" -b テキストファイルAのパス http://ホスト名:20703/im/api/v1/nodes/configInfo

   ・IM管理ノード情報取得のAPIの実行結果（JSON形式）

   {"simtData": [{ "sid":"XXXX/XXXX", "value":{"component":"/HITACHI/JP1/XXXX","visible":"true","label":"XXXX"} },{ ・・・・ },{ "sid":"YYYY/YYYY/YYYY", "value":{ ・・・・ "methods":[・・・,"__metricListGet","__timeSeriesDataGet",・・・], ・・・・} },{ ・・・・ }] }

   ●出力できるメトリックの確認

   メトリック一覧取得のAPIなどを利用して，時系列データのメトリック名を確認します。

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

   Windowsのコマンドプロンプト上で，OSSのcurlコマンドを利用して，メトリック一覧取得APIを実行する場合のイメージを，次に示します。

   ・ログインAPIの実行例

   curl -XPOST -H "Content-Type: application/json" -c 出力先のテキストファイルAのパス -d "{\"user\":\"JP1ユーザー名\",\"password\":\"パスワード\"}" http://ホスト名:20703/im/api/v1/login

   ・メトリック一覧取得APIの実行例

   curl -XPOST -H "Content-Type: application/json" -b テキストファイルAのパス -d "{\"sid\":\"JP1/IM - AgentのSID\"}" http://ホスト名:20703/im/api/v1/nodes/metrics

   ・メトリック一覧取得APIの実行結果の例（JSON形式）

   {"metrics":[ { "name":メトリック名, "default":デフォルトの設定, "label":メトリック表示名, "description":"メトリックの説明" } { ・・・・ } ]}

2. 時系列データ取得APIに，JP1/IM - AgentノードのSID，メトリック，および出力対象期間（開始日時と終了日時）を指定して実行する

   ●トレンドデータの取得

   時系列データ取得のAPIを利用して，トレンドデータ（時系列データ）のメトリック名を取得します。時系列データ取得のAPIは，SIDとメトリックの組み合わせで実行するため，トレンドデータを出力したいJP1/IM - AgentノードのSIDまたはメトリックが複数ある場合は，SID数×メトリック数の回数の実行が必要です。

   時系列データ取得のAPIの詳細については，マニュアル「JP1/Integrated Management 3 - Manager コマンド・定義ファイル・APIリファレンス」の「5.11.2　時系列データ取得」を参照してください。

   なお，時系列データ取得のAPIで取得できるデータ数の上限は，30,000個です。例えば，1インスタンス当たりのデータ数が1個の場合，毎分×1か月（31日）のデータを出力すると，データ数は44,640個となるため，出力対象期間を2回に分割して取得する必要があります。分割の要否や分割数は，データの間隔，出力対象期間，およびメトリックの内容（1インスタンス当たりのデータ数）に依存します。

   また，時系列データ取得のAPIでは，JSON形式でデータを取得できるため，JSON形式のデータからトレンドデータを取り出す必要があります。

   具体的には，"timeSeriesData"の"data"に，「{"time":日時のデータ,"value":その日時における（メトリックの）値},」という形式で格納されているため，「日時のデータ」と「その日時における（メトリックの）値」のデータを抽出する必要があります。

   時系列データ取得APIのリクエストとレスポンスの例を，次に示します。

   ・時系列データ取得APIのリクエストの例

   POST http://ホスト名:20703/im/api/v1/nodes/timeSeries { "sid":"_JP1PC-IMB-IMMHOST/_JP1PC-M_IMAHOST/_HOST_IMAHOST/_PROMETHEUS_", "metric": "cpu_used_rate", "startTime": "2021-06-01T00:00:00Z", "endTime": "2021-06-15T23:59:59Z", "countPerInstance":1, "instanceCount":30000 }

   ・時系列データ取得APIのレスポンスの例

   < HTTP/1.1 200 OK < Content-Type: application/json { "metric":"cpu_used_rate", "timeSeriesData":[ { "unit":"%", "data":[ {"time":"2021-06-01T00:00:00Z","value":14.04}, ・・・ ] ], "exceedCountDetected": { "countPerInstance": false, "instanceCount": false } }

   Windowsのコマンドプロンプト上で，OSSのcurlコマンドを利用して，時系列データ取得APIを実行し，1か月分のデータを2回に分けて出力する場合のイメージを，次に示します。

   ・ログインAPIの実行例

   curl -XPOST -H "Content-Type: application/json" -c 出力先のテキストファイルAのパス -d "{\"user\":\"JP1ユーザー名\",\"password\":\"パスワード\"}" http://ホスト名:20703/im/api/v1/login

   ・時系列データ取得APIの実行例＜1回目＞

   curl -XPOST -H "Content-Type: application/json" -b テキストファイルAのパス -d "{\"sid\":\"JP1/IM - AgentのSID\", \"metric\":\"メトリック名\", \"startTime\":\"2021-06-01T00:00:00Z\", \"endTime\":\"2021-06-15T23:59:59Z\", \"countPerInstance\":30000, \"instanceCount\":1}" http://ホスト名:20703/im/api/v1/nodes/timeSeries

   ・時系列データ取得APIの実行結果の例（JSON形式）＜1回目＞

   {"metric": "cpu_used_rate", "timeSeriesData":[ {"unit":"%", "data":[ {"time":"2021-06-01T00:00:00Z","value":10.480632}, ・・・・ ]} ], "exceedCountDetected":{"countPerInstance":false,"instanceCount":false} }

   ・時系列データ取得APIの実行例＜2回目＞

   curl -XPOST -H "Content-Type: application/json" -b テキストファイルAのパス -d "{\"sid\":\"JP1/IM - AgentのSID\", \"metric\":\"メトリック名\", \"startTime\":\"2021-06-16T00:00:00Z\" \"endTime\":\"2021-06-30T23:59:59Z\", \"countPerInstance\":30000, \"instanceCount\":1}" http://ホスト名:20703/im/api/v1/nodes/timeSeries

   ・時系列データ取得APIの実行結果の例（JSON形式）＜2回目＞

   {"metric": "cpu_used_rate", "timeSeriesData":[ {"unit":"%", "data":[ {"time":"2021-06-16T00:00:00Z","value":9.560327}, ・・・・ ]} ], "exceedCountDetected":{"countPerInstance":false,"instanceCount":false} }