10.4.1　JP1/IM3連携時のセットアップ手順

Script Exporter設定ファイルを開く。

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

Script Exporter設定ファイルで，IM3連携用のScript Exporterを設定する。

設定内容を次に示します。

scripts:
（省略）
  - name: ajseventmetrics
    command: 連携コマンドの絶対パス
    timeout:
      max_timeout: 60
      enforced: true
（省略）

連携コマンドの詳細については，「10.7.2　JP1/IM3との連携で使用するコマンド」を参照してください。

Script Exporter設定ファイルを保存する。

Prometheus設定ファイルを開く。

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

Prometheus設定ファイルに手順2で設定したScript Exporterを登録する。

設定内容を次に示します。

（省略）
  - job_name: 'jpc_jp1ajs3'
    scrape_interval: 1m
    scrape_timeout: 50s
    http_sd_configs:
      - url: 'http://インストールホスト名:Script exporterのポート番号/discovery'
    relabel_configs:
      - source_labels: [__param_script]
        regex: 'ajseventmetrics'
        action: 'keep'
      - source_labels: [__param_script]
        target_label: jp1_pc_script
      - target_label: jp1_pc_exporter
        replacement: JPC Script exporter
      - target_label: jp1_pc_category
        replacement: Script
      - target_label: jp1_pc_trendname
        replacement: script_exporter
      - target_label: jp1_pc_multiple_node
        replacement: "{job=~'jpc_jp1ajs3.*',__name__=~'script_.*'}"
      - target_label: jp1_pc_nodelabel
        replacement: JP1/AJS3 metric collector(Script exporter)
      - target_label: jp1_pc_agent_create_flag
        replacement: false
    metric_relabel_configs:
      - source_labels: ['__name__']
        regex: 'script_success|script_duration_seconds|script_exit_code|ajs_rootjobnet_exectime'
        action: 'keep'
      - source_labels: [jp1_pc_script]
        target_label: jp1_pc_nodelabel
      - source_labels: ['__name__','ajs_host','ajs_scheduler','ajs_rootjobnet']
        regex: 'ajs_rootjobnet_exectime;(.*);(.*);(.*)'
        target_label: jp1_pc_nodelabel
        replacement: ${1}:${2}:${3}
      - source_labels: ['__name__','ajs_host']
        regex: 'ajs_rootjobnet_exectime;(.*)'
        target_label: instance
        replacement: ${1}
      - source_labels: ['__name__']
        regex: 'ajs_rootjobnet_exectime'
        target_label: jp1_pc_trendname
        replacement: ajs_rootjobnet
      - regex: (jp1_pc_script|jp1_pc_multiple_node|jp1_pc_agent_create_flag)
        action: labeldrop
      - source_labels: ['__name__']
        regex: 'ajs_rootjobnet_exectime'
        target_label: jp1_pc_category
        replacement: ''
      - source_labels: ['__name__']
        regex: 'ajs_rootjobnet_exectime'
        target_label: jp1_pc_exporter
        replacement: ''
      - source_labels: ['__name__']
        regex: 'ajs_rootjobnet_exectime'
        target_label: jp1_pc_trendname
        replacement: ''
（省略）

また，IM3連携以外で任意のScript exporterを使用したスクレイプ設定を行う場合は，次の設定をスクレイプ定義に含めてください。

（省略）
  - job_name: '任意のScript Exporterを使ったスクレイプジョブ名'
（省略）
    relabel_configs:
      - source_labels: [__param_script]
        regex: 'ajseventmetrics'
        action: 'drop'
（省略）

Prometheus設定ファイルを保存する。

必要に応じてパフォーマンスデータの監視・通知機能を定義する。

連携したメトリックを監視する場合は，アラート設定ファイルにアラート定義を設定してください。パフォーマンスデータの監視・通知機能の詳細については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」を参照してください。アラート設定ファイルの詳細については，マニュアル「JP1/Integrated Management 3 - Manager コマンド・定義ファイル・APIリファレンス」を参照してください。

アラート定義の定義例を次に示します。

• ルートジョブネット実行時間のアノマリー監視

  次のアラート定義の定義例は，過去1年分の実行時間のパターンと比較して，Zスコアが3を超えた場合にアラートを発行します。

（省略）
    - alert: AJS_ROOTJOBNET_EXECTIME_ANOMALY_DETECTION(Script exporter)
      expr: abs(ajs_rootjobnet_exectime - avg_over_time(ajs_rootjobnet_exectime[1y※1])) / (stddev_over_time(ajs_rootjobnet_exectime[1y※1]) > 0) > 3※2
      for: 1m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/AJS2"
        jp1_pc_component: "/HITACHI/JP1/AJS3/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: 000041D0
        jp1_pc_metricname: "ajs_rootjobnet_exectime"
      annotations:
        jp1_pc_firing_description: "ルートジョブネットの実行時間の異常が検知されました。(対象：{{ $labels.jp1_pc_nodelabel }})"
        jp1_pc_resolved_description: "ルートジョブネットの実行時間の異常監視を終了しました。(対象：{{ $labels.jp1_pc_nodelabel }})"
（省略）

注※1

Zスコアの計算に使用する過去データの期間

注※2

Zスコアの異常判定に使用するしきい値

