1.19.3　エージェントとしてJP1/IM - Agentを使用する場合の設定

(a)　共通の設定方法

(b)　統合エージェント管理基盤の設定変更（Windowsの場合）

統合エージェント管理基盤（imbase，imbaseproxy）の設定変更の手順を，次に示します。

(c)　IM管理ノードのツリー情報の作成と反映（Windowsの場合）（必須）

次に示す手順で，IM管理ノードのツリー情報の作成と反映を行います。

1. 統合エージェントホストで行う手順を実施する。

   「1.21.2(16) IM管理ノードのツリー情報の作成と反映（Windowsの場合）（必須）」の手順1〜4を実施します。

2. JP1/IM - ManagerのjddcreatetreeコマンドまたはIM管理ノード関連情報の生成APIを実行する。

   実行に失敗した場合は，メッセージの内容に従って対処を行い，再度実行します。

3. アドオンプログラム，または，ユーザー独自のPrometheusもしくはFluentdの構成変更や削除を行った場合に，下記の「■IM管理ノード関連ファイルの編集」に記載するIM管理ノード関連ファイルの編集を行う（新規構築時には実施不要です）。

4. JP1/IM - Managerのjddupdatetreeコマンド（構成変更モード）またはIM管理ノード関連情報の反映APIを実行する。

   実行に失敗した場合，メッセージの内容に従って対処を行い，再度実行します。

5. 統合オペレーション・ビューアーを表示し，正しくIM管理ノードが作成されているか確認する。

   正しく作成されていない場合，作成されていない統合エージェント，アドオンプログラム，ユーザー独自のPrometheusまたはFluentdの設定内容を見直し，再度，手順2以降を実施します。

■IM管理ノード関連ファイルの編集

アドオンプログラム，または，ユーザー独自のPrometheusもしくはFluentdの構成変更（設定変更，または，削除）を行った場合，トレンドデータ管理DBからそれらのサンプルが削除されるまで，構成変更前のIM管理ノードが作成されます。トレンドデータが削除される契機については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「2.7.2トレンドデータ管理DB」を参照してください。

構成変更前のIM管理ノードを作成したくない場合，jddcreatetreeコマンドにより出力されたIM管理ノードファイル，および，IM管理ノードツリーファイルを編集します。IM管理ノードツリーファイルについては，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「3.5.3 IM管理ノード関連ファイル」を参照してください。ファイルをコピーしてバックアップを作成してから編集を行ってください。

■IM管理ノードファイルの編集

jddcreatetreeコマンドにより出力されたIM管理ノードファイル（ファイル名：imdd_node_HITACHI_JP1_JPCCS_CONFINFO_JP1/IM - Managerのホスト名.json）には，構成変更前のIM管理ノードの情報も出力されます。設定変更の場合，変更前と変更後で構成情報のSIDが同一となり，2つ目以降の構成情報のSIDは，末尾に「-xx」（xxは01〜99までの数字）を付与して出力されます。

構成変更前のIM管理ノードが不要である場合，jddcreatetreeコマンドにより出力されたIM管理ノードファイルを編集して，構成変更前のIM管理ノードのオブジェクトの情報を削除します。IM管理ノードファイルの形式を次に示します。

{
  "meta":{
    ・・・
  },
  "simtData": [
    IM管理ノードのオブジェクト,
    ・・・
  ]
}

IM管理ノードのオブジェクトは，simtDataの配列の要素で，次の形式です。

• IM管理ノードのオブジェクトの形式

{
  "sid": "構成情報のSID",
  "value": {
    ・・・
    "property": {
      IM管理ノードのプロパティに表示する値
    },
    "jp1im_TrendData_labels": {
      トレンドデータを特定するための値
    },
    ・・・
  }
}

IM管理ノードのプロパティに表示する値，および，トレンドデータを特定するための値を確認し，構成変更前のIM管理ノードのオブジェクトを削除します。IM管理ノードのプロパティに表示する値については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「3.15.6(1)(f)プロパティ表示」を参照してください。トレンドデータを特定するための値として，次に表に示す値が設定されています。

キー	値の説明
jp1_pc_prome_hostname	Prometheus serverのホスト名 Prometheus設定ファイルのjp1_pc_prome_hostnameに設定されている値です。ログ監視対象のSIDの場合，このキーと値は出力されません。
job	スクレイプジョブ名 Prometheus設定ファイルのjob_nameに設定されている値です。ログ監視対象のSID，または，kubernetesのSIDの場合，このキーと値は出力されません。
instance	インスタンス名 ディスカバリ設定ファイルのtargetsに指定した値です。
jp1_pc_nodelabel	IM管理ノードのラベル名 Prometheus設定ファイルのscrape_configsもしくはmetrics_scrape_configs，または，AWSリソースのjp1_pc_nodelabelタグで設定した値です。

構成情報のSIDの末尾に「-xx」が付与されていないIM管理ノードのオブジェクトを削除し，末尾に「-xx」が付与されているIM管理ノードのオブジェクトを残す場合，残す構成情報のSIDの末尾の「-xx」を削除して保存してください。

Node exporterのポート番号を変更した場合の編集例を，次に示します。

この例では，変更前のポート番号が20716，変更後のポート番号が29999とします。

• 編集前のIM管理ノードファイルの例

{
  "meta":{
    ・・・
  },
  "simtData": [
    ・・・
    {
      "sid": "_JP1PC-IMB_MHOST/_JP1PC-M_AHOST/_JP1PC-AHOST_AHOST/_HOST_AHOST/_JP1PC-A_Linux%20metric%20collector%28Node%20exporter%29",
      "value": {
        "component": "/HITACHI/JP1/JPCCS/CONFINFO",
        "category": "platform",
        "visible": true,
        "label": "Linux metric collector(Node exporter)",
        "property": {
          "jp1_pc_prome_hostname": "ahost",
          "job": "jpc_node",
          "jp1_pc_exporter": "JPC Node exporter",
          "jp1_pc_trendname": "node_exporter"
        },
        "jp1im_TrendData_labels": {
          "jp1_pc_prome_hostname": "ahost",
          "job": "jpc_node",
          "instance": "ahost:20716",
          "jp1_pc_nodelabel": "Linux metric collector(Node exporter)"
        },
        "methods": [
          "__metricListGet",
          "__timeSeriesDataGet"
        ]
      }
    },
    {
      "sid": "_JP1PC-IMB_MHOST/_JP1PC-M_AHOST/_JP1PC-AHOST_AHOST/_HOST_AHOST/_JP1PC-A_Linux%20metric%20collector%28Node%20exporter%29-01",
      "value": {
        "component": "/HITACHI/JP1/JPCCS/CONFINFO",
        "category": "platform",
        "visible": true,
        "label": "Linux metric collector(Node exporter)",
        "property": {
          "jp1_pc_prome_hostname": "ahost",
          "job": "jpc_node",
          "jp1_pc_exporter": "JPC Node exporter",
          "jp1_pc_trendname": "node_exporter"
        },
        "jp1im_TrendData_labels": {
          "jp1_pc_prome_hostname": "ahost",
          "job": "jpc_node",
          "instance": "ahost:29999",
          "jp1_pc_nodelabel": "Linux metric collector(Node exporter)"
        },
        "methods": [
          "__metricListGet",
          "__timeSeriesDataGet"
        ]
      }
    },
    ・・・
  ]
}

instanceのキーに「ahost:20716」が設定されているIM管理ノードのオブジェクトを削除し，残す構成情報のSIDの末尾の「-xx」を削除します。編集後のIM管理ノードファイルを，次に示します。

• 編集後のIM管理ノードファイルの例

{
  "meta":{
    ・・・
  },
  "simtData": [
    ・・・
    {
      "sid": "_JP1PC-IMB_MHOST/_JP1PC-M_AHOST/_JP1PC-AHOST_AHOST/_HOST_AHOST/_JP1PC-A_Linux%20metric%20collector%28Node%20exporter%29",
      "value": {
        "component": "/HITACHI/JP1/JPCCS/CONFINFO",
        "category": "platform",
        "visible": true,
        "label": "Linux metric collector(Node exporter)",
        "property": {
          "jp1_pc_prome_hostname": "ahost",
          "job": "jpc_node",
          "jp1_pc_exporter": "JPC Node exporter",
          "jp1_pc_trendname": "node_exporter"
        },
        "jp1im_TrendData_labels": {
          "jp1_pc_prome_hostname": "ahost",
          "job": "jpc_node",
          "instance": "ahost:29999",
          "jp1_pc_nodelabel": "Linux metric collector(Node exporter)"
        },
        "methods": [
          "__metricListGet",
          "__timeSeriesDataGet"
        ]
      }
    },
    ・・・
  ]
}

■IM管理ノードツリーファイルの編集

jddcreatetreeコマンドにより出力されたIM管理ノードツリーファイルを編集します。

構成の削除を行った場合，削除したIM管理ノードのツリーオブジェクトの記述を削除します。

設定変更を行った場合，構成情報のSIDの末尾に「-xx」が付与されている構成情報のSIDの記述を，targetの配列から削除します。

Node exporterの設定を変更した場合の編集例を，次に示します。

• 編集前のIM管理ノードツリーファイルの例