• ルートジョブネット実行時間の遅延予兆監視

  次のアラート定義の定義例は，JP1/AJS3マネージャーホストajsmgrのスケジューラーサービスAJSROOT1に定義されているルートジョブネット（/rootjobnet）の過去1年分の実行時間から近似直線を導出して，1日後の予測値が3,600秒を上回った場合にアラートを発行します。

（省略）
    - alert: AJS_ROOTJOBNET_EXECTIME_DELAY_EARLY_DETECTION(Script exporter)
      expr: predict_linear(ajs_rootjobnet_exectime(ajs_host="ajsmgr※1",ajs_scheduler="AJSROOT1 ※2",ajs_rootjobnet="/rootjobnet※3")[1y※4],86400 ※5) > 3600※6
      for: 1m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/AJS2"
        jp1_pc_component: "/HITACHI/JP1/AJS3/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: 000041D0
        jp1_pc_metricname: "ajs_rootjobnet_exectime"
      annotations:
        jp1_pc_firing_description: "ルートジョブネットの実行時間の遅延予兆が検知されました。(対象：{{ $labels.jp1_pc_nodelabel }})"
        jp1_pc_resolved_description: "ルートジョブネットの実行時間の遅延予兆の監視を終了しました。(対象：{{ $labels.jp1_pc_nodelabel }})"
（省略）

注※1

JP1/AJS3マネージャーのホスト名

・物理ホストの場合：JP1/AJS3 - Managerをインストールしたホストのホスト名

・論理ホストの場合：論理ホスト名

注※2

スケジューラーサービス名

注※3

監視対象のルートジョブネット名

注※4

近似直線の計算に使用する過去データの期間

注※5

近似直線上における，将来値を予測したい時刻までの時間（単位：秒）

注※6

ルートジョブネットの実行時間のしきい値（単位：秒）

必要に応じて，パフォーマンスデータの保存期間を変更する。

パフォーマンスデータの保存期間は，サービス定義ファイルまたはユニット定義ファイルで設定します。サービス定義ファイルおよびユニット定義ファイルの詳細については，マニュアル「JP1/Integrated Management 3 - Manager コマンド・定義ファイル・APIリファレンス」を参照してください。

JP1/IM2連携時のセットアップで定義内容を設定した，JP1/AJS3プラグイン設定ファイルを開く。

JP1/AJS3プラグイン設定ファイルの格納先，およびJP1/IM2連携でJP1/AJS3プラグイン設定ファイルに設定する項目の詳細については，「10.3.1(1) JP1/IM2向けのセットアップ（JP1/IM2マネージャーホストでの作業）」を参照してください。

JP1/AJS3プラグイン設定ファイルの定義内容に，設定項目imHostを追加する。

定義内容は次の形式で指定します。

{
  "ajswebconUrl":"設定値",
  "linkValueLimit":設定値,
  "prewaitLink":"{y|n}",
  "netcnLink":"{y|n}",
  "evRegexLink":"{y|n}",
  "evMacroLink":"{y|n}",
  "evotherLink":"{y|n}",
  "evIpLink":"{y|n}",
  "imHost":{
   "監視対象のJP1/AJS3マネージャーホスト名":{
    "監視対象のスケジューラーサービス名":{
     "immgrHost":"JP1/IM3マネージャーホスト名",
     "imagtHost":"JP1/IM3エージェントホスト名"
    },
    （省略）
   },
   （省略）
  }
}

設定項目を次の表に示します。

JP1/AJS3プラグイン設定ファイルを保存する。

必要に応じて，メトリック定義ファイル（metrics_ajs_rootjobnet.conf）の内容を編集する。

メトリック定義ファイル（metrics_ajs_rootjobnet.conf）の格納先を次に示します。

• Windowsの場合

  JP1/IM3 - Managerのインストール先フォルダ\jp1imm\conf\imdd\plugin\jp1pccs

  または

  共有フォルダ\jp1imm\conf\imdd\plugin\jp1pccs

• UNIXの場合

  /etc/opt/jp1imm/conf/imdd/plugin/jp1pccs

  または

  共有ディレクトリ/jp1imm/conf/imdd/plugin/jp1pccs

記述する内容は次のとおりです。

[
  {
    "name":"AJS_ROOTJOBNET_EXECTIME",
    "default":true,
    "promql":"avg_over_time(ajs_rootjobnet_exectime[$stepTime{minSeconds=\"60\"}]) and $jp1im_TrendData_labels",
    "resource_en":{
      "category":"time",
      "label":"Execusion time of root jobnet",
      "description":"It is the time from the start to the end of the root jobnet.",
      "unit":"sec"
    },
    "resource_ja":{
      "category":"時間",
      "label":"ルートジョブネットの実行時間",
      "description":"正常終了したルートジョブネットの開始時刻から終了時刻までの時間を表します。",
      "unit":"秒"
    }
  }
]

IM管理ノード関連ファイルを生成し，定義内容をインテリジェント統合管理サーバに反映する。

詳細については，マニュアル「JP1/Integrated Management 3 - Manager 構築ガイド」を参照してください。

必要に応じて，JP1/IM3 - Managerのトレンドデータ管理DBの保存期間を変更する。

変更方法の詳細については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」を参照してください。