{
  "meta":{
    ・・・
  },
  "simtData": [
    ・・・
    {
      "sid": "_ROOT_AllSystems/_HOST_AHOST/_CATEGORY_platform/_OBJECT_JP1PC-ALinux%20metric%20collector%28Node%20exporter%29",
      "value": {
        "target": [
          "_JP1PC-IMB_MHOST/_JP1PC-M_AHOST/_JP1PC-AHOST_AHOST/_HOST_AHOST/_JP1PC-A_Linux%20metric%20collector%28Node%20exporter%29"
        ],
        "label": "Linux metric collector(Node exporter)"
      }
    },
    {
      "sid": "_ROOT_AllSystems/_HOST_AHOST/_CATEGORY_platform/_OBJECT_JP1PC-ALinux%20metric%20collector%28Node%20exporter%29-01",
      "value": {
        "target": [
          "_JP1PC-IMB_MHOST/_JP1PC-M_AHOST/_JP1PC-AHOST_AHOST/_HOST_AHOST/_JP1PC-A_Linux%20metric%20collector%28Node%20exporter%29-01"
        ],
        "label": "Linux metric collector(Node exporter)"
      }
    },
    ・・・
  ]
}

• 編集後のIM管理ノードツリーファイルの例

{
  "meta":{
    ・・・
  },
  "simtData": [
    ・・・
    {
      "sid": "_ROOT_AllSystems/_HOST_AHOST/_CATEGORY_platform/_OBJECT_JP1PC-ALinux%20metric%20collector%28Node%20exporter%29",
      "value": {
        "target": [
          "_JP1PC-IMB_MHOST/_JP1PC-M_AHOST/_JP1PC-AHOST_AHOST/_HOST_AHOST/_JP1PC-A_Linux%20metric%20collector%28Node%20exporter%29"
        ],
        "label": "Linux metric collector(Node exporter)"
      }
    },
    ・・・
  ]
}

■IM管理ノード関連ファイルの編集しない場合の動作

IM管理ノード関連ファイルを編集しない場合，トレンドデータ管理DBから構成変更前のサンプルが削除されるまで，それらのIM管理ノードが作成されます。設定変更の場合，アドオンプログラム，または，ユーザー独自のPrometheusおよびFluentdが発行するJP1イベントは，構成情報のSIDの末尾に「-xx」が付与されていないIM管理ノードにマッピングされます。

(d)　製品プラグインの設定（Windowsの場合）

製品プラグインの設定方法について説明します。

{
  "meta":{
    "version":"2"
  },
  "allSystem":[
    {
      "id":"strageSystem",
      "displayName":"Amazon Simple Storage Service",
      "objectRoot":[
        {
          "type":"JP1PC-AWS-S3",
          "name":[{".*":"regexp"}]
        }
      ]
    },
    {
      "id":"lambda",
      "displayName":"AWS Lambda",
      "objectRoot":[
        {
          "type":"JP1PC-AWS-LAMBDA",
          "name":[{".*":"regexp"}]
        }
      ]
    },
    {
      "id":"dynamodb",
      "displayName":"Amazon DynamoDB",
      "objectRoot":[
        {
          "type":"JP1PC-AWS-DYNAMODB",
          "name":[{".*":"regexp"}]
        }
      ]
    },
    {
      "id":"states",
      "displayName":"AWS Step Functions",
      "objectRoot":[
        {
          "type":"JP1PC-AWS-STATES",
          "name":[{".*":"regexp"}]
        }
      ]
    },
    {
      "id":"sqs",
      "displayName":"Amazon Simple Queue Service",
      "objectRoot":[
        {
          "type":"JP1PC-AWS-SQS",
          "name":[{".*":"regexp"}]
        }
      ]
    },
    {
      "id":"ecs",
      "displayName":"Amazon Elastic Container Service",
      "objectRoot":[
        {
          "type":"JP1PC-AWS-ECS",
          "name":[{".*":"regexp"}]
        }
      ]
    },
    {
      "id":"ebs",
      "displayName":"Amazon Elastic Block Store",
      "objectRoot":[
        {
          "type":"JP1PC-AWS-EBS",
          "name":[{".*":"regexp"}]
        }
      ]
    },
    {
      "id":"efs",
      "displayName":"Amazon Elastic File System",
      "objectRoot":[
        {
          "type":"JP1PC-AWS-EFS",
          "name":[{".*":"regexp"}]
        }
      ]
    },
    {
      "id":"fsx",
      "displayName":"FSx File System",
      "objectRoot":[
        {
          "type":"JP1PC-AWS-FSX",
          "name":[{".*":"regexp"}]
        }
      ]
    },
    {
      "id":"sns",
      "displayName":"Simple Notification Service",
      "objectRoot":[
        {
          "type":"JP1PC-AWS-SNS",
          "name":[{".*":"regexp"}]
        }
      ]
    },
    {
      "id":"rds",
      "displayName":"Relational Database Service",
      "objectRoot":[
        {
          "type":"JP1PC-AWS-RDS",
          "name":[{".*":"regexp"}]
        }
      ]
    }
  ]
}