JP1 Version 13　JP1/Integrated Management 3 - Manager コマンド・定義ファイル・APIリファレンス

3021-3-L06-10

前書き

対象製品

適用OSのバージョン，JP1/Integrated Management 3 - Manager，JP1/Integrated Management 3 - View，およびJP1/Integrated Management 3 - Agentが前提とするサービスパックやパッチなどの詳細については各製品のリリースノートで確認してください。

●JP1/Integrated Management 3 - Manager（適用OS：Windows）

P-2A2C-8EDL JP1/Integrated Management 3 - Manager 13-01

製品構成一覧および内訳形名

P-CC2A2C-9MDL JP1/Integrated Management 3 - Manager 13-01 (適用OS: Windows Server 2022，Windows Server 2019，Windows Server 2016)

P-CC2A2C-6HDL JP1/Integrated Management 3 - View 13-00 (適用OS: Windows 11，Windows Server 2022，Windows Server 2019，Windows Server 2016，Windows 10)

P-CC2A2C-9GDL JP1/Integrated Management 3 - Agent 13-01 (適用OS: Windows Server 2022，Windows Server 2019，Windows Server 2016)

P-CC842C-9GDL JP1/Integrated Management 3 - Agent 13-01 (適用OS: Linux 9，Linux 8，Linux 7，Oracle Linux 9，Oracle Linux 8，Oracle Linux 7，SUSE Linux 15，SUSE Linux 12，Amazon Linux 2023)

P-CC2A2C-6LDL JP1/Base 13-00 (適用OS: Windows Server 2022，Windows Server 2019，Windows Server 2016)

P-CC842C-6LDL JP1/Base 13-00 (適用OS: Linux 9，Linux 8，Linux 7，Oracle Linux 9，Oracle Linux 8，Oracle Linux 7，SUSE Linux 15，SUSE Linux 12，Amazon Linux 2023)

P-CC1M2C-6LDL JP1/Base 13-00 (適用OS: AIX)

●JP1/Integrated Management 3 - Manager（適用OS：Linux）

P-842C-8EDL JP1/Integrated Management 3 - Manager 13-01

製品構成一覧および内訳形名

P-CC842C-9MDL JP1/Integrated Management 3 - Manager 13-01 (適用OS: Linux 9，Linux 8，Linux 7，Oracle Linux 9，Oracle Linux 8，Oracle Linux 7，Amazon Linux 2023)

P-CC9W2C-9MDL JP1/Integrated Management 3 - Manager 13-01 (適用OS: SUSE Linux 15，SUSE Linux 12)

P-CC2A2C-6HDL JP1/Integrated Management 3 - View 13-00 (適用OS: Windows 11，Windows Server 2022，Windows Server 2019，Windows Server 2016，Windows 10)

P-CC2A2C-9GDL JP1/Integrated Management 3 - Agent 13-01 (適用OS: Windows Server 2022，Windows Server 2019，Windows Server 2016)

P-CC842C-9GDL JP1/Integrated Management 3 - Agent 13-01 (適用OS: Linux 9，Linux 8，Linux 7，Oracle Linux 9，Oracle Linux 8，Oracle Linux 7，SUSE Linux 15，SUSE Linux 12，Amazon Linux 2023)

P-CC2A2C-6LDL JP1/Base 13-00 (適用OS: Windows Server 2022，Windows Server 2019，Windows Server 2016)

P-CC842C-6LDL JP1/Base 13-00 (適用OS: Linux 9，Linux 8，Linux 7，Oracle Linux 9，Oracle Linux 8，Oracle Linux 7，SUSE Linux 15，SUSE Linux 12，Amazon Linux 2023)

P-CC1M2C-6LDL JP1/Base 13-00 (適用OS: AIX)

輸出時の注意

本製品を輸出される場合には、外国為替及び外国貿易法の規制並びに米国輸出管理規則など外国の輸出関連法規をご確認の上、必要な手続きをお取りください。

なお、不明な場合は、弊社担当営業にお問い合わせください。

商標類

HITACHI，Cosminexus，HiRDB，JP1，ServerConductorは，株式会社 日立製作所の商標または登録商標です。

Active Directoryは，マイクロソフト 企業グループの商標です。

AIXは，世界の多くの国で登録されたInternational Business Machines Corporationの商標です。

Amazon Web Services，AWS，Powered by AWS ロゴ，Amazon CloudWatchは，Amazon.com, Inc. またはその関連会社の商標です。

Amazon Web Services，AWS，Powered by AWS ロゴ，Amazon DynamoDBは，Amazon.com, Inc. またはその関連会社の商標です。

Amazon Web Services，AWS，Powered by AWS ロゴ，Amazon S3は，Amazon.com, Inc. またはその関連会社の商標です。

Amazon Web Services，AWS，Powered by AWS ロゴ，Amazon Simple Queue Serviceは，Amazon.com, Inc. またはその関連会社の商標です。

Amazon Web Services，AWS，Powered by AWS ロゴ，Amazon Web Servicesは，Amazon.com, Inc. またはその関連会社の商標です。

Amazon Web Services，AWS，Powered by AWS ロゴ，AWSは，Amazon.com, Inc. またはその関連会社の商標です。

Amazon Web Services，AWS，Powered by AWS ロゴ，AWS Lambdaは，Amazon.com, Inc. またはその関連会社の商標です。

Azureは，マイクロソフト 企業グループの商標です。

BSAFEは，Dell Inc. またはその子会社の商標です。

Linuxは，Linus Torvalds氏の米国およびその他の国における登録商標です。

Microsoftは，マイクロソフト 企業グループの商標です。

Oracle(R)，Java及びMySQLは，Oracle，その子会社及び関連会社の米国及びその他の国における登録商標です。

Red Hat is a registered trademark of Red Hat, Inc. in the United States and other countries.

Red Hatは，米国およびその他の国におけるRed Hat, Inc.の登録商標です。

Red Hat Enterprise Linux is a registered trademark of Red Hat, Inc. in the United States and other countries.

Red Hat Enterprise Linuxは，米国およびその他の国におけるRed Hat, Inc.の登録商標です。

Rubyは，Advanced Micro Devices, Inc.の商標です。

SAP，および本文書に記載されたその他の SAP 製品，サービス，ならびにそれぞれのロゴは，ドイツおよびその他の国々における SAP SE の商標または登録商標です。

UNIXは，The Open Groupの登録商標です。

Windowsは，マイクロソフト 企業グループの商標です。

Windows Serverは，マイクロソフト 企業グループの商標です。

その他記載の会社名，製品名などは，それぞれの会社の商標もしくは登録商標です。

本製品は，米国Dell Inc.のDell BSAFE(TM)ソフトウェアを搭載しています。

This product includes software developed by the Apache Software Foundation (http://www.apache.org/).

This product includes software developed by Ben Laurie for use in the Apache-SSL HTTP server project.

Portions of this software were developed at the National Center for Supercomputing Applications (NCSA) at the University of Illinois at Urbana-Champaign.

This product includes software developed by the University of California, Berkeley and its contributors.

This software contains code derived from the RSA Data Security Inc. MD5 Message-Digest Algorithm, including various modifications by Spyglass Inc., Carnegie Mellon University, and Bell Communications Research, Inc (Bellcore).

Regular expression support is provided by the PCRE library package, which is open source software, written by Philip Hazel, and copyright by the University of Cambridge, England. The original software is available from ftp://ftp.csx.cam.ac.uk/pub/software/programming/pcre/

This product includes software developed by Ralf S. Engelschall <rse@engelschall.com> for use in the mod_ssl project (http://www.modssl.org/).

This product includes software developed by Andy Clark.

This product includes software developed by Daisuke Okajima and Kohsuke Kawaguchi (http://relaxngcc.sf.net/).

This product includes software developed by IAIK of Graz University of Technology.

This product includes software developed by the Java Apache Project for use in the Apache JServ servlet engine project (http://java.apache.org/).

Java is a registered trademark of Oracle and/or its affiliates.

マイクロソフト製品の表記について

このマニュアルでは，マイクロソフト製品の名称を次のように表記しています。

表記

製品名

Hyper-V

Microsoft(R) Windows Server(R) 2012 Hyper-V(R)

SCVMM

Microsoft(R) System Center Virtual Machine Manager 2012

Windows 10

Windows(R) 10 Enterprise 64-bit

Windows(R) 10 Home 64-bit

Windows(R) 10 Pro 64-bit

Windows 11

Windows(R) 11 Enterprise 64-bit

Windows(R) 11 Home 64-bit

Windows(R) 11 Pro 64-bit

Windows Server 2016

Microsoft(R) Windows Server(R) 2016 Datacenter

Microsoft(R) Windows Server(R) 2016 Standard

Windows Server 2019

Microsoft(R) Windows Server(R) 2019 Datacenter

Microsoft(R) Windows Server(R) 2019 Standard

Windows Server 2022

Microsoft(R) Windows Server(R) 2022 Datacenter

Microsoft(R) Windows Server(R) 2022 Standard

Windows11，Windows Server 2022，Windows Server 2019，Windows Server 2016，Windows 10を総称してWindowsと表記することがあります。

発行

2024年3月　3021-3-L06-10

著作権

Copyright (C) 2023, 2024 Hitachi, Ltd.

Copyright (C) 2023, 2024 Hitachi Solutions, Ltd.

奥付

マニュアル発行元

株式会社 日立製作所

〒100‒8280　東京都千代田区丸の内一丁目6番6号

変更内容

変更内容(3021-3-L06-10)　JP1/Integrated Management 3 - Manager　13-01

追加・変更内容

変更個所

JP1/IM - Agentによる性能監視機能に，AIX性能情報収集機能（Node exporter for AIX）を追加した。

これに伴い，次のコマンドを追加した。

jpc_stop_node_exporter_aix（AIX限定）

また，次の定義ファイルを追加した。

Node exporter for AIXのメトリック定義ファイル

Node exporter for AIXのディスカバリ設定ファイル

また，次の定義ファイルに説明を追加した。

Prometheus設定ファイル

アラート設定ファイル

ユニット定義ファイル

1. コマンド一覧，1. jpc_stop_node_exporter_aix（AIX限定），2. 定義ファイル一覧，2. Node exporter for AIXのメトリック定義ファイル（metrics_node_exporter_aix.conf）， 2. Node exporter for AIXのディスカバリ設定ファイル（jpc_file_sd_config_node_aix.yml），2. Prometheus設定ファイル（jpc_prometheus_server.yml），2. アラート設定ファイル（jpc_alerting_rules.yml），2. ユニット定義ファイル（jpc_プログラム名.service）

SAPシステムのシステムログ情報およびCCMSアラート情報を監視する機能を追加した。

これに伴い，次のコマンドを追加した。

jr3slget

jr3alget

また，次の定義ファイルを追加した。

SAPシステム監視のScript exporter設定ファイルのサンプルファイル

SAPシステムのシステムログ情報監視定義ファイルのサンプルファイル

SAPシステムのCCMSアラート情報監視定義ファイルのサンプルファイル

jr3slgetコマンドの環境パラメーター設定ファイル

jr3slgetコマンドの環境パラメーター設定ファイルのサンプルファイル

jr3algetコマンドの環境パラメーター設定ファイル

jr3algetコマンドの環境パラメーター設定ファイルのサンプルファイル

また，次の定義ファイルに説明を追加した。

Prometheus設定ファイル

1. コマンド一覧，1. jr3slget，1. jr3alget，2. 定義ファイル一覧，2. SAPシステム監視のScript exporter設定ファイルのサンプルファイル（jpc_script_exporter_sap.yml），2. SAPシステムのシステムログ情報監視定義ファイルのサンプルファイル（fluentd_sap_syslog_tail.conf），2. SAPシステムのCCMSアラート情報監視定義ファイルのサンプルファイル（fluentd_sap_alertlog_tail.conf），2. jr3slgetコマンドの環境パラメーター設定ファイル（jr3slget.ini），2. jr3slgetコマンドの環境パラメーター設定ファイルのサンプルファイル（jr3slget.ini.sample），2. jr3algetコマンドの環境パラメーター設定ファイル（jr3alget.ini），2. jr3algetコマンドの環境パラメーター設定ファイルのサンプルファイル（jr3alget.ini.sample），2. Prometheus設定ファイル（jpc_prometheus_server.yml）

JP1/IM - Agentによる性能監視機能に，Oracle Database監視機能（OracleDB exporter）を追加した。

これに伴い，次のコマンドにOracleDB exporterに関する説明を追加した。

jimasecret

jpc_service

jpc_service_autostart

jpc_service_start

jpc_service_stop

また，次の定義ファイルを追加した。

OracleDB exporterのメトリック定義ファイル

OracleDB exporterのデフォルトの収集メトリック定義ファイル

OracleDB exporterのディスカバリ設定ファイル

また，次の定義ファイルに説明を追加した。

アラート設定ファイル

サービス定義ファイル

1. jimasecret，1. jpc_service，1. jpc_service_autostart，1. jpc_service_start，1. jpc_service_stop，2. 定義ファイル一覧，2. OracleDB exporterのメトリック定義ファイル（metrics_oracledb_exporter.conf），2. OracleDB exporterのデフォルトの収集メトリック定義ファイル（default-metrics.toml），2. OracleDB exporterのディスカバリ設定ファイル（jpc_file_sd_config_oracledb.yml），2. アラート設定ファイル（jpc_alerting_rules.yml），2. サービス定義ファイル（jpc_プログラム名_service.xml）

「IMエクスポーター」の章および用語を削除し，次の機能に関する説明を，JP1/IM - AgentまたはJP1/IM - Managerの説明個所に統合した。

Windowsプロセス情報収集機能（Windows exporter）

Linuxプロセス情報収集機能（Process exporter）

Azure monitor性能情報収集機能（Promitor）

UAP監視機能（Script exporter）

ログメトリクス機能（Fluentd）

コンテナ監視機能

2. 定義ファイル，2. 定義ファイル一覧

JP1/IM - Agentによる性能監視機能に，WindowsおよびLinuxのサービス監視機能を追加した。

これに伴い，次の定義ファイルを追加した。

Windows exporter（サービス監視）のメトリック定義ファイル

Node exporter（サービス監視）のメトリック定義ファイル

また，次の定義ファイルに説明を追加した。

アラート設定ファイル

Windows exporterのディスカバリ設定ファイル

Node exporterのディスカバリ設定ファイル

ユニット定義ファイル

Windows exporter設定ファイル

2. 定義ファイル一覧，2. Windows exporter（サービス監視）のメトリック定義ファイル（metrics_windows_exporter_service.conf），2. Node exporter（サービス監視）のメトリック定義ファイル（metrics_node_exporter_service.conf），2. アラート設定ファイル（jpc_alerting_rules.yml），2. Windows exporterのディスカバリ設定ファイル（jpc_file_sd_config_windows.yml），2. Node exporterのディスカバリ設定ファイル（jpc_file_sd_config_node.yml），2. ユニット定義ファイル（jpc_プログラム名.service），2. Windows exporter設定ファイル（jpc_windows_exporter.yml）

imagent設定ファイルに，次の設定項目を追加した。

service_startup_wait_time（定義ファイルの更新処理におけるサービス起動待機時間）

2. imagent設定ファイル（jpc_imagent.json）

クラウドサービスログ連携ツールの説明を削除した。

−

エージェントとしてAIX版のJP1/Baseを追加した。

−

次の適用OSを追加した。

Amazon Linux 2023

−

単なる誤字・脱字などはお断りなく訂正しました。

はじめに

このマニュアルは，JP1/Integrated Management 3 - Manager，JP1/Integrated Management 3 - View，およびJP1/Integrated Management 3 - Agentのコマンドや定義ファイル，APIなどについて説明したものです。なお，このマニュアルでは，JP1/Integrated Management 3 - Manager，JP1/Integrated Management 3 - View，およびJP1/Integrated Management 3 - Agentを総称して，JP1/Integrated ManagementまたはJP1/IMと表記します。また，このマニュアルでのJP1/Integrated Management - Manager，JP1/Integrated Management - View，およびJP1/Integrated Management - Agentは，それぞれJP1/Integrated Management 3 - Manager，JP1/Integrated Management 3 - View，およびJP1/Integrated Management 3 - Agentと読み替えてください。

対象読者

オープンプラットフォームのシステムを管理するインフラを，JP1/IMを使って管理，運用，操作される方を対象としています。具体的には次の方を対象としています。

システムで発生する事象を一元監視するため，JP1/IMを管理，運用，操作するシステム管理者

システムを管理するインフラの状態をシステムで発生する事象と関連づけて一元監視するため，JP1/IMを管理，運用，操作するシステム管理者

OSおよびアプリケーションについて知識がある方

マニュアルの構成

このマニュアルは，次に示す章から構成されています。

第1章　コマンド

JP1/Integrated Managementで使用できるコマンドの文法について説明しています。

第2章　定義ファイル

JP1/Integrated Managementの定義ファイルの形式および文法について説明しています。

第3章　JP1イベント

JP1/Integrated Managementが出力するJP1イベントの種類とその属性について説明しています。

第4章　ユーザー作成プラグイン

JP1/IM - Manager（インテリジェント統合管理基盤）では，ユーザーが作成したプラグインで処理を行うことができます。ユーザー作成プラグインについて説明しています。

第5章　API

JP1/Integrated Managementが提供するAPIについて説明しています。

第6章　［統合オペレーション・ビューアー］画面のカスタマイズ

［統合オペレーション・ビューアー］画面で特定のIM管理ノードを選択した際に，ユーザーが定義した任意の画面を表示する機能について説明しています。

第7章　インテリジェント統合管理基盤を使うための情報

インテリジェント統合管理基盤を使うために必要なSIDやjsonオブジェクト，およびユーザー作成プラグインを利用するために必要なアダプタコマンドの情報，IM管理ノードツリー生成機能について説明しています。また，サンプルプラグイン，制御文字についても説明しています。

第8章　システム監視オブジェクト一覧（セントラルスコープ用）

JP1/Integrated Managementで提供しているシステム監視オブジェクトについて説明しています。

第9章　監視ツリーモデル（セントラルスコープ用）

監視ツリーを自動生成するときに作成される監視ツリーの構造について説明しています。

マニュアルの体系

JP1/IMのマニュアルでは，システムの設計・構築・運用などのシステムのライフサイクルでの段階ごとに必要な情報を説明しています。目的に合わせて必要なマニュアルをお読みください。

JP1/IMのマニュアルとシステムのライフサイクルの関係を次の図に示します。

このマニュアルで使用する記号

このマニュアルで使用する記号を次に示します。

記号

意味

［　］

メニュー項目，画面名，ボタン名，およびキーボードのキーなどを示す。

例

メニュー項目：［新規作成］

画面名：［ログイン］画面

ボタン名：［OK］ボタン

キーボードのキー：［Ctrl］キー

［　］−［　］

画面のメニューから項目を選択する操作を示す。

例

［ファイル］−［新規作成］を選択する。

上記の例では，メニューバーの［ファイル］を選んで，プルダウンメニューの［新規作成］を選択することを示す。

［　］＋［　］

キーを同時に押すことを示す。

例

［Ctrl］＋［C］キー

上記の例では，［Ctrl］キーと［C］キーを同時に押すことを示す。

コマンドの文法で使用する記号

コマンドとパラメーターの説明で使用する記号を，次のように定義します。

記号

意味

|

(ストローク)

複数の項目に対し，項目間の区切りを示し，「または」の意味を示す。

例

「A | B | C」は，「A，BまたはC」を示す。

｛　｝

この記号で囲まれている複数の項目の中から，必ず一つの項目を選択する。項目の区切りは|で示す。

例

｛A | B | C｝は「A，BまたはCのどれかを指定する」ことを示す。

[　]

この記号で囲まれている項目は任意に指定できる（省略してもよい）。

複数の項目が記述されている場合には，すべてを省略するか，どれか一つを選択する。

例

[A]は「何も指定しない」か「Aを指定する」ことを示す。

[B | C]は「何も指定しない」か「BまたはCを指定する」ことを示す。

…または...

この記号の直前に示された項目を繰り返して複数個，指定できる。

例

「A，B，…」は「AのあとにBを必要個数指定する」ことを示す。

＿

(下線)

括弧内のすべてを省略したときに，システムがとる標準値を示す。標準値がない場合は，指定した項目だけが有効である。

例

[A | B]はこの項目を指定しなかった場合に，Aを選択したと見なすことを示す。

△

空白を表す。

△₀：0個以上の空白（空白を省略できる）

△₁：1個以上の空白（空白を省略できない）

▲

タブを表す。

例

▲Aとした場合に，Aの前にタブがあることを示す。

図中で使用する記号

このマニュアルの図中で使用する記号を，次のように定義します。

Windows版JP1/IM，JP1/Baseのインストール先フォルダの表記

このマニュアルでは，Windows版JP1/IM，JP1/Baseのインストール先フォルダを次のように表記しています。

製品名

インストール先フォルダの表記

デフォルトインストール先フォルダ※

JP1/IM - View

Viewパス

システムドライブ:¥Program Files¥Hitachi¥JP1CoView

JP1/IM - Manager

Managerパス

システムドライブ:¥Program Files¥Hitachi¥JP1IMM

Consoleパス

システムドライブ:¥Program Files¥Hitachi¥JP1Cons

Scopeパス

システムドライブ:¥Program Files¥Hitachi¥JP1Scope

JP1/IM - Agent

Agentパス

システムドライブ:¥Program Files¥Hitachi¥jp1ima

JP1/Base

Baseパス

システムドライブ:¥Program Files¥Hitachi¥JP1Base

注※　各製品をデフォルトのままインストールした場合のインストール先フォルダを表しています。「システムドライブ:¥Program Files」と表記している部分は，インストール時のOS環境変数によって決定されるため，環境によって異なる場合があります。

このマニュアルで使用する「Administrators権限」について

このマニュアルで表記している「Administrators権限」とは，ローカルPCに対するAdministrators権限です。ローカルPCに対してAdministrators権限を持つユーザーであれば，ローカルユーザー，ドメインユーザーおよび，Active Directory環境で動作に違いはありません。

このマニュアルで使用する定義ファイルに指定するパスについて

ファイル名を指定する定義には，ネットワークパスを指定することはできません。

例えば，イベントガイド情報ファイルに記述するEV_FILEにはネットワークパス以外の任意のフォルダ（パス）を指定してください。

オンラインマニュアルについて

JP1/IMでは，Webブラウザーで参照できるHTMLマニュアルを提供しています。

オンラインマニュアルの内容は，このマニュアルと同様です。

オンラインマニュアルは，次の操作で目次が表示されます。

JP1/IM - View：［ヘルプ］−［目次］を選択する。

統合オペレーション・ビューアー：［ヘルプ］−［オンラインマニュアル］を選択する。

注意事項

スタートメニューからオンラインマニュアルを表示させると，OSの設定によってすでに表示されているブラウザーの画面上にHTMLマニュアルが表示されることがあります。

統合トレースログの出力先について

JP1/IM 12-10から，JP1/IM - Managerの32ビットJavaプロセスを，すべて64ビットJavaプロセスに変更しました。このため，JP1/IMの各機能のJavaプロセス機能が出力する統合トレースログの出力先が変更となります。

バージョン12-10以降のJP1/IMの各機能の統合トレースログの出力先を次に示します。ログファイルトラップ機能を使用している場合，出力先の変更に応じて設定変更が必要です。

統合トレースログの出力先（32ビット）：システムドライブ¥Program Files(x86)¥Hitachi¥HNTRLib2¥spool

IMデータベース

セントラルスコープサービス

プロセス管理

コマンド実行

自動アクション

インストールおよびセットアップ

統合トレースログの出力先（64ビット）：システムドライブ¥Program Files¥Hitachi¥HNTRLib2¥spool

イベント基盤サービス

セントラルコンソール・ビューアー

セントラルスコープ・ビューアー

相関イベント発行サービス

IM構成管理

IM構成管理・ビューアー

インテリジェント統合管理基盤

1　コマンド

この章では，JP1/IMで使用できるコマンドの文法について説明します。

コマンドの記述形式

コマンドの記述形式について説明します。ただし，コマンドによっては説明しない項目もあります。

機能

コマンドの機能について説明しています。

形式

コマンドの形式を説明しています。

実行権限

コマンドの実行に必要なユーザーの権限について説明しています。

格納先ディレクトリ

コマンドの格納場所について説明しています。

引数

コマンドの引数について説明しています。

なお，引数は大文字・小文字を区別します。ただし，ON，OFFの指定は大文字・小文字を区別しません。

jpc_serviceコマンド，jpc_service_autostartコマンドの「-on」「-off」については，大文字・小文字を区別します。

注意事項

注意事項を説明しています。

戻り値

コマンドの戻り値について説明しています。

なお，コマンド実行時に表示されるメッセージについては，マニュアル「JP1/Integrated Management 3 - Manager メッセージ」を参照してください。

使用例

コマンドの使用例について説明しています。

出力例

コマンドの出力例について説明しています。

コマンド一覧

JP1/IMで使用できるコマンド名とコマンドを実行するために必要な権限の一覧を示します。なお，次節以降のコマンドの説明では，コマンドはアルファベット順に記載されています。

表中の凡例および注釈

表中では，Windows，UNIXの対応を凡例のように表記しています。

（凡例）

○：対応している

−：対応していない

注※1

Windowsの場合，スーパーユーザーとはAdministrators権限を持つユーザーを指します。

注※2

マネージャーが対象のJP1/Baseのコマンド（構成定義，コマンド実行に関するコマンド）です。コマンドの詳細については，マニュアル「JP1/Base 運用ガイド」のコマンドを説明している章を参照してください。

注※3

Windowsの場合はAdministrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）が必要です。

注※4

監視対象のAIXホストで使用するコマンドです。

起動・終了，セットアップに関するコマンド

機能概要

コマンド名

Windows

UNIX

必要な

実行権限

JP1/IM - Manager（セントラルコンソール）のセットアップをする

jp1cc_setup（UNIX限定）

−

○

スーパーユーザー

JP1/IM - Manager（セントラルスコープ）のセットアップをする

jp1cs_setup（UNIX限定）

−

○

スーパーユーザー

JP1/IM - Managerを自動的に起動する

jco_start（UNIX限定）

−

○

スーパーユーザー

JP1/IM - Managerを自動的に終了する

jco_stop（UNIX限定）

−

○

スーパーユーザー

JP1/IM - Managerのプロセスの状態を確認する

jco_spmd_status

○

○

スーパーユーザー※1

JP1/IM - Managerのプロセスの状態を更新する

jco_spmd_reload

○

○

スーパーユーザー※1

クラスタシステムで運用するための設定をする

jp1cohasetup（Windows限定）

○

−

スーパーユーザー※1

jp1cshasetup（Windows限定）

○

−

スーパーユーザー※1

jp1cc_setup_cluster（UNIX限定）

−

○

スーパーユーザー

jp1cs_setup_cluster（UNIX限定）

−

○

スーパーユーザー

クラスタシステムでJP1/IM - Managerを起動する

jco_start.cluster（UNIX限定）

−

○

スーパーユーザー

クラスタシステムでJP1/IM - Managerを終了する

jco_stop.cluster（UNIX限定）

−

○

スーパーユーザー

クラスタシステムでJP1/IM - Managerを強制的に終了する

jco_killall.cluster（UNIX限定）

−

○

スーパーユーザー

JP1/IM-ManagerサービスとJP1/Base Eventサービスの依存関係を設定する

SpmSetSvcCon（Windows限定）

○

−

スーパーユーザー※1

IMデータベースに関するコマンド

機能概要

コマンド名

Windows

UNIX

必要な

実行権限

構成情報を格納するIM構成管理DBをセットアップする

jcfdbsetup

○

○

スーパーユーザー※1

構成情報を格納するIM構成管理DBをアンセットアップする

jcfdbunsetup

○

○

スーパーユーザー※1

JP1イベントを格納する統合監視DBをセットアップする

jcodbsetup

○

○

スーパーユーザー※1

JP1イベントを格納する統合監視DBをアンセットアップする

jcodbunsetup

○

○

スーパーユーザー※1

統合監視DBに登録しているJP1イベントの情報をCSV形式にしてファイルに出力する

jcoevtreport

○

○

スーパーユーザー※1

IMデータベースをバックアップする

jimdbbackup

○

○

スーパーユーザー※1

IM構成管理DBの使用中の空き領域（空きページ領域）を解放する

jimdbreclaim

○

○

スーパーユーザー※1

バックアップで保管しておいたデータベースを復旧（リカバリー）する

jimdbrecovery

○

○

スーパーユーザー※1

データベースの断片化された空き領域を再編成する

jimdbrorg

○

○

スーパーユーザー※1

IMデータベースの起動・停止などの稼働状態を確認する

jimdbstatus

○

○

スーパーユーザー※1

IMデータベースを停止する

jimdbstop

○

○

スーパーユーザー※1

IMデータベースをアップデートする

jimdbupdate

○

○

スーパーユーザー※1

IM構成管理に関するコマンド

機能概要

コマンド名

Windows

UNIX

必要な

実行権限

HCSMから仮想化構成情報を取得し，仮想化構成情報ファイルに出力する

jcfcolvmhcsm

○

○

スーパーユーザー※1

KVMから仮想化構成情報を取得し，仮想化構成情報ファイルに出力する

jcfcolvmkvm

○

○

スーパーユーザー※1

SCVMMから仮想化構成情報を取得し，仮想化構成情報ファイルに出力する

jcfcolvmscvmm（Windows限定）

○

−

スーパーユーザー※1

vCenterから仮想化構成情報を取得し，仮想化構成情報ファイルに出力する

jcfcolvmvc

○

○

スーパーユーザー※1

日立サーバ論理分割機構から仮想化構成情報を取得し，仮想化構成情報ファイルに出力する

jcfcolvmvirtage

○

○

スーパーユーザー※1

VMware ESXから仮想化構成情報を取得し，仮想化構成情報ファイルに出力する

jcfcolvmesx

○

○

スーパーユーザー※1

IM構成管理で管理しているシステムの階層構成（IM構成），ホスト情報および定義情報を出力する

jcfexport

○

○

スーパーユーザー※1

IM構成管理の情報をインポートする

jcfimport

○

○

スーパーユーザー※1

ホスト入力情報ファイルとセントラルスコープのエクスポートファイルから，仮想化構成の監視ツリー情報を追加したセントラルスコープのインポートファイルを生成する。または，業務グループ情報ファイル，監視グループ情報ファイルおよびセントラルスコープのエクスポートファイルから，業務グループの監視ツリー情報を追加したセントラルスコープのインポートファイルを生成する

jcfmkcsdata

○

○

スーパーユーザー※1

仮想化構成情報ファイルで，ホスト入力情報ファイルを更新する

jcfmkhostsdata

○

○

スーパーユーザー※1

指定ホストの仮想化構成を更新する

jcfvirtualchstat

○

○

スーパーユーザー※1

JP1/IM - ManagerのIM構成管理プロセスの動作環境を設定する

jp1cf_setup（UNIX限定）

−

○

スーパーユーザー

クラスタシステムで運用する場合に，IM構成管理の環境設定をする

jp1cf_setup_cluster（UNIX限定）

−

○

スーパーユーザー

クラスタシステムで運用する場合に，IM構成管理の環境設定をする

jp1cfhasetup（Windows限定）

○

−

スーパーユーザー※1

IM構成管理に関するコマンド（リモート監視構成）

機能概要

コマンド名

Windows

UNIX

必要な

実行権限

指定した監視対象ホストに，リモート監視イベントログトラップのプロファイルを定義する

jcfaleltdef（Windows限定）

○

−

スーパーユーザー※1

リモート監視イベントログトラップ動作定義ファイルをリロードする

jcfaleltreload（Windows限定）

○

−

スーパーユーザー※1

リモート監視イベントログトラップを起動する

jcfaleltstart（Windows限定）

○

−

スーパーユーザー※1

リモート監視イベントログトラップの動作状況を表示する

jcfaleltstat（Windows限定）

○

−

スーパーユーザー※1

リモート監視イベントログトラップを停止する

jcfaleltstop（Windows限定）

○

−

スーパーユーザー※1

指定した監視対象ホストに，リモート監視ログファイルトラップのプロファイルを追加または削除する

jcfallogdef

○

○

スーパーユーザー※1

リモート監視ログファイルトラップ動作定義ファイルをリロードする

jcfallogreload

○

○

スーパーユーザー※1

リモート監視ログファイルトラップを起動する

jcfallogstart

○

○

スーパーユーザー※1

リモート監視ログファイルトラップの動作状況を表示する

jcfallogstat

○

○

スーパーユーザー※1

リモート監視ログファイルトラップを停止する

jcfallogstop

○

○

スーパーユーザー※1

バージョンアップに関するコマンド

機能概要

コマンド名

Windows

UNIX

必要な

実行権限

11-50より前のアクション定義ファイルを11-50以降のアクション定義ファイルに変換する

jcadefconv

○

○

スーパーユーザー※1

イベント取得フィルターが互換用で動作している場合にイベント取得フィルターの位置をイベントコンソールサービスからイベント基盤サービスに変更する

jcochafmode（UNIX限定）

○

○

スーパーユーザー※1

バージョン7以前のJP1/Baseのコマンド実行の履歴をバージョン8用のコマンド実行履歴ファイルに移行する

jcocmdconv※2

○

○

スーパーユーザー※1

旧バージョンのJP1/IM - ManagerまたはJP1/IM - Manager（セントラルコンソール）で設定した論理ホスト環境をバージョンアップする

jp1cohaverup

○

○

スーパーユーザー※1

旧バージョンのJP1/IM - Manager（セントラルスコープ）の物理ホスト環境をバージョンアップする

jp1csverup.bat（Windows限定）

○

−

スーパーユーザー※1

旧バージョンのJP1/IM - Manager（セントラルスコープ）で設定した論理ホスト環境をバージョンアップする

jp1cshaverup.bat（Windows限定）

○

−

スーパーユーザー※1

旧バージョンのJP1/IM - Manager（セントラルスコープ）の物理ホスト環境をバージョンアップする

jp1csverup（UNIX限定）

−

○

スーパーユーザー

旧バージョンのJP1/IM - Manager（セントラルスコープ）で設定した論理ホスト環境をバージョンアップする

jp1cshaverup（UNIX限定）

−

○

スーパーユーザー

インテリジェント統合管理基盤に関するコマンド

機能概要

コマンド名

Windows

UNIX

必要な

実行権限

JP1/IM - Manager（インテリジェント統合管理基盤）が管理するシステム構成情報を取得し，IM管理ノード関連ファイルを生成する

jddcreatetree

○

○

スーパーユーザー※1

インテリジェント統合管理サーバが管理する製品からシステム構成情報を取得し，jddupdatetreeコマンドの入力データとなるIM管理ノード関連ファイルを生成する

jddupdatetree

○

○

スーパーユーザー※1

JP1/IM - Manager（インテリジェント統合管理基盤）が連携する製品から認証を受けるために使用するユーザーIDとパスワードを設定する

jddsetaccessuser

○

○

スーパーユーザー※1

JP1/IM - Manager（インテリジェント統合管理基盤）が提供するプラグインからREST APIを実行する場合のプロキシサーバーの認証情報を設定する

jddsetproxyuser

○

○

スーパーユーザー※1

ユーザーが定義した提案定義ファイルを読み込み，JP1/IM - Manager（インテリジェント統合管理基盤）に反映する

jddupdatesuggestion

○

○

スーパーユーザー※1

OpenID認証連携でOpenIDプロバイダに登録したインテリジェント統合管理基盤のクライアントの情報を，JP1/IM - Manager（インテリジェント統合管理基盤）に設定する

jddsetopinfo

○

○

スーパーユーザー※1

シングルサインオンマッピング定義ファイルで定義したマッピング情報を，JP1/IM - Manager（インテリジェント統合管理基盤）に反映する

jddupdatessomap

○

○

スーパーユーザー※1

ユーザーが定義した自動対処アクション定義ファイルを読み込み，インテリジェント統合管理基盤に反映する

jddupdateaction

○

○

スーパーユーザー※1

インテリジェント統合管理データベースに関するコマンド

機能概要

コマンド名

Windows

UNIX

必要な

実行権限

インテリジェント統合管理データベースをバックアップする

jimgndbbackup

○

○

スーパーユーザー※1

バックアップで保管しておいたインテリジェント統合管理データベースを復旧（リカバリー）する

jimgndbrestore

○

○

スーパーユーザー※1

インテリジェント統合管理データベースとトレンドデータ管理サービスをセットアップする

jimgndbsetup

○

○

スーパーユーザー※1

インテリジェント統合管理データベースとトレンドデータ管理サービスをアンセットアップする

jimgndbunsetup

○

○

スーパーユーザー※1

インテリジェント統合管理データベースサービスとトレンドデータ管理サービスを停止する

jimgndbstop

○

○

スーパーユーザー※1

インテリジェント統合管理データベースサービスとトレンドデータ管理サービスの起動・停止などの稼働状態を確認する

jimgndbstatus

○

○

スーパーユーザー※1

■インテリジェント統合管理データベースの運用コマンドの多重実行について

インテリジェント統合管理データベースの運用コマンドの多重実行の可不可について，次の表に示します。

実行するコマンド名

実行中のコマンド名

jimgndbsetup

jimgndbunsetup

jimgndbstop

jimgndbstatus

jimgndbbackup

jimgndbrestore

jimgndbsetup

多重実行不可

多重実行可

多重実行不可

jimgndbunsetup

多重実行不可

多重実行可

多重実行不可

jimgndbstop

多重実行不可

多重実行可

多重実行不可

jimgndbstatus

多重実行可

jimgndbbackup

多重実行不可

多重実行可

多重実行不可

jimgndbrestore

多重実行不可

多重実行可

多重実行不可

ビューの起動に関するコマンド

機能概要

コマンド名

Windows

UNIX

必要な

実行権限

IM構成管理・ビューアーを起動する

jcfview（Windows限定）

○

−

なし

IM構成管理・ビューアーを起動するメニューをWindowsスタートメニューに登録・削除する

jcovcfsetup（Windows限定）

○

−

スーパーユーザー※1

JP1/IM - Viewの［ログイン］画面，［監視ツリー(編集中)］画面を起動する，またはコマンドラインからJP1/IM - Managerにログインする

jcoview（Windows限定）

○

−

なし

構成定義に関するコマンド

機能概要

コマンド名

Windows

UNIX

必要な

実行権限

構成定義情報を下位ホストに配布し，定義を有効にする

jbsrt_distrib※2

○

○

スーパーユーザー※1

下位ホストから構成定義情報を収集し，構成定義を更新する

jbsrt_sync※2

○

○

スーパーユーザー※1

コマンドを実行したホストの構成定義情報を削除する

jbsrt_del※2

○

○

スーパーユーザー※1

設定されている構成定義情報を表示する

jbsrt_get※2

○

○

スーパーユーザー※1

イベントに関するコマンド

機能概要

コマンド名

Windows

UNIX

必要な

実行権限

重要イベントの対処状況を変更する

jcochstat

○

○

なし※3

JP1/IM - Managerのシステム環境を設定する

jcoimdef

○

○

スーパーユーザー※1

自動アクション，およびコマンド実行に関するコマンド

機能概要

コマンド名

Windows

UNIX

必要な

実行権限

自動アクションの定義をチェックし，複数の定義ファイルを併合する

jcamakea

○

○

スーパーユーザー※1

自動アクションの実行結果を表示する

jcashowa

○

○

なし※3

稼働しているアクション実行サービスの動作状態，および読み込んでいる自動アクション定義ファイルの内容を標準出力に表示する

jcastatus

○

○

なし※3

自動アクションの定義を再読み込みする，自動アクション機能を休止する，自動アクション定義を有効化または無効化する

jcachange

○

○

スーパーユーザー※1

自動アクションをキャンセルする

jcacancel

○

○

スーパーユーザー※1

コマンド実行のための環境を設定する

jcocmddef※2

○

○

スーパーユーザー※1

実行したコマンドの履歴を出力する

jcocmdlog※2

○

○

なし

JP1/IM - Viewから実行したコマンド，自動アクションで実行したコマンドを削除する

jcocmddel※2

○

○

スーパーユーザー※1

JP1/IM - Viewから実行したコマンド，自動アクションで実行したコマンドの状態を確認する

jcocmdshow※2

○

○

スーパーユーザー※1

メール通知機能に関するコマンド

機能概要

コマンド名

Windows

UNIX

必要な

実行権限

指定したメールアドレスにメールを送信する

jimmail（Windows限定）

○

−

スーパーユーザー※1

POP before SMTPまたはSMTP-AUTH認証のパスワードをメール環境定義ファイルに設定する

jimmailpasswd（Windows限定）

○

−

スーパーユーザー※1

相関イベントの発行に関するコマンド

機能概要

コマンド名

Windows

UNIX

必要な

実行権限

相関イベント発行定義を変更する

jcoegschange

○

○

スーパーユーザー※1

相関イベント発行定義ファイルの定義内容をチェックする

jcoegscheck

○

○

スーパーユーザー※1

相関イベント発行機能を相関稼働状態にする

jcoegsstart

○

○

スーパーユーザー※1

相関イベント発行機能の状態，および現在使用している相関イベント発行定義を表示する

jcoegsstatus

○

○

なし※3

相関イベント発行機能を機能停止状態にする

jcoegsstop

○

○

スーパーユーザー※1

セントラルスコープの環境設定で使用するコマンド

機能概要

コマンド名

Windows

UNIX

必要な

実行権限

ホスト情報をホスト情報DBに登録する

jcshostsimport

○

○

スーパーユーザー※1

ホスト情報DBからホスト情報を取得する

jcshostsexport

○

○

スーパーユーザー※1

監視オブジェクトDBを作成または再作成する

jcsdbsetup

○

○

スーパーユーザー※1

フィルターに関するコマンド

機能概要

コマンド名

Windows

UNIX

必要な

実行権限

イベント取得フィルターを切り替える

jcochfilter

○

○

スーパーユーザー※1

共通除外条件の動作モードを変更する

jcochcefmode

○

○

スーパーユーザー※1

セントラルスコープの監視ノードの状態変更に関するコマンド

機能概要

コマンド名

Windows

UNIX

必要な

実行権限

監視ノード（監視オブジェクトまたは監視グループ）の状態を変更する

jcschstat

○

○

スーパーユーザー※1

セントラルスコープの監視オブジェクトDBの情報を移行するコマンド

機能概要

コマンド名

Windows

UNIX

必要な

実行権限

JP1/IM - Managerの監視オブジェクトDBの保管情報を一括取得し，ローカルにファイル出力する

jcsdbexport

○

○

スーパーユーザー※1

jcsdbexportコマンドでファイル出力した情報をJP1/IM - Managerの監視オブジェクトDBに反映する

jcsdbimport

○

○

スーパーユーザー※1

トラブルシューティングに使用するコマンド

機能概要

コマンド名

Windows

UNIX

必要な

実行権限

IM構成管理・ビューアーのJavaスレッドダンプを生成する

jcfthreaddmp（Windows限定）

○

−

なし

JP1/IM - Manager，およびJP1/IM - Viewの障害発生時の資料を採取する

jim_log.bat（Windows限定）

○

−

なし※3

JP1/IM - Managerの障害発生時の資料を採取する

jim_log.sh（UNIX限定）

−

○

スーパーユーザー

JP1/IM - Viewの障害発生時の資料を採取する

jcoview_log.bat（Windows限定）

○

−

なし※3

JP1/IM - Viewの障害発生時にスレッドダンプを出力する

jcothreaddmp（Windows限定）

○

−

なし

JP1/IM - Managerの障害発生時にスレッドダンプ，コアダンプ（UNIX限定）を出力する

jcogencore

○

○

スーパーユーザー※1

JP1/IM - Managerのヘルスチェック定義ファイルで定義した通知コマンドをテストする

jcohctest

○

○

スーパーユーザー※1

JP1/IM - Managerの定義ファイルの内容をチェックするコマンド

機能概要

コマンド名

Windows

UNIX

必要な

実行権限

イベント拡張属性定義ファイルをチェックする

jcoattrfcheck

○

○

なし※3

モニター画面呼び出し定義ファイルをチェックする

jcomonitorfcheck

○

○

なし※3

JP1/IM - Viewの定義ファイルの内容をチェックするコマンド

機能概要

コマンド名

Windows

UNIX

必要な

実行権限

アプリケーション実行定義ファイルをチェックする

jcoappexecfcheck（Windows限定）

○

−

なし

統合機能メニュー定義ファイルをチェックする

jcofuncfcheck（Windows限定）

○

−

なし

JP1/IM - Managerの管理ノード数をカウントするコマンド

機能概要

コマンド名

Windows

UNIX

必要な

実行権限

JP1/IM - Managerの管理ノード数をカウントする

jimnodecount

○

○

スーパーユーザー※1

JP1/IM - Agentに関するコマンド

機能概要

コマンド名

Windows

UNIX

必要な

実行権限

Prometheus serverの設定ファイルの書式チェックとアラートルールのテストを行う

promtool

○

○

なし

指定されたシークレットを難読化してシークレット管理ファイルに格納する

jimasecret

○

○

スーパーユーザー※1

JP1/IM - Agentの初期設定を行う

jimasetup

○

○

スーパーユーザー※1

JP1/IM - Agentのアドオンプログラムの有効・無効を設定する

jpc_service

○

○

スーパーユーザー※1※3

JP1/IM - Agentの自動起動および自動停止の設定をする

jpc_service_autostart

○

○

スーパーユーザー※1※3

JP1/IM - Agentのサービスを起動する

jpc_service_start

○

○

スーパーユーザー※1※3

JP1/IM - Agentのサービスを停止する

jpc_service_stop

○

○

スーパーユーザー※1※3

Node exporter for AIXを停止する

jpc_stop_node_exporter_aix（AIX限定）

−※4

スーパーユーザー

SAPシステム監視機能に関するコマンド

機能概要

コマンド名

Windows

UNIX

必要な

実行権限

SAPシステムのシステムログ情報を抽出する

jr3slget

○

○

なし

SAPシステムのCCMSアラート情報を抽出する

jr3alget

○

○

なし

共通の注意事項

32bit版cmd.exeについて（Windows版）

32bit版cmd.exeには対応していません。64bit版cmd.exeを使用してください。

同時実行について

以下のコマンドおよび機能は同時実行できません。

jpc_service

jpc_service_autostart

jpc_service_start

jpc_service_stop

定義ファイル操作機能

systemdのない環境について【Linux版】

systemdのない環境（コンテナ環境等）では以下のコマンドおよび機能は実行できません。

jpc_service

jpc_service_autostart

jpc_service_start

jpc_service_stop

定義ファイル操作機能(IM-Agentの定義ファイルのアップロード)

jcacancel

機能

自動アクションをキャンセルするコマンドです。このコマンドは，システムの運用に必要なくなった次に示すようなアクションを，JP1/IM - Managerから削除する場合に使用します。

システムの運用中に自動アクションが多発したことによって，「キューイング」状態のまま実行されないアクション

処理に時間が掛かるコマンドまたは処理が終了しないコマンドの実行によって，「実行中」状態のまま終了しないアクション

アクションで実行したコマンドは，jcocmddelコマンドでも削除できますが，アクションの状態が「キャンセル」になりません。jcocmddelコマンドは，jcacancelコマンドでキャンセルできなくなってしまったアクションを削除する場合に使用してください。

jcocmddelコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」のコマンドに関する章を参照してください。

キャンセル後のアクションの状態は，キャンセルするアクションの状態に応じて異なります。キャンセルできるアクションの状態と，キャンセル後のアクションの状態を次に示します。

表1‒1　キャンセルできるアクションの状態，キャンセル後のアクションの状態

キャンセルできるアクションの状態

キャンセル後のアクションの状態※1

「送信待機」または「送信待機（キャンセル失敗）」

「キャンセル」

「送信中（キャンセル失敗）」※2

「キューイング」または「キューイング（キャンセル失敗）」

「実行中」または「実行中（キャンセル失敗）」

「強制終了」

注※1　キャンセル処理中にJP1/Baseのコマンド制御内で，エラーが発生するとアクションの状態は「実行失敗（キャンセル失敗）」になります。

注※2　状態が「送信中」のアクションは，キャンセルできません。キャンセルを実行すると状態が「送信中（キャンセル失敗）」になります。

形式

jcacancel [-h 論理ホスト名]
          {[-i アクション通し番号,...] | [-a] | [-s アクション実行ホスト名]}
          [-f]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Consoleパス¥bin¥

UNIXの場合

/opt/jp1cons/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，論理ホスト名を指定します。指定した論理ホストに対応する自動アクションをキャンセルします。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。クラスタシステムを使用していない場合には指定は不要です。

-i アクション通し番号

アクション単位で，自動アクションをキャンセルする場合に指定します。

アクション通し番号は，jcashowaコマンド，またはJP1/IM - View上の［アクション結果一覧］画面，および［アクション結果詳細］画面で確認できます。最大20件指定できます。複数のアクション通し番号を指定する場合は，アクション通し番号を半角コンマ（,）で区切ってください。なお，アクション通し番号とアクション通し番号の間に，ほかのオプションは指定できません。

複数のアクション通し番号を指定した場合には，実行途中でエラーが発生しても処理を継続します。エラーメッセージはエラーが発生した件数だけ表示されます。

-iオプションで複数のアクションを指定して複数アクションをキャンセルした場合に，複数のエラーが発生したとき，最後にエラーとなったエラー内容がjcacancelコマンドの戻り値となります。

-a

jcacancelを実行するJP1/IMから実行し，監視しているすべてのホストに存在する自動アクションをキャンセルする場合に指定します。

-aオプションを指定して複数アクションをキャンセルした場合に，複数のエラーが発生したとき，最後にエラーとなったエラー内容がjcacancelコマンドの戻り値となります。

-s アクション実行ホスト名

jcacancelを実行するJP1/IMから実行し，指定した実行先ホストに存在する自動アクションをキャンセルする場合に指定します。

システム構成の定義で管理対象ホストに設定したホストだけ指定できます。なお，IPアドレス，およびホストグループは指定できません。

-sオプションを指定して複数アクションをキャンセルした場合に，複数のエラーが発生したとき，最後にエラーとなったエラー内容がjcacancelコマンドの戻り値となります。

-f

キャンセル時の確認メッセージを省略して，自動アクションをキャンセルしたい場合に指定します。

注意事項

キャンセル処理中に実行先のホストが再起動した場合の処理

自動アクションのキャンセル処理中にアクション実行先のホストが再起動した場合には，アクションのキャンセル状態を取得できません。そのため，アクションの状態が「送信待機（キャンセル中）」，「送信中（キャンセル中）」，「キューイング（キャンセル中）」，または「実行中（キャンセル中）」のままになり，キャンセル処理が成功したかどうか確認できません。jcocmdshowコマンドで確認し，アクションが残っている場合には，jcocmddelコマンドで削除してください。

戻り値

0

正常終了

1

引数不正エラー

2

共通定義不正エラー

3

アクション状態不正エラー

4

キャンセル処理エラー

5

入出力エラー

6

自動アクション機能（アクション実行サービス）からの応答がない

7

実行権限エラー（Windows限定）

255

システムエラー

使用例1

複数の自動アクション（アクション通し番号23，35，42）をキャンセルする場合

jcacancel -i 23,35,42

使用例2

論理ホストhostAから実行し，論理ホストhostAの監視下にあるすべてのホストに存在する自動アクションをキャンセルする場合

jcacancel -h hostA -a

使用例3

jcacancelを実行するJP1/IMから実行し，ホストhost01に存在する自動アクションをキャンセルする場合

jcacancel -s host01

使用例4

論理ホストhostBから実行し，論理ホストhostB監視下のhost02に存在する自動アクションをキャンセルする場合

jcacancel -h hostB -s host02

使用例5

論理ホストhostCの監視下にある自動アクションを，アクション通し番号（23，35，42）を指定してキャンセルする場合

jcacancel -h hostC -i 23,35,42

jcachange

機能

自動アクション定義ファイルを再読み込みする，自動アクション機能を休止する，または，自動アクション定義を有効化または無効化するコマンドです。

オプションを省略した場合，自動アクション定義ファイルを再読み込みします。自動アクション定義ファイルの内容を変更したあとに，変更したアクション定義を有効にするために，このコマンドで再読み込みをします。

自動アクション定義ファイル中の不正なアクション定義は読み飛ばし，処理を続行します。

自動アクション定義ファイルに不正なアクション定義があった場合，KAVB5104-Wのメッセージが出力されます。変更した自動アクション定義ファイルを再読み込みする場合は，このコマンドを実行する前にjcamakeaコマンドを実行して自動アクション定義ファイルに誤りがないことを確認してください。

KAVB5104-Wのメッセージが出力された場合は，自動アクション定義ファイルの内容を見直してください。

読み込んだ自動アクション定義ファイルに有効なアクション定義がない場合，KAVB4053-Iのメッセージが出力され，自動アクション機能を休止します。

このコマンドをオプション指定なしで実行する場合，すべてのアクション実行条件の抑止時間とAND条件の部分成立状態を初期化します。-e，-on，-off，または-stオプションを指定した場合は，定義変更していないアクション実行条件の抑止時間とAND条件の部分成立状態を維持します。

再読み込みした自動アクション定義パラメーターのサイズが最大長を超えていた場合，該当する行番号の自動アクション定義パラメーターは無視されます。自動アクション定義パラメーターのサイズについては，「自動アクション定義ファイル（actdef.conf）」（2.　定義ファイル）を参照してください。

形式

jcachange [-n] [-h 論理ホスト名]
          [-e [アクションID[,アクションID...] | ALL]]
          [-on アクションID[,アクションID...]]
          [-off アクションID[,アクションID...]]
          [-st]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Consoleパス¥bin¥

UNIXの場合

/opt/jp1cons/bin/

引数

-n

自動アクション機能を休止します。アクション定義に一致するイベントを受信しても，アクションは実行されません。

自動アクション機能を再開するには，オプションを省略してjcachangeコマンドを実行するか，JP1/IM - Managerを再起動します。

-h 論理ホスト名

クラスタシステムで運用している場合に，論理ホスト名を指定します。指定した論理ホストに対応するアクション定義を再読み込み，または休止します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。クラスタシステムを使用していない場合には指定は不要です。

-e [アクションID[,アクションID...] | ALL]

有効にしたいアクション定義のアクションIDを指定します。指定しなかったアクション定義は無効になります。複数指定する場合は，コンマで区切ります。すべてのアクションを有効にしたい場合は，ALLを指定します。

このオプションを指定した場合，アクション定義ファイル中の該当するアクションIDのvalidパラメーターをtrueに書き換えます。指定されていないアクションIDのvalidパラメーターはfalseに書き換えます。ALLを指定した場合はすべてのvalidパラメーターをtrueに書き換えます。

アクション定義ファイルのDESC_VERSIONが4のときだけ使用できます。

指定したアクションIDのアクション定義がアクション定義ファイルにない場合はKAVB4028-Eメッセージを標準エラー出力と統合トレースログに出力し，終了コード10で終了します。アクション定義ファイルにアクション実行条件が一つも定義されていない状態でALLを指定した場合は，KAVB4029-Eメッセージを標準エラー出力と統合トレースログに出力し，終了コード10で終了します。アクション定義ファイルにアクション実行条件が一つも定義されていない状態でアクションIDを指定しなかった場合は，KAVB4029-Eメッセージを標準エラー出力と統合トレースログに出力し，終了コード11で終了します。

-on アクションID[,アクションID...]

有効にしたいアクション定義のアクションIDを指定します。複数指定する場合は，コンマで区切ります。指定していないアクションIDの状態は変わりません。-eオプションと同時に指定できません。

このオプションを指定した場合，アクション定義ファイル中の該当するアクションIDのvalidパラメーターをtrueに書き換えます。

アクション定義ファイルのDESC_VERSIONが4のときだけ使用できます。

指定したアクションIDのアクション定義がアクション定義ファイルにない場合はKAVB4028-Eメッセージを標準エラー出力と統合トレースログに出力し，終了コード10で終了します。

-off アクションID[,アクションID...]

無効にしたいアクション定義のアクションIDを指定します。複数指定する場合は，コンマで区切ります。指定していないアクションIDの状態は変わりません。-eオプションと同時に指定できません。

このオプションを指定した場合，アクション定義ファイル中の該当するアクションIDのvalidパラメーターをfalseに書き換えます。

アクション定義ファイルのDESC_VERSIONが4のときだけ使用できます。

指定したアクションIDのアクション定義がアクション定義ファイルにない場合はKAVB4028-Eメッセージを標準エラー出力と統合トレースログに出力し，終了コード11で終了します。

-st

コマンド実行時に，次に示すアクション実行条件の抑止状態およびAND条件の部分成立状態を初期化しない場合に指定します。

イベント基盤サービスで動作しているアクション実行条件の定義内容と，アクション定義ファイルの定義内容が同じアクション実行条件

アクション定義ファイルのDESC_VERSIONが4のときだけ使用できます。このオプションと同時に指定できるのは，-hオプションだけです。

注意事項

jcachangeコマンドを大量に同時実行すると，マネージャーの性能が低下したり，タイムアウトが発生したりすることがあります。

戻り値

0

正常終了

4

自動アクション機能からの応答がない

5

自動アクション定義ファイルの再読み込み，自動アクション機能の一時停止失敗

10

有効化対象のアクション定義が存在しない

11

無効化対象のアクション定義が存在しない

12

自動アクション定義ファイルの排他に失敗したため，更新に失敗した

13

自動アクション定義ファイルの排他に失敗したため，読み込みに失敗した

111

イベント基盤サービスまたはイベントコンソールサービスとの接続に失敗（UNIXの場合）

154

ファイル入出力エラー（UNIXの場合）

243

引数指定値不正（UNIXの場合）

-13

引数指定値不正（Windowsの場合）

-102

ファイル入出力エラー（Windowsの場合）

-401

イベント基盤サービスまたはイベントコンソールサービスとの接続に失敗（Windowsの場合）

その他の値

システムエラー

jcadefconv

機能

バージョン11-50より前のアクション定義ファイル（DESC_VERSIONの値が4未満）を11-50以降のアクション定義ファイル（DSEC_VERSIONの値が4）に変換します。

ただし，バージョン8以前のアクション定義ファイルの，メッセージ，イベント基本情報，イベント詳細情報，およびイベント拡張情報の項目に，次の文字があった場合，変換して定義します。

表1‒2　文字の変換

変換前の文字

変換後の文字

¥/

/

半角スペース

%20

%

%25

なお，このコマンドは変換前にアクション定義ファイルのフォーマットを自動でチェックします。チェックした結果，エラーが見つかった場合は，標準エラー出力にエラーメッセージが出力され，変換されません。

変換後のアクション定義ファイルの出力先は任意に設定できます。

バージョン8以前のアクション定義ファイルから11-50以降のアクション定義ファイルへは，次のように変換されます。

表1‒3　アクション定義ファイルの変換

バージョン8以前の形式

11-50以降の形式

備考

（DESC_VERSIONなし）

DESC_VERSION=4

−

DESC_VERSION=1

DESC_VERSION=4

−

DESC_VERSION=2

DESC_VERSION=4

−

DESC_VERSION=3

DESC_VERSION=4

−

:state_watch=true

cmn

▲sta△true

end-cmn

−

:state_watch=false

cmn

▲sta△false

end-cmn

−

(:state_watchを指定していない)

cmn

▲sta△false

end-cmn

−

#コメント1

+0△*△:action.exe

act△アクション1

▲prm△0

▲cmt△コメント1

(省略)

end-act

−

#△コメント1

+0△*△:action.exe

act△アクション1

▲prm△0

▲cmt△△コメント1

(省略)

end-act

−

#コメント1

#コメント2

+0△*△:action.exe

act△アクション1

▲prm△0

▲cmt△コメント2

(省略)

end-act

−

パラメーターグループ指定のアクション

act△アクション通し番号

コマンド実行の環境が日本語環境だった場合

act△Action通し番号

コマンド実行の環境が英語環境だった場合

ANDアクションの場合

act

−

+パラメーターグループ番号

▲prm△パラメーターグループ番号

−

&

▲prm△&

−

$イベントID基本部

▲eid△イベントID基本部

−

$イベントID基本部:イベントID拡張部

▲eid△イベントID基本部:イベントID拡張部

−

*

▲eid△*

−

/メッセージ/

▲▲B.MESSAGE△REGEX△メッセージ

−

/イベント基本情報/

▲▲B.BASIC△REGEX△イベント基本情報

−

/イベント詳細情報/

▲▲B.DETAIL△REGEX△イベント詳細情報

−

//

（条件を設定しない）

−

/-------E/

▲▲E.SEVERITY△IN△Emergency

−

/------A-/

▲▲E.SEVERITY△IN△Alert

−

/-----C--/

▲▲E.SEVERITY△IN△Critical

−

/----E---/

▲▲E.SEVERITY△IN△Error

−

/---W----/

▲▲E.SEVERITY△IN△Warning

−

/--N-----/

▲▲E.SEVERITY△IN△Notice

−

/-I------/

▲▲E.SEVERITY△IN△Information

−

/D-------/

▲▲E.SEVERITY△IN△Debug

−

/DINWECAE/

▲▲E.SEVERITY△IN△Emergency△Alert△Critical△Error△Warning△Notice△Information△Debug

複数の重大度の条件を指定する場合

イベント拡張情報属性名=/属性値/

▲▲E.イベント拡張情報属性名△REGEX△属性値

−

u=ユーザー名

▲usr△ユーザー名

−

e=環境変数ファイル名

▲var△環境変数ファイル名

−

d=実行先ホスト名

▲hst△実行先ホスト名

−

d=グループ名

▲hst△グループ名

−

dt=抑止時間

▲det△抑止時間

−

rt=遅延監視時間

▲ret△遅延監視時間

−

+0△*△:アクション

▲cmd△アクション

−

+0△*△:action.exe

act△アクション1

▲prm△0

▲eid△*

▲cnd

▲end-cnd

▲cmd△action.exe

end-act

イベント条件がない場合

+0△*△/メッセージ/ : action.exe

act△アクション1

▲prm△0

▲eid△*

▲cnd

▲▲B.MESSAGE△REGEX△メッセージ

▲end-cnd

▲cmd△action.exe

end-act

イベント条件がある場合

−

aid△アクションID

アクション定義の先頭からアクション実行条件が定義されている順に，アクションIDを0〜2,147,483,647を昇順に設定します。ただし，パラメーターグループに&が指定されているアクション実行条件には採番しません。

−

valid△true

有効パラメーターをtrue（有効）に設定します。ただし，パラメーターグループに&が指定されているアクション実行条件には設定しません。

（凡例）

▲：タブを示す

△：半角スペース

−：なし

形式

jcadefconv -i 変換するアクション定義ファイル名
           -o 変換後のアクション定義ファイル名
          [-h 論理ホスト名]

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Consoleパス¥bin¥

UNIXの場合

/opt/jp1cons/bin/

引数

-i 変換するアクション定義ファイル名

変換するアクション定義ファイル名を，相対パスまたは絶対パス形式で指定します。アクション定義ファイルのパス名に空白を含む場合は，「"」で囲んで指定します。ファイル名には，255バイトまでの名称を指定できます。

-o 変換後のアクション定義ファイル名

変換するアクション定義ファイル名を，相対パスまたは絶対パス形式で指定します。アクション定義ファイルのパス名に空白を含む場合は，「"」で囲んで指定します。ファイル名には，255バイトまでの名称を指定できます。

ただし，Windowsの場合，次に示す文字列はファイル名には指定できません。

「:」，「?」，「"」，「<」，「>」，「|」の文字。

CON，PRN，AUX，NUL，COM1，COM2，COM3，COM4，COM5，COM6，COM7，COM8，COM9，LPT1，LPT2，LPT3，LPT4，LPT5，LPT6，LPT7，LPT8，LPT9のどれかと完全一致する（小文字も含む）文字列。

変換後のアクション定義ファイル名はユーザー任意に指定できますが，-iオプションに指定したファイルは指定できません。指定した場合，KAVB5502-Eのメッセージが出力されコマンドが終了します。また，-oオプションに指定したファイル名と同名のファイルがすでにある場合，KAVB5504-Eメッセージが出力されてプログラムが終了されます。

-h 論理ホスト名

クラスタシステムで運用している場合に，論理ホスト名を指定します。指定した論理ホストが使用する正規表現を使用して，変換する定義ファイルの内容をチェックします。

このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。

注意事項

-iオプションまたは-oオプションに，JP1/IM - Managerが使用している自動アクション定義を指定する場合は，JP1/IM - Managerを停止してください。

11-50以降の形式に変換した際に，定義不正となる項目があります。定義不正の場合には，KAVB5505-Wメッセージが出力されますので，メッセージに従って，アクション定義ファイルを修正してください。そのあと，jcamakeaコマンドでチェックし，定義ファイルが正しく修正されたことを確認してください。

戻り値

0

正常終了

1

異常終了

2

警告終了

使用例

バージョン8以前の形式で指定されたアクション定義ファイルを11-50以降の形式に変換する場合の例を次に示します。

jcadefconv  -i actdef.conf  -o actdef_new.conf

バージョン8以前の形式で指定されたアクション定義ファイルの記述が次の場合を仮定します。

DESC_VERSION=2
:state_watch=true
#コメント
+0 $0000000A /メッセージ/,/イベント基本情報/,/イベント詳細情報/,/-------E/ ATTR1=/属性値1/ : u=ユーザー名 e=環境変数ファイル名 d=実行先ホスト名 dt=20 rt=30 アクション

jcadefconvコマンドを実行すると，次のように変換されます。

DESC_VERSION=4
cmn
  sta true
end-cmn
act アクション1
  aid アクションID
  valid true
  prm 0
  cmt コメント
  eid A
  cnd
    B.MESSAGE REGEX メッセージ
    B.BASIC REGEX イベント基本情報
    B.DETAIL REGEX イベント詳細情報
    E.SEVERITY IN Emergency
    E.ATTR1 REGEX 属性値1
  end-cnd

  usr ユーザー名
  hst 実行先ホスト名
  cmd アクション
  var 環境変数ファイル名
  det 20
  ret 30
end-act

jcamakea

機能

自動アクション定義ファイルの定義内容をチェックします。複数の自動アクション定義ファイルに定義が分かれている場合は，一つに合わせます。ただし，複数に分かれている自動アクション定義ファイルを一つにする場合，アクション定義ファイルのバージョン，および自動アクション状態監視パラメーターは最初に読み込んだファイルの定義を使用します。

チェック，および併合結果は標準出力に出力されます。出力結果を確認して，自動アクション定義ファイルを作成してください。

チェックした結果，エラーが見つかった場合は，標準エラー出力にエラーメッセージが出力されます。

オプション指定した自動アクション定義ファイル内に記述している自動アクション定義パラメーターのサイズが最大長を超えていた場合，その自動アクション定義パラメーターは標準出力に出力されません。自動アクション定義パラメーターのサイズについては，「自動アクション定義ファイル（actdef.conf）」（2.　定義ファイル）を参照してください。

定義パラメーターがないファイル，またはコメントだけのファイルは，エラーになります。

形式

jcamakea [-h 論理ホスト名] 自動アクション定義ファイル名1 […自動アクション定義ファイル名100]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Consoleパス¥bin¥

UNIXの場合

/opt/jp1cons/bin/

引数

-h 論理ホスト名

変換する定義ファイルの内容のチェックに使用する正規表現のあるホストの論理ホスト名を指定します。指定した論理ホストが使用する正規表現を使用して，定義ファイルの内容をチェックします。また，指定した論理ホストのファイルサイズの設定に従って，自動アクション定義ファイルのファイルサイズが最大値を超えていないかチェックします。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。クラスタシステムを使用していない場合には指定は不要です。

自動アクション定義ファイル名1 […自動アクション定義ファイル名100]

アクションを定義したファイルを，相対パスまたは絶対パス形式で指定します。最大100ファイル指定できます。ファイル名とファイル名の間には空白を挿入します。自動アクション定義ファイルのパス名に空白を含む場合は，「"」で囲んで指定します。

ファイル名には，255バイトまでの名称を指定できます。

戻り値

0

正常終了

3

引数不正

7

フォーマットエラー，または権限がない。

152

システムエラー（UNIXの場合）

153

メモリー不足（UNIXの場合）

154

ファイル入出力エラー（UNIXの場合）

156

論理エラー（UNIXの場合）

255

ファイルオープンエラー（UNIXの場合）

-1

ファイルオープンエラー（Windowsの場合）

-100

論理エラー（Windowsの場合）

-102

ファイル入出力エラー（Windowsの場合）

-103

メモリー不足（Windowsの場合）

-104

システムエラー（Windowsの場合）

08-50以前の形式のアクション定義ファイルを読み込んだ場合の戻り値は，次のとおりです。

0：正常終了

0以外：異常終了

なお，エラーが複数発生した場合，戻り値は，最後に発生したエラーの戻り値となります。

使用例

自動アクション定義ファイル1 /usr/console/action1と自動アクション定義ファイル2 /usr/console/action2を併合して，自動アクション定義ファイル /usr/console/actionx1を作成します。

jcamakea /usr/console/action1 /usr/console/action2 > /usr/console/actionx1

jcashowa

機能

アクション情報ファイルに格納されている，実行した自動アクションの結果を表示します。指定した日時に登録されたイベントに対する自動アクションの実行結果を表示します。

形式

jcashowa [-d {[MM/dd/hh:mm][, [MM/dd/hh:mm]]}]
         [-h 論理ホスト名]
         [アクション情報ファイル名]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：なし

格納先ディレクトリ

Windowsの場合

Consoleパス¥bin¥

UNIXの場合

/opt/jp1cons/bin/

引数

-d {[MM/dd/hh:mm][, [MM/dd/hh:mm]]}

アクション情報ファイルに格納されている，アクションの対象となったイベントのイベント登録時刻を指定します。範囲を指定する場合は，指定する日時の始点と終点を「,」で区切って指定します。指定した範囲のイベント登録時刻となっているイベントに対するアクション情報を表示します。

このオプションを省略した場合は，アクション情報ファイルに格納されているすべてのアクション情報を表示します。

日時指定（MM/dd/hh:mm）について

日時指定は，次の表に示す形式で指定できます。運用に合わせて使い分けてください。

表1‒4　日時指定形式

日時指定パターン

説明

MM/dd/hh:mm

MMには月，ddには日，hhには時，mmには分を指定します。

MM/dd/hh

MMには月，ddには日，hhには時を指定します。

省略したmmは00を指定したと仮定されます。

MM/dd

MMには月，ddには日を指定します。

省略したhhは00，mmは00を指定したと仮定されます。

dd

ddには日を指定します。

省略したMMはjcashowaコマンドを実行した月，hhは00，mmは00を指定したと仮定されます。

dd/hh:mm

ddには日，hhには時，mmには分を指定します。

省略したMMはjcashowaコマンドを実行した月を指定したと仮定されます。

hh:mm

hhには時，mmには分を指定します。

省略したMMはjcashowaコマンドを実行した月，ddはjcashowaコマンドを実行した日を指定したと仮定されます。

日時の範囲指定（[MM/dd/hh:mm][, [MM/dd/hh:mm]]）について

日時の範囲指定は，次の表に示す形式で指定できます。運用に合わせて使い分けてください。

表1‒5　日時の範囲指定形式

範囲指定パターン

説明

-d 日時

「日時」を指定すると，特定の日時に登録されたイベントに対して実行されたアクションの，アクション結果を表示できます。

例えば10月24日22時に登録されたイベントに対して実行されたアクションの，アクション結果を表示したい場合は次のように指定します。

jcashowa -d 10/24/22:00

-d 日時,日時

「日時,日時」を指定すると，ある日時からある日時までの範囲で登録されたイベントに対して実行されたアクションの，アクション結果をすべて表示できます。

例えば10月24日22時から11月24日10時までに登録されたイベントに対して実行されたアクションの，アクション結果を表示したい場合は次のように指定します。

jcashowa -d 10/24/22:00,11/24/10:00

-d 日時,

「日時,」を指定すると，ある日時以降に登録されたイベントに対して実行されたアクションの，アクション結果をすべて表示できます。

例えば10月24日22時以降に登録されたイベントに対して実行されたアクションの，アクション結果を表示したい場合は次のように指定します。

jcashowa -d 10/24/22:00,

-d ,日時

「,日時」を指定すると，ある日時以前に登録されたイベントに対して実行されたアクションの，アクション結果をすべて表示できます。

例えば11月24日10時以前に登録されたイベントに対して実行されたアクションの，アクション結果を表示したい場合は次のように指定します。

jcashowa -d ,11/24/10:00

指定年の仮定について

jcashowaコマンドを実行した月より，始点に指定した月の方が大きい場合，始点に指定した日時を前年と見なして「前年の始点日時から本年の終点日時まで」と判断します。

始点に指定した月がjcashowaコマンドを実行した月より大きい場合

12月 ≧ 始点指定月 ＞ jcashowaコマンド実行月

始点指定日時の年度はjcashowaコマンドを実行した年の1年前の日時と見なします。

始点に指定した月がjcashowaコマンドを実行した月より小さい場合

jcashowaコマンド実行月 ≧ 始点指定月 ≧ 01月

始点指定日時の年度はjcashowaコマンドを実行した年の日時と見なします。

(例1) 2003/10/31に次のようにjcashowaコマンドを実行した場合

# jcashowa -d 11/01/0:00,10/01/23:59

2002/11/01 0:00 〜 2003/10/01 23:59 の範囲として正常に処理されます。

(例2) 2003/11/01に次のようにjcashowaコマンドを実行した場合

# jcashowa -d 11/01/0:00,10/01/23:59

2003/11/01 0:00 〜 2003/10/01 23:59 の範囲を指定したと見なし，日時の指定範囲が昇順となっていないため，KAVB4009-Wのメッセージが表示されます。

-dオプションは，指定する日時の大小関係を判断します。始点に指定した日時と終点に指定した日時が，昇順となっていない場合はエラーとなります。

秒単位の指定について

秒については，始点に指定した場合は00秒，終点に指定した場合は59秒として扱います。

(例1) 次のようにjcashowaコマンドを実行した場合

# jcashowa -d 10/24/22:00

10月24日 22時00分00秒〜10月24日 22時00分59秒までのアクション結果を表示します。

(例2) 次のようにjcashowaコマンドを実行した場合

# jcashowa -d 10/24/22:00,11/24/10:00

10月24日 22時00分00秒〜11月24日 10時00分59秒までのアクション結果を表示します。

-h 論理ホスト名

クラスタシステムで運用している場合に，論理ホスト名を指定します。指定した論理ホストに対応するアクションの実行結果が表示されます。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。クラスタシステムを使用していない場合には指定は不要です。

アクション情報ファイル名

アクション情報ファイルをフルパスで指定します。

物理ホストのアクション情報ファイルを指定する場合は，-hオプションおよび環境変数JP1_HOSTNAMEを指定しないでください。

論理ホストのアクション情報ファイルを指定する場合は，-hオプションまたは環境変数JP1_HOSTNAMEに論理ホスト名を指定してください。

アクション情報ファイル名には，255バイトまでのファイル名が指定できます。

アクション情報ファイルは，実行したアクションに関する情報を格納するファイルです。

なお，このオプションは，指定したいほかのオプションをすべて指定したあとに指定してください。

戻り値

0

正常終了

3

引数エラー

6

システムエラー

7

コマンドを実行する権限がない（Windowsの場合）

出力形式

jcashowaコマンドを実行すると，自動アクション情報は次の形式で出力されます。

イベント情報※1　 イベントID△イベントDB内通し番号△イベント登録時刻△イベント到着時刻

アクション情報※2 アクション通し番号△アクション種別△状態△遅延状態△PID△実行先ホスト名

アクション情報 アクション投入時刻△アクション開始時刻△アクション終了時刻△終了コード

コマンド　　　 コマンド

メッセージ　　 メッセージ

注※1

自動アクションの設定でAND条件を指定している場合には，実行条件に設定しているイベントのうち，最後に受信したイベントのイベント情報だけ出力されます。

注※2

アクションに遅延監視設定をしていない，またはアクションが遅延していない場合は，次のように出力されます。

アクション情報 アクション通し番号△アクション種別△状態△PID△実行先ホスト名

出力される各項目を次に説明します。

表1‒6　自動アクション情報の出力項目

項目

説明

イベントID

イベントIDが「基本コード:拡張コード」の形式で表示される。

イベントDB内通し番号

イベントのイベントDB内通し番号が表示される。

イベント登録時刻

イベントの登録時刻が「月/日 時:分:秒」の形式で表示される。

イベント到着時刻

イベントの到着時刻が「月/日 時:分:秒」の形式で表示される。

アクション通し番号

実行するアクションのアクション通し番号。

アクション種別

アクションの種別が次のどれかで表示される。

Command（コマンド）

状態

状態アクションの実行状態を表す次の文字列のどれか。

running（実行中）

ended（終了）

none（なし）

fail（実行不可：JP1/Baseに実行要求を渡す前のエラー）

error（実行失敗：JP1/Baseのコマンド制御内でのエラー）

unknown（状態不明：コマンドの実行結果が不明）

wait（送信待機：先行コマンドの終了待ち）

send（送信中：コマンドの送信中）

queue（キューイング：JP1/Base内でのコマンド実行待ち）

cancel（キャンセル）

kill（強制終了）

deterrent（抑止）

アクションをJP1/IM - Viewまたはjcacancelコマンドからキャンセルした場合，上記の状態の後ろにキャンセル状態が表示される。

アクションのキャンセル状態を次に示す。

canceling（キャンセル中）例：queue（canceling）

miss（キャンセル失敗）例：ended（miss）

アクション実行サービスの再起動時にコマンドが再実行，またはアクション再実行用ファイルに出力された場合は，状態の後ろに「-R」が付く（例：ended-R）。

JP1/IM - Viewから再実行をした場合は，上記の状態の後ろに「-RU」が付く（例：ended-RU）。

抑止されたアクションをJP1/IM - Viewから再実行した場合は，上記状態の後ろに「-RUD」が付く（例：ended-RUD）。

抑止されたアクションをJP1/IM - Viewから再実行し，かつ，再実行中にアクション実行サービスの再起動（系切り替え含む）の発生によって再実行，またはアクション再実行用ファイルに出力された場合は，状態の後ろに「-RD」が付く（例：ended-RD）。

抑止されたアクションでアクションの状態が「fail」(実行不可)の場合は「fail」の状態の後ろに「-D」が付く（例：fail-D）。

遅延状態

アクションの遅延状態を表す。

アクションが遅延している場合は，delay（遅延）と表示される。

アクションが遅延していない場合は，何も表示されない。

PID

実行したアクションのプロセスID。

系切り替えが発生して，アクション再実行用ファイルにアクションの情報が記述された場合は，「OUTPUT」と表示される。

実行先ホスト名

アクションを実行したホストのホスト名。

アクション投入時刻

実行するアクションの投入時刻が「月/日 時:分:秒」の形式で表示される。

アクションが投入されていない場合は「**/** **:**:**」と表示される。

アクション開始時刻

実行するアクションの開始時刻が「月/日 時:分:秒」の形式で表示される。

アクションが開始されていない場合は「**/** **:**:**」と表示される。

アクション終了時刻

実行したアクションの終了時刻を「月/日 時:分:秒」の形式で表示する。

アクションが終了していない場合は，「**/** **:**:**」と表示される。

終了コード

実行したアクションの終了コード。

アクションが終了していない場合は，「***」と表示される。

コマンド

アクションとして実行したコマンド。

メッセージ

コマンドが出力したメッセージ。

出力例

（例1）

コマンドが異常終了し，メッセージが出力された場合

イベント情報　   00002000:00000000 20 12/03 12:03:26 12/03 12:03:26
アクション情報   23000 Command ended 27934 raysol
アクション情報   12/03 12:09:15 12/03 12:09:16 12/03 12:09:17 1
コマンド　　　   /usr/local/action
メッセージ　　   abcがみつかりません。

（例2）

コマンドが実行中で，メッセージが出力されていない場合

イベント情報　   00002000:00000000 20 12/03 12:03:26 12/03 12:03:26
アクション情報   23000 Command running 27934 raysol
アクション情報   12/03 12:09:15 12/03 12:09:16 **/** **:**:** ***
コマンド　　　   /usr/local/executing

（例3）

コマンドの状態が実行中，キャンセル状態がキャンセル中で，メッセージが出力されていない場合

イベント情報　   00002000:00000000 20 12/03 12:03:26 12/03 12:03:26
アクション情報   10 Command running(canceling) 15236 raysol
アクション情報   12/03 12:09:15 12/03 12:09:16 **/** **:**:** ***
コマンド　　　   /usr/local/action

（例4）

結果が複数ある場合

イベント情報　   00002000:00000000 20 12/03 12:03:26 12/03 12:03:26
アクション情報   380 Command ended 233 raysol
アクション情報   12/03 12:09:13 12/03 12:09:14 12/03 12:09:14 20
コマンド　　　   /usr/local/action
イベント情報　   00002000:00000000 20 12/03 12:03:26 12/03 12:03:26
アクション情報   381 Command ended 279 raysol
アクション情報   12/05 10:39:20 12/05 10:39:21 12/05 10:39:23 128
コマンド　　　   /usr/local/action2
メッセージ　　   権限がありません
スーパーユーザで実行してください
処理を打ち切ります

（例5）

パラメーターグループ指定のため，一つのイベントに対し複数のアクションがある場合

イベント情報　   00002000:00000000 20 12/03 12:03:26 12/03 12:03:26
アクション情報   987 Command running 2904 raysol
アクション情報   12/05 10:39:20 12/05 10:39:21 12/03 12:09:13 0
コマンド　　　   /usr/local/first
イベント情報　   00002000:00000000 20 12/03 12:03:26 12/03 12:03:26
アクション情報   988 Command ended 2906 raysol
アクション情報   12/05 10:39:20 12/05 10:39:21 12/06 21:02:54 0
コマンド　　　   /usr/local/second

（例6）

系切り替えが発生したため，アクションの情報がアクション再実行用ファイルに記述された場合

イベント情報　   00002000:00000000 20 12/03 12:03:26 12/03 12:03:26
アクション情報   45687 Command ended-R OUTPUT
アクション情報   **/** **:**:** *** **/** **:**:** *** **/** **:**:** ***

（例7）

実行中のアクションが遅延している場合

イベント情報　   00002000:00000000 20 12/03 12:03:26 12/03 12:03:26
アクション情報   987 Command running delay 2904 raysol
アクション情報   12/05 10:39:20 12/05 10:39:21 **/** **:**:** ***
コマンド　　　   /usr/local/executing

jcastatus

機能

稼働している自動アクション機能の動作状態（停止，稼働，休止），または稼働している自動アクション機能が読み込んでいる自動アクション定義ファイルの内容を標準出力に表示します。

なお，このコマンドは同時に複数起動できます。

形式

jcastatus [-h 論理ホスト名]
          [-d]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：なし

格納先ディレクトリ

Windowsの場合

Consoleパス¥bin¥

UNIXの場合

/opt/jp1cons/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，論理ホスト名を指定します。指定した論理ホストに対応する自動アクション機能（イベント基盤サービス）の動作状態が表示されます。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。クラスタシステムを使用していない場合には指定は不要です。

-d

稼働している自動アクション機能が読み込んでいる自動アクション定義ファイルの内容を標準出力に表示します。自動アクション定義ファイルと同じフォーマットで表示されます。

自動アクション定義がすべて無効の状態でも，稼働している自動アクション機能が読み込んでいる自動アクション定義ファイルの内容を標準出力に表示します。

戻り値

0

正常終了

4

自動アクション機能（イベント基盤サービス）からの応答がない

5

自動アクション機能（イベント基盤サービス）が停止または休止中のため，自動アクション定義ファイルの内容が表示できない

6

システムエラー（コマンド側）

152

システムエラー（イベント基盤サービス側）（UNIXの場合）

154

入出力エラー（UNIXの場合）

243

引数指定値不正（UNIXの場合）

-13

引数指定値不正（Windowsの場合）

-102

入出力エラー（Windowsの場合）

-104

システムエラー（イベント基盤サービス側）（Windowsの場合）

出力形式

jcastatusコマンドを実行すると，自動アクション機能の動作状態は次の形式で出力されます。

Status : 状態

「状態」に表示される文字列について次に説明します。

表1‒7　自動アクション機能の動作状態

「状態」に表示される文字列

動作状態

説明

STOP

停止

自動アクション機能（イベント基盤サービス）が停止している状態。

RUNNING

稼働

自動アクション機能（イベント基盤サービス）が起動していて，自動アクション機能が使用できる状態。

STANDBY

休止

イベント基盤サービスは起動しているが，自動アクション機能は休止している状態。

休止状態の間は，イベントは受信されるが，受信されたイベントに対してアクション処理は行われない。

休止状態から稼働状態になった場合は，休止中に受信されたイベントに対してアクション処理は行われない。

出力例

自動アクション機能の動作状態が休止状態であった場合

Status : STANDBY

jcfaleltdef（Windows限定）

機能

指定した監視対象ホストに，リモート監視イベントログトラップのプロファイルを定義します。指定した監視対象ホストのプロファイルが稼働中か停止中かに関係なく，定義を上書きします。

一括リロードをする場合は，jcfaleltdefコマンドで複数の稼働中のリモート監視イベントログトラップを上書きしたあと，jcfaleltreloadコマンドで複数のプロファイルを一括でリロードします。

なお，同時に実行できるコマンドの数は5個までです。

このコマンドを実行するための条件を次に示します。

IM構成管理サービスが起動している

リモートの監視対象ホストが，リモート監視構成下にある

リモートの監視対象ホストが，ホスト情報を収集済みである

形式

jcfaleltdef -f リモート監視イベントログトラップ動作定義ファイル名
            -o 監視対象ホスト名
            [-filter フィルター]
            [-h 論理ホスト名]

実行権限

Administrators権限

格納先ディレクトリ

Managerパス¥bin¥imcf¥

引数

-f リモート監視イベントログトラップ動作定義ファイル名

動作定義ファイルの名称を指定します。

動作定義ファイル名は，フルパスまたはカレントディレクトリからの相対パスで，256バイト以下で指定します。相対パスを指定する場合は，ディレクトリ名を補ったフルパス名が256バイト以下になるように指定してください。

動作定義ファイルは任意のディレクトリに配置し，任意のファイル名を指定できます。

-o 監視対象ホスト名

プロファイルを定義したいリモート監視イベントログトラップのプロファイル監視対象ホスト名を指定します。なお，監視対象ホストのOSは，Windowsだけです。

-filter フィルター

事前フィルターによって，リモートの監視対象ホスト側で取得したイベントログをフィルタリングする場合に，フィルターをログの種類で指定します。

このオプションを指定すると，指定したログの種類と一致したイベントログだけがマネージャーに転送されます。これによって，リモートの監視対象ホストからマネージャーに転送されるログファイルのデータ量を抑制できます。

ログの種類は，次の表に示す文字列で指定します。なお，文字列の大文字・小文字は区別しません。

指定できるログ種別

フィルタリングするイベントのログの種類

Error

エラー，Error，重大，Critical

Warning

警告，Warning

Information

情報，Information，詳細，Verbose

Audit_success

成功の監査，Security Audit Success

Audit_failure

失敗の監査，Security Audit Failure

複数のログの種類を指定する場合は，「,」で区切って指定します。「,」の前後に空白は入れないでください。

-h 論理ホスト名

このコマンドを実行させたい論理ホスト名を指定します。省略した場合は，環境変数JP1_HOSTNAMEに指定されている論理ホスト名が設定されます。JP1_HOSTNAMEに論理ホスト名が設定されていない場合は，物理ホスト名が設定されます。

戻り値

0

追加成功

4

引数不正

6

サーバに接続できない

7

ホスト情報が不正

10

排他編集権取得エラー

14

DB不正

17

権限が不正

18

I/Oエラー

21

同時実行数の上限に達した

255

内部エラー

その他の値

その他のエラー

使用例1

host1にプロファイルを追加する場合

jcfaleltdef -f actionDefinition.conf -o host1

使用例2

host1にプロファイルを追加する場合で，エラー，警告，および失敗の監査のイベントログだけをフィルタリングしたいとき

jcfaleltdef -f actionDefinition.conf -o host1 -filter Error,Warning,Audit_failure

jcfaleltreload（Windows限定）

機能

リモート監視イベントログトラップをリロードします。また，コマンド実行時にトラップ処理をしていた場合，そのトラップ処理の完了後，リロード処理をします。jcfaleltdefコマンドまたは［プロファイル表示/編集］画面で，起動オプションを変更した場合は，リロードしても反映されません。再起動して反映してください。

なお，同時に実行できるコマンドの数は5個までです。

このコマンドを実行するための条件を次に示します。

IM構成管理サービスが起動している

リモートの監視対象ホストが，リモート監視構成下にある

リモートの監視対象ホストが，ホスト情報を収集済みである

DCOMの設定をしている

リモート監視イベントログトラップが起動中である

形式

jcfaleltreload {-o 監視対象ホスト名 | ALL}
               [-h 論理ホスト名]

実行権限

Administrators権限

格納先ディレクトリ

Managerパス¥bin¥imcf¥

引数

-o 監視対象ホスト名

リロードしたいリモート監視イベントログトラップの監視対象ホスト名を指定します。監視対象ホストのOSはWindowsに限ります。

ALL

すべてのリモート監視イベントログトラップを対象とします。

-h 論理ホスト名

このコマンドを実行させたい論理ホスト名を指定します。省略した場合は，環境変数JP1_HOSTNAMEに指定されている論理ホスト名が設定されます。JP1_HOSTNAMEに論理ホスト名が設定されていない場合は，物理ホスト名が設定されます。

戻り値

0

リロード成功

2

一部失敗，またはすべて失敗

4

引数不正

6

サーバに接続できない

7

ホスト情報が不正

10

排他編集権取得エラー

11

動作定義ファイル不正

12

認証定義ファイル不正

13

通信エラー

14

DB不正

15

指定したリモート監視イベントログトラップは停止済み

17

権限が不正

18

I/Oエラー

21

同時実行数の上限に達した

255

内部エラー

その他の値

その他のエラー

使用例

host1のリモート監視イベントログトラップをリロードする場合

jcfaleltreload -o host1

jcfaleltstart（Windows限定）

機能

リモート監視イベントログトラップを起動します。

このコマンドを実行すると，オプションに指定した監視対象ホストのイベントログファイルを収集し，リモート監視イベントログトラップ動作定義ファイルで指定した条件に合うログの1行をJP1イベント化して，イベントサーバに登録します。

-fオプションを指定する場合，コマンドの実行前に，リモート監視イベントログトラップ動作定義ファイルを作成しておく必要があります。また，-fオプションを指定して実行した場合，プロファイルが停止中であれば，既存のリモート監視イベントログトラップ動作定義ファイルを上書きしたあと，リモート監視イベントログトラップのプロファイルのプロセスを起動します。プロファイルが稼働中であれば，既存のリモート監視イベントログトラップ動作定義ファイルを上書きし，サーバに保存したあとにエラーメッセージを出力します。このとき，プロファイルは上書きされる前の動作定義で稼働しています。

なお，同時に実行できるコマンドの数は5個までです。

このコマンドを実行するための条件を次に示します。

IM構成管理サービスが起動している

リモートの監視対象ホストが，リモート監視構成下にある

リモートの監視対象ホストが，ホスト情報を収集済みである

DCOMの設定をしている

形式

jcfaleltstart
        -o 監視対象ホスト名
        [-h 論理ホスト名]
        [-f リモート監視イベントログトラップ動作定義ファイル名
        [-filter フィルター]]

実行権限

Administrators権限

格納先ディレクトリ

Managerパス¥bin¥imcf¥

引数

-o 監視対象ホスト名

起動したいリモート監視イベントログトラップの監視対象ホスト名を指定します。監視対象ホストのOSはWindowsに限ります。

-h 論理ホスト名

このコマンドを実行させたい論理ホスト名を指定します。省略した場合は，環境変数JP1_HOSTNAMEに指定されている論理ホスト名が設定されます。JP1_HOSTNAMEに論理ホスト名が設定されていない場合は，物理ホスト名が設定されます。

-f リモート監視イベントログトラップ動作定義ファイル名

動作定義ファイルの名称を指定します。-fオプションを指定した場合，既存のリモート監視イベントログトラップ動作定義ファイルを上書きして起動します。また，-fオプションを指定しない場合は，既存のリモート監視イベントログトラップを起動します。

動作定義ファイル名は，フルパスまたはカレントディレクトリからの相対パスで，256バイト以下で指定します。相対パスを指定する場合は，ディレクトリ名を補ったフルパス名が256バイト以下になるように指定してください。

動作定義ファイルは任意のディレクトリに配置し，任意のファイル名を指定できます。

-filter フィルター

事前フィルターによって，リモートの監視対象ホスト側で取得したイベントログをフィルタリングする場合に，フィルターをログの種類で指定します。-fオプションを指定したときだけ指定できます。

このオプションを指定すると，指定したログの種類と一致したイベントログだけがマネージャーに転送されます。これによって，リモートの監視対象ホストからマネージャーに転送されるログファイルのデータ量を抑制できます。

ログの種類は，次の表に示す文字列で指定します。なお，文字列の大文字・小文字は区別しません。

指定できるログ種別

フィルタリングするイベントのログの種類

Error

エラー，Error，重大，Critical

Warning

警告，Warning

Information

情報，Information，詳細，Verbose

Audit_success

成功の監査，Security Audit Success

Audit_failure

失敗の監査，Security Audit Failure

複数のログの種類を指定する場合は，「,」で区切って指定します。「,」の前後に空白は入れないでください。

戻り値

0

起動成功

4

引数不正

6

サーバに接続できない

7

ホスト情報が不正

8

すでに稼働済み

9

プロファイルの各種制限値を超過

10

排他編集権取得エラー

11

動作定義ファイル不正

12

認証情報定義ファイル不正

13

通信エラー

14

DB不正

17

権限が不正

18

I/Oエラー

21

同時実行数の上限に達した

255

内部エラー

その他の値

その他のエラー

使用例1

host1のリモート監視イベントログトラップを起動する場合

jcfaleltstart -o host1 -f actionDefinition.conf

使用例2

host1のリモート監視イベントログトラップを起動する場合で，エラー，警告，および失敗の監査のイベントログだけをフィルタリングしたいとき

jcfaleltstart -o host1 -f actionDefinition.conf -filter Error,Warning,Audit_failure

jcfaleltstat（Windows限定）

機能

リモート監視イベントログトラップの動作状況を表示します。

このコマンドを実行すると，引数に指定した監視対象ホストを監視対象とするリモート監視イベントログトラップの動作状況を返します。

-oオプションでALLを指定していてリモート監視構成にホストが存在しない，またはWindowsではない場合は，そのことを示すメッセージが表示されます。

なお，同時に実行できるコマンドの数は5個までです。

このコマンドを実行するための条件を次に示します。

IM構成管理サービスが起動している

リモートの監視対象ホストが，リモート監視構成下にある

リモートの監視対象ホストが，ホスト情報を収集済みである

形式

jcfaleltstat {-o 監視対象ホスト名 | ALL}
             [-h 論理ホスト名]

実行権限

Administrators権限

格納先ディレクトリ

Managerパス¥bin¥imcf¥

表示形式

jcfaleltstatコマンドを実行すると，次の形式で出力結果が表示されます。

注

この例では，説明のために行頭に行番号を入れて示しています。

1　Message ID△メッセージ

2　Message ID△メッセージ

3　ホスト名△状態

4　ホスト名△状態

5　ホスト名△状態

6　　　　　：

1行目

コマンド実行が開始したことを示すメッセージを表示します。

2行目

次の表示範囲を示すメッセージを表示します。

すべて

指定したホスト

指定したホストの指定したイベントログトラップ

3〜6行目

指定した範囲内のリモートの監視対象ホスト（Windows）のイベントログトラップに関する状態を表示します。表示する状態は，次のとおりです。

START：イベントログトラップが起動中の状態

STOP：イベントログトラップが停止中の状態

EDIT：イベントログトラップの動作定義ファイルが編集されているが，反映していない状態

FAIL：次の理由によってイベントログトラップの状態の取得に失敗した状態

・ホスト不正（ホスト情報未収集，または収集失敗状態となっている）

・WMI通信でエラーが発生した

・認証エラー

・I/Oエラー

・排他権取得エラー

・内部エラー

引数

-o 監視対象ホスト名

動作状況を確認したいリモート監視イベントログトラップの監視対象ホスト名を指定します。監視対象ホストのOSはWindowsに限ります。

ALL

すべてのリモート監視イベントログトラップを対象とします。

-h 論理ホスト名

このコマンドを実行させたい論理ホスト名を指定します。省略した場合は，環境変数JP1_HOSTNAMEに指定されている論理ホスト名が設定されます。JP1_HOSTNAMEに論理ホスト名が設定されていない場合は，物理ホスト名が設定されます。

戻り値

0

リモート監視イベントログトラップがすべて稼働している

1

リモート監視イベントログトラップが一部稼働している（ALLオプションを指定したとき）

2

一部失敗，またはすべて失敗

4

引数不正

6

サーバに接続できない

7

ホスト情報が不正

14

DB不正

17

権限が不正

18

I/Oエラー

19

リモート監視イベントログトラップがすべて停止している

21

同時実行数の上限に達した

255

内部エラー

その他の値

その他のエラー

使用例

host1のリモート監視イベントログトラップの動作状況を表示する場合

jcfaleltstat -o host1

jcfaleltstop（Windows限定）

機能

リモート監視イベントログトラップを停止します。

なお，同時に実行できるコマンドの数は5個までです。

このコマンドを実行するための条件を次に示します。

IM構成管理サービスが起動している

リモートの監視対象ホストが，リモート監視構成下にある

リモートの監視対象ホストが，ホスト情報を収集済みである

DCOMの設定をしている

リモート監視ログファイルトラップが起動中である

形式

jcfaleltstop {-o 監視対象ホスト名 | ALL}
             [-h 論理ホスト名]

実行権限

Administrators権限

格納先ディレクトリ

Managerパス¥bin¥imcf¥

引数

-o 監視対象ホスト名

停止したいリモート監視イベントログトラップの監視対象ホスト名を指定します。監視対象ホストのOSはWindowsに限ります。

ALL

すべてのリモート監視イベントログトラップを対象とします。

-h 論理ホスト名

このコマンドを実行させたい論理ホスト名を指定します。省略した場合は，環境変数JP1_HOSTNAMEに指定されている論理ホスト名が設定されます。JP1_HOSTNAMEに論理ホスト名が設定されていない場合は，物理ホスト名が設定されます。

戻り値

0

停止成功

2

一部失敗，またはすべて失敗

4

引数不正

6

サーバに接続できない

7

ホスト情報が不正

10

排他編集権取得エラー

12

認証定義ファイル不正

13

通信エラー

14

DB不正

15

指定したリモート監視イベントログトラップは停止済み

17

権限が不正

18

I/Oエラー

21

同時実行数の上限に達した

255

内部エラー

その他の値

その他のエラー

使用例

すべてのリモート監視イベントログトラップを停止する場合

jcfaleltstop ALL

jcfallogdef

機能

指定した監視対象ホストに，リモート監視ログファイルトラップのプロファイルを追加または削除します。-fオプションを指定した場合はプロファイルを追加し，-dオプションを指定した場合はプロファイルを削除します。

プロファイルを追加するときに，指定した監視対象ホストに同じ監視名のプロファイルがすでにある場合は，そのプロファイルが稼働中か停止中かに関係なく，動作定義ファイルを上書きします。

プロファイルを削除するときは，指定したプロファイルが停止中のときだけ，このコマンドを実行できます。

一括リロードをする場合は，jcfallogdefコマンドで複数の稼働中のリモート監視ログファイルトラップを上書きしたあと，jcfallogreloadコマンドで複数のプロファイルを一括でリロードします。

なお，同時に実行できるコマンドの数は5個までです。

このコマンドを実行するための条件を次に示します。

IM構成管理サービスが起動している

リモートの監視対象ホストが，リモート監視構成下にある

リモートの監視対象ホストが，ホスト情報を収集済みである

形式

jcfallogdef
        -a 監視名
        -o 監視対象ホスト名
        [-h 論理ホスト名]
        {-f リモート監視ログファイルトラップ動作定義ファイル名
            -c 文字コード
            [-filter フィルター]
            [-m イベント化するデータの最大長（バイト）]
            [-p ログデータ出力元プログラム名]
            [-r]
            [-t ファイル監視間隔（秒）]
            ログファイル名1 […ログファイル名32] |
         -d}
        [-q]

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Managerパス¥bin¥imcf¥

UNIXの場合

/opt/jp1imm/bin/imcf/

引数

-a 監視名

リモート監視ログファイルトラップを識別する監視名を指定します。

監視名は30バイト以内の文字列で指定します。使用できる文字は英数字，ハイフン，およびアンダーラインで，先頭の文字は必ず英数字を指定します。大文字，小文字は区別されません。

なお，監視名と監視対象ホストの組は一意である必要があり，jcfallogstartで指定したほかの監視名と監視対象の組との重複はできません。ただし，JP1/Baseのjevlogstartで指定される監視名との重複はできます。

-o 監視対象ホスト名

プロファイルを追加または削除したいリモート監視ログファイルトラップの監視対象ホスト名を指定します。

-h 論理ホスト名

このコマンドを実行させたい論理ホスト名を指定します。省略した場合は，環境変数JP1_HOSTNAMEに指定されている論理ホスト名が設定されます。JP1_HOSTNAMEに論理ホスト名が設定されていない場合は，物理ホスト名が設定されます。

-f リモート監視ログファイルトラップ動作定義ファイル名

動作定義ファイルの名称を指定します。

動作定義ファイル名は，フルパスまたはカレントディレクトリからの相対パスで，256バイト以下で指定します。相対パスを指定する場合は，ディレクトリ名を補ったフルパス名が256バイト以下になるように指定してください。

動作定義ファイルは任意のディレクトリに配置し，任意のファイル名を指定できます。

-c 文字コード

ログファイルの文字コードを指定します。-fオプションを指定したときだけ指定できます。

指定できる文字コードは次のとおりです。

表1‒8　文字コード

監視対象OS

日本語の場合

英語の場合

中国語の場合

AIX

SJIS

SJISを指定した場合，SJIS/Ja_JPが設定されます。

SJIS/Ja_JP

SJIS/Ja_JP.IBM-932

EUC

EUCを指定した場合，EUC/ja_JPが設定されます。

EUC/ja_JP

EUC/ja_JP.IBM-eucJP

UTF-8

UTF-8を指定した場合，UTF-8/JA_JPが設定されます。

UTF-8/JA_JP

UTF-8/JA_JP.UTF-8

C

C

GB18030

GB18030を指定した場合，GB18030/Zh_CN.GB18030が設定されます。

GB18030/Zh_CN.GB18030

GB18030/Zh_CN

UTF-8

UTF-8を指定した場合，UTF-8/ZH_CNが設定されます。

UTF-8/ZH_CN

UTF-8/ZH_CN.UTF-8

C

HP-UX

SJIS

SJISを指定した場合，SJIS/ja_JP.SJISが設定されます。

SJIS/ja_JP.SJIS

SJIS/japanese

EUC

EUCを指定した場合，EUC/ja_JP.eucJPが設定されます。

EUC/ja_JP.eucJP

EUC/japanese.euc

UTF-8

UTF-8を指定した場合，UTF-8/ja_JP.utf8が設定されます。

UTF-8/ja_JP.utf8

C

C

GB18030

GB18030を指定した場合，GB18030/zh_CN.gb18030が設定されます。

GB18030/zh_CN.gb18030

UTF-8

UTF-8を指定した場合，UTF-8/zh_CN.utf8が設定されます。

UTF-8/zh_CN.utf8

C

Linux

UTF-8

UTF-8を指定した場合，UTF-8/ja_JP.UTF-8が設定されます。

UTF-8/ja_JP.UTF-8

UTF-8/ja_JP.utf8

SJIS※1

SJISを指定した場合，SJIS/ja_JP.sjisが設定されます。

SJIS/ja_JP.sjis※1

SJIS/ja_JP.SJIS※1

C

UTF-8

UTF-8を指定した場合，UTF-8/en_US.UTF-8が設定されます。

UTF-8/en_US.UTF-8

UTF-8/en_US.utf8

C

GB18030

GB18030を指定した場合，GB18030/zh_CN.gb18030が設定されます。

GB18030/zh_CN.gb18030

UTF-8

UTF-8を指定した場合，UTF-8/zh_CN.utf8が設定されます。

UTF-8/zh_CN.utf8

C

Solaris

EUC

EUCを指定した場合，EUC/jaが設定されます。

EUC/ja

EUC/japanese

EUC/ja_JP.eucJP

SJIS

SJISを指定した場合，SJIS/ja_JP.PCKが設定されます。

SJIS/ja_JP.PCK

UTF-8

UTF-8を指定した場合，UTF-8/ja_JP.UTF-8が設定されます。

UTF-8/ja_JP.UTF-8

C

C

GB18030

GB18030を指定した場合，GB18030/zh_CN.GB18030が設定されます。

GB18030/zh_CN.GB18030

GB18030/zh_CN.GB18030@pinyin

GB18030/zh_CN.GB18030@radical

GB18030/zh_CN.GB18030@stroke

UTF-8

UTF-8を指定した場合，UTF-8/zh.UTF-8が設定されます。

UTF-8/zh.UTF-8

UTF-8/zh_CN.UTF-8

UTF-8/zh_CN.UTF-8@pinyin

UTF-8/zh_CN.UTF-8@radical

UTF-8/zh_CN.UTF-8@stroke

C

Windows

SJIS

SJIS※2

C

GB18030

注※1

監視対象OSがSUSE Linuxの場合だけ有効です。

注※2

英語OSの場合，文字コードにSJISを指定してもCで動作します。

-filter フィルター

事前フィルターによって，リモートの監視対象ホスト側で取得したログファイルをフィルタリングする場合に，フィルターを正規表現で指定します。

このオプションを指定すると，指定した正規表現と一致したログデータだけがマネージャーに転送されます。これによって，リモートの監視対象ホストからマネージャーに転送されるログファイルのデータ量を抑制できます。

このオプションは，-fオプションを指定したときだけ指定できます。

このオプションは，リモートの監視対象ホストがUNIXの場合だけ有効です。前提条件として，SSH接続でgrepコマンドが実行できる必要があります。リモートの監視対象ホストがWindowsの場合は，このオプションを指定しても無視されます。

指定できる正規表現の形式は，リモートの監視対象ホストのgrepコマンドの-Eオプションに指定できる拡張正規表現の形式と同一です。環境変数は使用できません。

正規表現は128バイト以内の文字列で指定します。使用できる文字列は，「'」，「"」，「<」，「>」，および制御文字を除く半角英数字，半角スペース，記号です。文字列に半角スペースが含まれている場合は，前後をダブルクォーテーション「"」で囲む必要があります。

grepコマンドのパス例を次に示します。詳細は，各OSのgrepコマンドのマニュアルを参照してください。

Linuxの場合：/bin/grep

Solarisの場合：/usr/xpg4/bin/grep

Linux，Solaris以外の場合：/usr/bin/grep

-m イベント化するデータの最大長（バイト）

ログファイルの1行を，先頭から何バイト読み込むかを指定します。指定できるバイト数は1〜1,024です。このオプションを省略した場合は512が設定されます。

行の終了文字は終了記号「¥0」に変更されます。ログファイルの1行がこのオプションで指定されたバイト数を超える場合，最後の1バイトが「¥0」に変更されます。

このオプションで指定した値は，入力したログファイルの1行の有効範囲を示します。したがって，リモート監視ログファイルトラップ動作定義ファイルのMARKSTRパラメーターの正規表現とACTDEFパラメーターの正規表現をチェックするのは，ここで指定した範囲内です。つまり，有効範囲を超えたカラムに対応する正規表現があっても，それらはチェックの対象にはなりません。

-p ログデータ出力元プログラム名

ログデータを出力するプログラム名を指定します。指定した名前はJP1/IM - Viewの［イベントコンソール］画面に表示されます。

表示される名称は次のとおりです。

Windowsの場合

/HITACHI/JP1/NT_LOGTRAP/ログデータ出力元プログラム名

UNIXの場合

/HITACHI/JP1/UX_LOGTRAP/ログデータ出力元プログラム名

このオプションを省略すると，Windowsの場合は「/HITACHI/JP1/NT_LOGTRAP」，UNIXの場合は「/HITACHI/JP1/UX_LOGTRAP」と表示されます。

-r

このオプションを指定すると，次の場合に，ログが収集できるようになるまで，-tオプションで指定した間隔で収集を試みます。

リモート監視ログファイルトラップの起動時に，リモートの監視対象ホストにアクセスできない場合

リモート監視ログファイルトラップの稼働中に，リモートの監視対象ホストにアクセスできなくなった場合

リモート監視ログファイルトラップの起動時に，監視対象のログファイルにアクセスできない場合

リモート監視ログファイルトラップの稼働中に，監視対象のログファイルにアクセスできなくなった場合

-rオプションは，次の場合に指定してください。

リモート監視ログファイルトラップの起動後に，リモートの監視対象ホストにアクセスできるようになる場合

リモート監視ログファイルトラップの起動後に，監視対象のログファイルが作成される場合

リモートの監視対象ホストにアクセスできなくでも監視を継続したい場合

このオプションを省略した場合，次の動作となります。

リモート監視ログファイルトラップを起動した時点で，監視対象のログファイルの収集ができない場合，起動を中止し処理を終了します。

稼働中に監視対象のログファイルの収集ができなくなった場合，リモート監視ログファイルトラップ動作定義ファイルに指定したリトライ回数および間隔でリトライします。

-t ファイル監視間隔（秒）

ファイルの監視間隔を指定します。指定できる値は60〜86,400（単位：秒）です。省略した場合は300が設定されます。

WRAP2形式のログファイルを監視する場合

ラップアラウンドする頻度が高い場合や監視間隔を長く指定した場合に，リモート監視ログファイルトラップがデータを読み込む前に上書きされてしまい，データの読み込み漏れが発生するおそれがあります。データの読み込み漏れの予防策として，次の監視間隔の見積もり式を参考にしてください。

ログファイルサイズ（バイト）×ログファイル数>1秒当たりの出力サイズ（バイト）×監視間隔（秒）

ログファイル名1 […ログファイル名32]

監視するログファイル名を指定します。ログファイル名は256バイト以内の文字列で指定します。監視対象ホストがWindowsの場合は，ホスト名を除いたネットワークパス名で指定します。UNIXの場合はフルパスで指定します。なお，ワイルドカードを使用して，監視するログファイルを指定することはできません。

監視対象ホストがUNIXの場合，監視対象ファイルパスに半角英数字および「-」，「_」，「.」，「/」を含むログファイルを監視できます。それ以外の文字を含むファイルパスについては，正常に監視できないときがあります。

指定できるファイル数は32以下で，指定できるファイル形式は次の形式です。

シーケンシャルファイル(SEQ)

シーケンシャルファイル(SEQ2)

ラップアラウンドファイル(WRAP2)

-d

リモート監視ログファイルトラップのプロファイルを削除します。

リモート監視ログファイルトラップをプロファイルツリーから削除することになるため，問題ないかを確認するためのメッセージが表示されます。

-q

このオプションを指定すると，-dオプション指定時でも確認メッセージが表示されません。-dオプションを指定していない場合は，指定しても無視されます。

注意事項

このコマンドは実行系ホストでだけ実行してください。コマンドの実行時は共有ディスクをマウントした状態で実行してください。

このコマンドは待機系ホストでは実行しないでください。

UNIX/Linux環境の待機系ホストで実行した場合，待機系ホストのローカルディスクのルート直下に「/共有ディレクトリ名」という不要なディレクトリが作成され，その配下にも次の不要なディレクトリとファイルが作成されます。

/共有ディレクトリ名/jp1imm

/共有ディレクトリ名/jp1imm/log

/共有ディレクトリ名/jp1imm/log/imcf

上記のローカルディスクにあるルート直下の「/共有ディレクトリ名」およびそのディレクトリ配下のファイルは不要であるため削除してください。削除する際は誤って共有ディスク上のディレクトリおよびファイルを削除しないように，必ず待機系ホスト上で共有ディスクがマウントされていないことを確認して実施してください。

戻り値

0

追加成功/削除成功

4

引数不正

6

サーバに接続できない

7

ホスト情報が不正

8

指定した監視名は稼働済み（-dオプション指定時）

9

プロファイルの各種制限値を超過

10

排他編集権取得エラー

14

DB不正

17

権限が不正

18

I/Oエラー

21

同時実行数の上限に達した

255

内部エラー

その他の値

その他のエラー

使用例1

host1にプロファイルを追加する場合

jcfallogdef -a name1 -o host1 -f actionDefinition.conf -c SJIS -filter ".*-E" /log/sample.log

使用例2

host1のプロファイルを削除する場合

jcfallogdef -a name1 -o host1 -d -q

jcfallogreload

機能

リモート監視ログファイルトラップ動作定義ファイルをリロードします。

リロードできる定義情報は，動作定義ファイルのMARKSTRおよびACTDEFパラメーターの値だけです。jcfallogdefコマンドまたは［プロファイル表示/編集］画面で，MARKSTRおよびACTDEFパラメーター以外の値を変更した場合は，リロードしても反映されません。再起動して反映してください。また，リロードコマンドの実行がトラップ処理と重なった場合，そのトラップ処理にリロードする内容が反映されます。

なお，同時に実行できるコマンドの数は5個までです。

このコマンドを実行するための条件を次に示します。

IM構成管理サービスが起動している

リモートの監視対象ホストが，リモート監視構成下にある

リモートの監視対象ホストが，ホスト情報を収集済みである

SSHで通信する場合，対象のリモートの監視対象ホストと公開鍵暗号方式でSSH認証できる

NetBIOS（NetBIOS over TCP/IP）で通信する場合，監視するログファイルが共有されている

リモート監視ログファイルトラップが起動中である

形式

jcfallogreload {-o 監視対象ホスト名 [-a 監視名] | ALL}
               [-h 論理ホスト名]

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Managerパス¥bin¥imcf¥

UNIXの場合

/opt/jp1imm/bin/imcf/

引数

-o 監視対象ホスト名

リロードしたいリモート監視ログファイルトラップの監視対象ホスト名を指定します。

-a 監視名

リロードしたいリモート監視ログファイルトラップの監視名を指定します。

監視名は30バイト以内の文字列で指定します。使用できる文字は英数字，ハイフン，およびアンダーラインで，先頭の文字は必ず英数字を指定します。大文字，小文字は区別されません。

ALL

すべてのリモート監視ログファイルトラップを対象とします。

-h 論理ホスト名

このコマンドを実行させたい論理ホスト名を指定します。省略した場合は，環境変数JP1_HOSTNAMEに指定されている論理ホスト名が設定されます。JP1_HOSTNAMEに論理ホスト名が設定されていない場合は，物理ホスト名が設定されます。

注意事項

このコマンドは実行系ホストでだけ実行してください。コマンドの実行時は共有ディスクをマウントした状態で実行してください。

このコマンドは待機系ホストでは実行しないでください。

UNIX/Linux環境の待機系ホストで実行した場合，待機系ホストのローカルディスクのルート直下に「/共有ディレクトリ名」という不要なディレクトリが作成され，その配下にも次の不要なディレクトリとファイルが作成されます。

/共有ディレクトリ名/jp1imm

/共有ディレクトリ名/jp1imm/log

/共有ディレクトリ名/jp1imm/log/imcf

上記のローカルディスクにあるルート直下の「/共有ディレクトリ名」およびそのディレクトリ配下のファイルは不要であるため削除してください。削除する際は誤って共有ディスク上のディレクトリおよびファイルを削除しないように，必ず待機系ホスト上で共有ディスクがマウントされていないことを確認して実施してください。

戻り値

0

リロード成功

2

一部失敗，またはすべて失敗

4

引数不正

6

サーバに接続できない

7

ホスト情報が不正

10

排他編集権取得エラー

11

動作定義ファイル不正

12

認証情報定義ファイル不正

13

通信エラー

14

DB不正

15

指定したリモート監視ログファイルトラップは停止済み

17

権限が不正

18

I/Oエラー

21

同時実行数の上限に達した

255

内部エラー

その他の値

その他のエラー

使用例

host1のname1のリモート監視ログファイルトラップをリロードする場合

jcfallogreload -o host1 -a name1

jcfallogstart

機能

リモート監視ログファイルトラップを起動します。

このコマンドを実行すると，監視対象ホストのログファイルを収集し，リモート監視ログファイルトラップ動作定義ファイルで指定した条件に合うログの1行をJP1イベント化して，イベントサーバに登録します。

-fオプションを指定した場合，新規にリモート監視ログファイルトラップのプロファイルを追加したあと，プロセスを起動します。指定した監視対象ホストに同じ監視名のプロファイルがすでに存在する場合，プロファイルが停止中であれば，リモート監視ログファイルトラップ動作定義ファイルを上書きしたあと，リモート監視ログファイルトラップのプロセスを起動します。プロファイルが稼働中だった場合，動作定義ファイルを上書きして，サーバに保存したあとにエラーメッセージが出力され，処理を中断します。このとき，プロファイルは上書きされる前の動作定義で稼働しています。-fオプションを指定しない場合，既存のリモート監視ログファイルトラップのプロファイルのプロセスを起動します。

データの形式が異なるログファイルは同時に扱えません。この場合は，新たに別のリモート監視ログファイルトラップを起動してください。

なお，同時に実行できるコマンドの数は5個までです。

このコマンドを実行するための条件を次に示します。

IM構成管理サービスが起動している

リモートの監視対象ホストが，リモート監視構成下にある

リモートの監視対象ホストが，ホスト情報を収集済みである

SSHで通信する場合，対象のリモートの監視対象ホストと公開鍵暗号方式でSSH認証できる

NetBIOS（NetBIOS over TCP/IP）で通信する場合，監視するログファイルが共有されている

形式

jcfallogstart
        -a 監視名
        -o 監視対象ホスト名
        [-h 論理ホスト名]
        [-f リモート監視ログファイルトラップ動作定義ファイル名
          -c 文字コード
          [-filter フィルター]
          [-m イベント化するデータの最大長（バイト）]
          [-p ログデータ出力元プログラム名]
          [-r]
          [-t ファイル監視間隔（秒）]
          ログファイル名1 […ログファイル名32]]

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Managerパス¥bin¥imcf¥

UNIXの場合

/opt/jp1imm/bin/imcf/

引数

-a 監視名

リモート監視ログファイルトラップを識別する監視名を指定します。

監視名は30バイト以内の文字列で指定します。使用できる文字は英数字，ハイフン，およびアンダーラインで，先頭の文字は必ず英数字を指定します。大文字，小文字は区別されません。

なお，監視名と監視対象ホストの組は一意である必要があり，jcfallogstartで指定したほかの監視名と監視対象の組との重複はできません。ただし，JP1/Baseのjevlogstartで指定される監視名との重複はできます。

-o 監視対象ホスト名

起動したいリモート監視ログファイルトラップの監視対象ホスト名を指定します。

-h 論理ホスト名

このコマンドを実行させたい論理ホスト名を指定します。省略した場合は，環境変数JP1_HOSTNAMEに指定されている論理ホスト名が設定されます。JP1_HOSTNAMEに論理ホスト名が設定されていない場合は，物理ホスト名が設定されます。

-f リモート監視ログファイルトラップ動作定義ファイル名

動作定義ファイル名は，フルパスまたはカレントディレクトリからの相対パスで，256バイト以下で指定します。相対パスを指定する場合は，ディレクトリ名を補ったフルパス名が256バイト以下になるように指定してください。

動作定義ファイルは任意のディレクトリに配置し，任意のファイル名を指定できます。

このオプションを指定した場合，新規にリモート監視ログファイルトラップを作成して起動します。このオプションを省略した場合は，既存のリモート監視ログファイルトラップを起動します。

-c 文字コード

ログファイルの文字コードを指定します。-fオプションを指定したときだけ指定できます。

指定できる文字コードは次のとおりです。

表1‒9　文字コード

監視対象OS

日本語の場合

英語の場合

中国語の場合

AIX

SJIS

SJISを指定した場合，SJIS/Ja_JPが設定されます。

SJIS/Ja_JP

SJIS/Ja_JP.IBM-932

EUC

EUCを指定した場合，EUC/ja_JPが設定されます。

EUC/ja_JP

EUC/ja_JP.IBM-eucJP

UTF-8

UTF-8を指定した場合，UTF-8/JA_JPが設定されます。

UTF-8/JA_JP

UTF-8/JA_JP.UTF-8

C

C

GB18030

GB18030を指定した場合，GB18030/Zh_CN.GB18030が設定されます。

GB18030/Zh_CN.GB18030

GB18030/Zh_CN

UTF-8

UTF-8を指定した場合，UTF-8/ZH_CNが設定されます。

UTF-8/ZH_CN

UTF-8/ZH_CN.UTF-8

C

HP-UX

SJIS

SJISを指定した場合，SJIS/ja_JP.SJISが設定されます。

SJIS/ja_JP.SJIS

SJIS/japanese

EUC

EUCを指定した場合，EUC/ja_JP.eucJPが設定されます。

EUC/ja_JP.eucJP

EUC/japanese.euc

UTF-8

UTF-8を指定した場合，UTF-8/ja_JP.utf8が設定されます。

UTF-8/ja_JP.utf8

C

C

GB18030

GB18030を指定した場合，GB18030/zh_CN.gb18030が設定されます。

GB18030/zh_CN.gb18030

UTF-8

UTF-8を指定した場合，UTF-8/zh_CN.utf8が設定されます。

UTF-8/zh_CN.utf8

C

Linux

SJIS/ja_JP.sjis※1

SJIS/ja_JP.SJIS※1

UTF-8

UTF-8を指定した場合，UTF-8/ja_JP.UTF-8が設定されます。

UTF-8/ja_JP.UTF-8

UTF-8/ja_JP.utf8

C

UTF-8

UTF-8を指定した場合，UTF-8/en_US.UTF-8が設定されます。

UTF-8/en_US.UTF-8

UTF-8/en_US.utf8

C

GB18030

GB18030を指定した場合，GB18030/zh_CN.gb18030が設定されます。

GB18030/zh_CN.gb18030

UTF-8

UTF-8を指定した場合，UTF-8/zh_CN.utf8が設定されます。

UTF-8/zh_CN.utf8

C

Solaris

EUC

EUCを指定した場合，EUC/jaが設定されます。

EUC/ja

EUC/japanese

EUC/ja_JP.eucJP

SJIS

SJISを指定した場合，SJIS/ja_JP.PCKが設定されます。

SJIS/ja_JP.PCK

UTF-8

UTF-8を指定した場合，UTF-8/ja_JP.UTF-8が設定されます。

UTF-8/ja_JP.UTF-8

C

C

GB18030

GB18030を指定した場合，GB18030/zh_CN.GB18030が設定されます。

GB18030/zh_CN.GB18030

GB18030/zh_CN.GB18030@pinyin

GB18030/zh_CN.GB18030@radical

GB18030/zh_CN.GB18030@stroke

UTF-8

UTF-8を指定した場合，UTF-8/zh.UTF-8が設定されます。

UTF-8/zh.UTF-8

UTF-8/zh_CN.UTF-8

UTF-8/zh_CN.UTF-8@pinyin

UTF-8/zh_CN.UTF-8@radical

UTF-8/zh_CN.UTF-8@stroke

C

Windows

SJIS

SJIS※2

C

GB18030

注※1

監視対象OSがSUSE Linuxの場合だけ有効です。

注※2

英語OSの場合，文字コードにSJISを指定してもCで動作します。

-filter フィルター

事前フィルターによって，リモートの監視対象ホスト側で取得したログファイルをフィルタリングする場合に，フィルターを正規表現で指定します。

このオプションを指定すると，指定した正規表現と一致したログデータだけがマネージャーに転送されます。これによって，リモートの監視対象ホストからマネージャーに転送されるログファイルのデータ量を抑制できます。

このオプションは，-fオプションを指定したときだけ指定できます。

このオプションは，リモートの監視対象ホストがUNIXの場合だけ有効です。前提条件として，SSH接続でgrepコマンドが実行できる必要があります。リモートの監視対象ホストがWindowsの場合は，このオプションを指定しても無視されます。

指定できる正規表現の形式は，リモートの監視対象ホストのgrepコマンドの-Eオプションに指定できる拡張正規表現の形式と同一です。環境変数は使用できません。

正規表現は128バイト以内の文字列で指定します。使用できる文字列は，「'」，「"」，「<」，「>」，および制御文字を除く半角英数字，半角スペース，記号です。文字列に半角スペースが含まれている場合は，前後をダブルクォーテーション「"」で囲む必要があります。

grepコマンドのパス例を次に示します。詳細は，各OSのgrepコマンドのマニュアルを参照してください。

Linuxの場合：/bin/grep

Solarisの場合：/usr/xpg4/bin/grep

Linux，Solaris以外の場合：/usr/bin/grep

-m イベント化するデータの最大長（バイト）

ログファイルの1行を，先頭から何バイト読み込むかを指定します。指定できるバイト数は1〜1,024です。このオプションを省略した場合は512が設定されます。

行の終了文字は終了記号「¥0」に変更されます。ログファイルの1行がこのオプションで指定されたバイト数を超える場合，最後の1バイトが「¥0」に変更されます。

このオプションで指定した値は，入力したログファイルの1行の有効範囲を示します。したがって，リモート監視ログファイルトラップ動作定義ファイルのMARKSTRパラメーターの正規表現とACTDEFパラメーターの正規表現をチェックするのは，ここで指定した範囲内です。つまり，有効範囲を超えたカラムに対応する正規表現があっても，それらはチェックの対象にはなりません。

-p ログデータ出力元プログラム名

ログデータを出力するプログラム名を指定します。指定した名前はJP1/IM - Viewの［イベントコンソール］画面に表示されます。

表示される名称は次のとおりです。

Windowsの場合

/HITACHI/JP1/NT_LOGTRAP/ログデータ出力元プログラム名

UNIXの場合

/HITACHI/JP1/UX_LOGTRAP/ログデータ出力元プログラム名

このオプションを省略すると，Windowsの場合は「/HITACHI/JP1/NT_LOGTRAP」，UNIXの場合は「/HITACHI/JP1/UX_LOGTRAP」と表示されます。

-r

このオプションを指定すると，次の場合に，ログが収集できるようになるまで，-tオプションで指定した間隔で収集を試みます。

リモート監視ログファイルトラップの起動時に，リモートの監視対象ホストにアクセスできない場合

リモート監視ログファイルトラップの稼働中に，リモートの監視対象ホストにアクセスできなくなった場合

リモート監視ログファイルトラップの起動時に，監視対象のログファイルにアクセスできない場合

リモート監視ログファイルトラップの稼働中に，監視対象のログファイルにアクセスできなくなった場合

-rオプションは，次の場合に指定してください。

リモート監視ログファイルトラップの起動後に，リモートの監視対象ホストにアクセスできるようになる場合

リモート監視ログファイルトラップの起動後に，監視対象のログファイルが作成される場合

リモートの監視対象ホストにアクセスできなくでも監視を継続したい場合

このオプションを省略した場合，次の動作となります。

リモート監視ログファイルトラップを起動した時点で，監視対象のログファイルの収集ができない場合，起動を中止し処理を終了します。

稼働中に監視対象のログファイルの収集ができなくなった場合，リモート監視ログファイルトラップ動作定義ファイルに指定したリトライ回数および間隔でリトライします。

-t ファイル監視間隔（秒）

ファイルの監視間隔を指定します。指定できる値は60〜86,400（単位：秒）です。省略した場合は300が設定されます。

WRAP2形式のログファイルを監視する場合

ラップアラウンドする頻度が高い場合や監視間隔を長く指定した場合に，リモート監視ログファイルトラップがデータを読み込む前に上書きされてしまい，データの読み込み漏れが発生するおそれがあります。データの読み込み漏れの予防策として，次の監視間隔の見積もり式を参考にしてください。

ログファイルサイズ（バイト）×ログファイル数>1秒当たりの出力サイズ（バイト）×監視間隔（秒）

ログファイル名1 […ログファイル名32]

監視するログファイル名を指定します。ログファイル名は256バイト以内の文字列で指定します。監視対象ホストがWindowsの場合は，ホスト名を除いたネットワークパス名で指定します。UNIXの場合はフルパスで指定します。なお，ワイルドカードを使用して，監視するログファイルを指定することはできません。

監視対象ホストがUNIXの場合，監視対象ファイルパスに半角英数字および「-」，「_」，「.」，「/」を含むログファイルを監視できます。それ以外の文字を含むファイルパスについては，正常に監視できない場合があります。

指定できるファイル数は32以下で，指定できるファイル形式は次の形式です。

シーケンシャルファイル(SEQ)

シーケンシャルファイル(SEQ2)

ラップアラウンドファイル(WRAP2)

注意事項

このコマンドは実行系ホストでだけ実行してください。コマンドの実行時は共有ディスクをマウントした状態で実行してください。

このコマンドは待機系ホストでは実行しないでください。

UNIX/Linux環境の待機系ホストで実行した場合，待機系ホストのローカルディスクのルート直下に「/共有ディレクトリ名」という不要なディレクトリが作成され，その配下にも次の不要なディレクトリとファイルが作成されます。

/共有ディレクトリ名/jp1imm

/共有ディレクトリ名/jp1imm/log

/共有ディレクトリ名/jp1imm/log/imcf

上記のローカルディスクにあるルート直下の「/共有ディレクトリ名」およびそのディレクトリ配下のファイルは不要であるため削除してください。削除する際は誤って共有ディスク上のディレクトリおよびファイルを削除しないように，必ず待機系ホスト上で共有ディスクがマウントされていないことを確認して実施してください。

戻り値

0

起動成功

4

引数不正

6

サーバに接続できない

7

ホスト情報が不正

8

指定した監視名は稼働済み

9

プロファイルの各種制限値を超過

10

排他編集権取得エラー

11

動作定義ファイル不正

12

認証情報定義ファイル不正

13

通信エラー

14

DB不正

17

権限不正

18

I/Oエラー

21

同時実行数の上限に達した

255

内部エラー

その他の値

その他のエラー

使用例1

host1のmonitoringNameのリモート監視ログファイルトラップを起動する場合

jcfallogstart -a monitoringName -o host1

使用例2

リモート監視ログファイルトラップ動作定義ファイルを新規作成し，起動する場合

jcfallogstart -a monitoringName -o host2 -f actionDefinition.conf -c SJIS -filter ".*-E" /log/sample.log

jcfallogstat

機能

リモート監視ログファイルトラップの動作状況を表示します。

このコマンドを実行すると，引数に指定した監視名を持つ，または引数に指定した監視対象ホストを監視対象とするリモート監視ログファイルトラップの動作状況を返します。

なお，同時に実行できるコマンドの数は5個までです。

このコマンドを実行するための条件を次に示します。

IM構成管理サービスが起動している

リモートの監視対象ホストが，リモート監視構成下にある

リモートの監視対象ホストが，ホスト情報を収集済みである

形式

jcfallogstat {-o 監視対象ホスト名 [-a 監視名] | ALL}
             [-h 論理ホスト名]

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Managerパス¥bin¥imcf¥

UNIXの場合

/opt/jp1imm/bin/imcf/

表示形式

jcfallogstatコマンドを実行すると，次の形式で出力結果が表示されます。ただし，ALLを指定していてリモート監視構成にホストが存在しない，または指定したホストがリモート監視構成に存在しない場合は，そのことを示すメッセージが表示されます。

注

この例では，説明のために行頭に行番号を入れて示しています。

1　Message ID△メッセージ

2　Message ID△メッセージ

3　[ホスト名]

4　監視名△状態

5　監視名△状態

6　監視名△状態

7　[ホスト名]

8　[ホスト名]

9　△状態

10　：

1行目

コマンド実行が開始したことを示すメッセージを表示します。

2行目

次の表示範囲を示すメッセージを表示します。

すべて

指定したホスト

指定したホストの指定したログファイルトラップ

3〜6行目

指定した範囲内のリモートの監視対象ホストのログファイルトラップに関する状態を表示します。表示する状態は，次のとおりです。

START：ログファイルトラップが起動中の状態

STOP：ログファイルトラップが停止中の状態

EDIT：ログファイルトラップの動作定義ファイルが編集されているが，反映していない状態

FAIL：次の理由によってログファイルトラップの状態の取得に失敗した状態

・ホスト不正（ホスト情報未収集，または収集失敗状態となっている）

・SSH，WMI/NetBIOS（NetBIOS over TCP/IP）通信でエラーが発生した

・認証エラー

・I/Oエラー

・排他権取得エラー

・内部エラー

7行目

ログファイルトラップが1件も定義されていない場合，ホスト名だけを表示します。

8〜9行目

ホスト単位でエラーが発生し状態の取得に失敗した場合に，FAILだけを表示します。

10行目

指定した範囲内すべてのリモートの監視対象ホストのログファイルトラップに関する状態を表示します。

引数

-o 監視対象ホスト名

動作状況を確認したいリモート監視ログファイルトラップの監視対象ホスト名を指定します。

-a 監視名

動作状況を確認したいリモート監視ログファイルトラップの監視名を指定します。

監視名は30バイト以内の文字列で指定します。使用できる文字は英数字，ハイフン，およびアンダーラインで，先頭の文字は必ず英数字を指定します。大文字，小文字は区別されません。

ALL

すべてのログファイルトラップの監視名を対象とします。

-h 論理ホスト名

このコマンドを実行させたい論理ホスト名を指定します。このオプションを省略した場合は物理ホスト名が設定されます。省略した場合は，環境変数JP1_HOSTNAMEに指定されている論理ホスト名が設定されます。JP1_HOSTNAMEに論理ホスト名が設定されていない場合は，物理ホスト名が設定されます。

注意事項

このコマンドは実行系ホストでだけ実行してください。コマンドの実行時は共有ディスクをマウントした状態で実行してください。

このコマンドは待機系ホストでは実行しないでください。

UNIX/Linux環境の待機系ホストで実行した場合，待機系ホストのローカルディスクのルート直下に「/共有ディレクトリ名」という不要なディレクトリが作成され，その配下にも次の不要なディレクトリとファイルが作成されます。

/共有ディレクトリ名/jp1imm

/共有ディレクトリ名/jp1imm/log

/共有ディレクトリ名/jp1imm/log/imcf

上記のローカルディスクにあるルート直下の「/共有ディレクトリ名」およびそのディレクトリ配下のファイルは不要であるため削除してください。削除する際は誤って共有ディスク上のディレクトリおよびファイルを削除しないように，必ず待機系ホスト上で共有ディスクがマウントされていないことを確認して実施してください。

戻り値

0

リモート監視ログファイルトラップがすべて稼働している

1

リモート監視ログファイルトラップが一部稼働している（ALLオプションを指定したとき，または-oオプションだけを指定したとき）

2

一部失敗，またはすべて失敗

4

引数不正

6

サーバに接続できない

7

ホスト情報が不正

14

DB不正

17

権限が不正

18

I/Oエラー

19

リモート監視ログファイルトラップがすべて停止している

21

同時実行数の上限に達した

255

内部エラー

その他の値

その他のエラー

使用例

host1のname1のリモート監視ログファイルトラップの動作状況を表示する場合

jcfallogstat -o host1 -a name1

jcfallogstop

機能

リモート監視ログファイルトラップを停止します。

オプションで，次の指定ができます。

停止する範囲（個別停止または一括停止）

停止したリモート監視ログファイルトラップの削除の有無

なお，同時に実行できるコマンドの数は5個までです。

このコマンドを実行するための条件を次に示します。

IM構成管理サービスが起動している

リモートの監視対象ホストが，リモート監視構成下にある

リモートの監視対象ホストが，ホスト情報を収集済みである

SSHで通信する場合，対象のリモートの監視対象ホストと公開鍵暗号方式でSSH認証できる

NetBIOS（NetBIOS over TCP/IP）で通信する場合，監視するログファイルが共有されている

リモート監視ログファイルトラップが起動している

形式

jcfallogstop {-o 監視対象ホスト名 [-a 監視名] | ALL}
             [-d]
             [-h 論理ホスト名]
             [-q]

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Managerパス¥bin¥imcf¥

UNIXの場合

/opt/jp1imm/bin/imcf/

引数

-o 監視対象ホスト名

停止したいリモート監視ログファイルトラップの監視対象ホスト名を指定します。

-a 監視名

停止したいリモート監視ログファイルトラップの監視名を指定します。

監視名は30バイト以内の文字列で指定します。使用できる文字は英数字，ハイフン，およびアンダーラインで，先頭の文字は必ず英数字を指定します。大文字，小文字は区別されません。

ALL

すべてのリモート監視ログファイルトラップを対象とします。

-d

このオプションを指定すると，停止するリモート監視ログファイルトラップのエントリーをプロファイルツリーから削除します。

このオプションを-a，-o，またはALLオプションのどれかと組み合わせた場合，複数のリモート監視ログファイルトラップをプロファイルツリーから削除することになるため，問題ないかを確認するためのメッセージが表示されます。その他の指定と組み合わせた場合は，指定しても無視されます。

-h 論理ホスト名

このコマンドを実行させたい論理ホスト名を指定します。省略した場合は，環境変数JP1_HOSTNAMEに指定されている論理ホスト名が設定されます。JP1_HOSTNAMEに論理ホスト名が設定されていない場合は，物理ホスト名が設定されます。

-q

このオプションを指定すると，-dオプション指定時でも確認メッセージが表示されません。-dオプションを指定していない場合は，指定しても無視されます。

注意事項

このコマンドは実行系ホストでだけ実行してください。コマンドの実行時は共有ディスクをマウントした状態で実行してください。

このコマンドは待機系ホストでは実行しないでください。

UNIX/Linux環境の待機系ホストで実行した場合，待機系ホストのローカルディスクのルート直下に「/共有ディレクトリ名」という不要なディレクトリが作成され，その配下にも次の不要なディレクトリとファイルが作成されます。

/共有ディレクトリ名/jp1imm

/共有ディレクトリ名/jp1imm/log

/共有ディレクトリ名/jp1imm/log/imcf

上記のローカルディスクにあるルート直下の「/共有ディレクトリ名」およびそのディレクトリ配下のファイルは不要であるため削除してください。削除する際は誤って共有ディスク上のディレクトリおよびファイルを削除しないように，必ず待機系ホスト上で共有ディスクがマウントされていないことを確認して実施してください。

戻り値

0

停止成功，または削除成功

2

一部失敗，またはすべて失敗

4

引数不正

6

サーバに接続できない

7

ホスト情報が不正

10

排他編集権取得エラー

12

認証定義ファイル不正

13

通信エラー

14

DB不正

15

指定したリモート監視ログファイルトラップは停止済み（-dオプションを指定していないとき）

17

権限が不正

18

I/Oエラー

21

同時実行数の上限に達した

255

内部エラー

その他の値

その他のエラー

使用例1

host1のname1のリモート監視ログファイルトラップを停止する場合

jcfallogstop -o host1 -a name1

使用例2

すべてのリモート監視ログファイルトラップを停止後，削除する場合

jcfallogstop ALL -d

jcfcolvmesx

機能

VMware ESXから仮想化構成情報を取得し，仮想化構成情報ファイルに出力します。

ただし，VMware ESXからゲストOSの仮想ホスト名を取得するには，ゲストOSでVMware Toolsが動作している必要があります。VMware Toolsがインストールされていない，またはインストールされていても動作していない場合，仮想ホスト名は取得できません。

また，ゲストOS自体が起動していない場合も，仮想ホスト名は取得できません。

このコマンドは，VMware Infrastructure SDKのインターフェースを使用して通信します。

形式

jcfcolvmesx
          [-m 通信種別]
          -u ユーザーID
          [-p パスワード]
          -c ホスト名 [ホスト名]
          -o 出力ファイル名

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納ディレクトリ

Windowsの場合

Managerパス¥bin¥imcf¥

UNIXの場合

/opt/jp1imm/bin/imcf/

引数

-m 通信種別

VMware ESXとの通信方法を指定します。

httpsを指定した場合，VMware ESXとhttps通信をします。httpを指定した場合，VMware ESXとhttp通信をします。

このオプションを指定しなかった場合，httpsで通信をします。

-u ユーザーID

接続先VMware ESXのアカウントのユーザーIDを指定します。

ユーザーIDは，256バイト以内の半角文字列で指定します。空白，タブは指定できません。

-p パスワード

-uオプションで指定したユーザーIDのパスワードを指定します。

パスワードは，256バイト以内の半角文字列で指定します。空白，タブは指定できません。

このオプションを指定しなかった場合，パスワードなしが仮定されます。

-c ホスト名 [ホスト名]

VMware ESXが動作しているホストのホスト名を指定します。ホスト名は，255文字以内で指定します。オプションのあとに空白，またはタブ区切りで複数記述します。

-o 出力ファイル名

VMware ESXから取得した構成情報を格納する仮想化構成情報ファイルのファイル名を，相対パスまたは絶対パス形式で指定します。このオプションは省略できません。パスに空白を含む場合は，「"」で囲みます。

戻り値

0

正常終了※1

1

引数エラー

2

メモリー不足

3

JavaVMの起動エラーが発生した

4

実行権限エラー（Windows限定）

5

管理者コンソールから実行されなかった（Windows限定）

6

出力ファイルがすでに存在する

7

仮想化構成情報の取得に失敗※2

8

入出力エラーが発生した

99

その他のエラー

注※1

一部取得できなかった仮想化構成情報があった場合も，コマンドとしては正常終了になります。

注※2

仮想化構成情報をどのホストからも取得できなかった場合に，戻り値を返します。

仮想化構成情報ファイルの形式

表1‒10　ヘッダー情報（1行目）

項目

出力値

仮想化構成情報ファイルの識別文字列

#VM

ファイルフォーマットバージョン

090100

文字コード

UTF-8固定

表1‒11　ヘッダー情報（2行目）

項目

出力値

ホスト名

Host_name

VMMホスト名

VMM_host_name

仮想化管理種別

Virtual_manager_type

仮想化管理製品のバージョン

Manager_version

仮想化構成管理ホスト

Virtual_host_manager

表1‒12　出力項目（3行目以降）

項目

説明

ホスト名

ホスト名。

VMMホスト名

仮想化環境ソフトウェアが稼働するホストのホスト名。

ゲストOSが存在しないVMMホストの場合，仮想ホスト名が空白で，VMMホスト名だけ設定される。

仮想化管理種別

仮想化構成を管理する製品の種別。

VMware ESXの場合，「ESX」を出力する。

仮想化管理製品のバージョン

仮想化構成を管理する製品のバージョン。

仮想化構成管理ホスト

VMMホストを管理するホスト名。

jcfcolvmesxコマンドの場合，常に空白。

出力例

#VM,090100,UTF-8
Host_name,VMM_host_name,Virtual_manager_type,Manager_version,Virtual_host_manager
Vm1,ESX1,,,
Vm2,ESX1,,,
ESX1,,ESX,4.0,

jcfcolvmhcsm

機能

HCSMから仮想化構成情報を取得し，仮想化構成情報ファイルに出力します。

なお，このコマンドを実行するための前提条件については，マニュアル「JP1/Integrated Management 3 - Manager 構築ガイド」の「3.3.1(1)　仮想化構成を管理するための前提条件」を参照してください。

形式

jcfcolvmhcsm
          -u ユーザーID
          -p パスワード
          [-port ポート番号]
          -c ホスト名 [ホスト名]
          -o 出力ファイル名

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納ディレクトリ

Windowsの場合

Managerパス¥bin¥imcf¥

UNIXの場合

/opt/jp1imm/bin/imcf/

引数

-u ユーザーID

接続先HCSMのアカウントのユーザーIDを指定します。ユーザーIDは，制御文字を含まない255バイト以内の文字列で指定します。

-p パスワード

-uオプションで指定したユーザーIDのパスワードを指定します。パスワードは，制御文字を含まない255バイト以内の文字列で指定します。

-port ポート番号

接続先HCSMと通信するためのポート番号を指定します。ポート番号は，1〜65535の半角数字で指定します。このオプションを指定しなかった場合，23015が仮定されます。

-c ホスト名 [ホスト名]

HCSMが動作しているホストのホスト名を指定します。ホスト名は，255文字以内で指定します。オプションのあとに空白，またはタブ区切りで複数記述します。

-o 出力ファイル名

HCSMから取得した構成情報を格納する仮想化構成情報ファイルのファイル名を，相対パスまたは絶対パス形式で指定します。このオプションは省略できません。パスに空白を含む場合は，「"」で囲みます。

戻り値

0

正常終了※1

1

引数エラー

2

メモリー不足

3

JavaVMの起動エラーが発生した

4

実行権限エラー

5

管理者コンソールから実行されなかった

6

出力ファイルがすでに存在する

7

仮想化構成情報の取得に失敗※2

8

入出力エラーが発生した

99

その他のエラー

注※1

一部取得できなかった仮想化構成情報があった場合も，コマンドとしては正常終了になります。

注※2

仮想化構成情報をどのホストからも取得できなかった場合に，戻り値を返します。

仮想化構成情報ファイルの形式

表1‒13　ヘッダー情報（1行目）

項目

出力値

仮想化構成情報ファイルの識別文字列

#VM

ファイルフォーマットバージョン

101000

文字コード

UTF-8固定

表1‒14　ヘッダー情報（2行目）

項目

出力値

ホスト名

Host_name

VMMホスト名

VMM_host_name

仮想化管理種別

Virtual_manager_type

仮想化管理製品のバージョン

Manager_version

仮想化構成管理ホスト

Virtual_host_manager

表1‒15　出力項目（3行目以降）

項目

説明

ホスト名

ホスト名。

VMMホスト名

仮想化環境ソフトウェアが稼働するホストのホスト名。

ゲストOSが存在しないVMMホストの場合，仮想ホスト名が空白で，VMMホスト名だけ設定される。

仮想化管理種別

仮想化構成を管理する製品の種別。

HCSMの場合：HCSM

日立サーバ論理分割機構の場合：Virtage

仮想化管理製品のバージョン

仮想化構成を管理する製品のバージョン。

仮想化管理種別がHCSMの場合，HCSMの外部接続インターフェースのバージョンが設定される。

なお，仮想化構成情報をHCSMから収集した場合，仮想化管理種別がVirtageのホストではバージョンを収集できない。

仮想化構成管理ホスト

VMMホストを管理するホスト名。

出力例

#VM,101000,UTF-8
Host_name,VMM_host_name,Virtual_manager_type,Manager_version,Virtual_host_manager
WIN-T0NFDNMQ29E,,HCSM,7.2,
10.197.62.41,,Virtage,,WIN-T0NFDNMQ29E
bs20071-1,10.197.62.41,,,
WIN-77MGIUCU8P0,,,,WIN-T0NFDNMQ29E
guest01,,,,WIN-T0NFDNMQ29E

jcfcolvmkvm

機能

KVMから仮想化構成情報を取得し，仮想化構成情報ファイルに出力します。

なお，このコマンドを実行するための前提条件については，マニュアル「JP1/Integrated Management 3 - Manager 構築ガイド」の「3.3.1(1)　仮想化構成を管理するための前提条件」を参照してください。

形式

jcfcolvmkvm
          -u ユーザーID
          -i 秘密鍵ファイルパス
          [-port ポート番号]
          -c ホスト名 [ホスト名]
          -o 出力ファイル名

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納ディレクトリ

Windowsの場合

Managerパス¥bin¥imcf¥

UNIXの場合

/opt/jp1imm/bin/imcf/

引数

-u ユーザーID

接続先KVMが動作しているホストのユーザーIDを指定します。ユーザーIDは，空白およびタブを含まない255バイト以内の半角文字列で指定します。

-i 秘密鍵ファイルパス

接続先KVMと通信するための秘密鍵ファイル名を絶対パス形式で指定します。秘密鍵ファイルパスは，制御文字を含まない256バイト以内の文字列で指定します。秘密鍵ファイルパスは，大文字，小文字を区別します。また，パスに空白を含む場合は，「"」で囲みます。

-port ポート番号

接続先KVMとSSH接続するためのポート番号を指定します。ポート番号は，1〜65535の半角数字で指定します。このオプションを指定しなかった場合，22が仮定されます。

-c ホスト名 [ホスト名]

KVMが動作しているホストのホスト名を指定します。ホスト名は，255文字以内で指定します。オプションのあとに空白，またはタブ区切りで複数記述します。

-o 出力ファイル名

KVMから取得した構成情報を格納する仮想化構成情報ファイルのファイル名を，相対パスまたは絶対パス形式で指定します。このオプションは省略できません。パスに空白を含む場合は，「"」で囲みます。

戻り値

0

正常終了※1

1

引数エラー

2

メモリー不足

3

JavaVMの起動エラーが発生した

4

実行権限エラー

5

管理者コンソールから実行されなかった

6

出力ファイルがすでに存在する

7

仮想化構成情報の取得に失敗※2

8

入出力エラーが発生した

99

その他のエラー

注※1

一部取得できなかった仮想化構成情報があった場合も，コマンドとしては正常終了になります。

注※2

仮想化構成情報をどのホストからも取得できなかった場合に，戻り値を返します。

仮想化構成情報ファイルの形式

表1‒16　ヘッダー情報（1行目）

項目

出力値

仮想化構成情報ファイルの識別文字列

#VM

ファイルフォーマットバージョン

101000

文字コード

UTF-8固定

表1‒17　ヘッダー情報（2行目）

項目

出力値

ホスト名

Host_name

VMMホスト名

VMM_host_name

仮想化管理種別

Virtual_manager_type

仮想化管理製品のバージョン

Manager_version

仮想化構成管理ホスト

Virtual_host_manager

表1‒18　出力項目（3行目以降）

項目

説明

ホスト名

ホスト名。

VMMホスト名

仮想化環境ソフトウェアが稼働するホストのホスト名。

ゲストOSが存在しないVMMホストの場合，仮想ホスト名が空白で，VMMホスト名だけ設定される。

仮想化管理種別

仮想化構成を管理する製品の種別。

KVMの場合，「KVM」を出力する。

仮想化管理製品のバージョン

仮想化構成を管理する製品のバージョン。

仮想化構成管理ホスト

VMMホストを管理するホスト名。

jcfcolvmkvmコマンドの場合，常に空白。

出力例

#VM,101000,UTF-8
Host_name,VMM_host_name,Virtual_manager_type,Manager_version,Virtual_host_manager
jp1-sf7800b,,KVM,0.12.1,
kv7801,jp1-sf7800b,,,
kv7802,jp1-sf7800b,,,
kv7803,jp1-sf7800b,,,
kv7804,jp1-sf7800b,,,

jcfcolvmscvmm（Windows限定）

機能

SCVMMから仮想化構成情報を取得し，仮想化構成情報ファイルに出力します。

なお，このコマンドを実行するための前提条件については，マニュアル「JP1/Integrated Management 3 - Manager 構築ガイド」の「3.3.1(1)　仮想化構成を管理するための前提条件」を参照してください。

形式

jcfcolvmscvmm
          -c ホスト名 [ホスト名]
          [-d ドメイン名 -u ユーザーID [-p パスワード]]
          -o 出力ファイル名

実行権限

Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

格納ディレクトリ

Managerパス¥bin¥imcf¥

引数

-c ホスト名 [ホスト名]

SCVMMが動作しているホストのホスト名を指定します。ホスト名は，255文字以内で指定します。オプションのあとに空白，またはタブ区切りで複数記述します。

-d ドメイン名

接続先SCVMMのホストが所属するドメイン名を指定します。JP1/IM - Managerが接続先SCVMMのホストのドメインと，同じドメインに所属する場合は省略できます。ドメイン名は，255バイト以内で指定します。

-u ユーザーID

接続先SCVMMのホストが所属するドメインで管理者権限を持つアカウントのユーザーIDを指定します。-dオプションを指定した場合は，このオプションは省略できません。ユーザーIDは，制御文字を含まない255バイト以内の文字列で指定します。

-p パスワード

-uオプションで指定したユーザーIDのパスワードを指定します。このオプションを指定しなかった場合，パスワードなしが仮定されます。パスワードは，制御文字を含まない255バイト以内の文字列で指定します。

-o 出力ファイル名

vCenterから取得した構成情報を格納する仮想化構成情報ファイルのファイル名を，相対パスまたは絶対パス形式で指定します。このオプションは省略できません。パスに空白を含む場合は，「"」で囲みます。

戻り値

0

正常終了※1

1

引数エラー

2

メモリー不足

3

JavaVMの起動エラーが発生した

4

実行権限エラー

5

管理者コンソールから実行されなかった

6

出力ファイルがすでに存在する

7

仮想化構成情報の取得に失敗※2

8

入出力エラーが発生した

99

その他のエラー

注※1

一部取得できなかった仮想化構成情報があった場合も，コマンドとしては正常終了になります。

注※2

仮想化構成情報をどのホストからも取得できなかった場合に，戻り値を返します。

仮想化構成情報ファイルの形式

表1‒19　ヘッダー情報（1行目）

項目

出力値

仮想化構成情報ファイルの識別文字列

#VM

ファイルフォーマットバージョン

090100

文字コード

UTF-8固定

表1‒20　ヘッダー情報（2行目）

項目

出力値

ホスト名

Host_name

VMMホスト名

VMM_host_name

仮想化管理種別

Virtual_manager_type

仮想化管理製品のバージョン

Manager_version

仮想化構成管理ホスト

Virtual_host_manager

表1‒21　出力項目（3行目以降）

項目

説明

ホスト名

ホスト名。

VMMホスト名

仮想化環境ソフトウェアが稼働するホストのホスト名。

ゲストOSが存在しないVMMホストの場合，仮想ホスト名が空白で，VMMホスト名だけ設定される。

仮想化管理種別

仮想化構成を管理する製品の種別。

Hyper-Vの場合：Hyper-V

SCVMMの場合：SCVMM

vCenterの場合：vCenter

VMware ESXの場合：ESX

仮想化管理製品のバージョン

仮想化構成を管理する製品のバージョン。

仮想化管理元ホスト名

VMMホストを管理するホスト名。

出力例

#VM,090100,UTF-8
Host_name,VMM_host_name,Virtual_manager_type,Manager_version,Virtual_host_manager
Vm1,ESX1,,,
Vm2,ESX1,,,
ESX1,,ESX,4.0,vCenter1
vCenter1,, vCenter,2.0,SCVMM1
SCVMM1,,SCVMM,2008,

jcfcolvmvc

機能

vCenterから仮想化構成情報を取得し，仮想化構成情報ファイルに出力します。

なお，このコマンドを実行するための前提条件については，マニュアル「JP1/Integrated Management 3 - Manager 構築ガイド」の「3.3.1(1)　仮想化構成を管理するための前提条件」を参照してください。

形式

jcfcolvmvc
          [-m 通信種別]
          -u ユーザーID
          [-p パスワード]
          -c ホスト名 [ホスト名]
          -o 出力ファイル名

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納ディレクトリ

Windowsの場合

Managerパス¥bin¥imcf¥

UNIXの場合

/opt/jp1imm/bin/imcf/

引数

-m 通信種別

vCenterとの通信方法を指定します。

httpsを指定した場合，vCenterとhttps通信をします。httpを指定した場合，vCenterとhttp通信をします。

このオプションを指定しなかった場合，httpsで通信をします。

-u ユーザーID

接続先vCenterのアカウントのユーザーIDを指定します。

ユーザーIDは，制御文字を含まない255バイト以内の文字列で指定します。

-p パスワード

-uオプションで指定したユーザーIDのパスワードを指定します。

パスワードは，制御文字を含まない255バイト以内の文字列で指定します。

このオプションを指定しなかった場合，パスワードなしが仮定されます。

-c ホスト名 [ホスト名]

vCenterが動作しているホストのホスト名を指定します。ホスト名は，255文字以内で指定します。オプションのあとに空白，またはタブ区切りで複数記述します。

-o 出力ファイル名

vCenterから取得した構成情報を格納する仮想化構成情報ファイルのファイル名を，相対パスまたは絶対パス形式で指定します。パスに空白を含む場合は，「"」で囲みます。

戻り値

0

正常終了※1

1

引数エラー

2

メモリー不足

3

JavaVMの起動エラーが発生した

4

実行権限エラー

5

管理者コンソールから実行されなかった

6

出力ファイルがすでに存在する

7

仮想化構成情報の取得に失敗※2

8

入出力エラーが発生した

99

その他のエラー

注※1

一部取得できなかった仮想化構成情報があった場合も，コマンドとしては正常終了になります。

注※2

仮想化構成情報をどのホストからも取得できなかった場合に，戻り値を返します。

仮想化構成情報ファイルの形式

表1‒22　ヘッダー情報（1行目）

項目

出力値

仮想化構成情報ファイルの識別文字列

#VM

ファイルフォーマットバージョン

090100

文字コード

UTF-8固定

表1‒23　ヘッダー情報（2行目）

項目

出力値

ホスト名

Host_name

VMMホスト名

VMM_host_name

仮想化管理種別

Virtual_manager_type

仮想化管理製品のバージョン

Manager_version

仮想化構成管理ホスト

Virtual_host_manager

表1‒24　出力項目（3行目以降）

項目

説明

ホスト名

ホスト名。

VMMホスト名

仮想化環境ソフトウェアが稼働するホストのホスト名。

ゲストOSが存在しないVMMホストの場合，仮想ホスト名が空白で，VMMホスト名だけ設定される。

仮想化管理種別

仮想化構成を管理する製品の種別。

vCenterの場合：vCenter

VMware ESXの場合：ESX

仮想化管理製品のバージョン

仮想化構成を管理する製品のバージョン。

仮想化管理元ホスト名

VMMホストを管理するホスト名。

出力例

#VM,090100,UTF-8
Host_name,VMM_host_name,Virtual_manager_type,Manager_version,Virtual_host_manager
Vm1,ESX1,,,
Vm2,ESX1,,,
ESX1,,ESX,4.0,vCenter1
vCenter1,, vCenter,2.0,

jcfcolvmvirtage

機能

日立サーバ論理分割機構から仮想化構成情報を取得し，仮想化構成情報ファイルに出力します。

なお，このコマンドを実行するための前提条件については，マニュアル「JP1/Integrated Management 3 - Manager 構築ガイド」の「3.3.1(1)　仮想化構成を管理するための前提条件」を参照してください。

形式

jcfcolvmvirtage
          -c ホスト名 [ホスト名]
          -o 出力ファイル名

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納ディレクトリ

Windowsの場合

Managerパス¥bin¥imcf¥

UNIXの場合

/opt/jp1imm/bin/imcf/

引数

-c ホスト名 [ホスト名]

日立サーバ論理分割機構を管理するJP1/SC/CMが動作しているホストのホスト名を指定します。ホスト名は，255文字以内で指定します。オプションのあとに空白，またはタブ区切りで複数記述します。

-o 出力ファイル名

日立サーバ論理分割機構を管理するJP1/SCから取得した構成情報を格納する仮想化構成情報ファイルのファイル名を，相対パスまたは絶対パス形式で指定します。このオプションは省略できません。パスに空白を含む場合は，「"」で囲みます。

戻り値

0

正常終了※1

1

引数エラー

2

メモリー不足

3

JavaVMの起動エラーが発生した

4

実行権限エラー

5

管理者コンソールから実行されなかった

6

出力ファイルがすでに存在する

7

仮想化構成情報の取得に失敗※2

8

入出力エラーが発生した

99

その他のエラー

注※1

一部取得できなかった仮想化構成情報があった場合も，コマンドとしては正常終了になります。

注※2

仮想化構成情報をどのホストからも取得できなかった場合に，戻り値を返します。

仮想化構成情報ファイルの形式

表1‒25　ヘッダー情報（1行目）

項目

出力値

仮想化構成情報ファイルの識別文字列

#VM

ファイルフォーマットバージョン

090100

文字コード

UTF-8固定

表1‒26　ヘッダー情報（2行目）

項目

出力値

ホスト名

Host_name

VMMホスト名

VMM_host_name

仮想化管理種別

Virtual_manager_type

仮想化管理製品のバージョン

Manager_version

仮想化構成管理ホスト

Virtual_host_manager

表1‒27　出力項目（3行目以降）

項目

説明

ホスト名

ホスト名。

VMMホスト名

仮想化環境ソフトウェアが稼働するホストのホスト名。

ゲストOSが存在しないVMMホストの場合，仮想ホスト名が空白で，VMMホスト名だけ設定される。

仮想化管理種別

仮想化構成を管理する製品の種別。

JP1/SC/CMの場合：JP1/SC/CM

日立サーバ論理分割機構の場合：Virtage

仮想化管理製品のバージョン

仮想化構成を管理する製品のバージョン。

仮想化管理元ホスト名

VMMホストを管理するホスト名。

出力例

#VM,090100,UTF-8
Host_name,VMM_host_name,Virtual_manager_type,Manager_version,Virtual_host_manager
Vm1,VIRTAGE1,,,
Vm2, VIRTAGE1,,,
VIRTAGE1,,Virtage,
SCCM1,VIRTAGE1,JP1/SC/CM,,

jcfdbsetup

機能

構成情報を格納するIM構成管理DBをセットアップするコマンドです。データベースのサイズ，ポート番号，データベース格納先は，セットアップ情報ファイルに指定しておく必要があります。

Windowsの場合，統合監視DBがセットアップされていない環境でこのコマンドを実行すると，次のサービスがOSに登録されます。

物理ホストのセットアップ時：JP1/IM3-Manager DB Server，JP1/IM3-Manager DB Cluster Service

クラスタ構成のセットアップ時：JP1/IM3-Manager DB Server_論理ホスト名，JP1/IM3-Manager DB Cluster Service_論理ホスト名

UNIXの場合，統合監視DBがセットアップされていない環境でこのコマンドを実行すると，/etc/inittabファイルに，IMデータベースのパスを含むエントリーが追加されます。エントリーは，コマンドを実行した物理ホスト，および論理ホストごとに追加されます。このコマンドを実行したときに追加された/etc/inittabファイルのエントリーを，削除，編集，またはコメントアウトしないでください。

形式

jcfdbsetup {-f セットアップ情報ファイル名|-s}
           [-h 論理ホスト名 -c {online|standby}]
           [-q]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Managerパス¥bin¥imdb¥

UNIXの場合

/opt/jp1imm/bin/imdb/

引数

-f セットアップ情報ファイル名

インストール先フォルダや，データベース領域のサイズを記述したセットアップ情報ファイルを指定します。IM構成管理DBと統合監視DBがどちらもセットアップされていない場合は，必ずこのオプションを指定してください。統合監視DBがすでにセットアップ済みの場合にこのオプションを指定する場合は，統合監視DBのセットアップ時に指定したセットアップ情報ファイルと同じファイルを指定してください。また，統合監視DBがすでにセットアップ済みの場合は，-sオプションを代わりに指定できます。その際，統合監視DBのセットアップ時に指定したセットアップ情報が用いられます。

-sオプションと同時に指定できません。また，-fオプションと-sオプションは同時に省略できません。

パスに空白を含む場合は，「"」で囲みます。クラスタ環境を構築する場合は，クラスタセットアップ情報ファイル名を指定してください。

-s

統合監視DBがセットアップされている場合は，-fオプションの代わりに指定できます。このオプションを指定した場合は，統合監視DBのセットアップ時に指定されたセットアップ情報の内容を参照して，IM構成管理DB をセットアップします。

統合監視DBがセットアップされていない場合，このオプションを指定すると，KNAN11193-Eメッセージが出力されます。

-fオプションと同時に指定できません。また，-sオプションと-fオプションは同時に省略できません。

-h 論理ホスト名

クラスタシステムで運用している場合に，コマンドを実行するホストの論理ホスト名を指定します。指定した論理ホストに対応するIM構成管理DBをセットアップします。クラスタシステムを使用していない場合には指定は不要です。なお，論理ホスト名にJP1_DEFAULTは指定できません。また，論理ホスト名は，大文字・小文字を区別します。論理ホスト名には，JP1/Baseで設定した論理ホスト名を，大文字・小文字を含めて正確に指定してください。

-c {online|standby}

クラスタ構成の実行系および待機系のセットアップ種別を指定します。-hオプションを指定した場合は，必ずこのオプションを指定してください。また，すでに同一ホストに統合監視DBをセットアップしている場合は，-cオプションに統合監視DBを作成したときと同じ値を指定してください。

online：実行系をセットアップする場合に指定します。

standby：待機系をセットアップする場合に指定します。

onlineを指定する場合は，共有ディスクをマウントし，論理ホストと通信できる状態にしてください。また，非クラスタ環境で，論理ホストを運用する場合は-cオプションに「online」を指定してください。

-q

ユーザーの確認を省略してコマンドを実行する場合に指定します。

戻り値

0

正常終了

1

異常終了

注意事項

実行系と待機系のクラスタセットアップ情報ファイルの内容は同じにする必要があります。待機系をセットアップする場合，実行系で使用したクラスタセットアップ情報ファイルをコピーして使用してください。実行系と待機系で指定したファイル内容が異なっていた場合，待機系でアンセットアップしたあとに，クラスタセットアップ情報ファイルを実行系からコピーし，コマンドを再実行してください。

-cオプションを指定してコマンドを実行する場合は，実行途中でサーバを切り替えないでください。実行中にサーバを切り替えた場合は，コマンド終了後に一度アンセットアップしてから，コマンドを再実行してください。

コマンド実行中に［Ctrl］+［C］キーや［Ctrl］+［Break］キーで処理を中止した場合，pdistup，pdfmkfs，pddef，およびpdloadのプロセスが実行されていないことを確認し，jcfdbunsetupコマンドを実行してからこのコマンドを再実行してください。

統合監視DBをセットアップ済みの場合，かつIMデータベースを使用している場合，JP1/IM-Managerサービスが停止している必要があります。

Windowsで統合監視DBを使用している場合，IMデータベースサービス（JP1/IM3-Manager DB Server）が起動している必要があります。また，IMデータベースのクラスタサービス（JP1/IM3-Manager DB Cluster Service_論理ホスト名）が停止している必要があります。

JP1/IM - MOを使用している場合は，接続元のJP1/IM - MOのJP1/IM - Message Optimizerサービスが停止している必要があります。

引数に指定する論理ホスト名とJP1/Baseの論理ホスト名が一致し，かつ論理ホスト名の名前解決ができることを確認してからコマンドを実行してください。

jcodbunsetup，またはjcfdbunsetupコマンドを実行してIMデータベースをアンセットアップした場合にjcfdbsetupコマンドを実行するときは，jcfdbsetupコマンドを実行する前にOSを再起動してください。

Windowsの場合，Application Experienceサービスが存在する場合は，Application Experienceサービスのスタートアップの種類が無効になっていないことを確認してからコマンドを実行してください。

jcfdbunsetup

機能

構成情報を格納するIM構成管理DBをアンセットアップするコマンドです。

このコマンドは，IM構成管理DBの使用を停止する場合，JP1/IM - Managerをアンインストールする場合，IM構成管理DBを再作成する場合，およびデータベースサイズを拡張する場合に実行します。

統合監視DBをセットアップしている環境では，このコマンドの実行後も統合監視DBは使用できます。

Windowsの場合，統合監視DBがセットアップされていない環境でこのコマンドを実行すると，次のサービスが削除されます。

物理ホストのアンセットアップ時：JP1/IM-Manager DB Server，JP1/IM-Manager DB Cluster Service

クラスタ構成のアンセットアップ時：JP1/IM-Manager DB Server_論理ホスト名，JP1/IM-Manager DB Cluster Service_論理ホスト名

UNIXの場合，統合監視DBがセットアップされていない環境でこのコマンドを実行すると，jcodbsetupまたはjcfdbsetupコマンドが登録した/etc/inittabファイルのエントリーが削除されます。エントリーは，コマンドを実行した物理ホスト，および論理ホストに対応した処理だけ削除されます。

なお，jcfdbunsetupコマンドを実行したあとは，必ず次のファイルを削除してください。

Windowsの場合

物理ホストのとき

Managerパス¥data¥imcf¥imconfig以下のファイル

Managerパス¥data¥imcf¥profiles以下のファイルおよびフォルダ

論理ホストのとき

共有フォルダ¥data¥imcf¥imconfig以下のファイル

共有フォルダ¥data¥imcf¥profiles以下のファイルおよびフォルダ

UNIXの場合

物理ホストのとき

/var/opt/jp1imm/data/imcf/imconfig以下のファイル

/var/opt/jp1imm/data/imcf/profiles以下のファイルおよびディレクトリ

論理ホストのとき

共有ディレクトリ/data/imcf/imconfig以下のファイル

共有ディレクトリ/data/imcf/profiles以下のファイルおよびディレクトリ

形式

jcfdbunsetup [-h 論理ホスト名 -c {online|standby}]
             [-q]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Managerパス¥bin¥imdb¥

UNIXの場合

/opt/jp1imm/bin/imdb/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，コマンドを実行するホストの論理ホスト名を指定します。指定した論理ホストに対応するIM構成管理DBをアンセットアップします。クラスタシステムを使用していない場合には指定は不要です。なお，論理ホスト名にJP1_DEFAULTは指定できません。また，論理ホスト名は，大文字・小文字を区別します。論理ホスト名には，JP1/Baseで設定した論理ホスト名を，大文字・小文字を含めて正確に指定してください。

-c {online|standby}

クラスタ構成の実行系および待機系のアンセットアップ種別を指定します。-hオプションを指定した場合は，必ずこのオプションを指定してください。

online：IM構成管理DBのセットアップでonlineを指定した場合に指定します。

standby：IM構成管理DBのセットアップでstandbyを指定した場合に指定します。

onlineを指定する場合は，共有ディスクをマウントし，論理ホストと通信できる状態にしてください。また，非クラスタ環境で，運用していた論理ホストのIM構成管理DBをアンセットアップする場合は-cオプションに「online」を指定してください。

-q

ユーザー確認を省略してコマンドを実行する場合に指定します。

戻り値

0

正常終了

1

異常終了

注意事項

統合監視DBを作成している環境で，データベースのサイズを拡張する場合は，このコマンド実行後に，統合監視DBのアンセットアップコマンドを実行する必要があります。

-cオプションを指定してコマンドを実行する場合は，実行途中でサーバを切り替えないでください。実行中にサーバを切り替えた場合は，コマンド終了後にコマンドを再実行してください。

コマンド実行中に［Ctrl］+［C］キーや［Ctrl］+［Break］キーで処理を中止した場合，pdirstプロセスが実行されていないことを確認してからこのコマンドを再実行してください。

Windowsの場合，サービスが次の状態である必要があります。

物理ホストのとき

IMデータベースのクラスタサービス（JP1/IM3-Manager DB Cluster Service）が停止していて，IMデータベースサービス（JP1/IM3-Manager DB Server）が開始している必要があります。また，統合監視DBがセットアップ済み，かつIMデータベースを使用している場合，JP1/IM - Managerのサービス（JP1/IM3-Manager）が停止している必要があります。

論理ホストのとき

論理ホストのIMデータベースのクラスタサービス（JP1/IM3-Manager DB Cluster Service_論理ホスト名）が停止していて，論理ホストのIMデータベースサービス（JP1/IM3-Manager DB Server_論理ホスト名）が開始している必要があります。また，統合監視DBがセットアップ済み，かつIMデータベースを使用している場合，JP1/IM - Managerのサービス（JP1/IM3-Manager_論理ホスト名）が停止している必要があります。

UNIXの場合，IM構成管理DBがセットアップ済み，かつIMデータベースを使用しているとき，JP1/IM-Managerサービスが停止している必要があります。

JP1/IM - MOを使用している場合は，接続元のJP1/IM - MOのJP1/IM - Message Optimizerサービスが停止している必要があります。

Windowsの場合，Application Experienceサービスが存在する場合は，Application Experienceサービスのスタートアップの種類が無効になっていないことを確認してからコマンドを実行してください。

jcfexport

機能

IM構成管理で管理しているシステムの階層構成（IM構成），ホスト情報および定義情報を出力するコマンドです。

このコマンドを使用する場合には，IM構成管理サービスが起動している必要があります。jcfimportコマンドを実行している場合，このコマンドは実行できません。また，同時に実行できるコマンドの数は5個までです。

形式

jcfexport        [-h 論理ホスト名]
                 [-f]
                 -o ディレクトリ名
                 [-m | -r | -c | -g | -a]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Managerパス¥bin¥imcf¥

UNIXの場合

/opt/jp1imm/bin/imcf/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，コマンドを実行するホストの論理ホスト名を指定します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。クラスタシステムを使用していない場合には指定は不要です。

-f

指定したディレクトリにエクスポートファイル名と同名のファイルがすでにある場合は，ファイルを上書きします。このオプションを省略した場合は，エクスポート先にファイルがあるとエクスポートしません。

-o ディレクトリ名

エクスポートデータを出力するディレクトリ名を絶対パス形式，またはこのコマンドを実行した場所からの相対パス形式で指定します。このオプションは省略できません。パスに空白を含む場合は，「"」で囲んで指定します。

-m

ホスト情報だけをエクスポートします。エクスポートした情報は，ホスト入力情報ファイル（host_input_data.csv）に出力されます。

-r，-c，-g，-aオプションと同時に指定できません。指定した場合は，引数不正となります。-m，-r，-c，-g，および-aオプションをすべて省略した場合は，-aオプションが仮定されます。

-r

ホスト情報とリモート認証情報だけをエクスポートします。

-m，-c，-g，-aオプションと同時に指定できません。指定した場合は，引数不正となります。-m，-r，-c，-g，および-aオプションをすべて省略した場合は，-aオプションが仮定されます。

-c

ホスト情報とシステムの階層構成だけをエクスポートします。ホスト情報は，ホスト入力情報ファイル（host_input_data.csv）に出力されます。また，システムの階層構成は，system_tree_information.txtに出力されます。

-m，-r，-g，-aオプションと同時に指定できません。指定した場合は，引数不正となります。-m，-r，-c，-g，および-aオプションをすべて省略した場合は，-aオプションが仮定されます。

-g

ホスト情報，業務グループ情報，監視グループ情報だけをエクスポートします。

-m，-r，-c，-aオプションと同時に指定できません。指定した場合は，引数不正となります。-m，-r，-c，-g，および-aオプションをすべて省略した場合は，-aオプションが仮定されます。

-a

すべての情報をエクスポートします。エクスポートした情報は，data_information.txtに出力されます。ホスト情報は，ホスト入力情報ファイル（host_input_data.csv）に出力されます。システムの階層構成は，system_tree_information.txtに出力されます。また，定義情報は，-oオプションで指定したディレクトリ¥definition_files¥ホスト名¥製品名の直下の，次のファイルに出力されます。

転送設定ファイル（forward）

ログファイルトラップ動作定義ファイル（任意のファイル）

ログファイルトラップ起動定義ファイル（jevlog_start.conf）

イベントログトラップ機能の動作定義ファイル（ntevent.conf）

ローカルアクションの動作定義ファイル（jbslcact.conf）

-m，-r，-c，-gオプションと同時に指定できません。指定した場合は，引数不正となります。-m，-r，-c，-g，および-aオプションをすべて省略した場合は，-aオプションが仮定されます。

注意事項

プロファイル設定ファイルを収集していないホストの場合，エクスポートするデータはありません（ディレクトリも作成されません）。

このコマンドは実行系ホストでだけ実行してください。コマンドの実行時は共有ディスクをマウントした状態で実行してください。

このコマンドは待機系ホストでは実行しないでください。

UNIX/Linux環境の待機系ホストで実行した場合，待機系ホストのローカルディスクのルート直下に「/共有ディレクトリ名」という不要なディレクトリが作成され，その配下にも次の不要なディレクトリとファイルが作成されます。

/共有ディレクトリ名/jp1imm

/共有ディレクトリ名/jp1imm/log

/共有ディレクトリ名/jp1imm/log/imcf

上記のローカルディスクにあるルート直下の「/共有ディレクトリ名」およびそのディレクトリ配下のファイルは不要であるため削除してください。削除する際は誤って共有ディスク上のディレクトリおよびファイルを削除しないように，必ず待機系ホスト上で共有ディスクがマウントされていないことを確認して実施してください。

戻り値

0

正常終了

4

オプション不正

8

サーバに接続できない

12

メモリーが不足した

16

権限が不正

20

ファイルエラー，パスが不正，すでにファイルが存在するなど

21

同時実行数の上限に達した

24

入出力エラーが発生した

120

システムエラーが発生した

124

その他エラーにより終了した

201以上

JavaVMの起動エラーが発生した

使用例

c:¥tempの直下にIM構成管理のすべての情報をエクスポートする場合

jcfexport -o c:¥temp

jcfimport

機能

IM構成管理の情報をインポートするコマンドです。

このコマンドを使用する場合には，IM構成管理サービスが起動している必要があります。なお，リモート監視中は，このコマンドは実行できません。また，同時に実行できるコマンドの数は5個までです。

このコマンドを実行すると，インポート前にIM構成管理が管理していたホスト，システムの階層構成（IM構成），およびプロファイルの3種類の情報がすべて削除されて，オプションで指定した情報がインポートされます。

リモート監視をする場合は，インポート後にIM構成管理・ビューアーから［システム共通設定］画面を開き，設定を確認後に［OK］ボタンをクリックしてください。

形式

jcfimport       [-h 論理ホスト名]
                -i ディレクトリ名
                [-m | -r | -c | -g | -a]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Managerパス¥bin¥imcf¥

UNIXの場合

/opt/jp1imm/bin/imcf/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，コマンドを実行するホストの論理ホスト名を指定します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。クラスタシステムを使用していない場合には指定する必要はありません。

-i ディレクトリ名

jcfexportコマンドでエクスポートしたファイルのディレクトリ名を絶対パス形式，またはjcfimportコマンドを実行する場所からの相対パス形式で指定します。このオプションは省略できません。

-m

ホスト情報だけをインポートします。-c，-r，-g，-aオプションと同時に指定できません。指定した場合は，引数不正となります。-m，-r，-c，-g，および-aオプションをすべて省略した場合は，-aオプションが仮定されます。

-r

ホスト情報とリモート認証情報だけをインポートします。

-m，-c，-g，-aオプションと同時に指定できません。指定した場合は，引数不正となります。-m，-r，-c，-g，および-aオプションをすべて省略した場合は，-aオプションが仮定されます。

-c

システムの階層構成およびホスト情報をインポートします。-m，-r，-g，-aオプションと同時に指定できません。指定した場合は，引数不正となります。-m，-r，-c，-g，および-aオプションをすべて省略した場合は，-aオプションが仮定されます。

-g

ホスト情報，業務グループ情報，監視グループ情報だけをインポートします。

-m，-r，-c，-aオプションと同時に指定できません。指定した場合は，引数不正となります。-m，-r，-c，-g，および-aオプションをすべて省略した場合は，-aオプションが仮定されます。

-a

すべての情報をインポートします。-m，-r，-c，-gオプションと同時に指定できません。指定した場合は，引数不正となります。-m，-r，-c，-g，および-aオプションをすべて省略した場合は，-aオプションが仮定されます。

注意事項

このコマンドは実行系ホストでだけ実行してください。コマンドの実行時は共有ディスクをマウントした状態で実行してください。

このコマンドは待機系ホストでは実行しないでください。

UNIX/Linux環境の待機系ホストで実行した場合，待機系ホストのローカルディスクのルート直下に「/共有ディレクトリ名」という不要なディレクトリが作成され，その配下にも次の不要なディレクトリとファイルが作成されます。

/共有ディレクトリ名/jp1imm

/共有ディレクトリ名/jp1imm/log

/共有ディレクトリ名/jp1imm/log/imcf

上記のローカルディスクにあるルート直下の「/共有ディレクトリ名」およびそのディレクトリ配下のファイルは不要であるため削除してください。削除する際は誤って共有ディスク上のディレクトリおよびファイルを削除しないように，必ず待機系ホスト上で共有ディスクがマウントされていないことを確認して実施してください。

戻り値

0

正常終了

4

オプション不正

8

サーバに接続できない

12

メモリーが不足した

16

権限が不正

20

ファイルエラー，パスが不正など

24

入出力エラーが発生した

21

同時実行数の上限に達した

120

システムエラーが発生した

124

その他エラーにより終了した

201以上

JavaVMの起動エラーが発生した

使用例

c:¥tempの直下にあるエクスポートファイルのすべての情報をインポートする場合

jcfimport -i c:¥temp

jcfmkcsdata

機能

ホスト入力情報ファイル（host_input_data.csv）とセントラルスコープのエクスポートファイルから，仮想化構成の監視ツリー情報を追加したセントラルスコープのインポートファイルを生成します。または，業務グループ情報ファイル（monitoring_system_data.csv），監視グループ情報ファイル（monitoring_group_data.csv）およびセントラルスコープのエクスポートファイルから，業務グループの監視ツリー情報を追加したセントラルスコープのインポートファイルを生成します。

業務グループ情報ファイル（monitoring_system_data.csv），および監視グループ情報ファイル（monitoring_group_data.csv）については，マニュアル「JP1/Integrated Management 3 - Manager 運用ガイド」の「9.7.1(5)　業務グループ情報」および「9.7.1(6)　監視グループ情報」を参照してください。

形式

jcfmkcsdata
          { -f ホスト入力情報ファイル名 セントラルスコープのエクスポートファイル名 | -g 業務グループ情報ファイル名 監視グループ情報ファイル名 セントラルスコープのエクスポートファイル名 }
          -o エクスポートファイル名
          [-r]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Managerパス¥bin¥imcf¥

UNIXの場合

/opt/jp1imm/bin/imcf/

引数

-f ホスト入力情報ファイル名 セントラルスコープのエクスポートファイル名

jcfexportコマンドでエクスポートしたホスト入力情報ファイル（host_input_data.csv）とjcsdbexportコマンドでエクスポートしたファイルを，相対パスまたは絶対パス形式で指定します。このオプションは-gオプションと同時には指定できません。パスに空白を含む場合は，「"」で囲みます。

セントラルスコープのエクスポートファイルには，サーバ指向ツリーをエクスポートしたファイルを指定します。

ホスト入力情報ファイル（host_input_data.csv）については，マニュアル「JP1/Integrated Management 3 - Manager 運用ガイド」の「9.7.1(1)　ホスト情報」を参照してください。

-g 業務グループ情報ファイル名 監視グループ情報ファイル名 セントラルスコープのエクスポートファイル名

jcfexportコマンドでエクスポートした業務グループ情報ファイル（monitoring_system_data.csv），監視グループ情報ファイル（monitoring_group_data.csv）とjcsdbexportコマンドでエクスポートしたファイルを，相対パスまたは絶対パス形式で指定します。このオプションは-fオプションと同時には指定できません。パスに空白を含む場合は，「"」で囲みます。

セントラルスコープのエクスポートファイルには，サーバ指向ツリーをエクスポートしたファイルを指定します。なお，エクスポートファイルにはデータバージョンが0810以降の監視オブジェクトDBからエクスポートしたファイルを指定してください。

-o エクスポートファイル名

コマンドが出力するセントラルスコープのインポート用ファイルのファイル名を，相対パスまたは絶対パス形式で指定します。このオプションは省略できません。パスに空白を含む場合は，「"」で囲みます。

[-r]

このオプションは，引数で指定したJP1/IM - Manager（セントラルスコープ）のエクスポートファイルに含まれる仮想化システム構成ツリーを使用するかどうかを設定します。このオプションを指定する場合，JP1/IM - Manager（セントラルスコープ）のエクスポートファイルの仮想化システム構成ツリーを使用しないで，このコマンドで新しく作成します。このオプションを指定しない場合，JP1/IM - Manager（セントラルスコープ）のエクスポートファイルに含まれる仮想化システム構成ツリーに対して，新たに仮想化システム構成ツリーを追加します。

戻り値

0

正常終了

1

引数エラー

2

指定したファイルが不正

3

指定した入力ファイルが存在しない

4

エクスポートファイルがすでに存在する

5

指定したファイルに対するアクセス権がない

6

メモリー不足

7

入出力エラーが発生した

9

ディスク不足

10

実行権限エラー

11

［Ctrl］+［C］キーでコマンドを強制終了した

12

指定したセントラルスコープのエクスポートファイルのデータバージョンが古い

20

ファイルパスに予約デバイスを指定した

99

その他のエラー

122

管理者コンソールから実行されなかった（Windows限定）

jcfmkhostsdata

機能

仮想化構成情報ファイルで，ホスト入力情報ファイルを更新します。

形式

jcfmkhostsdata
          -imcf ホスト入力情報ファイル
          -vm 仮想化構成情報ファイル
          -o 出力ファイル名

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納ディレクトリ

Windowsの場合

Managerパス¥bin¥imcf¥

UNIXの場合

/opt/jp1imm/bin/imcf/

引数

-imcf ホスト入力情報ファイル

ホスト入力情報ファイルのファイル名を，相対パスまたは絶対パス形式で指定します。このオプションは省略できません。パスに空白を含む場合は，「"」で囲みます。

-vm 仮想化構成情報ファイル

仮想化構成情報ファイルのファイル名を，相対パスまたは絶対パス形式で指定します。このオプションは省略できません。パスに空白を含む場合は，「"」で囲みます。

-o 出力ファイル名

ホスト入力情報ファイルのファイル名を，相対パスまたは絶対パス形式で指定します。ホスト入力情報ファイルには，ホスト入力情報ファイルを更新した結果が出力されます。このオプションは省略できません。パスに空白を含む場合は，「"」で囲みます。

戻り値

0

正常終了

1

引数エラー

2

メモリー不足

3

JavaVMの起動エラーが発生した

4

実行権限エラー（Windows限定）

5

管理者コンソールから実行されなかった（Windows限定）

6

出力ファイルがすでに存在する

7

指定したファイルが不正

8

指定した入力ファイルが存在しない

9

指定したファイルに対するアクセス権がない

10

入出力エラーが発生した

99

その他のエラー

jcfthreaddmp（Windows限定）

機能

IM構成管理・ビューアーのJavaスレッドダンプを生成するコマンドです。

次の条件が成立した場合，このコマンドを実行するとJavaのスレッドダンプが取得されます。

画面操作ができなくなった場合

IM構成管理・ビューアーとIM構成管理サーバのプロセスで，停止しているプロセスがない場合

IM構成管理・ビューアーのJavaスレッドダンプをlogディレクトリ内にテキストファイル形式で出力します。

%ALLUSERSPROFILE%¥Hitachi¥JP1¥JP1_DEFAULT¥JP1CoView¥log

なお，正常に稼働しているIM構成管理・ビューアーのスレッドダンプを生成すると，JavaVMが不安定になるため，IM構成管理・ビューアーを再起動する必要があります。

形式

jcfthreaddmp プロセスID

実行権限

なし（ただし，WindowsのUAC機能が有効な場合は管理者コンソールから実行）

格納先ディレクトリ

Viewパス¥bin¥

引数

プロセスID

操作できなくなったIM構成管理・ビューアーのjava.exeプロセスのプロセスIDを指定します。

なお，プロセスIDとして指定できるバイト数は，OSの制限に依存します。

IM構成管理・ビューアー（java.exe）以外のプロセスに対して，CTRL_BREAK_EVENTは送信しません。

戻り値

0

正常終了

1

オプションエラー，引数エラー

2

プロセスチェックエラー

3

スレッドダンプ出力要求送信エラー

4

実行権限エラー

10

上記以外のエラー

使用例1

操作できなくなったIM構成管理・ビューアーのプロセスIDが，1234の場合

jcfthreaddmp 1234

使用例2

IM構成管理・ビューアーに対応するjava.exeのプロセスIDの特定方法

次の手順で，操作不能になったIM構成管理・ビューアーに対応するjava.exeのプロセスIDを特定し，jcfthreaddmpコマンドの引数に指定します。

なお，複数のIM構成管理・ビューアーを起動している場合は，java.exeプロセスも複数存在するため，プロセスIDの特定は，使用例2の手順を使用してください。

［PID（プロセスID）］列を追加する。

タスクマネージャのプロセスタブを開き，［表示］−［列の選択］を実行し，列の選択画面で「PID（プロセスID）」にチェックを入れます。

操作不能になったIM構成管理・ビューアーか確認する。

タスクマネージャのアプリケーションタブで，IM構成管理・ビューアーを選択し，右クリックして表示されるポップアップメニューから［手前に表示］を実行します。手前に表示されたIM構成管理・ビューアーが操作できなくなったIM構成管理・ビューアーか確認する。

操作できなくなったIM構成管理・ビューアーのjava.exeの［PID（プロセスID）］を表示する。

アプリケーションタブで操作できなくなったIM構成管理・ビューアーを選択し，右クリックして表示されるポップアップメニューから［プロセスの表示］を実行します。

プロセスタブに切り替わり，操作できなくなったIM構成管理・ビューアーのjava.exeの行が選択されます。その選択行のPID列が，操作できなくなったIM構成管理・ビューアーに対応するjava.exeのプロセスIDとなります。

jddcreatetree

機能

インテリジェント統合管理サーバが管理する製品からシステム構成情報を取得し，jddupdatetreeコマンドの入力データとなるIM管理ノード関連ファイルを生成します。このコマンドを実行する前にjddsetaccessuserコマンドを実行して，認証の際に必要なユーザーIDとパスワードの情報を設定してください。

jddupdatetreeコマンド，およびjddsetaccessuserコマンドについては，それぞれ「jddupdatetree」（1.　コマンド），「jddsetaccessuser」（1.　コマンド）を参照してください。

このコマンドは，インテリジェント統合管理基盤にIM管理ノード関連ファイルの生成要求を出し，要求が完了するまで待機します。

なお，コマンドを実行する前に，システムノード定義ファイル（imdd_systemnode.conf），IM管理ノードカテゴリ名称定義ファイル（imdd_category_name.conf），構成取得対象ホスト定義ファイル（imdd_target_host.conf）の定義が必要です。また，ホスト名にエイリアス名を付けることができる製品をIM管理ノードの構成に加える場合は，ホスト名定義ファイル（imdd_host_name.conf）でエイリアス名と実ホスト名のマッピングを定義しておく必要があります。

IM管理ノード関連ファイルについては，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」のIM管理ノード関連ファイルについて説明している項を参照してください。

また，定義ファイルについては，「システムノード定義ファイル（imdd_systemnode.conf）」（2.　定義ファイル），「IM管理ノードカテゴリ名称定義ファイル（imdd_category_name.conf）」（2.　定義ファイル），「構成取得対象ホスト定義ファイル（imdd_target_host.conf）」（2.　定義ファイル），「ホスト名定義ファイル（imdd_host_name.conf）」（2.　定義ファイル）を参照してください。

形式

jddcreatetree -o ディレクトリ名 [-h 論理ホスト名]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Managerパス¥bin¥imdd¥

UNIXの場合

/opt/jp1imm/bin/imdd/

引数

-o ディレクトリ名

作成するファイルの保存先ディレクトリを，絶対パス形式，またはこのコマンドを実行した場所からの相対パス形式で指定します。パスに空白を含む場合は，「"」で囲みます。パスの長さは，200文字まで指定できます。

-h 論理ホスト名

JP1/IMをクラスタシステムで運用している場合に，JP1/IMの論理ホスト名を指定します。

このオプションを省略した場合は，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを設定していない場合は，物理ホスト名が仮定されます。

構成情報を取得できる論理ホスト名の長さは，最大32バイトです。それより長い論理ホスト名を指定した場合，jddcreatetreeコマンドはメッセージKAJY02015-Eを出力して失敗し，構成管理ツリーは更新されません。

注意事項

jddcreatetreeコマンドは複数を同時に実行できません。実行した場合，エラーとなります。

jddupdatetreeコマンド，およびjddupdatesuggestionコマンドを実行中に，jddcreatetreeコマンドの実行はできません。実行した場合，エラーとなります。

jddcreatetreeコマンドを使用するには，JP1/IM - ManagerおよびIMデータベースが起動している必要があります。

jddcreatetreeコマンドを統合マネージャーホストで使用するには，拠点/中継マネージャーホストのインテリジェント統合管理基盤サービスおよび統合エージェント管理基盤サービスが起動している必要があります。

jddcreatetreeコマンドの実行中に，JP1/IM - ManagerおよびIMデータベースを停止しないでください。

拠点マネージャーまたは中継マネージャーを定義している場合は，システムの階層構成の同期が取れているかを確認したあと，統合マネージャーでjddcreatetreeコマンドを実行してください。なお，拠点マネージャーまたは中継マネージャーでjddcreatetreeコマンドを実行する必要はありません。

jddcreatetreeコマンドは，JP1/AJS3 - Managerホストでジョブを実行していない時間帯に実行してください。ジョブを実行しているときにjddcreatetreeコマンドを実行した場合，両方の処理の負荷が同時にかかることにより，それぞれの処理が遅延する可能性があります。

jddcreatetreeコマンドは，JP1/AJS3サービスが起動しているときに実行してください。構成情報取得先のホストのJP1/AJS3サービスが停止中または起動／停止途中にjddcreatetreeコマンドを実行すると，情報の取得に失敗します。

jddcreatetreeコマンドで情報取得中に，取得先のJP1/AJS3サービスを停止しないでください。停止した場合，サービスの停止処理が遅延する可能性があります。

jddcreatetreeコマンドでは，日本語以外の多バイト文字を含むユニット定義情報の取得はできません。取得した場合，構成管理ツリーが正しく表示されない可能性があります。

jddcreatetreeコマンドで取得する，ユニット名，ユニット定義内容，実行エージェント名，JP1資源グループ名などの情報に制御文字が含まれている場合，情報取得が失敗する可能性があります。取得する情報には，制御文字を含めないようにして運用してください。

構成取得対象の連携製品にJP1/PFMがある場合は，構成取得対象ホスト定義ファイル（imdd_target_host.conf）で，JP1/PFMが先頭（ファイル上側）になるように定義して，jddcreatetreeコマンドを実行してください。

上記以外の方法でjddcreatetreeコマンドを実行すると，失敗することがあります。

構成取得対象の連携製品にJP1/OAがある場合は，JP1/OAの構成情報の取得と，他製品の構成情報の取得を分けて取得するようにしてください。

下記以外の方法でjddcreatetreeコマンドを実行すると，失敗することがあります。

JP1/OA以外の連携製品を構成取得対象ホスト定義ファイル（imdd_target_host.conf）に定義する。

このとき，構成取得対象にJP1/PFMが含まれる場合は，JP1/PFMが先頭（ファイル上側）になるように定義する。

jddcreatetreeコマンドを実行する。

JP1/OAを構成取得対象ホスト定義ファイル（imdd_target_host.conf）に定義する。

2.と同じディレクトリ名を-oオプションに指定して，jddcreatetreeコマンドを実行する。

戻り値

0

正常終了

1

正常終了（プロパティ不正）

2

排他中

3

引数不正

4

論理ホスト名が不正

5

インテリジェント統合管理基盤が利用する認証情報が設定されていない

6

jddcreatetreeコマンドの実行に必要な情報が不足している

7

jddcreatetreeコマンドの実行権限がない

8

指定したディレクトリにアクセスできない

9

指定したディレクトリのパスが長すぎる

11

インテリジェント統合管理基盤への接続に失敗

12

インテリジェント統合管理基盤の認証に失敗

13

前提ファイルが存在しない

14

前提ファイルの読み込みに失敗

15

前提ファイルのフォーマット不正

16

前提ファイルの記載内容不正

17

プラグインからの情報取得に失敗

18

プラグインからの情報が不正

20

IM管理ノードファイルの作成に失敗

21

IM管理ノードリンクファイルの作成に失敗

23

IM管理ノードツリーファイルの作成に失敗

26

認証に使用したユーザーの権限が不足

255

システムエラー

使用例1

作成するファイルの保存先を「C:¥tmp」とする場合の例を次に示します。

$ jddcreatetree -o C:¥tmp
KAJY02009-I コマンド(jddcreatetree)を開始しました
KAJY02010-I コマンド(jddcreatetree)が正常終了しました

使用例2

作成するファイルの保存先を「C:¥tmp」とし，論理ホストを「ronri」とする場合の例を次に示します。

$ jddcreatetree -o C:¥tmp -h ronri
KAJY02009-I コマンド(jddcreatetree)を開始しました
KAJY02010-I コマンド(jddcreatetree)が正常終了しました

jddupdatetree

機能

jddcreatetreeコマンドで取得したIM管理ノード関連ファイル，ユーザーが手動で定義したIM管理ノードリンク定義ファイル（imdd_nodeLink_def.conf）の情報に基づき，IM管理ノードのツリー情報とリンク情報を作成し，構成情報を評価します。

jddupdatetreeコマンドには二つの反映方式のオプションがあり，どちらのオプションを指定するかによって，IM管理ノードの状態の評価が異なります。

反映方式に新規・再構築モードを指定した場合は，統合監視DBに格納されているJP1イベントをすべて取得し，IM管理ノードごとに状況を評価します。反映方式に構成変更モードを指定した場合は，統合監視DBに登録されているJP1イベントを再取得せずに，すでにあるJP1イベント情報，およびJP1イベントとIM管理ノードとのマッピング情報をそのまま引き継いで，評価します。

次の場合は「新規・再構築モード」を指定してください。

新規構築する場合

構築ミスを修正する場合

IMデータベースをバックアップ（jimdbbackupコマンド）し，リカバリー（jimdbrecoverコマンド）した場合

統合監視DBをアンセットアップ（jcodbunsetupコマンド）し，再セットアップ（jcodbsetupコマンド）した場合

インテリジェント統合管理データベースをバックアップ（jimgndbbackupコマン）し，リカバリー（jimgndbrestoreコマンド）した場合

インテリジェント統合管理基盤を利用している環境で，JP1/IM - Managerをバージョンアップした場合

次の場合は「構成変更モード」を指定してください。

構築ミスの修正以外に，インテリジェント統合管理基盤の管理対象の追加・削除・変更を反映する場合

反映方式の詳細については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「3.5.7　システム構成情報の反映方式」を参照してください。

このコマンドを実行する前にjddsetaccessuserコマンドを実行して，認証の際に必要なユーザーIDとパスワードの情報を設定してください。jddcreatetreeコマンドについては，「jddcreatetree」（1.　コマンド）を参照してください。

このコマンドは，インテリジェント統合管理基盤にIM管理ノード関連ファイルの反映要求を出し，要求が完了するまで待機します。

形式

jddupdatetree -i ディレクトリ名 [{-r|-c}] [-h 論理ホスト名]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Managerパス¥bin¥imdd¥

UNIXの場合

/opt/jp1imm/bin/imdd/

引数

-i ディレクトリ名

jddcreatetreeコマンドで作成したファイルの保存先ディレクトリを，絶対パス形式，またはこのコマンドを実行した場所からの相対パス形式で指定します。パスに空白を含む場合は，「"」で囲みます。

-r|-c

反映方式のオプションを指定します。

-r

新規・再構築モードで反映する場合に指定します。-cオプションと同時に指定できません。バージョン12-10以前と同様の反映方式となります。

-c

構成変更モードで反映する場合に指定します。-rオプションと同時に指定できません。

-h 論理ホスト名

JP1/IMをクラスタシステムで運用している場合に，JP1/IMの論理ホスト名を指定します。

このオプションを省略した場合は，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを設定していない場合は，物理ホスト名が仮定されます。

注意事項

jddupdatetreeコマンドは複数を同時に実行できません。実行した場合，エラーとなります。

jddcreatetreeコマンド，およびjddupdatesuggestionコマンドを実行中に，jddupdatetreeコマンドの実行はできません。実行した場合，エラーとなります。

jddupdatetreeコマンドを使用するには，JP1/IM-ManagerおよびIMデータベースが起動している必要があります。

jddupdatetreeコマンドの実行中に，JP1/IM-ManagerおよびIMデータベースを停止しないでください。

-rオプションと-cオプションのどちらの指定も省略した場合は，インテリジェント統合管理基盤定義ファイル（imdd.properties）のjp1.imdd.simt.updateModeプロパティの設定値に従い動作します。

なお，JP1/IM - Managerを新規インストールした場合は，プロパティの設定値にはchange（構成変更モード）が設定されます。バージョン12-10以前からバージョンアップした場合などプロパティの定義がないときは，プロパティの設定値にはreconfigure（新規・再構築モード）が仮定されます。運用にあわせて設定値を変更してください。

統合監視DBに発生元ホストマッピング機能が無効の状態のときに登録されたJP1イベントが含まれる場合，JP1イベントとIM管理ノードのマッピングに失敗して警告メッセージKAJY02022-Wが出力される場合があります。JP1イベントとIM管理ノードのマッピングの詳細については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「3.9.1　JP1イベントを使用した評価」を参照してください。

戻り値

0

正常終了

1

正常終了（プロパティ不正）

2

排他中

3

引数不正

4

論理ホスト名が不正

5

インテリジェント統合管理基盤が利用する認証情報が設定されていない

6

jddupdatetreeコマンド実行に必要な情報が不足している

7

jddupdatetreeコマンドの実行権限がない

8

指定したディレクトリが存在しない

10

IMデータベースサービスが起動していない

11

インテリジェント統合管理基盤への接続に失敗

12

インテリジェント統合管理基盤の認証に失敗

13

前提ファイルが存在しない

14

前提ファイルの読み込みに失敗

15

前提ファイルのフォーマット不正

16

前提ファイルの記載内容不正

17

イベント情報の取得に失敗

19

プラグインからの情報取得に失敗

22

マスターファイルの置換に失敗

26

認証に使用したユーザーの権限が不足

27

どのIM管理ノードにもマッピングされない提案定義が存在する

28

提案関連マスターファイル※の作成に失敗

29

提案関連マスターファイル※の置き換えに失敗

255

システムエラー

注※

提案定義マスターファイルなどの提案に関するマスター情報の総称を意味します。JP1/IM - Managerのサービス起動時に読み込まれます。

使用例1

jddcreatetreeコマンドで作成したファイルの保存先を「C:¥tmp」とする場合の例を次に示します。

$ jddupdatetree -i C:¥tmp
KAJY02009-I コマンド(jddupdatetree)を開始しました
KAJY02010-I コマンド(jddupdatetree)が正常終了しました

使用例2

jddcreatetreeコマンドで作成したファイルの保存先を「C:¥tmp」とし，論理ホストを「ronri」とする場合の例を次に示します。

$ jddupdatetree -i C:¥tmp -h ronri
KAJY02009-I コマンド(jddupdatetree)を開始しました
KAJY02010-I コマンド(jddupdatetree)が正常終了しました

使用例3

反映方式に新規・再構築モードを指定して実行する場合の例を次に示します。

$ jddupdatetree -i C:¥tmp -r
KAJY02009-I コマンド(jddcreatetree)を開始しました
KAJY02010-I コマンド(jddcreatetree)が正常終了しました

使用例4

反映方式に構成変更モードを指定して実行する場合の例を次に示します。

$ jddupdatetree -i C:¥tmp -c
KAJY02009-I コマンド(jddcreatetree)を開始しました
KAJY02010-I コマンド(jddcreatetree)が正常終了しました

jddsetaccessuser

機能

インテリジェント統合管理基盤の認証に関する定義を実行するコマンドです。このコマンドで定義するユーザーIDとパスワードの情報は，次に示す認証時に利用されます。

インテリジェント統合管理基盤から監視対象のJP1製品への接続する際の認証

インテリジェント統合管理基盤の各コマンドからインテリジェント統合管理基盤に接続する際の認証

OpenID認証を連携している際のインテリジェント統合管理基盤の認証

形式

jddsetaccessuser -id ユーザーID -pw パスワード [-h 論理ホスト名]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Managerパス¥bin¥imdd¥

UNIXの場合

/opt/jp1imm/bin/imdd/

引数

-id ユーザーID

JP1/IM，JP1/PFM，JP1/AJSの管理者権限を持つユーザーのユーザーIDを指定します。

ユーザーIDは1〜31バイト以内の文字列で指定します。

使用できる文字は半角英数字と記号「!」，「$」，「%」，「&」，「_」，「-」，「#」，「@」です。

大文字が指定された場合でも小文字で指定されたものとして扱われます。

-pw パスワード

-idオプションで指定したユーザーに対するパスワードを指定します。

パスワードは6〜32バイト以内の文字列で指定します。

使用できる文字は半角英数字と記号「!」，「#」，「$」，「%」，「&」，「_」，「-」，「*」，「/」，「'」，「^」，「[」，「]」，「{」，「}」，「(」，「)」，「;」，「|」，「=」，「+」，「?」，「<」，「>」です。

大文字と小文字は区別します。パスワードに「^<>|&」が含まれる場合は「"」で囲んで指定します。

-h 論理ホスト名

JP1/IMをクラスタシステムで運用している場合に，論理ホスト名を指定します。このオプションを省略した場合は，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合は，物理ホスト名が仮定されます。

戻り値

0

正常終了

1

引数不正

2

引数指定値不正

3

ファイルの作成に失敗

4

論理ホスト名が不正

7

jddsetaccessuserコマンドの実行権限がない

255

システムエラー

使用例1

「UserA」に「ABCDEF」というパスワードを設定する場合の例を次に示します。

$ jddsetaccessuser -id UserA -pw ABCDEF
KAJY02009-I コマンド(jddsetaccessuser)を開始しました
KAJY02010-I コマンド(jddsetaccessuser)が正常終了しました

使用例2

「UserA」に「ABCDEF」というパスワードを論理ホスト「ronri」に設定する場合の例を次に示します。

$ jddsetaccessuser -id UserA -pw ABCDEF -h ronri
KAJY02009-I コマンド(jddsetaccessuser)を開始しました
KAJY02010-I コマンド(jddsetaccessuser)が正常終了しました

jddsetproxyuser

機能

JP1/IM - Manager（インテリジェント統合管理基盤）が提供するプラグインからREST APIを実行する場合のプロキシサーバーの認証情報を設定するコマンドです。プロキシサーバーの認証を使用しない場合は，この設定は不要です。

形式1

Usage:
jddsetproxyuser {-list|-add -id ユーザーID -pw パスワード|-rm -id ユーザーID} [-h 論理ホスト名]

形式2

jddsetproxyuser -list [-h 論理ホスト名]

形式3

jddsetproxyuser -add -id ユーザーID -pw パスワード[-h 論理ホスト名]

形式4

jddsetproxyuser -rm -id ユーザーID [-h 論理ホスト名]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Managerパス¥bin¥imdd¥

UNIXの場合

/opt/jp1imm/bin/imdd/

引数

-list

インテリジェント統合管理基盤に設定されているプロキシサーバー認証情報を取得する場合に指定します。

-add

インテリジェント統合管理基盤に設定されているプロキシサーバー認証情報を更新する場合に指定します。このオプションを指定した場合，-idオプションと-pwオプションの指定は必須です。指定がない場合はエラーとなります。

-rm

インテリジェント統合管理基盤に設定されているプロキシサーバー認証情報を削除する場合に指定します。このオプションを指定した場合，-idオプションの指定は必須です。指定がない場合はエラーとなります。

-id ユーザーID

プロキシサーバー認証用ユーザーのユーザーIDを指定します。

-pw パスワード

-idオプションで指定したユーザーに対するパスワードを指定します。

-h 論理ホスト名

JP1/IMをクラスタシステムで運用している場合に，論理ホスト名を指定します。このオプションを省略した場合は，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合は，物理ホスト名が仮定されます。

注意事項

jddsetproxyuserコマンドは複数を同時に実行できません。実行した場合，エラーとなります。

jddsetproxyuserコマンドの実行中に，JP1/IM - ManagerおよびIMデータベースを停止しないでください。

jddsetproxyuserコマンドはプロキシ認証情報設定APIと同時に実行できません。プロキシ認証情報設定APIについては，「5.9.1　プロキシ認証情報設定」を参照してください。

JP1/IM - Managerの停止中にjddsetproxyuserコマンドを実行した場合，KAJY52015-Wメッセージを出力し，次回JP1/IM - Managerを起動した際に設定を反映します。

戻り値

0

正常終了

1

引数不正

2

排他中

3

引数指定値不正

4

論理ホスト名が不正

5

インテリジェント統合管理基盤が利用する認証情報が設定されていない

7

jddsetproxyuserコマンドの実行権限がない

11

インテリジェント統合管理基盤への接続に失敗

12

インテリジェント統合管理基盤の認証に失敗

13

プロキシ認証情報更新失敗

255

システムエラー

使用例1

インテリジェント統合管理基盤に設定されているプロキシサーバー認証情報を取得する場合の例を次に示します。

jddsetproxyuser -list
KAJY02009-I コマンド(jddsetproxyuser)を開始しました
User1
User2
KAJY02010-I コマンド(jddsetproxyuser)が正常終了しました

使用例2

インテリジェント統合管理基盤に設定されているプロキシサーバー認証情報を更新する場合の例を次に示します。

jddsetproxyuser -add -id User3 -pw PASSWORD
KAJY02009-I コマンド(jddsetproxyuser)を開始しました
KAJY02010-I コマンド(jddsetproxyuser)が正常終了しました

jddsetproxyuser -list
KAJY02009-I コマンド(jddsetproxyuser)を開始しました
User1
User2
User3
KAJY02010-I コマンド(jddsetproxyuser)が正常終了しました

使用例3

インテリジェント統合管理基盤に設定されているプロキシサーバー認証情報を削除する場合の例を次に示します。

jddsetproxyuser -rm -id User3
KAJY02009-I コマンド(jddsetproxyuser)を開始しました
KAJY02010-I コマンド(jddsetproxyuser)が正常終了しました

jddsetproxyuser -list
KAJY02009-I コマンド(jddsetproxyuser)を開始しました
User1
User2
KAJY02010-I コマンド(jddsetproxyuser)が正常終了しました

jddupdatesuggestion

機能

指定したディレクトリ直下の提案定義ファイルをすべて読み込み，インテリジェント統合管理基盤に反映するコマンドです。

提案定義ファイルがすでにインテリジェント統合管理基盤に反映済みの場合は，反映済みの定義内容をすべて破棄し，指定した提案定義ファイルの定義内容に置き換えます。提案定義ファイルの定義内容に誤りがある場合は，定義内容に誤りが見つかった時点でコマンドの処理を中断します。

このコマンドを実行する前にjddsetaccessuserコマンドを実行して，認証の際に必要なユーザーIDとパスワードの情報を設定してください。

形式

jddupdatesuggestion -i ディレクトリ名 [-h 論理ホスト名]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Managerパス¥bin¥imdd¥

UNIXの場合

/opt/jp1imm/bin/imdd/

引数

-i ディレクトリ名

提案定義ファイルの保存先ディレクトリを絶対パス形式，またはこのコマンドを実行した場所からの相対パス形式で指定します。パスに空白を含む場合は，「"」で囲みます。

-h 論理ホスト名

JP1/IMをクラスタシステムで運用している場合に，論理ホスト名を指定します。このオプションを省略した場合は，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合は，物理ホスト名が仮定されます。

注意事項

jddupdatesuggestionコマンドは複数を同時に実行できません。実行した場合，エラーとなります。

jddcreatetreeコマンド，およびjddupdatetreeコマンドを実行中にこのコマンドは実行できません。実行した場合，エラーとなります。

jddupdatesuggestionコマンドは，JP1/IM - Managerサービスの起動中に実行する必要があります。

戻り値

0

正常終了

1

正常終了（警告メッセージあり）

2

同時実行エラー

3

引数不正

4

論理ホスト名が不正

5

インテリジェント統合管理基盤が利用する認証情報が設定されていない

6

jddupdatesuggestionコマンドの実行権限がない

7

指定したディレクトリが存在しない

8

インテリジェント統合管理基盤への接続に失敗

9

インテリジェント統合管理基盤の認証に失敗

10

認証に使用したユーザーの権限が不足

11

提案定義ファイルが存在しない

12

提案定義ファイルの読み込みに失敗

13

提案定義ファイルのフォーマット不正

14

提案定義ファイルの記載内容不正

15

提案定義マスターファイル※の作成に失敗

255

システムエラー

注※

-iオプションで指定した提案定義ファイルを，マスター情報として一つにまとめて出力したファイルのことです。

使用例1

提案定義ファイルの格納先を「C:¥tmp」とする場合の例を次に示します。

$ jddupdatesuggestion -i C:¥tmp
KAJY02009-I コマンド(jddupdatesuggestion)を開始しました
KAJY02010-I コマンド(jddupdatesuggestion)が正常終了しました

使用例2

提案定義ファイルの格納先を「C:¥tmp」，論理ホストを「ronri」とする場合の例を次に示します。

$ jddupdatesuggestion -i C:¥tmp -h ronri
KAJY02009-I コマンド(jddupdatesuggestion)を開始しました
KAJY02010-I コマンド(jddupdatesuggestion)が正常終了しました

jddsetopinfo

機能

OpenID認証連携でOpenIDプロバイダに登録したインテリジェント統合管理基盤のクライアントの情報（クライアントIDとクライアントシークレット）を，JP1/IM - Manager（インテリジェント統合管理基盤）に設定するコマンドです。

クライアントIDとクライアントシークレットは，OpenIDプロバイダに登録したインテリジェント統合管理基盤のクライアントの認証に使用する情報です。このため，JP1/IM - Manager（インテリジェント統合管理基盤）を起動する前に，このコマンドを実行しておく必要があります。

形式1

Usage:
jddsetopinfo {-list|-add -provider OpenIDプロバイダ名 -id クライアントID -secret クライアントシークレット|-rm -provider OpenIDプロバイダ名} [-h 論理ホスト名]

形式2

jddsetopinfo -list [-h 論理ホスト名]

形式3

jddsetopinfo -add -provider OpenIDプロバイダ名 -id クライアントID -secret クライアントシークレット [-h 論理ホスト名]

形式4

jddsetopinfo -rm -provider OpenIDプロバイダ名 [-h 論理ホスト名]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Managerパス¥bin¥imdd¥

UNIXの場合

/opt/jp1imm/bin/imdd/

引数

-list

インテリジェント統合管理基盤に設定されているOpenIDプロバイダのクライアント情報を取得する場合に指定します。

同時に指定できるのは，-hオプションだけです。

-add

インテリジェント統合管理基盤に設定されているOpenIDプロバイダのクライアント情報を追加または更新する場合に指定します。このオプションを指定した場合，-providerオプション，-idオプションおよび-secretオプションの指定は必須です。指定しなかった場合はKAJY02011-Eのエラーメッセージが出力されます。それ以外のオプションとは，同時に指定できません。

-rm

インテリジェント統合管理基盤に設定されているOpenIDプロバイダのクライアント情報を削除する場合に指定します。このオプションを指定した場合，-providerオプションの指定は必須です。指定しなかった場合はKAJY02011-Eのエラーメッセージが出力されます。

-providerオプション，-hオプション以外のオプションとは，同時に指定できません。

-provider OpenIDプロバイダ

OpenIDプロバイダ名を指定します。インテリジェント統合管理基盤定義ファイル（imdd.properties）のOpenIDプロバイダの定義で設定した＜OpenIDプロバイダのキー名＞と同じ値を指定してください。詳細については「インテリジェント統合管理基盤定義ファイル（imdd.properties）」（2.　定義ファイル）を参照してください。

-listオプションとは，同時に指定できません。

-id クライアントID

クライアントIDを指定します。指定できる文字は，利用するOpenIDプロバイダの仕様に準じます。

-listオプション，-rmオプションとは，同時に指定できません。

-secret クライアントシークレット

-idオプションで指定したクライアントIDに対するクライアントシークレットを指定します。指定できる文字は，利用するOpenIDプロバイダの仕様に準じます。

-listオプション，-rmオプションとは，同時に指定できません。

-h 論理ホスト名

JP1/IMをクラスタシステムで運用している場合に，論理ホスト名を指定します。このオプションを省略した場合は，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合は，物理ホスト名が仮定されます。

注意事項

jddsetopinfoコマンドは複数を同時に実行できません。実行した場合，エラーとなります。

jddsetopinfoコマンドは，JP1/IM - Manager（インテリジェント統合管理基盤）を起動する前に，実行しておく必要があります。

JP1/IM - Manager（インテリジェント統合管理基盤）の起動中にjddsetopinfoコマンドを実行した場合，次回JP1/IM - Manager（インテリジェント統合管理基盤）を起動した際に設定を反映します。

戻り値

0

正常終了

2

排他失敗

3

引数不正

4

論理ホスト名が不正

5

設定に失敗

6

指定したOpenIDプロバイダのクライアント情報が存在しない

7

jddsetopinfoコマンドの実行権限がない

255

システムエラー

使用例1

インテリジェント統合管理基盤に設定されているOpenIDプロバイダのクライアント情報を取得する場合の例を次に示します。

jddsetopinfo -list
KAJY02009-I コマンド(jddsetopinfo)を開始しました
okta:IM1210
keycloak:IM1210
KAJY02010-I コマンド(jddsetopinfo)が正常終了しました

使用例2

インテリジェント統合管理基盤に設定されているOpenIDプロバイダのクライアント情報を追加または更新する場合の例を次に示します。

jddsetopinfo -add -provider okta -id id001 -secret SECRET
KAJY02009-I コマンド(jddsetopinfo)を開始しました
KAJY02010-I コマンド(jddsetopinfo)が正常終了しました

登録状況を確認します。

jddsetopinfo -list
KAJY02009-I コマンド(jddsetopinfo)を開始しました
okta:id001
keycloak:id001
KAJY02010-I コマンド(jddsetopinfo)が正常終了しました

使用例3

インテリジェント統合管理基盤に設定されているOpenIDプロバイダのクライアント情報を削除する場合の例を次に示します。

jddsetopinfo -rm -provider okta
KAJY02009-I コマンド(jddsetopinfo)を開始しました
KAJY02010-I コマンド(jddsetopinfo)が正常終了しました

登録状況を確認します。

jddsetopinfo -list
KAJY02009-I コマンド(jddsetopinfo)を開始しました
keycloak:User2
KAJY02010-I コマンド(jddsetopinfo)が正常終了しました

jddupdatessomap

機能

シングルサインオンマッピング定義ファイルで定義したマッピング情報を，JP1/IM - Manager（インテリジェント統合管理基盤）に反映するコマンドです。

なお，シングルサインオンマッピング定義ファイルに有効なプロパティが一つも存在しない状態でこのコマンドを実行した場合はKAJY52031-Wメッセージを出力し，反映済みのシングルサインオンマッピング定義をクリアします。

形式

Usage:
jddupdatessomap [-h 論理ホスト名]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Managerパス¥bin¥imdd¥

UNIXの場合

/opt/jp1imm/bin/imdd/

引数

-h 論理ホスト名

JP1/IMをクラスタシステムで運用している場合に，論理ホスト名を指定します。このオプションを省略した場合は，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合は，物理ホスト名が仮定されます。

注意事項

jddupdatessomapコマンドは複数を同時に実行できません。実行した場合，エラーとなります。

jddupdatessomapコマンドは，インテリジェント統合管理基盤サービスの起動中に実行してください。

戻り値

0

正常終了

1

正常終了（プロパティ不正またはシングルサインオンマッピング定義が空）

2

排他失敗

3

引数不正

4

論理ホスト名が不正

5

インテリジェント統合管理基盤が利用する認証情報が設定されていない

7

コマンド実行に必要な権限が無い

11

インテリジェント統合管理基盤への接続に失敗

12

インテリジェント統合管理基盤への認証に失敗

13

インテリジェント統合管理基盤への反映に失敗

14

定義ファイル読み込みエラー

255

システムエラー

使用例

jddsetssomap
KAJY02009-I コマンド(jddsetssomap)を開始しました
KAJY02010-I コマンド(jddsetssomap)が正常終了しました

jddupdateaction

機能

ユーザーが定義した自動対処アクション定義ファイルを読み込み，インテリジェント統合管理基盤に反映するコマンドです。

形式

Usage:
jddupdateaction [-h 論理ホスト名]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Managerパス¥bin¥imdd¥

UNIXの場合

/opt/jp1imm/bin/imdd/

引数

-h 論理ホスト名

JP1/IMをクラスタシステムで運用している場合に，論理ホスト名を指定します。

このオプションを省略した場合は，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。ただし，環境変数JP1_HOSTNAMEに空文字列を指定しているときは，物理ホスト名が仮定されます。

このオプションを省略，かつ，環境変数JP1_HOSTNAMEを指定していない場合は，物理ホスト名が仮定されます。

注意事項

このコマンドを使用する場合，JP1/IM3-Managerサービスが起動している必要があります。

戻り値

0

正常終了

1

正常終了（警告メッセージあり）

2

引数不正

3

論理ホスト名が不正

4

インテリジェント統合管理基盤が利用する認証情報が設定されていない

5

コマンド実行に必要な権限が無い

6

インテリジェント統合管理基盤への接続に失敗

7

インテリジェント統合管理基盤への認証に失敗

8

認証に使用したユーザーの権限が不足

9

自動対処アクション定義ファイルの読み込みに失敗

10

自動対処アクション定義ファイルのフォーマット不正

11

自動対処アクション定義ファイルの記載内容不正

255

システムエラー

使用例

論理ホストを「ronri」とする場合の例を次に示します。

$ jddupdateaction -h ronri
KAJY02009-I コマンド(jddupdateaction)を開始しました
KAJY02010-I コマンド(jddupdateaction)が正常終了しました

jcfview（Windows限定）

機能

IM構成管理・ビューアーを起動します。-hオプション，-uオプション，-pオプションで起動した場合，［ログイン］画面を表示しないで，自動的にログインします。

形式

jcfview [-h 接続先ホスト名] [-u ユーザー名] [-p パスワード]

実行権限

なし

格納先ディレクトリ

Viewパス¥bin¥

引数

-h 接続先ホスト名

ログインするIM構成管理が起動しているホスト名を指定します。指定できる文字数は，1〜255バイトです。JP1/IM - Managerが起動しているホストだけを指定できます。

接続先ホスト名には，次のものが指定できます。

コマンドを使用するホストで定義されているホスト名

コマンドを使用するホストでアドレス解決可能なホスト名

IPアドレス

IPアドレスを指定する場合，IPv4アドレス形式のアドレスだけ指定できます。IPv6アドレス形式のアドレスは指定できません。

このオプションは省略できますが，-pオプションを指定するときは省略できません。

-hオプションだけで起動した場合，または-hオプションと-uオプションで起動した場合，引数をデフォルト値として［ログイン］画面が表示されます。-hオプションと-pオプションで起動した場合，エラーとなります。

-u ユーザー名

認証サーバに登録してあるJP1ユーザー名を指定します。指定できる文字数は，1〜31バイトです。半角英数字（英字は小文字）だけを使用できます。

このオプションは省略できますが，-pオプションを指定するときは省略できません。

-uオプションだけで起動した場合，または-hオプションと-uオプションで起動した場合，引数をデフォルト値として［ログイン］画面を表示します。-uオプションと-pオプションで起動した場合，エラーとなります。

-p パスワード

指定したユーザー名に対応するパスワードを指定します。指定できる文字数は，6〜32バイトです。半角英数字だけを使用できます。英字は，大文字・小文字が区別されます。このオプションは省略できます。

このオプションを指定する場合は，-hおよび-uオプションも指定する必要があります。

戻り値

0

正常終了

1

引数エラー

2

メモリー不足

3

リソースの取得に失敗

4

エラーメッセージの作成に失敗

5

IM構成管理・ビューアーを強制終了

255

システムエラー

使用例1

IM構成管理・ビューアーを起動して，[ログイン]画面を表示する場合

jcfview

使用例2

［ログイン］画面を表示させないで自動的にログインする場合

接続先ホスト（host1），ユーザー名（user2），パスワード（password）を指定してIM構成管理・ビューアーを起動します。

jcfview -h host1 -u user2 -p password

jcfvirtualchstat

機能

指定ホストの仮想化構成を更新します。

仮想化環境管理ソフトウェアが管理する仮想化構成が変更された場合，このコマンドを実行することによって仮想化構成の変更をIM構成管理に反映できます。

なお，同時に実行できるコマンドの数は5個までです。

形式

jcfvirtualchstat    -c ホスト名
                    [-h 論理ホスト名]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納ディレクトリ

Windowsの場合

Managerパス¥bin¥imcf¥

UNIXの場合

/opt/jp1imm/bin/imcf/

引数

-c ホスト名

仮想化構成情報の収集対象のホスト名を指定します。ホスト名は，255文字以内で指定します。

-h 論理ホスト名

クラスタシステムで運用している場合に，論理ホスト名を指定します。論理ホスト名は，255バイト以内で指定します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。クラスタシステムを使用していない場合には指定は不要です。

注意事項

このコマンドは実行系ホストでだけ実行してください。コマンドの実行時は共有ディスクをマウントした状態で実行してください。

このコマンドは待機系ホストでは実行しないでください。

UNIX/Linux環境の待機系ホストで実行した場合，待機系ホストのローカルディスクのルート直下に「/共有ディレクトリ名」という不要なディレクトリが作成され，その配下にも次の不要なディレクトリとファイルが作成されます。

/共有ディレクトリ名/jp1imm

/共有ディレクトリ名/jp1imm/log

/共有ディレクトリ名/jp1imm/log/imcf

上記のローカルディスクにあるルート直下の「/共有ディレクトリ名」およびそのディレクトリ配下のファイルは不要であるため削除してください。削除する際は誤って共有ディスク上のディレクトリおよびファイルを削除しないように，必ず待機系ホスト上で共有ディスクがマウントされていないことを確認して実施してください。

戻り値

0

正常終了

4

オプション不正

8

サーバに接続できない

12

メモリーが不足した

16

権限が不正

21

同時実行数の上限に達した

24

入出力エラーが発生した

120

システムエラーが発生した

124

その他エラーにより終了した

201以上

JavaVMの起動エラーが発生した

jco_killall.cluster（UNIX限定）

機能

クラスタシステムで運用している場合に，JP1/IM - Managerのプロセスを強制的に終了します。

クラスタ運用時には，jco_stop.clusterコマンドを実行してもプロセスが停止しなくて，クラスタ運用が失敗することがあります。このコマンドは，停止しないプロセスを強制終了します。このコマンドは，正規の方法でJP1/IM - Managerのサービスを停止してもプロセスが停止しない場合にだけ使用してください。

終了させるプロセスを次に示します。

プロセス管理（jco_spmd）

アクション実行サービス（jcamain）

イベントコンソールサービス（evtcon）

イベント基盤サービス（evflow）

相関イベント発行サービス（evgen）

セントラルスコープサービス（jcsmain）

IM構成管理サービス（jcfmain）

IMデータベースサービス

インテリジェント統合管理データベースサービス

トレンドデータ管理サービス

インテリジェント統合管理基盤サービス（jddmain）

統合エージェント管理基盤サービス（imbase）

統合エージェント管理基盤サービス（imbaseproxy）

形式

jco_killall.cluster [論理ホスト名]

実行権限

スーパーユーザー権限

格納先ディレクトリ

/etc/opt/jp1cons/

引数

論理ホスト名

JP1/Baseで設定した論理ホスト名を指定します。指定できる文字数は，1〜32バイトです。省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。

注意事項

このコマンドは，論理ホスト名を先頭から32バイトまでで判定して，対応するプロセスを強制終了します。名称が33バイト以上の論理ホストのプロセスを強制終了できません。

戻り値

0

正常終了

1

論理ホスト名が指定されていない

2

ログディレクトリがない

jco_spmd_reload

機能

JP1/IM - Managerのプロセスの状態を更新します。JP1/IM - Managerの定義情報を変更した場合に，変更した内容を再度読み込んで有効にします。

jco_spmd_reloadコマンドの実行で有効になる定義ファイル，およびその定義情報は次のとおりです。詳細については，「2.　定義ファイル」記載の各定義ファイルの「定義の反映時期」を参照してください。

自動アクション環境定義ファイル（action.conf.update）の次の情報

ANDイベント保管期限（"EVENTALIVEPERIOD"）

アクション実行標準ユーザー（"ACTIONEXECUSER"）

自動アクション発行イベント（"SENDABLE_EVENT"）

イベント発行元ホスト名取得方法（"HOSTINEVENT"）

自動アクション通知定義ファイル（actnotice.conf）

拡張起動プロセス定義ファイル（jp1co_service.conf）

ヘルスチェック定義ファイル（jcohc.conf）

イベントガイド情報ファイル（jco_guide.txt）

ホスト情報ファイル（jcs_hosts）

ガイド情報ファイル（jcs_guide_xxx.txt）

相関イベント発行システムプロファイル（egs_system.conf）

相関イベント発行環境定義ファイル

インシデント手動登録定義ファイル（incident.conf）

インシデント引き継ぎ情報設定ファイル（incident_info.conf）

発生元ホストマッピング定義ファイル（user_hostmap.conf）

重大度変更定義ファイル（jcochsev.conf）

重大度変更定義表示項目定義ファイル（chsev_attr_list.conf）

重大度変更定義自動入力定義ファイル（chsev_auto_list.conf）

イベント条件表示項目定義ファイル（attr_list.conf）

繰り返しイベント条件表示項目定義ファイル（event_storm_attr_list.conf）

繰り返しイベント条件自動入力定義ファイル（event_storm_auto_list.conf）

共通除外条件表示項目定義ファイル（common_exclude_filter_attr_list.conf）

共通除外条件自動入力定義ファイル（common_exclude_filter_auto_list.conf）

イベント拡張属性定義ファイル

イベント拡張属性定義ファイル（拡張ファイル）

表示メッセージ変更定義ファイル（jcochmsg.conf）

表示メッセージ変更定義自動入力定義ファイル（chmsg_auto_list.conf）

表示メッセージ変更定義表示項目定義ファイル（chmsg_attr_list.conf）

モニター画面呼び出し定義ファイル

IM構成反映方式設定ファイル（jp1cf_applyconfig.conf）

形式

jco_spmd_reload [-h 論理ホスト名]
                [-t 監視時間]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Consoleパス¥bin¥

UNIXの場合

/opt/jp1cons/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，論理ホスト名を指定します。指定できる文字数は，1〜255バイトです。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。クラスタシステムを使用していない場合には指定は不要です。

-t 監視時間

jco_spmd_reloadコマンドの実行終了を待つ時間を秒単位で指定します。指定できる値は，0〜32,767（単位：秒）です。指定した時間内にjco_spmd_reloadコマンドの実行が終わらない場合，jco_spmd_reloadコマンドの実行が失敗したと見なします。デフォルトは，60秒です。

注意事項

jco_spmd_reloadコマンドは，jco_spmd_statusコマンドと同時に実行できません。

戻り値

0

正常終了

0以外の値

異常終了

jco_spmd_status

機能

JP1/IM - Managerのプロセス群の起動状態を表示するコマンドです。

形式

jco_spmd_status [-h 論理ホスト名]
                [-t 監視時間]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Consoleパス¥bin¥

UNIXの場合

/opt/jp1cons/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，論理ホスト名を指定します。指定できる文字数は，1〜255バイトです。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。クラスタシステムを使用していない場合には指定は不要です。

-t 監視時間

jco_spmd_statusコマンドの実行終了を待つ時間を秒単位で指定します。指定できる値は，0〜32,767（単位：秒）です。指定した時間内にjco_spmd_statusコマンドの実行が終わらない場合，jco_spmd_statusコマンドの実行が失敗したと見なします。デフォルトは60秒です。

戻り値

0

すべての子プロセスが起動している

1

プロセス管理との通信などでエラーが発生した

クラスタシステムで運用している場合に共有フォルダ（共有ディレクトリ）がマウントされていない

実行権限エラー（Windows限定）

4

一部の子プロセスが起動している

8

すべて停止している

12

要求処理中（リトライ可能）

jco_start（UNIX限定）

機能

JP1/IM - Managerを自動的に起動するためのスクリプトです。

このコマンドを実行するためには，JP1/IM - Managerのインストールとセットアップの完了後，次に示す操作が必要です。

# cd /etc/opt/jp1cons

# cp -p jco_start.model jco_start

この操作によって，システムの開始時に，JP1/IM - Managerが自動的に起動します。システムの開始時に，JP1/IM - Managerを自動的に起動させたくない場合はこの操作を行わないでください。

バージョン10以前のJP1/IM - Managerで自動起動していた場合，必ずこの操作をしてください。

自動起動の設定については，マニュアル「JP1/Integrated Management 3 - Manager 構築ガイド」の「2.18.2　自動起動および自動終了の設定（UNIXの場合）」を参照してください。

JP1/IM - Managerを手動で起動する場合は，/etc/opt/jp1cons/jco_start.modelスクリプト，またはこのスクリプトをコピーしたファイルを実行してください。

バージョン10以前のJP1/IM - Managerでjco_start.modelをコピーしたスクリプトで手動起動していた場合，このスクリプトをjco_start.modelで上書きしてください。

なお，このコマンドを実行する前に必ずJP1/Baseを起動してください。JP1/IM - Managerは，前提製品JP1/Baseの機能を使用して動作しています。

また，次の条件をすべて満たす場合にこのコマンドを実行すると，IMデータベースサービスを起動したあと，JP1/IM - Managerを起動します。

IMデータベースサービスをセットアップしている

統合監視DBを使用している，またはIM構成管理サービスを起動する設定にしている

インテリジェント統合管理データベースを利用している場合は，上記のIMデータベースサービスを起動したあと，インテリジェント統合管理データベース，トレンドデータ管理サービスの順序で起動してから，最後にJP1/IM - Managerを起動します。

JP1/IM - Managerのプロセス群に起動要求を出したあと，戻り値0で終了します。プロセス群が正しく起動したかどうかは，jco_startコマンドの終了後，jco_spmd_statusコマンドで起動したサービスのプロセスIDを表示させて確認してください。ただし，IMデータベースサービスのプロセスIDは，表示されません。

形式

jco_start

実行権限

スーパーユーザー権限

格納先ディレクトリ

/etc/opt/jp1cons/

注意事項

このコマンドをリモートシェルコマンドで実行する場合，標準入力，標準出力，および標準エラー出力を切断（標準入力，標準出力，標準エラー出力に/dev/nullを割り当てる）しておいてください。JP1/IM - Managerのプロセスの起動が完了しても，リモートシェルコマンドが終了しないおそれがあります。

環境変数JP1_HOSTNAMEが設定されていない環境でこのコマンドを実行してください。環境変数JP1_HOSTNAMEが設定されている環境でこのコマンドを実行すると，物理ホストではなく環境変数JP1_HOSTNAMEに設定した論理ホストのJP1/IM - Managerを起動しようとします。このコマンドは論理ホストに対応していないため，物理ホストのJP1/IM - Managerを起動する場合は，環境変数JP1_HOSTNAMEを削除してください。

jco_startコマンドは，jco_spmd_statusコマンドと同時に実行できません。

戻り値

0

正常終了

1

引数が二つ以上指定されている，イベントサービスが起動していない，またはIMデータベースサービスが起動できない

2

ログディレクトリがない

使用例1

統合監視DBを使用している場合

入力値

jco_start

結果

Please wait a minutes, now starting the IM database service...
KNAN11188-I The status of the IM database service will now be confirmed.
KNAN11183-I The IM database service is stopped.
KNAN11189-I The status of the IM database service was successfully confirmed.
Please wait a minutes, now starting JP1/IM - Manager...
KAVB3690-I Processing to report the status of JP1_CONS has started.
Display the running processes
process name  process ID
      evflow      18990
     jcamain      19036
      evtcon      19037
KAVB3691-I All the processes have started.

使用例2

統合監視DBを使用していない，およびIM構成管理サービスを起動していない場合

入力値

jco_start

結果

Please wait a minutes, now starting JP1/IM - Manager...
KAVB3690-I Processing to report the status of JP1_CONS has started.
Display the running processes
process name  process ID
       evflow      19237
      jcamain      19277
       evtcon      19278
KAVB3691-I All the processes have started.

使用例3

IMデータベースを使用していない場合

入力値

jco_start

結果

Please wait a minutes, now starting the IM database service...
KNAN11188-I The status of the IM database service will now be confirmed.
KNAN11109-E The IM database service is not set up.
Unable start JP1/IM - Manager.

使用例4

統合監視DBおよびトレンドデータ管理DBを使用している場合

入力値

jco_start

結果

Please wait a minutes, now starting the IM database service...
KNAN11188-I The status of the IM database service will now be confirmed.
KNAN11183-I The IM database service is stopped.
KNAN11189-I The status of the IM database service was successfully confirmed.
Please wait a minutes, now starting the Intelligent Integrated DB...
KNAN12055-I The Intelligent Integrated Management Database Service will now start.
KNAN12057-I The trend data management service will now start.
KNAN12056-I The Intelligent Integrated Management Database Service started normally.
KNAN12058-I The trend data management service started normally.
KNAN12044-I The processing to confirm the service operating status will now start.
KNAN12047-I The Intelligent Integrated Management Database Service is running.
KNAN12048-I The trend data management service is running.
KNAN12045-I The processing to confirm the service operating status ended normally.
Please wait a minutes, now starting JP1/IM - Manager...
KAVB3690-I Processing to report the status of JP1_CONS has started.
Display the running processes
process name  process ID
      evflow      26290
     jcamain      26374
      evtcon      26375
     jddmain      26291
KAVB3691-I All the processes have started.

jco_start.cluster（UNIX限定）

機能

クラスタシステムで運用している場合に，論理ホスト上のJP1/IM - Managerを起動します。

クラスタソフトにこのコマンドを登録すると，JP1/IM - Managerが起動します。

このコマンドを実行する前に，同じ論理ホスト上のJP1/Baseを起動してください。JP1/Baseのイベントサービスが起動していない場合にこのコマンドを実行したときは，エラーとなります。

JP1/IM - Managerのプロセス群に起動要求を出したあと，戻り値0で終了します。プロセス群が正しく起動したかどうかは，jco_start.clusterコマンドの終了後，jco_spmd_statusコマンドで確認してください。

また，次の条件を満たす場合にこのコマンドを実行すると，IMデータベースサービスを起動したあと，インテリジェント統合管理データベース，トレンドデータ管理サービスの順序で起動してから，最後にJP1/IM - Managerを起動します。

■IMデータベースサービスの起動条件（すべての条件を満たす必要があります）

論理ホスト上のIMデータベースをセットアップしている

論理ホスト上の統合監視DBが有効，またはIM構成管理サービスを起動する設定にしている

■インテリジェント統合管理データベースサービス，トレンドデータ管理サービスの起動条件

論理ホスト上のインテリジェント統合管理データベースをセットアップしている

このコマンドを実行するためには，JP1/IM - Managerのインストールとセットアップの完了後，jp1cc_setup_clusterおよびjp1cs_setup_clusterを実行する必要があります。また，IMデータベースサービスは，IMデータベースサービスのクラスタシステムをセットアップする必要があります。クラスタシステムのセットアップについては，マニュアル「JP1/Integrated Management 3 - Manager 構築ガイド」の「8.　クラスタシステムでの運用と環境構築（UNIXの場合）」を参照してください。

形式

jco_start.cluster [論理ホスト名]

実行権限

スーパーユーザー権限

格納先ディレクトリ

/etc/opt/jp1cons/

引数

論理ホスト名

クラスタシステムで運用している場合に，このコマンドを実行させたい論理ホスト名を指定します。指定できる文字数は，1〜63バイトです。省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。

注意事項

このコマンドをリモートシェルコマンドで実行する場合，標準入力，標準出力，および標準エラー出力を切断（標準入力，標準出力，標準エラー出力に/dev/nullを割り当てる）しておいてください。JP1/IM - Managerのプロセスの起動が完了しても，リモートシェルコマンドが終了しないおそれがあります。

jco_start.clusterコマンドは，jco_spmd_statusコマンドと同時に実行できません。

戻り値

0

正常終了

1

引数が二つ以上指定されている，イベントサービスが起動していない，またはIMデータベースサービスが起動できない

2

ログディレクトリがない

jco_stop（UNIX限定）

機能

JP1/IM - Managerを自動的に終了するためのスクリプトです。このコマンドの実行には，JP1/IM - Managerのインストールとセットアップの完了後，次に示す操作が必要です。

# cd /etc/opt/jp1cons

# cp -p jco_stop.model jco_stop

この操作によって，システムの終了時にJP1/IM - Managerが自動的に終了します。

ただし，IMデータベースサービスが起動している場合は，JP1/IM - Managerを停止したあとに自動的にIMデータベースサービスが終了します。

インテリジェント統合管理データベースを利用している場合は，JP1/IM - Managerを停止したあと，トレンドデータ管理サービス，インテリジェント統合管理データベースの順序で終了し，最後にIMデータベースサービスを終了します。

JP1/IM - Managerが停止しなかった場合，KAVB8800-Eのメッセージが標準出力に出力されます。

IMデータベースサービスが停止しなかった場合，KAVB8801-Eのメッセージが標準出力に出力されます。

JP1/IM - Managerを手動で停止する場合は，/etc/opt/jp1cons/jco_stop.modelスクリプト，またはこのスクリプトをコピーしたファイルを実行してください。

形式

jco_stop

実行権限

スーパーユーザー権限

格納先ディレクトリ

/etc/opt/jp1cons/

注意事項

環境変数JP1_HOSTNAMEが設定されていない環境でこのコマンドを実行してください。環境変数JP1_HOSTNAMEが設定されている環境でこのコマンドを実行すると，物理ホストではなく環境変数JP1_HOSTNAMEに設定した論理ホストのJP1/IM - Managerを停止しようとします。このコマンドは論理ホストに対応していないため，物理ホストのJP1/IM - Managerを停止する場合は，環境変数JP1_HOSTNAMEを削除してください。

jco_stopコマンドは，jco_spmd_statusコマンドと同時に実行できません。

戻り値

0

正常終了

1

引数が二つ以上指定されている，または停止要求がタイムアウトした

使用例1

JP1/IM - ManagerおよびIMデータベースサービスが起動している場合

入力値

jco_stop

結果

KAVB3674-I Termination processing of JP1_CONS has started.
KAVB3675-I The stop command terminated normally.
KNAN11185-I Processing to stop the IM database service will now start.
KNAN11028-I Please wait.
KNAN11187-I The IM database service stopped normally.
KNAN11186-I Processing to stop the IM database service ended normally.
KNAN11188-I The status of the IM database service will now be confirmed.
KNAN11183-I The IM database service is stopped.
KNAN11189-I The status of the IM database service was successfully confirmed.

使用例2

JP1/IM - Managerが起動している，およびIMデータベースサービスを起動していない場合

入力値

jco_stop

結果

KAVB3674-I Termination processing of JP1_CONS has started.
KAVB3675-I The stop command terminated normally.
KNAN11188-I The status of the IM database service will now be confirmed.
KNAN11183-I The IM database service is stopped.
KNAN11189-I The status of the IM database service was successfully confirmed.

使用例3

JP1/IM - ManagerおよびIMデータベースサービスが起動していない場合

入力値

jco_stop

結果

KAVB3674-I Termination processing of JP1_CONS has started.
KAVB3662-I The process management is not running.
KNAN11188-I The status of the IM database service will now be confirmed.
KNAN11183-I The IM database service is stopped.
KNAN11189-I The status of the IM database service was successfully confirmed.

使用例4

JP1/IM - Managerが起動していない，およびIMデータベースサービスが起動している場合

入力値

jco_stop

結果

KAVB3674-I Termination processing of JP1_CONS has started.
KAVB3662-I The process management is not running.
KNAN11185-I Processing to stop the IM database service will now start.
KNAN11028-I Please wait.
KNAN11187-I The IM database service stopped normally.
KNAN11186-I Processing to stop the IM database service ended normally.
KNAN11188-I The status of the IM database service will now be confirmed.
KNAN11183-I The IM database service is stopped.
KNAN11189-I The status of the IM database service was successfully confirmed.

使用例5

JP1/IM - Managerとインテリジェント統合管理データベースが起動している場合

入力値

jco_stop

結果

KAVB3674-I Termination processing of JP1_CONS has started.
KAVB3675-I The stop command terminated normally
KNAN12063-I Termination processing of Trend Data Management Service has started.
KNAN12067-I Trend Data Management Service stopped normally.
KNAN12065-I Processing to stop Trend Data Management Service ended normally.
KNAN12064-I Termination processing of Intelligent Integrated DB Server has started.
KNAN12068-I Intelligent Integrated DB Server stopped normally.
KNAN12066-I Termination processing of Intelligent Integrated DB Server has started.

jco_stop.cluster（UNIX限定）

機能

クラスタシステムで運用している場合に，論理ホスト上のJP1/IM - Managerを終了します。

JP1/IM - Managerを終了したあと，論理ホスト上のインテリジェント統合管理データベースサービス，トレンドデータ管理サービスが起動している場合は，インテリジェント統合管理データベースサービス，トレンドデータ管理サービスを終了します。さらにIMデータベースサービスが起動している場合は，IMデータベースサービスを終了します。

このコマンドを実行すると，JP1/IM - Managerのプロセス，トレンドデータ管理サービス，インテリジェント統合管理データベースサービス，およびIMデータベースサービスが停止します。このコマンドを実行してもプロセスが停止しなかった場合，jco_killall.clusterコマンドでプロセスを強制終了してください。

このコマンドを実行するためには，JP1/IM - Managerのインストールとセットアップの完了後，jp1cc_setup_clusterおよびjp1cs_setup_clusterを実行する必要があります。

インテリジェント統合管理データベースサービス，トレンドデータ管理サービスを使用する場合は，インテリジェント統合管理データベースをセットアップする必要があります。

IMデータベースサービスを使用する場合は，IMデータベースサービスのクラスタシステムをセットアップする必要があります。クラスタシステムのセットアップについては，マニュアル「JP1/Integrated Management 3 - Manager 構築ガイド」の「8.　クラスタシステムでの運用と環境構築（UNIXの場合）」を参照してください。

形式

jco_stop.cluster [論理ホスト名]

実行権限

スーパーユーザー権限

格納先ディレクトリ

/etc/opt/jp1cons/

引数

論理ホスト名

クラスタシステムで運用している場合に，このコマンドを実行させたい論理ホスト名を指定します。指定できる文字数は，1〜63バイトです。省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。

注意事項

jco_stop.clusterコマンドは，jco_spmd_statusコマンドと同時に実行できません。

戻り値

0

正常終了

1

引数が二つ以上指定されている，または停止要求がタイムアウトした

jcoappexecfcheck（Windows限定）

機能

アプリケーション実行定義ファイルをチェックします。

このコマンドを実行すると，指定されたディレクトリのアプリケーション実行定義ファイルの定義誤りなどがチェックされ，解析結果が標準出力に出力されます。

解析結果は次の形式で出力されます。

アプリケーション実行定義識別子,実行パス[,説明文]

解析結果には，システムで定義するアプリケーション実行定義識別子（セントラルコンソールで使用するデフォルトのWWWブラウザー定義である「"default_browser"」）が含まれます。

形式

jcoappexecfcheck アプリケーション実行定義ディレクトリ名

実行権限

なし

格納先ディレクトリ

Viewパス¥bin¥

引数

アプリケーション実行定義ディレクトリ名

チェックの対象となるアプリケーション実行定義ファイルがあるディレクトリを，絶対パス名，またはカレントディレクトリからの相対パス名で指定します。ファイル名は指定できません。

使用例

次の定義ファイルに対してコマンドを実行した場合の例を示します。

@file type="application-execution-definition", version="0300";
@define-block type="application-execution-def";
id="notepad";
path="C:¥winnt¥system32¥notepad.exe";
@define-block-end;
@define-block type="application-execution-def";
id="dmp";
path="[¥HKEY_LOCAL_MACHINE¥SOFTWARE¥HITACHI¥NETM/DM/P¥0521/A¥PathName¥Path00]¥bin¥DMPSTS.exe";
@define-block-end;

解析結果は次のように出力されます。

"dmp","C:¥NETMDMP¥bin¥DMPSTS.exe"
"notepad","C:¥winnt¥system32¥notepad.exe"
"default_browser","C:¥Program Files¥Netscape¥Communicator¥Program¥netscape.exe"

jcoattrfcheck

機能

イベント拡張属性定義ファイルの記述内容をチェックします。

このコマンドを実行すると，指定されたディレクトリのイベント拡張属性定義ファイルの定義誤りがチェックされ，解析結果が標準出力に出力されます。定義誤りなどのエラー情報は，標準エラー出力に出力されます。

解析結果はCSV形式で出力されます。イベントIDごとに，次の情報を含んだ1行で出力されます。

プラットフォーム,イベントID,言語種別,プロダクト名,属性名,表示名,タイプ

注

「,属性名,表示名,タイプ」部分は，表示されるイベント属性の分だけ繰り返し出力されます。

イベント拡張属性定義ファイル（拡張ファイル）をチェックした場合，一部の項目は出力内容が固定となります。固定となる出力内容を次に示します。

表1‒28　拡張ファイルをチェックした場合の出力内容

項番

項目

出力内容

1

プラットフォーム

"base"

2

イベントID

"DEFAULT"

3

言語種別

extend_attr_ja.confをチェックした場合は，"japanese"

extend_attr_en.confをチェックした場合は，"english"

extend_attr_zh.confをチェックした場合は，"chinese"

4

プロダクト名

"/HITACHI/DEFAULT"

［イベント詳細］画面に出力されるJP1イベントの属性は，このコマンドで出力される解析結果に，基本属性および拡張属性の共通情報が付加されたものになります。

形式

jcoattrfcheck イベント拡張属性定義ディレクトリ名

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：なし

格納先ディレクトリ

Windowsの場合

Consoleパス¥bin¥

UNIXの場合

/opt/jp1cons/bin/

引数

イベント拡張属性定義ディレクトリ名

チェックの対象となる拡張属性定義ファイルがあるディレクトリ名を指定します。ディレクトリ名は，絶対パス名，またはカレントディレクトリからの相対パス名で指定します。

チェックの対象となるファイルは，拡張子が「.conf」で，ファイルタイプが「extended-attributes-definition」でなければなりません。

イベント拡張属性定義ファイル（拡張ファイル）をチェックする場合は，jcoattrfcheckコマンドの引数に指定するディレクトリの下にextendディレクトリを作成して，extendディレクトリの下に拡張ファイルを配置します。extendディレクトリの下にあるファイルは，拡張ファイルとしてチェックされます。

なお，拡張ファイルのチェックでは，JP1/IM - Managerに配置されている標準ファイルと，jcoattrfcheckコマンドの引数に指定したディレクトリに配置されている拡張ファイルを読み込み，指定されている拡張属性が重複しているかチェックします。拡張ファイルをチェックするときに読み込む標準ファイルのパスを次に示します。

Windowsの場合

Consoleパス¥conf¥console¥attribute¥default.conf

UNIXの場合

/etc/opt/jp1cons/conf/console/attribute/default.conf

jcochafmode（UNIX限定）

機能

イベント取得フィルターの位置をイベントコンソールサービスからイベント基盤サービスに変更します。

イベント取得フィルター（互換用）を使用している場合にこのコマンドを実行すると，JP1イベントの監視に加えて，自動アクションやセントラルスコープなどのほかの機能にも有効なフィルターとして動作させることができます。また，フィルター条件を詳細に定義できるようになります。ただし，イベント取得フィルター（互換用）のまま運用したい場合は，フィルター位置の変更は不要です。

なお，07-00以前のイベント取得フィルターで設定した内容，またはイベント取得フィルター（互換用）で設定した内容は，次の表で示すとおりに引き継がれます。運用に合わせて設定内容，条件群名を変更してください。

表1‒29　イベント取得フィルター設定項目の引き継ぎ

jcochafmodeコマンド実行前の設定

jcochafmodeコマンド実行後

設定なし

何も設定のない「既存条件群」に引き継がれる。

イベントIDだけ設定

「既存条件群」に引き継がれる。

重大度だけ設定

「既存条件群」に引き継がれる。

JP1/SESイベントだけ設定

「既存条件群_SES」に引き継がれる。

JP1/SESイベント，イベントIDを設定

JP1/SESイベント，イベントID※の設定が「既存条件群_SES」として引き継がれる。

イベントID※の設定が「既存条件群」として引き継がれる。

重大度，イベントIDを設定

「既存条件群」に引き継がれる。

JP1/SESイベント，重大度を設定

JP1/SESイベントの設定は「既存条件群_SES」として引き継がれる。

重大度の設定は「既存条件群」として引き継がれる。

JP1/SESイベント，重大度，イベントIDを設定

JP1/SESイベント，イベントID※の設定が「既存条件群_SES」として引き継がれる。

重大度，イベントID※の設定が「既存条件群」として引き継がれる。

注※

イベントIDの設定は条件群両方に引き継がれます。

形式

jcochafmode [-h 論理ホスト名]

実行権限

スーパーユーザー権限

格納先ディレクトリ

/opt/jp1cons/bin/

注　このコマンドは，Linux版のJP1/IM - Managerには同梱されていません。

引数

-h 論理ホスト名

イベント取得フィルター（互換用）の論理ホスト名を指定します。このオプションを省略した場合，物理ホストを仮定します。クラスタシステムを使用していない場合には指定は不要です。

注意事項

このコマンドを実行してイベント取得フィルターの位置および定義内容を変更する場合は，イベント取得フィルターを変更する対象ホストのJP1/IM - Managerを必ず停止してください。JP1/IM - Managerを停止していない状態でこのコマンドを実行したときは，エラーとなります。

このコマンドを何度も実行した場合は，すでに変換されているイベント取得フィルターが上書きされ，カスタマイズした条件定義が破棄されます。このコマンドは，イベント取得フィルターを変換するときに1回だけ実行してください。

一度変換したイベント取得フィルターを，バージョンアップ前のイベント取得フィルターまたはイベント取得フィルター（互換用）として（フィルターの位置および定義内容を）元に戻すことはできません。

バージョン07-10以降のイベント取得フィルターは，イベント取得フィルター（互換用）に変換できません。

JP1/IM - Managerを新規にインストールした場合，このコマンドを実行する必要はありません。

このコマンドを実行してイベント取得フィルターの位置をイベント基盤サービスに変更すると，以後そのフィルターは相関イベント発行機能にも適用されるようになります。

戻り値

0

正常終了

1

異常終了

使用例

論理ホストhost01のイベント取得フィルター（互換用）を，イベント基盤サービス上で動作するイベント取得フィルターに変換する。

jcochafmode -h host01

出力例1

イベント取得フィルターを変更する対象ホストのJP1/IM - Managerが停止されている場合

KAVB1005-I コマンド（jcochafmode）を開始しました
KAVB0836-I イベント取得フィルタを互換から通常モードに切り替えました
KAVB1002-I コマンド（jcochafmode）が正常終了しました

出力例2

イベント取得フィルターを変更する対象ホストのJP1/IM - Managerが停止されていない場合

KAVB1005-I コマンド（jcochafmode）を開始しました
KAVB0831-E JP1/IM - Managerが起動しています
KAVB1003-I コマンド（jcochafmode）が異常終了しました

jcochcefmode

機能

JP1/IM - Managerの共通除外条件の動作モードを変更するコマンドです。このコマンドを実行すると，共通除外条件を基本モードから拡張モードに変更したり，拡張モードから基本モードに変更したりできます。拡張モードから基本モードに切り替えた場合，共通除外条件および追加共通除外条件は，基本モードの共通除外条件に引き継がれません。共通除外条件を拡張モードに変更する場合は，JP1/Baseの正規表現が拡張されている必要があります。JP1/Baseの正規表現を拡張するための設定手順については，マニュアル「JP1/Base 運用ガイド」を参照してください。

-mオプションを指定してこのコマンドを実行する場合は，JP1/IM - Managerが停止している必要があります。停止していないときに実行すると，エラー終了し，メッセージが表示されます。

また，このコマンドは複数を同時に実行できません。

なお，共通除外条件がすでに設定されている場合でも共通除外条件を拡張モードに変更できます。

次の場合に共通除外条件拡張定義ファイルのバックアップファイルがcommon_exclude_filter_backup.confとして出力されます。

動作モードを基本モードから拡張モードに変更した場合で正規表現に問題があるとき

動作モードを拡張モードから基本モードに変更した場合

バックアップファイルの出力先を次に示します。

Windowsの場合

物理ホストのとき

Consoleパス¥conf¥console¥filter¥

論理ホストのとき

共有フォルダ¥jp1cons¥conf¥console¥filter¥

UNIXの場合

物理ホストのとき

/etc/opt/jp1cons/conf/console/filter/

論理ホストのとき

共有ディレクトリ/jp1cons/conf/console/filter/

拡張モードで使用できない正規表現があった場合，エラーメッセージが表示され，拡張モードの共通除外条件が設定されていない状態になります。出力されたファイルを編集し直して，jcochfilterコマンドの-efオプションでJP1/IM - Managerに反映してください。

共通除外条件拡張定義ファイルについては，「共通除外条件拡張定義ファイル」（2.　定義ファイル）を参照してください。

jcochfilterコマンドについては，「jcochfilter」（1.　コマンド）を参照してください。

形式

jcochcefmode [-m {normal | extended}]
             [-h 論理ホスト名]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Consoleパス¥bin¥

UNIXの場合

/opt/jp1cons/bin/

引数

-m {normal | extended}

共通除外条件の動作モードを指定します。

normal：共通除外条件の動作モードを基本モードにしたい場合に指定します。デフォルトは，normalです。

動作モードを拡張モードから基本モードに戻した場合は，基本モードの共通除外条件の定義は空になります。拡張モードで使用していた共通除外条件の定義はバックアップファイルとして保存されます。また，追加共通除外条件の定義はすべて削除されます。バックアップファイルについては，「機能」を参照してください。

extended：共通除外条件の動作モードを拡張モードにしたい場合に指定します。基本モードで使用していた共通除外条件の定義は，拡張モードの共通除外条件の定義に引き継がれます。なお，共通除外条件を拡張モードに変更する場合は，JP1/Baseの正規表現が拡張されている必要があり，JP1/Baseの正規表現を拡張するとJP1/Baseの正規表現を使用する機能に影響があります。JP1/Baseの正規表現の拡張については，マニュアル「JP1/Base 運用ガイド」を参照してください。

normalまたはextendedは大文字・小文字を区別しません。

-h 論理ホスト名

クラスタシステムで運用している場合に，論理ホスト名を指定します。指定した論理ホストに対応する動作モードを，JP1/IM - Managerの共通除外条件に設定します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。クラスタシステムを使用していない場合には指定は不要です。

環境変数JP1_HOSTNAMEにJP1_DEFAULTや存在しない論理ホストを設定した場合，エラーメッセージが表示されます。

注意事項

-mオプションを指定しなかった場合，共通除外条件の動作モードを表示します。

次のどちらかまたは両方の状態の場合，拡張モードを使用できません。

イベント取得フィルター（互換用）を使用している

マネージャーホストのJP1/Baseで，拡張正規表現を使用していない

-hオプションを使用して論理ホストの共通除外条件の動作モードを変更する場合，共有ディスクがマウントされている必要があります。

クラスタシステムで運用している場合は，実行系サーバから待機系サーバに共通定義情報をコピーする必要があります。

手順については，マニュアル「JP1/Integrated Management 3 - Manager 構築ガイド」の「7.8.2　コマンドでの設定変更（Windowsの場合）」または「8.8.2　コマンドでの設定変更（UNIXの場合）」を参照してください。

jcochcefmodeコマンドは，jco_spmd_statusコマンドと同時に実行できません。

戻り値

0

正常終了

1

異常終了

2

引数エラー

3

JP1/IM - Managerが起動している

4

拡張モードの前提条件を満たしていない，またはイベント取得フィルターが互換用で動作している

5

拡張モードの前提条件を満たしていない，またはJP1/Baseの正規表現が拡張されていない

6

現在の動作モードと同じ動作モードを指定している

7

jcochcefmodeコマンドの実行権限がない（Windows限定）

8

共通除外条件拡張定義ファイルのバックアップに失敗した

9

論理ホストの指定が不正である

10

同時実行エラー

255

その他のエラー

使用例1

動作モードを基本モードに変更する場合

入力値

jcochcefmode -m normal

結果

KAVB1005-I コマンド（jcochcefmode）を開始しました
KAVB0895-I 共通除外条件の動作モードを基本モードに変更しました
KAVB1002-I コマンド（jcochcefmode）が正常終了しました

使用例2

動作モードを拡張モードに変更する場合

入力値

jcochcefmode -m extended

結果

KAVB1005-I コマンド（jcochcefmode）を開始しました
KAVB0896-I 共通除外条件の動作モードを拡張モードに変更しました
KAVB1002-I コマンド（jcochcefmode）が正常終了しました

使用例3

共通除外条件の動作モードを確認する場合（この例の場合，物理または論理ホストのホスト名はhostA，動作モードは拡張である）

入力値

jcochcefmode

結果

KAVB1005-I コマンド（jcochcefmode）を開始しました
KAVB0894-I 共通除外条件の動作モードを表示します(ホスト名:hostA)
動作モード            : 拡張モード
KAVB1002-I コマンド（jcochcefmode）が正常終了しました

jcochfilter

機能

JP1/IM - Managerのイベント基盤サービス，および相関イベント発行機能で有効となっているイベント取得フィルターを，指定したフィルターIDのイベント取得フィルターに切り替えるためのコマンドです。また，指定した共通除外条件を有効または無効にすることもできます。

イベント取得フィルターのフィルターID，フィルター名，共通除外条件群の共通除外条件群ID，および共通除外条件群名を一覧で表示することもできます。

指定したホストのJP1/IM - Managerが起動していない場合，およびイベント取得フィルター（互換用）の場合は使用できません。

また，共通除外条件が拡張モードの場合に，次の操作を実行できます。

拡張モードの共通除外条件を，条件群単位で有効・無効に設定できる

共通除外条件定義ファイルを読み込み，拡張モードの共通除外条件の定義を一括で反映できる

共通除外条件定義ファイルを読み込み，拡張モードの共通除外条件の定義内容をチェックできる

定義した追加共通除外条件群を，条件群単位で有効・無効に設定できる

形式1

jcochfilter [-i フィルターID]
            [-e [共通除外条件群ID[,共通除外条件群ID...]|ALL]]
            [-on 共通除外条件群ID[,共通除外条件群ID...]]※
            [-off 共通除外条件群ID[,共通除外条件群ID...]]※
            [-ef 共通除外条件拡張定義ファイル名]※
            [-h 論理ホスト名]

注※　拡張モードの共通除外条件の場合に指定できます。

形式2

jcochfilter -check 共通除外条件拡張定義ファイル名

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Consoleパス¥bin¥

UNIXの場合

/opt/jp1cons/bin/

引数

-i フィルターID

切り替えて使用するイベント取得フィルターのフィルターIDを指定します。

このオプションは，-efおよび-checkオプションと同時に指定できません。

-e [共通除外条件群ID,共通除外条件群ID...]|ALL

有効にしたい共通除外条件群のIDを指定します。指定しなかったIDの共通除外条件は無効になります。共通除外条件が拡張モードの場合，追加共通除外条件群IDを指定できます。複数指定する場合は，コンマで区切ります。すべての共通除外条件を有効にしたい場合は，ALLを指定します。

共通除外条件群IDには次の値が指定できます。

基本モードの場合：0〜29

拡張モードの場合：0〜2,499

なお，-eのあとに何も指定しなかった場合は，すべての共通除外条件が無効になります。追加共通除外条件群IDの場合は，Aを付けた数値を指定します。

このオプションと同時に指定できるのは，-iおよび-hオプションだけです。

-on 共通除外条件群ID[,共通除外条件群ID...]

有効にしたい拡張モードの共通除外条件のIDまたは追加共通除外条件のIDを指定します。このオプションは，共通除外条件が拡張モードの場合に設定できます。拡張モードの共通除外条件のIDを複数指定する場合は，コンマで区切ります。共通除外条件群IDには次の値が指定できます。

基本モードの場合：0〜29

拡張モードの場合：0〜2,499

追加共通除外条件群IDの場合は，Aを付けた数値を指定します。

このオプションは，-e，-ef，および-checkオプションと同時に指定できません。

-off 共通除外条件群ID[,共通除外条件群ID...]

無効にしたい拡張モードの共通除外条件のIDまたは追加共通除外条件のIDを指定します。このオプションは，共通除外条件が拡張モードの場合に設定できます。拡張モードの共通除外条件のIDを複数指定する場合は，コンマで区切ります。共通除外条件群IDには次の値が指定できます。

基本モードの場合：0〜29

拡張モードの場合：0〜2,499

追加共通除外条件群IDの場合は，Aを付けた数値を指定します。

このオプションは，-e，-ef，および-checkオプションと同時に指定できません。

-ef 共通除外条件拡張定義ファイル名

JP1/IM - Managerに反映したい共通除外条件拡張定義ファイル名を，相対パスまたは絶対パス形式で指定します。このオプションは，共通除外条件が拡張モードの場合に設定できます。

このオプションを指定すると，共通除外条件拡張定義ファイルに記載されている拡張モードの共通除外条件の定義内容をJP1/IM - Managerに一括で反映できます※。

追加共通除外条件群が設定されている場合，すべて削除されます。このオプションと同時に指定できるのは，-hオプションだけです。

注※　定義内容に環境依存文字など文字化けする文字が含まれている場合は反映できません。

-check 共通除外条件拡張定義ファイル名

定義内容に環境依存文字など文字化けする文字が含まれているかも含めて，共通除外条件拡張定義ファイルに記載されている拡張モードの共通除外条件の定義内容が正しいかどうかをチェックするオプションです。

JP1/IM - Managerに反映したい共通除外条件拡張定義ファイル名を，相対パスまたは絶対パス形式で指定します。このオプションは，ほかのオプションと同時に指定できません。

-h 論理ホスト名

クラスタシステムで運用している場合に，論理ホスト名を指定します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。クラスタシステムを使用していない場合には指定は不要です。このオプションは，-checkオプションと同時に指定できません。

注意事項

-h以外のオプションを指定しなかった場合，次の内容を一覧で表示します。

適用中のイベント取得フィルターのフィルターIDとフィルター名

適用中の共通除外条件群IDと共通除外条件群名

設定されているイベント取得フィルターのフィルターIDとフィルター名

設定されている共通除外条件群IDと共通除外条件群名

共通除外条件の動作モードが拡張モードの場合，拡張モードの共通除外条件のIDと共通除外条件群名

指定したホストのJP1/IM - Managerが起動していない場合，およびイベント取得フィルターが互換用の場合は，jcochfilterコマンドは実行できません。

jcochfilterコマンドを同時に実行した場合，タイミングによってエラーとなることがあります。

jcochfilterコマンドを大量に同時実行すると，マネージャーの性能が低下したり，タイムアウトが発生したりすることがあります。

jcochfilterコマンドは，jco_spmd_statusコマンドと同時に実行できません。

戻り値

0

正常終了

1

引数エラー

2

JP1/IM - Manager（セントラルコンソール）と接続できない（通信エラー）

3

JP1/IM - Managerの起動状態が確認できない

4

一定時間内にJP1/IM - Managerからの応答がない

5

イベント取得フィルターが互換用で動作している

6

JP1/IM - Managerからのエラー

7

-iオプションで指定したフィルターIDが存在しない

8

jcochfilterコマンドの実行権限がない（Windows限定）

9

イベント取得フィルターの最大長を超えている

10

-eオプションで指定した共通除外条件が存在しない

11

-onオプション，または-offオプションで指定した共通除外条件群（拡張）が存在しない

12

共通除外条件群（拡張）が使用できない（設定が拡張モードではない）

13

共通除外条件群（拡張）の定義反映に失敗した

14

共通除外条件群（拡張）の定義内容に誤りがある

255

その他のエラー

使用例1

論理ホストhostA上のイベント取得フィルターの一覧を表示する場合

jcochfilter -h hostA

使用例2

論理ホストhostA上のイベント取得フィルターをフィルターIDが3のフィルターに変更する場合

jcochfilter -i 3 -h hostA

使用例3

論理ホストhostA上のイベント取得フィルターの共通除外条件群（ID：0，2）を有効にし，それ以外を無効にする場合

jcochfilter -e 0,2 -h hostA

jcochstat

機能

重要イベントの対処状況を示す情報を変更します。

このコマンドは，-hで指定したホストのイベントDBにアクセスし，-nで指定した通し番号のJP1イベントの重要イベント対処状況を変更します。

対処状況を変更すると，同じマネージャーにログインしているほかのJP1/IM - Viewでも対処状況の表示が変更されます。対処状況を変更するJP1イベントがほかのホストから転送されてきた場合やほかのホストに転送する設定がされている場合，転送元および転送先のホストでの対処状況は変更されません。

なお，このコマンドを使えば，［イベントコンソール］画面の［重要イベント］ページに表示されていないJP1イベントの対処状況も変更できますが，この場合，その変更を確認するには次の方法を取る必要があります。

対処状況を変更したJP1イベントが［イベントコンソール］画面の［イベント監視］ページに表示されている場合：［イベント監視］ページで確認する。

対処状況を変更したJP1イベントが［イベントコンソール］画面の［イベント監視］ページに表示されていない場合：イベント検索で確認する。

このコマンドは，JP1/IM - Managerが稼働する環境で使用できます。

形式

jcochstat [-h マネージャーホスト名]
          {-k 重要イベント対処状況キー | -d |
           -k 重要イベント対処状況キー -d}
           -n イベントDB内通し番号1[,...,イベントDB内通し番号100]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：なし

格納先ディレクトリ

Windowsの場合

Consoleパス¥bin¥

UNIXの場合

/opt/jp1cons/bin/

引数

-h マネージャーホスト名

重要イベントが登録されているイベントDBがあるマネージャーを指定します。ホスト名，ドメイン名，およびIPv4アドレスを指定できます。このオプションを省略した場合は，自ホストを仮定します。クラスタシステムでの運用時に，このオプションを省略した場合は，コマンドを実行した物理ホスト名を仮定します。指定したマネージャー上のJP1/IM - Managerが起動していないと，エラーになります。

マネージャーホスト名は255文字以内の文字列で指定してください。

なお，マネージャーホスト名に他ホストのマネージャーを指定する機能は，バージョン6互換用です。

-k 重要イベント対処状況キー

重要イベントの対処状況を表すキー値を入力します。-nオプションで指定した重要イベントの対処状況が，指定したキーが示す対処状況に変更されます。また，JP1/IM - Viewで表示した場合，対処状況マークが変更されます。

重要イベント対処状況キーは大文字と小文字を区別します。

-kオプションと-dオプションは，どちらか一方または両方を指定してください。-kオプションと-dオプションを両方指定した場合は，対処状況を変更したあと，JP1/IM - Viewの画面からイベントを削除します。-kオプションと-dオプションは同時に省略できません。

表1‒30　重要イベント対処状況キー

キー値

対処状況

JP1/IM - Viewに表示される対処状況マーク

PROCESSED

対処済

PROCESSING

処理中

HELD

保留

UNPROCESSED

未対処

（無印）

-d

-nオプションで指定した重要イベントを［イベントコンソール］画面の［重要イベント］ページから削除します。イベントDBからは削除されません。

削除したイベントを［重要イベント］ページに再度表示することはできません。

-kオプションと-dオプションは，どちらか一方または両方を指定してください。

-kオプションと-dオプションを両方指定した場合は，対処状況を変更したあと，［イベントコンソール］画面の［重要イベント］ページからイベントを削除します。-kオプションと-dオプションは同時に省略できません。

-n イベントDB内通し番号

対処状況を変更したい重要イベントのイベントDB内通し番号を指定します。このオプションは省略できません。

イベントDB内通し番号は，最大100個指定できます。複数指定する場合は，通し番号と通し番号の間をコンマで区切ります。コンマの前後に空白を指定できません。

指定できる値は，0〜2,147,483,647の10進数整数です。

注意事項

jcochstatコマンドを大量に同時実行すると，マネージャーの性能が低下したり，タイムアウトが発生したりすることがあります。

例えば，自動アクションからjcochstatコマンドを実行すると，jcochstatコマンドの処理に時間がかかった場合に，自動アクションの処理が遅延したり，自動アクションを実行できなくなったりすることがあるため，自動アクションなどからjcochstatコマンドを実行することは推奨しません。jcochstatコマンドの実行を運用に組み込む場合は，jcochstatコマンドの実行性能とマネージャーの性能への影響が，運用要件上問題ないかを十分に検証した上で使用してください。

戻り値

0

正常終了

1

引数エラー

2

ネットワーク障害

3

イベントDBの更新に失敗した

4

指定できないキーを指定している

5

更新できないイベントを指定した

7

コマンドを実行する権限がない（Windowsの場合）

255

その他のエラー

使用例

マネージャーhost01上のイベントDBに登録されている，イベントDB内通し番号が35のイベントおよび400のイベントを，対処状況を対処済に変更したあと，画面から削除します。

jcochstat -h host01 -k PROCESSED -n 35,400 -d

jcodbsetup

機能

JP1イベントを格納する統合監視DB領域を作成するセットアップコマンドです。データベースのサイズ，ポート番号，およびデータベース格納先は，セットアップ情報ファイルに指定しておく必要があります。

Windowsの場合，IM構成管理DBがセットアップされていない環境でこのコマンドを実行すると，次のサービスがOSに登録されます。

物理ホストのセットアップ時：JP1/IM-Manager DB Server，JP1/IM-Manager DB Cluster Service

クラスタ構成のセットアップ時：JP1/IM-Manager DB Server_論理ホスト名，JP1/IM-Manager DB Cluster Service_論理ホスト名

UNIXの場合，IM構成管理DBがセットアップされていない環境でこのコマンドを実行すると，/etc/inittabファイルに，IMデータベースのパスを含むエントリーが追加されます。エントリーは，コマンドを実行した物理ホスト，および論理ホストごとに追加されます。このコマンドを実行したときに追加された/etc/inittabファイルのエントリーを，削除，編集，またはコメントアウトしないでください。

形式

jcodbsetup  {-f セットアップ情報ファイル名|-s}
            [-h 論理ホスト名 -c {online|standby}]
            [-q]
            [-v 0]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Consoleパス¥bin¥

UNIXの場合

/opt/jp1cons/bin/

引数

-f セットアップ情報ファイル名

IMデータベースのインストール先フォルダや，データベース領域のサイズを記述したセットアップ情報ファイルを指定します。IM構成管理DBと統合監視DBがどちらもセットアップされていない場合は，必ずこのオプションを指定してください。IM構成管理DBがすでにセットアップ済みの場合にこのオプションを指定するときには，IM構成管理DBのセットアップ時に指定したセットアップ情報ファイルと同じファイルを指定してください。また，IM構成管理DBがすでにセットアップ済みの場合は，-sオプションを代わりに指定できます。その際，IM構成管理DBのセットアップ時に指定したセットアップ情報が用いられます。

-sオプションと同時に指定できません。また，-fオプションと-sオプションは同時に省略できません。

パスに空白を含む場合は，「"」で囲みます。クラスタ環境を構築する場合は，クラスタセットアップ情報ファイル名を指定してください。

-s

IM構成管理DBがセットアップされている場合は，-fオプションの代わりに指定できます。このオプションを指定した場合は，IM構成管理DBのセットアップ時に指定されたセットアップ情報の内容を参照して，統合監視DBをセットアップします。

IM構成管理DBがセットアップされていない場合，このオプションを指定すると，KNAN11193-Eメッセージが出力されます。

-fオプションと同時に指定できません。また，-sオプションと-fオプションは同時に省略できません。

-h 論理ホスト名

クラスタシステムで運用している場合に，コマンドを実行するホストの論理ホスト名を指定します。指定した論理ホストに対応する統合監視DBをセットアップします。クラスタシステムを使用していない場合には指定は不要です。なお，論理ホスト名にJP1_DEFAULTは指定できません。また，論理ホスト名は，大文字・小文字を区別します。論理ホスト名には，JP1/Baseで設定した論理ホスト名を，大文字・小文字を含めて正確に指定してください。

-c {online|standby}

クラスタ構成の実行系および待機系のセットアップ種別を指定します。-hオプションを指定した場合は，必ずこのオプションを指定してください。

すでに同一ホストにIM構成管理DBをセットアップしている場合は，-cオプションにIM構成管理DBを作成したときと同じ値を指定してください。また，非クラスタ環境で，論理ホスト運用をする場合はonlineを指定してください。

online：実行系をセットアップする場合に指定します。

standby：待機系をセットアップする場合に指定します。

onlineを指定する場合は，共有ディスクをマウントし，論理ホストと通信できる状態にしてください。

-q

ユーザー確認を省略してコマンドを実行する場合に指定します。

-v 0

JP1/IM - Manager 09-00〜10-50のテーブルスキーマでバックアップした拡張用バックアップをリカバリーする場合に指定します。JP1/IM - Manager 11-00では，拡張用バックアップのバージョンとして，0を指定できます。

0を指定した場合，JP1/IM - Manager 09-00〜10-50と同じテーブルスキーマの統合監視DBをセットアップします。

-vオプションの指定を省略した場合，JP1/IM - Manager 11-00以降のテーブルスキーマで統合監視DBをセットアップします。

-cオプションにstandbyを指定している場合，-vオプションの指定は無視されます。

戻り値

0

正常終了

1

異常終了

注意事項

実行系と待機系のクラスタセットアップ情報ファイルの内容は同じにする必要があります。待機系をセットアップする場合，実行系で使用したクラスタセットアップ情報ファイルをコピーして使用してください。実行系と待機系で指定したファイル内容が異なっていた場合，待機系でアンセットアップしたあとに，クラスタセットアップ情報ファイルを実行系からコピーし，コマンドを再実行します。

-cオプションを指定してコマンドを実行する場合は，実行途中でサーバを切り替えないでください。実行中にサーバを切り替えた場合は，コマンド終了後に一度アンセットアップしてから，コマンドを再実行してください。

コマンド実行中に［Ctrl］+［C］キーや［Ctrl］+［Break］キーで処理を中止した場合，pdistup，pdfmkfs，pddef，およびpdloadのプロセスが実行されていないことを確認し，jcodbunsetupコマンドを実行してからこのコマンドを再実行してください。

IM構成管理DBをセットアップ済みの場合，かつIMデータベースを使用している場合，JP1/IM-Managerサービスが停止している必要があります。

WindowsでIM構成管理DBを使用している場合，IMデータベースサービス（JP1/IM3-Manager DB Server）が起動している必要があります。また，IMデータベースのクラスタサービス（JP1/IM3-Manager DB Cluster Service）が停止している必要があります。

JP1/IM - MOを使用している場合は，接続元のJP1/IM - MOのJP1/IM - Message Optimizerサービスが停止している必要があります。

引数に指定する論理ホスト名とJP1/Baseの論理ホスト名が一致し，かつ論理ホスト名の名前解決ができることを確認してからコマンドを実行してください。

jcodbunsetup，またはjcfdbunsetupコマンドを実行してIMデータベースをアンセットアップした場合にjcodbsetupコマンドを実行するときは，jcodbsetupコマンドを実行する前にOSを再起動してください。

Windowsの場合，Application Experienceサービスが存在する場合は，Application Experienceサービスのスタートアップの種類が無効になっていないことを確認してからコマンドを実行してください。

jcodbunsetup

機能

JP1イベントを格納する統合監視DBをアンセットアップするコマンドです。

このコマンドは，統合監視DBの使用を停止する場合，JP1/IM - Managerをアンインストールする場合，統合監視DBを再作成する場合，およびデータベースサイズを拡張する場合に実行します。IM構成管理DBをセットアップしている環境では，このコマンドを実行後もIM構成管理は使用できます。

Windowsの場合，IM構成管理DBがセットアップされていない環境でこのコマンドを実行すると，次のサービスが削除されます。

物理ホストのアンセットアップ時：JP1/IM-Manager DB Server，JP1/IM-Manager DB Cluster Service

クラスタ構成のアンセットアップ時：JP1/IM-Manager DB Server_論理ホスト名，JP1/IM-Manager DB Cluster Service_論理ホスト名

UNIXの場合，IM構成管理DBがセットアップされていない環境でこのコマンドを実行すると，jcodbsetupまたはjcfdbsetupコマンドが登録した，/etc/inittabファイルのエントリーが削除されます。エントリーは，コマンドを実行した物理ホスト，および論理ホストに対応した処理だけ削除されます。

形式

jcodbunsetup [-h 論理ホスト名 -c {online|standby}]
             [-q]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Consoleパス¥bin¥

UNIXの場合

/opt/jp1cons/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，コマンドを実行するホストの論理ホスト名を指定します。指定した論理ホストに対応する統合監視DBがアンセットアップされます。クラスタシステムを使用していない場合には指定は不要です。なお，論理ホスト名にJP1_DEFAULTは指定できません。また，論理ホスト名は，大文字・小文字を区別します。論理ホスト名には，JP1/Baseで設定した論理ホスト名を，大文字・小文字を含めて正確に指定してください。

-c {online|standby}

クラスタ構成の実行系および待機系のアンセットアップ種別を指定します。-hオプションを指定した場合は，必ずこのオプションを指定してください。

online：統合監視DBのセットアップでonlineを指定した場合に指定します。

standby：統合監視DBのセットアップでstandbyを指定した場合に指定します。

onlineを指定する場合は，共有ディスクをマウントし，論理ホストと通信できる状態にしてください。また，非クラスタ環境で，運用していた論理ホストの統合監視DBをアンセットアップする場合はonlineを指定してください。

-q

ユーザー確認を省略してコマンドを実行する場合に指定します。

戻り値

0

正常終了

1

異常終了

注意事項

IM構成管理DBを作成している環境で，データベースのサイズを拡張する場合は，このコマンドを実行後に，IM構成管理DBのアンセットアップコマンドを実行する必要があります。

-cオプションを指定してコマンドを実行する場合は，実行途中でサーバを切り替えないでください。実行中にサーバを切り替えた場合は，コマンド終了後にコマンドを再実行してください。

コマンド実行中に［Ctrl］+［C］キーや［Ctrl］+［Break］キーで処理を中止した場合，pdirstプロセスが実行されていないことを確認してからこのコマンドを再実行してください。

Windowsの場合，サービスが次の状態である必要があります。

物理ホストの場合

IMデータベースのクラスタサービス（JP1/IM3-Manager DB Cluster Service）が停止していて，IMデータベースサービス（JP1/IM3-Manager DB Server）が開始している必要があります。また，IM構成管理DBがセットアップ済み，かつIMデータベースを使用している場合，JP1/IM - Managerのサービス（JP1/IM3-Manager）が停止している必要があります。

論理ホストの場合

論理ホストのIMデータベースのクラスタサービス（JP1/IM3-Manager DB Cluster Service_論理ホスト名）が停止していて，論理ホストのIMデータベースサービス（JP1/IM3-Manager DB Server_論理ホスト名）が開始している必要があります。また，IM構成管理DBがセットアップ済み，かつIMデータベースを使用している場合，JP1/IM - Managerのサービス（JP1/IM3-Manager_論理ホスト名）が停止している必要があります。

UNIXの場合，IM構成管理DBがセットアップ済み，かつIMデータベースを使用しているとき，JP1/IM-Managerサービスが停止している必要があります。

JP1/IM - MOを使用している場合は，接続元のJP1/IM - MOのJP1/IM - Message Optimizerサービスが停止している必要があります。

Windowsの場合，Application Experienceサービスが存在する場合は，Application Experienceサービスのスタートアップの種類が無効になっていないことを確認してからコマンドを実行してください。

jcoegschange

機能

相関イベント発行定義を変更するコマンドです。相関イベント発行機能の状態が停止，相関稼働，および機能停止のどの状態のときでも実行できます。なお，起動処理中および停止処理中は実行できません。

jcoegschangeコマンドを実行する場合の注意事項を次に示します。

jcoegschangeコマンドで相関イベント発行定義を変更すると，即時に変更後の定義が有効になります。定義が有効になった時点で，相関イベントの発行処理中のJP1イベントがあった場合，すべて不成立となります。

jcoegschangeコマンド実行時，相関イベント発行定義ファイルに条件が1件も定義されていなかった場合，相関イベント発行条件がない状態で動作します。つまり，相関イベントは発行されません。

相関イベント発行機能が相関稼働状態の場合，jcoegschangeコマンドで変更しようとした相関イベント発行定義に不正があると，定義が変更されずに処理が続行されます。

相関イベント発行機能が起動していない場合は，相関イベント発行定義の設定だけが行われます。相関イベント発行機能を起動すると，相関イベント発行定義の設定が有効になります。

jcoegschangeコマンドは，jcoegsstatusコマンド（-dオプション指定）と同時に実行できません。

形式

jcoegschange [-h 論理ホスト名]
             -f 相関イベント発行定義ファイル名

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Consoleパス¥bin¥

UNIXの場合

/opt/jp1cons/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，論理ホスト名を指定します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。クラスタシステムを使用していない場合には指定は不要です。

-f 相関イベント発行定義ファイル名

相関イベント発行定義ファイル名を，相対パスまたは絶対パス形式で指定します。

注意事項

このコマンドは実行系ホストでだけ実行してください。コマンドの実行時は共有ディスクをマウントした状態で実行してください。

このコマンドは待機系ホストでは実行しないでください。

UNIX/Linux環境の待機系ホストで実行した場合，待機系ホストのローカルディスクのルート直下に「/共有ディレクトリ名」という不要なディレクトリが作成され，その配下にも次の不要なディレクトリとファイルが作成されます。

/共有ディレクトリ名/jp1cons

/共有ディレクトリ名/jp1cons/conf

/共有ディレクトリ名/jp1cons/conf/evgen

/共有ディレクトリ名/jp1cons/conf/evgen/system

上記のローカルディスクにあるルート直下の「/共有ディレクトリ名」およびそのディレクトリ配下のファイルは不要であるため削除してください。削除する際は誤って共有ディスク上のディレクトリおよびファイルを削除しないように，必ず待機系ホスト上で共有ディスクがマウントされていないことを確認して実施してください。

戻り値

0

相関イベント発行定義の変更に成功した

1

相関イベント発行定義の変更に失敗した

2

相関イベント発行サービス（統合監視DBを使用しない場合），またはイベント基盤サービス（統合監視DBを使用する場合）との通信がタイムアウトした

100

実行権限エラー（Windows限定）

101

引数エラー

102

通信エラー

255

その他の異常終了（システムエラー）

使用例

物理ホスト（hostP）の相関イベント発行定義を，相関イベント発行定義ファイル（/tmp/teigi1.conf）に定義した内容に変更する場合

入力値

jcoegschange -f /tmp/teigi1.conf

結果

KAJV3201-I 相関イベント発行定義ファイル（/tmp/teigi1.conf）を読み込み，hostPの相関イベント発行機能に反映しました

相関イベント発行機能に対して，相関イベント発行定義が1件も設定されていない場合でも同様の出力結果になります。

jcoegscheck

機能

相関イベント発行定義ファイルの定義内容をチェックするコマンドです。

相関イベント発行定義ファイル内の定義不正や，冗長な定義内容をチェックアウトします。

形式

jcoegscheck -f 相関イベント発行定義ファイル名

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Consoleパス¥bin¥

UNIXの場合

/opt/jp1cons/bin/

引数

-f 相関イベント発行定義ファイル名

相関イベント発行定義ファイル名を，相対パスまたは絶対パス形式で指定します。

戻り値

0

相関イベント発行定義ファイルの定義内容が正常だった

1

相関イベント発行定義ファイルの定義内容が不正だった

100

実行権限がない（Windows限定）

rootに対してだけ実行権限を与える（UNIX限定）

101

引数エラー

255

その他の異常終了（システムエラー）

使用例

物理ホスト（hostP）で相関イベント発行定義ファイル（/tmp/teigi1.conf）の定義内容をチェックする場合

入力値

jcoegscheck -f /tmp/teigi1.conf

結果（定義内容が正常だった場合）

KAJV3311-I 相関イベント発行定義ファイル（/tmp/teigi1.conf）の内容をチェックします
KAJV3312-I 相関イベント発行定義ファイル（/tmp/teigi1.conf）の内容に誤りは見つかりませんでした

結果（定義内容に不正があった場合）

KAJV3311-I 相関イベント発行定義ファイル（/tmp/teigi1.conf）の内容をチェックします
KAJV3313-E 相関イベント発行定義に不正な定義があります
KAJV3314-E 相関イベント発行定義ファイル（/tmp/teigi1.conf）の記載内容に間違いがあります。行番号:5 不正内容:相関イベント発行条件名が指定されていません
KAJV3314-E 相関イベント発行定義ファイル（/tmp/teigi1.conf）の記載内容に間違いがあります。行番号:25 不正内容:1つの相関イベント発行条件に指定されているイベント条件数が最大数を超えています

jcoegsstart

機能

相関イベント発行機能の状態を，機能停止から相関稼働に移行します。相関イベント発行機能は相関稼働状態になると，相関イベント発行定義に従って処理を開始します。

jcoegsstartコマンドは，相関イベント発行機能の状態をjcoegsstopコマンドで機能停止にしたあとにだけ使用します。停止している相関イベント発行機能の起動はできません（サービスの起動および停止は，プロセス管理(jco_spmd)によって制御されます）。

jcoegsstartコマンドで状態の移行に成功すると，JP1イベント（00003F25）が発行されます。JP1イベント（00003F25）については，「3.2.2　JP1/IM - Managerが出力するJP1イベントの詳細」を参照してください。

jcoegsstartコマンドの実行時に相関イベント発行機能が相関稼働状態だった場合，状態は変更されません。

形式

jcoegsstart [-h 論理ホスト名]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Consoleパス¥bin¥

UNIXの場合

/opt/jp1cons/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，論理ホスト名を指定します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。クラスタシステムを使用していない場合には指定は不要です。

戻り値

0

相関イベント発行機能の再開に成功した

1

相関イベント発行機能の再開に失敗した

2

相関イベント発行機能との通信がタイムアウトした

100

実行権限がない（Windows限定）

UNIXの場合は，rootに対してだけ実行権限を与える

101

引数エラー

102

通信エラー

255

その他の異常終了（システムエラー）

使用例

物理ホスト（hostP）の相関イベント発行機能を再開する場合

入力値

jcoegsstart

結果

KAJV3291-I hostPの相関イベント発行機能を再開しました

jcoegsstatus

機能

相関イベント発行機能の状態，および起動オプションを表示するコマンドです。オプションの指定によって，現在使用している相関イベント発行定義，および相関イベント発行定義を反映した日時を表示することもできます。

形式

jcoegsstatus [-h 論理ホスト名]
             [-d]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：なし

格納先ディレクトリ

Windowsの場合

Consoleパス¥bin¥

UNIXの場合

/opt/jp1cons/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，論理ホスト名を指定します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。クラスタシステムを使用していない場合には指定は不要です。

-d

-dオプションを指定すると相関イベント発行機能の状態，および起動オプションに加えて，現在使用している相関イベント発行定義，およびjcoegsstatusコマンドでの相関イベント発行定義の反映日時を表示します。

-dオプションを指定したjcoegsstatusコマンドはjcoegschangeコマンドと同時に実行できません。

出力形式

WindowsおよびUNIX（環境変数LANGがC以外）の場合

jcoegsstatusコマンドを実行すると，相関イベント発行機能の状態は次の形式で表示されます。

KAJV3261-I hostPの相関イベント発行サービスの状態を表示します

相関イベント発行機能 : 状態

起動オプション : 起動オプション

-dオプションを指定した場合は次の形式で表示されます。

KAJV3261-I hostPの相関イベント発行サービスの状態を表示します

相関イベント発行機能 : 状態

起動オプション : 起動オプション

KAJV3281-I hostPの相関イベント発行定義を表示します

ファイル名 : ファイルの絶対パス

反映日時 : YYYY/MM/DD hh:mm:ss

VERSION=0002

# コメント

[発行条件名]

TARGET=相関の対象範囲の絞り込み条件

CON=イベント条件

SAME_ATTRIBUTE=同一属性値条件

CORRELATION_NUM=同時相関数

TIMEOUT=タイムアウト時間

TYPE=イベント相関タイプ

SUCCESS_EVENT=相関イベント情報

UNIX（環境変数LANGがC）の場合

jcoegsstatusコマンドを実行すると，相関イベント発行機能の状態は次の形式で表示されます。

KAJV3261-I The status of the correlation event generation service for ホスト名 will now be displayed.

Correlation event generation function : 状態

Start option : 起動オプション

-dオプションを指定した場合は次の形式で表示されます。

KAJV3261-I The status of the correlation event generation service for ホスト名 will now be displayed.

Correlation event generation function : 状態

Start option : 起動オプション

KAJV3281-I The correlation event generation definition for ホスト名 will now be displayed.

File name : ファイルの絶対パス

Reflection time : YYYY/MM/DD hh:mm:ss

VERSION=0002

# コメント

[発行条件名]

TARGET=相関の対象範囲の絞り込み条件

CON=イベント条件

SAME_ATTRIBUTE=同一属性値条件

CORRELATION_NUM=同時相関数

TIMEOUT=タイムアウト時間

TYPE=イベント相関タイプ

SUCCESS_EVENT=相関イベント情報

状態に表示される文字列について次に説明します。

表1‒31　状態に表示される文字列

状態に表示される文字列

動作状態

説明

STARTING

起動処理中

相関イベント発行機能が起動処理を実行している状態。

RUNNING

相関稼働

相関イベント発行機能が起動していて，相関イベントの発行処理ができる状態。

次の場合にこの状態となる。

相関イベント発行機能が起動した場合。

相関イベント発行機能の状態が機能停止で，jcoegsstartコマンドを実行した場合。

STANDBY

機能停止

相関イベント発行機能は起動しているが，相関イベントの発行処理が停止している状態。

機能停止中に発生したJP1イベントに対して相関イベントの発行処理はしない。

また，機能停止から相関稼働になった場合でも，機能停止中に発生したJP1イベントに対して相関イベントの発行処理はしない。

備考

機能停止前に発行処理中だった相関イベントは機能停止後に不成立になる。

STOPPING

停止処理中

相関イベント発行機能が停止処理をしている状態。

STOP

停止

相関イベント発行機能が停止している状態。

起動オプションに表示される文字列について次に説明します。

表1‒32　起動オプションに表示される文字列

起動オプションに表示される文字列

起動オプション

説明

cold

coldスタート

前回停止時に相関イベントの発行処理中であった情報を引き継がない。

warm

warmスタート

前回停止時に相関イベントの発行処理中であった情報を引き継ぐ。

相関イベント発行定義ファイルの形式については，「相関イベント発行定義ファイル」（2.　定義ファイル）を参照してください。

戻り値

0

状態の表示に成功した

1

状態の表示に失敗した

2

相関イベント発行機能との通信がタイムアウトした

100

コマンドを実行する権限がない（Windowsの場合）

101

引数エラー

102

通信エラー

255

その他の異常終了（システムエラー）

使用例1

物理ホスト（hostP）の相関イベント発行機能の状態を表示する場合（状態：相関稼働，起動オプション：cold）

入力値

jcoegsstatus

結果

KAJV3261-I  hostPの相関イベント発行サービスの状態を表示します
相関イベント発行機能        : RUNNING
起動オプション              : cold

使用例2

物理ホスト（hostP）の相関イベント発行機能の状態および相関イベント発行定義を表示する場合（状態：相関稼働，起動オプション：cold）

入力値

jcoegsstatus  -d

結果

KAJV3261-I  hostPの相関イベント発行サービスの状態を表示します
相関イベント発行機能        : RUNNING
起動オプション              : cold

KAJV3281-I  hostPの相関イベント発行定義を表示します
ファイル名  :  /tmp/teigi1.conf
反映日時  :  2005/11/05 20:35:30

VERSION=2
[CONDITION]
TARGET=B.SOURCESERVER==host1;host2;host3
CON=CID:1, B.ID==100, E.SEVERITY==Emergency;Critical;Alert;Error
SAME_ATTRIBUTE=B.SOURCESERVER
CORRELATION_NUM=20
SUCCESS_EVENT=B.ID:A00, E.SEVERITY:Emergency, B.MESSAGE:$EV1_B.MESSAGE

使用例3

物理ホスト（hostP）の相関イベント発行機能の状態および相関イベント発行定義を表示する場合（状態：機能停止，起動オプション：warm）

なお，次の条件がある。

JP1/IM - Managerの新規インストール時

相関イベント発行定義ファイルが設定されていないため，KAJV3283-Iが出力される。

入力値

jcoegsstatus  -d

結果

KAJV3261-I  hostPの相関イベント発行サービスの状態を表示します
相関イベント発行機能        : STANDBY
起動オプション              : warm

KAJV3283-I  hostPの相関イベント発行定義は定義されていません

使用例4

物理ホスト（hostP）の相関イベント発行機能の状態および相関イベント発行定義を表示する場合（状態：停止(プロセスダウン)，起動オプション：cold）

入力値

jcoegsstatus  -d

結果

KAJV3261-I  hostPの相関イベント発行サービスの状態を表示します
相関イベント発行機能        : STOP
起動オプション              : cold

KAJV3281-I  hostPの相関イベント発行定義を表示します
ファイル名  :  /tmp/teigi1.conf
反映日時  :  2005/11/05 20:35:30

VERSION=2
[CONDITION]
TARGET=B.SOURCESERVER==host1;host2;host3
CON=CID:1, B.ID==100, E.SEVERITY==Emergency;Critical;Alert;Error
SAME_ATTRIBUTE=B.SOURCESERVER
CORRELATION_NUM=20
SUCCESS_EVENT=B.ID:A00, E.SEVERITY:Emergency, B.MESSAGE:$EV1_B.MESSAGE

使用例5

イベント相関機能の起動時に不正な相関イベント発行定義ファイルを読み込んだ場合

入力値

jcoegsstatus  -d

結果

KAJV3261-I  hostPの相関イベント発行サービスの状態を表示します
相関イベント発行機能        : RUNNING
起動オプション              : cold

KAJV3281-I  hostPの相関イベント発行定義を表示します
ファイル名  :  /tmp/teigi1.conf
反映日時  :  2005/11/05 20:35:30

KAJV3285-I  hostPの相関イベント発行定義に不正があるため，不正な相関イベント発行条件を無視して動作しています

[CONDITION]
CON=CID:1, B.ID==ZZZ                ・・・※メッセージIDが不正
SUCCESS_EVENT=B.ID:A00, E.SEVERITY:Emergency, B.MESSAGE:$EV1_B.MESSAGE

jcoegsstop

機能

相関イベント発行機能の状態を，相関稼働から機能停止に移行します。相関イベント発行機能は機能停止状態になると，相関イベントの発行処理を停止します。

jcoegsstopコマンドは，相関イベント発行機能を停止させずに，相関イベントの発行処理だけを休止したい場合に使用します。なお，相関イベント発行機能の状態を相関稼働に戻したい場合，jcoegsstartコマンドを実行するか，JP1/IM - Managerを再起動してください。

jcoegsstopコマンドで状態の移行に成功すると，JP1イベント（00003F26）が発行されます。JP1イベント（00003F26）については，「3.2.2　JP1/IM - Managerが出力するJP1イベントの詳細」を参照してください。

形式

jcoegsstop [-h 論理ホスト名]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Consoleパス¥bin¥

UNIXの場合

/opt/jp1cons/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，論理ホスト名を指定します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。クラスタシステムを使用していない場合には指定は不要です。

注意事項

相関イベントの発行処理中にこのコマンドを実行した場合，発行処理中の相関イベントはすべて不成立になります。

相関イベント発行機能の状態が機能停止の間に発行されたJP1イベントは，相関イベントの発行処理の対象外になります。

jcoegsstopコマンドの実行時に相関イベント発行機能が機能停止状態だった場合，状態は変更されません。

戻り値

0

相関イベント発行機能の停止に成功した

1

相関イベント発行機能の停止に失敗した

2

相関イベント発行機能との通信がタイムアウトした

100

実行権限がない（Windows限定）

UNIXの場合は，rootに対してだけ実行権限を与える

101

引数エラー

102

通信エラー

255

その他の異常終了（システムエラー）

使用例

物理ホスト（hostP）の相関イベント発行機能を停止する場合

入力値

jcoegsstop

結果

KAJV3301-I hostPの相関イベント発行機能を停止しました

jcoevtreport

機能

統合監視DBに登録しているJP1イベントの情報をCSV形式にしてファイルに出力するコマンドです。このコマンドは，複数を同時に実行できません。

jcoevtreportコマンドは，統合監視DBを無効にしている場合またはセントラルコンソールが停止している場合でも，IMデータベースサービスが起動していれば，JP1イベントの情報をCSV形式にしてファイルに出力できます。

重要

jcoevtreportコマンドは統合監視DBのイベントを取得するため，JP1/IM - Viewからのイベント検索，対処状況変更，およびJP1/IM - Managerのイベント取得処理に影響します。このため，イベントが大量に発生している場合にjcoevtreportコマンドを実行したとき，JP1/IM - ViewやJP1/IM - Managerのほかの処理が遅延し，運用に影響を及ぼすことがあります。jcoevtreportコマンドを実行する場合は，運用に影響を及ぼさない時間帯に実行することをお勧めします。

CSVの出力形式については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「4.15.2　統合監視DBのイベント情報を保管（イベントレポート出力）」を参照してください。

定義を誤った場合や，ファイルサイズの最大値を超えた場合などのエラー情報は，標準エラー出力に出力されます。

出力する機能の説明を次の表に示します。

機能

説明

イベントレポート出力

統合監視DBに登録しているJP1イベントの情報をCSV形式にしてファイルに出力する機能

保守情報出力

統合監視DBで障害が発生した場合に出力対象始点日から出力対象終点日までに登録されたJP1イベントのすべての情報をイベントレポート出力する機能

保存出力

統合監視DBからJP1イベントの情報が削除される前に，イベントレポート出力を利用して保存する機能

保存出力状態表示

統合監視DB内の保存出力していないJP1イベントの割合（統合監視DBの最大件数との比率）と容量，および削除警告通知位置を表示する機能

形式

イベントレポート出力
jcoevtreport [-h 論理ホスト名]
             [-o 出力ファイル名]
              -s 出力対象始点日 -e 出力対象終点日
             [-user]
             [-f イベントレポート出力のフィルターファイル名]
             [-k イベントレポート出力の項目ファイル名]
             [-t {ON|OFF}]
             [-a {EVTATTR|DISP}]
保守情報出力
jcoevtreport [-h 論理ホスト名]
             [-o 出力ファイル名]
              -s 出力対象始点日 -e 出力対象終点日
              -sys
保存出力
jcoevtreport [-h 論理ホスト名]
             [-o 出力ファイル名]
              -save
             [-t {ON|OFF}]
             [-a {EVTATTR|DISP}]
保存出力状態表示
jcoevtreport [-h 論理ホスト名]
              -showsv

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Consoleパス¥bin¥

UNIXの場合

/opt/jp1cons/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，コマンドを実行するホストの論理ホスト名を指定します。指定された論理ホストで稼働している統合監視DBからJP1イベントの情報を取得し，イベントレポート出力，保守情報出力，保存出力，または保存出力状態表示をします。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。クラスタシステムを使用していない場合には指定は不要です。

-o 出力ファイル名

統合監視DBから取得したJP1イベントの情報をCSV形式にして出力するファイル名を，相対パスまたは絶対パス形式で指定します。

ファイル名が「-」で始まるファイルを指定する場合は，オプション指定との区別をするため，「-」で始まらないように，ディレクトリを含む相対パス（「./-hoge」など）や絶対パス形式で指定してください。指定できるファイル名は，パスを含めて250バイト以内です。

ただし，Windowsの場合，次に示す文字列はファイル名には指定できません。

「:」，「?」，「"」，「<」，「>」，「|」の文字。

CON，PRN，AUX，NUL，COM1，COM2，COM3，COM4，COM5，COM6，COM7，COM8，COM9，LPT1，LPT2，LPT3，LPT4，LPT5，LPT6，LPT7，LPT8，LPT9のどれかと完全一致する（小文字も含む）文字列。

指定した出力ファイル名と実際に作成されるファイル名の関係を次に示します。

統合監視DBのイベント情報がCSV形式で「出力ファイル名_通し番号.csv」が出力されます。通し番号は，000から999までの数字です。1ファイルに出力するイベントの情報は最大50,000件です。すでに同じファイル名が存在する場合は，上書きしないで，存在しない番号まで繰り上げて作成します。通し番号が999を超えた場合は，ファイルを出力しないで，終了します。オプションを省略した場合は，カレントディレクトリにjcoevtreport_通し番号.csvが出力されます。

カレントディレクトリ（「.」）やルートディレクトリ（「/」）をファイル名に指定した場合，次の対処となります。

-oの引数

Windows

UNIX

.

カレントに「._xxx.csv」が作成される。

カレントに「_xxx.csv」が作成される。

/

ルートに「_xxx.csv」が作成される。

ルートに「_xxx.csv」が作成される。

""(空文字)

カレントに「_xxx.csv」が作成される。

引数不足エラー。

-s 出力対象始点日

出力するイベントの始点日をイベントの到着時刻で指定します。

指定形式はYYYYMMDDhhmmssで指定します。

指定可能な日時の範囲は，（GMT）1970/01/01 00:00:00 〜 2099/12/31 23:59:59です。コマンド実行ホストのタイムゾーンが日本時間の場合，（GMT+9:00）1970/01/01 09:00:00 〜 2099/12/31 23:59:59となります。

-e 出力対象終点日

出力するイベントの終点日をイベントの到着時刻で指定します。

指定形式はYYYYMMDDhhmmssで指定します。

指定可能な日時の範囲は，-sオプションと同じです。

-k イベントレポート出力の項目ファイル名

イベントレポート出力の項目ファイル名を，相対パスまたは絶対パス形式で指定します。

ファイル名が「-」で始まるファイルを指定する場合は，オプション指定との区別をするため，「-」で始まらないように，ディレクトリを含む相対パス（「./-hoge」など），または絶対パス形式で指定してください。

イベントレポート出力の項目ファイルの形式については，「イベントレポート出力の項目ファイル」（2.　定義ファイル）を参照してください。

-f イベントレポート出力のフィルターファイル名

イベントレポート出力のフィルターファイル名を，相対パスまたは絶対パス形式で指定します。

ファイル名が「-」で始まるファイルを指定する場合は，オプション指定との区別をするため，「-」で始まらないように，ディレクトリを含む相対パス（「./-hoge」など），または絶対パス形式で指定してください。

イベントレポート出力のフィルターファイルの形式については，「イベントレポート出力のフィルターファイル」（2.　定義ファイル）を参照してください。

-t {ON|OFF}

登録時刻，到着時刻，および拡張属性の共通情報のSTART_TIMEとEND_TIMEを通算秒でなくYYYYMMDDhhmmss形式で出力します。

ON：登録時刻，到着時刻，および拡張属性の共通情報のSTART_TIMEとEND_TIMEを1970年1月1日からの通算秒の表記からYYYYMMDDhhmmssの西暦表示に変換したい場合に指定します。

OFF：西暦表示に変換しない場合に指定します。

このオプションの指定は，項目ファイルの指定より優先されます。

ONまたはOFFは，大文字・小文字を区別しません。

-a {EVTATTR|DISP}

ヘッダーの出力形式を指定します。-aオプションを省略した場合，ヘッダーは出力しません。

EVTATTRを指定すると表示形式が属性名（B.IDやE.SEVERITYなど）で出力し，DISPを指定すると項目（イベントIDや重大度など）で出力します。

EVTATTRまたはDISPは，大文字・小文字を区別しません。

-aオプションにDISPを指定した場合，環境変数LANGの設定値によって出力する文字列が異なります。なお，ヘッダーの文字列表示に使用される環境変数LANGは，Windowsの場合，ヘッダー文字列の言語はOSの言語になります。UNIXの場合，コマンドを実行するプロンプトの環境変数LANGになります。

また，イベント拡張属性定義ファイル（拡張ファイル）に固有の拡張属性と任意の項目名を指定すると，基本属性や共通の拡張属性と同じように，1件の属性に1つの列を割り当てて出力できます。ヘッダーについても，属性名や指定した項目名で出力できます。CSVの出力形式については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「4.15.2　統合監視DBのイベント情報を保管（イベントレポート出力）」を参照してください。

1件の固有の拡張属性に1つの列を割り当てて出力する機能は，イベントレポート出力環境定義ファイル（evtreport.conf）で有効にするかどうかを指定します。詳細については，「イベントレポート出力環境定義ファイル（evtreport.conf）」（2.　定義ファイル）を参照してください。

jcoevtreportコマンドが出力するヘッダーの文字列を次の表に示します。

表1‒33　jcoevtreportコマンドが出力するヘッダー文字列

-a EVTATTRの場合

-a DISPの場合

LANGが日本語

LANGが英語

B.SEQNO

イベントDB内通し番号

Serial number

B.ID

イベントID

Event ID

B.PROCESSID

発行元プロセスID

Source process ID

B.TIME

登録時刻

Registered time

B.ARRIVEDTIME

到着時刻

Arrived time

B.REASON

登録要因

Registered reason

B.USERID

発行元ユーザーID

Source user ID

B.GROUPID

発行元グループID

Source group ID

B.USERNAME

発行元ユーザー名

Source user name

B.GROUPNAME

発行元グループ名

Source group name

B.SOURCESERVER

登録ホスト名

Source event server name

B.DESTSERVER

送信先イベントサーバ名

Destination event server name

B.SOURCEIPADDR

発行元IPアドレス

Source IP address

B.DESTIPADDR

送信先IPアドレス

Destination IP address

B.SOURCESEQNO

発行元イベントDB内通し番号

Source serial number

B.CODESET

コードセット

Code set

B.MESSAGE

メッセージ

Message

E.SEVERITY

重大度

Event level

E.USER_NAME

ユーザー名

User name

E.PRODUCT_NAME

プロダクト名

Product name

E.OBJECT_TYPE

オブジェクトタイプ

Object type

E.OBJECT_NAME

オブジェクト名

Object name

E.ROOT_OBJECT_TYPE

登録名タイプ

Root object type

E.ROOT_OBJECT_NAME

登録名

Root object name

E.OBJECT_ID

オブジェクトID

Object ID

E.OCCURRENCE

事象種別

Occurrence

E.START_TIME

開始時刻

Start time

E.END_TIME

終了時刻

End time

E.RESULT_CODE

終了コード

Result code

E.JP1_SOURCEHOST

発生元ホスト名

Event source host

E.JP1_GENERATE_SOURCE_SEQNO

関連イベントDB内通し番号

Relation Event serial number

E.JP1_GENERATE_NAME

相関イベント発行条件名

Correlation event generation condition name

E.JP1_IMSUPPRESS_ID

監視抑止ID

Suppressed event ID

E.JP1_IMSUPPRESS_NAME

繰り返しイベント条件名

Repeated event condition name

E.JP1_TRAP_NAME

監視名

Monitoring target name

E.JP1_TRAP_ID

監視ID

Monitoring ID number

E.JP1_IMCOMEXCLUDE_ID

共通除外条件群ID

Common exclude conditions group ID

E.JP1_IMCOMEXCLUDE_NAME

共通除外条件群名

Common exclude conditions group name

E.JP1_IMCOMEXCLUDE_TARGET

共通除外条件群除外対象

Common exclude conditions group target-for-exclusion

E.@JP1IM_ACTTYPE

アクション種別

Action type

E.@JP1IM_ACTCONTROL

アクション

Action

E.@JP1IM_SEVERE

重要イベント

Severe Event

E.@JP1IM_CORRELATE

相関イベント

Correlation event

E.@JP1IM_RESPONSE

応答待ちイベント

Response-waiting event

E.@JP1IM_ORIGINAL_SEVERITY

重大度(変更前)

Original Severity Level

E.@JP1IM_CHANGE_SEVERITY

重大度変更

New Severity Level

E.@JP1IM_DEALT

対処状況

Event status

E.@JP1IM_RELEASE

重要イベント解除

Severe Event Released

E.@JP1IM_DISMISSED

重要イベント削除

Severe Event Deleted

E.@JP1IM_MEMO

メモ

Memo

E.@JP1IM_DISPLAY_MESSAGE

メッセージ(変更後)

Display Message

E.@JP1IM_CHANGE_MESSAGE

表示メッセージ変更

New Message

E.@JP1IM_CHANGE_MESSAGE_NAME

表示メッセージ変更定義名

Message change definition name

E.xxxxxxx※1

項目名※2

項目名※3

Program-specific extended attributes count

固有の拡張属性数※4

Program-specific extended attributes count

Program-specific extended attributes

固有の拡張属性

Program-specific extended attribute

注※1　イベント拡張属性定義ファイル（拡張ファイル）に指定した属性名が出力されます。

注※2　日本語のイベント拡張属性定義ファイル（拡張ファイル）に指定した項目名が出力されます。

注※3　英語のイベント拡張属性定義ファイル（拡張ファイル）に指定した項目名が出力されます。

注※4　イベント拡張属性定義ファイル（拡張ファイル）に指定していない固有の拡張属性の合計数が出力されます。

-user

統合監視DBに登録しているJP1イベントをイベントレポート出力します。

-userオプションは，省略できます。

-userオプションを指定しなくても，-sys，-save，-showsvを指定していなければイベントレポート出力を指定していることになります。

-sys

統合監視DBに登録しているJP1イベントを保守情報出力します。

-save

統合監視DB内の保存出力していないJP1イベントをすべて保存出力します。

-showsv

次の項目を表示します。

表示項目

内容

未出力イベントの割合

統合監視DB内の保存出力していないJP1イベントの割合（統合監視DBの最大件数との比率）をパーセンテージで表示します。

未出力イベントのサイズ

統合監視DB内の保存出力していないJP1イベントの統合監視DB内でのデータサイズを，メガバイト単位で表示します。

表示するサイズは，統合監視DB内でのデータサイズです。CSV出力には，表示された未出力イベントのサイズ×1.2の容量が必要となります。

削除警告通知設定

削除警告通知位置の設定値を表示します。

削除警告通知がOFFの場合は「-」（半角ハイフン）を表示します。

戻り値

0

正常終了

1

オプション・引数不正

2

フィルター不正

3

項目ファイル不正

4

レポート出力処理エラー

5

実行権限エラー（Windows限定）

6

同時実行エラー

7

出力ファイルの通し番号が上限値に達した

101

統合監視DBがセットアップされていない

102

IMデータベースサービスが起動していない

103

IMデータベースサービスとの接続エラーが発生した

254

メモリー不足が発生した

255

システムエラー

注意事項

Windowsの場合，Application Experienceサービスが存在する場合は，Application Experienceサービスのスタートアップの種類が無効になっていないことを確認してからコマンドを実行してください。

使用例1

2008/06/01 12:00:00 〜 2009/01/01/00:00:00の間にマネージャーに到着したイベントを対象にレポート出力する場合

jcoevtreport -s 20080601120000 -e 20090101000000 -user

使用例2

出力先を「report_xxx.csv」に指定して2009/07/08 08:45:00 〜 2009/07/14 17:15:00のJP1イベントをイベントレポート出力する場合

jcoevtreport -s 20090708084500 -e 20090714171500 -o report

使用例3

出力先を「report_xxx.csv」に指定して2009/07/08 08:45:00 〜 2009/07/14 17:15:00のJP1イベントを保守情報出力する場合

jcoevtreport -sys -s 20090708084500 -e 20090714171500 -o report

使用例4

出力先を「report_xxx.csv」に指定して保存出力する場合

jcoevtreport -save -o report

使用例5

保存出力状態を表示する場合

jcoevtreport -showsv

jcofuncfcheck（Windows限定）

機能

このコマンドを実行すると，指定されたディレクトリのアプリケーション実行定義ファイルおよび統合機能メニュー定義ファイルの定義誤りなどがチェックされ，解析結果が標準出力に出力されます。

解析結果は次の形式で出力されます。

Function tree definition

ツリー階層 "表示文字列" [,"実行コマンドパス"]

Function toolbar definition

row = 列

"表示文字列"[,"実行コマンドパス"]

注

「Function toolbar definition」以降の部分は，統合機能メニュー定義ディレクトリとして次のディレクトリが指定された場合にだけ表示されます。

Viewパス¥conf¥function¥ja

または

Viewパス¥conf¥function¥en

解析結果には，システムで定義するアプリケーション実行定義識別子（セントラルコンソールで使用するデフォルトのWWWブラウザー定義である「"default_browser"」）および統合機能メニュー識別子（機能ツリーの最上位ノードを表す「"root"」）が含まれます。

形式

jcofuncfcheck アプリケーション実行定義ディレクトリ名
              統合機能メニュー定義ディレクトリ名

実行権限

なし

格納先ディレクトリ

Viewパス¥bin¥

引数

アプリケーション実行定義ディレクトリ名

チェックの対象となるアプリケーション実行定義ファイルがあるディレクトリを，絶対パス名，またはカレントディレクトリからの相対パス名で指定します。ファイル名は指定できません。

統合機能メニュー定義ディレクトリ名

チェックの対象となる統合機能メニュー定義ファイルがあるディレクトリを，絶対パス名，またはカレントディレクトリからの相対パス名で指定します。ファイル名は指定できません。

使用例

次の定義ファイルに対してコマンドを実行した場合の例を示します。

アプリケーション実行定義ファイル

@file type="application-execution-definition", version="0300";
@define-block type="application-execution-def";
id="notepad";
path="C:¥winnt¥system32¥notepad.exe";
@define-block-end;
@define-block type="application-execution-def";
id="dmp";
path="[¥HKEY_LOCAL_MACHINE¥SOFTWARE¥HITACHI¥NETM/DM/P¥0521/A¥PathName¥Path00]¥bin¥DMPSTS.exe";
@define-block-end;

統合機能メニュー定義ファイル

@file type="function-definition", version="0300";
@define-block type="function-tree-def";
id="node1";
parent_id="root";
name="ノード1";
@define-block-end;
@define-block type="function-tree-def";
id="node11";
parent_id="node1";
name="ノード11";
icon="%JCO_INSTALL_PATH%¥image¥1206.gif";
execute_id="default_browser";
args="http://";
@define-block-end;
@define-block type="function-tree-def";
id="node2";
parent_id="root";
name="ノード2";
icon="%JCO_INSTALL_PATH%¥image¥1206.gif";
execute_id="notepad";
@define-block-end;
@define-block type="function-tree-def";
id="node3";
parent_id="root";
name="ノード3";
icon="%JCO_INSTALL_PATH%¥image¥1206.gif";
execute_id="dmp";
@define-block-end;

解析結果は次のように出力されます。

Function tree definition
  "統合管理"
   "ノード1"
     "ノード11","C:¥Program Files¥Netscape¥Communicator¥Program¥netscape.exe"
     "ノード2","C:¥winnt¥system32¥notepad.exe"
     "ノード3","C:¥NETMDMP¥bin¥DMPSTS.exe"
Function toolbar definition
  row=1
   "ノード11","C:¥Program Files¥Netscape¥Communicator¥Program¥netscape.exe"
   "ノード2","C:¥winnt¥system32¥notepad.exe"

jcogencore

機能

JP1/IM - Managerのプロセスで障害が発生したときに，ダンプを出力するためのコマンドです。なお，インテリジェント統合管理サービス（jddmain），セントラルスコープサービス（jcsmain）は除きます。また，jcogencoreコマンドを実行した場合は，JP1/IM - Managerを再起動する必要があります。

jcogencoreコマンドは，通常実行するコマンドではありません。プロセスがハングアップした場合や，サポートからの調査の過程で指示された場合に，実行してください。

障害の検知手段としてはJP1/IM - Managerのヘルスチェック機能を利用します（ヘルスチェック機能については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「9.2　JP1/IM - Managerのヘルスチェック機能」参照）。

jcogencoreコマンドを実行すると，どのプロセスの障害資料を出力するか問い合わせメッセージが表示されます。障害が発生したプロセスの資料を出力するようにします。jcogencoreコマンドを実行することで出力されるファイルを次の表に示します。

表1‒34　出力されるファイル

OS

プロセス名

出力されるファイルの名称

Javaスレッドダンプ

コアダンプ

Windows

evflow

javacoreプロセスID.XXXXXXXXXX.txt

−

jcamain

−

−

evtcon※1

javacoreプロセスID.XXXXXXXXXX.txt

−

evgen※1，※2

javacoreプロセスID.XXXXXXXXXX.txt

−

jcfmain

javacoreプロセスID.XXXXXXXXXX.txt

−

UNIX

evflow

javacoreプロセスID.XXXXXXXXXX.txt

core.evflow

jcamain

−

core.jcamain

evtcon※1

javacoreプロセスID.XXXXXXXXXX.txt

core.java

evgen※1，※2

javacoreプロセスID.XXXXXXXXXX.txt

core.evgen

jcfmain

javacoreプロセスID.XXXXXXXXXX.txt

core.jcfmain

core.プロセスID.jcfallogtrap

（凡例）

XXXXXXXXXX：OSが自動で割り当てる一意のID

−：出力しない

注※1

evtcon，およびevgenは機能名です。

注※2

統合監視DBを使用しない場合に使用される機能名です。

出力されたファイルは，次のフォルダに格納されます。

プロセス名がjcfmain以外の場合

Windowsの場合

物理ホスト：Consoleパス¥log¥

論理ホスト：共有ディスク¥jp1cons¥log¥

UNIXの場合

物理ホスト：/var/opt/jp1cons/log/

論理ホスト：共有ディスク/jp1cons/log/

プロセス名がjcfmainの場合

Windowsの場合

物理ホスト：Managerパス¥log¥imcf¥

論理ホスト：共有ディスク¥jp1imm¥log¥imcf¥

UNIXの場合

物理ホスト：/var/opt/jp1imm/log/imcf

論理ホスト：共有ディスク/jp1imm/log/imcf

出力したスレッドダンプおよびコアダンプは，資料採取ツールを使って，ほかの障害資料と合わせて採取してください。

また，このコマンドを実行したあとは，JP1/IM - Managerの再起動が必要です。

Windowsの場合

物理ホスト：コマンドを実行したあと，［コントロールパネル］−［管理ツール］−［サービス］で「JP1/IM-Managerサービス」を停止し，再起動してください。再起動後に，jco_spmd_statusコマンドでプロセスの起動状況を確認してください。

論理ホスト：コマンドを実行したあと，［コントロールパネル］−［管理ツール］−［サービス］で「JP1/IM-Manager_論理ホスト名サービス」を停止し，再起動してください。クラスタソフトで「JP1/IM-Manager_論理ホスト名サービス」を監視している場合は，クラスタソフトでサービスを再起動するか，フェールオーバーしてください。

UNIXの場合

物理ホスト：コマンドを実行したあと，指定したプロセスが強制的に停止します。一度，jco_stopコマンドですべてのプロセスを停止し，jco_startコマンドで再起動してください。再起動後に，jco_spmd_statusコマンドでプロセスの起動状況を確認してください。

論理ホスト：コマンドを実行したあと，指定したプロセスが強制的に停止します。一度，jco_stop.clusterコマンドですべてのプロセスを停止し，jco_start.clusterコマンドで再起動してください。クラスタソフトでJP1/IM - Managerを監視している場合は，クラスタソフトでJP1/IM - Managerを再起動するか，フェールオーバーしてください。

形式

jcogencore [-h 論理ホスト名]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Consoleパス¥bin¥

UNIXの場合

/opt/jp1cons/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，論理ホスト名を指定します。指定した論理ホストのJP1/IM - Managerプロセスのスレッドダンプ，またはコアダンプを出力します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。クラスタシステムを使用していない場合には指定は不要です。

注意事項

UNIXの場合，jcogencoreコマンドを実行すると，ダンプ出力後に指定したプロセスは強制的に停止します。プロセスがハングアップしたとき以外には実行しないでください。プロセスのハングアップはヘルスチェックで検知できます。

なお，クラスタシステムで運用中にjcogencoreコマンドを実行する場合は，注意してください。

UNIXでこのコマンドを実行する場合には，実行前にご使用のマシンの空き容量を確認してください。jcfmainを除く5プロセス分のコアダンプを出力した場合，コアダンプの容量は合計で最大8,419メガバイトになる場合があります。

また，jcfmainのコアダンプを出力した場合，コアダンプの容量は合計で最大「560＋230×jcfallogtrapプロセスの数」メガバイトになる場合があります。

複数のプロセスで障害が発生した場合は，次の順にコマンドを実行してください。

Windowsの場合：イベントコンソールサービス（evtcon），イベント基盤サービス（evflow）

UNIXの場合：イベントコンソールサービス（evtcon），アクション実行サービス（jcamain），イベント基盤サービス（evflow）

なお，相関イベント発行機能（evgen），IM構成管理サービス（jcfmain）はほかのプロセスと依存関係がないため，コマンドの実行順序は任意です。

UNIXの場合，OSの設定などでコアダンプファイルの生成を制限しているとjcogencoreコマンドの実行でもコアダンプファイルが生成されないことがあります。

コアダンプファイルに関する設定については，マニュアル「JP1/Integrated Management 3 - Manager 構築ガイド」の「2.18.10　JP1/IM - Managerの障害に備えた設定（UNIXの場合）」を参照してください。

戻り値

0

正常終了

1

オプション・引数解析エラー

2

プロセスチェックエラー

3

論理ホストエラー

4

実行権限エラー（Windows限定）

5

パイプ作成エラー（Windows限定）

6

スレッドダンプ出力処理エラー

10

その他のエラー

使用例1

Windowsで，物理ホストのイベントコンソールサービス（evtcon）プロセスがハングアップした場合

jcogencore

使用例2

Windowsで，論理ホストhostAのイベントコンソールサービス（evtcon）プロセスがハングアップした場合

jcogencore -h hostA

使用例3

UNIXで，物理ホストのイベントコンソールサービス（evtcon）プロセスがハングアップした場合

/opt/jp1cons/bin/jcogencore

出力例

UNIXで，物理ホストのイベントコンソールサービス（evtcon）プロセスがハングアップし，コアダンプおよびスレッドダンプを出力する場合

     ProcessName    PID
[1] : evflow        1234
[2] : jcamain       94320
[3] : evtcon        3333
[4] : evgen         65654
[6] : jcfmain       3316
[7] : Exit
KAVB8427-I When outputting dumps for the three processes evflow, jcamain, and evtcon at the same time, output the dumps in order of evtcon, jcamain, and evflow.
KAVB8417-I Please enter a number for the process to output the core dump file [1-7]:3
KAVB8414-I The thread dump output request has been sent.
KAVB8407-I When the core dump is output, evtcon will stop. Is this OK? (y/n):y
KAVB8406-I The core dump file will be output.
KAVB8416-I The core dump file has been output.

jcohctest

機能

JP1/IM - Managerのヘルスチェック機能で使用するヘルスチェック定義ファイル（jcohc.conf）の定義が正しく実行されるかをテストするコマンドです。ヘルスチェック定義ファイルに従い，通知コマンドの実行テストができます。

jcohctestコマンドは，JP1/IM - Managerが起動中にだけ実行できます。

ヘルスチェック定義ファイル（jcohc.conf）を変更した場合は，jcohctestコマンドを実行する前に，jco_spmd_reloadコマンドなどでヘルスチェック定義ファイルの設定を有効にする必要があります。

ヘルスチェック定義ファイルで指定した変数（HCHOST，HCFUNC，HCPNAME，HCPID，HCDATE，およびHCTIME）は，jcohctestコマンドでのテスト時には次のように表示されます。

表1‒35　jcohctestコマンド実行時に表示される値

変数名

jcohctestコマンド実行時に表示される値

HCHOST

物理ホスト名，または-h オプションで指定した論理ホスト名

HCFUNC

evflow

HCPNAME

evflow

HCPID

evflowのプロセスID

HCDATE

通知コマンドの実行日付（YYYY/MM/DD）

HCTIME

通知コマンドの実行時刻（hh:mm:ss）

ヘルスチェック定義ファイル（jcohc.conf）については，「ヘルスチェック定義ファイル（jcohc.conf）」（2.　定義ファイル）を参照してください。

形式

jcohctest [-h 論理ホスト名]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Consoleパス¥bin¥

UNIXの場合

/opt/jp1cons/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，論理ホスト名を指定します。指定した論理ホスト用のヘルスチェック定義ファイルで設定した通知コマンドをテストします。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。クラスタシステムを使用していない場合には指定は不要です。

戻り値

0

正常終了

1

引数エラー

2

論理ホストが存在しない

3

通知コマンド実行失敗

7

実行権限エラー（Windows限定）

10

その他のエラー

jcoimdef

機能

JP1/IM - Managerのシステム環境を設定，または設定値を参照します。

このコマンドを実行すると設定内容が標準出力に出力されます。

なお，-iオプションを指定して有効になる設定値については，-iオプションの説明を参照してください。

形式

jcoimdef  [-r {EXE | OUTPUT | OFF}]
          [-b イベント取得位置]
          [-s {ON | OFF}]
          [-egs {ON | OFF}]
          [-resevent {ON | OFF}]
          [-e リトライ間隔]
          [-t タイムアウト時間]
          [-c リトライ回数:リトライ間隔]
          [-o リトライ回数:リトライ間隔]
          [-i]
          [-h 論理ホスト名]
          [-memo {ON | OFF}]
          [-chsev {ON | OFF}]
          [-db {ON | OFF}]
          [-dbntc {ON | OFF}]
          [-dbntcpos 削除警告通知位置]
          [-cf {ON | OFF}]
          [-cmdbtn {ON | OFF}]
          [-hostmap {ON | OFF}]
          [-bizmonmode {ON | OFF}]
          [-ignorecasehost {ON | OFF}]
          [-storm {ON | OFF}]
          [-dd {ON | OFF}]

-reseventオプションは，BJEXまたはJP1/ASと連携した場合に使用するオプションです。-reseventオプションの詳細については，マニュアル「JP1/Integrated Management 3 - Manager 運用ガイド」の「11.5.1　jcoimdef」を参照してください。

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Consoleパス¥bin¥

UNIXの場合

/opt/jp1cons/bin/

引数

引数なし

現在の設定内容が，標準出力に一覧表示されます。

表示形式を，次に示します。

設定項目名=設定値

デフォルトの値が設定されている場合にこのコマンドを実行したときの出力内容を次に示します。各設定項目名の設定値は引数指定によって変更ができます。

図1‒1　jcoimdefコマンドの出力形式

-r {EXE | OUTPUT | OFF}

アクション実行サービスに対する設定です。アクション実行サービス起動時に次の状態となっているアクションに対する動作を指定します。

送信待機

送信待機（キャンセル中）

送信待機（キャンセル失敗）

送信中

送信中（キャンセル中）

送信中（キャンセル失敗）

キューイング

キューイング（キャンセル中）

キューイング（キャンセル失敗）

実行中

実行中（キャンセル中）

実行中（キャンセル失敗）

EXEを指定すると，上記の状態となっているアクションを再実行します。該当アクションの状態をjcashowaコマンド，アクション結果画面などで表示した場合，状態名に「-R」が付きます。

OUTPUTを指定すると，上記の状態となっているアクションの一覧をアクション再実行用ファイル（actreaction）に出力します。

該当アクションの状態をjcashowaコマンド，アクション結果画面などで表示した場合，状態名は「終了-R」と表示されます。

アクション再実行用ファイルには，次の形式でアクションごとに繰り返し出力されます。

###　日付※△時刻※△イベントID△イベントDB内通し番号　###［改行］

　　［u=実行ユーザー名］［e=環境変数ファイル名］［d=実行先ホスト名］

　　　実行コマンド［改行］

注※　日付と時刻は再実行機能が動作した時の日付と時刻になります。

OFFを指定すると，上記の状態となっているアクションに対して処理を行わず，その状態のままになります。

-b イベント取得開始位置

JP1/IM - Managerを起動した時に取得するイベントをいつから取得するかを指定します。指定できる値は，-1〜144です。

-1を指定すると，JP1/IM - Managerが前回停止したときの状態から処理を続行します。デフォルトでは，-1が設定されています。

例えば-1が指定されている状態で，JP1/IM - ManagerがイベントDB内通し番号12000のイベントまで受信していて，イベントがイベントバッファーにイベントDB内通し番号10001〜12000（2,000件）のイベントが格納されているときにJP1/IM - Managerを再起動したときの動作は次のようになります。

JP1/IM - Managerのイベントバッファー

前回停止したときにイベントバッファーに入っていたイベント（イベントDB内通し番号10001〜12000）を再度イベントバッファーに格納します。

自動アクション

イベントDB内通し番号12000の次のイベント(イベントDB内通し番号12001)から自動アクション処理の対象になります。自動アクション処理とは，イベントとアクション定義とのマッチング処理のことです。

0を指定すると，JP1/IM - Managerの起動後に登録されたイベントから，取得処理を開始します。

JP1/IM - Managerのイベントバッファー

起動後にイベントDBに登録されたイベントがイベントバッファーに格納されます。

自動アクション

起動後にイベントDBに登録されたイベントが自動アクション処理の対象になります。

1〜144を指定すると，JP1/IM - Managerの起動前に登録されたイベントを，指定された時間分さかのぼってイベントDBから取得します。

1〜144の単位は時間です。例えば，JP1/IM - Managerが起動する1時間前にさかのぼって，イベントを取得したい場合，1を指定します。

JP1/IM - Managerのイベントバッファー

起動時刻から指定された時刻をさかのぼり，その時刻以降にマネージャー上のイベントDBに登録されたイベントがイベントバッファーに格納されます。

自動アクション

起動時刻から指定された時刻をさかのぼり，その時刻以降にマネージャー上のイベントDBに登録されたイベントが自動アクション処理の対象になります。

ただし，一度自動アクション処理を行ったイベントは，自動アクション処理の対象にはなりません。つまり，一つのイベントに対して，アクションのマッチング処理は一度だけです。

どの場合でも，セントラルスコープサービスへ配信するイベントは自動アクションと同じになります。

-s {ON | OFF}

セントラルスコープサービスを起動し，かつセントラルスコープサービスにイベントを配信するようにするかどうかを指定します。

ONを指定すると，JP1/IM - Managerの起動時にセントラルスコープサービスが起動し，さらにセントラルスコープサービスにイベントが配信されるようになります。また，［イベントコンソール］画面の［セントラルスコープ起動］ボタンおよびメニューが活性となります。

OFFを指定すると，JP1/IM - Managerの起動時にセントラルスコープサービスが起動しないため，セントラルスコープサービスにイベントが配信されるようになりません。また，［イベントコンソール］画面の［セントラルスコープ起動］ボタンおよびメニューが非活性となります。デフォルトはOFFです。

-sの設定を有効にするには，接続中のJP1/IM - Viewも再起動が必要です。

-egs {ON | OFF}

相関イベント発行機能を有効にするかどうかを指定します。

ONを指定すると，JP1/IM - Managerの起動時に次の動作をします。

統合監視DBを使用しない場合，相関イベント発行サービスを起動します。

統合監視DBを使用する場合，イベント基盤サービスの相関イベント発行機能を有効にします。

OFFを指定すると，JP1/IM - Managerの起動時に次の動作をします。

統合監視DBを使用しない場合，相関イベント発行サービスを起動しません。

統合監視DBを使用する場合，イベント基盤サービスの相関イベント発行機能を無効にします。

デフォルトはOFFです。

-resevent {ON | OFF}

応答待ちイベント管理機能を有効にするかどうかを指定します。

ONを指定すると，JP1/IM - Manager全体のイベントへの応答機能が有効になります。

OFFを指定すると，JP1/IM - Manager全体のイベントへの応答機能が無効になります。デフォルトはOFFです。このコマンドで設定した値は，JP1/IM - Managerを再起動した場合に有効になります。この場合，接続しているJP1/IM - Viewも再起動する必要があります。-iオプションまたはjco_spmd_reloadコマンドで，応答待ちイベント管理機能の有効・無効は反映できません。

-e リトライ間隔

イベント基盤サービスからイベントサービスへのイベント取得時に，イベントサービスに接続ができなかった，または接続が切断された場合に，自動的に再接続するリトライ間隔を指定します。指定できる値は，1〜86,400（単位：秒）です。イベント基盤サービスに対する設定です。

-t タイムアウト時間

イベント基盤サービスからセントラルスコープサービスまたはイベントコンソールサービスへのイベント配信処理が失敗した場合に，自動的に再配布するリトライ処理のタイムアウト時間を指定します。指定できる値は，1〜3,600（単位：秒）です。イベント基盤サービスは，セントラルスコープサービスまたはイベントコンソールサービスにイベント配信要求をし，このオプションで指定された時間内に応答がない場合は，応答がない制御に対してイベント配信を停止します。イベント基盤サービスに対する設定です。

-c リトライ回数:リトライ間隔

イベント基盤サービスからセントラルスコープサービスまたはイベントコンソールサービスへのイベント配信時に，セントラルスコープサービスまたはイベントコンソールサービスに接続ができなかった，または接続が切断された場合に，自動的に再接続するリトライ処理のリトライ回数とリトライ間隔を指定します。リトライ回数に指定できる値は0〜100（単位：回），リトライ間隔に指定できる値は0〜3,600（単位：秒）です。イベント基盤サービスに対する設定です。

-o リトライ回数:リトライ間隔

イベント基盤サービスからセントラルスコープサービスまたはイベントコンソールサービスへのイベント配信処理が失敗した場合に，自動的に再配布するリトライ処理のリトライ回数とリトライ間隔を指定します。リトライ回数に指定できる値は1〜100（単位：回），リトライ間隔に指定できる値は0〜3,600（単位：秒）です。イベント基盤サービスに対する設定です。

-i

各オプションで指定した値を有効にするために，有効にしたいオプションと一緒にこのオプションを指定します。このオプションを指定すると，一緒に指定したオプションで設定された値がイベント基盤サービスおよびアクション実行サービスに読み込まれて，有効になります。

-iオプションで直ちに反映できるオプションを次に示します。

-eオプション

-tオプション

-cオプション

-oオプション

-memoオプション

-cmdbtnオプション

-h 論理ホスト名

クラスタシステムで運用している場合に，論理ホスト名を指定します。指定した論理ホストのJP1/IM - Managerのシステム環境を設定，または設定値を参照します。ただし，論理ホストでは，物理ホストのシステム環境が引き継がれます。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。クラスタシステムを使用していない場合には指定は不要です。

-memo {ON | OFF}

メモ情報の設定機能を使用するかどうかを指定します。

統合監視DBが有効な場合にONを指定すると，メモ情報の設定機能が有効になります。OFFを指定すると，メモ情報の設定機能が無効になります。統合監視DBが無効な場合にONを指定しても，メモ情報の設定機能が無効になります。デフォルトはOFFです。

-chsev {ON | OFF}

重大度変更機能を使用するかどうかを指定します。

統合監視DBが有効な場合にONを指定すると，重大度変更機能が有効になります。OFFを指定すると，重大度変更機能が無効になります。統合監視DBが無効な場合にONを指定しても，重大度変更機能が無効になります。デフォルトはOFFです。

-db {ON | OFF}

イベント保管機能を使用するかどうかを指定します。

ON：イベント保管機能が有効になり，統合監視DBにイベントが保管されます。

OFF：イベント保管機能が無効になり，統合監視DBにイベントが保管されません。

統合監視DBが無効な場合にONを指定しても，イベント保管機能が無効になります。デフォルトはOFFです。

ONを指定する場合は，事前に統合監視DBをセットアップしてください。

統合監視DBがセットアップされていない，またはIMデータベースサービスが起動していない状態でJP1/IM - Managerを起動すると，イベント基盤サービスは統合トレースログにメッセージを出力して異常終了します。

-dbntc {ON | OFF}

統合監視DB内の保存出力していないJP1イベントの割合（統合監視DBの最大件数との比率）が削除警告通知位置を超えた場合，削除警告通知イベントを発行するかどうかを指定します。

ON：統合監視DB内で保存出力していないJP1イベントの割合が削除警告通知位置を超えたときに，削除警告通知イベントを発行します。

OFF：統合監視DB内で保存出力していないJP1イベントの割合が削除警告通知位置を超えても，削除警告通知イベントを発行しません。デフォルトはOFFです。

統合監視DBが無効な場合にONを指定しても，統合監視DB内の保存出力していないJP1イベントの割合が削除警告通知位置を超えていなければ，削除警告通知イベントを発行しません。

-dbntcpos 削除警告通知位置

削除警告通知イベントで通知する，統合監視DB内で保存出力していないJP1イベントの割合（統合監視DBの最大件数との比率）を%で指定します。

指定できる範囲は20〜80%です。デフォルト値は80です。

例えば，-dbntcpos 70と指定した場合，削除警告通知位置は70%になります。

-cf {ON | OFF}

IM構成管理サービスを起動するかどうかを指定します。

ON：JP1/IM - Managerの起動時にIM構成管理サービスを起動します。

OFF：JP1/IM - Managerの起動時にIM構成管理サービスを起動しません。デフォルトはOFFです。

ONを指定する場合は，事前にIM構成管理をセットアップしてください。

IM構成管理がセットアップされていない，またはIMデータベースサービスが起動していない状態でJP1/IM - Managerを起動すると，イベント基盤サービスは統合トレースログにメッセージを出力して異常終了します。

-cmdbtn {ON | OFF}

［コマンド実行］画面の［コマンド］ボタンを有効にするかどうかを指定します。

ON：［コマンド］ボタンを有効にします。有効にすると［コマンド実行］画面に［コマンド］ボタンが表示されます。デフォルトはONです。

OFF：［コマンド］ボタンを無効にします。無効にすると［コマンド実行］画面に［コマンド］ボタンは表示されません。

-hostmap {ON | OFF}

発生元ホストのマッピングを有効にするかどうかを指定します。

ON：発生元ホストのマッピングを有効にします。

OFF：発生元ホストのマッピングを無効にします。デフォルトはOFFです。

統合監視DBが無効な場合にONを指定しても，発生元ホストのマッピングが無効になります。

-bizmonmode {ON | OFF}

業務グループの参照・操作制限を有効にするかどうかを指定します。

ON：業務グループの参照・操作制限を有効にします。

OFF：業務グループの参照・操作制限を無効にします。デフォルトはOFFです。

統合監視DB，IM構成管理サービス，発生元ホストのマッピングのうちどれかが無効な場合にONを指定しても，業務グループの参照・操作制限が無効になります。

-ignorecasehost {ON | OFF}

ホスト名に関するイベント条件を比較するときに英大文字・英小文字を区別するかどうかを指定します。

ON：英大文字・英小文字を区別しません。ただし，比較キーワードに正規表現を使用している場合は区別します。

OFF：英大文字・英小文字を区別します。デフォルトはOFFです。

このオプションを有効にした場合に，ホスト名の大文字・小文字を区別しなくなる機能と属性の対応を次に示します。

表1‒36　機能とイベント条件の対応

機能

属性（イベント条件）

重要イベントフィルターでのフィルタリング

発行元イベントサーバ名(登録ホスト名)（B.SOURCESERVER）

発生元ホスト名（E.JP1_SOURCEHOST）

イベント検索

検索対象が統合監視DBの場合

発行元イベントサーバ名(登録ホスト名)（B.SOURCESERVER）

送信先イベントサーバ名（B.DESTSERVER）

発生元ホスト名（E.JP1_SOURCEHOST）

検索対象がイベントDBの場合

対応しない

イベント取得フィルター（拡張モードの共通除外条件）でのフィルタリング

発行元イベントサーバ名(登録ホスト名)（B.SOURCESERVER）

発生元ホスト名（E.JP1_SOURCEHOST）

表示フィルターでのフィルタリング

発行元イベントサーバ名(登録ホスト名)（B.SOURCESERVER）

発生元ホスト名（E.JP1_SOURCEHOST）

ユーザーフィルターでのフィルタリング

発行元イベントサーバ名(登録ホスト名)（B.SOURCESERVER）

発生元ホスト名（E.JP1_SOURCEHOST）

自動アクション

発行元イベントサーバ名(登録ホスト名)（B.SOURCESERVER）

発生元ホスト名（E.JP1_SOURCEHOST）

繰り返しイベントの監視抑止

発行元イベントサーバ名(登録ホスト名)（B.SOURCESERVER）

送信先イベントサーバ名（B.DESTSERVER）

発生元ホスト名（E.JP1_SOURCEHOST）

繰り返しイベントの集約表示

イベント条件を指定できないが，-ignorecasehostオプションの設定が反映される

相関イベントの発行

発行元イベントサーバ名(登録ホスト名)（B.SOURCESERVER）

送信先イベントサーバ名（B.DESTSERVER）

発生元ホスト名（E.JP1_SOURCEHOST）

重大度の変更

発行元イベントサーバ名(登録ホスト名)（B.SOURCESERVER）

送信先イベントサーバ名（B.DESTSERVER）

発生元ホスト名（E.JP1_SOURCEHOST）

メッセージの表示形式の変更

発行元イベントサーバ名(登録ホスト名)（B.SOURCESERVER）

送信先イベントサーバ名（B.DESTSERVER）

発生元ホスト名（E.JP1_SOURCEHOST）

イベントレポート出力

発行元イベントサーバ名(登録ホスト名)（B.SOURCESERVER）

送信先イベントサーバ名（B.DESTSERVER）

発生元ホスト名（E.JP1_SOURCEHOST）

発生元ホストのマッピング

発行元イベントサーバ名(登録ホスト名)（B.SOURCESERVER）

送信先イベントサーバ名（B.DESTSERVER）

発生元ホスト名（E.JP1_SOURCEHOST）

-storm {ON | OFF}

繰り返しイベントの監視抑止を有効にするかどうかを指定します。

ON：繰り返しイベントの監視抑止を有効にします。

OFF：繰り返しイベントの監視抑止を無効にします。デフォルトはOFFです。

統合監視DBが無効な場合にONを指定しても，繰り返しイベントの監視抑止が無効になります。

-dd {ON | OFF}

インテリジェント統合管理基盤サービスを起動するかどうかを指定します。

ON：JP1/IM - Managerの起動時にインテリジェント統合管理基盤サービスを起動します。

OFF：JP1/IM - Managerの起動時にインテリジェント統合管理基盤サービスを起動しません。デフォルトはOFFです。

ONを指定する場合は，事前に統合監視DBのセットアップが必要です。また，発生元ホストのマッピングを有効にしてください。

統合監視DBがセットアップされていない，発生元ホストのマッピングが無効，またはIMデータベースサービスが起動していない状態でJP1/IM - Managerを起動すると，インテリジェント統合管理基盤サービスは統合トレースログにメッセージを出力して異常終了します。

戻り値

0

正常終了

1

異常終了

7

実行権限エラー（Windows限定）

111

イベント基盤サービスとの接続に失敗（UNIX の場合）

-401

イベント基盤サービスとの接続に失敗（Windows の場合）

定義が有効になる契機

オプション

有効になる契機

JP1/IM - Managerの再起動時

jco_spmd_reloadコマンド実行時

-i指定時

-r

○

−

−

-b

○

−

−

-s

○※

−

−

-egs

○

−

−

-resevent

○※

−

−

-e

○

○

○

-t

○

○

○

-c

○

○

○

-o

○

○

○

-memo

○※

○※

○※

-chsev

○※

−

−

-db

○※

−

−

-dbntc

○

○

−

-dbntcpos

○

○

−

-cf

○

−

−

-cmdbtn

○

−

○※

-hostmap

○※

−

−

-bizmonmode

○※

−

−

-ignorecasehost

○※

−

−

-storm

○※

−

−

-dd

○

−

−

（凡例）

○：有効になる

−：該当しない

注※

接続中のJP1/IM - Viewの再起動が必要です。

jcomonitorfcheck

機能

モニター画面呼び出し定義ファイルをチェックします。

このコマンドを実行すると，指定されたモニター画面呼び出し定義ファイルの定義誤りなどがチェックされ，解析結果が標準出力に出力されます。定義誤りなどのエラー情報は標準エラー出力に出力されます。

解析結果は，イベントID単位に次の形式で出力されます。

プロダクト名，イベントID

開始バージョン，終了バージョン

[サブキー名 ，キーとなる属性名

[キーとなる属性値, インターフェース名]]

[インターフェース名，アプリケーション実行定義識別子，

コマンド引数，置き換えイベント属性]

バージョンの指定が「0600」のように一つだけだった場合は，開始バージョンと終了バージョンに同じ値が出力されます。同様に，「ALL」を指定した場合も，開始バージョンと終了バージョンの両方に「ALL」が表示されます。

キー定義「DEF_KEY」に「SUBKEY」が設定された場合は，サブキーの内容が表示されます。「SUBKEY」は，ほかのキー定義「DEF_KEY」で使用されている場合でも重複して表示されます。

このコマンドでは，アプリケーション実行定義識別子がアプリケーション実行定義ファイルに定義されているかどうかはチェックしません。

形式

jcomonitorfcheck モニター画面呼び出し定義ディレクトリ名

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：なし

格納先ディレクトリ

Windowsの場合

Consoleパス¥bin¥

UNIXの場合

/opt/jp1cons/bin/

引数

モニター画面呼び出し定義ディレクトリ名

チェックの対象となるモニター画面呼び出し定義ディレクトリ名を，絶対パス名，またはカレントディレクトリからの相対パス名で指定します。

使用例

次の定義ファイルに対してコマンドを実行した場合の例を示します。

DESC_VERSION=0300
#AJS-View用モニター画面遷移定義ファイル
DEF_KEY PRODUCT_NAME=/HITACHI/JP1/AJS2 EVENT_ID=00004102 INTERFACE=AJS2_MONITOR
DEF_KEY PRODUCT_NAME=/HITACHI/JP1/AJS2 EVENT_ID=00004103 INTERFACE=AJS2_MONITOR
DEF_KEY PRODUCT_NAME=/HITACHI/JP1/AJS2 EVENT_ID=00004104 INTERFACE=AJS2_MONITOR
DEF_KEY PRODUCT_NAME=/HITACHI/JP1/AJS2 EVENT_ID=00004105 INTERFACE=AJS2_MONITOR
DEF_KEY PRODUCT_NAME=/HITACHI/JP1/AJS2 EVENT_ID=00004106 INTERFACE=AJS2_MONITOR
DEF_KEY PRODUCT_NAME=/HITACHI/JP1/AJS2 EVENT_ID=00004107 INTERFACE=AJS2_MONITOR
DEF_KEY PRODUCT_NAME=/HITACHI/JP1/AJS2 EVENT_ID=00004108 INTERFACE=AJS2_MONITOR
DEF_KEY PRODUCT_NAME=/HITACHI/JP1/AJS2 EVENT_ID=00004109 INTERFACE=AJS2_MONITOR
DEF_KEY PRODUCT_NAME=/HITACHI/JP1/AJS2 EVENT_ID=00004120 INTERFACE=AJS2_MONITOR
DEF_KEY PRODUCT_NAME=/HITACHI/JP1/AJS2 EVENT_ID=00004121 INTERFACE=AJS2_MONITOR
DEF_KEY PRODUCT_NAME=/HITACHI/JP1/AJS2 EVENT_ID=00004122 INTERFACE=AJS2_MONITOR
DEF_KEY PRODUCT_NAME=/HITACHI/JP1/AJS2 EVENT_ID=00004123 INTERFACE=AJS2_MONITOR
DEF_KEY PRODUCT_NAME=/HITACHI/JP1/AJS2 EVENT_ID=00004124 INTERFACE=AJS2_MONITOR
DEF_KEY PRODUCT_NAME=/HITACHI/JP1/AJS2 EVENT_ID=00004125 INTERFACE=AJS2_MONITOR
DEF_KEY PRODUCT_NAME=/HITACHI/JP1/AJS2 EVENT_ID=000041A7 INTERFACE=AJS2_MONITOR
DEF_KEY PRODUCT_NAME=/HITACHI/JP1/AJS2 EVENT_ID=000041A8 INTERFACE=AJS2_MONITOR
DEF_KEY PRODUCT_NAME=/HITACHI/JP1/AJS2 EVENT_ID=000041A9 INTERFACE=AJS2_MONITOR

DEF_MTR_CALL NAME=AJS2_MONITOR EXEC_ID=jco_JP1_AJS2 PATH="-j %IM_EVC_PARAMETER_1%::%IM_EVC_PARAMETER_2%/%IM_EVC_PARAMETER_3% -t %JCO_JP1TOKEN% -v monitor -l %IM_EVC_PARAMETER_4%" PARAM=B.SOURCESERVER,E.A0,E.A1,E.A3

解析結果は次のようになります。

/HITACHI/JP1/AJS2, 41a9
 ALL, ALL
   AJS2_MONITOR, jco_JP1_AJS2, -j %IM_EVC_PARAMETER_1%::%IM_EVC_PARAMETER_2%/%IM_EVC_PARAMETER_3% -t %JCO_JP1TOKEN% -v monitor -l %IM_EVC_PARAMETER_4%, B.SOURCESERVER, E.A0, E.A1, E.A3
/HITACHI/JP1/AJS2, 4109
 ALL, ALL
   AJS2_MONITOR, jco_JP1_AJS2, -j %IM_EVC_PARAMETER_1%::%IM_EVC_PARAMETER_2%/%IM_EVC_PARAMETER_3% -t %JCO_JP1TOKEN% -v monitor -l %IM_EVC_PARAMETER_4%, B.SOURCESERVER, E.A0, E.A1, E.A3
/HITACHI/JP1/AJS2, 41a8
 ALL, ALL
   AJS2_MONITOR, jco_JP1_AJS2, -j %IM_EVC_PARAMETER_1%::%IM_EVC_PARAMETER_2%/%IM_EVC_PARAMETER_3% -t %JCO_JP1TOKEN% -v monitor -l %IM_EVC_PARAMETER_4%, B.SOURCESERVER, E.A0, E.A1, E.A3
/HITACHI/JP1/AJS2, 4108
 ALL, ALL
   AJS2_MONITOR, jco_JP1_AJS2, -j %IM_EVC_PARAMETER_1%::%IM_EVC_PARAMETER_2%/%IM_EVC_PARAMETER_3% -t %JCO_JP1TOKEN% -v monitor -l %IM_EVC_PARAMETER_4%, B.SOURCESERVER, E.A0, E.A1, E.A3
/HITACHI/JP1/AJS2, 41a7
 ALL, ALL
   AJS2_MONITOR, jco_JP1_AJS2, -j %IM_EVC_PARAMETER_1%::%IM_EVC_PARAMETER_2%/%IM_EVC_PARAMETER_3% -t %JCO_JP1TOKEN% -v monitor -l %IM_EVC_PARAMETER_4%, B.SOURCESERVER, E.A0, E.A1, E.A3
/HITACHI/JP1/AJS2, 4107
 ALL, ALL
   AJS2_MONITOR, jco_JP1_AJS2, -j %IM_EVC_PARAMETER_1%::%IM_EVC_PARAMETER_2%/%IM_EVC_PARAMETER_3% -t %JCO_JP1TOKEN% -v monitor -l %IM_EVC_PARAMETER_4%, B.SOURCESERVER, E.A0, E.A1, E.A3
/HITACHI/JP1/AJS2, 4106
 ALL, ALL
   AJS2_MONITOR, jco_JP1_AJS2, -j %IM_EVC_PARAMETER_1%::%IM_EVC_PARAMETER_2%/%IM_EVC_PARAMETER_3% -t %JCO_JP1TOKEN% -v monitor -l %IM_EVC_PARAMETER_4%, B.SOURCESERVER, E.A0, E.A1, E.A3
/HITACHI/JP1/AJS2, 4125
 ALL, ALL
   AJS2_MONITOR, jco_JP1_AJS2, -j %IM_EVC_PARAMETER_1%::%IM_EVC_PARAMETER_2%/%IM_EVC_PARAMETER_3% -t %JCO_JP1TOKEN% -v monitor -l %IM_EVC_PARAMETER_4%, B.SOURCESERVER, E.A0, E.A1, E.A3
/HITACHI/JP1/AJS2, 4105
 ALL, ALL
   AJS2_MONITOR, jco_JP1_AJS2, -j %IM_EVC_PARAMETER_1%::%IM_EVC_PARAMETER_2%/%IM_EVC_PARAMETER_3% -t %JCO_JP1TOKEN% -v monitor -l %IM_EVC_PARAMETER_4%, B.SOURCESERVER, E.A0, E.A1, E.A3
/HITACHI/JP1/AJS2, 4124
 ALL, ALL
   AJS2_MONITOR, jco_JP1_AJS2, -j %IM_EVC_PARAMETER_1%::%IM_EVC_PARAMETER_2%/%IM_EVC_PARAMETER_3% -t %JCO_JP1TOKEN% -v monitor -l %IM_EVC_PARAMETER_4%, B.SOURCESERVER, E.A0, E.A1, E.A3
/HITACHI/JP1/AJS2, 4104
 ALL, ALL
   AJS2_MONITOR, jco_JP1_AJS2, -j %IM_EVC_PARAMETER_1%::%IM_EVC_PARAMETER_2%/%IM_EVC_PARAMETER_3% -t %JCO_JP1TOKEN% -v monitor -l %IM_EVC_PARAMETER_4%, B.SOURCESERVER, E.A0, E.A1, E.A3
/HITACHI/JP1/AJS2, 4123
 ALL, ALL
   AJS2_MONITOR, jco_JP1_AJS2, -j %IM_EVC_PARAMETER_1%::%IM_EVC_PARAMETER_2%/%IM_EVC_PARAMETER_3% -t %JCO_JP1TOKEN% -v monitor -l %IM_EVC_PARAMETER_4%, B.SOURCESERVER, E.A0, E.A1, E.A3
/HITACHI/JP1/AJS2, 4103
 ALL, ALL
   AJS2_MONITOR, jco_JP1_AJS2, -j %IM_EVC_PARAMETER_1%::%IM_EVC_PARAMETER_2%/%IM_EVC_PARAMETER_3% -t %JCO_JP1TOKEN% -v monitor -l %IM_EVC_PARAMETER_4%, B.SOURCESERVER, E.A0, E.A1, E.A3
/HITACHI/JP1/AJS2, 4122
 ALL, ALL
   AJS2_MONITOR, jco_JP1_AJS2, -j %IM_EVC_PARAMETER_1%::%IM_EVC_PARAMETER_2%/%IM_EVC_PARAMETER_3% -t %JCO_JP1TOKEN% -v monitor -l %IM_EVC_PARAMETER_4%, B.SOURCESERVER, E.A0, E.A1, E.A3
/HITACHI/JP1/AJS2, 4102
 ALL, ALL
   AJS2_MONITOR, jco_JP1_AJS2, -j %IM_EVC_PARAMETER_1%::%IM_EVC_PARAMETER_2%/%IM_EVC_PARAMETER_3% -t %JCO_JP1TOKEN% -v monitor -l %IM_EVC_PARAMETER_4%, B.SOURCESERVER, E.A0, E.A1, E.A3
/HITACHI/JP1/AJS2, 4121
 ALL, ALL
   AJS2_MONITOR, jco_JP1_AJS2, -j %IM_EVC_PARAMETER_1%::%IM_EVC_PARAMETER_2%/%IM_EVC_PARAMETER_3% -t %JCO_JP1TOKEN% -v monitor -l %IM_EVC_PARAMETER_4%, B.SOURCESERVER, E.A0, E.A1, E.A3
/HITACHI/JP1/AJS2, 4120
 ALL, ALL
   AJS2_MONITOR, jco_JP1_AJS2, -j %IM_EVC_PARAMETER_1%::%IM_EVC_PARAMETER_2%/%IM_EVC_PARAMETER_3% -t %JCO_JP1TOKEN% -v monitor -l %IM_EVC_PARAMETER_4%, B.SOURCESERVER, E.A0, E.A1, E.A3

jcothreaddmp（Windows限定）

機能

JP1/IM - Viewで障害が発生したときに，スレッドダンプを出力するためのコマンドです。

jcothreaddmpコマンドを実行して出力したスレッドダンプは，次のフォルダに格納されます。

Viewパス¥log¥

出力したスレッドダンプは，資料採取ツールを使って，ほかの障害情報と合わせて採取してください。

形式

jcothreaddmp プロセスID

実行権限

なし

格納先ディレクトリ

Viewパス¥bin¥

引数

プロセスID

操作ができなくなったJP1/IM - Viewのjava.exeプロセスのプロセスIDを指定します。指定できるプロセスIDは一つだけです。プロセスIDの省略および複数指定はできません。

複数のJP1/IM - Viewを起動している場合は，タスクマネージャで操作ができなくなったJP1/IM - ViewのプロセスIDを識別してください。

JP1/IM - Viewはタスクマネージャ上でjava.exeと表示されます。このとき，同時に動作しているほかのjavaプログラムがあると，同様にjava.exeと表示されるため，識別が難しくなります。マニュアル「JP1/Integrated Management 3 - Manager 運用ガイド」の「12.4.1(1)(b)　JP1/IM用スレッドダンプを出力する」を参照して，操作できなくなったJP1/IM - ViewのプロセスIDを識別してください。

注意事項

正常なJP1/IM - Viewに対して，jcothreaddmpコマンドを実行した場合は，JP1/IM - Viewの動作が不安定になることがあります。この場合には，JP1/IM - Viewを再起動してください。

戻り値

0

正常終了

1

オプションの解析エラー

2

プロセスのチェックエラー

3

スレッドダンプ出力要求の送信エラー

10

その他のエラー

jcovcfsetup（Windows限定）

機能

IM構成管理・ビューアーを起動するメニューをWindowsのスタートメニューに登録・削除するコマンドです。なお，IM構成管理・ビューアーはインストール時にWindowsのスタートメニューには登録されます。

このコマンドは，［管理者として実行］から起動したコマンドプロンプト上から実行したときだけ有効となります。

形式

jcovcfsetup [-i | -u]

実行権限

Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

格納先ディレクトリ

Viewパス¥bin¥

引数

オプションを指定しない場合は，-iオプションを指定したときと同じ動作をします。

-i

IM構成管理・ビューアーを起動するメニューを登録します。

-u

IM構成管理・ビューアーを起動するメニューを削除します。

ただし，メニューの名称や，格納場所を手動で変更した場合，削除できません。この場合は手動で削除する必要があります。

注意事項

コマンドの引数で指定できる最大バイト数は，OSの制限に依存します。コマンドの引数は，各OSの制限内で指定します。

戻り値

0

正常終了

1

異常終了

使用例1

JP1/IM - Viewのメニューに，［構成管理］を追加する場合

jcovcfsetupまたはjcovcfsetup -i

使用例2

JP1/IM - Viewのメニューから［構成管理］を削除する場合

jcovcfsetup -u

jcoview（Windows限定）

機能

JP1/IM - Viewの画面を起動します。

オプション指定によって次のように起動する画面が異なります。

JP1/IM - Viewの［ログイン］画面の起動

-p，-eオプション以外のオプションを指定した場合，またはオプション指定なしの場合，［ログイン］画面が起動します。

-cオプション指定時：［ログイン］画面の［セントラルコンソール］チェックボックスがチェックされます。

-sオプション指定時：［ログイン］画面の［セントラルスコープ］チェックボックスがチェックされます。

-hオプション指定時：［ログイン］画面の「接続ホスト名」に値が入力されます。

-uオプション指定時：［ログイン］画面の「ユーザー名」に値が入力されます。

JP1/IM - Viewの［イベントコンソール］画面および［監視ツリー］画面の起動

-h，-u，-pオプションを指定した場合，［イベントコンソール］画面および［監視ツリー］画面が起動します。［イベントコンソール］画面および［監視ツリー］画面を起動する場合，-h，-u，-pオプションの指定は必須となります。

-cオプション指定時：［イベントコンソール］画面が起動します。

-sオプション指定時：［監視ツリー］画面が起動します。

-c，-sオプション指定なし：［イベントコンソール］画面が起動します。

JP1/IM - Viewの［監視ツリー(編集中)］画面の起動

-eオプションを指定した場合，［監視ツリー(編集中)］画面が起動します。

形式

jcoview [[[-c] [-s]]
         [-h 接続ホスト名] [-u ユーザー名] [-p パスワード]
         | -e]

実行権限

なし

格納先ディレクトリ

Viewパス¥bin¥

引数

-c

［イベントコンソール］画面を起動します。

パスワード（-pオプション）を省略した場合，［セントラルコンソール］チェックボックスがチェックされた状態で，［ログイン］画面が起動します。また，-eオプションと同時に指定できません。

このオプションは省略できます。

-h，-u，および-pオプションが指定されていて，かつ，-c，-s，または-eオプションのどれも指定されていない場合は，この-cオプションが指定されているものと仮定されます。

-s

［監視ツリー］画面を起動します。

パスワード（-pオプション）を省略した場合，［セントラルスコープ］チェックボックスがチェックされた状態で，［ログイン］画面が起動します。また，-eオプションと同時に指定できません。

このオプションは省略できます。

-h 接続ホスト名

接続先ホストのホスト名を指定します。指定できる文字数は，1〜255バイトです。JP1/IM - Managerが起動しているホストだけを指定できます。

接続先ホスト名には，次のものが指定できます。

コマンドを使用するホストで定義されているホスト名

コマンドを使用するホストでアドレス解決可能なホスト名

IPアドレス

IPアドレスを指定する場合，IPv4アドレス形式のアドレスだけ指定できます。IPv6アドレス形式のアドレスは指定できません。

このオプションは省略できますが，-pオプションを指定するときは省略できません。

-u ユーザー名

認証サーバに登録してあるJP1ユーザー名を指定します。指定できる文字数は，1〜31バイトです。半角英数字（英字は小文字）だけを使用できます。

このオプションは省略できますが，-pオプションを指定するときは省略できません。

-p パスワード

指定したユーザー名に対応するパスワードを指定します。指定できる文字数は，6〜32バイトです。半角英数字だけを使用できます。英字は，大文字・小文字が区別されます。

このオプションを指定する場合は，-hおよび-uオプションも指定する必要があります。

このオプションは省略できます。

-e

［監視ツリー(編集中)］画面を起動します。

このオプションを指定する場合は，ほかのオプションを指定しないでください。

このオプションは省略できます。

重要

jcoviewコマンドの引数に誤った値を指定し，JP1/IM - Viewを起動すると，「KAVB0104-E ユーザー認証に失敗しました」，または「KAVB1210-E 接続中に通信エラーが発生しました。ホスト名をIPアドレスに変換できません。ホスト名を確認してくださいホスト名：ホスト名, ポート番号：ポート番号 詳細情報：詳細情報」メッセージを出力後に［ログイン］画面が表示され，マウスでクリックしても，［ログイン］画面の入力フィールドを選択して入力できなくなる場合があります。この場合は，いったん，タスクバーでJP1/IM - View以外の画面をクリックした後，［ログイン］画面をクリックすると入力できる状態になります。

日本語で動作させる場合，コードページを932以外に設定しているコマンドプロンプトからjcoviewコマンドを実行すると，画面に表示される文字が文字化けする場合があります。

中国語で動作させる場合，コードページを936以外に設定しているコマンドプロンプトからjcoviewコマンドを実行すると，画面に表示される文字が文字化けする場合があります。

戻り値

0

正常終了

1

引数エラー

2

メモリー不足

3

リソースの取得に失敗

4

エラーメッセージの作成に失敗

255

システムエラー

使用例1

JP1/IM - Viewを起動して，［ログイン］画面を表示します。

jcoview

使用例2

JP1/IM - Viewを起動して，［ログイン］画面を表示します。［ログイン］画面の［接続ホスト名］にhost，［ユーザー名］にjp1adminが設定されます。

jcoview -h host -u jp1admin

使用例3

JP1/IM - Viewを起動して，ユーザーjp1admin，パスワードjp1adminで接続ホストhostにログインし，［イベントコンソール］画面を起動します。

jcoview -h host -u jp1admin -p jp1admin

使用例4

JP1/IM - Viewを起動して，ユーザーjp1admin，パスワードjp1adminで接続ホストhostにログインし，［監視ツリー］画面を起動します。

jcoview -s -h host -u jp1admin -p jp1admin

使用例5

JP1/IM - Viewを起動して，ユーザーjp1admin，パスワードjp1adminで接続ホストhostにログインし，［イベントコンソール］画面および［監視ツリー］画面を起動します。

jcoview -c -s -h host -u jp1admin -p jp1admin

使用例6

JP1/IM - Viewを起動して，［監視ツリー(編集中)］画面を起動します。

jcoview -e

使用例7

ホストやユーザーごとに，使用例2や使用例3などのコマンドのショートカットを作成できます。

jcoview_log.bat（Windows限定）

機能

JP1/IM - Viewで障害が発生したときに資料を採取するためのツールです。JP1/IM - Viewの保守資料，OSのシステム情報，統合トレースログなどを採取します。JP1/IM - ManagerおよびJP1/Baseが同一マシン上にインストールされている場合，JP1/IM - ManagerおよびJP1/Baseの資料も採取されます。

このツールは，バッチファイルです。ユーザーによるカスタマイズはできません。

このツールを実行すると，資料を採取する対象フォルダまたはファイルを一次資料および二次資料に区分けし，指定した資料格納フォルダの直下に採取した資料が格納されます。

一次資料は，障害時の切り分けや，軽度の障害の調査を目的に採取する資料です。必要最低限のログおよび設定ファイルを採取します。二次資料は，一次資料ではわからなかった障害をさらに調査するための詳細資料です。Windowsイベントログを採取します。

また，JP1/IM - Viewのスレッドダンプがある状態でjcoview_log.batを実行すると，メッセージKAVB8946-Iを表示してスレッドダンプを削除するかどうかユーザーに問い合わせます。「y」を入力した場合，スレッドダンプを削除します。

必要に応じて採取した資料を圧縮ツールなどで圧縮してください。

なお，このツールを使って採取できる資料の詳細については，マニュアル「JP1/Integrated Management 3 - Manager 運用ガイド」の「12.3　トラブル発生時に採取が必要な資料」を参照してください。

資料格納フォルダの直下に格納された資料のフォルダ構成および資料内容を次に示します。

表1‒37　一次資料の内部フォルダ構成

フォルダ名

格納された資料

資料格納フォルダ¥jp1_default¥imm_1st¥coview

JP1/IM - Viewのパッチ情報

資料格納フォルダ¥jp1_default¥imm_1st¥coview¥conf

JP1/IM - Viewの設定および定義ファイル

資料格納フォルダ¥jp1_default¥imm_1st¥coview¥default

JP1/IM - Viewの共通定義情報

資料格納フォルダ¥jp1_default¥imm_1st¥coview¥log

JP1/IM - Viewのログファイル

資料格納フォルダ¥jp1_default¥imm_1st¥oslog

OSのログ情報

資料格納フォルダ¥jp1_default¥imm_1st¥spool

32bit版の統合トレースログ

資料格納フォルダ¥jp1_default¥imm_1st¥spoolx64

64bit版の統合トレースログ

表1‒38　二次資料の内部フォルダ構成

フォルダ名

格納された資料

資料格納フォルダ¥jp1_default¥imm_2nd¥oslog

Windowsイベントログ

形式

jcoview_log.bat -f 資料格納フォルダ
               [-t]
               [-q]

実行権限

Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

格納先ディレクトリ

Viewパス¥tools¥

引数

-f 資料格納フォルダ

採取した資料を出力するフォルダ名をフルパスまたはこのコマンドを実行した場所からの相対パス形式で指定します。パスに空白を含む場合は，「"」で囲んで指定します。このオプションは省略できません。

存在しないフォルダを指定した場合は，その名称でフォルダが新規作成されます。すでに存在するフォルダを指定した場合は，いったんそのフォルダを削除してから，指定したフォルダが作成されます。

-t

hostsおよびservicesファイルを採取しない場合に指定します。

-q

ユーザー確認を省略してコマンドを実行する場合に指定します。

注意事項

JP1/IM - Managerと同一ホストで，JP1/IM - Viewの資料を採取する場合は，jim_log.batコマンドを実行してください。

このツールを複数同時に実行しないでください。資料が上書きされたり，採取できなかったりする場合があります。

採取するファイルが見つからない場合，「ファイルが見つかりません」などのメッセージが表示されることがありますが，対処の必要はありません。

戻り値

0

正常終了

8

異常終了

使用例

F:¥tmp¥batフォルダに資料を採取する場合

jcoview_log.bat -f F:¥tmp¥bat

出力結果は次のようになります。

KAVB8925-I The directory does not exists. ("F:¥tmp¥bat")
           The directory will be created.
続行するには何かキーを押してください . . .
KAVB8925-I The directory does not exists. ("F:¥tmp¥bat¥jp1_default¥imm_1st")
           The directory will be created.
続行するには何かキーを押してください . . .
KAVB8925-I The directory does not exists. ("F:¥tmp¥bat¥jp1_default¥imm_2nd")
           The directory will be created.
続行するには何かキーを押してください . . .
KAVB8926-I Data acquisition processing will start.
KAVB8927-I Execution of the "D:¥Program Files¥Hitachi¥JP1IMM¥bin¥jimGetConfInfo.exe" command will start.
KAVB8921-I The information for JP1/IM - View will be acquired.
KAVB8922-I The information for JP1/IM - View has been acquired.
KAVB8928-I "D:¥Program Files¥Hitachi¥JP1IMM¥bin¥jimGetConfInfo.exe" execution is ended. (ERRORLEVEL=0)
KAVB8929-I The system information will be acquired. Please wait.
KAVB8927-I Execution of the "D:¥Program Files¥Hitachi¥JP1IMM¥bin¥jimGetMsInfo.exe" command will start.
KAVB8928-I "D:¥Program Files¥Hitachi¥JP1IMM¥bin¥jimGetMsInfo.exe" execution is ended. (ERRORLEVEL=0)
KAVB8922-I The system information has been acquired.
KAVB8929-I "Watson log and crash dump" will be acquired. Please wait.
KAVB8927-I Execution of the "D:¥Program Files¥Hitachi¥JP1IMM¥bin¥jimGetWtsnInfo.exe" command will start.
KAVB8928-I "D:¥Program Files¥Hitachi¥JP1IMM¥bin¥jimGetWtsnInfo.exe" execution is ended. (ERRORLEVEL=0)
KAVB8922-I "Watson log and crash dump" has been acquired.
KAVB8921-I Windows Eventlog(Application) will be acquired.
KAVB8927-I Execution of the "D:¥Program Files¥Hitachi¥JP1IMM¥bin¥jimGetEvLog.exe" command will start.
KAVB8928-I "D:¥Program Files¥Hitachi¥JP1IMM¥bin¥jimGetEvLog.exe" execution is ended. (ERRORLEVEL=0)
KAVB8922-I Windows Eventlog(Application) has been acquired.
KAVB8921-I Windows Eventlog(System) will be acquired.
KAVB8927-I Execution of the "D:¥Program Files¥Hitachi¥JP1IMM¥bin¥jimGetEvLog.exe" command will start.
KAVB8928-I "D:¥Program Files¥Hitachi¥JP1IMM¥bin¥jimGetEvLog.exe" execution is ended. (ERRORLEVEL=0)
KAVB8922-I Windows Eventlog(System) has been acquired.
KAVB8921-I The setup.ini of JP1/IM - Manager will be acquired.
KAVB8922-I The setup.ini of JP1/IM - Manager has been acquired.
KAVB8921-I The setup.ilg of JP1/IM - Manager will be acquired.
KAVB8922-I The setup.ilg of JP1/IM - Manager has been acquired.
KAVB8921-I The setup.ini of JP1/Base will be acquired.
KAVB8922-I The setup.ini of JP1/Base has been acquired.
KAVB8921-I The setup.ilg of JP1/Base will be acquired.
KAVB8922-I The setup.ilg of JP1/Base has been acquired.
KAVB8921-I The setup.ini of JP1/IM - View will be acquired.
KAVB8922-I The setup.ini of JP1/IM - View has been acquired.
KAVB8921-I The setup.ilg of JP1/IM - View will be acquired.
KAVB8922-I The setup.ilg of JP1/IM - View has been acquired.
KAVB8921-I The integrated trace log will be acquired.
KAVB8922-I The integrated trace log has been acquired.
KAVB8921-I The integrated installer log will be acquired.
KAVB8922-I The integrated installer log has been acquired.
KAVB8921-I The installer log file will be acquired.
KAVB8922-I The installer log has been acquired.
KAVB8921-I The hosts will be acquired.
KAVB8922-I The hosts has been acquired.
KAVB8921-I The services will be acquired.
KAVB8922-I The services has been acquired.
KAVB8921-I The registry information will be acquired.
KAVB8922-I The registry information has been acquired.
KAVB8921-I The netstat information will be acquired.
KAVB8922-I The netstat information has been acquired.
KAVB8921-I The ipconfig information will be acquired.
KAVB8922-I The ipconfig information has been acquired.
KAVB8921-I The net start information will be acquired.
KAVB8922-I The net start information has been acquired.
KAVB8921-I The set information will be acquired.
KAVB8922-I The set information has been acquired.
KAVB8918-I The data was successfully acquired.

jcschstat

機能

監視ノード（監視オブジェクトまたは監視グループ）の状態を変更します。また，監視ノードの状態変更イベントの履歴をクリアします。監視ノードの監視状態は変更できません。

障害発生時の回復処理としてバッチ処理でこのコマンドを含め，最後の処理として自動実行で監視ノードの状態を初期化したい場合，ヘルプデスクシステムと連携して障害を取り除いたあとに自動実行で監視ノードの状態を初期化したい場合に，使用できます。

このコマンドは，セントラルスコープの機能が有効になっている場合に使用できます。

JP1/IM - Manager（セントラルスコープ）がすでに32個のコマンド要求を処理している最中に，このコマンドを実行した場合，サーバ側の通信が切断され，このコマンドの実行に失敗します。

形式

jcschstat [-h 論理ホスト名]
          -n 監視ノードID1,監視ノードID2,監視ノードID3...
          [-s 状態値]
          [-i]
          [-t タイムアウト時間]
          [-d]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Scopeパス¥bin¥

UNIXの場合

/opt/jp1scope/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，論理ホスト名を指定します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。クラスタシステムを使用していない場合には指定は不要です。

-n 監視ノードID1,監視ノードID2,監視ノードID3...

状態変更の対象となる監視ノードID（監視オブジェクトIDまたは監視グループID）を指定します。監視ノードIDは，16進数で指定します。

監視ノードIDは複数指定，10個まで指定できます。複数指定する場合は，コンマ「,」で区切ってください。指定した監視ノードの順に監視ノードの状態が変わります。

-s 状態値

監視ノードの変更後の状態を指定します。状態値は大文字と小文字を区別します。監視オブジェクトはEmergency，Alert，Critical，Error，Warning，Normal，Debug，またはInitialを指定できます。監視グループはInitialだけ指定できます。

指定した監視ノードの状態を変更すると，上位ノードへ状態が伝播し，下位ノードを初期化します。

省略した場合，Initialが仮定されます。

-i

監視ノードの状態を変更する際に，確認メッセージを表示させたい場合に指定します。

-t タイムアウト時間

サーバとの通信時のタイムアウト時間を指定します。指定できる値は，1〜32,767（単位：秒）です。デフォルトは1,800秒（30分）です。

-d

このオプションを指定すると，-nオプションで指定した監視ノードが存在しない場合または監視ノードの状態変更に失敗した場合に，コマンド処理を中断し，エラー終了します。

省略した場合，存在しないまたは状態変更に失敗した監視ノードの処理をスキップし，次の監視ノード以降の処理を続行します。

戻り値

0

正常終了

1

論理ホスト名が存在しない

2

引数エラー

4

コマンドを実行する権限がない

12

メモリー不足

32

データアクセスエラー

33

監視ツリーIDまたは監視ノードIDがDB内に存在しない

37

サーバからの応答がない（コネクション要求が失敗した）

38

サーバとの通信が切断された（通信中にサーバが停止した，またはサーバ側の接続数が最大値を超えた）

39

タイムアウトが発生した（サーバに要求送信後，応答を受信するまでにタイムアウト時間を超えた）

40

サーバから不正な応答が送信された

42

ほかのコマンドまたはほかの要求が実行中

43

-nに非監視設定の監視ノードを指定している

44

-nに監視グループを設定している

99

その他のエラー

使用例

監視ノードID 8の状態をErrorに変更します。

jcschstat -n 8 -s Error

出力例

jcschstat -n 5 -s Normal
KAVB7630-I 監視ノード(5)の状態を正常に変更しました

jcsdbexport

機能

監視オブジェクトDBの保管情報を取得し，ツリー構成ファイルとしてローカルにファイル出力するコマンドです。ファイルに出力される情報は，監視ツリー構成情報，共通イベント監視条件，およびビジュアル監視画面構成情報です。

監視オブジェクトDBで保管情報を複数世代保存する場合に利用できます。また，監視オブジェクトDBの保管情報を別サーバに複製したい場合は，このコマンドを実行したあとにjcsdbimportコマンドで別サーバの監視オブジェクトDBに反映することもできます。

このコマンドは，セントラルスコープの機能が有効になっている場合に使用できます。

セントラルスコープサービスのデータ更新中にこのコマンドを実行すると，エラー終了します。例えば，［監視ツリー(編集中)］画面からサーバのツリーを更新中の場合や，jcschstatコマンドで監視ノードの状態を変更中の場合に，このコマンドを実行するとエラー終了します。

08-10以降のJP1/IM - Managerで出力したツリー構成ファイルは，08-01以前のJP1/IM - Managerで読み込むことはできません。

形式

jcsdbexport [-h 論理ホスト名]
            -o ファイル名
            [-t タイムアウト時間]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Scopeパス¥bin¥

UNIXの場合

/opt/jp1scope/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，論理ホスト名を指定します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。クラスタシステムを使用していない場合には指定は不要です。

-o ファイル名

ツリー構成情報の出力先となるファイルをフルパスで指定します。ファイル名の末尾は「.dat」と指定します。また，パスに空白を含む場合は，「"」で囲んで指定します。

-t タイムアウト時間

サーバとの通信時のタイムアウト時間を指定します。指定できる値は，10〜32,767（単位：秒）です。デフォルトは1,800秒（30分）です。

戻り値

0

正常終了

1

論理ホスト名が存在しない

2

引数エラー

3

指定したファイルが不正

4

コマンドを実行する権限がない

6

指定したファイルに対するアクセス権がない

12

メモリー不足

13

ディスク容量不足

31

サーバ側でDBの初期化失敗

32

サーバ側でDBへのアクセスに失敗

33

監視ツリーIDまたは監視ノードIDがDB内に存在しない

37

サーバからの応答がない（コネクション要求が失敗した）

38

サーバとの通信が切断された（通信中にサーバが停止した，またはサーバ側の接続数が最大値を超えた）

39

タイムアウトが発生した（サーバに要求送信後，応答を受信するまでにタイムアウト時間を超えた）

40

サーバから不正な応答が送信された

42

ほかのコマンドまたはほかの要求が実行中

99

その他のエラー

使用例

監視オブジェクトDBの保管情報をc:¥temp¥output.datに出力します。

jcsdbexport -o c:¥temp¥output.dat

出力例

KAVB7670-I ファイル(c:¥temp¥output.dat)への監視ツリー定義の出力に成功しました

jcsdbimport

機能

jcsdbexportコマンドでファイル出力した監視オブジェクトDBの保管情報（監視ツリー構成情報，共通イベント監視条件，およびビジュアル監視画面構成情報）をJP1/IM - Managerの監視オブジェクトDBに反映するためのコマンドです。

このコマンドは，jcsdbexportコマンドと併用して，ほかのサーバにJP1/IM - Managerの監視オブジェクトDBの保管情報を移行する際に利用します。

このコマンドは，セントラルスコープの機能が有効になっている場合に使用できます。

セントラルスコープサービスのデータ更新中にこのコマンドを実行すると，エラー終了します。例えば，［監視ツリー(編集中)］画面からサーバのツリーを更新中の場合や，jcschstatコマンドで監視ノードの状態を変更中の場合に，このコマンドを実行するとエラー終了します。

形式

jcsdbimport [-h 論理ホスト名]
            -o ファイル名
            [-t タイムアウト時間]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Scopeパス¥bin¥

UNIXの場合

/opt/jp1scope/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，論理ホスト名を指定します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。クラスタシステムを使用していない場合には指定は不要です。

-o ファイル名

JP1/IM - Managerの監視オブジェクトDBに反映させたい，jcsdbexportコマンドで出力したファイルをフルパスで指定します。ファイル名の末尾には「.dat」と指定します。パスに空白を含む場合は，「"」で囲んで指定します。

-t タイムアウト時間

サーバとの通信時のタイムアウト時間を指定します。指定できる値は，10〜32,767（単位：秒）です。デフォルトは1,800秒（30分）です。

注意事項

jcsdbimportコマンドでインポートすると，監視ツリーの状態が初期化されます。

戻り値

0

正常終了

1

論理ホスト名が存在しない

2

引数エラー

3

指定したファイルが不正

4

コマンドを実行する権限がない

6

指定したファイルに対するアクセス権がない

12

メモリー不足

31

サーバ側でDBの初期化失敗

32

サーバ側でDBへのアクセスに失敗

34

ツリー構成ファイルのフォーマットエラー

37

サーバからの応答がない（コネクション要求が失敗した）

38

サーバとの通信が切断された（通信中にサーバが停止した，またはサーバ側の接続数が最大値を超えた）

39

タイムアウトが発生した（サーバに要求送信後，応答を受信するまでにタイムアウト時間を超えた）

40

サーバから不正な応答が送信された

41

指定した入力ファイルが存在しない

42

ほかのコマンドまたはほかの要求が実行中

48

サーバが指定したファイルのファイルバージョンに対応していない

99

その他のエラー

使用例

jcsdbexportコマンドで出力したファイル（input.dat）を，JP1/IM - Managerの監視オブジェクトDBに反映します。

jcsdbimport -o input.dat

出力例

KAVB7660-I input.datファイルから監視ツリー定義のインポートに成功しました

jcsdbsetup

機能

監視オブジェクトDBを格納するISAMファイルを新規作成します。このコマンドを実行すると，既存の監視オブジェクトDBが削除され，新たに監視オブジェクトDBが作成されます。

監視オブジェクトDBを作成する際は，JP1/IM - Managerを停止してから実行してください。

セントラルスコープの機能を使用する場合には必ず実行してください。

形式

jcsdbsetup [-h 論理ホスト名]
           [-f]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Scopeパス¥bin¥

UNIXの場合

/opt/jp1scope/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，論理ホスト名を指定します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。クラスタシステムを使用していない場合には指定は不要です。

-f

監視オブジェクトDBが存在する場合は必ず指定します（指定しない場合，エラーとなります）。監視オブジェクトDBが存在しない場合は省略できます。

このオプションを指定し，かつ，監視オブジェクトDBが存在する場合，確認メッセージ「データベースが存在しますが，再作成してよろしいですか？[Y/N]」が表示されます。「Y」を入力し，［Enter］キーを押すと，既存の監視オブジェクトDB削除後，監視オブジェクトDBが再作成されます。監視オブジェクトが存在しない場合は，確認メッセージの表示なしで監視オブジェクトDBが作成されます。

戻り値

0

正常終了

1

論理ホスト名が不正

2

引数エラー

4

コマンドを実行する権限がない

10

セットアップされていない

12

メモリー不足

13

ディスク容量不足

20

DBがすでに存在する

42

ほかのコマンドまたはほかの要求が実行中

99

その他のエラー

jcshostsexport

機能

ホスト情報DBに登録されたホスト情報を採取するコマンドです。このコマンドを実行すると，ホスト情報DBからホスト情報を読み出し，ホスト情報ファイル名にホスト情報を格納します（ホスト情報ファイル名を指定しなかった場合，標準出力に出力します）。

このコマンドは，セントラルスコープの機能が有効になっている場合に使用できます。

形式

jcshostsexport [-h 論理ホスト名] > ホスト情報ファイル名

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Scopeパス¥bin¥

UNIXの場合

/opt/jp1scope/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，論理ホスト名を指定します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。クラスタシステムを使用していない場合には指定は不要です。

ホスト情報ファイル名

ホスト情報を格納するファイル名を指定します。

注意事項

このコマンドは実行系ホストでだけ実行してください。コマンドの実行時は共有ディスクをマウントした状態で実行してください。

このコマンドは待機系ホストでは実行しないでください。

UNIX/Linux環境の待機系ホストで実行した場合，待機系ホストのローカルディスクのルート直下に「/共有ディレクトリ名」という不要なディレクトリが作成され，その配下にも次の不要なディレクトリとファイルが作成されます。

/共有ディレクトリ名/jp1scope

/共有ディレクトリ名/jp1scope/log

上記のローカルディスクにあるルート直下の「/共有ディレクトリ名」およびそのディレクトリ配下のファイルは不要であるため削除してください。削除する際は誤って共有ディスク上のディレクトリおよびファイルを削除しないように，必ず待機系ホスト上で共有ディスクがマウントされていないことを確認して実施してください。

戻り値

0

正常終了

1

論理ホスト名が不正

2

引数エラー

4

コマンドを実行する権限がない

10

セットアップされていない

11

ホスト情報DBがない

12

メモリー不足

14

ホスト情報DBが壊れている

15

メッセージの初期化失敗

16

ホスト情報DBが使用中

99

その他のエラー

jcshostsimport

機能

ホスト情報DBにホスト情報の登録，削除を行うコマンドです。JP1/IM - Manager稼働中の場合は，このコマンド実行後，jco_spmd_reloadコマンドを実行することでホスト情報の内容が有効になります。JP1/IM - Manager停止中の場合は，JP1/IM - Managerを起動することで有効になります。

このコマンドは，セントラルスコープの機能が有効になっている場合に使用できます。

形式

jcshostsimport { { -o | -r } ホスト情報ファイル名 | -d}
               [-h 論理ホスト名]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Scopeパス¥bin¥

UNIXの場合

/opt/jp1scope/bin/

引数

-r ホスト情報ファイル名

ホスト情報DBに登録したいホスト情報を定義したファイル名を指定します。-rオプションを指定した場合は，ホスト情報DBに登録済みのホスト情報をすべて削除してからホスト情報を登録します。

ホスト情報ファイルの記述形式については，「ホスト情報ファイル（jcs_hosts）」（2.　定義ファイル）を参照してください。

-o ホスト情報ファイル名

ホスト情報DBに登録したいホスト情報を定義したファイル名を指定します。-oオプションを指定した場合は，ホスト情報DBに登録済みのホスト情報を削除せずに，ホスト情報ファイルに記述したホスト情報を追加登録します（同一IPアドレスが存在した場合は上書きします）。

ホスト情報ファイルの記述形式については，「ホスト情報ファイル（jcs_hosts）」（2.　定義ファイル）を参照してください。

-d

ホスト情報DBに登録されたホスト情報をすべて削除する場合に指定します。

-h 論理ホスト名

クラスタシステムで運用している場合に，論理ホスト名を指定します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。クラスタシステムを使用していない場合には指定は不要です。

注意事項

このコマンドは実行系ホストでだけ実行してください。コマンドの実行時は共有ディスクをマウントした状態で実行してください。

このコマンドは待機系ホストでは実行しないでください。

UNIX/Linux環境の待機系ホストで実行した場合，待機系ホストのローカルディスクのルート直下に「/共有ディレクトリ名」という不要なディレクトリが作成され，その配下にも次の不要なディレクトリとファイルが作成されます。

/共有ディレクトリ名/jp1scope

/共有ディレクトリ名/jp1scope/log

上記のローカルディスクにあるルート直下の「/共有ディレクトリ名」およびそのディレクトリ配下のファイルは不要であるため削除してください。削除する際は誤って共有ディスク上のディレクトリおよびファイルを削除しないように，必ず待機系ホスト上で共有ディスクがマウントされていないことを確認して実施してください。

戻り値

0

正常終了

1

論理ホスト名が不正

2

引数エラー

3

ファイル名が不正

4

コマンドを実行する権限がない

5

指定したホスト情報ファイルの構文エラー

6

指定したホスト情報ファイルへのアクセス権がない

10

セットアップされていない

11

ホスト情報DBがない

12

メモリー不足

13

ディスク容量不足

14

ホスト情報DBが壊れている

15

メッセージの初期化失敗

16

ホスト情報DBが使用中

99

その他のエラー

jim_log.bat（Windows限定）

機能

JP1/IM - ManagerまたはJP1/IM - Viewで障害が発生したときに資料を採取するためのツールです。JP1/IM - Manager，JP1/IM - View，およびJP1/Baseの保守資料，OSのシステム情報，統合トレースログなどを採取します。

このツールは，バッチファイルです。ユーザーによるカスタマイズはできません。

このツールを実行すると，資料を採取する対象フォルダまたはファイルを一次資料および二次資料に区分けし，指定した資料格納フォルダの直下に採取した資料が格納されます。

一次資料は，障害時の切り分けや，軽度の障害の調査を目的に採取する資料です。必要最低限のログおよび設定ファイルを採取します。二次資料は，一次資料ではわからなかった障害をさらに調査するための詳細資料です。Windowsイベントログ，JP1/BaseのイベントDBなどを採取します。

また，JP1/IM - Manager（セントラルコンソール）またはJP1/IM - Viewのスレッドダンプがある状態でjim_log.batを実行すると，メッセージKAVB8946-Iを表示してスレッドダンプを削除するかどうかユーザーに問い合わせます。「y」を入力した場合，スレッドダンプを削除します。

必要に応じて採取した資料を圧縮ツールなどで圧縮してください。

なお，このツールを使って採取できる資料の詳細については，マニュアル「JP1/Integrated Management 3 - Manager 運用ガイド」の「12.3　トラブル発生時に採取が必要な資料」を参照してください。

インテリジェント統合管理データベースを利用している場合は，インテリジェント統合管理データベース※に関する資料も採取できます。

注※

インテリジェント統合管理データベース自体のログは，このツールの採取対象外になります。マニュアル「JP1/Integrated Management 3 - Manager 運用ガイド」の「12.3.1(1)(b) JP1の情報」に記載しているケースに該当する場合は，手動で個別に採取してください。

インテリジェント統合管理データベースの保守資料を取得しない場合は，-iオプションを指定してツールを実行してください。

資料格納フォルダの直下に格納された資料のフォルダ構成および資料内容を次に示します。

表1‒39　物理ホストの一次資料の内部フォルダ構成

フォルダ名

格納された資料

資料格納フォルダ¥jp1_default¥imm_1st¥imm

JP1/IM - Managerの資料格納フォルダ

JP1/IM - Managerのパッチ情報

資料格納フォルダ¥jp1_default¥imm_1st¥imm¥conf

JP1/IM - Managerの設定および定義ファイル

資料格納フォルダ¥jp1_default¥imm_1st¥imm¥log

JP1/IM - Managerのログファイル

資料格納フォルダ¥jp1_default¥imm_1st¥cons

JP1/IM - Manager（セントラルコンソール）の資料格納フォルダ

資料格納フォルダ¥jp1_default¥imm_1st¥cons¥conf

JP1/IM - Manager（セントラルコンソール）の設定および定義ファイル

資料格納フォルダ¥jp1_default¥imm_1st¥cons¥default

JP1/IM - Manager（セントラルコンソール）の共通定義情報

資料格納フォルダ¥jp1_default¥imm_1st¥cons¥log

JP1/IM - Manager（セントラルコンソール）のログファイル

資料格納フォルダ¥jp1_default¥imm_1st¥scope

JP1/IM - Manager（セントラルスコープ）の資料格納フォルダ

資料格納フォルダ¥jp1_default¥imm_1st¥scope¥conf

JP1/IM - Manager（セントラルスコープ）の設定および定義ファイル

資料格納フォルダ¥jp1_default¥imm_1st¥scope¥default

JP1/IM - Manager（セントラルスコープ）の共通定義情報

資料格納フォルダ¥jp1_default¥imm_1st¥scope¥log

JP1/IM - Manager（セントラルスコープ）のログファイル

資料格納フォルダ¥jp1_default¥imm_1st¥coview

JP1/IM - Viewの資料格納フォルダ

JP1/IM - Viewのパッチ情報

資料格納フォルダ¥jp1_default¥imm_1st¥coview¥conf

JP1/IM - Viewの設定および定義ファイル

資料格納フォルダ¥jp1_default¥imm_1st¥coview¥default

JP1/IM - Viewの共通定義情報

資料格納フォルダ¥jp1_default¥imm_1st¥coview¥log

JP1/IM - Viewのログファイル

資料格納フォルダ¥jp1_default¥imm_1st¥imm¥Patchlog_jp1imm.txt

JP1/IM - Managerのパッチ情報

資料格納フォルダ¥jp1_default¥imm_1st¥imm¥conf¥tools

JP1/IM - Managerの設定および定義ファイル

資料格納フォルダ¥jp1_default¥imm_1st¥imm¥log¥operationlog

JP1/IM - Managerの操作ログ

資料格納フォルダ¥jp1_default¥imm_1st¥imcf¥conf¥imcf

IM構成管理の設定および定義ファイル

資料格納フォルダ¥jp1_default¥imm_1st¥imdb¥conf¥imdb

IMデータベースの設定および定義ファイル

資料格納フォルダ¥jp1_default¥imm_1st¥imcf¥system¥default¥new¥imcf

IM構成管理の共通定義情報

資料格納フォルダ¥jp1_default¥imm_1st¥imdb¥database¥imdb

IMデータベースのログの詳細情報

資料格納フォルダ¥jp1_default¥imm_1st¥imcf¥log¥imcf

IM構成管理のログファイル

資料格納フォルダ¥jp1_default¥imm_1st¥imdb¥log¥imdb

IMデータベースのログファイル

資料格納フォルダ¥jp1_default¥imm_1st¥base

JP1/Baseの資料格納フォルダ

JP1/Baseのパッチ情報

資料格納フォルダ¥jp1_default¥imm_1st¥base¥conf

JP1/Baseの設定および定義ファイル

資料格納フォルダ¥jp1_default¥imm_1st¥base¥default

JP1/Baseの共通定義情報

資料格納フォルダ¥jp1_default¥imm_1st¥base¥log

JP1/Baseのログファイル

資料格納フォルダ¥jp1_default¥imm_1st¥base¥plugin¥conf

JP1/Baseのプラグインサービスの設定ファイル

資料格納フォルダ¥jp1_default¥imm_1st¥base¥sys¥tmp

JP1/Baseのログおよびテンポラリファイル

資料格納フォルダ¥jp1_default¥imm_1st¥oslog

OSのログ情報

資料格納フォルダ¥jp1_default¥imm_1st¥spool

32bit版の統合トレースログ

資料格納フォルダ¥jp1_default¥imm_1st¥spoolx64

64bit版の統合トレースログ

資料格納フォルダ¥jp1_default¥imm_1st¥imdd

JP1/IM - Manager（インテリジェント統合管理基盤）の資料格納フォルダ

資料格納フォルダ¥jp1_default¥imm_1st¥imdd¥conf

JP1/IM - Manager（インテリジェント統合管理基盤）の設定および定義ファイル

資料格納フォルダ¥jp1_default¥imm_1st¥imdd¥log

JP1/IM - Manager（インテリジェント統合管理基盤）のログファイル

資料格納フォルダ¥jp1_default¥imm_1st¥imdd¥plugin

JP1/IM - Manager（インテリジェント統合管理基盤）のプラグイン

資料格納フォルダ¥jp1_default¥imm_1st¥imdd¥log¥suggestion

JP1/IM - Manager（インテリジェント統合管理基盤）の対処アクション実行履歴ファイル

資料格納フォルダ¥jp1_default¥imm_1st¥imgndb¥conf

インテリジェント統合管理データベースの設定および定義ファイル

資料格納フォルダ¥jp1_default¥imm_1st¥imgndb¥log

インテリジェント統合管理データベースのログファイル

表1‒40　物理ホストの二次資料の内部フォルダ構成

フォルダ名

格納された資料

資料格納フォルダ¥jp1_default¥imm_2nd¥cons

JP1/IM - Manager（セントラルコンソール）の資料格納フォルダ

資料格納フォルダ¥jp1_default¥imm_2nd¥cons¥operation¥evgen

JP1/IM - Manager（セントラルコンソール）の相関イベント発行履歴ファイル

資料格納フォルダ¥jp1_default¥imm_2nd¥cons¥operation¥comexclude

JP1/IM - Manager（セントラルコンソール）の共通除外履歴ファイルおよび共通除外条件定義履歴ファイル

資料格納フォルダ¥jp1_default¥imm_2nd¥scope

JP1/IM - Manager（セントラルスコープ）の資料格納フォルダ

資料格納フォルダ¥jp1_default¥imm_2nd¥scope¥database

JP1/IM - Manager（セントラルスコープ）のDB情報

資料格納フォルダ¥jp1_default¥imm_2nd¥base

JP1/Baseの資料格納フォルダ

資料格納フォルダ¥jp1_default¥imm_2nd¥base¥log¥COMMAND

JP1/Baseのコマンド実行履歴ファイル

資料格納フォルダ¥jp1_default¥imm_2nd¥base¥sys¥event¥servers¥default

JP1/BaseのイベントDB

資料格納フォルダ¥jp1_default¥imm_2nd¥oslog

Windowsイベントログ

資料格納フォルダ¥jp1_default¥imm_2nd¥imcf¥data¥imcf

IM構成管理のデータファイル

資料格納フォルダ¥jp1_default¥imm_2nd¥imdb¥database¥imdb¥imdbbackup.dat

IMデータベースのバックアップファイル

資料格納フォルダ¥jp1_default¥imm_2nd¥imdd¥data¥imdd

JP1/IM - Manager（インテリジェント統合管理基盤）のデータファイル

資料格納フォルダ¥jp1_default¥imm_2nd¥imgndb¥database¥imgndb

インテリジェント統合管理データベースのデータファイル

表1‒41　論理ホストの一次資料の内部フォルダ構成

フォルダ名

格納された資料

資料格納フォルダ¥論理ホスト名¥imm_1st¥cons

JP1/IM - Manager（セントラルコンソール）の論理ホストの資料格納フォルダ

資料格納フォルダ¥論理ホスト名¥imm_1st¥cons¥conf

JP1/IM - Manager（セントラルコンソール）の論理ホストの設定および定義ファイル

資料格納フォルダ¥論理ホスト名¥imm_1st¥cons¥log

JP1/IM - Manager（セントラルコンソール）の論理ホストのログファイル

資料格納フォルダ¥論理ホスト名¥imm_1st¥scope

JP1/IM - Manager（セントラルスコープ）の論理ホストの資料格納フォルダ

資料格納フォルダ¥論理ホスト名¥imm_1st¥scope¥conf

JP1/IM - Manager（セントラルスコープ）の論理ホストの設定および定義ファイル

資料格納フォルダ¥論理ホスト名¥imm_1st¥scope¥log

JP1/IM - Manager（セントラルスコープ）の論理ホストのログファイル

資料格納フォルダ¥論理ホスト名¥imm_1st¥base

JP1/Baseの論理ホストの資料格納フォルダ

資料格納フォルダ¥論理ホスト名¥imm_1st¥base¥conf

JP1/Baseの論理ホスト名の設定および定義ファイル

資料格納フォルダ¥論理ホスト名¥imm_1st¥base¥event

JP1/Baseの論理ホストのイベントサーバ設定

資料格納フォルダ¥論理ホスト名¥imm_1st¥base¥log

JP1/Baseの論理ホストのログファイル

資料格納フォルダ¥論理ホスト名¥imm_1st¥oslog

OSのログ情報

資料格納フォルダ¥論理ホスト名¥imm_1st¥imm¥Patchlog_jp1imm.txt

JP1/IM - Managerのパッチ情報

資料格納フォルダ¥論理ホスト名¥imm_1st¥imm¥log¥operationlog

JP1/IM - Managerの操作ログ

資料格納フォルダ¥論理ホスト名¥imm_1st¥imcf¥conf¥imcf

IM構成管理の設定および定義ファイル

資料格納フォルダ¥論理ホスト名¥imm_1st¥imdb¥database¥imdb

IMデータベースのログの詳細情報

資料格納フォルダ¥論理ホスト名¥imm_1st¥imcf¥log¥imcf

IM構成管理のログファイル

資料格納フォルダ¥論理ホスト名¥imm_1st¥imdb¥log¥imdb

IMデータベースのログファイル

資料格納フォルダ¥論理ホスト名¥imm_1st¥imdd

JP1/IM - Manager（インテリジェント統合管理基盤）の資料格納フォルダ

資料格納フォルダ¥論理ホスト名¥imm_1st¥imdd¥conf

JP1/IM - Manager（インテリジェント統合管理基盤）の設定および定義ファイル

資料格納フォルダ¥論理ホスト名¥imm_1st¥imdd¥log

JP1/IM - Manager（インテリジェント統合管理基盤）のログファイル

資料格納フォルダ¥論理ホスト名¥imm_1st¥imdd¥plugin

JP1/IM - Manager（インテリジェント統合管理基盤）のプラグイン

資料格納フォルダ¥論理ホスト名¥imm_1st¥imdd¥log¥suggestion

JP1/IM - Manager（インテリジェント統合管理基盤）の対処アクション実行履歴ファイル

資料格納フォルダ¥論理ホスト名¥imm_1st¥imgndb¥conf

インテリジェント統合管理データベースの設定および定義ファイル

資料格納フォルダ¥論理ホスト名¥imm_1st¥imgndb¥log

インテリジェント統合管理データベースのログファイル

表1‒42　論理ホストの二次資料の内部フォルダ構成

フォルダ名

格納された資料

資料格納フォルダ¥論理ホスト名¥imm_2nd¥cons

JP1/IM - Manager（セントラルコンソール）の論理ホストの資料格納フォルダ

資料格納フォルダ¥論理ホスト名¥imm_2nd¥cons¥operation¥evgen

JP1/IM - Manager（セントラルコンソール）の論理ホストの相関イベント発行履歴ファイル

資料格納フォルダ¥論理ホスト名¥imm_2nd¥cons¥operation¥comexclude

JP1/IM - Manager（セントラルコンソール）の論理ホストの共通除外履歴ファイルおよび共通除外条件定義履歴ファイル

資料格納フォルダ¥論理ホスト名¥imm_2nd¥scope

JP1/IM - Manager（セントラルスコープ）の論理ホストの資料格納フォルダ

資料格納フォルダ¥論理ホスト名¥imm_2nd¥scope¥database

JP1/IM - Manager（セントラルスコープ）の論理ホストのDB情報

資料格納フォルダ¥論理ホスト名¥imm_2nd¥base

JP1/Baseの論理ホストの資料格納フォルダ

資料格納フォルダ¥論理ホスト名¥imm_2nd¥base¥log¥COMMAND

JP1/Baseの論理ホストのコマンド実行履歴ファイル

資料格納フォルダ¥論理ホスト名¥imm_2nd¥base¥event

JP1/Baseの論理ホストのイベントDB

資料格納フォルダ¥論理ホスト名¥imm_2nd¥imcf¥data¥imcf

IM構成管理のデータファイル

資料格納フォルダ¥論理ホスト名¥imm_2nd¥imdb¥database¥imdb¥imdbbackup.dat

IMデータベースのバックアップファイル

資料格納フォルダ¥論理ホスト名¥imm_2nd¥imdd¥data¥imdd

JP1/IM - Manager（インテリジェント統合管理基盤）の論理ホストのデータファイル

資料格納フォルダ¥論理ホスト名¥imm_2nd¥imgndb¥database¥imgndb

インテリジェント統合管理データベースの論理ホストのデータファイル

形式

jim_log.bat -f 資料格納フォルダ
            [-h 論理ホスト名]
            [-t]
            [-n]
            [-p]
            [-r]
            [-g]
            [-a]
            [-s]
            [-c]
            [-d]
            [-x]
            [-w]
            [-q]
            [-b]
            [-i]

-aオプションは，BJEXまたはJP1/ASと連携した場合に使用するオプションです。-aオプションの詳細については，マニュアル「JP1/Integrated Management 3 - Manager 運用ガイド」の「11.5.2　jim_log.bat（Windows限定）」を参照してください。

実行権限

Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

格納先ディレクトリ

Managerパス¥tools¥

引数

-f 資料格納フォルダ

採取した資料を出力するフォルダ名をフルパスまたはこのコマンドを実行した場所からの相対パス形式で指定します。パスに空白を含む場合は，「"」で囲んで指定します。このオプションは省略できません。

存在しないフォルダを指定した場合は，その名称でフォルダが新規作成されます。すでに存在するフォルダを指定した場合は，いったんそのフォルダを削除してから，指定したフォルダが作成されます。

-h 論理ホスト名

クラスタシステムで運用している場合に，論理ホスト名を指定します。このオプションを指定した場合，物理ホストと論理ホストの両方の資料を採取します。このオプションを省略した場合，物理ホストの資料だけ採取します。クラスタシステムを使用していない場合には指定は不要です。

なお，このコマンドでは環境変数JP1_HOSTNAMEの論理ホスト名は使用しません。このため，クラスタシステムで使用する場合には論理ホスト名を必ずこのオプションで指定してください。

-t

hostsおよびservicesファイルを採取しない場合に指定します。

-n

JP1/Baseの保守資料を採取しない場合に指定します。

-p

JP1/BaseのイベントDBを取得しない場合に指定します。

-r

JP1/Baseのコマンド実行履歴ファイルを採取しない場合に指定します。

-g

相関イベント発行履歴ファイルを採取しない場合に指定します。

-a

応答待ちイベント滞留ファイルを採取しない場合に指定します。

-s

JP1/IM - Manager（セントラルスコープ）の保守資料を採取しない場合に指定します。

-c

IM構成管理の保守資料を採取しない場合に指定します。

-d

IMデータベースの保守資料を採取しない場合に指定します。

-xオプションと同時に指定できません。

-x

IMデータベースのバックアップファイルを採取する場合に指定します。

-dオプションと同時に指定できません。

IMデータベースのバックアップファイルは，デフォルトで採取するIMデータベースの保守資料には含まれていません。IMデータベースサービスが起動していない場合は，保守資料を採取しません。IMデータベースサービスを起動したあと，資料採取ツールを再実行してください。なお，資料採取時にJP1/IM-Managerが起動していても採取できます。

-w

JP1/IM - Viewの保守資料を採取しない場合に指定します。

-q

ユーザー確認を省略してコマンドを実行する場合に指定します。

-b

インテリジェント統合管理基盤の保守資料を採取しない場合に指定します。

-i

インテリジェント統合管理データベースの保守資料を採取しない場合に指定します。

注意事項

このツールによって採取される資料の総容量は大きくなるため，このツールを実行する前に必要容量を見積もり，ご使用のマシンの空き容量を確認する必要があります。詳細については，マニュアル「JP1/Integrated Management 3 - Manager 運用ガイド」の「12.4　資料の採取方法」を参照してください。

このツールを複数同時に実行しないでください。資料が上書きされたり，採取できなかったりする場合があります。

採取するファイルが見つからない場合，「ファイルが見つかりません」などのメッセージが表示されることがありますが，対処の必要はありません。

JP1/BaseまたはJP1/IM - Managerが起動している場合，「共有違反です」などのメッセージが表示されることがありますが，対処の必要はありません。

資料を採取するツールの実行時は，ある程度の負荷（ディスクI/Oなど）が掛かります。

このツールを使用しないでサポートサービスへ資料を送付した場合や，資料を除外して送付した場合は，正確な調査ができないおそれがあります。

戻り値

0

正常終了

8

異常終了

使用例1

D:¥tempフォルダに物理ホストの資料と論理ホストhostAの資料を採取する場合

jim_log.bat -f D:¥temp -h hostA

出力結果は次のようになります。

KAVB8925-I The directory does not exists. ("D:¥temp¥jp1_default¥imm_1st")
           The directory will be created.
続行するには何かキーを押してください . . .
KAVB8925-I The directory does not exists. ("D:¥temp¥jp1_default¥imm_2nd")
           The directory will be created.
続行するには何かキーを押してください . . .
KAVB8925-I The directory does not exists. ("D:¥temp¥hostA¥imm_1st")
           The directory will be created.
続行するには何かキーを押してください . . .
KAVB8925-I The directory does not exists. ("D:¥temp¥hostA¥imm_2nd")
           The directory will be created.
続行するには何かキーを押してください . . .
KAVB8926-I Data acquisition processing will start.
KAVB8927-I Execution of the "D:¥Program Files¥Hitachi¥JP1IMM¥bin¥jimGetConfInfo.exe" command will start.
KAVB8921-I The information for JP1/IM - Manager will be acquired.
KAVB8921-I The physical host information will be acquired.
KAVB8922-I The physical host information has been acquired.
KAVB8922-I The information for JP1/IM - Manager has been acquired.
KAVB8921-I The information for JP1/IM - Central Console will be acquired.
KAVB8921-I The physical host information will be acquired.
KAVB8922-I The physical host information has been acquired.
KAVB8921-I The logical host (hostA) information will be acquired.
KAVB8922-I The logical host (hostA) information has been acquired.
KAVB8922-I The information for JP1/IM - Central Console has been acquired.
KAVB8921-I The information for JP1/IM - Central Scope will be acquired.
KAVB8921-I The physical host information will be acquired.
KAVB8922-I The physical host information has been acquired.
KAVB8921-I The logical host (hostA) information will be acquired.
KAVB8922-I The logical host (hostA) information has been acquired.
KAVB8922-I The information for JP1/IM - Central Scope has been acquired.
KAVB8921-I The information for JP1/Base will be acquired.
KAVB8921-I The physical host information will be acquired.
KAVB8922-I The physical host information has been acquired.
KAVB8921-I The logical host (hostA) information will be acquired.
KAVB8922-I The logical host (hostA) information has been acquired.
KAVB8922-I The information for JP1/Base has been acquired.
KAVB8921-I The information for JP1/IM - View will be acquired.
KAVB8922-I The information for JP1/IM - View has been acquired.
KAVB8928-I "D:¥Program Files¥Hitachi¥JP1IMM¥bin¥jimGetConfInfo.exe" execution is ended. (ERRORLEVEL=0)
KAVB8929-I The system information will be acquired. Please wait.
KAVB8927-I Execution of the "D:¥Program Files¥Hitachi¥JP1IMM¥bin¥jimGetMsInfo.exe" command will start.
KAVB8928-I "D:¥Program Files¥Hitachi¥JP1IMM¥bin¥jimGetMsInfo.exe" execution is ended. (ERRORLEVEL=0)
KAVB8922-I The system information has been acquired.
KAVB8929-I "Watson log and crash dump" will be acquired. Please wait.
KAVB8927-I Execution of the "D:¥Program Files¥Hitachi¥JP1IMM¥bin¥jimGetWtsnInfo.exe" command will start.
KAVB8928-I "D:¥Program Files¥Hitachi¥JP1IMM¥bin¥jimGetWtsnInfo.exe" execution is ended. (ERRORLEVEL=0)
KAVB8922-I "Watson log and crash dump" has been acquired.
KAVB8921-I Windows Eventlog(Application) will be acquired.
KAVB8927-I Execution of the "D:¥Program Files¥Hitachi¥JP1IMM¥bin¥jimGetEvLog.exe" command will start.
KAVB8928-I "D:¥Program Files¥Hitachi¥JP1IMM¥bin¥jimGetEvLog.exe" execution is ended. (ERRORLEVEL=0)
KAVB8922-I Windows Eventlog(Application) has been acquired.
KAVB8921-I Windows Eventlog(System) will be acquired.
KAVB8927-I Execution of the "D:¥Program Files¥Hitachi¥JP1IMM¥bin¥jimGetEvLog.exe" command will start.
KAVB8928-I "D:¥Program Files¥Hitachi¥JP1IMM¥bin¥jimGetEvLog.exe" execution is ended. (ERRORLEVEL=0)
KAVB8922-I Windows Eventlog(System) has been acquired.
KAVB8921-I The setup.ini of JP1/IM - Manager will be acquired.
KAVB8922-I The setup.ini of JP1/IM - Manager has been acquired.
KAVB8921-I The setup.ilg of JP1/IM - Manager will be acquired.
KAVB8922-I The setup.ilg of JP1/IM - Manager has been acquired.
KAVB8921-I The setup.ini of JP1/IM - View will be acquired.
KAVB8922-I The setup.ini of JP1/IM - View has been acquired.
KAVB8921-I The setup.ilg of JP1/IM - View will be acquired.
KAVB8922-I The setup.ilg of JP1/IM - View has been acquired.
KAVB8921-I The setup.ini of JP1/Base will be acquired.
KAVB8922-I The setup.ini of JP1/Base has been acquired.
KAVB8921-I The setup.ilg of JP1/Base will be acquired.
KAVB8922-I The setup.ilg of JP1/Base has been acquired.
KAVB8921-I The integrated trace log will be acquired.
KAVB8922-I The integrated trace log has been acquired.
KAVB8921-I The integrated installer log will be acquired.
KAVB8922-I The integrated installer log has been acquired.
KAVB8921-I The installer log file will be acquired.
KAVB8922-I The installer log file has been acquired.
KAVB8921-I The hosts will be acquired.
KAVB8922-I The hosts has been acquired.
KAVB8921-I The services will be acquired.
KAVB8922-I The services has been acquired.
KAVB8921-I The registry information will be acquired.
KAVB8922-I The registry information has been acquired.
KAVB8921-I The netstat information will be acquired.
KAVB8922-I The netstat information has been acquired.
KAVB8921-I The ipconfig information will be acquired.
KAVB8922-I The ipconfig information has been acquired.
KAVB8921-I The net start information will be acquired.
KAVB8922-I The net start information has been acquired.
KAVB8921-I The set information will be acquired.
KAVB8922-I The set information has been acquired.
KAVB8918-I The data was successfully acquired.

使用例2

存在しないD:¥tempフォルダに物理ホストの資料を採取するが，存在する論理ホストhostAを指定しなかった場合

jim_log.bat -f D:¥temp

出力結果は次のようになります。

KAVB8925-I The directory does not exists. ("D:¥temp")
           The directory will be created.
続行するには何かキーを押してください . . .
KAVB8925-I The directory does not exists. ("D:¥temp¥jp1_default¥imm_1st")
           The directory will be created.
続行するには何かキーを押してください . . .
KAVB8925-I The directory does not exists. ("D:¥temp¥jp1_default¥imm_2nd")
           The directory will be created.
続行するには何かキーを押してください . . .
KAVB8926-I Data acquisition processing will start.
KAVB8927-I Execution of the "D:¥Program Files¥Hitachi¥JP1IMM¥bin¥jimGetConfInfo.exe" command will start.
KAVB8921-I The information for JP1/IM - Manager will be acquired.
KAVB8921-I The physical host information will be acquired.
KAVB8922-I The physical host information has been acquired.
KAVB8922-I The information for JP1/IM - Manager has been acquired.
KAVB8921-I The information for JP1/IM - Central Console will be acquired.
KAVB8921-I The physical host information will be acquired.
KAVB8922-I The physical host information has been acquired.
KAVB8922-I The information for JP1/IM - Central Console has been acquired.
KAVB8921-I The information for JP1/IM - Central Scope will be acquired.
KAVB8921-I The physical host information will be acquired.
KAVB8922-I The physical host information has been acquired.
KAVB8922-I The information for JP1/IM - Central Scope has been acquired.
KAVB8921-I The information for JP1/Base will be acquired.
KAVB8921-I The physical host information will be acquired.
KAVB8922-I The physical host information has been acquired.
KAVB8922-I The information for JP1/Base has been acquired.
KAVB8921-I The information for JP1/IM - View will be acquired.
KAVB8922-I The information for JP1/IM - View has been acquired.
KAVB8928-I "D:¥Program Files¥Hitachi¥JP1IMM¥bin¥jimGetConfInfo.exe" execution is ended. (ERRORLEVEL=0)
KAVB8929-I The system information will be acquired. Please wait.
KAVB8927-I Execution of the "D:¥Program Files¥Hitachi¥JP1IMM¥bin¥jimGetMsInfo.exe" command will start.
KAVB8928-I "D:¥Program Files¥Hitachi¥JP1IMM¥bin¥jimGetMsInfo.exe" execution is ended. (ERRORLEVEL=0)
KAVB8922-I The system information has been acquired.
KAVB8929-I "Watson log and crash dump" will be acquired. Please wait.
KAVB8927-I Execution of the "D:¥Program Files¥Hitachi¥JP1IMM¥bin¥jimGetWtsnInfo.exe" command will start.
KAVB8928-I "D:¥Program Files¥Hitachi¥JP1IMM¥bin¥jimGetWtsnInfo.exe" execution is ended. (ERRORLEVEL=0)
KAVB8922-I "Watson log and crash dump" has been acquired.
KAVB8921-I Windows Eventlog(Application) will be acquired.
KAVB8927-I Execution of the "D:¥Program Files¥Hitachi¥JP1IMM¥bin¥jimGetEvLog.exe" command will start.
KAVB8928-I "D:¥Program Files¥Hitachi¥JP1IMM¥bin¥jimGetEvLog.exe" execution is ended. (ERRORLEVEL=0)
KAVB8922-I Windows Eventlog(Application) has been acquired.
KAVB8921-I Windows Eventlog(System) will be acquired.
KAVB8927-I Execution of the "D:¥Program Files¥Hitachi¥JP1IMM¥bin¥jimGetEvLog.exe" command will start.
KAVB8928-I "D:¥Program Files¥Hitachi¥JP1IMM¥bin¥jimGetEvLog.exe" execution is ended. (ERRORLEVEL=0)
KAVB8922-I Windows Eventlog(System) has been acquired.
KAVB8921-I The setup.ini of JP1/IM - Manager will be acquired.
KAVB8922-I The setup.ini of JP1/IM - Manager has been acquired.
KAVB8921-I The setup.ilg of JP1/IM - Manager will be acquired.
KAVB8922-I The setup.ilg of JP1/IM - Manager has been acquired.
KAVB8921-I The setup.ini of JP1/IM - View will be acquired.
KAVB8922-I The setup.ini of JP1/IM - View has been acquired.
KAVB8921-I The setup.ilg of JP1/IM - View will be acquired.
KAVB8922-I The setup.ilg of JP1/IM - View has been acquired.
KAVB8921-I The setup.ini of JP1/Base will be acquired.
KAVB8922-I The setup.ini of JP1/Base has been acquired.
KAVB8921-I The setup.ilg of JP1/Base will be acquired.
KAVB8922-I The setup.ilg of JP1/Base has been acquired.
KAVB8921-I The integrated trace log will be acquired.
KAVB8922-I The integrated trace log has been acquired.
KAVB8921-I The integrated installer log will be acquired.
KAVB8922-I The integrated installer log has been acquired.
KAVB8921-I The installer log file will be acquired.
KAVB8922-I The installer log file has been acquired.
KAVB8921-I The hosts will be acquired.
KAVB8922-I The hosts has been acquired.
KAVB8921-I The services will be acquired.
KAVB8922-I The services has been acquired.
KAVB8921-I The registry information will be acquired.
KAVB8922-I The registry information has been acquired.
KAVB8921-I The netstat information will be acquired.
KAVB8922-I The netstat information has been acquired.
KAVB8921-I The ipconfig information will be acquired.
KAVB8922-I The ipconfig information has been acquired.
KAVB8921-I The net start information will be acquired.
KAVB8922-I The net start information has been acquired.
KAVB8921-I The set information will be acquired.
KAVB8922-I The set information has been acquired.
KAVB8918-I The data was successfully acquired.
KAVB8934-I The following logical host(s) exist on this machine:
hostA
To acquire information about a logical host, execute "jim_log.bat -f output-directory-name -h logical-hostname".
続行するには何かキーを押してください . . .

jim_log.sh（UNIX限定）

機能

JP1/IM - Managerで障害が発生したときに資料を採取するためのツールです。JP1/IM - ManagerおよびJP1/Baseの保守資料，OSのシステム情報，統合トレースログなどを採取します。

このツールは，シェルスクリプトです。ユーザーによるカスタマイズはできません。

このツールを実行すると，資料を採取する対象ディレクトリまたはファイルを一次資料および二次資料に区分けし，指定した資料格納ディレクトリの直下でtarコマンドによってアーカイブしたあと，compressコマンドで圧縮したファイルを作成します。

一次資料は，障害時の切り分けや，軽度の障害の調査を目的に採取する資料です。必要最低限のログおよび設定ファイルを採取します。二次資料は，一次資料ではわからなかった障害をさらに調査するための詳細資料です。core解析情報，JP1/BaseのイベントDBなどを採取します。

systemd-coredumpのcoreファイル出力が有効になっている環境では，このツールの実行時にシステムに保持されているcoreファイル一覧の中から，JP1/IM - Managerのプロセスが出力したcoreファイルについて，採取対象のログファイルディレクトリにcoreファイルを取得します。

また，JP1/IM - Manager（セントラルコンソール）のコアダンプやスレッドダンプがある状態でjim_log.shコマンドを実行すると，メッセージKAVB8941-IまたはKAVB8942-Iを表示してコアダンプまたはスレッドダンプを削除するかどうかユーザーに問い合わせます。「y」または「yes」を入力した場合，コアダンプまたはスレッドダンプを削除します。

なお，このツールを使って採取できる資料の詳細については，マニュアル「JP1/Integrated Management 3 - Manager 運用ガイド」の「12.3　トラブル発生時に採取が必要な資料」を参照してください。

インテリジェント統合管理データベースを利用している場合は，インテリジェント統合管理データベース※に関する資料も採取できます。

注※

インテリジェント統合管理データベース自体のログは，このツールの採取対象外になります。マニュアル「JP1/Integrated Management 3 - Manager 運用ガイド」の「12.3.1(2)(b) JP1の情報」に記載しているケースに該当する場合は，手動で個別に採取してください。

インテリジェント統合管理データベースの保守資料を取得しない場合は，-iオプションを指定してツールを実行してください。

採取した資料を圧縮したファイルを次に示します。

表1‒43　採取した資料を圧縮したファイル

ファイル名

内容

jp1_default_imm_1st.tar.Z

物理ホストの一次資料を格納します。

jp1_default_imm_2nd.tar.Z

物理ホストの二次資料を格納します。

論理ホスト名_imm_1st.tar.Z※

論理ホストの一次資料を格納します。

論理ホスト名_imm_2nd.tar.Z※

論理ホストの二次資料を格納します。

注※　-hオプションで論理ホストを指定した場合にだけ作成されます。

圧縮されたファイルは，資料格納ディレクトリに格納されます。圧縮された各ファイルの内部ディレクトリ構成を次に示します。

表1‒44　物理ホストの一次資料の内部ディレクトリ構成

ディレクトリ名・ファイル名

格納された資料

./etc/opt/jp1base

JP1/Baseの自動起動および自動終了スクリプト

./etc/opt/jp1base/conf

JP1/Baseの設定および定義ファイル

./etc/opt/jp1base/default

JP1/Baseの共通定義情報

./etc/opt/jp1cons

JP1/IM - Manager（セントラルコンソール）の自動起動および自動終了スクリプト

./etc/opt/jp1cons/conf

JP1/IM - Manager（セントラルコンソール）の設定および定義ファイル

./etc/opt/jp1cons/default

JP1/IM - Manager（セントラルコンソール）の共通定義情報

./etc/opt/jp1imm/conf/tools

JP1/IM - Managerの設定および定義ファイル

./etc/opt/jp1imm/conf/imcf

IM構成管理の設定および定義ファイル

./etc/opt/jp1imm/conf/imdb

IMデータベースの設定および定義ファイル

./etc/opt/jp1imm/conf/imdd

JP1/IM - Manager（インテリジェント統合管理基盤）の設定および定義ファイル

./etc/opt/jp1imm/conf/imgndb

インテリジェント統合管理データベースの設定および定義ファイル

./etc/opt/jp1imm/plugin

JP1/IM - Manager（インテリジェント統合管理基盤）のプラグイン

./var/opt/jp1imm/log/suggestion

JP1/IM - Manager（インテリジェント統合管理基盤）の対処アクション実行履歴ファイル

./etc/opt/jp1imm/default/imcf

IM構成管理の共通定義情報

./etc/opt/jp1scope/conf

JP1/IM - Manager（セントラルスコープ）の設定および定義ファイル

./etc/opt/jp1scope/default

JP1/IM - Manager（セントラルスコープ）の共通定義情報

./opt/jp1/hcclibcnf

共通定義情報

./opt/jp1base

JP1/Baseのパッチ適用履歴およびパッチログ情報

./opt/jp1base/conf

JP1/Baseのプラグインサービスの設定ファイル

./opt/jp1imm

JP1/IM - Managerのパッチ適用履歴およびパッチログ情報

./var/opt/jp1base/log

JP1/Baseのログファイル

./var/opt/jp1base/sys/tmp

JP1/Baseのログおよびテンポラリファイル

./var/opt/hitachi/HNTRLib2/spool

統合トレースログ

./var/opt/jp1cons/log

JP1/IM - Manager（セントラルコンソール）のログファイル

./var/opt/jp1imm/database/imdb

IMデータベースのログの詳細情報

./var/opt/jp1imm/log/imcf

IM構成管理のログファイル

./var/opt/jp1imm/log/imdb

IMデータベースのログファイル

./var/opt/jp1imm/log/imdd

JP1/IM - Manager（インテリジェント統合管理基盤）のログファイル

./var/opt/jp1imm/log/imgndb

インテリジェント統合管理データベースのログファイル

./var/opt/jp1imm/log/_jp1_default/oslog

OSのログ情報

./var/opt/jp1imm/log/_jp1_default/operationlog

JP1/IM - Managerの操作ログ

./var/opt/jp1scope/log

JP1/IM - Manager（セントラルスコープ）のログファイル

表1‒45　物理ホストの二次資料の内部ディレクトリ構成

ディレクトリ名・ファイル名

格納された資料

./var/opt/jp1base/log/COMMAND

JP1/Baseのコマンド実行履歴ファイル

./var/opt/jp1base/sys/event/servers/default

JP1/BaseのイベントDB

./var/opt/jp1cons/operation/evgen

JP1/IM - Manager（セントラルコンソール）の相関イベント発行履歴ファイル

./var/opt/jp1cons/operation/comexclude

JP1/IM - Manager（セントラルコンソール）の共通除外履歴ファイルおよび共通除外条件定義履歴ファイル

./var/opt/jp1imm/log/_jp1_default/oslog

OSのログ情報

./var/opt/jp1imm/log/_jp1_default/core

コアファイル

./var/opt/jp1scope/database

JP1/IM - Manager（セントラルスコープ）のDB情報

./var/opt/jp1imm/data/imcf

IM構成管理のデータファイル

./var/opt/jp1imm/database/imdb/imdbbackup.dat

IMデータベースのバックアップファイル

./var/opt/jp1imm/data/imdd

JP1/IM - Manager（インテリジェント統合管理基盤）のデータファイル

./tmp/.JP1_SES*

./usr/tmp/jp1_ses

./usr/lib/jp1_ses/log

./usr/lib/jp1_ses/sys

./usr/bin/jp1_ses/jp*

./var/opt/jp1_ses

JP1/SES互換用ログ

表1‒46　論理ホストの一次資料の内部ディレクトリ構成

ディレクトリ名・ファイル名

格納された資料

./共有ディスク/jp1base/../event

JP1/Baseの論理ホストのイベントサーバ設定

./共有ディスク/jp1base/conf

JP1/Baseの論理ホストの設定および定義ファイル

./共有ディスク/jp1base/log

JP1/Baseの論理ホストのログファイル

./共有ディスク/jp1cons/conf

JP1/IM - Manager（セントラルコンソール）の論理ホストの設定および定義ファイル

./共有ディスク/jp1cons/log

JP1/IM - Manager（セントラルコンソール）の論理ホストのログファイル

./共有ディスク/jp1scope/conf

JP1/IM - Manager（セントラルスコープ）の論理ホストの設定および定義ファイル

./共有ディスク/jp1scope/log

JP1/IM - Manager（セントラルスコープ）の論理ホストのログファイル

./var/opt/jp1imm/log/_論理ホスト名/oslog

OSのログ情報

./var/opt/jp1imm/log/_論理ホスト名/operationlog

JP1/IM - Managerの操作ログ

./共有ディスク/jp1imm/conf/imcf

IM構成管理の設定および定義ファイル

./共有ディスク/jp1imm/conf/imdd

JP1/IM - Manager（インテリジェント統合管理基盤）の設定および定義ファイル

./共有ディスク/jp1imm/conf/imgndb

インテリジェント統合管理データベースの設定および定義ファイル

./var/opt/jp1imm/database/imdb

IMデータベースのログの詳細情報

./共有ディスク/jp1imm/log/imcf

IM構成管理のログファイル

./共有ディスク/jp1imm/log/imdd

JP1/IM - Manager（インテリジェント統合管理基盤）のログファイル

./共有ディスク/jp1imm/log/imgndb

インテリジェント統合管理データベースのログファイル

./共有ディスク/jp1imm/log/suggestion

JP1/IM - Manager（インテリジェント統合管理基盤）の対処アクション実行履歴ファイル

./var/opt/jp1imm/log/imdb

IMデータベースのログファイル

表1‒47　論理ホストの二次資料の内部ディレクトリ構成

ディレクトリ名・ファイル名

格納された資料

./共有ディスク/event

JP1/Baseの論理ホストのイベントDB

./共有ディスク/jp1base/log/COMMAND

JP1/Baseの論理ホストのコマンド実行履歴ファイル

./共有ディスク/jp1cons/operation/evgen

JP1/IM - Manager（セントラルコンソール）の論理ホストの相関イベント発行履歴ファイル

./共有ディスク/jp1cons/operation/comexclude

JP1/IM - Manager（セントラルコンソール）の論理ホストの共通除外履歴ファイルおよび共通除外条件定義履歴ファイル

./共有ディスク/jp1scope/database

JP1/IM - Manager（セントラルスコープ）の論理ホストのDB情報

./var/opt/jp1imm/log/_論理ホスト名/oslog

OSのログ情報

./var/opt/jp1imm/log/_論理ホスト名/core

コアファイル

./共有ディスク/jp1imm/data/imcf

IM構成管理のデータファイル

./共有ディスク/jp1imm/database/imdb/imdbbackup.dat

IMデータベースのバックアップファイル

./共有ディスク/jp1imm/data/imdd

JP1/IM - Manager（インテリジェント統合管理基盤）のデータファイル

形式

jim_log.sh -f 資料格納ディレクトリ
           [-h 論理ホスト名]
           [-t]
           [-u]
           [-n]
           [-p]
           [-r]
           [-g]
           [-a]
           [-s]
           [-c]
           [-d]
           [-x]
           [-q]
           [-b]
           [-i]
           [ディレクトリ名またはファイル名...]

-aオプションは，BJEXまたはJP1/ASと連携した場合に使用するオプションです。-aオプションの詳細については，マニュアル「JP1/Integrated Management 3 - Manager 運用ガイド」の「11.5.3　jim_log.sh（UNIX限定）」を参照してください。

実行権限

スーパーユーザー権限

格納先ディレクトリ

/opt/jp1imm/tools/

引数

-f 資料格納ディレクトリ

採取した資料を出力するディレクトリ名またはデバイス名をフルパスまたはルートディレクトリからの相対パス形式で指定します。ディレクトリ名を指定した場合，その下に採取した各資料を格納したファイルが作成されます。パスに空白を含む場合は，「"」で囲んで指定します。このオプションは省略できません。

存在しないディレクトリを指定した場合は，その名称でディレクトリが新規作成されます。すでに存在するディレクトリを指定した場合は，いったんそのディレクトリを削除してから，指定したディレクトリが作成されます。

デバイス名を指定した場合，作成したファイルの数だけデバイスに対して書き込みが発生します。また，テープなどのデバイスファイル名を指定した場合，採取した資料は圧縮されずにデバイスに格納されます。

デバイス名を指定し，かつ-qオプションを指定した場合，ユーザー確認に対しては「yes」を選択したものとして動作するので，あらかじめコマンドを実行する前にデバイスをセットしておく必要があります。

-h 論理ホスト名

クラスタシステムで運用している場合に，論理ホスト名を指定します。このオプションを指定した場合，物理ホストと論理ホストの両方の資料を採取します。このオプションを省略した場合，物理ホストの資料だけ採取します。クラスタシステムを使用していない場合には指定は不要です。

なお，このコマンドでは環境変数JP1_HOSTNAMEの論理ホスト名は使用しません。このため，クラスタシステムで使用する場合には論理ホスト名を必ずこのオプションで指定してください。

-t

hosts，services，およびpasswdファイルを採取しない場合に指定します。

-u

core解析情報を採取しない場合に指定します。core解析情報とは，coreダンプファイルをSeraphツールのcarコマンドで解析して取得したファイルです。

-n

JP1/Baseの保守資料を採取しない場合に指定します。

-p

JP1/BaseのイベントDBを取得しない場合に指定します。

-r

JP1/Baseのコマンド実行履歴ファイルを採取しない場合に指定します。

-g

相関イベント発行履歴ファイルを採取しない場合に指定します。

-a

応答待ちイベント滞留ファイルを採取しない場合に指定します。

-s

JP1/IM - Manager（セントラルスコープ）の保守資料を採取しない場合に指定します。

-c

IM構成管理の保守資料を採取しない場合に指定します。

-d

IMデータベースの保守資料を採取しない場合に指定します。

-xオプションと同時に指定できません。

-x

IMデータベースのバックアップファイルを採取する場合に指定します。

-dオプションと同時に指定できません。

IMデータベースのバックアップファイルは，デフォルトで採取するIMデータベースの保守資料には含まれていません。IMデータベースサービスが起動していない場合は，保守資料を採取しません。IMデータベースサービスを起動したあと，資料採取ツールを再実行してください。なお，資料採取時にJP1/IM-Managerが起動していても採取できます。

-q

ユーザー確認を省略してコマンドを実行する場合に指定します。

-b

インテリジェント統合管理基盤の保守資料を採取しない場合に指定します。

-i

インテリジェント統合管理データベースの保守資料を採取しない場合に指定します。

ディレクトリ名またはファイル名

資料採取ツールで任意のファイルまたはディレクトリを採取したいときに指定します。フルパス名で指定してください。複数指定する場合は，スペースで区切ってください。

なお，このオプションは，指定したいほかのオプションをすべて指定したあとに指定してください。採取した資料は物理ホストの一次資料に格納されます。

注意事項

このツールによって採取される資料の総容量は大きくなるため，このツールを実行する前に必要容量を見積もり，ご使用のマシンの空き容量を確認する必要があります。詳細については，マニュアル「JP1/Integrated Management 3 - Manager 運用ガイド」の「12.4　資料の採取方法」を参照してください。

このツールを複数同時に実行しないでください。資料が上書きされたり，採取できなかったりする場合があります。

資料を採取するツールの実行時は，ある程度の負荷（ディスクI/Oなど）が掛かります。

このツールを使用しないでサポートサービスへ資料を送付した場合や，資料を除外して送付した場合は，正確な調査ができないおそれがあります。

戻り値

0

正常終了

8

異常終了

使用例1

/tmp/jp1logに物理ホストの資料と論理ホストhostAの資料を採取する場合

jim_log.sh -f /tmp/jp1log -h hostA

出力結果は次のようになります。

KAVB8925-I The directory does not exist. (/var/opt/jp1imm/log/_jp1_default).
           The directory will be created.
KAVB8925-I The directory does not exist. (/var/opt/jp1imm/log/_hostA).
           The directory will be created.
KAVB8926-I Data acquisition processing will start.
KAVB8921-I The physical host's first material will be acquired.
KAVB8922-I The physical host's first material has been acquired.
KAVB8921-I The physical host's second material will be acquired.
KAVB8922-I The physical host's second material has been acquired.
KAVB8921-I The logical host(hostA)'s first material will be acquired.
KAVB8922-I The logical host(hostA)'s first material has been acquired.
KAVB8921-I The logical host(hostA)'s second material will be acquired.
KAVB8922-I The logical host(hostA)'s second material has been acquired.
KAVB8918-I The data was successfully acquired.

使用例2

存在しない/tmp/jp1log/に物理ホストの資料を採取するが，存在する論理ホストhostAを指定しなかった場合

jim_log.sh -f /tmp/jp1log

出力結果は次のようになります。

KAVB8925-I The directory does not exist. (/tmp/jp1log).
           The directory will be created.
KAVB8925-I The directory does not exist. (/var/opt/jp1imm/log/_jp1_default).
           The directory will be created.
KAVB8926-I Data acquisition processing will start.
KAVB8921-I The physical host's first material will be acquired.
KAVB8922-I The physical host's first material has been acquired.
KAVB8921-I The physical host's second material will be acquired.
KAVB8922-I The physical host's second material has been acquired.
KAVB8918-I The data was successfully acquired.
KAVB8935-I The following logical host(s) exist on this machine:
hostA
To acquire information about a logical host, execute "jim_log.sh -f output-directory-name -h logical-hostname".

使用例3

jp1_default_imm_1st.tar.Zおよびjp1_default_imm_2nd.tar.Zファイルが存在する/tmp/jp1log/に物理ホストの資料を採取するが，存在する論理ホストhostAを指定しなかった場合

jim_log.sh -f /tmp/jp1log

出力結果は次のようになります（すべて「y」と入力した場合）。

KAVB8925-I The directory does not exist. (/var/opt/jp1imm/log/_jp1_default).
           The directory will be created.
KAVB8926-I Data acquisition processing will start.
KAVB8921-I The physical host's first material will be acquired.
KAVB8922-I The physical host's first material has been acquired.
KAVB8921-I The physical host's second material will be acquired.
KAVB8944-I (/tmp/jp1log/jp1_default_imm_2nd.tar.Z) already exists. Do you want to overwrite it? [yes/no]y
KAVB8922-I The physical host's second material has been acquired.
KAVB8918-I The data was successfully acquired.
KAVB8944-I (/tmp/jp1log/jp1_default_imm_1st.tar.Z) already exists. Do you want to overwrite it? [yes/no]y
KAVB8935-I The following logical host(s) exist on this machine:
hostA
To acquire information about a logical host, execute "jim_log.sh -f output-directory-name -h logical-hostname".

jimasecret

機能

指定されたシークレットを難読化してシークレット管理ファイルに登録するコマンドです。登録したシークレットは，JP1/IM - Agentのサービスが読み込んで利用します。

このコマンドで設定できるシークレットについては，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「3.15.10 シークレット難読化機能」を参照してください。

形式

シークレットを登録したキーを一覧表示する場合

jimasecret -list
                   [-l 共有ディレクトリ]

キーを指定してシークレットを追加または更新する場合

jimasecret -add
                   -key キー名
                   -s シークレット
                   [-l 共有ディレクトリ]

キーを指定してシークレットを削除する場合

jimasecret -rm
                   -key キー名
                   [-l 共有ディレクトリ]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

Linuxの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Agentパス¥tools¥

Linuxの場合

/opt/jp1ima/tools/

引数

-list

登録したシークレットのキーを一覧表示します。シークレットは表示しません。

-add，-rmオプションと同時に指定できません。

-add

キーを指定して新しいシークレットを登録します。

すでに登録済みのキーを指定した場合は，シークレットを上書きします。このとき，上書きの確認はしません。

登録できるシークレットは1,000個までです。

このオプションを指定する場合は，-keyおよび-sオプションも必須で指定します。

-list，-rmオプションと同時に指定できません。

-rm

キーを指定して登録済みのシークレットを削除します。

存在しないキーを指定した場合は，エラーとなります。

このオプションを指定する場合は，-keyオプションも必須で指定します。

-list，-addオプションと同時に指定できません。

-key キー名

追加，変更，削除するシークレットのキー名を指定します。

指定できる文字は，ASCIIコードの0x20〜0x7eの文字です。

指定できる長さは，最大1,024文字です。

具体的なキーの書式を次に示します。

■接続先のマネージャーの情報

マネージャーホストへ接続するためのプロキシーパスワードのキー

immgr.proxy_user.認証ID

認証IDには，imagent設定ファイル（jpc_imagent.json）のimmgr.proxy_userに指定したユーザーIDを指定します。

■マネージャーホストへ接続するための初期シークレットのキー

immgr.initial_secret

■マネージャーホストへ接続するためのクライアントシークレットのキー

immgr.client_secret

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

アクション実行で使用する実行ユーザーのパスワードを登録するためのキー

action.user.<ユーザー名>

ユーザー名にはimagent設定ファイル（jpc_imagent.json）のaction.usernameに指定したユーザーを指定します。

Windowsのみ有効です。Linuxの場合，設定しても無視されます。

重要

-keyに指定した値が正しい書式であるかのチェックは行われません。

メモ

クライアントシークレットは，ユーザーが手動で削除する場合にだけ指定します。

■Blackbox exporterの場合

プロキシ認証のパスワードを登録するときのキー

Blackbox.モジュール名.proxy_user.認証ID

モジュール名には，Blackbox exporter設定ファイル（jpc_blackbox_exporter.yml）に指定したモジュール名を指定します。

認証IDには，Blackbox exporter設定ファイル（jpc_blackbox_exporter.yml）のproxy_userに指定したユーザーIDを指定します。

監視対象Webサーバのパスワードを登録するときのキー

Blackbox.モジュール名.basic_auth.認証ID

モジュール名には，Blackbox exporter設定ファイル（jpc_blackbox_exporter.yml）に指定したモジュール名を指定します。

認証IDには，Blackbox exporter設定ファイル（jpc_blackbox_exporter.yml）のbasic_auth.usernameに指定したユーザーIDを指定します。

監視対象WebサーバのBearerトークンを登録するときのキー

Blackbox.モジュール名.bearer_token

モジュール名には，Blackbox exporter設定ファイル（jpc_blackbox_exporter.yml）に指定したモジュール名を指定します。

■Primitorの場合

Resource Discoveryのクライアントシークレットを登録するときのキー

Promitor.resource_discovery.env.AUTH_APPKEY

Scraperのクライアントシークレットのキーを登録するときのキー

Promitor.scraper.env.AUTH_APPKEY

■OracleDB exporterの場合

Oracle Databaseに接続するためのパスワードを登録するキーには，次に示す2種類のキーがあります。

Oracle Databaseに接続するためのパスワードのキー（ユーザー名を指定する形式）

OracleDB.user.ユーザー名

・ユーザー名

環境変数DATA_SOURCE_NAMEに設定しているユーザー名を指定します。大文字小文字を合わせてください。

Oracle Databaseに接続するためのパスワードのキー（ホスト名，リスナーサービス名，ユーザー名を指定する形式）

OracleDB.host.ホスト名.listener.リスナーサービス名.user.ユーザー名

・ホスト名

環境変数DATA_SOURCE_NAMEのOracle Databaseサーバーのホスト名を指定します。大文字小文字を合わせてください。

・リスナーサービス名

環境変数DATA_SOURCE_NAMEのサービス名を指定します。大文字小文字を合わせてください。

・ユーザー名

環境変数DATA_SOURCE_NAMEに設定しているユーザー名を指定します。大文字小文字を合わせてください。

通常は，「ユーザー名を指定する形式」のキーを使用します。

同じユーザー名のユーザーが複数存在，かつ，異なるパスワードを設定して運用しているような環境の場合は，「サーバ名，リスナーサービス名，ユーザー名を指定する形式」のキーを使用して，Oracle Databaseホストやサービスごとにパスワードを設定する必要があります。

OracleDB exporterは，環境変数DATA_SOURCE_NAMEの値から，ホスト名，リスナーサービス名，ユーザー名の値を取得します。取得した値から「ユーザー名を指定する形式」のキー，および，「サーバ名，リスナーサービス名，ユーザー名を指定する形式」のキーを構成して，登録済みのパスワードを検索します。両方の形式でパスワードを取得できた場合は，「サーバ名，リスナーサービス名，ユーザー名を指定する形式」のキーを使用します。

-s シークレット

追加または更新するシークレット（パスワード）を指定します。

指定できる文字は，ASCIIコードの0x20〜0x7eの文字です。

指定できる長さは，最大1,024文字です。

-l 共有ディレクトリ

論理ホスト環境を対象にする場合は，論理ホストの共有ディレクトリを指定します。

相対パスまたは絶対パスで指定します。

指定できるパスの長さは63バイトまでです。

文字種のチェックは行われません。

注意事項

-keyに指定した値が正しい書式であるかのチェックは行いません。

戻り値

0

正常終了

1

異常終了（ユーザー起因のエラー）

2

異常終了（その他のエラー）

ログの出力

出力先

■Windowsの場合

Agentパス¥logs¥tools¥

■Linuxの場合

/opt/jp1ima/logs/tools/

使用例

シークレットを登録する場合

> jimasecret -add -key Blackbox.http1.proxy_user.p-user01 -s password01

シークレットを削除する場合

> jimasecret -rm -key Blackbox.http1.proxy _user.p-user01

登録済みのキーを一覧表示する場合

> jimasecret -list
Blackbox.http1.proxy_user.p-user01
Blackbox.http1.basic_auth.w-user01
immgr.proxy_user.user01

jimasetup

機能

JP1/IM - Agentの初期設定を行うコマンドです。

形式

jimasetup { phost | container }

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

Linuxの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Agentパス¥tools¥

Linuxの場合

/opt/jp1ima/tools/

引数

phost

物理ホストで稼働させる場合に，このオプションを指定すると，物理ホストで稼働させるための初期設定を行います。

通常ホストの構築でJP1/IM - Agentをインストールした場合は，インストーラーからjimasetup phostコマンドが実行されます。

AWS/EC2の仮想マシンイメージを作成した場合，AWS/EC2のAuto Scalingのスクリプトから，このコマンドをphostオプション指定で実行してからサービスを起動するようにします。

containerオプションと同時に指定できません。

container

コンテナイメージを作成した場合，コンテナが実行するスクリプトから，このコマンドをcontainerオプション指定で実行してからサービスを起動するようにします。

phostオプションと同時に指定できません。

戻り値

0

正常終了

1

異常終了

ログの出力

出力先

■Windowsの場合

Agentパス¥logs¥tools¥

■Linuxの場合

/opt/jp1ima/logs/tools/

使用例

AWS/EC2のAuto Scalingのスクリプトでの指定例

■Windowsの場合

<script>
Agentパス¥tools¥jimasetup phost
Agentパス¥tools¥jpc_service_start -s all
</script>

■Linuxの場合

#!/bin/sh
/opt/jp1ima/tools/jimasetup phost
/opt/jp1ima/tools/jpc_service_start -s all

コンテナが実行するスクリプトでの指定例

■Linuxの場合

#!/bin/bash
/opt/jp1ima/tools/jimasetup container※1
exec /usr/local/bin/supervisord -c /opt/supervisord.conf※2

注※1　初期設定コマンドをcontainerオプション指定で実行

注※2　サービス管理ツールを実行

注意事項

このコマンドを同時に複数実行しないでください。同時に実行すると，コマンドが正常終了しても，不正な結果になっていることがあります。

このコマンドは，必ずすべてのJP1/IM - Agentのサービスを停止した状態で実行してください。JP1/IM - Agentのサービスが起動している状態で実行すると，更新対象のファイルにロックが掛かってファイルの更新に失敗することがあります。

このコマンドは，必ずテキストエディタなどで定義ファイルを開いていない状態で実行してください。テキストエディタなどで定義ファイルを編集している状態で実行すると，更新対象のファイルにロックが掛かってファイルの更新に失敗することがあります。

jimdbbackup

機能

IMデータベースをバックアップするコマンドです。バックアップの用途と取得できるデータの種類を次に示します。

障害復旧用バックアップ

データベースの障害が発生した際にデータベースを復旧するため，定期的にデータをバックアップします。バックアップ対象は，データベース内の統合監視DB領域，IM構成管理DB領域，およびシステムDB領域です。

拡張用バックアップ

データベースのサイズ拡張をするために，一時退避するためのデータをバックアップします。バックアップ対象は，データベース内の統合監視DB領域，IM構成管理DB領域です。

形式

jimdbbackup -o バックアップファイル名
            -m {MAINT|EXPAND}
              [-h 論理ホスト名]
              [-q]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Managerパス¥bin¥imdb¥

UNIXの場合

/opt/jp1imm/bin/imdb/

引数

-o バックアップファイル名

バックアップするデータベースを出力するファイル名を絶対パス形式で指定します。バックアップファイルは，ローカルドライブを指定してください。このオプションは省略できません。

ネットワークドライブが指定された場合，UNCパスが指定された場合，およびWindowsで予約デバイスファイルが指定された場合はエラーとなります。指定したバックアップファイルがすでに存在する場合は，上書きされます。

バックアップファイル名にはファイルパスを含めて指定してください。使用できる文字は半角英数字とアンダースコア「_」，ドット「.」，シャープ「#」，アットマーク「@」です。文字はOSに依存し，半角スペース「 」または丸括弧「(」，「)」を含む場合は，前後を引用符「"」で囲む必要があります。Windowsの場合，MAINT指定時のバックアップファイル名はすべて小文字となります。また，ファイル名の最大長はOSの制限に従います。

指定されたバックアップファイルを格納するディレクトリが存在しない場合は，コマンドの実行に失敗します。コマンドを実行する前に，必ずディレクトリを作成してください。

-m {MAINT | EXPAND}

データベースのバックアップ形式を指定します。半角英大文字です。このオプションは省略できません。

MAINT：障害復旧用バックアップを実行します。

EXPAND：拡張用バックアップを実行します。

-h 論理ホスト名

クラスタシステムで運用している場合に，コマンドを実行するホストの論理ホスト名を指定します。指定した論理ホストに対応するデータベースをバックアップします。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。クラスタシステムを使用していない場合には指定は不要です。なお，論理ホスト名にJP1_DEFAULTは指定できません。また，論理ホスト名は，大文字・小文字を区別します。

-q

ユーザー確認を省略してコマンドを実行する場合に指定します。

戻り値

0

バックアップが正常終了した

1

バックアップが異常終了した

注意事項

このコマンドを実行する前に，このコマンドとjimdbrecoveryコマンドの実行条件を満たすことを確認してください。

このコマンドの実行中にほかのJP1/IM - Managerのコマンドを実行したりJP1/IM - Managerのサービスを起動したりしないでください。このコマンドは障害復旧用バックアップの場合にデータベースを参照・更新禁止モードに変更するため，実行に失敗することがあります。

このコマンドの実行中に［Ctrl］+［C］キーや［Ctrl］+［Break］キーは押さないでください。バックアップをバックグラウンドで実行するため，［Ctrl］+［C］キーや［Ctrl］+［Break］キーを押してもバックアップ処理は継続されます。［Ctrl］+［C］キーや［Ctrl］+［Break］キーを押したあと，すぐにほかのJP1/IM - Managerコマンドを実行したり，JP1/IM - Manager全体のサービスを起動したりすると，コマンドの実行やサービスの起動に失敗することがあります。

コマンド実行中に［Ctrl］+［C］キーや［Ctrl］+［Break］キーで処理を中止した場合，次のプロセスが実行されていないことを確認してからコマンドを再実行してください。

障害復旧用バックアップの場合はpdcopyプロセス

拡張用バックアップの場合はpdrorgプロセス

このコマンドの実行時にバックアップファイルが作成されます。拡張用バックアップの場合，または障害復旧用バックアップの場合，バックアップファイルの出力先のドライブ空き容量は，DBサイズがSのときに最大2ギガバイト，Mのときに最大15ギガバイト，Lのときに最大50ギガバイト程度必要です。

IMデータベースを使用している場合，JP1/IM-Managerが停止している必要があります。

Windowsの場合，IMデータベースサービス（JP1/IM3-Manager DB Server）が起動している必要があります。また，IMデータベースのクラスタサービス（JP1/IM3-Manager DB Cluster Service_論理ホスト名）が停止している必要があります。

バックアップファイルは，復旧用と拡張用の区別ができないため，ファイル名にそれぞれが区別できる文字を指定することを推奨します。

バックアップファイルのアクセス権は，ユーザーがアクセスできる状態で出力されます。バックアップ取得後，アクセス権を変更するか，ユーザーがアクセスできない場所へ移動することを推奨します。

JP1/IM - MOを使用している場合は，接続元のJP1/IM - MOのJP1/IM - Message Optimizerサービスが停止している必要があります。

Windowsの場合，Application Experienceサービスが存在する場合は，Application Experienceサービスのスタートアップの種類が無効になっていないことを確認してからコマンドを実行してください。

障害復旧用バックアップを実行する場合は，インテリジェント統合管理データベースのバックアップも合わせて検討してください。

jimdbreclaim

機能

IM構成管理DBの使用中の空き領域（空きページ領域）を解放するコマンドです。

IM構成管理DBで大量のホストを削除すると，そのデータを格納している領域の一部が使用中の空き領域になることがあります。このコマンドを実行すると，使用中の空き領域を未使用の空き領域にして再利用できます。

また，JP1/IM-Managerサービスを停止しないで，運用中に実行できます。

形式

jimdbreclaim [-h 論理ホスト名]
             [-q]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Managerパス¥bin¥imdb¥

UNIXの場合

/opt/jp1imm/bin/imdb/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，コマンドを実行するホストの論理ホスト名を指定します。指定した論理ホストに対応するIM構成管理DBの空き領域を解放します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。クラスタシステムを使用していない場合には指定は不要です。なお，論理ホスト名にJP1_DEFAULTは指定できません。また，論理ホスト名は，大文字・小文字を区別します。

-q

ユーザー確認を省略してコマンドを実行する場合に指定します。

戻り値

0

正常終了

1

異常終了

注意事項

このコマンドはIM構成管理DBで大量のホストの追加，削除を繰り返さない場合は実行する必要がありません。

このコマンドの実行中に，ほかのJP1/IM - Managerのコマンドを実行しないでください。実行が失敗することがあります。

このコマンドの実行中はCPUが高負荷状態になるため，参照・更新の頻度が低い夜間などの時間帯に実行することをお勧めします。

このコマンドの実行中に［Ctrl］+［C］キーや［Ctrl］+［Break］キーを押して処理を中止した場合，データベースの空き領域解放に失敗することがあります。コマンドを再実行するには，別プロセスが動作している場合があるため，pdreclaimとpdrorgプロセスが実行されていないことを確認してください。これらのプロセスが実行中の場合，しばらく時間をおいてから再確認してください。

このコマンドの実行中にデータベースサービスを停止しないでください。

実行中にデータベースサービスを停止した場合は，データベースサービスを起動後にコマンドの再実行が必要です。

Windowsの場合，IMデータベースサービス「JP1/IM3-Manager DB Server」が起動している必要があります。

Windowsの場合，Application Experienceサービスが存在する場合は，Application Experienceサービスのスタートアップの種類が無効になっていないことを確認してからコマンドを実行してください。

jimdbrecovery

機能

バックアップで保管しておいたデータベースを復旧（リカバリー）するコマンドです。リカバリーできるデータの種類を次に示します。

障害復旧用リカバリー

データベースの障害が発生した際に，定期的に取得しているバックアップデータを利用してデータベースを復旧します。

拡張用リカバリー

データベースのサイズ拡張をするために，一時退避するためのデータをバックアップします。

形式

jimdbrecovery -i バックアップファイル名
                -m {MAINT|EXPAND}
                [-h 論理ホスト名]
                [-q]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Managerパス¥bin¥imdb¥

UNIXの場合

/opt/jp1imm/bin/imdb/

引数

-i バックアップファイル名

jimdbbackupコマンドを用いてバックアップしたデータベースのファイル名を絶対パス形式で指定します。ファイル名に使用できる文字は，半角英数字とアンダースコア「_」，ドット「.」，シャープ「#」，アットマーク「@」です。バックアップファイルには，ローカルドライブを指定します。このオプションは省略できません。

ネットワークドライブが指定された場合，UNCパスが指定された場合，およびWindowsで予約デバイスファイルが指定された場合はエラーとなります。

-m {MAINT|EXPAND}

データベースのリカバリー形式を指定します。指定できる文字は，半角英大文字です。このオプションは省略できません。

MAINT：障害復旧用リカバリーを実行します。

EXPAND：拡張用リカバリーを実行します。

障害復旧用リカバリーを実行する場合，障害復旧用バックアップで採取したバックアップファイルを指定してください。また，拡張用リカバリーを実行する場合，拡張用バックアップで採取したバックアップファイルを指定してください。指定した引数とバックアップファイルの種別が異なる場合は，エラーとなります。

-h 論理ホスト名

クラスタシステムで運用している場合に，コマンドを実行するホストの論理ホスト名を指定します。指定した論理ホストに対するデータベースがリカバリーされます。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。クラスタシステムを使用していない場合には指定は不要です。なお，論理ホスト名にJP1_DEFAULTは指定できません。また，論理ホスト名は，大文字・小文字を区別します。

-q

ユーザー確認を省略してコマンドを実行する場合に指定します。

戻り値

0

リカバリーが正常終了した

1

リカバリーが異常終了した

注意事項

jimdbbackupコマンドで取得したバックアップデータをjimdbrecoveryコマンドでリカバリーする場合は，バックアップを取得したときと同じOSで実施してください。異なるOSのデータベースにリカバリーした場合は，動作は保証できません。

このコマンドの実行中に，ほかのJP1/IM - Managerのコマンドの実行やJP1/IM - Managerのサービス起動をしないでください。このコマンドはデータベースの参照・更新を禁止モードに変更するため，実行に失敗するおそれがあります。

このコマンドの実行中に［Ctrl］+［C］キーや［Ctrl］+［Break］キーは押さないでください。リカバリーをバックグラウンドで実行するため，［Ctrl］+［C］キーや［Ctrl］+［Break］キーを押してもリカバリー処理は継続されます。［Ctrl］+［C］キーや［Ctrl］+［Break］キーを押したあと，すぐにほかのJP1/IM - Managerコマンドを実行したり，JP1/IM - Managerのサービスを起動したりすると，コマンドの実行やサービスの起動に失敗することがあります。

コマンド実行中に［Ctrl］+［C］キーや［Ctrl］+［Break］キーでコマンドの実行を途中で停止した場合，障害復旧用リカバリーではpdrstrプロセスが実行されていないことを確認してからJP1/IM - Managerを再起動してください。拡張用リカバリーではpdrorgプロセスが実行されていないことを確認してから，ほかのコマンドの実行やJP1/IM - Managerのサービスの起動をしてください。

このコマンドの実行時に一時ファイルが作成されます。拡張用リカバリーの場合，IMデータベースのインストール先ディレクトリの空き容量は，DBサイズがSのときに1ギガバイト，Mのときに1ギガバイト，Lのときに4ギガバイト程度必要です。また，障害復旧用リカバリーの場合，IMデータベースのインストール先ディレクトリの空き容量は，DBサイズがS，MおよびLのどのサイズのときも，5〜50メガバイト程度必要です。

障害復旧用リカバリー実行時は，障害復旧用バックアップを実行したときのデータベース格納ディレクトリと，障害復旧用リカバリーを実行するときのデータベース格納ディレクトリは同じである必要あります。

拡張用リカバリーを実行する場合，拡張用バックアップを実行した時のサイズより小さいサイズでは実行できません。

拡張用リカバリーを実行する場合，拡張用バックアップを実行したときと同じサイズでは，リカバリーに失敗することがあります。データベースを再セットアップしてデータベースを空にしてから，リカバリーしてください。

IMデータベースを使用している場合には，JP1/IM - Managerが停止している必要があります。

Windowsの場合，IMデータベースサービス（JP1/IM3-Manager DB Server）が起動している必要があります。また，IMデータベースのクラスタサービス（JP1/IM3-Manager DB Cluster Service_論理ホスト名）が停止している必要があります。

JP1/IM - MOを使用している場合は，接続元のJP1/IM - MOのJP1/IM - Message Optimizerサービスが停止している必要があります。

Windowsの場合，Application Experienceサービスが存在する場合は，Application Experienceサービスのスタートアップの種類が無効になっていないことを確認してからコマンドを実行してください。

障害復旧用リカバリーを実行する場合は，インテリジェント統合管理データベースのリストアも合わせて検討してください。

jimdbrorg

機能

IM構成管理DBの断片化された空き領域を再編成するコマンドです。再編成に伴って，使用中の空き領域も解放されます。そのため，jimdbreclaimコマンドを続けて実行する必要はありません。

空き領域によるデータの非効率化を防ぐために，データベースの再編成はJP1/IM - Managerのメンテナンスのタイミングで実行してください。

形式

jimdbrorg [-h 論理ホスト名]
          [-q]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Managerパス¥bin¥imdb¥

UNIXの場合

/opt/jp1imm/bin/imdb/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，コマンドを実行するホストの論理ホスト名を指定します。指定した論理ホストに対するデータベースを再編成します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。クラスタシステムを使用していない場合には指定は不要です。なお，論理ホスト名にJP1_DEFAULTは指定できません。また，論理ホスト名は，大文字・小文字を区別します。

-q

ユーザー確認を省略してコマンドを実行する場合に指定します。

戻り値

0

再編成が正常終了した

1

再編成が異常終了した

注意事項

このコマンドの実行中に，ほかのJP1/IM - Managerのコマンドを実行したり，JP1/IM - Managerのサービスを起動したりしないでください。実行に失敗することがあります。

このコマンドの実行中に［Ctrl］+［C］キーや［Ctrl］+［Break］キーは押さないでください。データベースの再編成処理をバックグラウンドで実行するため，［Ctrl］+［C］キーや［Ctrl］+［Break］キーを押してもデータベースの再編成処理処理は継続されます。［Ctrl］+［C］キーや［Ctrl］+［Break］キーを押したあと，すぐにほかのJP1/IM - Managerコマンドを実行したり，JP1/IM - Managerのサービスを起動したりすると，コマンドの実行やサービスの起動に失敗することがあります。

このコマンドの実行中に［Ctrl］+［C］キーや［Ctrl］+［Break］キーでコマンドの実行を途中で停止した場合，タスクマネージャなどによりpdrorgプロセスが実行していないことを確認してからほかのJP1/IM - Managerコマンドを実行したり，JP1/IM - Managerを操作したりする必要があります。これらのプロセスが実行中の場合，しばらく時間をおいて，そのプロセスの終了を待ってから，ほかのJP1/IM - Managerコマンドを実行したり，JP1/IM - Managerの操作をしたりしてください。

このコマンドを実行する前後には，障害復旧用バックアップを実行することをお勧めします。

コマンド実行時に一時ファイルを作成します。そのためIMデータベースのインストール先ディレクトリの空き容量は，DBサイズがSの場合に1ギガバイト，サイズがMの場合に1ギガバイト，Lの場合に4ギガバイト程度必要です。

IMデータベースを使用している場合には，JP1/IM-Managerが停止している必要があります。

Windowsの場合，IMデータベースサービス（JP1/IM3-Manager DB Server）が起動している必要があります。また，IMデータベースのクラスタサービス（JP1/IM3-Manager DB Cluster Service_論理ホスト名）が停止している必要があります。

JP1/IM - MOを使用している場合は，接続元のJP1/IM - MOのJP1/IM - Message Optimizerサービスが停止している必要があります。

Windowsの場合，Application Experienceサービスが存在する場合は，Application Experienceサービスのスタートアップの種類が無効になっていないことを確認してからコマンドを実行してください。

jimdbstatus

機能

IMデータベースの起動・停止などの稼働状態を確認するコマンドです。

形式

jimdbstatus [-h 論理ホスト名]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Managerパス¥bin¥imdb¥

UNIXの場合

/opt/jp1imm/bin/imdb/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，コマンドを実行するホストの論理ホスト名を指定します。その後，指定した論理ホストに対応するIMデータベースの稼働状態を確認します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。クラスタシステムを使用していない場合には指定は不要です。なお，論理ホスト名は，大文字・小文字を区別します。

戻り値

0

IMデータベース稼働中

1

jimdbstatusコマンドが異常終了

4

IMデータベースが起動・停止処理中

8

IMデータベースが停止中（IMデータベースが再起動中断状態であり，不安定な状態）

12

IMデータベースが停止中（正常に停止された状態）

16

IMデータベースサービスが起動していない（Windowsの場合）

20

IMデータベースがセットアップされていない

注意事項

Windowsの場合，Application Experienceサービスが存在する場合は，Application Experienceサービスのスタートアップの種類が無効になっていないことを確認してからコマンドを実行してください。

jimdbstop

機能

IMデータベースを停止するコマンドです。JP1/Baseの起動順序制御機能で，終了コマンドを設定する場合に使用します。

また，IMデータベースが再起動中断状態の場合，IMデータベースを強制停止するときに，-fオプションを指定してこのコマンドを使用します。

形式

jimdbstop [-h 論理ホスト名]
          [-f]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Managerパス¥bin¥imdb¥

UNIXの場合

/opt/jp1imm/bin/imdb/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，コマンドを実行するホストの論理ホスト名を指定します。その後，指定した論理ホストに対応するIMデータベースを停止します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。クラスタシステムを使用していない場合には指定は不要です。なお，論理ホスト名は，大文字・小文字を区別します。

-f

IMデータベースを強制停止する場合に指定します。

戻り値

0

正常終了

1

異常終了

4

IMデータベースが起動・停止処理中

8

IMデータベースが停止中（IMデータベースが再起動中断状態であり，不安定な状態）

12

IMデータベースが停止中（正常に停止された状態）

20

IMデータベースがセットアップされていない

注意事項

このコマンドの実行中に［Ctrl］+［C］キーや［Ctrl］+［Break］キーを押して処理を中止した場合，IMデータベースの停止に失敗することがあります。コマンドを再実行するには，別プロセスが動作している場合があるため，pdstopプロセスが実行されていないことを確認してください。このプロセスが実行中の場合，しばらく時間をおいてから再確認してください。

IMデータベースを使用している場合には，JP1/IM-Managerが停止している必要があります。

JP1/IM - MOを使用している場合は，接続元のJP1/IM - MOのJP1/IM - Message Optimizerサービスが停止している必要があります。

Windowsの場合，Application Experienceサービスが存在する場合は，Application Experienceサービスのスタートアップの種類が無効になっていないことを確認してからコマンドを実行してください。

jimdbupdate

機能

セットアップ済みのIMデータベースをアップデートするコマンドです。JP1/IM - Managerをバージョンアップインストールした場合，このコマンドを実行してください。

形式

jimdbupdate [-h 論理ホスト名] [-i] [-q]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Managerパス¥bin¥imdb¥

UNIXの場合

/opt/jp1imm/bin/imdb/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，コマンドを実行するホストの論理ホスト名を指定します。指定した論理ホストに対応するIMデータベースを更新します。クラスタシステムを使用していない場合には指定は不要です。なお，論理ホスト名にJP1_DEFAULTは指定できません。また，論理ホスト名は，大文字・小文字を区別します。論理ホスト名には，JP1/Baseで設定した論理ホスト名を，大文字・小文字を含めて正確に指定してください。

-i

IMデータベースを更新する場合に指定します。指定しない場合は，IMデータベースをアップデートする必要があるか確認するメッセージが出力されます。

-q

ユーザー確認を省略してコマンドを実行する場合に指定します。

戻り値

0

正常終了

1

異常終了

注意事項

このコマンドを実行する前に，次に示すこのコマンドの実行条件を満たすことを確認してください。

実行条件

実行系で実行する場合は，共有ディスクがオンラインであり，論理ホスト名が名前解決できる必要があります。

Windowsの場合，IMデータベースサービスが起動している必要があります。

物理ホストの場合

　JP1/IM3-Manager DB Server

論理ホストの場合

　JP1/IM3-Manager DB Server_論理ホスト名

また，次に示す，JP1/IM - Managerのサービス，およびIMデータベースのクラスタサービスが停止している必要があります。ただし，統合監視DB，およびIM構成管理DBを使用していない場合はJP1/IM - Managerのサービスは停止する必要はありません。

物理ホストの場合

　JP1/IM - Managerのサービス（JP1/IM3-Manager）

　IMデータベースのクラスタサービス（JP1/IM3-Manager DB Cluster Service）

論理ホストの場合

　JP1/IM - Managerのサービス（JP1/IM3-Manager_論理ホスト名）

　IMデータベースのクラスタサービス（JP1/IM3-Manager DB Cluster Service_論理ホスト名）

UNIXの場合，JP1/IM - Managerのサービスが停止している必要があります。ただし，統合監視DB，およびIM構成管理DBを使用していない場合はJP1/IM - Managerのサービスは停止する必要はありません。

コマンド実行中に［Ctrl］+［C］キーや［Ctrl］+［Break］キーで処理を中止した場合，pdeinstallのプロセスが実行していないことを確認してから再度コマンドを実行してください。

jimdbupdateコマンド実行後は，jimdbupdateコマンド実行前の拡張バックアップはリカバリーできなくなります。jimdbupdateコマンド実行後に拡張バックアップを取り直してください。

このコマンドを実行する前に取得したIMデータベースの更新前のバックアップデータは，コマンド実行後のIMデータベースにリカバリーしないでください。このコマンドを実行したあとは，再度jimdbupdateコマンドでバックアップを取り直してください。

jimdbupdateコマンド実行中に，jimdbstatusなどのIMデータベースに関するコマンドを実行しないでください。実行した場合，IMデータベースがアンインストールできなくなる場合があります。

Windowsの場合，Application Experienceサービスが存在する場合は，Application Experienceサービスのスタートアップの種類が無効になっていないことを確認してからコマンドを実行してください。

JP1/IM - Managerを13-00より前のバージョンから13-00以降にバージョンアップインストールしたあとに，jimdbupdateコマンドを実行する場合，次のことに注意してください。

2034年9月29日を過ぎた場合は，jimdbupdateコマンドを実行せず，IMデータベースの手動アンインストールおよび新規セットアップを実施してください。

Windowsの場合は，次の事項についても注意してください。

コマンド実行中に［Ctrl］＋［C］キーや［Ctrl］＋［Break］キーで処理を中止しないでください。中止した場合，JP1/IM - Managerのバージョンアップのやり直しが必要となることがあります。

IMデータベースを更新する場合，IMデータベースのファイルをロックするようなアプリケーションを終了してください。終了しなかった場合，更新に失敗し，JP1/IM - Managerのバージョンアップのやり直しが必要となることがあります。ウィルス対策ソフトについては，IMデータベースのインストールディレクトリおよびデータ格納ディレクトリ以下をチェック対象から除外していない場合，この手順が必要となります。

IMデータベースの更新に失敗し，KNAN11215-Eメッセージが出力された場合は，マニュアル「JP1/Integrated Management 3 - Manager 運用ガイド」の「12.5.3(69)　jimdbupdateコマンドによるIMデータベースの更新に失敗し，KNAN11215-Eメッセージが出力された場合の対処方法」に従って対処してください。

Linuxの場合は，次の事項についても注意してください。

SELinuxが無効な状態でコマンドを実行してください。

jimgndbbackup

機能

インテリジェント統合管理データベースをバックアップするコマンドです。

バックアップの用途と取得できるデータの種類を次に示します。

障害復旧用バックアップ

データベースの障害が発生した際にデータベースを復旧するため，定期的にデータをバックアップします。バックアップ対象は，データベース内のトレンドデータ管理DB領域，統合エージェントホスト管理DB領域，ダッシュボード管理DB領域，および対処アクション結果管理DB領域です。

移行用バックアップ

JP1/IM - Managerを別のホストに移行する際にデータベースにある定義情報を移行するためのデータをバックアップします。バックアップ対象は，データベース内のトレンドデータ管理DB領域，ダッシュボード管理DB領域，および統合エージェントホスト管理DB領域です。

このコマンドの実行条件を次に示します。

このコマンドの実行時に作成するバックアップファイルを格納するために，出力先のドライブに十分な空き容量があること。

少なくともインテリジェント統合管理データベースのデータファイルの格納先と同等のサイズの空き容量が必要です。インテリジェント統合管理データベースのデータファイルの格納先については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「2.7.1(1)(d)関連ファイルの格納先」の「インテリジェント統合管理データベースのデータファイルの格納先」を参照してください。

次のサービスが停止していること。

JP1/IM3-Manager

JP1/IM3-Manager Intelligent Integrated DB Server

JP1/IM3-Manager Trend Data Management Service

クラスタシステムでの運用時の場合は，次のサービスが停止していること。

JP1/IM3-Manager_論理ホスト名

JP1/IM3-Manager Intelligent Integrated DB Server_論理ホスト名

JP1/IM3-Manager Trend Data Management Service_論理ホスト名

このコマンドを引数-mにMAINTオプションを指定して実行する場合は，jimdbbackupコマンド（引数-mにMAINTオプションを指定）を使用してIMデータベースのバックアップを取得済みであること。

形式

jimgndbbackup -o バックアップファイル名
              -m {MAINT|TRANSF}
              [-h 論理ホスト名]
              [-q]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Managerパス¥bin¥imgndb¥

UNIXの場合

/opt/jp1imm/bin/imgndb/

引数

-o バックアップファイル名

バックアップするデータベースを出力するファイル名を絶対パス形式で指定します。バックアップファイルは，ローカルドライブを指定してください。このオプションは省略できません。

ネットワークドライブが指定された場合，UNCパスが指定された場合，およびWindowsで予約デバイスファイルが指定された場合はエラーとなります。指定したバックアップファイルがすでに存在する場合は，上書きされます。

バックアップファイル名にはファイルパスを含めて指定してください。使用できる文字は半角英数字とアンダースコア「_」，ドット「.」，シャープ「#」，アットマーク「@」です。文字はOSに依存し，半角スペース「 」または丸括弧「(」，「)」を含む場合は，前後を引用符「"」で囲む必要があります。また，ファイル名の最大長はOSの制限に従います。

-m {MAINT|TRANSF}

データベースのバックアップ形式を指定します。半角英大文字です。このオプションは省略できません。

MAINT：障害復旧用バックアップを実行します。

TRANSF：移行用バックアップを実行します。

-h 論理ホスト名

クラスタシステムで運用している場合に，コマンドを実行するホストの論理ホスト名を指定します。指定した論理ホストに対応するインテリジェント統合管理データベースをバックアップします。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。クラスタシステムを使用していない場合には指定は不要です。なお，論理ホスト名にJP1_DEFAULTは指定できません。

-q

ユーザー確認を省略してコマンドを実行する場合に指定します。

戻り値

0

バックアップが正常終了した

1

バックアップが異常終了した

3

ユーザーがキャンセルした（KNAN12009-Qメッセージで「N/n」を入力して処理を中断した場合）

注意事項

このコマンドを実行する前に，このコマンドとjimgndbrestoreコマンドの実行条件を満たすことを確認してください。

このコマンドの実行中にほかのJP1/IM - ManagerまたはJP1/IM - Agentのコマンドの実行やサービスの起動をしないでください。このコマンドはデータベースを参照・更新禁止モードに変更するため，実行に失敗することがあります。

このコマンドの実行中に［Ctrl］+［C］キーや［Ctrl］+［Break］キーは押さないでください。バックアップをバックグラウンドで実行するため，［Ctrl］+［C］キーや［Ctrl］+［Break］キーを押してもバックアップ処理は継続されます。［Ctrl］+［C］キーや［Ctrl］+［Break］キーを押したあと，すぐにほかのJP1/IM - ManagerまたはJP1/IM - Agentのコマンドの実行やサービスの起動を行うと，それらのコマンドの実行やサービスの起動に失敗することがあります。

コマンド実行中に［Ctrl］+［C］キーや［Ctrl］+［Break］キーで処理を中止した場合，処理は中断されますが，メッセージが崩れて出力されることがあります。

バックアップファイルは，障害復旧用と移行用の区別ができないため，ファイル名にそれぞれが区別できる文字を指定することを推奨します。

バックアップファイルのアクセス権は，ユーザーがアクセスできる状態で出力されます。バックアップ取得後，アクセス権を変更するか，ユーザーがアクセスできない場所へ移動することを推奨します。

このコマンドは，多重実行およびインテリジェント統合管理データベースのほかの運用コマンドとの同時実行はできません。インテリジェント統合管理データベースの運用コマンドの多重実行については，「■インテリジェント統合管理データベースの運用コマンドの多重実行について」を参照してください。

jimgndbrestore

機能

バックアップで保管しておいたインテリジェント統合管理データベースを復旧（リカバリー）するコマンドです。リカバリーできるデータの種類を次に示します。

障害復旧用リカバリー

データベースの障害が発生した際に，定期的に取得しているバックアップデータを利用してデータベースを復旧します。

移行用リカバリー

JP1/IM - Managerを別のホストに移行する際に，バックアップデータを利用してデータベースを移行します。

このコマンドの実行条件を次に示します。

次のサービスが停止していること。

JP1/IM3-Manager

JP1/IM3-Manager Intelligent Integrated DB Server

JP1/IM3-Manager Trend Data Management Service

クラスタシステムでの運用時の場合は，次のサービスが停止していること。

JP1/IM3-Manager_論理ホスト名

JP1/IM3-Manager Intelligent Integrated DB Server_論理ホスト名

JP1/IM3-Manager Trend Data Management Service_論理ホスト名

このコマンドを引数-mにMAINTオプションを指定して実行する場合は，jimdbrecoveryコマンド（引数-mにMAINTオプションを指定）を使用してIMデータベースのリカバリーを実行済みであること。

インテリジェント統合管理データベースを再セットアップしていること。

形式

jimgndbrestore -i バックアップファイル名
               -m {MAINT|TRANSF}
               [-h 論理ホスト名]
               [-q]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Managerパス¥bin¥imgndb¥

UNIXの場合

/opt/jp1imm/bin/imgndb/

引数

-i バックアップファイル名

jimgndbbackupコマンドを用いてバックアップしたデータベースのファイル名を絶対パス形式で指定します。ファイル名に使用できる文字は，半角英数字とアンダースコア「_」，ドット「.」，シャープ「#」，アットマーク「@」です。バックアップファイルには，ローカルドライブを指定します。このオプションは省略できません。

ネットワークドライブが指定された場合，UNCパスが指定された場合，およびWindowsで予約デバイスファイルが指定された場合はエラーとなります。

-m {MAINT|TRANSF}

データベースのリカバリー形式を指定します。指定できる文字は，半角英大文字です。このオプションは省略できません。

MAINT：障害復旧用リカバリーを実行します。

TRANSF：移行用リカバリーを実行します。

障害復旧用リカバリーを実行する場合，障害復旧用バックアップで採取したバックアップファイルを指定してください。また，移行用リカバリーを実行する場合，移行用バックアップで採取したバックアップファイルを指定してください。

-h 論理ホスト名

クラスタシステムで運用している場合に，コマンドを実行するホストの論理ホスト名を指定します。指定した論理ホストに対するデータベースがリカバリーされます。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。クラスタシステムを使用していない場合には指定は不要です。なお，論理ホスト名にJP1_DEFAULTは指定できません。

-q

ユーザー確認を省略してコマンドを実行する場合に指定します。

戻り値

0

リカバリーが正常終了した

1

リカバリーが異常終了した

3

ユーザーがキャンセルした（KNAN12009-Qメッセージで「N/n」を入力して処理を中断した場合）

注意事項

このコマンドを実行する前に，このコマンドとjimgndbbackupコマンドの実行条件を満たすことを確認してください。

このコマンドによるデータベースのリカバリーの影響でJP1/IM - Agentとの間に不整合が発生する場合があります。不整合を回避するために，JP1/IM - Agentを停止してからリカバリーしてください。

このコマンドはデータベースにあるデータだけをリカバリーします。バックアップ後に追加したデータとの不整合を回避するために，先にデータベースを再セットアップしてからリカバリーする必要があります。データ不整合が発生した場合の影響は様々であり，後からデータ不整合を発見することは難しいため，必ずデータベースを再セットアップしてからリカバリーしてください。

このコマンドの実行中に，ほかのJP1/IM - ManagerまたはJP1/IM - Agentのコマンドの実行やサービスの起動をしないでください。このコマンドはデータベースの参照・更新を禁止モードに変更するため，実行に失敗するおそれがあります。

このコマンドの実行中に［Ctrl］+［C］キーや［Ctrl］+［Break］キーは押さないでください。リカバリーをバックグラウンドで実行するため，［Ctrl］+［C］キーや［Ctrl］+［Break］キーを押してもリカバリー処理は継続されます。［Ctrl］+［C］キーや［Ctrl］+［Break］キーを押したあと，すぐにほかのJP1/IM - ManagerまたはJP1/IM - Agenのコマンドの実行やサービスの起動をすると，それらのコマンドの実行やサービスの起動に失敗することがあります。

コマンド実行中に［Ctrl］+［C］キーや［Ctrl］+［Break］キーで処理を中止した場合，処理は中断されますが，メッセージが崩れて出力されることがあります。

リカバリーファイルは，障害復旧用と移行用の区別ができないため，ファイル名にそれぞれが区別できる文字を指定することを推奨します。

リカバリーファイルのアクセス権は，ユーザーがアクセスできる状態で出力されます。リカバリー取得後，アクセス権を変更するか，ユーザーがアクセスできない場所へ移動することを推奨します。

このコマンドは，多重実行およびインテリジェント統合管理データベースのほかの運用コマンドとの同時実行はできません。インテリジェント統合管理データベースの運用コマンドの多重実行については，「■インテリジェント統合管理データベースの運用コマンドの多重実行について」を参照してください。

jimgndbsetup

機能

インテリジェント統合管理データベースとトレンドデータ管理サービスのセットアップ（インストールとデータベースの構築）を行うコマンドです。

また，セットアップ済みの場合は，データベースの設定の確認，および，変更を行います。

形式

jimgndbsetup  {-f セットアップ情報ファイル名
                [-h 論理ホスト名 -c {online|standby}]
                [-q]
              | -display [-h 論理ホスト名] }

コマンドの各引数の並びは順不同です。

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

Linuxの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Managerパス¥bin¥imgndb¥

Linuxの場合

/opt/jp1imm/bin/imgndb/

引数

-f セットアップ情報ファイル名

インテリジェント統合管理データベースのインストール先ディレクトリやポート番号を記述したセットアップ情報ファイルを指定します。インテリジェント統合管理データベースを構築する環境に応じて，次に示すファイル名を指定します。

物理ホスト環境に構築する場合

インテリジェント統合管理データベースセットアップ情報ファイル名

クラスタ環境に構築する場合

クラスタ環境インテリジェント統合管理データベースセットアップ情報ファイル名

ファイル名は，フルパスまたはこのコマンドを実行した場所からの相対パス形式で指定します。パスに空白を含む場合は「"」で囲んで指定します。

-h 論理ホスト名

-fオプションに，クラスタ環境インテリジェント統合管理データベースセットアップ情報ファイル名を指定する場合，論理ホスト名を必須で指定します。論理ホスト名には，JP1/Baseで設定した論理ホスト名を，大文字・小文字を含めて正確に指定してください。

指定した論理ホストに対応するインテリジェント統合管理データベースをセットアップします。クラスタシステムを使用していない場合は指定不要です。

なお，論理ホスト名にJP1_DEFAULTは指定できません。

-c {online|standby}

-hオプションを指定する場合，クラスタ構成の実行系および待機系のセットアップ種別を必須で指定します。指定できるセットアップ種別を次に示します。

online

実行系をセットアップする場合に指定します。

standby

待機系をセットアップする場合に指定します。

インテリジェント統合管理データベースのインストールだけを行い，データベースの構築はスキップします。

実行系と待機系の両方で-cオプションにstandbyを指定してしまった場合は，データベースの構築は行われません。その場合は，コマンド終了後に一度アンセットアップしてから，コマンドを再実行してください。

また，非クラスタ環境で，論理ホスト運用をする場合はonlineを指定してください。

-q

ユーザー確認を省略してコマンドを実行する場合に指定します。

-display

インテリジェント統合管理データベースとトレンドデータ管理サービスが構築されているかどうかを確認する場合に指定します。

また，構築済みの場合は，次に示すセットアップ時の設定情報を，KNAN12094-Iメッセージで出力します。

インテリジェント統合管理データベースのポート番号

トレンドデータ管理サービスのポート番号

データ格納ディレクトリ

インストールディレクトリ

データ保存期間

戻り値

0

正常終了

1

異常終了

2

異常終了（ファイルまたはプロセスが残っているおそれがある場合）

3

ユーザーがキャンセルした（KNAN12009-Qメッセージで「N/n」を入力して処理を中断した場合）

ログの出力

このコマンドは，次に示すプロセス別トレースログを出力します。統合トレースログは出力しません。

ファイル名

jimgndbsetup{1|2}.log※

注※　{1|2}はファイルの面数です。

ファイルサイズ（面数）

256KB（2面）

出力先

■Windowsの場合

物理ホストおよび論理ホスト

Managerパス¥log¥imgndb¥

■Linuxの場合

物理ホストおよび論理ホスト

/var/opt/jp1imm/log/imgndb/

注意事項

実行系と待機系のクラスタ環境インテリジェント統合管理データベースセットアップ情報ファイルの内容は同じにする必要があります。待機系をセットアップする場合，実行系で使用したクラスタ環境インテリジェント統合管理データベースセットアップ情報ファイルをコピーして使用してください。実行系と待機系で指定したファイル内容が異なっていた場合，待機系でアンセットアップしたあとに，クラスタ環境インテリジェント統合管理データベースセットアップ情報ファイルを実行系からコピーし，コマンドを再実行してください。

-cオプションを指定してコマンドを実行する場合は，実行途中でサーバを切り替えないでください。実行中にサーバを切り替えた場合は，コマンド終了後に一度アンセットアップしてから，コマンドを再実行してください。

コマンド実行中に［Ctrl］＋［C］キーや［Ctrl］＋［Break］キーで処理を中止した場合の注意事項を次に示します。

- pg_ctl，postgres，およびpromscaleのプロセスが実行されていないことを確認し，jimgndbunsetupコマンドを実行してからこのコマンドを再実行してください。これらのプロセスが実行中の場合は，しばらく時間をおいてプロセスの終了を待ってから，このコマンドを再実行してください。

- 処理は中止されますが，メッセージが崩れて出力されることがあります。

- 処理を中止したあとに，再度コマンドを実行する場合は，インテリジェント統合管理データベースセットアップ情報ファイルの項目「IMGNDBDIR」，またはクラスタ環境インテリジェント統合管理データベースセットアップ情報ファイルの項目「SHAREGNDBDIR」に指定したディレクトリを確認し，ファイルまたはディレクトリが存在するときは，それらを削除して空にしてから実行してください。

このコマンドは多重実行できません。また，インテリジェント統合管理データベースのほかの運用コマンドと同時に実行できません。

インテリジェント統合管理データベースの運用コマンドの多重実行については，「■インテリジェント統合管理データベースの運用コマンドの多重実行について」を参照してください。

このコマンドで論理ホストの設定を変更した場合，サービスは再起動せず停止したままとなります。この場合は，コマンドの実行後に手動でサービスを開始する必要があります。

インテリジェント統合管理データベースはlocalhostに対して通信を行うため，localhostのIPアドレスが解決できる必要があります。解決できない場合，セットアップに失敗します。

使用例1

正常終了の場合

>jimgndbsetup -f インテリジェント統合管理データベースセットアップ情報ファイル名
KNAN12005-Iインテリジェント統合管理データベースをセットアップします
KNAN12088-Iインテリジェント統合管理データベースのインストールディレクトリ : ディレクトリ名
KNAN12006-Iインテリジェント統合管理データベースのデータ格納ディレクトリ : ディレクトリ名
KNAN12007-Iインテリジェント統合管理データベースのポート番号 : ポート番号
KNAN12008-Iインテリジェント統合管理データベースのデータ保存期間 : データ保存期間
KNAN12009-Q処理を続行しますか？（Y/N）：Y
KNAN12010-Iインテリジェント統合管理データベースのセットアップを開始します
KNAN12020-Iしばらくお待ちください
KNAN12089-Iインテリジェント統合管理データベースをインストールします
KNAN12090-Iインテリジェント統合管理データベースをインストールしました
KNAN12013-Iインテリジェント統合管理データベースを構築します
KNAN12014-Iインテリジェント統合管理データベースを構築しました
KNAN12012-Iインテリジェント統合管理データベースのセットアップは正常に終了しました

異常終了の場合（インテリジェント統合管理データベースセットアップ情報ファイルの必須項目が指定されていないとき）

>jimgndbsetup -f インテリジェント統合管理データベースセットアップ情報ファイル名
KNAN12005-I インテリジェント統合管理データベースをセットアップします
KNAN12022-E インテリジェント統合管理データベースセットアップ情報ファイルに必須項目が指定されていません (項目名: 項目名)

使用例2

設定済みの情報を確認する場合

>jimgndbsetup -display
KNAN12094-I インテリジェント統合管理データベースはセットアップされています
インテリジェント統合管理データベースのポート番号：ポート番号
トレンドデータ管理サービスのポート番号：ポート番号
データ格納ディレクトリ：ディレクトリパス
インストールディレクトリ：ディレクトリパス
データ保存期間：保存期間

使用例3

設定の変更を行う場合

>jimgndbsetup -f インテリジェント統合管理データベースセットアップ情報ファイル名
KNAN12005-I インテリジェント統合管理データベースをセットアップします
KNAN12088-I インテリジェント統合管理データベースのインストールディレクトリ : /var/opt/jp1imm/dbms
KNAN12006-I インテリジェント統合管理データベースのデータ格納ディレクトリ : /var/opt/jp1imm/database
KNAN12007-I インテリジェント統合管理データベースのポート番号 : 20705
KNAN12008-I インテリジェント統合管理データベースのデータ保存期間 : 64
KNAN12015-I インテリジェント統合管理データベースの設定を変更します
設定変更後にインテリジェント統合管理データベースは再起動されます
KNAN12009-Q 処理を続行しますか？ (Y/N) : Y
KNAN12020-I しばらくお待ちください
KNAN12016-I インテリジェント統合管理データベースの設定を変更しました

jimgndbstatus

機能

インテリジェント統合管理データベースサービスとトレンドデータ管理サービスの起動・停止などの稼働状態を確認するコマンドです。

-riオプションを指定すると，インテリジェント統合管理データベース（トレンドデータ管理DB）の保存期間を確認できます。

-rsオプションを指定すると，インテリジェント統合管理データベース（トレンドデータ管理DB）の保存期間を経過したデータを削除する処理について，前回の実行日時，終了日時，および次回の実行予定日時を確認できます。

形式

jimgndbstatus  [{-ri | -rs}]
               [-h 論理ホスト名]

コマンドの各引数の並びは順不同です。

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

Linuxの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Managerパス¥bin¥imgndb¥

Linuxの場合

/opt/jp1imm/bin/imgndb/

引数

-ri

このオプションを指定すると，トレンドデータ管理DBのトレンドデータの保存期間を，KNAN12099-Iメッセージで出力します。

-rs

このオプションを指定すると，トレンドデータ管理DBのトレンドデータが，保存期間を過ぎているかをチェックし，保存期間を過ぎたデータの削除処理の実行スケジュールに関する次に示す情報を，KNAN12054-Iメッセージで出力します。

前回開始日時（前回実行時の開始日時）

前回終了日時（前回実行時の終了日時）

次回開始日時（次回の実行開始日時）

各日時データ（前回開始日時，前回終了日時，次回開始日時）のフォーマットなど，KNAN12054-Iメッセージの詳細については，マニュアル「JP1/Integrated Management 3 - Manager メッセージ」を参照してください。

-h 論理ホスト名

クラスタシステムで運用している場合に，コマンドを実行するホストの論理ホスト名を必須で指定します。

指定した論理ホストに対応するインテリジェント統合管理データベースの稼働状態を確認します。クラスタシステムを使用していない場合は指定不要です。

このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。

なお，論理ホスト名にJP1_DEFAULTは指定できません。

戻り値

0

-riオプションと-rsオプションのどちらも指定しなかった場合

インテリジェント統合管理データベース，および，トレンドデータ管理サービスが起動状態

-riオプションまたは-rsオプションのどちらかを指定した場合

正常終了

1

異常終了

12

インテリジェント統合管理データベース，および，トレンドデータ管理サービスが停止状態

16

インテリジェント統合管理データベースが起動状態，かつ，トレンドデータ管理サービスが停止状態

17

インテリジェント統合管理データベースが停止状態，かつ，トレンドデータ管理サービスが起動状態

20

インテリジェント統合管理データベースが未セットアップ

ログの出力

このコマンドは，次に示すプロセス別トレースログを出力します。統合トレースログは出力しません。

ファイル名

jimgndbstatus{1|2|3|4|5|6|7|8|9|10}.log※

注※　{1|2|3|4|5|6|7|8|9|10}はファイルの面数です。

ファイルサイズ（面数）

5,120KB（10面）

出力先

■Windowsの場合

物理ホスト

Managerパス¥log¥imgndb¥※

論理ホスト

JP1/IM - Managerの論理ホスト環境の作成時にユーザーが指定したパス¥log¥imgndb¥

■Linuxの場合

物理ホスト

/var/opt/jp1imm/log/imgndb/※

論理ホスト

JP1/IM - Managerの論理ホスト環境の作成時にユーザーが指定したパス/jp1imm/log/imgndb/

注※

論理ホストの運用でも，ログの一部が物理ホスト側に出力されます。

注意事項

インテリジェント統合管理データベースの運用コマンドの多重実行については，「■インテリジェント統合管理データベースの運用コマンドの多重実行について」を参照してください。

-rsオプションを指定してコマンドを実行したときに，日時情報に"unknown"が表示された場合，トレンドデータの自動削除が実行中であることが考えられます。この場合，しばらく待ってから再度コマンドを実行することで，実行スケジュールに関する情報を取得できます。

使用例1

-riオプションと-rsオプションのどちらも指定しない，かつ，正常終了の場合

>jimgndbstatus
KNAN12044-I サービスの稼働状態確認処理を開始します
KNAN12047-I インテリジェント統合管理データベースサービスは稼働中です
KNAN12048-Iトレンドデータ管理サービスは稼働中です
KNAN12045-I サービスの稼働状態確認処理は正常に終了しました

使用例2

-riオプションを指定，かつ，正常終了の場合

>jimgndbstatus -ri
KNAN12044-I サービスの稼働状態確認処理を開始します
KNAN12099-I 保存期間は次の通りです
32日
KNAN12045-Iサービスの稼働状態確認処理は正常に終了しました

使用例3

-rsオプションを指定，かつ，正常終了の場合

>jimgndbstatus -rs
KNAN12044-I サービスの稼働状態確認処理を開始します
KNAN12054-I 直前および次回の実行スケジュールは次の通りです
前回開始日時：[2021-07-15 17:31:06.83+09]
前回終了日時：[2021-07-15 17:31:07.08+09]
次回開始日時：[2021-07-15 18:01:07.08+09]
KNAN12045-Iサービスの稼働状態確認処理は正常に終了しました

jimgndbstop

機能

インテリジェント統合管理データベースとトレンドデータ管理サービスを停止するコマンドです。

インテリジェント統合管理データベースを強制停止する場合は，-fオプションを指定してこのコマンドを使用します。

なお，トレンドデータ管理サービスの停止処理の待ち時間は最大10秒※です。

注※

通常の停止処理の待ち時間は最大5秒です。-fオプションを指定した場合は，強制停止の処理で最大5秒が待ち時間に加わります。

また，JP1/IM - Managerの自動起動および自動終了の設定をしている場合は，jco_stopコマンドを使用して，インテリジェント統合管理データベースとトレンドデータ管理サービスを停止してください。jco_stopコマンドの詳細については，「jco_stop（UNIX限定）」を参照してください。

形式

jimgndbstop  -sys
             [-h 論理ホスト名]
             [-f]

コマンドの各引数の並びは順不同です。

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

Linuxの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Managerパス¥bin¥imgndb¥

Linuxの場合

/opt/jp1imm/bin/imgndb/

引数

-sys

このコマンドの実行時に必須で指定します。意図せずにサービスを停止することを予防するためのオプションです。

-h 論理ホスト名

クラスタシステムで運用している場合に，コマンドを実行するホストの論理ホスト名を必須で指定します。

指定した論理ホストに対応するインテリジェント統合管理データベース（サービス），およびトレンドデータ管理サービスを停止します。クラスタシステムを使用していない場合は指定不要です。

このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。

なお，論理ホスト名にJP1_DEFAULTは指定できません。

-f

インテリジェント統合管理データベースを強制停止する場合に指定します。

戻り値

0

正常終了

1

異常終了

20

インテリジェント統合管理データベースが未セットアップ

ログの出力

このコマンドは，次に示すプロセス別トレースログを出力します。統合トレースログは出力しません。

ファイル名

jimgndbstop{1|2|3|4|5|6|7|8|9|10}.log※

注※　{1|2|3|4|5|6|7|8|9|10}はファイルの面数です。

ファイルサイズ（面数）

5,120KB（10面）

出力先

■Windowsの場合

物理ホスト

Managerパス¥log¥imgndb¥※

論理ホスト

JP1/IM - Managerの論理ホスト環境の作成時にユーザーが指定したパス¥log¥imgndb¥

■Linuxの場合

物理ホスト

/var/opt/jp1imm/log/imgndb/※

論理ホスト

JP1/IM - Managerの論理ホスト環境の作成時にユーザーが指定したパス/jp1imm/log/imgndb/

注※

論理ホストの運用でも，ログの一部が物理ホスト側に出力されます。

注意事項

このコマンドは多重実行できません。また，インテリジェント統合管理データベースのほかの運用コマンドと同時に実行できません。

インテリジェント統合管理データベースの運用コマンドの多重実行については「■インテリジェント統合管理データベースの運用コマンドの多重実行について」を参照してください。

このコマンドを実行して，インテリジェント統合管理データベース，およびトレンドデータ管理サービスの停止に失敗した場合は，次のように対処してください。

コンソールなどに出力されたエラーメッセージを確認して，エラーの要因を取り除き，再度このコマンドで停止を実行します。

それでも停止しない場合は，OSの機能を利用してプロセスを停止してください。

停止対象のプロセスについては，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「付録B プロセス一覧」の「JP1/IM - Managerのプロセス（Linux）」を参照してください。

使用例

正常終了の場合

> jimgndbstop -sys
KNAN12064-Iトレンドデータ管理サービスの停止処理を開始します
KNAN12068-Iトレンドデータ管理サービスが停止しました
KNAN12066-Iトレンドデータ管理サービスの停止処理が正常終了しました
KNAN12063-Iインテリジェント統合管理データベースサービスの停止処理を開始します
KNAN12067-Iインテリジェント統合管理データベースサービスが停止しました
KNAN12065-Iインテリジェント統合管理データベースサービスの停止処理が正常終了しました

異常終了の場合（データベースが未セットアップのとき）

> jimgndbstop -sys
KNAN12063-Iインテリジェント統合管理データベースサービスの停止処理を開始します
KNAN12041-Eインテリジェント統合管理データベースは構築されていません

jimgndbunsetup

機能

インテリジェント統合管理データベースとトレンドデータ管理サービスのアンセットアップ（アンインストールとデータベースの削除）を行うコマンドです。

インテリジェント統合管理データベースの使用を停止する場合，およびインテリジェント統合管理データベースの再作成を行う場合は，事前にこのコマンドを実行します。物理ホストと論理ホストの両方をアンセットアップする場合は，それぞれのホストで実行する必要があります。

形式

jimgndbunsetup  [-h 論理ホスト名 -c {online|standby}]
                [-q]

コマンドの各引数の並びは順不同です。

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

Linuxの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Managerパス¥bin¥imgndb¥

Linuxの場合

/opt/jp1imm/bin/imgndb/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，コマンドを実行するホストの論理ホスト名を必須で指定します。論理ホスト名には，JP1/Baseで設定した論理ホスト名を，大文字・小文字を含めて正確に指定してください。

指定した論理ホストに対応するインテリジェント統合管理データベースがアンセットアップされます。クラスタシステムを使用していない場合は指定不要です。

なお，論理ホスト名にJP1_DEFAULTは指定できません。

-c {online|standby}

クラスタ構成の実行系および待機系のセットアップ種別を必須で指定します。指定できるセットアップ種別を次に示します。

online

実行系をセットアップする場合に指定します。

standby

待機系をセットアップする場合に指定します。

インテリジェント統合管理データベースのアンインストールだけを行い，データベースの削除はスキップします。

実行系と待機系の両方で-cオプションにstandbyを指定してしまった場合は，データベースの削除が行われません，その場合は，データベースを手動で削除してください。削除対象については，KNAN12108-Iメッセージで確認できます。

また，非クラスタ環境で，論理ホスト運用をする場合はonlineを指定してください。

-q

ユーザー確認を省略してコマンドを実行する場合に指定します。

戻り値

0

正常終了

1

異常終了

3

ユーザーがキャンセルした（KNAN12009-Qメッセージで「N/n」を入力して処理を中断した場合）

20

インテリジェント統合管理データベースが未セットアップ

ログの出力

このコマンドは，次に示すプロセス別トレースログを出力します。統合トレースログは出力しません。

ファイル名

jimgndbunsetup{1|2}.log※

注※　{1|2}はファイルの面数です。

ファイルサイズ（面数）

256KB（2面）

出力先

■Windowsの場合

物理ホストおよび論理ホスト

Managerパス¥log¥imgndb¥

■Linuxの場合

物理ホストおよび論理ホスト

/var/opt/jp1imm/log/imgndb/

注意事項

-cオプションを指定してコマンドを実行する場合は，実行途中でサーバを切り替えないでください。実行中にサーバを切り替えた場合は，コマンド終了後にコマンドを再実行してください。

コマンド実行中に［Ctrl］＋［C］キーや［Ctrl］＋［Break］キーで処理を中止した場合の注意事項を次に示します。

- pg_ctl，postgres，およびpromscaleのプロセスが実行されていないことを確認し，jimgndbunsetupコマンドを実行してからこのコマンドを再実行してください。これらのプロセスが実行中の場合は，しばらく時間をおいてプロセスの終了を待ってから，このコマンドを再実行してください。

- 処理は中止されますが，メッセージが崩れて出力されることがあります。

このコマンドは多重実行できません。また，インテリジェント統合管理データベースのほかの運用コマンドと同時に実行できません。

インテリジェント統合管理データベースの運用コマンドの多重実行については，「■インテリジェント統合管理データベースの運用コマンドの多重実行について」を参照してください。

KNAN12105-EもしくはKNAN12107-Eのエラーメッセージが出力された場合，または操作の誤りでKNAN12108-Iメッセージが出力された場合，メッセージ中のディレクトリ名を確認して，該当するディレクトリのデータを手動で削除してください。

使用例

正常終了の場合

>jimgndbunsetup
KNAN12035-I インテリジェント統合管理データベースのアンセットアップします
KNAN12009-Q 処理を続行しますか？（Y/N）：Y
KNAN12036-I インテリジェント統合管理データベースのアンセットアップを開始します
KNAN12020-I しばらくお待ちください
KNAN12104-I インテリジェント統合管理データベースをアンインストールしました
KNAN12106-I インテリジェント統合管理データベースのデータ格納ディレクトリを削除しました
KNAN12038-I インテリジェント統合管理データベースのアンセットアップは正常に終了しました

異常終了の場合（データベースが未セットアップのとき）

>jimgndbunsetup
KNAN12035-I インテリジェント統合管理データベースのアンセットアップします
KNAN12041-E インテリジェント統合管理データベースは構築されていません

jimmail（Windows限定）

機能

指定したメールアドレスにメールを送信するコマンドです。

jimmailコマンドでメールを送信するには，メール環境定義ファイルの設定が必要です。

このコマンドは，JP1/IM - Managerサービスの起動状態に関係なく単体で実行できます。次に示すJP1/IM - Managerの機能でメール送信できます。

表1‒48　jimmailコマンドでメール送信できるJP1/IM - Managerの機能

機能

説明

自動アクション

自動アクションでメール送信できる。

アクションの状態監視，遅延監視

アクションの異常を検知したときに通知コマンドでメール送信できる。

ヘルスチェック

JP1/IM - Managerのプロセス異常を検知したとき，通知コマンドでメール送信できる。

コマンド実行（コマンドボタン）

コマンドボタンでメール送信できる。

コマンドラインの最大長を超過した場合は，jimmailコマンドのコマンドライン長が制限内に収まるように，メールの内容を再定義してください。

形式

jimmail [-to 送信先メールアドレス[,送信先メールアドレス…]]
        [-s メールの主題]
        [-b メールの本文]
        [-rh 論理ホスト名]

実行権限

Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

格納先ディレクトリ

Consoleパス¥bin¥

引数

-to 送信先メールアドレス[,送信先メールアドレス…]

送信先メールアドレスを指定するオプションです。

指定できるメールアドレスは20件です。ただし，コマンドラインの最大長を超えて指定することはできません。複数のメールアドレスを指定する場合は，「,（コンマ）」でアドレスを区切って指定してください。メールアドレスと「,（コンマ）」の間の半角スペース，タブは無視されます。連続した「,（コンマ）」は一つの「,（コンマ）」と見なし，先頭と末尾の「,（コンマ）」は無視されます。同じメールアドレスを複数指定した場合，指定したアドレスにはメールを1件送信します。

指定したメールアドレスが最大件数を超過した場合，KAVB8725-Eを出力して異常終了します。

送信先メールアドレスに指定できる文字数は，1〜256バイトです。半角英数字，「@（アットマーク）」，「-（ハイフン）」，「_（アンダースコア）」，「.（ピリオド）」の文字で指定します。

このオプションは省略できます。省略した場合，メール環境定義ファイルのDefaultToパラメーター（デフォルトの送信先メールアドレス）に指定したメールアドレスを送信先として処理を継続します。送信処理する際，DefaultToパラメーターのメールアドレスに送信したメッセージは出力しません。

-toオプションを省略し，DefaultToパラメーターにメールアドレスの指定がない場合，jimmailコマンドはエラーメッセージを出力して異常終了します。

-toオプションとDefaultToパラメーターがどちらも設定されている場合，-toオプションが優先されます。

jimmailコマンドは，指定されたメールアドレスが有効なアドレスかをチェックしません。

-s メールの主題

メールの主題を指定するオプションです。

指定できる文字数は，1〜512バイトです。文字数は，メール環境定義ファイルのCharsetパラメーターで指定したメールの文字コードに従ったバイト数でチェックします。イベントやアクションの情報を引き継ぐ場合は，「$変数名」を置換したあとの長さで最大長をチェックします。最大長を超えている場合，メールの主題を切り捨ててメール送信を継続するかを，メール環境定義ファイルのMailSubjectCuttingパラメーターで選択できます。

MailSubjectCuttingパラメーターの値が「OFF」の場合は，KAVB8708-Eメッセージを出力してコマンドは異常終了します。

MailSubjectCuttingパラメーターの値が「ON」の場合は，メールの主題をCharsetパラメーターで指定したメールの文字コードに従い512バイト以内になるように切り捨てて，メール送信を継続します。512バイトを超える場合は，512バイト以内になるように主題の文字列を切り捨てます。メールの主題を切り捨てて送信した場合，KAVB8729-I（メール送信成功メッセージ）の前に，KAVB8724-Wメッセージを表示します。

このオプションは省略できます。省略した場合，メールの主題は空文字（""）になります。

メールの主題に空白文字を含む場合，メールの主題を「"」で囲んで指定します。

「¥n」を指定しても，メールの主題は改行されません。「¥n」を指定した場合，「¥n」がそのまま表示されます。改行コード，制御文字の場合，半角スペースに変換されます。

-b メールの本文

メールの本文を指定するオプションです。

メールの本文に指定できる文字数は，1〜4,096バイトです。文字数は，メール環境定義ファイルのCharsetパラメーターで指定したメールの文字コードに従ったバイト数でチェックします。イベントやアクションの情報を引き継ぐ場合は，「$変数名」を置換したあとの長さで最大長をチェックします。

1行に指定できる文字数は，改行文字を含め1〜512バイトです。512バイトを超えている場合，改行文字を含めて512バイト以内になるように改行コードを挿入します。その際，警告メッセージは出力しません。

このオプションは省略できます。省略した場合，メールの本文は空文字（""）となります。

最終行の末尾に改行がない場合，改行コードが挿入されます。

メールの本文に空白文字を含む場合，メール本文を「"」で囲んで指定します。

メールの本文中に「¥n」を指定した場合，メール環境定義ファイルのMailNewLineパラメーターに指定した改行コードで改行されます。「CRLF」，「CR」，「LF」を除く制御文字が指定されている場合は，半角スペースに変換されます。

「¥n」を文字列として入力する場合は，「¥¥n」と指定します。

-rh 論理ホスト名

-rhオプションは，クラスタでJP1/IM - Managerを運用している場合に，jimmailコマンドが物理ホスト上，または論理ホストの共有フォルダ上のどちらに格納されたメール環境定義ファイルを使用するか指定するオプションです。

このオプションを指定した場合，指定した論理ホスト名の共有フォルダ上のメール環境定義ファイルを読み込み，メールを送信します。

このオプションを省略した場合は，物理ホスト上のメール環境定義ファイルを読み込み，メールを送信します。

ただし，このオプションを省略した場合は，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。クラスタでJP1/IM - Managerを運用していない場合は指定する必要はありません。

注意事項

コマンドラインに指定したメールの主題，および本文は，メール環境定義ファイルに指定した文字コードの範囲で指定してください。メール環境定義ファイルの詳細については，「メール環境定義ファイル（jimmail.conf）」（2.　定義ファイル）を参照してください。

自動アクションやコマンド実行（コマンドボタン）でjimmailコマンドを実行する場合，イベント情報を引き継ぐ際にイベント情報に次に示す制御文字が含まれていると，その制御文字は半角スペース（0x20）に変換されて処理されます。

半角スペースに変換される制御文字：0x01〜0x1F（タブ（0x09）を除く），0x7F

例えば，$EVMSGの指定によって取得したメッセージの中に改行コード（0x0A）が含まれていた場合，改行コード（0x0A）は半角スペース（0x20）に変換されて処理されます。

戻り値

戻り値

説明

0

正常終了

1

引数エラー

2

送信先メールアドレスが指定されていない

3

メール環境定義ファイルの読み込みエラー

4

メール環境定義ファイルのフォーマットエラー

（設定値不正，必須項目未指定，パラメーター不正）

5

SMTPサーバへの接続でタイムアウトが発生した

6

SMTPサーバがログインを拒否した

7

SMTPサーバへの接続に失敗した

8

POP3サーバへの接続でタイムアウトが発生した

9

POP3サーバがログインを拒否した

10

POP3サーバへの接続に失敗した

11

メール送信処理に失敗した

12

メモリー不足が発生した

13

実行権限エラー

255

その他のエラー

使用例

自動アクションで，監視対象ホスト（gyoumu001）の障害をマネージャーホスト（jp1imhost001）からシステム管理者（user@hitachi.com）にメール通知する例と，送信されるメール内容の例を次に示します。

jimmail.exe -to user@hitachi.com -s "[重大度:$EVSEV] 障害発生通知" -b "業務サーバで障害が発生しました。¥n---¥nイベントDB内通し番号=$EVSEQNO¥nイベント発生日時=$EVDATE $EVTIME¥nイベントID=$EVIDBASE¥n重大度=$EVSEV¥nプロダクト名=$EV"PRODUCT_NAME"¥nメッセージ=$EVMSG¥n---¥nFrom:IM-Mホスト($ACTHOST)"

［通知メール例］

送信元（From）

admin@hitachi.com

送信先（To）

user@hitachi.com

メールの主題

[重大度:Error]障害発生通知

メールの本文

業務サーバで障害が発生しました。

---

イベントDB内通し番号=1234567

イベント発生日時=2014/01/01 10:00:00

イベントID=000A

重大度=Error

プロダクト名=/HITACHI/XXXXX/JP1

メッセージ=業務サーバでシステムエラーが発生しました

---

From:IM-Mホスト(jp1imhost001)

jimmailpasswd（Windows限定）

機能

POP before SMTPまたはSMTP-AUTH認証のパスワードをメール環境定義ファイルに設定します。このコマンドは，JP1/IM - Managerサービスの起動状態に関係なく単体で実行できます。

このコマンドを実行する前に，メール環境定義ファイルに次の項目を設定してください。

AuthMethodパラメーターに「POP」または「SMTP」を指定する

AuthUserパラメーターに認証アカウント名を指定する

これらのパラメーターを設定しないでコマンドを実行した場合，KAVB8714-EまたはKAVB8736-Eメッセージを出力して異常終了します。

形式

jimmailpasswd {-p 新しい認証パスワード | -d}
              [-rh 論理ホスト名]

実行権限

Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

格納先ディレクトリ

Consoleパス¥bin¥

引数

-p 新しい認証パスワード

POP before SMTPまたはSMTP-AUTH認証を使用してメールサーバに接続する場合の認証パスワードをメール環境定義ファイルに設定するオプションです。

オプションの引数には，認証パスワードを1〜127バイトの範囲で指定します。引数の認証パスワードの指定は省略できません。

指定できる文字は制御文字（0x00〜0x1F，0x7F〜0x9F）を除く半角文字だけで，マルチバイト文字は指定できません。パスワードは大文字・小文字を区別します。

オプションの引数にパスワードを指定しなかった場合，KAVB8704-Eメッセージが出力され，異常終了します。

-d

メール環境定義ファイルから認証パスワードを削除するオプションです。

このオプションを指定してコマンドを実行するとメール環境定義ファイルのAuthPasswordパラメーターの設定値（パスワード部分）を削除します。

-dオプションは，-pオプションと同時に指定はできません。

-rh 論理ホスト名

クラスタでJP1/IM - Managerを運用している場合に，jimmailコマンドが物理ホスト上，または論理ホストの共有フォルダ上に格納した，どちらのメール環境定義ファイルを使用するか指定するオプションです。

このオプションを指定した場合，指定した論理ホスト名の共有フォルダ上のメール環境定義ファイルに認証パスワードを設定します。

このオプションを省略した場合は，物理ホスト上のメール環境定義ファイルに認証パスワードを設定します。

ただし，このオプションを省略した場合は，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合は，物理ホスト名が仮定されます。クラスタでJP1/IM - Managerを運用していない場合は指定する必要はありません。

使用例1

認証パスワード"ABCD"をメール環境定義ファイルに設定する場合

$ jimmailpasswd -p ABCD
KAVB8731-I コマンド（jimmailpasswd）を開始しました
KAVB8730-I パスワードの設定に成功しました
KAVB8732-I コマンド（jimmailpasswd）が正常終了しました

使用例2

認証パスワード"ABCD"を論理ホスト（ronri）上のメール環境定義ファイルに設定する場合

$ jimmailpasswd -p ABCD -rh ronri
KAVB8731-I コマンド（jimmailpasswd）を開始しました
KAVB8730-I パスワードの設定に成功しました
KAVB8732-I コマンド（jimmailpasswd）が正常終了しました

使用例3

認証パスワードをメール環境定義ファイルから削除する場合

$ jimmailpasswd -d
KAVB8731-I コマンド（jimmailpasswd）を開始しました
KAVB8734-I パスワードの削除に成功しました
KAVB8732-I コマンド（jimmailpasswd）が正常終了しました

jimnodecount

機能

JP1/IM - Managerの管理ノードをカウントします。また，管理ノードとしてカウントしたホストの一覧を管理ノードリストファイルに出力します。

このコマンドは，JP1/IM - Managerの起動状態に関係なく，単体で実行できます。

このコマンドでカウントの対象となるJP1/IM - Managerの管理ノードとは，構成定義情報で定義したホストのJP1/Base，およびリモートの監視対象ホストです。

構成定義に定義していないホストのJP1/Baseは，管理ノードとしてカウントされません。ユーザー自身でカウントしてください。

形式

jimnodecount[ -h 論理ホスト名| -m]
            [ -o 出力ファイル名]

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Managerパス¥bin¥

UNIXの場合

/opt/jp1imm/bin/

引数

-h 論理ホスト名

クラスタシステムでJP1/IM - Managerを運用している場合に，jimnodecountコマンドが物理ホスト，または論理ホストのどちらの管理ノードをカウントするか指定するオプションです。

-hオプションを指定した場合は，指定した論理ホストの管理ノードをカウントします。

-hオプションを省略した場合は，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEに論理ホスト名を設定していない場合は，物理ホストの管理ノードをカウントします。

クラスタシステムでJP1/IM - Managerを運用していない場合，指定は不要です。

-m

クラスタシステムでJP1/IM - Managerを運用している場合に，jimnodecountコマンドが物理ホスト，および論理ホストすべての管理ノードの合計値をカウントするオプションです。

-mオプションを指定した場合は，全管理ノードをカウントします。

-mオプションを省略した場合は，環境変数JP1_HOSTNAMEに指定した論理ホストの管理ノードをカウントします。環境変数JP1_HOSTNAMEに論理ホスト名を設定していない場合は，物理ホストの管理ノードをカウントします。

-o 出力ファイル名

管理ノードの一覧を出力する，管理ノードリストファイルを指定するオプションです。出力先に同名のファイルがすでにある場合は，ファイル内容を上書きします。

出力ファイル名は，相対パス，または絶対パス形式で指定します。出力ファイル名を相対パスで指定した場合は，jimnodecountコマンドを実行したカレントディレクトリからの相対パスに，管理ノードリストファイルを出力します。ファイル名が「-」で始まるファイルを指定する場合は，オプション指定との区別をするため，「-」で始まらないように，ディレクトリを含む相対パス（「./-hoge」など），または，絶対パスで指定してください。指定できるファイル名は，パスを含めて250バイト以内です。

出力ファイル名にネットワークパスを指定できません。

また，実行環境がWindowsの場合，次に示す文字列はファイル名には指定できません。

「:」，「?」，「"」，「<」，「>」，「|」の文字。

CON，PRN，AUX，NUL，COM1，COM2，COM3，COM4，COM5，COM6，COM7，COM8，COM9，LPT1，LPT2，LPT3，LPT4，LPT5，LPT6，LPT7，LPT8，LPT9のどれかと完全一致する（小文字も含む）文字列。

出力形式

jimnodecountコマンドを実行すると，管理ノード数は次の形式で出力されます。

なお，コマンド実行時にエラーが発生した場合は，管理ノード数は出力されません。

管理ノード数

注意事項

クラスタシステムで複数の論理ホストのJP1/IM - Managerが，同一ホストを管理ノードとして管理している構成では，jimnodecountコマンドに-mオプションを指定して実行した場合，該当のホストが重複してカウントされます。運用に合わせて管理ノード数を減算してください。

戻り値

0

正常終了

43

リモート構成の反映中，またはjcfimportコマンドの実行中にjimnodecountコマンドを実行した

84

引数エラー

85

実行権限エラー

127

その他のエラー

管理ノードリストファイルの形式

管理ノードリストファイルの形式を次に示します。なお，各行の先頭の番号（1〜12）は行番号を示しています。実際のファイルには行番号は出力されません。

 1  出力時刻
 2  The number of managed nodes : 管理ノード数
 3  M  /マネージャーのホスト名
 4  B  /マネージャーのホスト名/構成定義情報で定義したホストのJP1/Baseのホスト名
 5  R  /マネージャーのホスト名/リモートの監視対象ホストのホスト名
 6  BR /マネージャーのホスト名/構成定義情報で定義したホストのJP1/Baseかつリモートの監視対象ホストのホスト名
 7  B  /マネージャーのホスト名/拠点マネージャーのホスト名
 8  B  /マネージャーのホスト名/拠点マネージャーのホスト名/構成定義情報で定義したホストのJP1/Baseのホスト名
 9  R  /マネージャーのホスト名/拠点マネージャーのホスト名/リモートの監視対象ホストのホスト名
10  BR /マネージャーのホスト名/拠点マネージャーのホスト名/構成定義情報で定義したホストのJP1/Baseかつリモートの監視対象ホストのホスト名
11  B  /マネージャーのホスト名/中継マネージャーのホスト名
12  B  /マネージャーのホスト名/中継マネージャーのホスト名/構成定義情報で定義したホストのJP1/Baseのホスト名

2行目〜12行目が管理ノードブロックになります。管理ノードブロックは，2行目の管理ノード数と3行目〜12行目の管理ノードリストから構成されます。

管理ノードリストファイルの出力形式

出力時刻

jimnodecountコマンドを実行し，管理ノードリストファイルを出力した時刻を出力します。

YYYY/MM/DD hh:mm:ss

（YYYY：年，MM：月，DD：日，hh：時間，mm：分，ss：秒）

管理ノードブロック

出力形式を次に示します。

The number of managed nodes : 管理ノード数

カウントされた管理ノード数が出力されます。

管理ノード数リスト

管理ノードの種別/ホスト名[/ホスト名...]

管理ノードの種別について次に説明します。

種別

説明

M△△

jimnodecountコマンドを実行したマネージャーを示す。

B△△

jimnodecountコマンドを実行したマネージャー以外の構成定義情報で定義したホストのJP1/Baseを示す。

R△△

リモートの監視対象ホストを示す。

BR△

構成定義情報で定義したホストのJP1/Base，かつリモートの監視対象ホストを示す。

（凡例）△：半角スペース

管理ノードブロックは-mオプションの指定の有無で出力形式が異なります。

-mオプションの指定がない場合

-mオプションの指定がない場合，出力される管理ノードブロックは一つです。

-mオプションの指定がない場合の出力例を次に示します。

統合マネージャー

拠点マネージャー

エージェント

物理ホスト（kanri）

tokyo

jp1ag1

osaka

rhost1

jp1ag2

2016/04/28 09:00:00
The number of managed nodes : 6
M  /kanri
B  /kanri/tokyo
B  /kanri/tokyo/jp1ag1
B  /kanri/osaka
R  /kanri/osaka/rhost1
BR /kanri/osaka/jp1ag2

-mオプションの指定がある場合

-mオプションの指定がある場合，出力される管理ノードブロックは複数あります。管理ノードブロックが出力される順番は，物理ホスト，論理ホストの順番です。論理ホストが複数存在する場合は，論理ホスト名の昇順で出力されます。

-mオプションの指定がある場合の出力例を次に示します。

統合マネージャー

拠点マネージャー

エージェント

物理ホスト（kanri）

tokyo

jp1ag1

論理ホスト（kanriL1）

osakaA

jp1ag2

osakaB

jp1ag3

論理ホスト（kanriL2）

nagoyaA

jp1ag4

論理ホスト（kanriL3）

nagoyaB

jp1ag5

2016/11/26 09:00:00
The number of managed nodes : 3
M  /kanri
B  /kanri/tokyo
B  /kanri/tokyo/jp1ag1
The number of managed nodes : 5
M  /kanriL1
B  /kanriL1/osakaA
B  /kanriL1/osakaA/jp1ag2
B  /kanriL1/osakaB
B  /kanriL1/osakaB/jp1ag3
KAVB8201-E またはKAVB8202-Eの英語メッセージ※
The number of managed nodes : 3
M  /kanriL3
B  /kanriL3/nagoyaB
B  /kanriL3/nagoyaB/jp1ag5

注※　論理ホスト（kanriL2）の管理ノード数カウントに失敗すると，KAVB8201-EまたはKAVB8202-Eの英語メッセージが出力されます。メッセージの詳細については，マニュアル「JP1/Integrated Management 3 - Manager メッセージ」を参照してください。

jp1cc_setup（UNIX限定）

機能

JP1/IM - Manager（セントラルコンソール）の動作環境を設定します。

このコマンドは，JP1/IM - ManagerとJP1/Baseがインストールされているマシン上で，JP1/BaseをアンインストールしたあとでJP1/Baseを再インストールした場合だけ，実行する必要があります。Hitachi PP InstallerによるJP1/IM - Managerの新規インストールまたは上書きインストールをした場合は，実行する必要はありません。

形式

jp1cc_setup

実行権限

スーパーユーザー権限

格納先ディレクトリ

/opt/jp1cons/bin/

戻り値

0

正常終了

1

異常終了

jp1cc_setup_cluster（UNIX限定）

機能

JP1/IM - Manager（セントラルコンソール）の論理ホストの動作環境を設定します。クラスタシステムでの環境設定に使います。

環境設定は，実行系，待機系の順に設定します。

実行系の環境設定では，論理ホスト名と共有ディレクトリ名の指定が必要です。コマンドを実行すると指定した共有ディレクトリに定義ファイルなどがコピーされるため，あらかじめ共有ディスクを使用できる状態にしておいてください。

待機系の環境設定では，論理ホスト名だけを指定します。実行系で設定した情報を基に動作環境を設定します。

なお，待機系の環境設定をする前に，JP1/Baseのjbsgetcnfコマンドとjbssetcnfコマンドを使って，実行系で設定した共通定義情報を待機系にコピーする必要があります。

このコマンドを実行すると，TCP/IP通信で使うソケットのバインド方法がIPバインド方式に変更されます。変更されるのは，作成する論理ホストおよび物理ホストの設定です。TCP/IP通信で使うソケットのバインド方法の詳細については，使用するOSのマニュアルを参照してください。

形式

jp1cc_setup_cluster -h 論理ホスト名
                   [-d 共有ディレクトリ名]

実行権限

スーパーユーザー権限

格納先ディレクトリ

/opt/jp1cons/bin/

引数

-h 論理ホスト名

環境を設定する論理ホストのホスト名を指定します。指定できる文字数は，1〜63バイトです。

論理ホスト名は，hostsファイルやネームサーバに設定し，TCP/IP通信ができるようにしてください。

-d 共有ディレクトリ名

系切り替え時に引き継ぐ情報を格納する共有ディレクトリを指定します。共有ディスク上のディレクトリを指定してください。指定できる文字数は，1〜165バイトです。

指定した共有ディレクトリには，次のディレクトリを作成し，定義ファイルを/etc/opt/jp1cons/conf/からコピーします。作成されたディレクトリには適切な権限が設定されます。設定されたディレクトリの権限を変更しないでください。

表1‒49　jp1cc_setup_clusterコマンド実行で作成されるディレクトリ

格納するファイル種別

ディレクトリ

定義ファイル

共有ディレクトリ名/jp1cons/conf/

ログファイル

共有ディレクトリ名/jp1cons/log/

一時ファイル

共有ディレクトリ名/jp1cons/tmp/

履歴ファイル※

共有ディレクトリ名/jp1cons/operation/

注※ 相関イベント発行機能の処理が履歴として出力されます。

必要に応じて，定義ファイルを変更してください。

注意事項

論理ホストの設定は，各ノード単位で実施してください。

実行系の環境設定をする場合は，あらかじめ共有ディスクを使用できる状態にしてから，jp1cc_setup_clusterコマンドを実行してください。

戻り値

0

正常終了

1

異常終了

使用例

次の条件で設定する例を説明します。

論理ホスト名：lnode0
共有ディスク：/shdsk/lnode0

実行系サーバで論理ホスト環境を設定する

jp1cc_setup_cluster -h lnode0 -d /shdsk/lnode0

待機系サーバで論理ホスト環境を設定する

jp1cc_setup_cluster -h lnode0

jp1cf_setup（UNIX限定）

機能

JP1/IM - ManagerのIM構成管理プロセスの動作環境を設定するコマンドです。

このコマンドは，JP1/IM - ManagerとJP1/Baseがインストールされているマシンで，JP1/Baseをアンインストールしたあと，JP1/Baseを再インストールした場合だけ，実行する必要があります。

形式

jp1cf_setup

実行権限

スーパーユーザー権限

格納ディレクトリ

/opt/jp1imm/bin/imcf

戻り値

0

正常終了

1

異常終了

jp1cf_setup_cluster（UNIX限定）

機能

クラスタシステムで運用する場合に，IM構成管理の環境を設定するコマンドです。

IM構成管理のクラスタセットアップは，論理ホストの実行系，待機系の設定の両方に対応します。-dオプションを指定した場合は，実行系を設定します。-dオプションを指定しなかった場合は，待機系を設定します。

それぞれの設定内容を次の表に示します。

表1‒50　実行系の設定，待機系の設定

コマンド実行ホスト

設定項目

設定概要

実行系

論理ホストの共通定義の設定

jbsgetcnf，jbssetcnfコマンドを使用して物理ホストのIM構成管理の共通定義を論理ホストの共通定義として設定する。その際，ディレクトリ名などの設定を変更する。

共有ディレクトリの作成

共有ディレクトリ以下に必要なディレクトリを作成する。

定義ファイルのコピー

/opt/jp1imm/conf/imcf以下の定義ファイルを共有ディレクトリ/jp1imm/conf/imcf以下にコピーする。

論理ホストのセントラルコンソールに対するIM構成管理の起動設定

jcoimdefコマンドを使用して論理ホストのセントラルコンソールのプロセス管理と連動してIM構成管理サービスが起動するようにする。

物理ホストのIM構成管理の通信方式の変更

物理ホストのIM構成管理の通信方式をIPバインド方式に変更する。

待機系

物理ホストの通信方式の変更

同上

共通定義の設定

IM構成管理のクラスタセットアップは，論理ホストの共通定義に対して次の値を設定します。

表1‒51　論理ホストの共通定義

パス

キー名称

設定値

論理ホスト名¥JP1CONF¥

JP1CONFIG_CONFDIR

共有ディレクトリ名/jp1imm/conf/imcf

JP1CONFIG_TMPDIR

共有ディレクトリ名/jp1imm/tmp

JP1CONFIG_LOGDIR

共有ディレクトリ名/jp1imm/log/imcf

JP1CONFIG_DATADIR

共有ディレクトリ名/jp1imm/data/imcf

JP1_BIND_ADDR

IP

共有ディレクトリの作成

IM構成管理のクラスタセットアップは次のディレクトリを作成します。作成されたディレクトリには適切な権限が設定されます。設定されたディレクトリの権限を変更しないでください。

表1‒52　jp1cf_setup_clusterコマンド実行で作成されるディレクトリ

格納するファイル種別

ディレクトリ

定義ファイル

共有ディレクトリ名/jp1imm/conf/imcf

ログファイル

共有ディレクトリ名/jp1imm/log/imcf

一時ファイル

共有ディレクトリ名/jp1imm/tmp

システムの階層構成（IM構成）のデータおよびプロファイルのデータ

共有ディレクトリ名/jp1imm/data/imcf

論理ホストのセントラルコンソールに対するIM構成管理の起動設定

jcoimdefコマンドを実行し，同一論理ホストのセントラルコンソールのプロセス管理に対してIM構成管理の起動設定を追加します。

物理ホストのIM構成管理の通信方式の変更

IM構成管理のクラスタセットアップは，共通定義JP1_DEFAULT¥JP1CONFIG¥以下のJP1_BIND_ADDRの値をIPに変更することで，物理ホストの通信方式の設定をIPバインド方式に変更します。

形式

jp1cf_setup_cluster  -h 論理ホスト名
                     [-d 共有ディレクトリ名]

実行権限

スーパーユーザー権限

格納先ディレクトリ

/opt/jp1imm/bin/imcf

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，コマンドを実行するホストの論理ホスト名を指定します。その後，指定した論理ホストに対するデータベースを再編成します。指定できる文字数は，1〜63バイトです。このオプションを省略した場合は，エラーとなります。

-d 共有ディレクトリ名

実行系をセットアップする場合，論理ホストの共有ディレクトリを指定します。指定しなかった場合待機系をセットアップします。指定できる文字数は，1〜165バイトです。

戻り値

0

正常終了

1

異常終了

注意事項

実行系の設定の際は，共有ディレクトリへの定義ファイルのコピー，および監視オブジェクトDBの作成をするため，共有ディスクをマウントする必要があります。

論理ホストの設定は各ノード単位でします。

このコマンドを実行すると，TCP/IP通信で使うソケットのバインド方法がIPバインド方式に変更されます。変更されるのは，作成する論理ホストおよび物理ホストの設定です。TCP/IP通信で使うソケットのバインド方法の詳細については，OSのマニュアルを参照してください。

jp1cfhasetup（Windows限定）

機能

クラスタシステムで運用する場合に，IM構成管理の環境を設定するコマンドです。

このコマンドを実行する前に，JP1/Baseの論理ホストを設定する必要があります。

このコマンドを実行すると，TCP/IP通信で使うソケットのバインド方法がIPバインド方式に変更されます。変更されるのは，作成する論理ホストおよび物理ホストの設定です。TCP/IP通信で使うソケットのバインド方法の詳細については，使用するOSのマニュアルを参照してください。

形式

jp1cfhasetup

実行権限

Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

格納先ディレクトリ

Managerパス¥bin¥imcf¥

注意事項

jp1cfhasetupコマンドを実行する場合は，先にjp1cohasetupコマンドを実行してください。

論理ホストの設定は，各ノード単位で実施してください。

事前にJP1/Baseの論理ホストを設定しておく必要があります。JP1/Baseの設定方法については，マニュアル「JP1/Base 運用ガイド」を参照してください。

jp1cohasetup（Windows限定）

機能

JP1/IM - Manager（セントラルコンソール）の論理ホストの動作環境を設定する［Central Consoleクラスタ構成の設定］ダイアログボックスを表示するコマンドです。クラスタシステムでのJP1/IM - Manager（セントラルコンソール）の環境設定で使用します。

このコマンドを実行すると，TCP/IP通信で使うソケットのバインド方法がIPバインド方式に変更されます。変更されるのは，作成する論理ホストおよび物理ホストの設定です。TCP/IP通信で使うソケットのバインド方法の詳細については，使用するOSのマニュアルを参照してください。

形式

jp1cohasetup

実行権限

Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

格納先ディレクトリ

Consoleパス¥bin¥

注意事項

このコマンドは，クラスタシステムでのJP1/IM - Manager（セントラルコンソール）の環境設定で使用します。JP1/IM - Manager（セントラルスコープ）の環境設定をする場合は，jp1cshasetupコマンドを使用してください。

論理ホストの設定は，各ノード単位で実施してください。

事前にJP1/Baseの論理ホストを設定しておく必要があります。JP1/Baseの設定方法については，マニュアル「JP1/Base 運用ガイド」を参照してください。

jp1cohaverup

機能

JP1/IM - Managerで設定した論理ホスト環境をバージョンアップします。論理ホスト環境のJP1/IM - Managerをバージョンアップした場合に実行してください。

形式

jp1cohaverup -h 論理ホスト名

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Consoleパス¥bin¥

UNIXの場合

/opt/jp1cons/bin/

引数

-h 論理ホスト名

バージョンアップする論理ホスト名を指定します。このオプションを省略した場合は，エラーとなります。

注意事項

このコマンドを実行する前に，必ずJP1/IM - Managerを停止してください。JP1/IM - Managerを停止していないときにこのコマンドを実行した場合は，エラーとなります。

このコマンドは実行系ホストでだけ実行します。コマンドの実行時は共有ディスクをマウントした状態で実行してください。なお，待機系ホストでは実行しないでください。

このコマンドを実行したあと，必ず実行系ホストの共通定義情報を退避してください。そのあと，退避した共通定義情報ファイルを待機系ホストにコピーし，jbssetcnfコマンドで設定してください。

同一バージョンに対する修正版を上書きインストールした場合は，このコマンドを実行する必要はありません。

戻り値

0

正常終了

1

異常終了

使用例

論理ホストhost01をバージョンアップします。

jp1cohaverup -h host01

出力例

jp1cohaverup -h host01
KAVB9101-I The upgrading of the logical host environment will now start.
KAVB9102-I The upgrading of the logical host environment has finished.

jp1cs_setup（UNIX限定）

機能

JP1/IM - Manager（セントラルスコープ）の動作環境を設定します。

このコマンドは，JP1/IM - ManagerおよびJP1/Baseがインストールされているマシン上で，JP1/BaseをアンインストールしたあとでJP1/Baseを再インストールした場合だけ，実行する必要があります。Hitachi PP InstallerによるJP1/IM - Managerの新規インストールまたは上書きインストールをした場合は，実行する必要はありません。

このコマンドを使用する場合，JP1/IM - Managerを停止してください。

形式

jp1cs_setup

実行権限

スーパーユーザー権限

格納先ディレクトリ

/opt/jp1scope/bin/

戻り値

0

正常終了

1

異常終了

jp1cs_setup_cluster（UNIX限定）

機能

JP1/IM - Manager（セントラルスコープ）の論理ホストの動作環境を設定します。クラスタでの環境設定に使います。

環境設定は，実行系，待機系の順に設定します。

実行系の環境設定では，論理ホスト名と共有ディレクトリ名の指定が必要です。コマンドを実行すると指定した共有ディレクトリに定義ファイルなどがコピーされるため，あらかじめ共有ディスクを使用できる状態にしておいてください。

待機系の環境設定では，論理ホスト名だけを指定します。実行系で設定した情報を基に動作環境を設定します。

なお，待機系の環境設定をする前に，JP1/Baseのjbsgetcnfコマンドとjbssetcnfコマンドを使って，実行系で設定した共通定義情報を待機系にコピーする必要があります。

このコマンドを使用する場合，JP1/IM - Managerを停止してください。

このコマンドを実行すると，TCP/IP通信で使うソケットのバインド方法がIPバインド方式に変更されます。変更されるのは，作成する論理ホストおよび物理ホストの設定です。TCP/IP通信で使うソケットのバインド方法の詳細については，使用するOSのマニュアルを参照してください。

形式

jp1cs_setup_cluster -h 論理ホスト名
                   [-d 共有ディレクトリ名]

実行権限

スーパーユーザー権限

格納先ディレクトリ

/opt/jp1scope/bin/

引数

-h 論理ホスト名

環境を設定する論理ホストのホスト名を指定します。指定できる文字数は，1〜63バイトです。

論理ホスト名は，hostsファイルやネームサーバに設定し，TCP/IP通信ができるようにしてください。

-d 共有ディレクトリ名

系切り替え時に引き継ぐ情報を格納する共有ディレクトリを指定します。共有ディスク上のディレクトリを指定してください。指定できる文字数は，1〜165バイトです。

指定した共有ディレクトリには，次のディレクトリを作成し，定義ファイルを/etc/opt/jp1scope/conf/からコピーします。作成されたディレクトリには適切な権限が設定されます。設定されたディレクトリの権限を変更しないでください。

表1‒53　jp1cs_setup_clusterコマンド実行で作成されるディレクトリ

格納するファイル種別

ディレクトリ

定義ファイル

共有ディレクトリ名/jp1scope/conf/

ログファイル

共有ディレクトリ名/jp1scope/log/

一時ファイル

共有ディレクトリ名/jp1scope/tmp/

DB情報

共有ディレクトリ名/jp1scope/database/

必要に応じて，定義ファイルを変更してください。

注意事項

論理ホストの設定は，各ノード単位で実施してください。

実行系の環境設定をする場合は，あらかじめ共有ディスクを使用できる状態にしてから，jp1cs_setup_clusterコマンドを実行してください。

戻り値

0

正常終了

1

異常終了

使用例

次の条件で設定する例を説明します。

論理ホスト名：lnode0
共有ディスク：/shdsk/lnode0

実行系サーバで論理ホスト環境を設定する

jp1cs_setup_cluster -h lnode0 -d /shdsk/lnode0

待機系サーバで論理ホスト環境を設定する

jp1cs_setup_cluster -h lnode0

jp1cshasetup（Windows限定）

機能

JP1/IM - Manager（セントラルスコープ）の論理ホストの動作環境を設定する［Central Scopeクラスタ構成の設定］ダイアログボックスを表示するコマンドです。クラスタシステムでのJP1/IM - Manager（セントラルスコープ）の環境設定で使用します。

このコマンドを実行すると，TCP/IP通信で使うソケットのバインド方法がIPバインド方式に変更されます。変更されるのは，作成する論理ホストおよび物理ホストの設定です。TCP/IP通信で使うソケットのバインド方法の詳細については，使用するOSのマニュアルを参照してください。

形式

jp1cshasetup

実行権限

Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

格納先ディレクトリ

Scopeパス¥bin¥

注意事項

このコマンドは，クラスタシステムでのJP1/IM - Manager（セントラルスコープ）の環境設定で使用します。JP1/IM - Manager（セントラルコンソール）の環境設定をする場合は，jp1cohasetupコマンドを使用してください。

論理ホストの設定は，各ノード単位で実施してください。

事前にJP1/Baseの論理ホストの設定をしておく必要があります。JP1/Baseの設定作業については，マニュアル「JP1/Base 運用ガイド」のクラスタシステムで運用する場合の設定の章を参照してください。

また，事前にJP1/IM - Manager（セントラルコンソール）の論理ホストの設定をしておく必要があります。

jp1cshaverup（UNIX限定）

機能

JP1/IM - Managerで設定した論理ホスト環境をバージョンアップします。論理ホスト環境のJP1/IM - Managerをバージョンアップした場合に実行してください。

形式

jp1cshaverup -h 論理ホスト名
             [-w 作業ディレクトリ]

実行権限

スーパーユーザー権限

格納先ディレクトリ

/opt/jp1scope/bin/

注　このコマンドは，Linux版JP1/IM - Managerには同梱されていません。

引数

-h 論理ホスト名

バージョンアップする論理ホスト名を指定します。このオプションを省略した場合は，エラーとなります。

-w 作業ディレクトリ

JP1/IM - Manager（セントラルスコープ）の論理ホスト環境をバージョンアップするための作業ディレクトリをフルパスで指定します。

このオプションを省略した場合は，/opt/jp1scope/tmp/を仮定します。

注意事項

このコマンドを実行する前に，必ずJP1/IM - Managerを停止してください。JP1/IM - Managerを停止していない場合にこのコマンドを実行したときは，エラーとなります。

jp1cshaverupコマンドを実行すると，インストールした新しいバージョンのJP1/IM - Manager（セントラルスコープ）として動作します。08-01以前のJP1/IM - Viewの［監視ツリー(編集中)］画面からはログインできなくなります。

戻り値

0

正常終了

1

指定した論理ホスト名が存在しない

2

引数エラー

4

コマンドを実行する権限がない

12

メモリー不足

13

ディスク容量不足

31

DB初期化エラー

32

データアクセスエラー

42

サービスが起動中

45

新しいバージョンのデータベースに対してコマンドを実行しようとした

99

その他のエラー

使用例

作業ディレクトリ/temp/で，08-01のJP1/IM - Manager（セントラルスコープ）の論理ホスト環境logicalhostをバージョンアップします。

jp1cshaverup -h logicalhost -w /temp

出力例

クラスタ環境のバージョンアップ処理を開始します
KAVB7750-I データベースのバージョンアップは完了しました
KAVB7624-I jcsdbconvertコマンドの実行が正常終了しました
バージョンアップに成功しました

jp1cshaverup.bat（Windows限定）

機能

JP1/IM - Managerで設定した論理ホスト環境をバージョンアップします。論理ホスト環境のJP1/IM - Managerをバージョンアップした場合に実行してください。

形式

jp1cshaverup.bat -h 論理ホスト名
                [-w 作業ディレクトリ]

実行権限

Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

格納先ディレクトリ

Scopeパス¥bin¥

引数

-h 論理ホスト名

バージョンアップする論理ホスト名を指定します。このオプションを省略した場合は，エラーとなります。

-w 作業ディレクトリ

JP1/IM - Manager（セントラルスコープ）の論理ホスト環境をバージョンアップするための作業フォルダをフルパスで指定します。パスに空白を含む場合は，「"」で囲んで指定します。

このオプションを省略した場合は，Scopeパス¥tmp¥を仮定します。

注意事項

このコマンドを実行する前に，必ずJP1/IM - Managerを停止してください。JP1/IM - Managerを停止していない場合にこのコマンドを実行したときは，エラーとなります。

jp1cshaverup.batコマンドを実行すると，インストールした新しいバージョンのJP1/IM - Manager（セントラルスコープ）として動作します。08-01以前のJP1/IM - Viewの［監視ツリー(編集中)］画面からはログインできなくなります。

戻り値

0

正常終了

1

指定した論理ホスト名が存在しない

2

引数エラー

4

コマンドを実行する権限がない

12

メモリー不足

13

ディスク容量不足

31

DB初期化エラー

32

データアクセスエラー

42

サービスが起動中

45

新しいバージョンのデータベースに対してコマンドを実行しようとした

99

その他のエラー

使用例

作業フォルダC:¥temp¥で，08-01のJP1/IM - Manager（セントラルスコープ）の論理ホスト環境logicalhostをバージョンアップします。

jp1cshaverup -h logicalhost -w C:¥temp

出力例

クラスタ環境のバージョンアップ処理を開始します
KAVB7750-I データベースのバージョンアップは完了しました
KAVB7624-I jcsdbconvertコマンドの実行が正常終了しました
バージョンアップに成功しました

jp1csverup（UNIX限定）

機能

08-01以前のJP1/IM - Manager（セントラルスコープ）で設定した物理ホストの環境をバージョンアップします。08-01以前のJP1/IM - Manager（セントラルスコープ）からバージョンアップした場合に実行してください。

インストールした新しいバージョンのJP1/IM - Manager（セントラルスコープ）の機能を使用したい場合には必ず実行してください。ただし，08-01以前の機能範囲で使用したい場合には，実行しないでください。

形式

jp1csverup [-w 作業ディレクトリ]

実行権限

スーパーユーザー権限

格納先ディレクトリ

/opt/jp1scope/bin/

注　このコマンドは，Linux版JP1/IM - Managerには同梱されていません。

引数

-w 作業ディレクトリ

JP1/IM - Manager（セントラルスコープ）の物理ホストの環境をバージョンアップするための作業ディレクトリをフルパスで指定します。

このオプションを省略した場合は，/opt/jp1scope/tmp/を仮定します。

注意事項

このコマンドを実行する前に，必ずJP1/IM - Managerを停止してください。JP1/IM - Managerを停止していない場合にこのコマンドを実行したときは，エラーとなります。

このコマンドを実行する前にディスクの空き容量を確認してください。このコマンドを実行するには，監視オブジェクトDB分の空き容量が必要です。監視オブジェクトDBは，次に示すディレクトリ内のすべてのデータです。

/var/opt/jp1scope/database/jcsdb/

jp1csverupコマンドを実行すると，インストールした新しいバージョンのJP1/IM - Manager（セントラルスコープ）として動作します。08-01以前のJP1/IM - Viewの［監視ツリー(編集中)］画面からはログインできなくなります。

戻り値

0

正常終了

2

引数エラー

4

コマンドを実行する権限がない

12

メモリー不足

13

ディスク容量不足

31

DB初期化エラー

32

データアクセスエラー

42

サービスが起動中

45

新しいバージョンのデータベースに対してコマンドを実行しようとした

99

その他のエラー

使用例

作業ディレクトリ/temp/で，08-01のJP1/IM - Manager（セントラルスコープ）の物理ホスト環境をバージョンアップします。

jp1csverup -w /temp

出力例

バージョンアップ処理を開始します
KAVB7750-I データベースのバージョンアップは完了しました
KAVB7624-I jcsdbconvertコマンドの実行が正常終了しました
バージョンアップに成功しました

jp1csverup.bat（Windows限定）

機能

08-01以前のJP1/IM - Manager（セントラルスコープ）で設定した物理ホストの環境をバージョンアップします。08-01以前のJP1/IM - Manager（セントラルスコープ）からバージョンアップした場合に実行してください。

インストールした新しいバージョンのJP1/IM - Manager（セントラルスコープ）の機能を使用したい場合には必ず実行してください。ただし，08-01以前の機能範囲で使用したい場合には，実行しないでください。

形式

jp1csverup.bat [-w 作業ディレクトリ]

実行権限

Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

格納先ディレクトリ

Scopeパス¥bin¥

引数

-w 作業ディレクトリ

JP1/IM - Manager（セントラルスコープ）の物理ホストの環境をバージョンアップするための作業フォルダをフルパスで指定します。パスに空白を含む場合は，「"」で囲んで指定します。

このオプションを省略した場合は，Scopeパス¥tmp¥を仮定します。

注意事項

このコマンドを実行する前に，必ずJP1/IM - Managerを停止してください。JP1/IM - Managerを停止していない場合にこのコマンドを実行したときは，エラーとなります。

このコマンドを実行する前にディスクの空き容量を確認してください。このコマンドを実行するには，監視オブジェクトDB分の空き容量が必要です。監視オブジェクトDBは，次に示すフォルダ内のすべてのデータです。

Scopeパス¥database¥jcsdb¥

jp1csverup.batコマンドを実行すると，インストールした新しいバージョンのJP1/IM - Manager（セントラルスコープ）として動作します。08-01以前のJP1/IM - Viewの［監視ツリー(編集中)］画面からはログインできなくなります。

戻り値

0

正常終了

2

引数エラー

4

コマンドを実行する権限がない

12

メモリー不足

13

ディスク容量不足

31

DB初期化エラー

32

データアクセスエラー

42

サービスが起動中

45

新しいバージョンのデータベースに対してコマンドを実行しようとした

99

その他のエラー

使用例

作業フォルダC:¥tempで，08-01のJP1/IM - Manager（セントラルスコープ）の物理ホスト環境をバージョンアップします。

jp1csverup -w C:¥temp

出力例

バージョンアップ処理を開始します
KAVB7750-I データベースのバージョンアップは完了しました
KAVB7624-I jcsdbconvertコマンドの実行が正常終了しました
バージョンアップに成功しました

jpc_service

機能

JP1/IM - Agentのアドオンプログラムの有効・無効を設定するコマンドです。

形式

jpc_service {-on | -off} サービス名
                    [-h 論理ホスト名]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

Linuxの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Agentパス¥tools¥

Linuxの場合

/opt/jp1ima/tools/

引数

-on サービス名

サービス名に指定したアドオンプログラムを有効化します。

論理ホストのサービス名は「jpc_アドオンディレクトリ名※_論理ホスト名」ですが，-onオプションには「jpc_アドオンディレクトリ名※」を指定します。

-off サービス名

サービス名に指定したアドオンプログラムを無効化します。

論理ホストのサービス名は「jpc_アドオンディレクトリ名※_論理ホスト名」ですが，-offオプションには「jpc_アドオンディレクトリ名※」を指定します。

-h 論理ホスト名

クラスタシステムで運用している場合に，論理ホスト名を指定します。

注※

アドオンディレクトリ名に指定する値については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「付録A.4(5)アドオンディレクトリについて」を参照してください。

注意事項

引数に指定する文字列に空白および特殊文字を含む場合は，「""」で囲みエスケープする必要があります。

また，次の文字は使用できません。

「"」（ダブルクォーテーション）

「!」（エクスクラメーション）

「%」（パーセント）

「^」（サーカムフレックス）

OracleDB exporterでは，有効・無効の設定はできません。

戻り値

0

サービス有効化・無効化に成功

1

すでにサービスが有効化・無効化されている

10

引数が不正

11

実行権限がない

12

サービスが起動中

13

ほかのコマンドが実行中

251

サービス名が不正

252

必須のサービス（imagent，imagentproxy，imagentaction）が指定された

254

サービス定義ファイルが見つからない

255

サービス有効化・無効化に失敗

ログの出力

出力先

■Windowsの場合

Agentパス¥logs¥tools¥

■Linuxの場合

/opt/jp1ima/logs/tools/

使用例

jpc_service -on jpc_prometheus

jpc_service_autostart

機能

JP1/IM - Agentの自動起動および自動停止の設定をするコマンドです。

imagent，imagentproxy，imagentactionのサービス，および，各サービスが登録されているアドオンプログラムのサービスが対象となります。

Windowsの場合，サービスの「スタートアップの種類」は次のように設定されます。

-on：自動

-off：手動

クラスタ環境の場合は，起動と停止をクラスタソフト側で制御するため，論理ホストでは自動起動および自動停止の設定はできません。

形式

jpc_service_autostart {-on | -off}

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

Linuxの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Agentパス¥tools¥

Linuxの場合

/opt/jp1ima/tools/

引数

-on

アドオンプログラムの自動起動を有効化します。

-off

アドオンプログラムの自動起動を無効化します。

注意事項

引数に指定する文字列に空白および特殊文字を含む場合は，「""」で囲みエスケープする必要があります。

また，次の文字は使用できません。

「"」（ダブルクォーテーション）

「!」（エクスクラメーション）

「%」（パーセント）

「^」（サーカムフレックス）

OracleDB exporterでは，自動起動・自動停止の設定はできません。

戻り値

0

サービス自動起動の有効化・無効化に成功（すべて成功，または，すでに有効化・無効化されていた場合）

10

引数が不正

11

実行権限がない

13

ほかのコマンドが実行中

255

サービス自動起動の有効化・無効化に失敗

ログの出力

出力先

■Windowsの場合

Agentパス¥logs¥tools¥

■Linuxの場合

/opt/jp1ima/logs/tools/

使用例

jpc_service_autostart -on

jpc_service_start

機能

JP1/IM - Agentのサービスを起動するコマンドです。

形式

jpc_service_start -s サービスキー
                          [-h 論理ホスト名]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

Linuxの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Agentパス¥tools¥

Linuxの場合

/opt/jp1ima/tools/

引数

-s サービスキー

サービスキーを指定します。

「all」を指定した場合は，JP1/IM - Agentのすべてのサービスを起動します。

-h 論理ホスト名

クラスタシステムで運用している場合に，論理ホスト名を指定します。

注意事項

引数に指定する文字列に空白および特殊文字を含む場合は，「""」で囲みエスケープする必要があります。

また，次の文字は使用できません。

「"」（ダブルクォーテーション）

「!」（エクスクラメーション）

「%」（パーセント）

「^」（サーカムフレックス）

OracleDB exporterの起動はできません。

戻り値

0

サービスの起動に成功（すべて成功，または，すでに起動済みだった場合）

10

引数が不正

11

実行権限がない

13

ほかのコマンドが実行中

251

サービスキーが不正

253

サービスが有効化されていない

255

サービスの起動に失敗

ログの出力

出力先

■Windowsの場合

Agentパス¥logs¥tools¥

■Linuxの場合

/opt/jp1ima/logs/tools/

使用例

jpc_service_start -s all

jpc_service_stop

機能

JP1/IM - Agentのサービスを停止するコマンドです。

形式

jpc_service_stop -s サービスキー
                         [-f]
                         [-h 論理ホスト名]

実行権限

Windowsの場合：Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

Linuxの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

Agentパス¥tools¥

Linuxの場合

/opt/jp1ima/tools/

引数

-s サービスキー

サービスキーを指定します。

「all」を指定した場合は，JP1/IM - Agentのすべてのサービスを停止します。

-f

サービスを強制停止するオプションです。クラスタ運用時に、起動中のサービスプロセスを強制的に停止させる場合に指定します。

-h 論理ホスト名

クラスタシステムで運用している場合に，論理ホスト名を指定します。

注意事項

引数に指定する文字列に空白および特殊文字を含む場合は，「""」で囲みエスケープする必要があります。

また，次の文字は使用できません。

「"」（ダブルクォーテーション）

「!」（エクスクラメーション）

「%」（パーセント）

「^」（サーカムフレックス）

OracleDB exporterの停止はできません。

戻り値

0

サービスの停止に成功（すべて成功、または，すでに停止済みだった場合）

10

引数不正

11

実行権限がない

13

ほかのコマンドが実行中

251

サービスキーが不正

253

サービスが有効化されていない

255

サービスの停止に失敗

使用例

jpc_service_stop -s all

jpc_stop_node_exporter_aix（AIX限定）

機能

Node exporter for AIXを停止するコマンドです。

このコマンドのログファイルは，OSのシステムログに出力します。

形式

jpc_stop_node_exporter_aix
         [-f]
         [-h 論理ホスト名]

実行権限

スーパーユーザー権限

格納先ディレクトリ

Node exporter for AIXのアーカイブファイル（node_exporter_aix_VVRRSS.tar.Z）の展開先のディレクトリに格納されます。

物理ホストで運用する場合

任意のディレクトリ/node_exporter_aix/jp1ima/bin/

論理ホストで運用する場合

共有ディレクトリ/node_exporter_aix/jp1ima/bin/

引数

-f

サービスを強制停止するオプションです。クラスタ運用時に、起動中のサービスプロセスを強制的に停止させる場合に指定します。

-h 論理ホスト名

クラスタシステムで運用している場合に，論理ホスト名を指定します。

論理ホスト名が8バイト以上の場合は，マニュアル「JP1/Integrated Management 3 - Manager 運用ガイド」の「10.4.2 Node exporter for AIXのサービス」の「(1)サービスの登録の有効化」または「(3)サービスの登録の変更」で，論理ホスト名に指定した7文字以内の任意の文字列を，-hオプションに指定します。

注意事項

物理ホストで運用する場合，このコマンドを実行すると，サービスに登録しているnode_exporter_aixの実行パスがjpc_stop_node_exporter_aixコマンドと別のディレクトリのときは，jpc_stop_node_exporter_aixコマンドは正常終了してサービスは停止しますが，node_exporter_aixのプロセスは起動した状態で残ります。

戻り値

0

サービスの停止に成功（成功、または，すでに停止済みだった場合）

10

引数不正

11

実行権限がない

253

サービスが有効化されていない

255

サービスの停止に失敗

使用例

jpc_stop_node_exporter_aix

jr3slget

機能

jr3slgetコマンドは，SAPシステムのシステムログ情報を抽出します。

形式

jr3slget     ［RFC接続情報］
             ［ターゲット情報］
             ［-lasttime タイムスタンプファイル名］
             ［出力先］
             ［-cnf 環境パラメーター設定ファイル名］
             ［-help］
             ［-v］

コマンドを実行できるホスト

統合エージェントホスト

実行権限

Windowsの場合

なし

Linuxの場合

なし

格納先ディレクトリ

■統合エージェントホスト

Windowsの場合

物理ホストのとき

Windows版のSAPシステム監視のアーカイブファイル※の展開先¥sap_windows¥command¥agtm¥evtrap¥

注※

Agentパス¥options¥sap_windows_VVRRSS.zip

Linuxの場合

物理ホストのとき

Linux版のSAPシステム監視のアーカイブファイル※の展開先/sap_linux/command/agtm/evtrap/

注※

/opt/jp1ima/options/sap_linux_VVRRSS.tar.gz

引数

RFC接続情報

コマンド実行時に，SAPシステムとのRFC接続を確立するための情報を指定します。

環境パラメーター設定ファイルで，RFC接続情報（CONNECTセクション）が指定されている場合，これらの引数の指定を省略できます。環境パラメーター設定ファイルおよびコマンドの両方でRFC接続情報が指定された場合，コマンドでの指定が優先されます。環境パラメーター設定ファイルについては，「jr3slgetコマンドの環境パラメーター設定ファイル（jr3slget.ini）」（2.　定義ファイル）を参照してください。

RFC情報の各引数について説明します。

-h アプリケーションサーバホスト名

接続先のアプリケーションサーバホスト名を指定します。指定できる値は，1〜100バイトの半角英数字です。アプリケーションサーバホスト名は，次の形式で指定できます。

hostsファイルに指定されたホスト名

IPアドレス

SAPルーターアドレス

アプリケーションサーバホスト名は，トランザクションコードSM51で確認できます。

このオプションを指定する場合は，-sオプションも指定する必要があります。

-s システム番号

-hオプションで指定したアプリケーションサーバホストで識別するためのシステム番号を指定します。指定できる値は，0〜99の数値です。

このオプションを指定する場合は，-hオプションも指定する必要があります。

-c クライアント名

接続に利用するユーザーのクライアント名を1〜3バイトで指定します。指定できる値は，0〜999の数値です。

このオプションを指定する場合は，-u，および-pまたは-p2オプションも指定する必要があります。

-u ユーザー名

接続に利用するユーザー名を指定します。指定できる値は，1〜12バイトの半角英数字です。

このオプションを指定する場合は，-c，および-pまたは-p2オプションも指定する必要があります。

指定できるSAPユーザーについては「接続に使用するSAPユーザー」を参照してください。

-p パスワード

-uオプションで指定したユーザーのパスワードを指定します。指定できる値は，1〜8バイトの半角文字列です。

このオプションは，-p2オプションと同時に指定できません。

このオプションを指定する場合は，-c，および-uオプションも指定する必要があります。

このオプションは，SAPシステム側で従来型のパスワードルールが適用されている場合に指定します。

パスワードに指定できる文字については「接続に使用するSAPユーザー」を参照してください。

-p2 拡張パスワード

SAP NetWeaver 7.0以降をベースシステムとした拡張パスワード対応のSAPシステムへ接続する場合，-uオプションで指定したユーザーの拡張パスワードを指定します。指定できる値は，1〜40バイトの半角文字列です。英字の大文字と小文字は区別されます。

このオプションは，-pオプションと同時に指定できません。

このオプションは，SAPシステム側で拡張パスワードルールが適用されている場合に指定します。

このオプションを指定する場合は，-c，および-uオプションも指定する必要があります。

拡張パスワードに指定できる文字については「接続に使用するSAPユーザー」を参照してください。

-l 言語

-uオプションで指定したユーザーの言語を指定します。指定できる値は，SAPシステムで使用されている，2バイトのISO IDまたは1バイトの言語キーです。例えば，次のように指定します。

日本語の場合：JA

日本語以外の場合：EN

このオプションの指定を省略した場合，接続先システムで定義されているユーザーの言語が仮定されます。

このオプションを指定する場合は，-c，-u，および-pまたは-p2オプションも指定する必要があります。

-codepage コードページ

接続先のUnicode版SAPシステムで文字コードを変換するときに使用するコードページを指定します。コードページは，-lオプションの言語と組み合わせて指定する必要があります。

次の組み合わせで設定してください。次の組み合わせ以外の言語とコードページを指定した場合，SAPシステムから取得した情報が文字化けする可能性があります。

表1‒54　言語とコードページの指定内容の組み合わせ

接続先SAPシステム

接続言語

言語（-l）

コードページ（-codepage）

Unicode版

日本語

JA

8000

英語

EN

指定する必要はありません。指定する場合は，1100を指定してください。

非Unicode版

日本語

JA

指定する必要はありません。指定する場合は，8000を指定してください。

英語

EN

指定する必要はありません。指定する場合は，1100を指定してください。

接続先のUnicode版SAPシステムで文字コードを変換するときに使用するコードページは，SAPシステムが提供する環境変数SAP_CODEPAGEでも設定することができます。環境変数SAP_CODEPAGEとこのオプションの両方でコードページが指定された場合は，このオプションの指定が有効となります。

このオプションの指定を省略した場合，接続先システムのデフォルトコードページが仮定されます。このオプションを指定する場合は，-c，-u，および-pまたは-p2オプションも指定する必要があります。

ターゲット情報

抽出対象のシステムログ情報を特定するための情報を指定します。

環境パラメーター設定ファイルでターゲット情報（TARGETセクション）が指定されている場合は，この引数の指定を省略できます。環境パラメーター設定ファイルおよびコマンドの両方でターゲット接続情報が指定された場合，コマンドでの指定が優先されます。環境パラメーター設定ファイルについては，「jr3slgetコマンドの環境パラメーター設定ファイル（jr3slget.ini）」（2.　定義ファイル）を参照してください。

ターゲット情報の引数について説明します。

-server SAPインスタンス名

システムログを採取しているSAPインスタンス名を指定します。指定できる値は，1〜20バイトの半角英数字です。1つのSAPインスタンス名だけ指定できます。SAPインスタンス名は，トランザクションコードSM50やSM66などで確認できます。

-lasttime タイムスタンプファイル名

前回のコマンド実行時以降に出力されたシステムログ情報だけを抽出する場合に，前回の抽出時刻を管理するためのタイムスタンプファイル名を指定します。

指定できる値は，1〜255バイトの半角文字列です。

相対パスで指定する場合，コマンドの作業ディレクトリからの相対パスを指定してください。ただし，環境パラメーター設定ファイルのCOMMANDセクションのWORKDIRラベルで，コマンドの作業ディレクトリを指定していない場合，カレントディレクトリからの相対パスを指定してください。

このオプションの指定を省略した場合，コマンド実行日の0時0分0秒から23時59分59秒までの期間が仮定されます。

このオプションの初回実行時に，指定したタイムスタンプファイルが存在しない場合，新規に作成されます。初回実行時は，システムログ情報が出力されません。

出力先

システムログ情報の出力先を指定します。このオプションの指定を省略した場合，システムログ情報は，改行コードで区切られてコマンドの標準出力に出力されます。

システムログ情報の出力ファイルの形式には，次の2種類があります。

WRAP1

システムログ情報が一定の容量に達すると，ラップアラウンドして再び先頭からデータを上書きする形式のファイルです。出力ファイル数は，1つです。

WRAP2

システムログ情報が一定の容量に達してラップアラウンドするとき，データを削除して再び先頭からデータを書き込む形式のファイルです。1つ目のファイルが一定の容量に達すると，ラップアラウンドして2つ目のファイルに書き込みます。このとき，2つ目のファイルのデータを削除し，先頭からデータを書き込みます。複数のファイルすべてで一定の容量に達すると，1つ目のファイルに戻ってデータを削除し，先頭からデータを書き込みます。

出力ファイルは2〜9個用意できます。デフォルトは5個です。出力ファイルの個数は，環境パラメーター設定ファイルのEXTRACTFILEセクションのNUMラベルで指定します。

出力ファイルの形式を変更する場合は，事前に出力ファイルを監視している製品を停止し，出力ファイルとその管理ファイル（存在する場合）を削除してください。

出力先の各引数について説明します。

-x WRAP1形式の格納ファイル名

システムログ情報を出力するWRAP1形式のファイル名を，相対パスまたはフルパスで指定します。指定できる値は，1〜251バイトの半角文字列です。

相対パスで指定する場合，コマンドの作業ディレクトリからの相対パスを指定してください。ただし，環境パラメーター設定ファイルのCOMMANDセクションのWORKDIRラベルで，コマンドの作業ディレクトリを指定していない場合，カレントディレクトリからの相対パスを指定してください。

このファイルの先頭には，管理情報として1行のヘッダーがあります。

ファイルサイズのデフォルトは10,240キロバイトです。ファイルサイズを変更する場合は，環境パラメーター設定ファイルのEXTRACTFILEセクションのSIZEラベルで指定してください。

出力ファイルと同じディレクトリに，出力ファイル名.ofsという名称で管理ファイルが作成されます。たとえば，出力ファイル名としてSYSLOGを指定したときSYSLOGファイルとは別にSYSLOG.ofsファイルが管理ファイルとして作成されます。出力ファイルを削除する場合は，この管理ファイルも合わせて削除してください。

-xオプション，-x2オプション，-xwオプションは同時に指定できません。

-xw WRAP2形式複数面出力の格納ファイル名

システムログ情報を格納するWRAP2形式のファイル名を指定します。指定できる値は，1〜254バイトの半角文字列です。ファイル名は，指定されたファイル名の末尾に1バイトの数字が付与された名称で格納されます。

ここで付与される数字は，環境パラメーター設定ファイルのEXTRACTFILEセクションのNUMラベルで設定した値を基に，1〜「NUMラベルの値」の範囲で付与されます。例えば，"SYSLOG"を指定した場合，デフォルトではSYSLOG1〜SYSLOG5まで格納ファイルを生成します。

相対パスで指定する場合，コマンドの作業ディレクトリからの相対パスを指定してください。ただし，環境パラメーター設定ファイルのCOMMANDセクションのWORKDIRラベルで，コマンドの作業ディレクトリを指定していない場合，カレントディレクトリからの相対パスを指定してください。

ファイルサイズのデフォルトは10,240キロバイトです。ファイルサイズを変更する場合は，環境パラメーター設定ファイルのEXTRACTFILEセクションのSIZEラベルで指定してください。

-xwオプション，-xオプション，-x2オプションは同時に指定できません。

-x2

環境パラメーター設定ファイルのEXTRACTFILEセクションのX2PATHラベルで設定したファイルに，システムログ情報を出力する場合に指定します。

-x2オプション，-xオプション，-xwオプションは同時に指定できません。

-cnf 環境パラメーター設定ファイル名

コマンドが参照する環境パラメーター設定ファイル名を指定します。指定できる値は，1〜255バイトの半角文字列です。

相対パスで指定する場合，コマンドのカレントディレクトリからの相対パスを指定してください。

このオプションの指定を省略した場合，カレントディレクトリ下のデフォルト環境パラメーター設定ファイルjr3slget.iniが仮定されます。デフォルト環境パラメーター設定ファイルが存在しない場合は，JP1/IM - Agentでのデフォルトの設定値が仮定されます。

環境パラメーター設定ファイルおよびデフォルトの設定値については，「jr3slgetコマンドの環境パラメーター設定ファイル（jr3slget.ini）」（2.　定義ファイル）を参照してください。

-help

jr3slgetコマンドの使用方法を標準出力に出力します。

-v

標準出力にjr3slgetコマンドの処理状況を示すメッセージを出力します。このオプションの指定を省略した場合，コマンドの処理状況を示すメッセージは出力されません。

接続に使用するSAPユーザー

jr3slgetコマンドはシステムログ情報を収集するために，SAP社の通信プロトコルであるRFCを使用して，SAPシステム側に定義されている外部管理インターフェースを実行します。そのため，jr3slgetコマンドが接続に使用するユーザーをあらかじめSAPシステム側に用意しておく必要があります。

ここでは，SAPシステム側に作成するSAPユーザーのユーザータイプ，パスワード，権限について説明します。

ユーザータイプ

JP1/IM - Agentで使用するSAPユーザーには，次のタイプのユーザーが使用できます。

ダイアログ（Dialog）

システム（System）

通信（Communication）

サービス（Service）

パスワードに指定できる文字

SAPユーザーのパスワードは，半角数字（0〜9），半角英字（a〜z，A〜Z），および次の半角記号で定義してください。

! @ $ % & / ( ) = ? ' ` * + ~ # - _ . : { [ ] } < > |

必要な権限

ユーザーには次の権限（権限オブジェクト）を設定する必要があります。

ユーザーが汎用モジュールにRFC接続するための権限（S_RFC）

外部管理インターフェースを使用するための権限（S_XMI_PROD）

各権限の値として，次の表に示す値またはすべての項目に「*」を指定したビルトイン権限値（S_RFC_ALLやS_XMI_ADMIN）を割り当ててください。

表1‒55　ユーザーが汎用モジュールにRFC接続するための権限（S_RFC）

権限項目

説明

値

RFC_TYPE

保護されるRFCオブジェクトのタイプ

FUGR（汎用グループ）

RFC_NAME

保護されるRFC名

*

ACTVT

アクティビティ

16（実行）

表1‒56　外部管理インターフェースを使用するための権限（S_XMI_PROD）

権限項目

説明

値

EXTCOMPANY

外部管理ツールの会社名

HITACHI

EXTPRODUCT

外部管理ツールのプログラム名

JP1

INTERFACE

インターフェースID

*

注意事項

リモート監視機能を使用する場合，コマンドの引数に指定するRFC接続情報やターゲット情報，および環境パラメーター設定ファイルのCONNECTセクションには，監視対象のSAPシステムの情報（ホスト名やインスタンス名など）を指定してください。

出力形式および内容

SAPシステムのトランザクションコードSM21で確認できるシステムログ情報（パラメーターレコード行を含む）を抽出します。

システムログ情報は，デフォルトでは次の形式で出力されます。<　>は，フィールドIDを示します。

システムログ情報の各値が，各フィールドに対して決められた長さに満たない場合，半角の空白で埋められます。出力される各値について次に説明します。

表1‒57　出力されるシステムログ情報の内容

フィールドID

意味

長さ（単位：バイト）

<TIME>

メッセージ記録時刻（HH:MM:SS）

8

<INSTANCE>

メッセージを記録したサーバ

20

<USER>

メッセージを記録したユーザー

12

<PROGRAM>

メッセージを記録したプログラム

8

<MSGNO>

メッセージ番号

3

<MSGTEXT>

メッセージテキスト

255

戻り値

0

正常終了した。

1以上

異常終了した。

使用例

SAPインスタンスo246bci_SD5_00のシステムログ情報を出力する場合のコマンド実行例を次に示します。RFC接続情報は，環境パラメーター設定ファイルで定義済みであることを前提としています。

jr3slget -server o246bci_SD5_00

このコマンドの出力例を次に示します。

jr3alget

機能

jr3algetコマンドは，SAPシステムのCCMSアラート情報を抽出します。

形式

jr3alget     ［RFC接続情報］
             ［ターゲット情報］
             ［-lasttime タイムスタンプファイル名］
             ［出力先］
             ［-cnf 環境パラメーター設定ファイル名］
             ［-help］
             ［-v］

コマンドを実行できるホスト

統合エージェントホスト

実行権限

Windowsの場合

なし

Linuxの場合

なし

格納先ディレクトリ

■統合エージェントホスト

Windowsの場合

物理ホストのとき

Windows版のSAPシステム監視のアーカイブファイル※の展開先¥sap_windows¥command¥agtm¥evtrap¥

注※

Agentパス¥options¥sap_windows_VVRRSS.zip

Linuxの場合

物理ホストのとき

Linux版のSAPシステム監視のアーカイブファイル※の展開先/sap_linux/command/agtm/evtrap/

注※

/opt/jp1ima/options/sap_linux_VVRRSS.tar.gz

引数

RFC接続情報

コマンド実行時に，SAPシステムとのRFC接続を確立するための情報を指定します。

環境パラメーター設定ファイルで，RFC接続情報（CONNECTセクション）が指定されている場合，これらの引数の指定を省略できます。環境パラメーター設定ファイルおよびコマンドの両方でRFC接続情報が指定された場合，コマンドでの指定が優先されます。環境パラメーター設定ファイルについては，「jr3algetコマンドの環境パラメーター設定ファイル（jr3alget.ini）」（2.定義ファイル）を参照してください。

RFC情報の各引数について説明します。

-h アプリケーションサーバホスト名

接続先のアプリケーションサーバホスト名を指定します。指定できる値は，1〜100バイトの半角英数字です。アプリケーションサーバホスト名は，次の形式で指定できます。

hostsファイルに指定されたホスト名

IPアドレス

SAPルーターアドレス

アプリケーションサーバホスト名は，トランザクションコードSM51で確認できます。

このオプションを指定する場合は，-sオプションも指定する必要があります。

-s システム番号

-hオプションで指定したアプリケーションサーバホストで識別するためのシステム番号を指定します。指定できる値は，0〜99の数値です。

このオプションを指定する場合は，-hオプションも指定する必要があります。

-c クライアント名

接続に利用するユーザーのクライアント名を1〜3バイトで指定します。指定できる値は，0〜999の数値です。

このオプションを指定する場合は，-u，および-pまたは-p2オプションも指定する必要があります。

-u ユーザー名

接続に利用するユーザー名を指定します。指定できる値は，1〜12バイトの半角英数字です。

このオプションを指定する場合は，-c，および-pまたは-p2オプションも指定する必要があります。

指定できるSAPユーザーについては「接続に使用するSAPユーザー」を参照してください。

-p パスワード

-uオプションで指定したユーザーのパスワードを指定します。指定できる値は，1〜8バイトの半角文字列です。

このオプションは，-p2オプションと同時に指定できません。

このオプションを指定する場合は，-c，および-uオプションも指定する必要があります。

このオプションは，SAPシステム側で従来型のパスワードルールが適用されている場合に指定します。

パスワードに指定できる文字については「接続に使用するSAPユーザー」を参照してください。

-p2 拡張パスワード

SAP NetWeaver 7.0以降をベースシステムとした拡張パスワード対応のSAPシステムへ接続する場合，-uオプションで指定したユーザーの拡張パスワードを指定します。指定できる値は，1〜40バイトの半角文字列です。英字の大文字と小文字は区別されます。

このオプションは，-pオプションと同時に指定できません。

このオプションを指定する場合は，-c，および-uオプションも指定する必要があります。

このオプションは，SAPシステム側で拡張パスワードルールが適用されている場合に指定します。

拡張パスワードに指定できる文字については「接続に使用するSAPユーザー」を参照してください。

-l 言語

-uオプションで指定したユーザーの言語を指定します。指定できる値は，SAPシステムで使用されている，2バイトのISO IDまたは1バイトの言語キーです。例えば，次のように指定します。

日本語の場合：JA

日本語以外の場合：EN

このオプションの指定を省略した場合，接続先システムで定義されているユーザーの言語が仮定されます。

このオプションを指定する場合は，-c，-u，および-pまたは-p2オプションも指定する必要があります。

-codepage コードページ

接続先のUnicode版SAPシステムで文字コードを変換するときに使用するコードページを指定します。コードページは，-lオプションの言語と組み合わせて指定する必要があります。

次の組み合わせで設定してください。次の組み合わせ以外の言語とコードページを指定した場合，SAPシステムから取得した情報が文字化けする可能性があります。

表1‒58　言語とコードページの指定内容の組み合わせ

接続先SAPシステム

接続言語

言語（-l）

コードページ（-codepage）

Unicode版

日本語

JA

8000

英語

EN

指定する必要はありません。指定する場合は，1100を指定してください。

非Unicode版

日本語

JA

指定する必要はありません。指定する場合は，8000を指定してください。

英語

EN

指定する必要はありません。指定する場合は，1100を指定してください。

接続先のUnicode版SAPシステムで文字コードを変換するときに使用するコードページは，SAPシステムが提供する環境変数SAP_CODEPAGEでも設定することができます。環境変数SAP_CODEPAGEとこのオプションの両方でコードページが指定された場合は，このオプションの指定が有効となります。

このオプションの指定を省略した場合，接続先システムのデフォルトコードページが仮定されます。このオプションを指定する場合は，-c，-u，および-pまたは-p2オプションも指定する必要があります。

ターゲット情報

抽出対象のCCMSアラート情報を特定するための情報を指定します。

環境パラメーター設定ファイルでターゲット情報（TARGETセクション）が指定されている場合は，これらの引数の指定を省略できます。環境パラメーター設定ファイルおよびコマンドの両方でターゲット接続情報が指定された場合，コマンドでの指定が優先されます。環境パラメーター設定ファイルについては，「jr3algetコマンドの環境パラメーター設定ファイル（jr3alget.ini）」（2.　定義ファイル）を参照してください。

ターゲット情報の各引数について説明します。

-ms モニターセット名

モニターセット名を指定します。指定できる値は，1〜60バイトの半角英数字です。モニターセット名とは，SAPシステムの警告モニター（トランザクションコードRZ20）で，「CCMS監視セット」として表示される名称です。

このオプションを指定する場合は，-mnオプションも指定する必要があります。

-mn モニター名

モニターセット内に定義されているモニター名を指定します。指定できる値は，1〜60バイトの半角英数字です。モニター名とは，SAPシステムの警告モニター（トランザクションコードRZ20）で，CCMS監視セットのツリーに表示される名称です。

このオプションを指定する場合は，-msオプションも指定する必要があります。

-lasttime タイムスタンプファイル名

前回のコマンド実行時以降に出力されたCCMSアラート情報だけを抽出する場合に，前回の抽出時刻を管理するためのタイムスタンプファイル名を指定します。

指定できる値は，1〜255バイトの半角文字列です。

相対パスで指定する場合，コマンドの作業ディレクトリからの相対パスを指定してください。ただし，環境パラメーター設定ファイルのCOMMANDセクションのWORKDIRラベルで，コマンドの作業ディレクトリを指定していない場合，カレントディレクトリからの相対パスを指定してください。

このオプションの指定を省略した場合，コマンド実行日の0時0分0秒から23時59分59秒までの期間が仮定されます。

このオプションの初回実行時に，指定したタイムスタンプファイルが存在しない場合，新規に作成されます。初回実行時は，CCMSアラート情報が出力されません。

出力先

CCMSアラート情報の出力先を指定します。このオプションの指定を省略した場合，CCMSアラート情報は，改行コードで区切られてコマンドの標準出力に出力されます。

CCMSアラート情報の出力ファイルの形式には，次の2種類があります。

WRAP1

CCMSアラート情報が一定の容量に達すると，ラップアラウンドして再び先頭からデータを上書きする形式のファイルです。出力ファイル数は，1つです。

WRAP2

CCMSアラート情報が一定の容量に達してラップアラウンドするとき，データを削除して再び先頭からデータを書き込む形式のファイルです。1つ目のファイルが一定の容量に達すると，ラップアラウンドして2つ目のファイルに書き込みます。このとき，2つ目のファイルのデータを削除し，先頭からデータを書き込みます。複数のファイルすべてで一定の容量に達すると，1つ目のファイルに戻ってデータを削除し，先頭からデータを書き込みます。

出力ファイルは2〜9個用意できます。デフォルトは5個です。出力ファイルの個数は，環境パラメーター設定ファイルのEXTRACTFILEセクションのNUMラベルで指定します。

出力ファイルの形式を変更する場合は，事前に出力ファイルを監視している製品を停止し，出力ファイルとその管理ファイル（存在する場合）を削除してください。

出力先の各引数について説明します。

-x WRAP1形式の格納ファイル名

CCMSアラート情報を格納するWRAP1形式のファイル名を，相対パスまたはフルパスで指定します。指定できる値は，1〜251バイトの半角文字列です。

相対パスで指定する場合，コマンドの作業ディレクトリからの相対パスを指定してください。ただし，環境パラメーター設定ファイルのCOMMANDセクションのWORKDIRラベルで，コマンドの作業ディレクトリを指定していない場合，カレントディレクトリからの相対パスを指定してください。

このファイルの先頭には，管理情報として1行のヘッダーがあります。

ファイルサイズのデフォルトは10,240キロバイトです。ファイルサイズを変更する場合は，環境パラメーター設定ファイルのEXTRACTFILEセクションのSIZEラベルで指定してください。

格納ファイルと同じディレクトリに，格納ファイル名.ofsという名称で管理ファイルが作成されます。たとえば，格納ファイル名としてALERTを指定したとき，ALERTファイルとは別にALERT.ofsファイルが管理ファイルとして作成されます。格納ファイルを削除する場合は，この管理ファイルも合わせて削除してください。

-xオプション，-x2オプション，-xwオプションは同時に指定できません。

-xw WRAP2形式複数面出力の格納ファイル名

CCMSアラート情報を格納するWRAP2形式のファイル名を指定します。指定できる値は，1〜254バイトの半角文字列です。ファイル名は，指定されたファイル名の末尾に1バイトの数字が付与された名称で格納されます。

ここで付与される数字は，環境パラメーター設定ファイルのEXTRACTFILEセクションのNUMラベルで設定した値を基に，1〜「NUMラベルの値」の範囲で付与されます。例えば，"ALERT"を指定した場合，デフォルトではALERT1〜ALERT5まで格納ファイルを生成します。

相対パスで指定する場合，コマンドの作業ディレクトリからの相対パスを指定してください。ただし，環境パラメーター設定ファイルのCOMMANDセクションのWORKDIRラベルで，コマンドの作業ディレクトリを指定していない場合，カレントディレクトリからの相対パスを指定してください。

ファイルサイズのデフォルトは10,240キロバイトです。ファイルサイズを変更する場合は，環境パラメーター設定ファイルのEXTRACTFILEセクションのSIZEラベルで指定してください。

-xwオプション，-xオプション，-x2オプションは同時に指定できません。

-x2

環境パラメーター設定ファイルのEXTRACTFILEセクションのX2PATHラベルで設定したファイルに，CCMSアラート情報を出力する場合に指定します。

-x2オプション，-xオプション，-xwオプションは同時に指定できません。

-cnf 環境パラメーター設定ファイル名

コマンドが参照する環境パラメーター設定ファイル名を指定します。指定できる値は，1〜255バイトの半角文字列です。

相対パスで指定する場合，コマンドのカレントディレクトリからの相対パスを指定してください。

このオプションの指定を省略した場合，カレントディレクトリ下のデフォルト環境パラメーター設定ファイルjr3alget.iniが仮定されます。デフォルト環境パラメーター設定ファイルが存在しない場合，JP1/IM - Agentでのデフォルトの設定値が仮定されます。

環境パラメーター設定ファイルおよびデフォルトの設定値については，「jr3algetコマンドの環境パラメーター設定ファイル（jr3alget.ini）」（2.　定義ファイル）を参照してください。

-help

jr3algetコマンドの使用方法を標準出力に出力します。

-v

標準出力にjr3algetコマンドの処理状況を示すメッセージを出力します。このオプションの指定を省略した場合，コマンドの処理状況を示すメッセージは出力されません。

接続に使用するSAPユーザー

jr3algetコマンドはCCMSアラート情報を収集するために，SAP社の通信プロトコルであるRFCを使用して，SAPシステム側に定義されている外部管理インターフェースを実行します。そのため，JP1/IM - Agentが使用するユーザーをあらかじめSAPシステム側に用意しておく必要があります。

ここでは，SAPシステム側に作成するSAPユーザーのユーザータイプ，パスワード，権限について説明します。

ユーザータイプ

JP1/IM - Agentで使用するSAPユーザーには，次のタイプのユーザーが使用できます。

ダイアログ（Dialog）

システム（System）

通信（Communication）

サービス（Service）

パスワードに指定できる文字

SAPユーザーのパスワードは，半角数字（0〜9），半角英字（a〜z，A〜Z），および次の半角記号で定義してください。

! @ $ % & / ( ) = ? ' ` * + ~ # - _ . : { [ ] } < > |

必要な権限

ユーザーには次の権限（権限オブジェクト）を設定する必要があります。

ユーザーが汎用モジュールにRFC接続するための権限（S_RFC）

外部管理インターフェースを使用するための権限（S_XMI_PROD）

各権限の値として，次の表に示す値またはすべての項目に「*」を指定したビルトイン権限値（S_RFC_ALLやS_XMI_ADMIN）を割り当ててください。

表1‒59　ユーザーが汎用モジュールにRFC接続するための権限（S_RFC）

権限項目

説明

値

RFC_TYPE

保護されるRFCオブジェクトのタイプ

FUGR（汎用グループ）

RFC_NAME

保護されるRFC名

*

ACTVT

アクティビティ

16（実行）

表1‒60　外部管理インターフェースを使用するための権限（S_XMI_PROD）

権限項目

説明

値

EXTCOMPANY

外部管理ツールの会社名

HITACHI

EXTPRODUCT

外部管理ツールのプログラム名

JP1

INTERFACE

インターフェースID

*

注意事項

CCMSアラート情報は，SAPシステム内で1つのリソースとして扱われていて，どのアプリケーションサーバからも参照できるため，接続先のアプリケーションサーバは，任意です。1つのSAPシステムにつき，1つだけコマンドを実行するようにしてください。

リモート監視機能を使用する場合，コマンドの引数に指定するRFC接続情報やターゲット情報，および環境パラメーター設定ファイルのCONNECTセクションには，監視対象のSAPシステムの情報（ホスト名やインスタンス名など）を指定してください。

出力形式および内容

CCMSアラート情報は，デフォルトでは次の形式で出力されます。<　>は，フィールドIDを示します。

CCMSアラート情報の各値が，各フィールドに対して決められた長さに満たない場合，半角の空白で埋められます。出力される各値について次に説明します。

表1‒61　出力されるCCMSアラート情報の内容

フィールドID

意味

参照元

長さ（単位：バイト）

<ALSYSID>

SAPシステムの名称

アラートID（AID）

（BAPIAID）

8

<MSEGNAME>

監視セグメント名

40

<ALUNIQNUM>

AIDで使用される一意のID

10

<ALERTDATE>

アラート発生日付（YYYYMMDD）

8

<ALERTTIME>

アラート発生時刻（HHMMSS）

6

<MTSYSID>

SAPシステムの名称

アラートに関連づけられているMTEのID（TID）

（BAPITID）

8

<MTCLASS>

MTEタイプ

3

<MTNUMRANGE>

番号範囲（常駐,一時など）

3

<MTMCNAME>

監視コンテキスト名

40

<MTUID>

TIDで使用される一意のID

10

<VALUE>

警告値（トランザクションコードRZ20で見るCCMSアラートエントリーの色に対応）

0：灰（無効情報）

1：緑（ＯＫ）

2：黄（警告）

3：赤（問題またはエラー）

アラートの重要度（BAPIALDATA）

11

<SEVERITY>

重大度（0〜255。数値が大きいほど重大）

<FIELDNAME>

MTE略称

一般プロパティ（BAPIALERT）

40

<STATUS>

アラートステータス

11

<OBJECTNAME>

監視オブジェクト名

40

<MANDT>

クライアント

3

<USERID>

SAPユーザー

12

<REPORTEDBY>

報告者（論理名）

16

<STATCHGDAT>

ステータス最終変更日付

8

<STATCHGBY>

ステータス最終変更者（論理名）

16

<STATCHGTIM>

ステータス最終変更時間

6

<MSCGLID>

ログ属性のメッセージがアラートを発生させたときのメッセージ識別

50

<MSGCLASS>

メッセージ記録者

メッセージ

16

<MSGID>

メッセージID

30

<MSGARG1>

メッセージの挿入語句1の文字列

128

<ARGTYPE1>

メッセージの挿入語句1のタイプ

1

<MSGARG2>

メッセージの挿入語句2の文字列

128

<ARGTYPE2>

メッセージの挿入語句2のタイプ

1

<MSGARG3>

メッセージの挿入語句3の文字列

128

<ARGTYPE3>

メッセージの挿入語句3のタイプ

1

<MSGARG4>

メッセージの挿入語句4の文字列

128

<ARGTYPE4>

メッセージの挿入語句4のタイプ

1

<MSGTEXT>

メッセージテキスト

128

<MSG>

翻訳済みメッセージ

255

戻り値

0

正常終了した。

1以上

異常終了した。

使用例

モニターセット名としてSAP CCMS Monitor Templates，モニター名をEntire SystemとしてCCMSアラート情報を出力する場合のコマンド実行例を次に示します。RFC接続情報は，環境パラメーター設定ファイルで定義済みであることを前提としています。

jr3alget -ms "SAP CCMS Monitor Templates" -mn "Entire System"

このコマンドの出力例を次に示します。

promtool

機能

Prometheus serverの定義ファイルの書式チェックとアラートルールのテストを行うコマンドです。

形式

promtool check config Prometheus設定ファイル名
         check rules アラート設定ファイル名
         test rules テストファイル名 ･･･

実行権限

なし

格納先ディレクトリ

Windowsの場合

Agentパス¥tools¥

Linuxの場合

/opt/jp1ima/tools/

引数

check config Prometheus設定ファイル名

Prometheus設定ファイルの書式に誤りがないかをチェックします。

Prometheus設定ファイルの詳細については，「Prometheus設定ファイル（jpc_prometheus_server.yml）」を参照してください。

check rules アラート設定ファイル名

アラート設定ファイルの書式に誤りがないかをチェックします。

アラート設定ファイルの詳細については，「アラート設定ファイル（jpc_alerting_rules.yml）」を参照してください。

test rules テストファイル名 ･･･

テストファイルに記述したアラートルールのテストを実行します。テストファイルは最大10個まで指定できます。

戻り値

0

書式正常，アラートルールのテスト成功

0以外

書式不正，アラートルールのテスト失敗

アラートルールのテストファイルの内容

形式

YAML形式で記述します。

ファイル

任意の名前.yml

記述内容

項目名

説明

デフォルト値

rule_files:

[ - <file_name> ]

テストのために考慮すべきルールファイルをリストで指定します。

ファイル名はワイルドカードで指定できます。

−

[ evaluation_interval: <duration> | default = 1m ]

アラートルールの評価間隔を指定します。

1m

group_eval_order:

[ - <group_name> ]

グループ名の順序を指定できます。

グループ名の順序は，ルールグループの評価の順序（特定の評価時間）になります。指定した順序は，記述したグループ名に対してだけ保証されます。

すべてのグループを記述する必要はありません。

次に示す記述例のように，<rule_files:>に記述したルールファイルの評価順序を指定できます。

＜記述例＞

group_eval_order:

- test02.yml

- test01.yml

−

tests:

[ - <test_group> ]

すべてのテストを列挙します。

−

（凡例）

−：該当なし

<test_group>

項目名

説明

デフォルト値

interval: <duration>

「input_series:」のデータ発生間隔を指定します。

−

input_series:

[ - <series> ]

シリーズのデータを指定します。

−

[ name: <string> ]

<test group>の名前を指定します。

−

alert_rule_test:

[ - <alert_test_case> ]

アラートルールのテストを指定します。

指定したファイルからアラートルールを検討します。

−

（凡例）

−：該当なし

<series>

項目名

説明

デフォルト値

series: <string>

シリーズのデータを次の形式で指定します。

'メトリック名 {ラベル名 = ラベル値, ...}'

＜記述例＞

series_name{label1="value1", label2="value2"}

go_goroutines{job="prometheus", instance="localhost:9090"}

−

values: <string>

発生するデータをスペース区切りで指定します。

次に示す展開表記を使用できます。

＜展開表記の例＞

'a+bxc' becomes 'a a+b a+(2*b) a+(3*b) … a+(c*b)'

'a-bxc' becomes 'a a-b a-(2*b) a-(3*b) … a-(c*b)'

＜記述例＞

'-2+4x3' becomes '-2 2 6 10'

' 1-2x4' becomes '1 -1 -3 -5 -7'

−

（凡例）

−：該当なし

<alert_test_case>

項目名

説明

デフォルト値

eval_time: <duration>

テストを評価する（アラートをチェックする）タイミングを「time = 0s」からの経過時間を指定します。

<test_group>の「interval:」に指定したデータ発生間隔で「eval_time:」に指定した経過時間までを評価します。

例えば，<test_group>の「interval:」に指定したデータ発生間隔が1mで，「eval_time:」に指定した経過時間が5mの場合，「input_series:」で指定したデータの6番目を取得したタイミングで評価されます。

−

alertname: <string>

テストするアラートの名前を指定します。

アラート設定ファイルの「alert:」に記述した値を指定します。

−

exp_alerts:

[ - <alert> ]

発生を期待するアラートの内容をリストで指定します。

アラートルールを実行しないことをテストする場合は，「exp_alerts」の指定を空にします。

−

（凡例）

−：該当なし

<alert>

項目名

説明

デフォルト値

exp_labels:

[ <labelname>: <string> ]

発生を期待するアラートのラベルを指定します。

ラベルには，アラートに関連付けられたサンプルのラベルも含まれます。

−

exp_annotations:

[ <labelname>: <string> ]

発生を期待するアラートの注釈を指定します。

−

（凡例）

−：該当なし

アラート設定ファイルとアラートルールのテストファイルのサンプル

■「up」メトリックの例

アラート設定ファイルの記述例

groups:
- name: alerts
  rules:

  - alert: InstanceDown
    expr: up == 0
    for: 5m
    labels:
        severity: page
    annotations:
        summary: "Instance {{ $labels.instance }} down"
        description: "{{ $labels.instance }} of job {{ $labels.job }} has been down for more than 5 minutes."

アラートルールのテストファイルの記述例

rule_files:
    - jpc_alerting_rules.yml

evaluation_interval: 1m

tests:
    # Test
    - interval: 1m
      # Series data.
      input_series:
          - series: 'up{job="prometheus", instance="localhost:9090"}'
            values: '0 0 0 0 0 0 0 0 0 0 0 0 0 0 0' # success

      # Unit test for alerting rules.
      alert_rule_test:
          # Unit test 1.
          - eval_time: 5m
            alertname: InstanceDown
            # alertname: AnotherInstanceDown
            exp_alerts:
                # Alert 1.
                - exp_labels:
                      severity: page
                      instance: localhost:9090
                      job: prometheus
                  exp_annotations:
                      summary: "Instance localhost:9090 down"
                      description: "localhost:9090 of job prometheus has been down for more than 5 minutes."

■CPUの例

アラート設定ファイルの記述例

groups:
  - name: alerts
    rules:
      - alert: cpu_alert_rule
        expr: sum(rate(windows_cpu_time_total{mode!="idle"}[1m])) < 50
        for: 2m
        labels:
          severity: page
        annotations:
          summary: "CPU alert rule summary"
          description: "CPU alert rule description"

アラートルールのテストファイルの記述例

rule_files:
    - jpc_alerting_rules.yml

evaluation_interval: 1m

tests:
    # Test
    - interval: 1m
      # Series data.
      input_series:
          - series: 'windows_cpu_time_total'
            #values: '0+3000x10' # fail
            values: '0+2800x10'  # success

      # Unit test for alerting rules.
      alert_rule_test:
          # Unit test 1.
          - eval_time: 7m
            alertname: cpu_alert_rule
            exp_alerts:
                # Alert 1.
                - exp_labels:
                      severity: page
                  exp_annotations:
                      summary: "CPU alert rule summary"
                      description: "CPU alert rule description"

■メモリーの例（その1）

アラート設定ファイルの記述例

groups:
  - name: alerts
    rules:
      - alert: memory_alert_rule
        expr: windows_memory_available_bytes < 1073741824
        for: 3m
        labels:
          severity: page
        annotations:
          summary: "Memory alert rule summary"
          description: "Memory alert rule description"

アラートルールのテストファイルの記述例

rule_files:
    - jpc_alerting_rules.yml

evaluation_interval: 1m

tests:
    # Test
    - interval: 1m
      # Series data.
      input_series:
          - series: 'windows_memory_available_bytes'
            values: '1073741822 1073741826 1073741823 1073741823 1073741823 1073741823 1073741828 1073741822' # success
            #values: '1073741822 1073741822 1073741826 1073741823 1073741823 1073741823 1073741828 1073741822' # fail

      # Unit test for alerting rules.
      alert_rule_test:
          # Unit test 1.
          - eval_time: 5m
            alertname: memory_alert_rule
            exp_alerts:
                # Alert 1.
                - exp_labels:
                      severity: page
                  exp_annotations:
                      summary: "Memory alert rule summary"
                      description: "Memory alert rule description"

■メモリーの例（その2）

アラート設定ファイルの記述例

groups:
  - name: alerts
    rules:
      - alert: memory_alert_rule
        expr: windows_memory_available_bytes < 1073741824
        for: 3m
        labels:
          severity: page
        annotations:
          summary: "Memory alert rule summary"
          description: "Memory alert rule description"

アラートルールのテストファイルの記述例

rule_files:
    - jpc_alerting_rules.yml

evaluation_interval: 1m

tests:
    # Test
    - interval: 1m
      # Series data.
      input_series:
          - series: 'windows_memory_available_bytes'
            values: '1073741822 1073741826 1073741823 1073741823 1073741823 1073741823 1073741828 1073741822' # success
            #values: '1073741822 1073741822 1073741826 1073741823 1073741823 1073741823 1073741828 1073741822' # fail

      # Unit test for alerting rules.
      alert_rule_test:
          # Unit test 1.
          - eval_time: 5m
            alertname: memory_alert_rule
            exp_alerts:
                # Alert 1.
                - exp_labels:
                      severity: page
                  exp_annotations:
                      summary: "Memory alert rule summary"
                      description: "Memory alert rule description"

■割り込みの例

アラート設定ファイルの記述例

groups:
  - name: alerts
    rules:
      - alert: alerts_rules_increase
        expr: increase(windows_cpu_interrupts_total{core="0,0"}[3m]) > 100
        for: 0m
        labels:
          severity: critical
        annotations:
          summary: "Alert test case of increase."
          description: "Use increase function in unit test."

      - alert: alerts_rules_increase_all
        expr: sum(increase(windows_cpu_interrupts_total[5m])) > 240
        for: 0m
        labels:
          severity: critical
        annotations:
          summary: "Alert test case of increase."
          description: "Use increase function in unit test."

アラートルールのテストファイルの記述例

rule_files:
    - jpc_alerting_rules.yml

evaluation_interval: 1m

tests:
    # Test
    - interval: 1m
      # Series data.
      input_series:
          - series: 'windows_cpu_interrupts_total{core="0,0"}'
            #values: '0 10 20 30 110 120 130 140 150 160 170' #fail
            values: '0+10x3 111+10x6'  #success
          - series: 'windows_cpu_interrupts_total{core="0,1"}'
            values: '0+10x3 98+13x6'

      # Unit test for alerting rules.
      alert_rule_test:
          # Unit test 1.
          - eval_time: 4m
            alertname: alerts_rules_increase
            exp_alerts:
                # Alert 1.
                - exp_labels:
                      core: "0,0"
                      severity: critical
                  exp_annotations:
                      summary: "Alert test case of increase."
                      description: "Use increase function in unit test."
          - eval_time: 8m
            alertname: alerts_rules_increase_all
            exp_alerts:
                # Alert 1.
                - exp_labels:
                      severity: critical
                  exp_annotations:
                      summary: "Alert test case of increase."
                      description: "Use increase function in unit test."

使用例

Prometheus設定ファイルの書式チェックの実行例（書式が正しい場合）

# ./promtool check config jpc_prometheus_server.yml
Checking jpc_prometheus_server.yml
  SUCCESS: 1 rule files found

Checking jpc_alerting_rules.yml
  SUCCESS: 1 rules found

Prometheus設定ファイルの書式チェックの実行例（書式が不正な場合）

# ./promtool check config jpc_prometheus_server.yml
Checking jpc_prometheus_server.yml
  FAILED: parsing YAML file jpc_prometheus_server.yml: yaml: line 42: did not find expected key

アラート設定ファイルの書式チェックの実行例（書式が不正な場合）

# ./promtool check rules jpc_alerting_rules.yml
Checking jpc_alerting_rules.yml
  SUCCESS: 1 rules found

アラート設定ファイルの書式チェックの実行例（書式が不正な場合）

# ./promtool check rules jpc_alerting_rules.yml
Checking jpc_alerting_rules.yml
  FAILED:
jpc_alerting_rules.yml: yaml: unmarshal errors:
  line 10: field aannotations not found in type rulefmt.RuleNode

アラートルールのテストの実行例（テストが成功した場合）

# ./promtool test rules alerts_rules_unit_test.yml
Unit Testing:  alerts_rules_unit_test.yml
  SUCCESS

アラートルールのテストの実行例（テストが失敗した場合（その1））

# ./promtool test rules alerts_rules_unit_test.yml
Unit Testing:  alerts_rules_unit_test.yml
  FAILED:
    alertname:InstanceDown, time:10m,
        exp:"[Labels:{alertname=¥"InstanceDown¥", instance=¥"localhost:9090¥", job=¥"prometheus¥", severity=¥"page¥"} Annotations:{description=¥"localhost:9090 of job prometheus has been down for more than 5 minutes.¥", summary=¥"Instance localhost:9090 down¥"}]",
        got:"[]

テストファイルが不正な場合，「exp」に発生が予想されるアラート，「got」に実際に発生したアラートが出力されます。上記の実行例の場合，アラートが1つ出力する想定（「exp」の出力結果）に対して，実際にはアラートが通知されなかった（「got」の出力結果）ことを示します。

アラートルールのテストの実行例（テストが失敗した場合（その2））

# ./promtool test rules test_rule_file.yml
Unit Testing:  test_rule_file.yml
  FAILED:
    alertname:InstanceDown, time:5m,
        exp:"[Labels:{alertname=¥"InstanceDown¥", instance=¥"localhost:9090¥", job=¥"prometheus¥", severity=¥"warn¥"} Annotations:{description=¥"localhost:9090 of job prometheus has been down for more than 5 minutes.¥", summary=¥"Instance localhost:9090 down¥"}]",
        got:"[Labels:{alertname=¥"InstanceDown¥", instance=¥"localhost:9090¥", job=¥"prometheus¥", severity=¥"page¥"} Annotations:{description=¥"localhost:9090 of job prometheus has been down for more than 5 minutes.¥", summary=¥"Instance localhost:9090 down¥"}]

テストファイルが不正な場合，「exp」に発生が予想されるアラート，「got」に実際に発生したアラートが出力されます。上記の実行例の場合，「severity」の値が「warn」である想定（「exp」の出力結果）に対して，実際には「severity」の値が「page」であった（「got」の出力結果）ことを示します。

SpmSetSvcCon（Windows限定）

機能

JP1/IM-ManagerサービスとJP1/Base Eventサービスの依存関係を設定，または解除するコマンドです。また，論理ホストからJP1/IM - Managerだけを削除する場合に，論理ホストのJP1/IM-Managerサービスを削除することもできます。

形式

SpmSetSvcCon {-setdepend {yes|no} | -d -h 論理ホスト名}

実行権限

Administrators権限（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

格納先ディレクトリ

Consoleパス¥bin¥

引数

-setdepend {yes|no}

登録してあるサービスに対して，依存関係を設定します。

yes：JP1/IM-ManagerサービスとJP1/Base Eventサービスの依存関係を設定します。

no：JP1/IM-ManagerサービスとJP1/Base Eventサービスの依存関係を解除します。

-d -h 論理ホスト名

論理ホストからJP1/IM - Managerだけを削除する場合に指定します。論理ホストからJP1/IM - Managerだけを削除する手順については，マニュアル「JP1/Integrated Management 3 - Manager 構築ガイド」の「7.7.1(4)　論理ホストからJP1/IM - ManagerおよびIMデータベースだけを削除する手順」を参照してください。

戻り値

0

正常終了

1

引数エラー

2

実行権限エラー

3

JP1/IM-Managerサービスが登録されていない

255

その他のエラー

2　定義ファイル

この章では，JP1/IMの定義ファイルの形式および文法について説明します。

定義ファイル一覧

JP1/Integrated Managementの定義ファイルの一覧を次に示します。

定義ファイル一覧

表2‒1　定義ファイル一覧

製品名

定義ファイル名

説明

JP1/Base

構成定義ファイル（jbs_route.conf）

JP1/IMで管理するシステムの階層構造を定義するファイルです。構成定義ファイル（jbs_route.conf）の詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

環境変数ファイル※³

JP1/IMの管理対象ホストでコマンドを実行するときの環境変数を定義するファイルです。環境変数ファイルの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

ホストグループ定義ファイル

JP1/IMの管理対象ホストのグループを定義するファイルです。ホストグループ定義ファイルの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/IM - Manager

JP1/IM - Manager

共通定義設定用ファイル（JP1イベントの属性変更）

JP1イベントの属性を変更するファイルです。

操作ログ定義ファイル（imm_operationlog.conf）

操作ログの出力の有無，出力先，サイズ，および保存面数を定義するファイルです。

インテリジェント統合管理基盤

インテリジェント統合管理基盤定義ファイル（imdd.properties）

インテリジェント統合管理基盤のシステム関連の設定値を定義するファイルです。

システムノード定義ファイル（imdd_systemnode.conf）※³

サンバースト形式やツリー形式で表示するシステムの階層構造を定義し，収集したデータを定義したホストでグルーピングする設定ファイルです。

IM管理ノードカテゴリ名称定義ファイル（imdd_category_name.conf）※³

サンバースト形式やツリー形式で表示する管理グループのIM管理ノードカテゴリの名称を定義するファイルです。

構成取得対象ホスト定義ファイル（imdd_target_host.conf）※³

監視オブジェクトの情報を取得する際に，製品ごとに取得先のホストを定義する設定ファイルです。

ホスト名定義ファイル（imdd_host_name.conf）※³

エイリアス名と実ホスト名のマッピングを定義するファイルです。

IM管理ノードリンク定義ファイル（imdd_nodeLink_def.conf）※³

IM管理ノード間の関連を定義するファイルです。

提案定義ファイル（imdd_suggestion.conf）※³

提案機能で使用する，対処アクションを提案する条件と，対処アクションの内容を定義するファイルです。

提案定義ファイル（ユーザー作成）（imdd_suggestion_任意のファイル名.conf）※³※⁴

シングルサインオンマッピング定義ファイル（imdd_sso_mapping.properties）※³

インテリジェント統合管理基盤で使用するJP1ユーザー名とOpenIDプロバイダに登録されているユーザー名のマッピングを定義するファイルです。

自動対処アクション定義ファイル（autoactconf.json）※³

自動対処アクションの実行条件，実行内容を記載した自動対処アクション定義を保存するファイルです。

対処アクション状態監視定義ファイル（responseactionnotice.conf）

自動対処アクションの実行状態の監視に関する設定を定義するファイルです。

ユーザー作成定義ファイルリスト定義ファイル（imdd_user_deffile_list.json）※³

ユーザー作成の定義ファイルのうち，JP1/IM - Managerが提供する機能で更新や削除ができるファイルを定義するファイルです。

定義ファイルプロパティファイル（imdd_file_properties.json）

定義ファイルの取得や更新を行うときに，操作対象の定義ファイルのファイル名，ファイルパス，定義ファイル反映のための操作を定義するファイルです。

セントラルコンソール

発生元ホストマッピング定義ファイル（user_hostmap.conf）※³

発生元ホストのマッピングを定義するファイルです。

自動アクション環境定義ファイル（action.conf.update）

自動アクションの実行環境を定義するファイルです。

自動アクション定義ファイル（actdef.conf）

自動アクションのアクションを実行する条件と，アクションとして実行するコマンドについて定義するファイルです。

自動アクション定義ファイル（actdef.conf）（互換用）

互換用に自動アクションのアクションを実行する条件と，アクションとして実行するコマンドについて定義するファイルです。

自動アクション通知定義ファイル（actnotice.conf）

自動アクションの状態通知機能を有効にするかどうかを定義するファイルです。

拡張起動プロセス定義ファイル（jp1co_service.conf）

JP1/IM - Managerを構成する機能のプロセス情報を定義するファイルです。

IMパラメーター定義ファイル（jp1co_param_V7.conf）

JP1/IM - Managerのプロセスの異常，また，異常終了からの自動復旧時にJP1イベントを発行するかどうかを定義するファイルです。

システムプロファイル（.system）

イベントコンソールの基本動作に関する環境情報を定義するファイルです。

ユーザープロファイル（defaultUser | profile_ユーザー名）

イベントコンソールの画面表示に関する環境情報を定義するファイルです。

通信環境定義ファイル（console.conf.update）

JP1/IM - Managerとビューアー，jcochstatコマンドとの通信処理（タイムアウト時間）を定義するファイルです。

ヘルスチェック定義ファイル（jcohc.conf）※³

ヘルスチェック機能を有効にするかどうかを定義するファイルです。

イベントガイド情報ファイル（jco_guide.txt）※³※⁴

システムで発生した問題となるJP1イベントに対して，JP1イベント単位でイベントガイド情報を定義するファイルです。

イベントガイド情報ファイルのサンプルファイル（sample_jco_guide_ja.txt，sample_jco_guide_en.txt）

システムで発生した問題となるJP1イベントに対して，JP1イベント単位でイベントガイド情報を定義するファイルのサンプルファイルです。

対処状況イベント定義ファイル（processupdate.conf）

対処状況を変更したときにJP1イベントを発行するかどうかを定義するファイルです。

相関イベント発行システムプロファイル（egs_system.conf）※³

相関イベント発行サービスの起動時および停止時の動作を定義するファイルです。

相関イベント発行定義ファイル※³※⁴

相関イベントの発行処理の対象とするJP1イベントの条件と条件成立時に発行する相関イベントを定義するファイルです。

相関イベント発行環境定義ファイル※³※⁴

相関イベント発行履歴ファイルのサイズおよび面数を定義するファイルです。

インシデント手動登録定義ファイル（incident.conf）

JP1/Service Support連携用の定義ファイルです。JP1/IM - Viewの連携先JP1/Service Supportを定義するファイルです。

インシデント引き継ぎ情報設定ファイル（incident_info.conf）

JP1/Service Supportとの連携で，インシデントとして登録する任意のJP1イベントの属性または文字列を定義するファイルです。

重大度変更定義ファイル（jcochsev.conf）※³

イベントの重大度変更機能で，重大度を変更するJP1イベントの条件と変更後の重大度を定義するファイルです。

コマンドボタン定義ファイル（cmdbtn.conf）※³

［コマンド実行］画面に表示する［コマンド］ボタンを定義するファイルです。

イベント条件表示項目定義ファイル（attr_list.conf）

［アクション詳細設定］画面の［属性名］表示領域に表示する表示項目を指定する定義ファイルです。

イベント引き継ぎ情報変換設定ファイル（event_info_replace.conf）

自動アクション，およびコマンド実行のイベント引き継ぎ機能の変換ルールを指定するファイルです。

イベントレポート出力の項目ファイル

イベントレポート出力で出力したいJP1イベントの属性を指定するファイルです。

イベントレポート出力環境定義ファイル（evtreport.conf）

イベントレポート出力機能の実行環境の情報を定義するファイルです。

イベントレポート出力のフィルターファイル

イベントレポート出力時のフィルター条件を指定する定義ファイルです。

システムカラー定義ファイル（systemColor.conf）※³

イベント一覧に使用する色の設定を定義するファイルです。

イベント拡張属性定義ファイル※³※⁴

JP1イベントの拡張属性を定義するファイルです。

イベント拡張属性定義ファイル（拡張ファイル）※³※⁴

JP1イベントの固有の拡張属性を項目名で画面に表示したり，イベントレポート出力したりする設定を定義するファイルです。

オブジェクトタイプ定義ファイル

JP1イベントの拡張属性のオブジェクトタイプを定義するファイルです。

共通除外条件拡張定義ファイル※³※⁴

拡張モードの共通除外条件のイベント条件や適用期間を定義するファイルです。

共通除外条件表示項目定義ファイル（common_exclude_filter_attr_list.conf）※³

［共通除外条件設定(拡張)］画面の［属性名］表示領域に表示する項目を指定する定義ファイルです。

共通除外条件自動入力定義ファイル（common_exclude_filter_auto_list.conf）※³

［共通除外条件設定(拡張)］画面を開いたときに，自動で設定されるJP1イベント属性を定義するファイルです。

繰り返しイベント条件表示項目定義ファイル（event_storm_attr_list.conf）※³

［繰り返しイベント条件設定］画面の［属性名］表示領域に表示する項目を指定する定義ファイルです。

繰り返しイベント条件自動入力定義ファイル（event_storm_auto_list.conf）※³

［繰り返しイベント条件設定］画面を開いたときに，自動で設定されるJP1イベント属性を定義するファイルです。

重大度変更定義表示項目定義ファイル（chsev_attr_list.conf）※³

［重大度変更定義設定］画面の［属性名］表示領域に表示する項目を指定する定義ファイルです。

重大度変更定義自動入力定義ファイル（chsev_auto_list.conf）※³

［重大度変更定義設定］画面を開いたときに，自動で設定されるJP1イベント属性を定義するファイルです。

モニター画面呼び出し定義ファイル※³※⁴

モニター画面呼び出しの設定を定義するファイルです。

メール環境定義ファイル（jimmail.conf）

JP1/IM - Managerでメール送信するときに，必要な情報を設定する定義ファイルです。

表示メッセージ変更定義ファイル（jcochmsg.conf）※³

イベントの表示メッセージ変更機能で，メッセージの表示を変更するJP1イベントの条件と変更後のメッセージを定義するファイルです。

表示メッセージ変更定義表示項目定義ファイル（chmsg_attr_list.conf）※³

［表示メッセージ変更定義設定］画面の［属性名］表示領域に表示する表示項目を指定する定義ファイルです。

表示メッセージ変更定義自動入力定義ファイル（chmsg_auto_list.conf）※³

［表示メッセージ変更定義設定］画面を開いたときに，自動で設定される条件を設定する定義ファイルです。

表示メッセージ変更後イベント環境定義ファイル（chmsgevent.conf）

表示メッセージ変更したイベントを発行する機能の動作を定義するファイルです。

セントラルスコープ

ホスト情報ファイル（jcs_hosts）

JP1/IM - Manager（セントラルスコープ）が管理するホスト情報を定義するファイルです。

ガイド情報ファイル（jcs_guide_xxx.txt）※1

監視オブジェクトの状態変更の契機となったJP1イベントに関するガイド情報を定義するファイルです。

状態変更イベント件数の上限監視設定ファイル（evhist_warn_event_xxx.conf）※2

監視オブジェクトの状態変更イベントの件数が上限を超えた場合に，JP1イベントを発行するかどうかを定義するファイルです。

対処済み連動設定ファイル（action_complete_xxx.conf）※2

対処済み連動機能を有効にするかどうかを定義するファイルです。

状態変更イベント自動削除設定ファイル

JP1イベントの対処状況を「対処済」にしたときに，状態変更イベントを自動削除する機能を有効にするかどうかを定義するファイルです。

監視オブジェクト初期化設定ファイル

特定のJP1イベントを受信したときに，監視オブジェクトを初期化する機能を有効にするかどうかを定義するファイルです。

監視オブジェクトDBの自動バックアップ・リカバリー設定ファイル（auto_dbbackup_xxx.conf）※2

監視ツリー更新中の，OSのシャットダウンやクラスタシステムの系切り替え発生による，監視オブジェクトDBの破損を防ぐための機能を有効にするかどうかを定義するファイルです。

状態変更条件メモリー常駐機能の設定ファイル

状態変更条件メモリー常駐機能を有効にするかどうかを設定するファイルです。

システムプロファイル（セントラルスコープ）（jcs_sysprofile_xxx.def）※1

セントラルスコープ・ビューアーの共通の定義情報です。

セントラルスコープにログインすると，セントラルスコープ・ビューアーに送信されます。

IM構成管理

IM構成管理・ビューアー動作定義ファイル（jcfview.conf）

IM構成管理・ビューアーの動作を指定するファイルです。

IM構成反映方式設定ファイル（jp1cf_applyconfig.conf）

システムの階層構成の反映方式を定義するファイルです。

ホスト入力情報ファイル（host_input_data.csv）

IM構成管理の管理対象ホストに関するホスト入力情報のエクスポートファイルです。

ホスト収集情報ファイル（host_collect_data.csv）

IM構成管理の管理対象ホストに関するホスト収集情報のエクスポートファイルです。

プロファイル管理環境定義ファイル（jp1cf_profile_manager.conf）

プロファイル管理機能の実行環境の情報を定義するファイルです。

リモートログトラップ環境定義ファイル（jp1cf_remote_logtrap.conf）

リモート監視ログファイルトラップ機能とリモート監視イベントログトラップ機能の実行環境を定義するファイルです。

リモート監視ログファイルトラップ動作定義ファイル

リモート監視のログトラップ機能の動作を定義するファイルです。

リモート監視イベントログトラップ動作定義ファイル

リモート監視のイベントログトラップ機能の動作を定義するファイルです。

IMデータベース

セットアップ情報ファイル（jimdbsetupinfo.conf）

統合監視DBおよびIM構成管理DBのセットアップ時に，IMデータベースのサイズやIMデータベースのデータを格納するディレクトリなどを記述するファイルです。

クラスタセットアップ情報ファイル（jimdbclustersetupinfo.conf）

統合監視DBおよびIM構成管理DBのクラスタ環境のセットアップ時に，論理ホスト用のIMデータベースのサイズや論理ホスト用のIMデータベースのデータを格納するディレクトリなどを記述するファイルです。

インテリジェント統合管理データベース

インテリジェント統合管理データベースセットアップ情報ファイル（jimgndbsetupinfo.conf）

インテリジェント統合管理データベースのセットアップ時に必要な項目を記述するファイルです。

クラスタ環境インテリジェント統合管理データベースセットアップ情報ファイル（jimgndbclustersetupinfo.conf）

インテリジェント統合管理データベースのクラスタ環境のセットアップ時に必要な項目を記述するファイルです。

インテリジェント統合管理データベースの設定ファイル（postgresql.conf）

インテリジェント統合管理データベース（PostgreSQL）に関するパラメーターの定義を記述するファイルです。

JP1/IM - Agentの製品プラグイン

Node exporterのメトリック定義ファイル（metrics_node_exporter.conf）※³

［統合オペレーション・ビューアー］画面の［トレンド］タブで表示するNode exporterのメトリック情報を定義するファイルです。

Process exporterのメトリック定義ファイル（metrics_process_exporter.conf）※3

［統合オペレーション・ビューアー］画面の［トレンド］タブで表示するProcess exporterのメトリック情報を定義するファイルです。

Node exporter（サービス監視）のメトリック定義ファイル（metrics_node_exporter_service.conf）※3

［統合オペレーション・ビューアー］画面の［トレンド］タブで表示するNode exporter（サービス監視）のメトリック情報を定義するファイルです。

Windows exporterのメトリック定義ファイル（metrics_windows_exporter.conf）※³

［統合オペレーション・ビューアー］画面の［トレンド］タブで表示するWindows exporterのメトリック情報を定義するファイルです。

Windows exporter（プロセス監視）のメトリック定義ファイル（metrics_windows_exporter_process.conf）※3

［統合オペレーション・ビューアー］画面の［トレンド］タブで表示するWindows exporter（プロセス監視）のメトリック情報を定義するファイルです。

Windows exporter（サービス監視）のメトリック定義ファイル（metrics_windows_exporter_service.conf）※3

［統合オペレーション・ビューアー］画面の［トレンド］タブで表示するWindows exporter（サービス監視）のメトリック情報を定義するファイルです。

Node exporter for AIXのメトリック定義ファイル（metrics_node_exporter_aix.conf）※3

［統合オペレーション・ビューアー］画面の［トレンド］タブで表示するNode exporter for AIXのメトリック情報を定義するファイルです。

Blackbox exporterのメトリック定義ファイル（metrics_blackbox_exporter.conf）※³

［統合オペレーション・ビューアー］画面の［トレンド］タブで表示するBlackbox exporterのメトリック情報を定義するファイルです。

Yet another cloudwatch exporterのメトリック定義ファイル（metrics_ya_cloudwatch_exporter.conf）※³

［統合オペレーション・ビューアー］画面の［トレンド］タブで表示するYet another cloudwatch exporterのメトリック情報を定義するファイルです。

Promitorのメトリック定義ファイル（metrics_promitor.conf）※3

［統合オペレーション・ビューアー］画面の［トレンド］タブで表示するPromitorのメトリック情報を定義するファイルです。

Script exporterのメトリック定義ファイル（metrics_script_exporter.conf）※3

［統合オペレーション・ビューアー］画面の［トレンド］タブで表示するScript exporterのメトリック情報を定義するファイルです。

Fluentdのメトリック定義ファイル（metrics_fluentd.conf）※³

［統合オペレーション・ビューアー］画面の［トレンド］タブで表示するFluentdのメトリック情報を定義するファイルです。

OracleDB exporterのメトリック定義ファイル（metrics_oracledb_exporter.conf）※3

［統合オペレーション・ビューアー］画面の［トレンド］タブで表示するOracleDB exporterのメトリック情報を定義するファイルです。

OracleDB exporterのデフォルトの収集メトリック定義ファイル（default-metrics.toml）

OracleDB exporterが取得するメトリックを定義するファイルです。

コンテナ監視のメトリック定義ファイル（metrics_kubernetes.conf）※3

［統合オペレーション・ビューアー］画面の［トレンド］タブで表示するコンテナ監視のメトリック情報を定義するファイルです。

任意のPrometheusトレンド名のメトリック定義ファイル（metrics_任意のPrometheusトレンド名.conf）※³※⁴

［統合オペレーション・ビューアー］画面の［トレンド］タブで表示するメトリック情報を定義するファイルです。

ユーザー独自のメトリック定義ファイル（metrics_任意のPrometheusトレンド名.conf）※³※⁴

［統合オペレーション・ビューアー］画面の［トレンド］タブで表示するユーザー独自のメトリック情報を定義するファイルです。

ユーザー独自のメトリック定義ファイル（Promitor）（metrics_任意のPrometheusトレンド名.conf）※3※4

［統合オペレーション・ビューアー］画面の［トレンド］タブで表示するユーザー独自のメトリック情報を定義するファイルです。

ユーザー独自のメトリック定義ファイル（コンテナ監視）（metrics_任意のPrometheusトレンド名.conf）※3※4

［統合オペレーション・ビューアー］画面の［トレンド］タブで表示するユーザー独自のメトリック情報を定義するファイルです。

AWS定義ファイル（aws_settings.conf）※³

AWSやYet another cloudwatch exporterに関する設定ファイルです。

JP1/IM - Agent（統合エージェント管理基盤）

imbase共通設定ファイル（jpc_imbasecommon.json）

統合エージェント管理基盤の共通動作を規定する設定ファイルです。

imbase設定ファイル（jpc_imbase.json）

統合エージェント管理基盤のimbaseプロセスの動作を規定する設定ファイルです。

imbaseproxy設定ファイル（jpc_imbaseproxy.json）

統合エージェント管理基盤のimbaseproxyプロセスの動作を規定する設定ファイルです。

JP1/IM - View

通信環境定義ファイル（view.conf.update）

JP1/IM - ViewとJP1/IM - Manager（セントラルコンソール）間の通信でのタイムアウト時間を定義するファイルです。

通信環境定義ファイル（tree_view.conf.update）

JP1/IM - ViewとJP1/IM - Manager（セントラルスコープ）間の通信でのタイムアウト時間を定義するファイルです。

非暗号化通信ホスト設定ファイル（nosslhost.conf）

非暗号化通信をするホストを設定するファイルです。

IM-View設定ファイル（tuning.conf）

ログイン画面での接続先ホスト入力履歴数，イベントコンソール画面表示時の動作などJP1/IM - Viewの動作を定義するファイルです。

WWWページ呼び出し定義ファイル（hitachi_jp1_製品名.html）

統合機能メニューから他製品のWWWページを呼び出すときに使用するファイルです。

起動プログラム定義ファイル（!JP1_CS_APP0.conf）

監視ツリー画面のツールバーに追加するプログラムの起動パスを定義するファイルです。

ツールバー定義ファイル（!JP1_CS_FTOOL0.conf）

監視ツリー画面のツールバーに追加するプログラムの並び順を定義するファイルです。

アイコン動作定義ファイル（!JP1_CS_FTREE0.conf）

監視ツリー画面のツールバーに追加するアイコンの動作を定義するファイルです。

ツリー構成ファイル

監視ツリー画面に表示される監視ツリーのツリー構成を定義したファイルです。

アプリケーション実行定義ファイル

ビューアーで実行するアプリケーションのIDとパスを定義するファイルです。

統合機能メニュー定義ファイル

統合機能メニューに表示するツリーを定義するファイルです。

システムプロファイル（セントラルスコープ・ビューアー）（system.conf）

セントラルスコープ・ビューアーの共通の定義情報です。

［監視ツリー（編集中）］画面と［ビジュアル監視（編集中）］画面を定義します。

性能レポート表示定義ファイル（performance.conf）

事象発生元ホストの性能レポート表示機能の定義ファイルです。接続先のJP1/PFM - Web ConsoleのURLを定義します。

JP1/IM - Agent

Alertmanager設定ファイル（jpc_alertmanager.yml）※³

Alertmanagerの動作を規定する設定ファイルです。

Prometheus設定ファイル（jpc_prometheus_server.yml）※³

Prometheus serverの動作を規定する設定ファイルです。

アラート設定ファイル（jpc_alerting_rules.yml）※³

Prometheus serverが実行するアラート評価のルールを定義するファイルです。

Node exporterのディスカバリ設定ファイル（jpc_file_sd_config_node.yml）※³

Prometheus serverがスクレイプするNode exporterを設定するファイルです。

Process exporterのディスカバリ設定ファイル（jpc_file_sd_config_process.yml）※3

Prometheus serverがスクレイプするProcess exporterを設定するファイルです。

Windows exporterのディスカバリ設定ファイル（jpc_file_sd_config_windows.yml）※³

Prometheus serverがスクレイプするWindows exporterを設定するファイルです。

Node exporter for AIXのディスカバリ設定ファイル（jpc_file_sd_config_node_aix.yml）※3

Prometheus serverがスクレイプするNode exporter for AIXを設定するファイルです。

Blackbox exporter（HTTP/HTTPS監視）のディスカバリ設定ファイル（jpc_file_sd_config_blackbox_http.yml）※³

Prometheus serverがHTTP/HTTPS監視でスクレイプするBlackbox exporterを設定するファイルです。

Blackbox exporter（HTTP/HTTPS監視）のディスカバリ設定ファイル（ユーザー作成）（file_sd_config_blackbox_httpで始まるモジュール名.yml）※³※⁵

Blackbox exporter（ICMP監視）のディスカバリ設定ファイル（jpc_file_sd_config_blackbox_icmp.yml）※³

Prometheus serverがICMP監視でスクレイプするBlackbox exporterを設定するファイルです。

Blackbox exporter（ICMP監視）のディスカバリ設定ファイル（ユーザー作成）（file_sd_config_blackbox_icmpで始まるモジュール名.yml）※³※⁵

Yet another cloudwatch exporterのディスカバリ設定ファイル（jpc_file_sd_config_cloudwatch.yml）※³

Prometheus serverがスクレイプするYet another cloudwatch exporterを設定するファイルです。

Promitorのディスカバリ設定ファイル（jpc_file_sd_config_promitor.yml）※3

Prometheus serverがスクレイプするPromitorを設定するファイルです。

OracleDB exporterのディスカバリ設定ファイル（jpc_file_sd_config_oracledb.yml）※3

Prometheus serverがスクレイプするOracleDB exporterを設定するファイルです。

Script exporterのディスカバリ設定ファイル（jpc_file_sd_config_script.yml）※3

Prometheus serverがスクレイプするScript exporterを設定するファイルです。

ユーザー独自のディスカバリ設定ファイル（user_file_sd_config_任意の名前.yml）※³※⁵

Prometheus serverがスクレイプする対象を設定するファイルです。ユーザーが独自に用意したExporterもスクレイプの対象とすることができます。

サービス定義ファイル（jpc_プログラム名_service.xml）

Windows環境でプログラムをWindowsサービス化するためのWinSWの定義ファイルです。

ユニット定義ファイル（jpc_プログラム名.service）

Linux環境でプログラムをsystemctlに登録するための定義ファイルです。

Windows exporter設定ファイル（jpc_windows_exporter.yml）※³

Windows exporterの動作を規定する設定ファイルです。

Process exporter設定ファイル（jpc_process_exporter.yml）※3

Process exporterの動作を規定する設定ファイルです。

Blackbox exporter設定ファイル（jpc_blackbox_exporter.yml）※³

Blackbox exporterの動作を規定する設定ファイルです。

Yet another cloudwatch exporter設定ファイル（jpc_ya_cloudwatch_exporter.yml）※³

Yet another cloudwatch exporterの動作を規定する設定ファイルです。

Promitor Scraper設定ファイル（metrics-declaration.yaml）※3

Promitor Scraperの取得するメトリクスを定義する設定ファイルです。

Promitor Scraper runtime設定ファイル（runtime.yaml）※3

Promitor Scraperの認証情報やスクレイプ用ポートなどを定義する設定ファイルです。

Promitor Resource Discovery設定ファイル（resource-discovery-declaration.yaml）※3

Promitor Resource Discoveryの取得するリソースグループを定義する設定ファイルです。

Promitor Resource Discovery runtime設定ファイル（runtime.yaml）※3

Promitor Resource Discoveryの認証情報やスクレイプ用ポートなどを定義する設定ファイルです。

Script exporter設定ファイル（jpc_script_exporter.yml）※3

Script exporterの動作を規定する設定ファイルです。

SAPシステム監視のScript exporter設定ファイルのサンプルファイル（jpc_script_exporter_sap.yml）

SAPシステム監視のScript exporterの動作を規定する設定ファイルのサンプルファイルです。

ログ監視共通定義ファイル（jpc_fluentd_common.conf）※³

HTTP POSTリクエスト機能やログ出力機能など，ログ監視機能で共通の動作を定義するためのファイルです。

ログ監視対象定義ファイル（jpc_fluentd_common_list.conf）※³

ログ監視の対象を指定する定義ファイルです。指定する対象として，テキスト形式のログファイルの監視定義ファイル，または，Windowsイベントログの監視定義ファイルのファイル名を指定します。指定した監視定義ファイルのログ監視が有効となります。

テキスト形式のログファイルの監視定義ファイル（fluentd_@@trapname@@_tail.conf.template）※³※⁵

テキスト形式のログファイルを監視するための定義ファイルです。

Windowsイベントログの監視定義ファイル（fluentd_@@trapname@@_wevt.conf.template）※³※⁵

Windowsイベントログを監視するための定義ファイルです。

SAPシステムのシステムログ情報監視定義ファイルのサンプルファイル（fluentd_sap_syslog_tail.conf）

SAPシステムのシステムログ情報を監視するための定義ファイルのサンプルファイルです。

SAPシステムのCCMSアラート情報監視定義ファイルのサンプルファイル（fluentd_sap_alertlog_tail.conf）

SAPシステムのCCMSアラート情報を監視するための定義ファイルのサンプルファイルです。

jr3slgetコマンドの環境パラメーター設定ファイル（jr3slget.ini）

SAPシステムのシステムログ情報の出力先ファイル名などを設定するファイルです。

jr3slgetコマンドの環境パラメーター設定ファイルのサンプルファイル（jr3slget.ini.sample）

SAPシステムのシステムログ情報の出力先ファイル名などを設定するファイルのサンプルファイルです。

jr3algetコマンドの環境パラメーター設定ファイル（jr3alget.ini）

SAPシステムのCCMSアラート情報の出力先ファイル名などを設定するファイルです。

jr3algetコマンドの環境パラメーター設定ファイルのサンプルファイル（jr3alget.ini.sample）

SAPシステムのCCMSアラート情報の出力先ファイル名などを設定するファイルのサンプルファイルです。

ログメトリクス定義ファイル（fluentd_任意の名前_logmetrics.conf）※3※5

監視対象のアプリケーションが出力するログを読み込み，ログメトリクスに変換するためのFluentdのメトリック定義ファイルです。

プロパティ表示文字列定義ファイル（property_labels.conf）

任意のIM管理ノードのプロパティの値を，別の値に置き換える設定を行うファイルです。

imagent共通設定ファイル（jpc_imagentcommon.json）

統合エージェント制御基盤の共通動作を規定する設定ファイルです。

imagent設定ファイル（jpc_imagent.json）

統合エージェント制御基盤のimagentの動作を規定する設定ファイルです。

imagentproxy設定ファイル（jpc_imagentproxy.json）

統合エージェント制御基盤のimagentproxyの動作を規定する設定ファイルです。

imagentaction設定ファイル（jpc_imagentaction.json）

統合エージェント制御基盤のimagentactionの動作を規定する設定ファイルです。

ユーザー作成定義ファイルリスト定義ファイル（jpc_user_deffile_list.json）※³

ユーザが作成する定義ファイルのうち，JP1/IM - Managerが提供するREST APIで更新，削除ができるファイルを定義するファイルです。

定義ファイルプロパティファイル（jpc_file_properties.json）

定義ファイルの取得機能または更新機能で操作する定義ファイルのファイル名，ファイルパス，定義ファイル反映のための操作を記載したファイルです。

環境変数ファイル（任意のファイル名）※³※⁵

JP1/IMの管理対象ホストでコマンドを実行するときの環境変数を定義するファイルです。

注※1　システムプロファイル（セントラルスコープ），およびJP1/IM - ManagerのUNIX版で使用するガイド情報ファイルは，JP1/IM - Managerが動作する言語コードによってファイル名が異なります。xxx部分については，以降の各ファイルの詳細で説明します。

注※2　状態変更イベント件数の上限監視設定ファイル，対処済み連動設定ファイル，および監視オブジェクトDBの自動バックアップ・リカバリー設定ファイルはそれぞれ二つあります。xxx部分には，on，offのどちらかが入ります。

注※3　ユーザーが統合オペレーション・ビューアー（定義ファイルのダウンロードおよびアップロード）またはREST API（定義ファイルの取得および更新）を使用して更新できる定義ファイルです。次のファイルも更新できます。

Blackbox exporter用のファイル

CA証明書ファイル，クライアント証明書ファイル，クライアント証明書キーファイル，パスワードファイル

注※4　「ユーザー作成定義ファイルリスト定義ファイル（imdd_user_deffile_list.json）」に指定できる定義ファイルです。

注※5　「ユーザー作成定義ファイルリスト定義ファイル（jpc_user_deffile_list.json）」に指定できる定義ファイルです。次のファイルも指定できます。

Blackbox exporter用のファイル

CA証明書ファイル，クライアント証明書ファイル，クライアント証明書キーファイル，パスワードファイル

定義ファイルの記述形式

定義ファイルの記述形式について説明します。ただし，定義ファイルによっては説明しない項目もあります。なお，定義ファイル名や定義ファイル内に環境依存文字を使用すると，定義に文字化けが発生することがあるため，使用しないでください。

形式

定義ファイルの形式について説明しています。

ファイル

定義ファイルのファイル名について説明しています。

格納先ディレクトリ

定義ファイルの格納場所について説明しています。

説明

定義ファイルの用途について説明しています。

定義の反映時期

定義ファイルが反映されるタイミングについて説明しています。

記述内容

定義ファイルの記述内容について説明しています。

定義例

定義ファイルの定義例について説明しています。

ユーザー独自のイベント属性を表示するための定義ファイルについて

JP1/IMの定義ファイルをカスタマイズすることによって，ほかのアプリケーションがJP1/IMと連携するための機能を拡張できるようになります。

JP1/IMの定義ファイルのカスタマイズ

機能を拡張すると，次のことができます。

ユーザー独自のイベント属性を表示する

JP1/IM - Viewに表示されたJP1イベントからモニター画面を表示する

［統合機能メニュー］画面に新規メニューを追加する

注意事項

カスタマイズした定義ファイルをUTF-8で保存する場合は，BOM（byte order mark）が付与されないように保存してください。

機能の詳細については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「4.14　ユーザー独自のイベント属性の表示」を参照してください。

定義ファイルの概要

定義ファイルの中で，定義を記述するブロック間には関連があります。また，定義ファイル間にも関連があります。それらの関連を次の図に示します。

図2‒1　定義ブロックおよび定義ファイルの関連

定義ファイルの命名規則

定義ファイルの命名規則を次に示します。

表2‒2　定義ファイルの命名規則

定義ファイル名

命名規則

イベント拡張属性定義ファイル

会社名_製品名_attr_ja.conf

オブジェクトタイプ定義ファイル

会社名_製品名_obj.ja

アプリケーション実行定義ファイル

会社名_製品名_app.conf

モニター画面呼び出し定義ファイル

会社名_製品名_mon.conf

統合機能メニュー定義ファイル

会社名_製品名_tree.conf

なお，「製品名」は，「シリーズ名_製品名」とすることもできます。JP1イベント発行時の「PRODUCT_NAME」に指定する値の「/」を「_」に変更してファイル名に使用することをお勧めします。また，標準提供ファイル名称用に「hitachi」を使用しているため，「会社名」には「hitachi」以外の名称を使用してください。

定義ファイルの格納先

それぞれの定義ファイルの格納先を次に示します。

表2‒3　定義ファイルの格納先

定義ファイル名

格納先

イベント拡張属性定義ファイル

JP1/IM - Managerがインストールされたマシン

モニター画面呼び出し定義ファイル

JP1/IM - Managerがインストールされたマシン

オブジェクトタイプ定義ファイル

JP1/IM - Managerがインストールされたマシン

アプリケーション実行定義ファイル

JP1/IM - Viewがインストールされたマシン

統合機能メニュー定義ファイル

JP1/IM - Viewがインストールされたマシン

定義ファイルの構造

ここでは，［イベントコンソール］画面，［統合機能メニュー］画面と連携するためにカスタマイズできるJP1/IMの定義ファイルに共通する事項について説明します。

なお，この節の説明は次の三つの定義ファイルだけに該当します。

イベント拡張属性定義ファイル

アプリケーション実行定義ファイル

統合機能メニュー定義ファイル

オブジェクトタイプ定義ファイルおよびモニター画面呼び出し定義ファイルは，それぞれ構造が異なります。

定義ファイルの構成要素

定義ファイルを構成する要素には，大きく分けて，ステートメント，ブロック，およびコメントがあります。定義ファイルは，そのファイル全体の属性を表すステートメント（定義情報ヘッダー）から開始し，定義内容を記述するブロック，および任意選択のコメントが続きます。

定義ファイルを構成するこれらの要素について説明します。

ステートメント

ステートメントの構造

ステートメントとは，複数の構成要素が組み合わされて一つの意味を形成するようになった列のことです。ステートメントは必ず行頭から開始しなければなりません。また，ステートメントは「;」と改行で区切らなければなりません。

ステートメントの種別

ステートメントは，記述できる場所によって「ファイル内ステートメント」と「ブロック内ステートメント」に分けられます。

ファイル内ステートメント

ファイル内ステートメントは，定義ファイルの属性を表すステートメントです。ファイル内ステートメントには，さらに「定義情報ヘッダー用ステートメント」と「ブロック制御用ステートメント」の二つがあります。

ファイル内ステートメントには「@」のプリフィックスが付きます。

ブロック内ステートメント

ブロック内ステートメントは，ブロック内の属性を表すステートメントです。ブロック内ステートメントは，ブロック開始ステートメント（@define-block）からブロック終了ステートメント（@define-block-end）までの間に記述できるステートメントのうち，コメント以外のものを指します。記述できるブロック内ステートメントは，ブロックごとに決まっています。

ブロック内ステートメントには「@」などのプリフィックスは付きません。

ブロック

ブロックの構造

ブロックはステートメントの集合体です。ブロックは，ブロックの開始を宣言するステートメント（@define-block），実際の定義を記述するブロック内ステートメント，コメント，およびブロックの終了を宣言するステートメント（@define-block-end）によって構成されます。

定義ファイルの中でブロックをネストできません。

ブロックの種別

ブロック種別は，ブロック開始ステートメント（@define-block）の「type=」パラメーターで指定します。ブロック種別の詳細については，「@define-blockステートメント」を参照してください。

ブロックの優先順位

ブロックには，定義内でユニークでなければならないキー項目があります。キー項目が定義内に複数個存在した場合は，優先順位に従ってブロック単位で取捨選択されます。ブロックの優先順位は次のようになります。

ファイル名を昇順にソートしてあとの方のファイル内のブロック

ファイル内で記述場所があとの方に存在するブロック

言い換えると，「定義ファイルをファイル名で昇順にソートして一つのファイルに連結し，連結したファイル内であとに記述されているものが優先される」ということになります。

コメント

コメントとは，行頭が「#」のステートメント，または1行が空白，タブ，または改行だけで構成される行です。コメントは定義情報としての意味を持ちません。

コメントは一つのステートメントとして処理されます。コメントは行単位で判断されるので，「;」で区切る必要はありません。コメントの末尾に「;」を付けた場合は，「;」もコメントの一部として解釈されます。

共通ステートメントの生成規則

ファイル内ステートメントには，定義情報ヘッダー用ステートメントとブロック制御用ステートメントの二つがあります。

ファイル内ステートメントの一覧を次に示します。

表2‒4　ファイル内ステートメントの一覧

ステートメント名

意味

種別

@file

定義バージョンを宣言する

定義情報ヘッダー用

@product

定義中のPP情報を宣言する

定義情報ヘッダー用

@define-block

ブロックの開始を宣言する

ブロック制御用

@define-block-end

ブロックの終了を宣言する

ブロック制御用

これらのステートメントのうち，定義情報ヘッダー用ステートメントは，一つの定義ファイル全体に共通する属性を定義します。使用できる定義情報ヘッダー用ステートメントは定義ファイルごとに異なります。また，定義情報ヘッダー用ステートメントのパラメーターも，定義ファイルごとに異なります。

ブロック制御用ステートメントは，その定義ファイル内で定義するブロックの単位を宣言するために使用します。ブロック制御用ステートメントの生成規則は，すべての定義ファイルで共通です。

このあとに，ブロック制御用ステートメントの生成規則を示します。定義情報ヘッダー用ステートメントの生成規則については，個々の定義ファイルの説明を参照してください。

@define-blockステートメント

構文

@define-block type="ブロック種別";

機能

ブロックの開始を宣言します。このステートメントから @define-block-endステートメントまでを一つの定義ブロックとして扱います。

パラメーター

・type="ブロック種別"

定義ブロックの種類を指定します。指定できるブロック種別を次に示します。

表2‒5　ブロック種別一覧

ブロック名

パラメーターでの指定値

イベント属性定義ブロック

"event-attr-def"

イベント属性グループ定義ブロック

"event-attr-group-def"

イベント表示順序定義ブロック

"event-attr-order-def"

アプリケーション実行定義ブロック

"application-execution-def"

機能ツリーメニュー定義ブロック

"function-tree-def"

無効なブロック種別が指定された場合は，ブロック全体が無視されて警告が表示されますが，ファイルの解析処理は続行されます。

注意事項

定義ブロックをネストできません。

定義例

@define-block-endステートメントの説明を参照してください。

@define-block-endステートメント

構文

@define-block-end;

機能

@define-blockから始まる定義ブロックの終了を宣言します。

注意事項

対応する@define-blockステートメントがない場合は，ファイルの解析処理を中止します。

定義例

@define-blockステートメントおよび@define-block-endステートメントの定義例を示します。

@define-block type="event-attr-def";
block lang="Japanese", platform="base", extended="false";
attr name="E.SEVERITY", title="重大度";
attr name="B.TIME", title="登録時刻";
attr name="B.SOURCESERVER", title="登録ホスト";
attr name="E.USER_NAME", title="ユーザー名";
@define-block-end;

共通定義設定用ファイル（JP1イベントの属性変更）

形式

[JP1_DEFAULT¥JP1CONFIG]
"ATTR_EVENT_LOGTRAP_SOURCEHOST"=dword:{00000000 | 00000001}

ファイル

任意

jp1im_jp1_event_attributes.conf.model（共通定義設定用ファイル（JP1イベントの属性変更）のモデルファイル）

格納先ディレクトリ

共通定義設定用ファイル（JP1イベントの属性変更）のモデルファイルの格納先ディレクトリを次に示します。モデルファイルをコピーして，任意のファイル名で作成してください。

Windowsの場合

Managerパス¥conf

UNIXの場合

/etc/opt/jp1imm/conf

説明

イベントログトラップの発生元属性についての情報を共通定義情報に設定するファイルです。

定義の反映時期

jbssetcnfコマンドを実行すると，共通定義設定用ファイル（JP1イベントの属性変更）の情報が共通定義情報に登録されます。そのあと，JP1/IM - Managerを再起動すると，共通定義情報の設定が有効になります。共通定義を変更した場合は，必ずJP1/IM - Managerを再起動してください。

記述内容

共通定義設定用ファイル（JP1イベントの属性変更）には，次に示す規則があります。

行の先頭に#（0x23）を指定すると，その行はコメント行になります。

「=」「,」の前後，行頭，および行末にスペースまたはタブを入れないでください。これらを入れた場合，jbssetcnfコマンド実行時にエラーとなります。

改行だけの行は無効になります。

[JP1_DEFAULT¥JP1CONFIG]

この行は変更しないでください。

"ATTR_EVENT_LOGTRAP_SOURCEHOST"=dword:{00000000 | 00000001}

JP1/IM - Managerで監視するJP1/Baseイベントログトラップ，およびリモート監視イベントログトラップのJP1イベントの発生元ホスト名属性にマッピングする属性を決定します。

「00000000」または「00000001」のどちらかを指定します。デフォルト値は「00000000」です。

「00000000」を指定した場合，JP1イベント（イベントID=3A71）の発生元ホスト名にコンピュータ名をマッピングします。

「00000001」を指定した場合，JP1/BaseのイベントログトラップによるJP1イベント（3A71）の発生元ホスト名にイベントサーバ名をマッピングします。また，リモート監視イベントログトラップによるJP1イベント（3A71）に発生元ホスト名の属性が追加され，発生元ホスト名として監視対象ホスト名が表示されます。

JP1/BaseイベントログトラップのJP1イベント（3A71）の発生元ホスト名にマッピングする属性については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「14.3.10(2)(b)　JP1イベントの属性を変更する（JP1/IM - Managerの設定）」を参照してください。

リモート監視イベントログトラップのJP1イベント（3A71）については，「3.2.2(97)　イベントID：00003A71またはリモート監視イベントログトラップ動作定義ファイルのfilterブロックに指定されたイベントIDの詳細」を参照してください。

操作ログ定義ファイル（imm_operationlog.conf）

形式

[論理ホスト名¥JP1IMM¥OPERATION]
"ENABLE"=dword:16進数
"LOGFILEDIR"="出力先"
"LOGSIZE"=dword:16進数
"LOGFILENUM"=dword:16進数

ファイル

imm_operationlog.conf

imm_operationlog.conf.model（操作ログ定義ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

Managerパス¥conf

UNIXの場合

/etc/opt/jp1imm/conf

説明

操作ログ出力機能で使用する共通定義の内容を指定するファイルです。操作ログの出力の有無，出力先，サイズ，および保存面数を定義します。

定義の反映時期

jbssetcnfコマンドを実行すると，操作ログ定義ファイル（imm_operationlog.conf）の情報が共通定義情報に登録されます。そのあと，JP1/IM - Managerを再起動すると，共通定義情報の設定が有効になります。共通定義を変更した場合は，必ずJP1/IM - Managerを再起動してください。

記述内容

[論理ホスト名¥JP1IMM¥OPERATION]

JP1/IM - Managerの環境設定のキー名称です。

論理ホスト名の部分を，物理ホストの場合はJP1_DEFAULTに，論理ホストの場合は論理ホスト名に設定します。

"ENABLE"=dword:16進数

操作ログの出力を有効にするか無効にするかを16進数で指定します。未定義，または次に示す値以外を指定した場合，初期値を仮定します。

初期値：0x00000000

操作ログの出力を無効にする場合：0x00000000

操作ログの出力を有効にする場合：0x00000001

"LOGFILEDIR"="出力先"

操作ログファイル（imm_operation.log）の出力先を絶対パス形式で指定します。出力先の最大長は217バイトです。出力先には存在し，かつ書き込みできるディレクトリを指定してください。論理ホスト側の操作ログは，共有ディスク上に出力するように指定することをお勧めします。

初期値

Windowsの場合：Managerパス¥log¥operationlog

UNIXの場合：/var/opt/jp1imm/log/operationlog

論理ホストの場合の出力先例

Windowsの場合：共有フォルダ¥JP1IMM¥log¥operationlog

UNIXの場合：共有ディレクトリ/jp1imm/log/operationlog

出力先にネットワークパスを指定できません。

また，実行環境がWindowsの場合，次に示す文字列は出力先には指定できません。

「:」，「?」，「"」，「<」，「>」，「|」の文字。

CON，PRN，AUX，NUL，COM1，COM2，COM3，COM4，COM5，COM6，COM7，COM8，COM9，LPT1，LPT2，LPT3，LPT4，LPT5，LPT6，LPT7，LPT8，LPT9のどれかと完全一致する（小文字も含む）文字列。

"LOGSIZE"=dword:16進数

操作ログファイル（imm_operation.log）のサイズを16進数で指定します。単位はメガバイトです。未定義，または指定できる範囲以外の値を指定した場合は，初期値を仮定します。

初期値：0x00000005（5MB）

指定できる範囲：0x00000001〜0x00000800（1MB〜2,048MB）

"LOGFILENUM"=dword:16進数

操作ログファイル（imm_operation.log）の保存する面数を16進数で指定します。未定義，または指定できる範囲以外の値を指定した場合は，初期値を仮定します。

初期値：0x0000000A（10面）

指定できる範囲：0x00000001〜0x00000010（1〜16面）

定義例

1ファイル当たり5メガバイトの操作ログを出力して，10ファイルまで保存する場合の定義例を次に示します。なお，次に示す定義例はJP1/IM - ManagerのOSがUNIX，かつ物理ホストの場合の例です。

[JP1_DEFAULT¥JP1IMM¥OPERATION]
"ENABLE"=dword:00000001
"LOGFILEDIR"="/var/opt/jp1imm/log/operationlog"
"LOGSIZE"=dword:00000005
"LOGFILENUM"=dword:0000000A

インテリジェント統合管理基盤定義ファイル（imdd.properties）

形式

server.port=ポート番号
jp1.imdd.proxy.server[n].host=プロキシサーバー[n]のホスト名
jp1.imdd.proxy.server[n].port=プロキシサーバー[n]のポート番号
jp1.imdd.proxy.server[n].user=プロキシサーバー[n]の認証ユーザーID
jp1.imdd.proxy.target[n].host= プロキシサーバーを利用するREST APIのターゲットホスト[n]
jp1.imdd.proxy.target[n].serverHost=接続先のプロキシサーバーのターゲットホスト名[n]
jp1.imdd.gui.settings.contentViews.<custom UI Id>.title=［カスタムUI］タブに表示するタイトル
jp1.imdd.gui.settings.contentViews.<custom UI Id>.url=［ユーザー定義の画面表示領域］に表示するhtmlファイルのパス
jp1.imdd.gui.settings.contentViews.<custom UI Id>.sid=ユーザー定義の画面を表示するIM管理ノードのツリーSID
jp1.imdd.gui.settings.contentViews.<custom UI Id>.target=ユーザー定義の画面を表示するIM管理ノードのSID
jp1.im.db.DEFAULT.portNo=IMデータベースが使用するポート番号
jp1.im.db.DEFAULT.logicalHostNum=論理ホスト用のIMデータベースで論理ホストを識別する番号
jp1.imdd.gui.settings.linkedUnit.impact.unKnownDisplay=影響不明アイコンの表示/非表示
jp1.imdd.event.stormCompatible=繰り返しイベントの表示抑止機能の互換設定
jp1.imdd.gui.settings.eventSearchCount=イベント取得での検索回数
jp1.imdd.authBasic=Basic認証の有効/無効
jp1.imdd.jp1LoginForm=true|false
jp1.imdd.oidc.＜OpenIDプロバイダのキー名＞.client-name=クライアントの別名
jp1.imdd.oidc.＜OpenIDプロバイダのキー名＞.client-id=OpenIDプロバイダで設定したクライアントID
jp1.imdd.oidc.＜OpenIDプロバイダのキー名＞.client-authentication-method=basic|post
jp1.imdd.oidc.＜OpenIDプロバイダのキー名＞.authorization-grant-type= authorization_code
jp1.imdd.oidc.＜OpenIDプロバイダのキー名＞.redirect-uri=リダイレクトURLのURI
jp1.imdd.oidc.＜OpenIDプロバイダのキー名＞.scope=クライアントに使用されるスコープ
jp1.imdd.oidc.＜OpenIDプロバイダのキー名＞.authorization-uri=許可URLのURI
jp1.imdd.oidc.＜OpenIDプロバイダのキー名＞.token-uri=トークン取得URLのURI
jp1.imdd.oidc.＜OpenIDプロバイダのキー名＞.user-info-uri=ユーザー情報URLのURI
jp1.imdd.oidc.＜OpenIDプロバイダのキー名＞.userNameAttribute=属性名
jp1.imdd.oidc.＜OpenIDプロバイダのキー名＞.jwk-set-uri=JSON Web Key（JWK）SetURLのURI
jp1.imdd.oidc.＜OpenIDプロバイダのキー名＞.issuer-uri=OpenIDプロバイダのIssuer Identifier
jp1.imdd.oidc.＜OpenIDプロバイダのキー名＞.logout-uri=OpenIDプロバイダのログアウトURI
jp1.imdd.oidc.＜OpenIDプロバイダのキー名＞.introspect-uri=OpenIDプロバイダのトークン情報取得URI
jp1.imdd.simt.updateMode=reconfigure|change

ファイル

imdd.properties

imdd.properties.model（インテリジェント統合管理基盤定義ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Managerパス¥conf¥imdd¥

論理ホストのとき

共有フォルダ¥jp1imm¥conf¥imdd¥

UNIXの場合

物理ホストのとき

/etc/opt/jp1imm/conf/imdd/

論理ホストのとき

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

説明

インテリジェント統合管理基盤のシステムの設定を定義するファイルです。

定義の反映時期

JP1/IM - Managerを起動すると，定義情報の設定が有効になります。

記述内容

インテリジェント統合管理基盤定義ファイルには，次に示す規則があります。

行の先頭に#（0x23）を指定すると，その行はコメント行になります。

プロパティ名は英小文字，英大文字を区別します。

定義ファイルはUTF-8で，BOM（byte order mark）が付与されないように保存してください。

無効なプロパティの場合は，その行を無視して処理を続行します。

プロパティに指定できる値以外を指定した場合は，動作を保証できません。

server.port=ポート番号

インテリジェント統合管理基盤サービスでHTTP通信を受け付ける任意のポート番号を指定します。

指定するポート番号はシステムで一意である必要があります。また，セットアップで作成するホスト単位でも一意の値とします。

指定できる値は，5001〜65535です。デフォルトは20703です。

jp1.imdd.proxy.server[n].host=プロキシサーバー[n]のホスト名

プロキシサーバー[n]のホスト名を指定します。

名前解決ができるプロキシサーバーのホスト名を指定します。不正なホスト名を指定した場合，製品プラグインからのAPIの実行に失敗します。

ASCII文字で指定します。

このプロパティを複数指定する場合は，[n]には0からの通番を指定してください。

jp1.imdd.proxy.server[n].port=プロキシサーバー[n]のポート番号

プロキシサーバー[n]のポート番号を指定します。

指定できる値は，1〜65535です。指定できる範囲以外の値を指定した場合は，KAJY52016-Wメッセージを出力して，プロキシサーバー[n]の設定を無効にします。

このプロパティを複数指定する場合は，[n]には0からの通番を指定してください。

jp1.imdd.proxy.server[n].user=プロキシサーバー[n]の認証ユーザーID

プロキシサーバー[n]の認証ユーザーのユーザーIDを指定します。

プロキシサーバーの認証を使用する場合，このオプションの指定と，プロキシサーバーの認証情報の設定が必要です。プロキシサーバーの認証情報の設定は「jddsetproxyuser」（1.　コマンド）を参照してください。

このプロパティを複数指定する場合は，[n]には0からの通番を指定してください。

プロキシサーバーの認証を使用しない場合は，このオプションの指定は不要です。

jp1.imdd.proxy.target[n].host=プロキシサーバーを利用するREST APIのターゲットホスト[n]

プロキシサーバーを利用するREST APIの実行対象となるターゲット[n]のホストを指定します。ターゲット[n]のホスト名には，REST APIのURLのホスト部を指定します。

例えば，REST APIが「http://hitachi.co.jp/api/v1/restApi」の場合は，「hitachi.co.jp」を指定します。

ASCII文字で指定します。

このプロパティを複数指定する場合は，[n]には0からの通番を指定してください。

jp1.imdd.proxy.target[n].serverHost=接続先のプロキシサーバーのターゲットホスト名[n]

接続先のプロキシサーバー[n]のターゲットホスト名を指定します。

設定した値がプロキシサーバー[n]に設定されていない場合，または無効な値の場合は，KAJY52018-Wメッセージを出力し，ターゲットホスト[n]の設定を無効にします。

ASCII文字で指定します。

このプロパティを複数指定する場合は，[n]には0からの通番を指定してください。

jp1.imdd.gui.settings.contentViews.<custom UI Id>.title=［カスタムUI］タブに表示するタイトル

カスタムUI表示機能を使用する場合に，［カスタムUI］タブに表示するタイトルを指定します。

タイトルは，制御文字および機種依存文字を含まない255文字以内の文字列で指定します。

なお，マルチバイト文字を指定する場合はUnicode（¥udddd表記）に変換してください。その場合の文字数は，Unicodeに変換済みの文字列の文字数でカウントされます。

一つの<custom UI Id>に対して，必ず指定してください。

jp1.imdd.gui.settings.contentViews.<custom UI Id>.url=［ユーザー定義の画面表示領域］に表示するhtmlファイルのパス

カスタムUI表示機能を使用する場合に，［ユーザー定義の画面表示領域］に表示するhtmlファイルのパスを，「public」からの相対パス形式で指定します。htmlファイルの配置先を次に示します。

Windowsの場合

Managerパス¥public¥customUI¥

UNIXの場合

/opt/jp1imm/public/customUI/

htmlファイルのパスは，制御文字および機種依存文字を含まない255文字以内の文字列で指定します。パス区切り文字は「/」を使用します。

なお，マルチバイト文字を指定する場合はUnicode（¥udddd表記）に変換してください。その場合の文字数は，Unicodeに変換済みの文字列の文字数でカウントされます。半角スペース「 」を含む場合でも，前後を引用符「"」で囲む必要はありません。

一つの<custom UI Id>に対して，必ず指定してください。

jp1.imdd.gui.settings.contentViews.<custom UI Id>.sid=ユーザー定義の画面を表示するIM管理ノードのツリーSID

カスタムUI表示機能を使用する場合に，ユーザー定義の画面を表示するIM管理ノードのツリーSIDを指定します。

IM管理ノードのツリーSIDは，1,048,576文字以内で指定します。指定できる文字は，指定したツリーSIDの仕様に準じます。

IM管理ノードのツリーSIDは，正規表現で指定できます。正規表現は完全一致であり，指定した正規表現とIM 管理ノードのツリーSIDの文字列全体を比較し，完全に一致した場合だけ条件が成立します。正規表現で指定する場合，すべての文字に一致する表現の「.*」を多用すると，検索に時間が掛かることがあります。「.*」を使用する場合は，必要な個所にだけ「.*」を使用するようにしてください。

なお，指定したツリーSIDが存在するかどうかはチェックされません。

一つの<custom UI Id>に対して，sidまたはtargetのどちらかの指定が必要です。

jp1.imdd.gui.settings.contentViews.<custom UI Id>.target=ユーザー定義の画面を表示するIM管理ノードのSID

カスタムUI表示機能を使用する場合に，ユーザー定義の画面を表示するIM管理ノードのツリーSIDを指定します。

IM管理ノードのSIDは，1,048,576文字以内で指定します。指定できる文字は，指定したツリーSIDの仕様に準じます。

IM管理ノードのツリーSIDは，正規表現で指定できます。正規表現は完全一致であり，指定した正規表現とIM 管理ノードのSIDの文字列全体を比較し，完全に一致した場合だけ条件が成立します。正規表現で指定する場合，すべての文字に一致する表現の「.*」を多用すると，検索に時間が掛かることがあります。「.*」を使用する場合は，必要な個所にだけ「.*」を使用するようにしてください。

なお，指定したツリーSIDが存在するかどうかはチェックされません。

一つの<custom UI Id>に対して，sidまたはtargetのどちらかの指定が必要です。

jp1.im.db.DEFAULT.portNo=IMデータベースが使用するポート番号

IMデータベースが使用するポート番号を指定します。

物理ホストの場合，統合監視DBのセットアップ時に使用したセットアップ情報ファイルのIMDBPORTオプションに指定した値を指定します。IMDBPORTオプションがデフォルトの設定の場合，jp1.im.db.DEFAULT.portNoの指定は不要です。

セットアップ情報ファイルについては「セットアップ情報ファイル（jimdbsetupinfo.conf）」を参照してください。

論理ホストの場合，統合監視DBのセットアップ時に使用したクラスタセットアップ情報ファイルのIMDBPORTオプションに指定した値を指定します。

クラスタセットアップ情報ファイルについては「クラスタセットアップ情報ファイル（jimdbclustersetupinfo.conf）」を参照してください。

jp1.im.db.DEFAULT.logicalHostNum=論理ホスト用のIMデータベースで論理ホストを識別する番号

論理ホスト用のIMデータベースで論理ホストを識別する番号を指定します。

統合監視DBのセットアップ時に使用したクラスタセットアップ情報ファイルのLOGICALHOSTNUMBERオプションに指定した値を指定します。

jp1.im.db.DEFAULT.portNoで論理ホストを指定した場合，このオプションを指定します。

クラスタセットアップ情報ファイルについては「クラスタセットアップ情報ファイル（jimdbclustersetupinfo.conf）」を参照してください。

jp1.imdd.gui.settings.linkedUnit.impact.unKnownDisplay=影響不明アイコンの表示/非表示

［業務フロー］タブおよび［連携ユニット］ダイアログで，後続ルートジョブネットへの影響の有無が不明であることを表すアイコン（[図データ]アイコン）を表示するかどうかを指定します。

「true」または「false」のどちらかを指定します。アイコンを表示する場合は「true」，表示しない場合は「false」です。デフォルト値は「true」です。

jp1.imdd.event.stormCompatible=繰り返しイベントの表示抑止機能の互換設定

バージョン12-00では，jcoimdefコマンドの‐stormオプションの設定がONでも，繰り返しイベントの表示が抑止されません。このため，バージョン12-00からバージョンアップした場合，繰り返しイベントの表示抑止機能を使用するには，繰り返しイベントの表示抑止機能の互換設定を無効（false）にする必要があります。

なお，バージョン12-10以降を新規インストールした場合，繰り返しイベントの表示抑止機能の互換設定はあらかじめ無効（false）に設定されています。

「true」または「false」のどちらかを指定します。

「true」を設定すると12-00と同様に繰り返しイベントの表示を抑止しません。「false」を設定すると，繰り返しイベントの表示を抑止します。

デフォルト値は「true」です。

jcoimdefコマンドの‐stormオプションの繰り返しイベントの監視抑止の設定がONで，かつjp1.imdd.event.stormCompatibleオプションの設定がfalseの場合に，繰り返しイベントの表示抑止機能が有効になります。

jcoimdefコマンドの‐stormオプションの繰り返しイベントの監視抑止の設定がOFFの場合は，jp1.imdd.event.stormCompatibleオプションの設定に関わらず，繰り返しイベントの表示抑止機能は無効となります。

jp1.imdd.gui.settings.eventSearchCount=イベント取得での検索回数

統合オペレーション・ビューアーがイベント一覧を表示するために行うイベント取得での検索回数を設定します。

イベント取得では，選択したIM管理ノードにマッピングされているイベントを対象に検索します。表示するページに応じて検索開始位置，検索方向を決定し，検索対象のイベント100件を決定します。ユーザーフィルターなどによりイベントが100件取得できなかった場合は，次のイベント100件を対象として繰り返し検索します。

この繰り返し行うイベント検索回数の上限値を設定します。検索回数が設定した値に達した場合は検索を中断し，イベント一覧には中断までに取得したイベントを表示します。

指定できる値は，0〜120000（単位：回）です。0を指定した場合は，無制限となります。デフォルトは10回です。指定できる範囲以外の値を指定した場合は，デフォルトの値を仮定して動作します。

jp1.imdd.authBasic=Basic認証の有効/無効

インテリジェント統合管理基盤の任意のREST APIでは，REST APIに付加したログイン情報による認証方式（Basic認証）を使用できます。このBasic認証を有効にするかどうかを設定します。

「true」または「false」のどちらかを指定します。

「true」を設定すると，Basic認証を有効にします。

デフォルト値は「false」です。

REST APIについては，「5.　API」を参照してください。

jp1.imdd.jp1LoginForm=true|false

インテリジェント統合管理基盤のログイン画面にJP1/Base認証のログインフォームを表示するかどうかを指定します。

OpenIDプロバイダの定義がない場合は，falseを指定してもtrueを仮定して動作します。

また，falseを指定しかつOpenIDプロバイダの定義が一つだけの場合は，インテリジェント統合管理基盤の認証画面を経由せずに，OpenIDプロバイダの認証URLを直接呼出します。

「true」または「false」のどちらかを指定します。

「true」を設定すると，JP1/Base認証ログインフォームを有効にします。

デフォルト値は「true」です。

jp1.imdd.oidc.＜OpenIDプロバイダのキー名＞.client-name=クライアントの別名

OpenIDプロバイダに登録したインテリジェント統合管理基盤のクライアントの別名を設定します。

クライアントの別名は，インテリジェント統合管理基盤のログイン画面のボタン名として使用します。

＜OpenIDプロバイダのキー名＞には，OpenIDプロバイダを特定できる一意の名称を指定してください。

jp1.imdd.oidc.＜OpenIDプロバイダのキー名＞.client-id=OpenIDプロバイダで設定したクライアントID

OpenIDプロバイダに登録したインテリジェント統合管理基盤のクライアントIDを設定します。

＜OpenIDプロバイダのキー名＞には，OpenIDプロバイダを特定できる一意の名称を指定してください。

jp1.imdd.oidc.＜OpenIDプロバイダのキー名＞.client-authentication-method=basic|post

OpenIDプロバイダに登録したインテリジェント統合管理基盤のクライアントを認可するサーバでの認証方法を設定します。

「basic」または「post」のどちらかを指定します。

デフォルト値は「basic」です。

＜OpenIDプロバイダのキー名＞には，OpenIDプロバイダを特定できる一意の名称を指定してください。

jp1.imdd.oidc.＜OpenIDプロバイダのキー名＞.authorization-grant-type= authorization_code

OpenIDプロバイダに登録したインテリジェント統合管理基盤のクライアントに使用する，認可の付与種別を設定します。

「authorization_code」を指定します。

＜OpenIDプロバイダのキー名＞には，OpenIDプロバイダを特定できる一意の名称を指定してください。

jp1.imdd.oidc.＜OpenIDプロバイダのキー名＞.redirect-uri=リダイレクトURLのURI

OpenIDプロバイダに登録したリダイレクトURLのURIを，次の形式で指定します。

＜インテリジェント統合管理基盤ログインURI＞/oauth2/code/＜OpenID Provider＞

（指定例）

https://IMHOST:20703/login/oauth2/code/okta

＜OpenIDプロバイダのキー名＞には，OpenIDプロバイダを特定できる一意の名称を指定してください。指定できる文字はURL形式の文字列です。それ以外の形式を指定した場合は，KAJY52019-Wメッセージを出力してOpenIDプロバイダの設定を無効にし，JP1/IM3-Managerサービスの起動を続行します。

WWWブラウザーとインテリジェント統合管理基盤のセッションに認証リクエストが保存され，OpenIDプロバイダを認証したあと，リダイレクトURLのURIにリダイレクトしてセッションを検証します。Cookieのデータはドメインごとに管理されるため，インテリジェント統合管理基盤ログインURIとリダイレクトURLのURIのインテリジェント統合管理サーバのホスト名は一致するように合わせて，認証処理中にCookieの削除や上書きがされないようにしてください。

なお，インテリジェント統合管理基盤ログインURIとリダイレクトURLのURIのインテリジェント統合管理サーバのホスト名が不一致の場合，OpenID認証によるログイン時にKAJY52028-Eのメッセージを統合オペレーション・ビューアーまたはREST APIの戻り値として出力します。

jp1.imdd.oidc.＜OpenIDプロバイダのキー名＞.scope=クライアントに使用されるスコープ

OpenIDプロバイダに登録したインテリジェント統合管理基盤のクライアントに使用するスコープを設定します。複数指定する場合は，コンマで区切ります。

＜OpenIDプロバイダのキー名＞には，OpenIDプロバイダを特定できる一意の名称を指定してください。

指定できる文字はASCII文字（0x21，0x23〜0x5B，0x5D〜0x7E）です。それ以外の文字を指定した場合は，KAJY52019-Wメッセージを出力してOpenIDプロバイダの設定を無効にし，JP1/IM3-Managerサービスの起動を続行します。

jp1.imdd.oidc.＜OpenIDプロバイダのキー名＞.authorization-uri=許可URLのURI

許可URLのURIを設定します。

＜OpenIDプロバイダのキー名＞には，OpenIDプロバイダを特定できる一意の名称を指定してください。

URL形式以外の値を指定した場合は，KAJY52019-Wメッセージを出力してOpenIDプロバイダの設定を無効にし，JP1/IM3-Managerサービスの起動を続行します。

jp1.imdd.oidc.＜OpenIDプロバイダのキー名＞.token-uri=トークン取得URLのURI

トークン取得URLのURIを設定します。

URL形式以外の値を指定した場合は，KAJY52019-Wメッセージを出力してOpenIDプロバイダの設定を無効にし，JP1/IM3-Managerサービスの起動を続行します。

jp1.imdd.oidc.＜OpenIDプロバイダのキー名＞.user-info-uri=ユーザー情報URLのURI

ユーザー情報URLのURIを設定します。

＜OpenIDプロバイダのキー名＞には，OpenIDプロバイダを特定できる一意の名称を指定してください。

URL形式以外の値を指定した場合は，KAJY52019-Wメッセージを出力してOpenIDプロバイダの設定を無効にし，JP1/IM3-Managerサービスの起動を続行します。

jp1.imdd.oidc.＜OpenIDプロバイダのキー名＞.userNameAttribute=属性名

ユーザー情報の応答からユーザーの名前にアクセスするために使用される属性名を設定します。

＜OpenIDプロバイダのキー名＞には，OpenIDプロバイダを特定できる一意の名称を指定してください。

jp1.imdd.oidc.＜OpenIDプロバイダのキー名＞.jwk-set-uri=JSON Web Key（JWK）SetURLのURI

JSON Web Key（JWK）SetURLのURIを設定します。

＜OpenIDプロバイダのキー名＞には，OpenIDプロバイダを特定できる一意の名称を指定してください。

URL形式以外の値を指定した場合は，KAJY52019-Wメッセージを出力してOpenIDプロバイダの設定を無効にし，JP1/IM3-Managerサービスの起動を続行します。

jp1.imdd.oidc.＜OpenIDプロバイダのキー名＞.issuer-uri=OpenIDプロバイダのIssuer Identifier

OpenIDプロバイダのIssuer Identifierを設定します。

＜OpenIDプロバイダのキー名＞には，OpenIDプロバイダを特定できる一意の名称を指定してください。

URL形式以外の値を指定した場合は，KAJY52019-Wメッセージを出力してOpenIDプロバイダの設定を無効にし，JP1/IM3-Managerサービスの起動を続行します。

jp1.imdd.oidc.＜OpenIDプロバイダのキー名＞.logout-uri=OpenIDプロバイダのログアウトURI

OpenIDプロバイダのログアウトURLを設定します。

＜OpenIDプロバイダのキー名＞には，OpenIDプロバイダを特定できる一意の名称を指定してください。

URL形式以外の値を指定した場合は，KAJY52019-Wメッセージを出力してOpenIDプロバイダの設定を無効にし，JP1/IM3-Managerサービスの起動を続行します。

jp1.imdd.oidc.＜OpenIDプロバイダのキー名＞.introspect-uri=OpenIDプロバイダのトークン情報取得URI

OpenIDプロバイダのトークン情報取得URLを設定します。

＜OpenIDプロバイダのキー名＞には，OpenIDプロバイダを特定できる一意の名称を指定してください。

URL形式以外の値を指定した場合は，KAJY52019-Wメッセージを出力してOpenIDプロバイダの設定を無効にし，JP1/IM3-Managerサービスの起動を続行します。

jp1.imdd.simt.updateMode=reconfigure|change

jddupdatetreeコマンドを実行する際のデフォルトの反映方式を設定します。

「reconfigure」または「change」のどちらかを指定します。

「reconfigure」を指定すると，バージョン12-10以前と同じ新規・再構築モードで反映します。「change」を指定すると，構成変更モードで反映します。

デフォルト値は「change」です。

定義がない場合は，「reconfigure」を仮定します。不正な値が指定された場合は，デフォルト値「change」を使用します。

注意事項

インテリジェント統合管理基盤サービスを起動した際にこの定義ファイルが存在しない場合，または読み込みに失敗した場合は，次の動作となります。

物理ホストの場合

統合トレースログにKAJY00015-Wの警告メッセージを出力し，デフォルト値のプロパティが指定されたものとして起動します。デフォルト値がないプロパティの場合は，プロパティが指定されていないものと仮定し起動します。

論理ホストの場合

統合トレースログにKAJY00021-Eのエラーメッセージを出力し，インテリジェント統合管理基盤サービスを終了します。

定義例

server.port=20703

jp1.imdd.proxy.server[0].host=ProxyServer
jp1.imdd.proxy.server[0].port=443
jp1.imdd.proxy.server[0].user=UserID
jp1.imdd.proxy.target[0].host=HostA
jp1.imdd.proxy.target[0].serverHost=ProxyServer

jp1.imdd.gui.settings.contentViews.sample.title=¥u30ab¥u30b9¥u30bf¥u30e0UI1
jp1.imdd.gui.settings.contentViews.sample.url=./customUI/sample/index.html
jp1.imdd.gui.settings.contentViews.sample.target=^(?=.*MYHOST).*$

jp1.imdd.gui.settings.contentViews.sample2.title=¥u30ab¥u30b9¥u30bf¥u30e0UI2
jp1.imdd.gui.settings.contentViews.sample2.url=./customUI/sample2/index.html
jp1.imdd.gui.settings.contentViews.sample2.sid=_ROOT_AllSystems

jp1.im.db.DEFAULT.portNo=20700
jp1.im.db.DEFAULT.logicalHostNum=[1-9]

jp1.imdd.gui.settings.linkedUnit.impact.unKnownDisplay=true
jp1.imdd.event.stormCompatible=false

jp1.imdd.gui.settings.eventSearchCount=10

jp1.imdd.authBasic=false

jp1.imdd.jp1LoginForm=true
jp1.imdd.oidc.keycloak.client-name=KEYCLOAK LOGIN
jp1.imdd.oidc.keycloak.client-id= ddmain
jp1.imdd.oidc.keycloak.client-authentication-method=basic
jp1.imdd.oidc.keycloak.authorization-grant-type=authorization_code
jp1.imdd.oidc.keycloak.redirect-uri=https://IMhost:20703/login/oauth2/code/keycloak
jp1.imdd.oidc.keycloak.scope=openid,profile,email,address,offline_access
jp1.imdd.oidc.keycloak.authorization-uri=https://OPhost:8080/auth/realms/jddmain/protocol/openid-connect/auth
jp1.imdd.oidc.keycloak.token-uri=https://OPhost:8080/auth/realms/jddmain/protocol/openid-connect/token
jp1.imdd.oidc.keycloak.user-info-uri=https://OPhost:8080/auth//realms/jddmain/protocol/openid-connect/userinfo
jp1.imdd.oidc.keycloak.userNameAttribute=sub
jp1.imdd.oidc.keycloak.jwk-set-uri=https://OPhost:8080/auth/realms/jddmain/protocol/openid-connect/certs
jp1.imdd.oidc.keycloak.issuer-uri=https://OPhost:8080/auth/realms/jddmain
jp1.imdd.oidc.keycloak.logout-uri=https://OPhost:8080/auth/realms/jddmain/protocol/openid-connect/logout
jp1.imdd.oidc.keycloak.introspect-uri=https://OPhost:8080/auth/realms/jddmain/protocol/openid-connect/token/introspect
jp1.imdd.simt.updateMode=change

システムノード定義ファイル（imdd_systemnode.conf）

形式

{
  "meta":{
    "version":"2"
  },
  "allSystem":[
    {
      "id":"1個目のシステム名(ID)",
      "displayName":"システム名（表示名）",
      "jp1ResourcesGroup":"JP1資源グループ",
      "hostName":[{"ホスト指定文字":"指定種別"},
                   …
                 ],
      "objectRoot":[
             {"type":"オブジェクトルートノード種別",
              "name":[
                 {"オブジェクトルートノード指定文字":"指定種別"},
                    …
                     ]
                    },
                    …
             ],
      "children":[
        {
          "id":"1個目のサブシステム名（ID）",
          "displayName":"サブシステム名（表示名）",
          "jp1ResourcesGroup":"JP1資源グループ",
          "hostName":[
                       {"ホスト指定文字":"指定種別"},
                        …
                     ],
          "objectRoot":[
             {"type":"オブジェクトルートノード種別",
              "name":[
                 {"オブジェクトルートノード指定文字":"指定種別"},
                    …
                     ]
                    },
                    …
                     ],
          "children":[
            {
              "id":"1個目のサブシステム配下のサブシステム名（ID）",
              "displayName":"サブシステム名（表示名）",
              "jp1ResourcesGroup":"JP1資源グループ",
              "hostName":[{"ホスト指定文字":"指定種別"},…],
              "objectRoot":[
                 {"type":"オブジェクトルートノード種別",
                  "name":[
                     {"オブジェクトルートノード指定文字":"指定種別"},
                        …
                          ]
                         },
                         …
                 ]
              "children":[
                {
                  …
                },
                …
              ]
            },
            …
          ]
        },
        {
          "id":"2個目のサブシステム名（ID）",
          "displayName":"サブシステム名（表示名）",
          "jp1ResourcesGroup":"JP1資源グループ",
          "hostName":[{"ホスト指定文字":"指定種別"},…],
          "objectRoot":[
             {"type":"オブジェクトルートノード種別",
              "name":[
                 {"オブジェクトルートノード指定文字":"指定種別"},
                    …
                      ]
                     },
                     …
             ]
          "children":[
            {
              …
            },
            …
          ]
        },
        …
      ]
    },
    {
      "id":"2個目のシステム名(ID)",
      …
    },
    …
  ]
}

ファイル

imdd_systemnode.conf

imdd_systemnode.conf.model（システムノード定義ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Managerパス¥conf¥imdd¥

論理ホストのとき

共有フォルダ¥jp1imm¥conf¥imdd¥

UNIXの場合

物理ホストのとき

/etc/opt/jp1imm/conf/imdd/

論理ホストのとき

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

説明

サンバースト形式やツリー形式で表示するシステムの階層構造を定義し，収集したデータを定義したホスト，およびホスト以外のオブジェクトルートでグルーピングする設定ファイルです。

インテリジェント統合管理基盤が収集した構成情報内のホスト，およびホスト以外のオブジェクトルートに対して，どのシステムに配置するかを定義します。

表示対象は，JP1/IM - Managerのエージェント構成またはリモート監視構成に含まれているホスト，およびホスト以外のオブジェクトルート，および他製品から収集した構成情報に含まれるホスト，およびホスト以外のオブジェクトルートです。JP1/IM - Manager（インテリジェント統合管理基盤）の連携先ホストにAJSマネージャーやPFMマネージャーが含まれる場合，配下のAJSエージェントやPFMの監視エージェントもツリーの表示対象です。

jddcreatetreeコマンド実行時にこれらのホスト，およびホスト以外のオブジェクトルートの一覧を取得し，システムノード定義ファイル（imdd_systemnode.conf）の定義内容に従って，システムの配下にホスト，およびホスト以外のオブジェクトルートを振り分けて階層構造を作成します。このため，システムノード定義ファイル（imdd_systemnode.conf）に定義されたホスト，およびホスト以外のオブジェクトルートでも，JP1/IM，JP1/AJS，およびJP1/PFMの構成上に存在しない場合は，ツリー上には表示されません。

なお，一つのノードが複数のシステムまたはサブシステムで使用される場合は，どれか一つのシステムに定義を絞る必要があります。複数のシステムで一つのノードを管理することはできません。

定義の反映時期

jddcreatetreeコマンドおよびjddupdatetreeコマンドが正常終了すると，システムノード定義ファイルの情報がインテリジェント統合管理基盤に反映されます。

jddcreatetreeコマンドおよびjddupdatetreeコマンドについては，「jddcreatetree」（1.　コマンド），「jddupdatetree」（1.　コマンド）を参照してください。

記述内容

システムノード定義ファイルは，UTF-8で，BOM（byte order mark）が付与されないように保存してください。「¥」を文字として指定したい場合は，エスケープ文字「¥」を「¥」の前に指定します。

"version":"2"

システムノード定義ファイルのバージョンです。「2」を指定します。このオプションは省略できません。

"id":"n個目のシステム名(ID)"

SID（連携する各製品の構成要素を一意に表すID）に設定するシステムのIDを，半角英数字で指定します。

idは255文字以内で指定します。システムとシステム構成要素を合わせて1,000個まで指定できます。このオプションは省略できません。

システムの場合

allSystemの直下に定義するシステム内の一意の値

サブシステムの場合

childrenの直下に定義するサブシステム内の一意の値

システムの統合によりシステムノード定義ファイルを統合する場合，設定値が一意となっているかを確認し，必要に応じてidを変更してください。

"displayName":"システム名（表示名）"

サンバースト形式，ツリー形式に表示されるシステムの名称を指定します。

名称は，制御文字および機種依存文字を含まない255文字以内の文字列で指定します。なお，displayNameは，システムノード定義ファイル内で一意とする必要はありません。同じ名称を指定できます。

"jp1ResourcesGroup":"JP1資源グループ"

システムが監視する範囲のJP1資源グループです。JP1資源グループによるアクセス制御をしない場合，この項目は不要です。

jp1ResourcesGroupは半角英数字および記号「!」，「@」，「#」，「$」，「%」，「&」，「_」，「-」，「*」，「'」，「^」，「{」，「}」，「(」，「)」，「.」，「¥」，「`」，「~」です。64文字以内で指定します。

"hostName":[{"ホスト指定文字":"指定種別"}…]

IM構成上のホスト，連携製品の登録エージェントなどシステムに属するホストを，次に示すホスト指定文字と指定種別で指定します。

ホスト指定文字

指定種別（6文字以内）

ホスト名そのもので指定する場合

""（空文字）

正規表現※でホストを指定する場合

regexp

注※　正規表現には拡張正規表現を使用します。正規表現は完全一致であり，指定した正規表現とホスト名の文字列全体を比較し，完全に一致した場合だけ条件が成立します。正規表現の詳細については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「付録G　正規表現」を参照してください。

ホスト名に指定できる文字は，半角英数字および記号「!」，「$」，「(」，「)」，「*」，「+」，「,」，「-」，「.」，「/」，「:」，「<」，「=」，「[」，「¥」，「]」，「^」，「{」，「|」，「}」です。255文字以内で指定します。

（指定例）

"hostName":[{"host1":""},{".+[1-5]+":"regexp"}]

hostNameで設定したホストでデータをグループ化する際は，上から設定された順番で処理されます。また，ホストのグループ化では，大文字小文字の区別はありません。childrenでサブシステムを定義していない場合，かつtypeおよびnameが指定されていない場合，このオプションは省略できません。

なお，ホスト名が重複している場合，二つ目以降のホスト名は無視されます。

"objectRoot"

システム，またはサブシステムに属するオブジェクトルートノードのオブジェクトルートノード種別とオブジェクトルートノード指定文字，指定種別を指定します。

"type":"オブジェクトルートノード種別"

nameに指定したオブジェクトルートノード名の種別を指定します。

指定したオブジェクトルートノード種別は大文字小文字の区別はありません。typeに指定できる値については，各製品のマニュアルを参照してください。なお，JP1/AJSまたはJP1/PFMと連携する場合に指定できる値は，HOSTだけです。

childrenでサブシステムを定義していない場合，かつhostNameが指定されていない場合，このオプションの指定は省略できません。

typeに指定できる文字は，半角英数字および記号「-」，「.」，「:」，「~」です。

"name":[{"オブジェクトルートノード指定文字":"指定種別"}…]

システム，またはサブシステムに属するオブジェクトルートノードを，次に示すオブジェクトルートノード指定文字と指定種別で指定します。

オブジェクトルートノード指定文字

指定種別

オブジェクトルートノード名そのもので指定する場合

""（空文字）

正規表現※で指定する場合

regexp

注※　正規表現には拡張正規表現を使用します。正規表現は完全一致であり，指定した正規表現とオブジェクトルートノード名の文字列全体を比較し，完全に一致した場合だけ条件が成立します。正規表現の詳細については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「付録G　正規表現」を参照してください。

（指定例1）

"name":{"switch1":""}

（指定例2）

"name":{".+[1-5]+":"regexp"}

nameで設定したオブジェクトルートノードでデータをグループ化する際は，上から設定された順番で処理されます。また，オブジェクトルートノードのグループ化では，大文字小文字の区別はありません。nameに設定したオブジェクトルートノード名とtypeに設定したオブジェクトルートノード種別が重複している場合，二つ目以降のオブジェクトルートノード名は無視されます。

childrenでサブシステムを定義していない場合，かつhostNameが指定されていない場合，このオプションの指定は省略できません。

"children"

システムの直下のサブシステムの情報を，id〜childrenの内容で定義し，階層化の情報として設定します。階層はシステムと合わせて10階層まで定義できます。配下にサブシステムを持たないシステムの場合，この項目は不要です。

なお，統合オペレーション・ビューアーのサンバーストまたはツリーに表示できる階層については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」のサンバーストまたはツリーの階層を説明している章を参照してください。

定義例1

例題に示す構成の場合の定義例

次のシステム，サブシステム，および各システム，サブシステムに属するホストの構成を設定します。

（例題）

{
  "meta":{
    "version":"2"
  },
  "allSystem":[
    {
      "id":"systemA",
      "displayName":"システムA",
      "jp1ResourcesGroup":"SYSTEM_A",
      "hostName":[{"HOST-A0":""}],
      "children":[
        {
          "id":"subA1",
          "displayName":"システムA-1",
          "jp1ResourcesGroup":"SYSTEM_A",
          "hostName":[{"HOST-A10":""},{"HOST-A11":""}]
        },
        {
          "id":"subA2",
          "displayName":"システムA-2",
          "jp1ResourcesGroup":"SYSTEM_A",
          "children":[
            {
              "id":"subA21",
              "displayName":"システムA-2-1",
              "jp1ResourcesGroup":"SYSTEM_A",
              "hostName":[{"^HOST-A21.*":"regexp"},{"HOST-A10-1":""}]
            },
            {
              "id":"subA22",
              "displayName":"システムA-2-2",
              "jp1ResourcesGroup":"SYSTEM_A",
              "hostName":[{"HOST-A22":""}]
            }
          ]
        }
      ]
    },
    {
      "id":"systemB",
      "displayName":"システムB",
      "jp1ResourcesGroup":"SYSTEM_B",
      "hostName":[{"HOST-B10":""},{"HOST-B11":""}]
    }
  ]
}

定義例2

一つのホストやルートオブジェクトノードが複数のシステムまたはサブシステムで使用される場合の定義例

複数のシステムで一つのホストを管理できないため，システムAまたはシステムBのどちらかに定義を絞ります。

例題

{
  "meta":{
    "version":"1"
  },
  "allSystem":[
    {
      "id":"systemA",
      "displayName":"システムA",
      "hostName":[{"HOST1":""},{"HOST-A":""}]
    },
    {
      "id":"systemB",
      "displayName":"システムB",
      "hostName":[{"HOST1":""},{"HOST-B":""}]
    }
  ]
}

システムAに絞る場合の定義例

{
  "meta":{
    "version":"1"
  },
  "allSystem":[
    {
      "id":"systemA",
      "displayName":"システムA",
      "hostName":[{"HOST1":""},{"HOST-A":""}]
    },
    {
      "id":"systemB",
      "displayName":"システムB",
      "hostName":[{"HOST-B":""}]
    }
  ]
}

システムBに絞る場合の定義例

{
  "meta":{
    "version":"1"
  },
  "allSystem":[
    {
      "id":"systemA",
      "displayName":"システムA",
      "hostName":[{"HOST-A":""}]
    },
    {
      "id":"systemB",
      "displayName":"システムB",
      "hostName":[{"HOST1":""},{"HOST-B":""}]
    }
  ]
}

IM管理ノードカテゴリ名称定義ファイル（imdd_category_name.conf）

形式

{
  "meta":{
    "version":"1"
  },
  "categoryData":[
    {"categoryId":"カテゴリId","categoryName":"カテゴリ名称"},
    …
  ]
}

ファイル

imdd_category_name.conf

imdd_category_name.conf.model（IM管理ノードカテゴリ名称定義ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Managerパス¥conf¥imdd¥

論理ホストのとき

共有フォルダ¥jp1imm¥conf¥imdd¥

UNIXの場合

物理ホストのとき

/etc/opt/jp1imm/conf/imdd/

論理ホストのとき

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

説明

インテリジェント統合管理基盤が収集したデータをサンバースト形式，ツリー形式で表示する際の管理グループのIM管理ノードカテゴリの名称，および順番を定義するファイルです。順番は，IM管理ノードカテゴリが定義された順となります。

定義の反映時期

jddcreatetreeコマンドおよびjddupdatetreeコマンドが正常終了すると，IM管理ノードカテゴリ名称定義ファイルの情報がインテリジェント統合管理基盤に反映されます。

jddcreatetreeコマンドおよびjddupdatetreeコマンドについては，「jddcreatetree」（1.　コマンド），「jddupdatetree」（1.　コマンド）を参照してください。

記述内容

IM管理ノードカテゴリ名称定義ファイルは，UTF-8で，BOM（byte order mark）が付与されないように保存してください。

"version":"1"

IM管理ノードカテゴリ名称定義ファイルのバージョンです。「1」を指定します。

"categoryId":"カテゴリId"

デフォルトで設定された値です。編集しないでください。

"categoryName":"カテゴリ名称"

サンバースト形式，ツリー形式に表示される管理グループのカテゴリ名称を指定します。categoryNameは制御文字および機種依存文字を含まない255文字以内の文字列で指定します。

定義例

下線部分のカテゴリの順番を入れ替える定義例を次に示します。

変更前

{
  "meta":{
    "version":"1"
  },
  "categoryData":[
    {"categoryId":"job","categoryName":"Job"},
    {"categoryId":"serviceResponse","categoryName":"Service Response"},
    {"categoryId":"enterprise","categoryName":"Enterprise"},
    {"categoryId":"transactionProcessing","categoryName":"Transaction Processing"},
    {"categoryId":"applicationServer","categoryName":"Application Server"},
    {"categoryId":"database","categoryName":"Database"},
    {"categoryId":"platform","categoryName":"Platform"},
    {"categoryId":"virtualMachine","categoryName":"Virtual Machine"},
    {"categoryId":"managementApplications","categoryName":"Management Applications"},
    {"categoryId":"otherApplications","categoryName":"Other Applications"}
  ]
}

変更後

{
  "meta":{
    "version":"1"
  },
  "categoryData":[
    {"categoryId":"job","categoryName":"Job"},
    {"categoryId":"serviceResponse","categoryName":"Service Response"},
    {"categoryId":"enterprise","categoryName":"Enterprise"},
    {"categoryId":"platform","categoryName":"Platform"},
    {"categoryId":"database","categoryName":"Database"},
    {"categoryId":"virtualMachine","categoryName":"Virtual Machine"},
    {"categoryId":"managementApplications","categoryName":"Management Applications"},
    {"categoryId":"transactionProcessing","categoryName":"Transaction Processing"},
    {"categoryId":"applicationServer","categoryName":"Application Server"},
    {"categoryId":"otherApplications","categoryName":"Other Applications"}
  ]
}

構成取得対象ホスト定義ファイル（imdd_target_host.conf）

形式

{
  "meta":{
    "version":"1"
  },
  "target":[
    {
      "product":"製品名",
      "hostName":["ホスト名1","ホスト名2",…]
    },
    …
  ]
}

ファイル

imdd_target_host.conf

imdd_target_host.conf.model（構成取得対象ホスト定義ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Managerパス¥conf¥imdd¥

論理ホストのとき

共有フォルダ¥jp1imm¥conf¥imdd¥

UNIXの場合

物理ホストのとき

/etc/opt/jp1imm/conf/imdd/

論理ホストのとき

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

説明

インテリジェント統合管理基盤が，連携製品の監視オブジェクトの情報を取得する際に，このファイルの定義内容に基づいて連携製品ごとに取得先のホストを設定します。

定義の反映時期

jddcreatetreeコマンドおよびjddupdatetreeコマンドが正常終了すると，構成取得対象ホスト定義ファイルの情報がインテリジェント統合管理基盤に反映されます。

jddcreatetreeコマンドおよびjddupdatetreeコマンドについては，「jddcreatetree」（1.　コマンド），「jddupdatetree」（1.　コマンド）を参照してください。

記述内容

構成取得対象ホスト定義ファイルは，UTF-8で，BOM（byte order mark）が付与されないように保存してください。「¥」を文字として指定したい場合は，エスケープ文字「¥」を「¥」の前に指定します。

"version":"1"

構成取得対象ホスト定義ファイルのバージョンです。「1」を指定します。

"product":"製品名"

連携する製品名を半角英数字で指定します。255文字以内で指定します。構成取得対象を指定する場合，このオプションは省略できません。

AJS3

JP1/AJSと連携する場合に指定します。

PFM

JP1/PFMと連携する場合に指定します。

"hostName":["ホスト名1","ホスト名2",…]

構成取得対象のホスト名を255文字以内の文字列で指定します。

使用できる文字は半角英数字と記号「!」，「$」，「(」，「)」，「*」，「+」，「,」，「-」，「.」，「/」，「:」，「<」，「=」，「[」，「¥」，「]」，「^」，「{」，「|」，「}」です。

IM構成に登録済みのホストを，物理ホストまたは論理ホストの名称で指定します。連携する製品内で同名のホストの指定はできません。構成取得対象を指定する場合，このオプションは省略できません。

記載するホスト名はhostsファイルやDNSに登録し，JP1/IM - ManagerホストのOS上で名前解決できるようにしてください。jp1hostsファイルおよびjp1hosts2ファイルの設定は参照されません。

定義例

JP1/AJS，JP1/PFMと連携する場合

{
  "meta":{
    "version":"1"
  },
  "target":[
    {
      "product":"AJS3",
      "hostName":["host-01","host-02","host-03"]
    },
    {
      "product":"PFM",
      "hostName":["host-01","host-04"]
    }
  ]
}

ホスト名定義ファイル（imdd_host_name.conf）

形式

{
  "meta":{
    "version":"1"
  },
  "hostNameDef":[
    {
      "sourceHostName":["構成情報のホスト名1","構成情報のホスト名2"],
      "hostName":"ツリーデータ上のホスト名",
      "label":"画面上の表示名"
    },
    …
  ]
}

ファイル

imdd_host_name.conf

imdd_host_name.conf.model（ホスト名定義ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Managerパス¥conf¥imdd¥

論理ホストのとき

共有フォルダ¥jp1imm¥conf¥imdd¥

UNIXの場合

物理ホストのとき

/etc/opt/jp1imm/conf/imdd/

論理ホストのとき

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

説明

ホスト名にエイリアス名を付けることができる製品をIM管理ノードの構成に加える場合，エイリアス名と実ホスト名のマッピングを定義するファイルです。エイリアス名と実ホスト名をマッピングすると，ツリー上のホスト名が実ホスト名となるため，管理ツールごとにエイリアス名が異なる場合でも，ツリー上では同じホストにグルーピングできます。

統合オペレーション・ビューアーに表示するホスト名を変更する場合も，この定義ファイルを使用します。

定義の反映時期

jddcreatetreeコマンドおよびjddupdatetreeコマンドが正常終了すると，ホスト名定義ファイルの情報がインテリジェント統合管理基盤に反映されます。

jddcreatetreeコマンドおよびjddupdatetreeコマンドについては，「jddcreatetree」（1.　コマンド），「jddupdatetree」（1.　コマンド）を参照してください。

記述内容

ホスト名定義ファイルは，UTF-8で，BOM（byte order mark）が付与されないように保存してください。「¥」を文字として指定したい場合は，エスケープ文字「¥」を「¥」の前に指定します。

"version":"1"

ホスト名定義ファイルのバージョンです。「1」を指定します。

"hostNameDef"

sourceHostNameまたはlabelのどちらかの指定が必要です。hostNameの指定は必須です。

"sourceHostName":["構成情報のホスト名1","構成情報のホスト名2"]

同一ホストとして扱うホスト名を指定します。最大10個指定できます。一つのホスト名は，255文字以内で指定します。

使用できる文字は半角英数字と記号「!」，「$」，「(」，「)」，「*」，「+」，「,」，「-」，「.」，「/」，「:」，「<」，「=」，「[」，「¥」，「]」，「^」，「{」，「|」，「}」です。

"hostName":"ツリーデータ上のホスト名"

ツリーデータ上のホスト名を指定します。ホスト名は，255文字以内で指定します。

使用できる文字は半角英数字と記号「!」，「$」，「(」，「)」，「*」，「+」，「,」，「-」，「.」，「/」，「:」，「<」，「=」，「[」，「¥」，「]」，「^」，「{」，「|」，「}」です。

"label":"画面上の表示名"

画面上に表示するラベル名を指定します。制御文字および機種依存文字を含まない255文字以内の文字列で指定します。

画面に表示されるホスト名

画面上に表示されるホスト名は，次に示す優先度に従い表示文字列を決定します。

優先度

hostNameの値との一致／不一致

labelの設定有無

ホストの構成情報のSIDのvalue値のlabelの設定有無

画面に表示されるホスト名

高い

一致

あり

−

labelの値

↑

一致

なし

−

hostNameの値

↓

不一致

−

あり

ホストのの構成情報のSIDのvalue値に設定されているlabelの値

低い

不一致

−

なし

構成情報のSIDに設定されているホスト名（_HOST_XXXXXのXXXXX）

（凡例）−：関係しない項目です。

構成情報のSID，およびそのvalue値は［統合オペレーション・ビューアー］画面上，またはJP1/IM - Managerが提供するREST APIを使用することで確認できます。SIDの詳細については「7.1　SID」，REST APIの詳細については「5.　API」をそれぞれ参照してください。

定義例

定義例1：「hostX」を画面上で「ホストX」と表示する場合

{
  "meta":{
    "version":"1"
  },
  "hostNameDef":[
    {
      "hostName":"hostX",
      "label":"ホストX"
    }
  ]
}

定義例2：エイリアス名として「hostA,hostB」と定義されているホストを「hostX」と扱う際に「hostX」を画面上で「ホストX」と表示する場合

{
  "meta":{
    "version":"1"
  },
  "hostNameDef":[
    {
      "sourceHostName":["hostA","hostB"],
      "hostName":"hostX",
      "label":"ホストX"
    }
  ]
}

IM管理ノードリンク定義ファイル（imdd_nodeLink_def.conf）

形式

{
  "meta":{
    "version":"1"
  },
  "links":[
    {
      "from":"先行ノードの構成情報のSIDまたはツリーSID",
      "to":"後続ノードの構成情報のSIDまたはツリーSID",
      "type":"処理対象種別",
      "value":{
          "unit":[
            {
              "precedingJob":"先行する連携ユニットの完全名",
              "succeedingJob":"後続の連携ユニットの完全名",
              "succeedingJobTimeType":"連携予定日時の取得形式",
              "relationType":"連携種別"
            }, ...
          ]
      }
    }, ...
  ]
}

ファイル

imdd_nodeLink_def.conf

imdd_nodeLink_def.conf.model（IM管理ノードリンク定義ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Managerパス¥conf¥imdd¥

論理ホストのとき

共有フォルダ¥jp1imm¥conf¥imdd¥

UNIXの場合

物理ホストのとき

/etc/opt/jp1imm/conf/imdd/

論理ホストのとき

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

説明

IM管理ノード間の関連を定義するファイルです。この定義ファイルは，ユーザーがIM管理ノードの関連を新たに定義したい場合に使用します。IM管理ノードリンクファイル（imdd_nodeLink.json）と同じ関連（from，to，typeが一致する関連）を定義した場合は，このファイルに定義した関連がシステムに反映されます。

JP1/AJSやJP1/PFMと連携した場合，監視対象間の関連は関連ノード表示機能によって自動的に登録されます。それ以外に個別に関連を追加し，統合オペレーション・ビューアーに表示したい場合に，この定義ファイルに関連を指定できます。関連ノード表示機能については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「3.11　関連ノード表示機能」を参照してください。

REST APIを使用すると，設定した内容をデータとして取得することができます。REST APIについては，「5.　API」を参照してください。

定義の反映時期

jddupdatetreeコマンドが正常終了すると，IM管理ノードリンク定義ファイルの設定がインテリジェント統合管理基盤に反映されます。

記述内容

IM管理ノードリンク定義ファイルは，UTF-8で，BOM（byte order mark）が付与されないように保存してください。

"version":"1"

IM管理ノードリンク定義ファイルのバージョンです。「1」を指定します。

"from":"先行ノードの構成情報のSIDまたはツリーSID"

先行ノードです。構成情報のSIDまたはツリーSIDを指定します。SIDの種別，名称に指定できる文字については，「7.1　SID」を参照してください。なお，SIDは［統合オペレーション・ビューアー］画面，またはREST APIで参照した値を定義することを推奨します。

このオプションは省略できません。

［業務フロー］タブでは，typeがrootJobnetExecutionOrderでかつSIDで指定した場合にだけ，IM管理ノード間の関連として表示されます。なお，ツリーSIDで指定した場合，画面には関連が表示されませんが，リンク情報取得APIによってツリーSIDで指定したリンク情報を取得できます。詳細については「5.5.1　リンク情報取得」を参照してください。

［関連ノード］タブの場合は，typeに関わらずSIDおよびツリーSIDのどちらで指定されたときでも，IM管理ノード間の関連として表示されます。

（指定例）ルートジョブネットを指定する場合

_JP1AJS-M_HOST1/_HOST_HOST1/_JP1SCHE_schedulerserv/_JP1JOBG_jobgroup/_JP1ROOTJOBNET_jobnet1

"to":"後続ノードの構成情報のSIDまたはツリーSID"

後続ノードです。構成情報のSIDまたはツリーSIDを指定します。SIDの種別，名称に指定できる文字については，「7.1　SID」を参照してください。なお，SIDは［統合オペレーション・ビューアー］画面，またはREST APIで参照した値を定義することを推奨します。

このオプションは省略できません。

［業務フロー］タブでは，typeがrootJobnetExecutionOrderでかつSIDで指定した場合にだけ，IM管理ノード間の関連として表示されます。なお，ツリーSIDで指定した場合，画面には関連が表示されませんが，リンク情報取得APIによってツリーSIDで指定したリンク情報を取得できます。詳細については「7.1　SID」を参照してください。

［関連ノード］タブの場合は，type に関わらずSIDおよびツリーSIDのどちらで指定されたときでも，IM管理ノード間の関連として表示されます。

（指定例）ルートジョブネットを指定する場合

_JP1AJS-M_HOST1/_HOST_HOST1/_JP1SCHE_schedulerserv/_JP1JOBG_jobgroup/_JP1ROOTJOBNET_jobnet2

"type":"処理対象種別"

fromとtoで設定したリンク情報が示す種別を指定します。1〜255バイトの半角英数字が指定できます。このオプションは省略できません。

typeは同じ意味を持つ関連同士をグループ化する情報です。統合オペレーション・ビューアーの［関連ノード］タブでは，typeごとに関連をフィルタリングして表示することができます。

JP1/IMの製品内や他製品との連携では次の種別を使用します。これらの種別以外に，ユーザーが任意の種別を指定することもできます。

rootJobnetExecutionOrder（ルートジョブネット実行順序の関連）

rootJobnetAgent（ルートジョブネットとAJSエージェントの関連）

managerAgent（JP1製品のマネージャーとエージェントの関連）

sameNode（名称が同じノードの関連）

L2Connection（JP1/NNMiで管理するレイヤー2接続線の関連）

Infrastructure（JP1/OAで管理するインフラリソースの関連）

monitoringConfiguration（監視製品の構成における製品と監視対象の関連）

typeにrootJobnetExecutionOrderを指定する場合は，fromおよびtoにはIM管理ノードの構成情報のSIDを指定してください。

"value"

リンク情報の付与情報を指定します。このオプションは省略できます。

"unit"

処理対象種別がルートジョブネット実行順序の場合に指定します。連携ユニットの情報を指定します。このオプションは省略できます。

"precedingJob":"先行する連携ユニットの完全名"

先行する連携ユニットの完全名を指定します。制御文字を除く1メガバイト以内の文字列で指定します。このオプションは省略できません。

（指定例）

/jobnet1/JP1イベント送信ジョブ

"succeedingJob":"後続の連携ユニットの完全名"

後続の連携ユニットの完全名を指定します。制御文字を除く1メガバイト以内の文字列で指定します。このオプションは省略できません。

（指定例）

/jobnet2/JP1イベント受信監視ジョブ

"succeedingJobTimeType":"連携予定日時の取得形式"

処理対象種別がルートジョブネット実行順序の場合に指定します。連携予定日時を指定します。このオプションは省略できます。省略した場合は，endtimeを仮定して動作します。

relationTypeにwaitConditionを指定している場合はオプションの指定は無視され，startTimeとして動作します。

"startTime"

先行ユニットの終了によって，後続ユニットが実行開始される連携の場合に指定します。例えば，保留解除操作による連携の場合に指定します。

"endTime"

先行ユニットの終了によって，後続ユニットの待ち条件が満了する連携の場合に指定します。例えば，イベントジョブ（ファイル監視ジョブやメール受信監視ジョブなど）による連携の場合に指定します。

"relationType":"連携種別"

処理対象種別がルートジョブネット実行順序の場合に指定します。precedingJob（先行する連携ユニットの完全名）とsucceedingJob（後続の連携ユニットの完全名）の連携種別を指定します。

waitCondition

待ち合わせを使用した連携の場合に指定します。

この連携種別を指定した場合，precedingJob（先行する連携ユニットの完全名）は待ち合わせ対象ユニットを，succeedingJob（後続の連携ユニットの完全名）には待ち合わせ条件付きユニットの完全名を指定してください。

jobnetConnector

ジョブネットコネクタを使用した連携の場合に指定します。

この連携種別を指定した場合，precedingJob（先行する連携ユニットの完全名）およびsucceedingJob（後続の連携ユニットの完全名）には，ジョブネットコネクタ，または接続先のルートジョブネットのユニット完全名を指定してください。

other

その他の連携の場合に指定します。JP1イベント連携の場合は，この値を指定します。

このオプションは省略できます。省略した場合は，otherを仮定して動作します。

なお，［連携ユニット］ダイアログの［連携予定日時］に表示される日時は，指定した連携種別によって異なります。詳細はマニュアル「JP1/Integrated Management 3 - Manager 画面リファレンス」の「2.6.1　［タブ］領域」の連携ユニットの説明を参照してください。

注意事項

precedingJob（先行する連携ユニットの完全名）とsucceedingJob（後続の連携ユニットの完全名）には，relationType（連携種別）で指定した連携種別と一致したユニット完全名を指定してください。異なるユニット完全名を指定した場合，［連携ユニット］ダイアログの［連携予定日時］に正しい日時が表示されません。

定義例

{
    "meta":{
        "version":"1"
    },
        "links": [
    {
     "from":_JP1AJS-M_HOST1/_HOST_HOST1/_JP1SCHE_schedulerserv
/_JP1JOBG_jobgroup/_JP1ROOTJOBNET_jobnet1",
     "to":_JP1AJS-M_HOST1/_HOST_HOST1/_JP1SCHE_schedulerserv
/_JP1JOBG_jobgroup/_JP1ROOTJOBNET_jobnet2",
     "type":"rootJobnetExecutionOrder",
     "value":{
          "unit":[
           {
              "precedingJob":"/jobnet1/ジョブ1",
              "succeedingJob":"/jobnet2/ジョブ2",
              "succeedingJobTimeType":"startTime",
              "relationType":"other"
           }, …
         ]
      }

        }, ...
    ]
}

提案定義ファイル（imdd_suggestion.conf）

提案定義ファイル全体の形式

{
    "meta":{
        "version":"1"
    },
    "suggestions":[
        {
            "suggestionId":"提案ID",
            "label":"提案表示名",
            "node":"提案情報を表示するノード",
            "permissions":[
                ["提案情報を表示するJP1権限",...],
                ["提案情報を表示するJP1権限",...],
                ...
            ],
            "cases":[
                [
                    "提案活性条件",
                    "提案活性条件",
                    ...
                ],
                [
                    "提案活性条件",
                    "提案活性条件",
                    ...
                ],
                ...
            ],
            "action":{
                "対処アクション情報"
            }
        },
        ...
    ]
}

ファイル

imdd_suggestion_任意のファイル名.conf（ユーザーが作成する提案定義ファイル）

imdd_suggestion.conf（提案定義ファイル）

imdd_suggestion.conf.model（提案定義ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Managerパス¥conf¥imdd¥suggestion

論理ホストのとき

共有フォルダ¥jp1imm¥conf¥imdd¥suggestion

UNIXの場合

物理ホストのとき

/etc/opt/jp1imm/conf/imdd/suggestion

論理ホストのとき

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

ユーザーが作成する提案定義ファイルは，imdd_suggestion.confファイルをコピーして任意のディレクトリに格納し，jddupdatesuggestionコマンドの引数でディレクトリパスを指定してください。

説明

提案定義ファイルは，対処アクションを提案する条件（提案表示条件と提案活性条件）と対処アクションの内容を定義するファイルです。

提案定義ファイルは，複数作成できます。また，一つの提案定義ファイルには，複数の提案定義を作成できます。提案定義には，提案定義ごとに提案ID（suggestionId）を設定し，個別の提案定義として識別されるようにします。このため，すべての提案定義ファイルのなかで，一意の提案IDの設定が必要です。重複した提案IDが設定された場合は，提案定義ファイルの反映時にエラーとなります。

定義の反映時期

jddupdatesuggestionコマンドが正常終了すると，提案定義ファイルの情報がインテリジェント統合管理基盤に反映されます。

記述内容

提案定義ファイルは，UTF-8で，BOM（byte order mark）が付与されないように保存してください。提案定義ファイル全体の記述内容を次に示します。

"meta"

メタ情報を指定します。データ型はobjectです。このメンバーは省略できません。

"version":"1"

提案定義ファイルのバージョンです。「1」を指定します。データ型はstringです。このメンバーは省略できません。

"suggestions"

提案定義のオブジェクトの配列です。すべての提案定義ファイルを通して，0〜1,000件指定できます。データ型はobject[]です。このメンバーは省略できません。

"suggestionId":"提案ID"

すべての提案定義ファイルを通して，一意となる提案のIDを指定します。

提案IDには，半角英数字，-（ハイフン），_（アンダースコア）が使用できます。指定できる文字数は，1文字以上255文字以下です。

提案IDは，REST APIのリクエストで指定したり，メッセージの埋め字に使用されたりするため，わかりやすい値にしてください。

なお，［統合オペレーション・ビューアー］画面−［提案］タブの［提案一覧］領域では，各提案は活性状態と提案IDの文字コード順でソートされます。このため，優先度が高い提案定義には，文字コードの順序が前方の提案IDを定義してください。

提案IDには，「JP1」，「jp1」，「hitachi」，「HITACHI」から始まる文字は使用できません。

データ型はstringです。このメンバーは省略できません。

"label":"提案表示名"

［統合オペレーション・ビューアー］画面の［提案］タブ−［提案一覧］領域，および［提案詳細］領域の［提案名］に表示される，提案表示名を指定します。制御文字を含まない1文字以上60文字以下の文字列で指定します。データ型はstringです。このメンバーは省略できません。

"node":"提案情報を表示するIM管理ノード"

提案があることを示すIM管理ノードのツリーSIDを，正規表現で指定します。半角英数字，半角記号が使用できます。

ツリーSIDが指定した正規表現と一致（部分一致）するIM管理ノードにだけ，提案情報が表示されます。データ型はstringです。このメンバーは省略できません。

"permissions":[["提案情報を表示するJP1ユーザー権限"]]

提案情報を表示するJP1ユーザー権限を二重配列で指定します。

内側の[]に指定した条件群はAND条件となり，外側の[]に指定した条件群はOR条件となります。内側の[]と外側の[]を合わせて，1〜100件のJP1権限を指定できます。データ型はstring[][]です。

このメンバーは省略できます。省略した場合は，［統合オペレーション・ビューアー］画面のIM管理ノードの表示条件に従います。

"cases":[["提案活性条件"]]

提案活性条件の情報を二重配列で指定します。

内側の[]に指定した条件群はAND条件となり，外側の[]に指定した条件群はOR条件となります。内側の[]と外側の[]で合わせて，1〜100件の提案活性条件を指定できます。データ型はobject[][]です。

このメンバーは省略できます。省略した場合は，常に条件が成立したと仮定されます。

"action":"対処アクション情報"

対処アクションの情報を指定します。データ型はobjectです。このメンバーは省略できません。

提案活性条件と対処アクションの定義には変数が使用できます。変数の使用については，「(3) 変数」を参照してください。

(1) 提案活性条件

提案活性条件には，提案機能が対処アクションを提案する条件を指定します。指定する条件は「条件のキー」，「比較キーワード」，「比較値」です。「条件のキー」に指定された対象と「比較値」に指定された値を，「比較キーワード」に指定された比較方法で評価して，条件が成立しているかを判定します。

提案活性条件は提案定義ファイルのcasesパラメーターの要素として指定します。二重配列の内側の配列はAND条件，外側の配列はOR条件です。一つのAND条件の配列を提案活性条件群と呼びます。提案活性条件群の例を次に示します。

cases:[
    [提案活性条件1,提案活性条件2],   ← 提案活性条件群a
    [提案活性条件3,提案活性条件4]    ← 提案活性条件群b
]

この例の場合，提案活性条件1と提案活性条件2はAND条件，提案活性条件群aと提案活性条件群bはOR条件となります。

提案活性条件の判定は，casesメンバーに指定された順番で実行されます。上記の例では，提案活性条件1，提案活性条件2，提案活性条件3，提案活性条件4の順番で判定されます。

ただし，提案活性条件群の不成立，または提案活性条件全体の成立が判定された際は，判定がスキップされる場合があります。

例えば，提案活性条件群内で不一致の提案活性条件が存在する場合は，AND条件によって提案活性条件群は不成立と判定されるため，未判定の提案活性条件が存在していても判定はスキップされます。成立の提案活性条件群が存在する場合は，OR条件によって提案活性条件全体は成立と判定されるため，未判定の提案活性条件群が存在していても判定はスキップされます。

スキップされる例を次に示します。

cases:[
    [提案活性条件1(不一致),  提案活性条件2(スキップ)], ← 提案活性条件群a
    [提案活性条件3(一致),   提案活性条件4(一致)],     ← 提案活性条件群b
    [提案活性条件5(スキップ),提案活性条件6(スキップ)]  ← 提案活性条件群c
]

この例の場合，提案活性条件1が不一致と判定されると，提案活性条件群aは不成立となり，提案活性条件2の判定はスキップされます。提案活性条件3と4が一致と判定されると，提案活性条件群bが成立となります。その結果，提案活性条件の全体が成立となり，提案活性条件5と6の判定はスキップされます。

また，条件の情報の取得に失敗した，変数の変換に失敗したなどによって，提案活性条件がエラーと判定された場合は，該当する提案定義の提案活性条件全体がエラーと判定され，以降の判定はすべてスキップされます。

すべてスキップされる例を次に示します。

cases:[
    [<提案活性条件1(一致)>,  <提案活性条件2(エラー)>],
    [<提案活性条件3(スキップ)>,    <提案活性条件4(スキップ)>],
    [<提案活性条件5(スキップ)>,<提案活性条件6(スキップ)>]
]

提案活性条件2がエラーと判定された場合，提案活性条件の全体がエラーと判定され，提案活性条件3〜6の判定がスキップされます。

casesメンバーは内側の[]がAND条件で，外側の[]がOR条件のため，OR条件群をAND条件でつなげる指定はできません。次のように書き換えると，同じ意味を持つ指定ができます。

（書き換え前）

(条件A OR 条件B) AND (条件C OR 条件D)

（書き換え後）

(条件A AND 条件C) OR (条件A AND 条件D) OR (条件B AND 条件C) OR (条件B AND 条件D)

同じ条件を二つ指定することになりますが，2回目の判定には1回目の判定時に取得したJP1/IMや連携製品などから取得した提案活性条件を判定するための情報（条件情報）が使用されるため，判定時間は掛かりません。

AND条件とOR条件を複雑につなげたい場合，この指定方法以外にも，プラグイン関数，またはバッチ・シェルスクリプトを使用し，それらのプログラム内で条件を判定することもできます。

メモ

提案が成立した際に，各提案活性条件の判定時に取得した条件情報（例：コマンドの標準出力，REST APIのステータスコード）を確認したい場合は，対処アクションのdescriptionメンバーに提案活性条件の実行結果の変数を指定してください。変数の詳細については「(3) 変数」を参照してください。

提案活性条件の形式

{
    "type":"条件種別",
    "key":"条件のキー",
    "ope":"比較キーワード",
    "val":"比較値",
    "cache":"条件情報キャッシュの使用可否",
    "description":"条件の説明"
}

提案活性条件の記述内容

"type":"条件種別"

提案活性条件の種別を指定します。指定できる値については，次の表を参照してくだい。データ型はstringです。このメンバーは省略できません。

表2‒6　 typeに指定できるメンバー

項番

値

説明

1

event

JP1イベントの条件を定義する場合に指定します。

2

eventCount

JP1イベントの件数の条件を定義する場合に指定します。

3

trendCount

時系列データの個数の条件を定義する場合に指定します。

4

restApi

REST APIの実行結果の定義を指定する場合に指定します。

5

plugin

製品プラグインの実行結果の条件を定義する場合に指定します。

6

cmd※

コマンドの実行結果の条件を定義する場合に指定します。実行できるコマンド，実行先ホスト，ログインユーザーなどについては「4.5.10　jp1Imdd.execCmd」を参照してください。

7

struct

IM管理ノードの条件を指定する定義に指定します。

注※

この値は，コマンドの実行先ホストのJP1/Baseのバージョンが12-10以降の場合に，指定できます。12-10未満のバージョンの場合はコマンドの実行に失敗し，戻り値に0，標準出力および標準エラー出力は空で返却されます。

"key":"条件のキー"

提案活性条件の対象を指定します。指定できる値は，typeメンバーに指定した値によって異なります。データ型はobjectです。このメンバーは省略できません。

"ope":"比較キーワード"

比較キーワードを指定します。指定できる値は，typeメンバーに指定した値によって異なります。データ型はstringです。このメンバーは省略できません。

"val":"比較値"

比較値を指定します。指定できる値は，typeメンバーに指定した値によって異なります。データ型はopeメンバーに依存します。このメンバーは省略できません。

"cache":"条件情報キャッシュの使用可否"

提案活性条件の判定に，条件情報のキャッシュを使用するかどうかを指定します。

キャッシュを使用する場合

キャッシュの有効期限内に，keyが同じ提案活性条件で提案活性条件を判定する場合は，条件情報を取得せずにキャッシュの情報を使用します。キャッシュの有効期限は10分です。

キャッシュを使用しない場合

常に条件情報を取得し提案活性条件を判定します。

「true」または「false」のどちらかを指定します。キャッシュを使用する場合は「true」，キャッシュを使用しない場合は「false」です。

typeメンバーにstructが指定されている場合，このメンバーは指定できません。指定した場合は無視されます。「true」を指定した場合，対処アクション提案APIで条件情報を取得したタイミングで，キャッシュを作成，更新します。

データ型はbooleanです。このメンバーは省略できます。省略した場合は「false」を仮定して動作します。

"description":"条件の説明"

［統合オペレーション・ビューアー］画面の［提案］タブ−［提案詳細］領域に表示される提案活性条件の説明を，制御文字を含まない1文字以上512文字以下の文字列で指定します。データ型はstringです。このメンバーは省略できません。

(A) key，ope，valの各メンバーが指定できる値

提案活性条件のtype（条件種別）によってkey，ope，valの各メンバーに指定できる値は異なります。各メンバーが指定できる値について説明します。なお，cacheメンバー，descriptionメンバーは，どのtypeの場合でも指定できます。

(a) typeに「event」を指定した場合の提案活性条件

type（条件種別）にeventを指定した場合は，特定の条件に合致するJP1イベントが存在するかどうかを，提案活性条件に指定できます。

形式

{
    "type":"event",
    "key":{
        "sid":"イベントが紐付くノードのツリーSID",
        "statusFilter":ノードのステータス,
        "属性名":"属性の値",
        "REGEX_属性名":"属性の値"
    },
    "ope":"比較キーワード",
    "val":"比較値",
    "cache":"条件情報キャッシュの使用可否",
    "description":"条件の説明"
}

記述内容

"key"

提案活性条件の対象となるJP1イベントの情報を指定するオブジェクトです。

データ型はobjectです。このメンバーは省略できません。

"sid":"イベントが紐付くノードのツリーSID"

イベントが紐付くノードのツリーSIDを指定します。指定できる文字はツリーSIDの仕様に準じます。データ型はstringです。このメンバーは省略できます。省略した場合は，選択中のノードを指定したと仮定されます。

"statusFilter":ノードのステータス

ノードのステータスに該当するイベントだけを絞り込む場合に，ノードのステータスを配列で指定します。次の値を指定できます。

10：緑

対処済みのイベント，解除または削除した重要イベント，重要イベントではないイベントを対象として絞り込みます。

20：黄

重大度が「警告」「デバッグ」「情報」で，かつ対処状況が「未対処」「処理中」「保留」の重要イベントを対象として絞り込みます。

30：橙

重大度が「エラー」で，かつ対処状況が「未対処」「処理中」「保留」の重要イベントを対象として絞り込みます。

40：赤

重大度が「緊急」「警戒」「致命的」で，かつ対処状況が「未対処」「処理中」「保留」の重要イベントを対象として絞り込みます。

複数の値を指定した場合は，OR条件でイベントを検索します。

重要イベント定義，重要イベント解除・削除機能で重要イベントに該当するイベントを変更した場合，提案活性条件の判定の際に変更後の状態に応じてイベントを絞り込みます。

データ型はnumber[]です。このメンバーは省略できますが，イベント検索性能を向上させるため，指定することを推奨します。

"属性名":"属性の値"

イベントの属性名の属性の値を指定します。メンバーとして使用できる属性名はイベント検索条件オブジェクトのkeyに指定できる値と同じです。各属性名で指定できる値は検索条件オブジェクトのvalに指定できる値と同じです。値は1件4,096バイトまで，提案活性条件1件当たり4,096バイト（1つの提案活性条件の<属性名>，<REG_属性名>に指定した値の合計サイズ）まで指定できます。条件情報オブジェクトの詳細は「7.2.1 (3) イベント検索条件オブジェクト」を参照してください。ただし，各属性の値に半角スペースを指定した場合は「%20」を指定したものとみなされます。

値が完全一致するイベントを検索します。値が配列の場合は，値のどれかが完全一致するイベントを検索します。

属性名「B.TIME」（登録時刻）と属性名「B.ARRIVEDTIME」（到着時刻）のメンバーをどちらも指定しなかった場合は，属性名「B.TIME」の値として，次を指定したと仮定されます。

["現在時刻の一日前","現在時刻"]

属性名「E.START_TIME」（開始時刻）と属性名「E.END_TIME」（終了時刻）に，次の値が格納されている場合は，どのような日時を指定しても一致しないものと判断されます。

数値以外の値

0未満の数値

4,102,444,800以上の数値

データ型は属性名に依存します。このメンバーは省略できます。

"REGEX_属性名":"属性の値"

イベントの属性名の属性の値を指定します。メンバーとして使用できる属性名はイベント検索条件オブジェクトのkeyに指定できる値のうち，指定できる比較キーワードに「正規表現」が含まれる属性の属性名です。各属性名で指定できる値は検索条件オブジェクトのvalに指定できる値と同じです。値は1件4,096バイトまで，提案活性条件1 件あたり4,096バイト（1つの提案活性条件の<属性名>，<REG_属性名>に指定した値の合計サイズ）まで指定できます。条件情報オブジェクトの詳細は「7.2.1 (3) イベント検索条件オブジェクト」を参照してください。

ただし，各属性の値に半角スペースを指定した場合は「%20」を指定したものとみなされます。

指定した正規表現の値と部分一致するイベントを検索します。

データ型はstringです。このメンバーは省略できます。

"ope":"比較キーワード"

比較キーワードを指定します。次の値を指定できます。

EXIST：keyに指定した条件をすべて満たすJP1イベントが存在するかどうか

データ型はstringです。このメンバーは省略できません。

"val":"比較値"

keyに指定した条件をすべて満たすJP1イベントが存在するかどうかを指定します。

「true」または「false」のどちらかを指定します。JP1イベントが存在する場合は「true」，JP1イベントが存在しない場合は「false」です。

データ型はbooleanです。このメンバーは省略できません。

cacheメンバー，descriptionメンバーついては，「(1)　提案活性条件」の各メンバーの説明を参照してください。

指定例

次の条件に一致するJP1イベントが発行されているかを判定する場合の例です。

選択中のIM管理ノードに紐付いている

ステータスが「黄色（警告）」以上に該当するイベント

イベントの登録日時が現在時刻から過去60分の間

イベントIDはJP1/PFMのヘルスチェックイベントのID「00004860」

イベントのメッセージに，ヘルスチェック状態がホスト停止であることが含まれている

イベントの対処状況が「未対処」（処理状況が「処理中」「保留」ではない）

{
    "type":"event",
    "key":{
        "statusFilter":[20,30,40],
        "B.TIME":["${:time:-60.m.:}","${:time::}"],
        "B.ID":["00004860"],
        "REGEX_B.MESSAGE":"KAVL15022-E.*hcsstatus=Host Not Available",
        "E.@JP1IM_DEALT":[0]
    },
    "ope":"EXIST",
    "val":true,
    "description":"ホスト停止のJP1イベントが発行されている"
}

(b) typeに「eventCount」を指定した場合の提案活性条件

type（条件種別）にeventCountを指定した場合は，特定の条件に合致するJP1イベントの件数を，提案活性条件に指定できます。

形式

{
    "type":"eventCount",
    "key":{
        "sid":"イベントが紐付くノードのツリーSID",
        "statusFilter":ノードのステータス,
        "属性名":"属性の値",
        "REGEX_属性名":"属性の値"
    },
    "ope":"比較キーワード",
    "val":比較値,
    "cache":"条件情報キャッシュの使用可否",
    "description":"条件の説明"
}

記述内容

"key"

提案活性条件の対象となるJP1イベントの情報を指定するオブジェクトです。データ型はobjectです。このメンバーは省略できません。

"sid":"イベントが紐付くノードのツリーSID"

提案活性条件の対象となるJP1イベントの情報を指定するオブジェクトです。データ型はstringです。このメンバーは省略できます。省略した場合は，選択中のノードを指定したと仮定されます。

"statusFilter":ノードのステータス

ノードのステータスに該当するイベントだけを絞り込む場合に，ノードのステータスを配列で指定します。次の値を指定できます。

10：緑

対処済みのイベント，解除または削除した重要イベント，重要イベントではないイベントを対象として絞り込みます。

20：黄

重大度が「警告」「デバッグ」「情報」で，かつ対処状況が「未対処」「処理中」「保留」の重要イベントを対象として絞り込みます。

30：橙

重大度が「エラー」で，かつ対処状況が「未対処」「処理中」「保留」の重要イベントを対象として絞り込みます。

40：赤

重大度が「緊急」「警戒」「致命的」で，かつ対処状況が「未対処」「処理中」「保留」の重要イベントを対象として絞り込みます。

複数の値を指定した場合は，OR条件でイベントを検索します。

重要イベント定義，重要イベント解除・削除機能で重要イベントに該当するイベントを変更した場合，提案活性条件の判定の際に変更後の状態に応じてイベントを絞り込みます。

データ型はnumber[]です。このメンバーは省略できますが，イベント検索性能を向上させるため，指定することを推奨します。

"属性名":"属性の値"

イベントの属性名の属性の値を指定します。メンバーとして使用できる属性名はイベント検索条件オブジェクトのkeyに指定できる値と同じです。各属性名で指定できる値は検索条件オブジェクトのvalに指定できる値と同じです。値は1件4,096バイトまで，提案活性条件1件当たり4,096バイト（1つの提案活性条件の<属性名>，<REG_属性名>に指定した値の合計サイズ）まで指定できます。条件情報オブジェクトの詳細は「7.2.1 (3) イベント検索条件オブジェクト」を参照してください。ただし，各属性の値に半角スペースを指定した場合は「%20」を指定したものとみなされます。

値が完全一致するイベントを検索します。値が配列の場合は，値のどれかが完全一致するイベントを検索します。

属性名「B.TIME」（登録時刻）と属性名「B.ARRIVEDTIME」（到着時刻）のメンバーをどちらも指定しなかった場合は，属性名「B.TIME」の値として，次を指定したと仮定されます。

["現在時刻の一日前","現在時刻"]

属性名「E.START_TIME」（開始時刻）と属性名「E.END_TIME」（終了時刻）に，次の値が格納されている場合は，どのような日時を指定しても一致しないものと判断されます。

数値以外の値

0未満の数値

4,102,444,800以上の数値

データ型は属性名に依存します。このメンバーは省略できます。

"REGEX_属性名":"属性の値"

イベントの属性名の属性の値を指定します。メンバーとして使用できる属性名はイベント検索条件オブジェクトのkeyに指定できる値のうち，指定できる比較キーワードに「正規表現」が含まれる属性の属性名です。各属性名で指定できる値は検索条件オブジェクトのvalに指定できる値と同じです。値は1件4,096バイトまで，提案活性条件1 件あたり4,096バイト（1つの提案活性条件の<属性名>，<REG_属性名>に指定した値の合計サイズ）まで指定できます。条件情報オブジェクトの詳細は「7.2.1 (3) イベント検索条件オブジェクト」を参照してください。

ただし，各属性の値に半角スペースを指定した場合は「%20」を指定したものとみなされます。

指定した正規表現の値と部分一致するイベントを検索します。

データ型はstringです。このメンバーは省略できます。

"ope":"比較キーワード"

比較キーワードを指定します。次の値を指定できます。

GT：keyに指定した条件に合致するJP1イベントの件数がvalに指定した値より大きい

LT：keyに指定した条件に合致するJP1イベントの件数がvalに指定した値より小さい

データ型はstringです。このメンバーは省略できません。

"val":比較値

keyに指定した条件に合致するJP1イベントの件数を，0〜100の整数で指定します。

データ型はnumberです。このメンバーは省略できません。

cacheメンバー，descriptionメンバーについては，「(1)　提案活性条件」の各メンバーの説明を参照してください。

指定例

次の条件に一致するJP1イベントが，10件より多く発行されているかを判定する場合の例です。

選択中のIM管理ノードに紐付いている

ステータスが「黄色（警告）」以上に該当するイベント

イベントの登録日時が現在時刻から過去60分の間

イベントIDはJP1/PFMのヘルスチェックイベントのID「00004860」

イベントのメッセージに，ヘルスチェック状態がホスト停止であることが含まれている

イベントの対処状況が「未対処」（処理状況が「処理中」「保留」ではない）

{
    "type":"eventCount",
    "key":{
        "statusFilter":[20,30,40],
        "B.TIME":["${:time:-60.m.:}","${:time::}"],
        "B.ID":["00004860"],
        "REGEX_B.MESSAGE":"KAVL15022-E.*hcsstatus=Host Not Available",
        "E.@JP1IM_DEALT":[0]
    },
    "ope":"GT",
    "val":10,
    "description":"ホスト停止のJP1イベントが1時間以内に10件より多く発行されている"
}

(c) typeに「trendCount」を指定した場合の提案活性条件

type（条件種別）にtrendCountを指定した場合は，特定の条件に合致する時系列データの件数を，提案活性条件に指定できます。

形式

{
    "type":"trendCount",
    "key":{
        "sid":"ツリーSID",
        "metric":"メトリック名",
        "startTime":"開始日時",
        "endTime":"終了日時",
        "countPerInstance":インスタンス当たりのデータ数の上限,
        "instanceCount":インスタンス数の上限,
        "instance":"インスタンス名",
        "threshold":しきい値,
        "thresholdType":"しきい値タイプ"
    },
    "ope":"比較キーワード",
    "val":比較値,
    "cache":"条件情報キャッシュの使用可否",
    "description":"条件の説明"
}

記述内容

"key"

提案活性条件の対象となる時系列データの情報を指定するオブジェクトです。

データ型はobjectです。このメンバーは省略できません。

"sid":"ツリーSID"

時系列データのツリーSIDを指定します。指定できる文字はツリーSIDの仕様に準じます。

指定したツリーSIDに複数の構成情報のSIDが紐付いている場合は，一つの構成情報のSIDの時系列データを取得します。

取得に成功した場合は，その時系列データで条件を判定します。取得に失敗した場合は，次の時系列データを取得します。

すべての構成情報のSIDで時系列データの取得に失敗した場合は，条件情報の取得に失敗します。時系列データを取得する順番は，不定です。

データ型はstringです。このメンバーは省略できます。省略した場合は，選択中のノードを指定したと仮定されます。

"metric":"時系列データのメトリック"

時系列データのメトリックを指定します。255文字以内の半角英数字と記号-（ハイフン），_（アンダースコア）で指定します。データ型はstringです。このメンバーは省略できません。

"startTime":"時系列データの開始日時"

時系列データの開始日時をISO 8601形式のUTC時刻で指定します。小数点以下の秒数は指定しません。データ型はstringです。このメンバーは省略できません。

"endTime":"時系列データの終了日時"

時系列データの終了日時をISO 8601形式のUTC時刻で指定します。小数点以下の秒数は指定しません。データ型はstringです。このメンバーは省略できません。

"countPerInstance":1インスタンス当たりのデータ数の上限

取得する1インスタンス当たりのデータ数の上限を指定します。指定できるのは，1〜30,000の整数です。countPerInstanceとinstanceCountを掛けた数が30,000以下になるように指定します。データ型はnumberです。このメンバーは省略できます。省略した場合は，60を仮定して動作します。

"instanceCount":インスタンス数の上限

インスタンス数の上限を指定します。指定できるのは，1〜30,000の整数です。countPerInstanceとinstanceCountを掛けた数が30,000以下になるように指定します。データ型はnumberです。このメンバーは省略できます。省略した場合は，10を仮定して動作します。

"instance":"インスタンス名"

時系列データに複数インスタンスが存在する場合に，提案活性条件の対象とするインスタンスのインスタンス名を指定します。データ型はstringです。このメンバーは省略できます。省略した場合は最初のインスタンスを提案活性条件の対象とします。

指定できるのは，制御文字を含まない255文字以内の文字列です。

"threshold":しきい値

対象とする時系列データのしきい値を指定します。データ型はnumberです。このメンバーは省略できません。

"thresholdType":"しきい値タイプ"

対象とする時系列データの範囲を指定します。次の値を指定できます。

<：thresholdに指定した値未満を対象範囲とする

<=：thresholdに指定した値以下を対象範囲とする

>：thresholdに指定した値より大きい値を対象範囲とする

>=：thresholdに指定した値以上の値を対象範囲とする

データ型はstringです。このメンバーは省略できません。

"ope":"比較キーワード"

比較キーワードを指定します。次の値を指定できます。

GT：keyに指定した条件に合致する時系列データの個数がvalに指定した値より大きい

LT：keyに指定した条件に合致する時系列データの個数がvalに指定した値より小さい

データ型はstringです。このメンバーは省略できません。

"val":比較値

keyに指定した条件に合致する時系列データの個数を指定します。指定できるのは，0〜30,000の整数です。データ型はnumberです。このメンバーは省略できません。

cacheメンバー，descriptionメンバーについては，「(1)　提案活性条件」の各メンバーの説明を参照してください。

指定例

次の条件に一致する時系列データが1個以上存在するかを判定する場合の例です。

対象ノード：選択中のノード

メトリック：CPU使用率

開始日時：1時間前

終了日時：現在時刻

１インスタンス当たりのデータ数の上限：60

インスタンス数の上限：10

しきい値：80

しきい値タイプ：しきい値より大きい

{
    "type":"trendCount",
    "key":{
        "sid":"${.:tree:sid:}",
        "metric":"cpu_used_rate",
        "startTime":"${:time:-60.m.:}",
        "endTime":"${:time::}",
        "countPerInstance":60,
        "instanceCount":10,
        "threshold":80,
        "thresholdType":">"
    },
    "ope":"GT",
    "val":0,
    "description":"過去1時間のCPU使用率の時系列データで80%を超える時系列データが1個以上存在する"
}

(d) typeに「restApi」を指定した場合の提案活性条件

type（条件種別）にrestApiを指定した場合は，REST APIの実行結果（ステータスコード，レスポンスヘッダー，レスポンスボディー）を提案活性条件に指定できます。

形式

{
    "type":"restApi",
    "key":{
        "method":"REST APIのメソッド",
        "url":"REST APIのURL",
        "headers":"REST APIのリクエストヘッダー",
        "body":"REST APIのリクエストのボディー",
        "param":"REST APIのレスポンスで比較対象となるパラメーター"
    },
    "ope":"比較キーワード",
    "val":"比較値",
    "cache":"条件情報キャッシュの使用可否",
    "description":"条件の説明"
}

記述内容

"key"

提案活性条件の対象となるREAT APIの情報を指定するオブジェクトです。

データ型はobjectです。このメンバーは省略できません。

"method":"REST APIのメソッド"

REST APIのメソッドを指定します。次の値を指定できます。

GET

HEAD

POST

PUT

PATCH

DELETE

OPTIONS

TRACE

データ型はstringです。このメンバーは省略できません。

"url":"REST APIのURL"

REST APIのURLを指定します。指定できる文字は，半角英数字およびRFC 2396の仕様に準拠した次の記号です。

「;」，「/」，「?」，「:」，「@」，「&」，「=」，「+」，「$」，「,」，「-」，「_」，「.」，「!」，「~」，「*」，「'」，「(」，「)」，「%」

先頭には「http://」または「https://」を指定します。

データ型はstringです。このメンバーは省略できません。

ホスト名を含むURLを指定する場合，ホスト名はhostsファイルやDNSに登録し，JP1/IM - ManagerホストのOS上で名前解決できるようにしてください。jp1hostsファイルおよびjp1hosts2ファイルの設定は参照されません。

"headers":"REST APIのリクエストヘッダー"

REST APIのリクエストヘッダーです。データ型はobjectです。このメンバーは省略できません。

"body":"REST APIのリクエストボディー"

REST APIのリクエストボディーです。データ型はobjectです。メソッドがGET，またはDELETEの場合でボディーが不要のときは，省略します。このメンバーは省略できます。

"param":"REST APIのレスポンスで比較対象となるパラメーター"

REST APIのレスポンスで比較対象となるパラメーターを指定します。次の値を指定できます。

status：ステータスコード

headers：レスポンスヘッダー

body：レスポンスボディー

データ型はstringです。このメンバーは省略できません。

"ope":"比較キーワード"

比較キーワードを指定します。次の値を指定できます。

IN：keyで指定したREST APIのレスポンスがvalで指定した値と一致する

NOTIN：keyで指定したREST APIのレスポンスがvalで指定した値と一致しない

GT：keyに指定したREST APIのレスポンスがvalに指定した値より大きい

LT：keyに指定したREST APIのレスポンスがvalに指定した値より小さい

REGEX：keyで指定したREST APIのレスポンスがvalに指定した値と正規表現で一致（部分一致）する

データ型はstringです。このメンバーは省略できません。

"val":"比較値"

REST APIの実行結果と比較する値を指定します。指定する値はparamの値によって異なります。詳細は，次の表を参照してください。型がstringの場合は，サイズが1メガバイト未満の文字列を指定してください。このメンバーは省略できません。

表2‒7　restApiで指定できるparam，ope，valの型の組み合わせ

項番

paramの値

opeに指定できる値

valの型

valに指定する値

1

status

IN

NOTIN

GT

LT

number

REST APIのステータスコードと比較する値

2

headers

IN

NOTIN

REGEX

string

REST APIのレスポンスヘッダーと比較する値

3

body

IN

NOTIN

REGEX

string

REST APIのレスポンスボディー比較する値

REST APIのレスポンスヘッダーの文字列の形式

paramにheadersを指定した場合，取得したレスポンスヘッダーは，次の形式の文字列となります。

<フィールド名1>:<フィールド値1-1>,<フィールド値1-2>,…,<フィールド値1-n><CRLF>
<フィールド名2>:<フィールド値2-1>,<フィールド値2-2>,…,<フィールド値2-n><CRLF>
<フィールド名3>:<フィールド値3-1>,<フィールド値3-2>,…,<フィールド値3-n><CRLF>
…

注　フィールド名はすべて大文字に変換されます。フィールドの並び順は，フィールド名のASCIIコードの昇順です。

指定例を次に示します。

CACHE-CONTROL:no-store,no-cache,max-age=0<CRLF>
CONTENT-TYPE:application/json<CRLF>
EXPIRES:Thu,01 Jan 1970 00:00:00 GMT<CRLF>
PRAGMA:no-cache<CRLF>

cacheメンバー，descriptionメンバーについては，「(1)　提案活性条件」の各メンバーの説明を参照してください。

指定例

次に示すREST APIのステータスコードが，200かどうかを判定する場合の例です。

メソッド：POST

URL：https://test

リクエストヘッダー

認証情報：yyyy/zzzz

リクエストボディーのメディアタイプ：application/json

リクエストボディー

リクエストボディーのパラメーター「body1」：test1

リクエストボディーのパラメーター「body2」：test2

REST APIのレスポンスで比較対象となるパラメーター：ステータスコード

{
    "type":"restApi",
    "key":{
        "method":"POST",
        "url":"https://test",
        "headers":{
            "Authorization":"yyyy/zzzz",
            "Content-Type":"application/json"
        },
        "body":{
            "body1":"test1",
            "body2":"test2"
        },
        "param":"status"
    },
    "ope":"IN",
    "val":200,
    "description":"REST API testのステータスコードが200"
}

(e) typeに「plugin」を指定した場合の提案活性条件

type（条件種別）にpluginを指定した場合は，プラグイン関数の実行結果を提案活性条件に指定できます。

形式

{
    "type":"plugin",
    "key":{
        "sid":"ツリーSID",
        "method":"プラグイン関数名",
        "args":"プラグイン関数の引数"
    },
    "ope":"比較キーワード",
    "val":"比較値",
    "cache":"条件情報キャッシュの使用可否",
    "description":"条件の説明"
}

記述内容

"key"

提案活性条件の対象となるプラグイン関数の情報を指定するオブジェクトです。データ型はobjectです。このメンバーは省略できません。

"sid":"ツリーSID"

ツリーSIDを指定します。指定できる文字はツリーSIDの仕様に準じます。指定したツリーSIDに紐付いている構成情報のSIDを指定してプラグイン関数を実行します。指定したツリーSIDに複数の構成情報のSIDが紐付いている場合は，一つの構成情報のSIDを指定してプラグイン関数を実行し，実行に成功した場合は，そのプラグイン関数のレスポンスで条件を判定します。それ以降の構成情報のSIDは無視します。

構成情報のSIDを指定する順番は，不定です。

プラグイン内でargs.setErrorメソッドが実行された場合，またはレスポンスのメンバーにsuggestionが存在しない場合は，プラグイン関数の実行に失敗したと判断され，次の構成情報のSIDでプラグイン関数を実行します。

すべての構成情報のSIDでプラグイン関数の実行に失敗した場合は，条件情報の取得に失敗します。データ型はstringです。このメンバーは省略できます。省略した場合は，選択中のノードを指定したと仮定されます。

"method":"プラグイン関数名"

プラグイン関数名を指定します。プラグイン関数を追加したあとに，JP1/IM3-Managerサービスが再起動されているか確認してください。指定するプラグイン関数は，次の条件をすべて満たす必要があります。

module.exportsでモジュール化されている。

引数はobject型の「args」だけである。

returnではなく，args.setResult(Object result)メソッドでレスポンスを返却する。

「result」にはレスポンスを指定します。

例外ではなくargs.setError(String message)メソッドによって，エラー通知する。

「message」にはエラーメッセージを指定します。

レスポンスのメンバーに，suggestion（データ型：string）が存在する。

データ型はstringです。このメンバーは省略できません。

プラグイン関数の詳細については「4.　ユーザー作成プラグイン」を参照してください。

"args":"プラグイン関数の引数"

実行するプラグイン関数の引数を指定します。渡す情報が存在しない場合は，空オブジェクトを指定します。指定したオブジェクトは，実行するプラグイン関数の引数args.methodArgsに渡されます。そのほかのプラグイン関数のargsに渡される値については，「5.7.1　プラグイン処理実行」を参照してください。

データ型はobjectです。このメンバーは省略できません。

"ope":"比較キーワード"

比較キーワードを指定します。次の値を指定できます。

IN：keyで指定したプラグイン関数のレスポンスのsuggestionの値がvalで指定した値と一致する。

NOTIN：keyで指定したプラグイン関数のレスポンスのsuggestionの値がvalで指定した値と一致しない。

REGEX：keyで指定したプラグイン関数のレスポンスのsuggestionの値がvalに指定した値と正規表現で一致（部分一致）する。

データ型はstringです。このメンバーは省略できません。

"val":"比較値"

プラグイン関数のレスポンスのsuggestionの値と比較する値を指定します。サイズが1メガバイト未満の文字列を指定してください。データ型はstringです。このメンバーは省略できません。

cacheメンバー，descriptionメンバーについては，「(1)　提案活性条件」の各メンバーの説明を参照してください。

指定例

次に示すプラグイン関数のメンバーsuggestionの値が，OK以外かどうかを判定する場合の例です。

対象のIM管理ノード：選択中のIM管理ノード

プラグイン関数：jp1pfmSuggestionCreateReportURL

JP1/PFMのレポートのURLを作成する関数です。jp1pfmSuggestionCreateReportURL関数の詳細については，マニュアル「JP1/Performance Management リファレンス」を参照してください。

引数：レポートのID

{
    "type":"plugin",
    "key":{
        "sid":"${.:tree:sid:}",
        "method":"jp1pfmSuggestionCreateReportURL",
        "args":{
            "reportId":"ac102ce0:3b9952:ec20ca1bfc:-7b99"
         }
    },
    "ope":"NOTIN",
    "val":"",
    "description":"レポートURL生成が成功"
}

(f) typeに「cmd」を指定した場合の提案活性条件

type（条件種別）にcmdを指定した場合は，コマンドの実行結果（戻り値，標準出力，標準エラー出力）を提案活性条件に指定できます。

形式

{
    "type":"cmd",
    "key":{
        "host":"コマンドの実行先ホスト名",
        "cmd":"実行コマンド",
        "env":"環境変数",
        "envFile":"環境変数ファイル名",
        "param":"コマンドの実行結果の種別"
    },
    "ope":"比較キーワード",
    "val":"比較値",
    "cache":"条件情報キャッシュの使用可否",
    "description":"条件の説明"
}

記述内容

"key"

提案活性条件の対象となるコマンドの情報を指定するオブジェクトです。データ型はobjectです。このメンバーは省略できません。

host:"コマンドの実行先ホスト名"

コマンドの実行先ホスト名を指定します。指定できる範囲は，1〜254バイトです。データ型はstringです。このメンバーは省略できません。

"cmd":"実行コマンド"

実行コマンドと引数を指定します。指定できる範囲は，1〜4,095バイトです。

コマンド名に空白を含む場合は"（ダブルクォーテーション）で囲みます。データ型はstringです。このメンバーは省略できません。

"env":"環境変数"

実行先ホストでコマンドを実行する際の環境変数をオブジェクトのキーに，環境変数の値をオブジェクトの値に指定します。

最大30個まで指定できます。オブジェクトのキーと値は，全体で1〜7,107バイトの範囲で指定します。データ型はobjectです。このメンバーは省略できます。

"envFile":"環境変数ファイル名"

実行先ホストのファイル名を，絶対パス形式で指定します。指定できる範囲は，1〜255バイトです。データ型はstringです。このメンバーは省略できます。

"param":"比較値"

比較対象を指定します。次の値を指定できます。

rc：戻り値

stdout：標準出力

stderr：標準エラー出力

データ型はstringです。このメンバーは省略できません。

"ope":"比較キーワード"

比較キーワードを指定します。次の値を指定できます。

IN：keyで指定したコマンドのparamの値とvalで指定した値と一致する

NOTIN：keyで指定したコマンドのparamの値とvalで指定した値が一致しない

REGEX：keyで指定したコマンドのparamの値がvalに指定した値と正規表現で一致（部分一致）する

GT：keyに指定したコマンドのparamの値がvalに指定した値より大きい

LT：keyに指定したコマンドのparamの値がvalに指定した値より小さい

指定できるparamとopeの組み合わせは，表2-8を参照してください。

データ型はstringです。このメンバーは省略できません。

"val":"比較値"

コマンドの実行結果と比較する値を指定します。指定する値は，paramに指定した値によって異なります。詳細は，次の表を参照してください。なお，型がstringの場合は，サイズが1メガバイト未満の文字列を指定してください。このメンバーは省略できません。

表2‒8　cmdで指定できるparam，ope，valの型の組み合わせ

項番

paramの値

opeに指定できる値

valの型

valに指定する値

1

rc

IN

NOTIN

GT

LT

number

コマンドの戻り値と比較する値

2

stdout

IN

NOTIN

REGEX

string

コマンドの標準出力と比較する値

3

stderr

IN

NOTIN

REGEX

string

コマンドの標準エラー出力と比較する値

typeが「cmd」の提案活性条件に指定した変数は，変数を変換したあとに次の文字変換が実行されます。

次の制御文字が提案活性条件に指定した変数に含まれていた場合，半角スペース（0x20）に変換します。

・0x01から0x1F（タブ（0x09）を除く）

・0x7F

文字変換は，イベント引き継ぎ情報変換設定ファイルに従って実行されます。詳細は，「イベント引き継ぎ情報変換設定ファイル（event_info_replace.conf）」（2.　定義ファイル）を参照してください。

cacheメンバー，descriptionメンバーについては，「(1)　提案活性条件」の各メンバーの説明を参照してください。

指定例

次の条件のコマンドの標準出力に「DISPLAY_NAME: JP1/AJSサービス」が含まれるかどうか（JP1/AJSサービスが起動中か）を判定する場合の例です。

コマンドの実行先ホスト名：選択中のIM管理ノード※のノード名称

注※　JP1/AJSマネージャーのホストのノード

実行コマンド：sc query

環境変数ファイル名：対象ホストのC:¥envFile.txt

コマンドの実行結果の種別：標準出力

{
    "type":"cmd",
    "key":{
        "host":"${.:tree:value.label:}",
        "cmd":"sc query",
        "envFile":"C:¥¥envFile.txt",
        "param":"stdout"
    },
    "ope":"REGEX",
    "val":"DISPLAY_NAME: JP1/AJS3",
    "description":"JP1/AJSサービスが起動中"
}

(g) typeに「struct」を指定した場合の提案活性条件

type（条件種別）にstructを指定した場合は，特定のIM管理ノードの構成が存在するかどうかを，提案活性条件に指定できます。

形式

{
    "type":"struct",
    "key":{
        "idType":"ノードの形式",
        "sid":"構成情報のSIDまたはツリーSID"
    },
    "ope":"比較キーワード",
    "val":"比較値",
    "description":"条件の説明"
}

記述内容

"key"

提案活性条件の対象となるIM管理ノードの情報を指定するオブジェクトです。データ型はobjectです。このメンバーは省略できません。

"idType":"ノードの形式"

対象となるノードのid種別を指定します。次の値を指定できます。

target：構成情報のSID

tree：ツリーSID

データ型はstringです。このメンバーは省略できません。

"sid":"構成情報のSIDまたはツリーSID"

構成情報のSIDまたはツリーのSIDを指定します。指定できる文字は，SIDの仕様に従います。

sidメンバーに指定した変数の変換に失敗した場合に，その原因が次のどちらかのときは，判定失敗ではなくSIDは存在しないものとみなし処理を続行します。

対象ノードが存在しない

対象種別にtargetまたはtarget[製品名]を指定し，該当する構成情報のSIDが存在しない

データ型はstringです。このメンバーは省略できません。

"ope":"比較キーワード"

比較キーワードを指定します。次の値を指定できます。

EXIST：keyで指定した条件のIM管理ノードが存在するかどうか

データ型はstringです。このメンバーは省略できません。

"val":"比較値"

keyで指定した条件のIM管理ノードが存在するかどうかを指定します。

「true」または「false」のどちらかを指定します。IM管理ノードが存在する場合は「true」，IM管理ノードが存在しない場合は「false」です。

データ型はbooleanです。このメンバーは省略できません。

descriptionメンバーについては，「(1)　提案活性条件」の説明を参照してください。

指定例

選択中のJP1/PFM - AgentのIM管理ノードと同じホストのJP1/AJS - AgentのIM管理ノードが，存在するかどうかを判定する場合の例です。

ID種別：ツリーSID

SID：次の条件を満たすSID

選択中のJP1/PFM - AgentのツリーSIDと3つ上位のIM管理ノード（ホストのIM管理ノード）までツリーSIDが一致する。

ホスト以降のツリーSIDが，JP1/AJS-Agentを示す次のツリーSIDである。

_CATEGORY_managementApplications/_OBJECT_JP1AJSAGT

{
    "type":"struct",
    "key":{
        "idType":"tree",
        "sid":"${../../..:tree:sid:}/_CATEGORY_managementApplications/_OBJECT_JP1AJSAGT"
    },
    "ope":"EXIST",
    "val":true,
    "description":"選択中のJP1/PFM - AgentのIM管理ノードと同じホストに，JP1/AJS - Agentのノードが存在する"
}

(2) 対処アクション

対処アクションについて説明します。

対処アクションの形式

{
    "type":"対処アクション種別",
    "params":"対処アクションのパラメーター",
    "description":"対処アクションの説明"
}

対処アクションの記述内容

"type":"対処アクション種別"

対処アクションの種別を指定します。次の値を指定できます。

restApi：REST APIの実行を定義する場合に指定します。

plugin：製品プラグインの実行を定義する場合に指定します。

cmd：コマンドの実行を定義する場合に指定します。

eventStatus：イベントの対処状況の変更を定義する場合に指定します。

jump：特定URLまたは［繰り返しイベント一覧］画面へのジャンプを定義する場合に指定します。

データ型はstringです。このメンバーは省略できません。

なお，cmdはコマンドの実行先ホストのJP1/Baseのバージョンが12-10以降の場合に指定します。12-10未満のバージョンの場合はコマンドの実行に失敗し，戻り値に0，標準出力および標準エラー出力は空で返却されます。

"params":"対処アクションのパラメーター"

対処アクションのパラメーターを指定します。指定できるメンバーはtypeによって異なります。データ型はobjectです。このメンバーは省略できません。

"description":"対処アクションの説明"

対処アクションの説明を指定します。指定できるのは，制御文字を含まない512文字以内の文字列です。空文字は指定できません。

データ型はstringです。このメンバーは省略できません。

(A) 対処アクション種別ごとの指定できる値

対処アクションのtype（対処アクション種別）によってメンバーに指定できる値は異なります。typeごとに指定できる値について説明します。なお，descriptionメンバーは，どのtypeの場合でも指定できます。

(a) typeに「restApi」を指定した場合の対処アクション

type（対処アクション種別）にrestApiを指定した場合は，REST APIの実行を対処アクションに指定できます。

形式

{
    "type":"restApi",
    "params":{
        "method":"REST APIのメソッド",
        "url":"REST APIのURL",
        "headers":"REST APIのリクエストヘッダー",
        "body":"REST APIのリクエストのボディー"
    },
    "description":"対処アクションの説明"
}

記述内容

"params"

対処アクションの対象となるREST APIの情報を指定するオブジェクトです。データ型はobjectです。このメンバーは省略できません。

"method":"REST APIのメソッド"

REST APIのメソッドを指定します。次の値を指定できます。

GET

HEAD

POST

PUT

PATCH

DELETE

OPTIONS

TRACE

データ型はstringです。このメンバーは省略できません。

"url":"REST APIのURL"

REST APIのURLを指定します。指定できる文字は，半角英数字およびRFC 2396の仕様に準拠した次の記号です。

「;」，「/」，「?」，「:」，「@」，「&」，「=」，「+」，「$」，「,」，「-」，「_」，「.」，「!」，「~」，「*」，「'」，「(」，「)」，「%」

先頭には「http://」または「https://」を指定します。

データ型はstringです。このメンバーは省略できません。

ホスト名を含むURLを指定する場合，ホスト名はhostsファイルやDNSに登録し，JP1/IM - ManagerホストのOS上で名前解決できるようにしてください。

jp1hostsファイルおよびjp1hosts2ファイルの設定は参照されません。

"headers":"REST APIのリクエストヘッダー"

REST APIのリクエストヘッダーです。データ型はobjectです。このメンバーは省略できません。

"body":"REST APIのリクエストボディー"

REST APIのリクエストボディーです。メソッドがGET，またはDELETEの場合でボディーが不要のときは，省略します。データ型はobjectです。このメンバーは省略できます。

descriptionメンバーについては，「(2)　対処アクション」の説明を参照してください。

指定例

次のJP1イベントの情報を用いてREST APIを実行する場合の例です。

URL：https://test

リクエストヘッダー

認証情報：yyyy/zzzz

リクエストボディーのメディアタイプ：application/json

リクエストボディー

リクエストボディーのパラメーター「body1」：${:event[1]:B.ID:}

casesに指定したtypeが「event」の１番目の提案活性条件に該当するJP1イベントのイベントIDです。

リクエストボディーのパラメーター「body2」：${:event[1]:B.MESSAGE:}

casesに指定したtypeが「event」の１番目の提案活性条件に該当するJP1イベントのメッセージです。

{
    "type":"restApi",
    "params":{
        "method":"POST",
        "url":"https://test",
        "headers":{
            "Authorization":"yyyy/zzzz",
            "Content-Type": "application/json"
        },
        "body":{
            "body1":"${:event[1]:B.ID:}",
            "body2":"${:event[1]:B.MESSAGE:}"
        }
    },
    "description":"JP1イベントの情報を用いてREST API testを実行する"
}

(b) typeに「plugin」を指定した場合の対処アクション

type（対処アクション種別）にpluginを指定した場合は，プラグイン関数の実行を対処アクションに指定できます。

形式

{
    "type":"plugin",
    "params":{
        "sid":"ツリーSID",
        "method":"プラグイン関数名",
        "args":"プラグイン関数の引数"
    },
    "description":"対処アクションの説明"
}

記述内容

"params"

対処アクションの対象となるプラグイン関数の情報を指定するオブジェクトです。データ型はobjectです。このメンバーは省略できません。

"sid":"ツリーSID"

ツリーSIDを指定します。指定できる文字はツリーSIDの仕様に準じます。指定したツリーSIDに紐付いている構成情報のSIDを指定してプラグイン関数を実行します。指定したツリーSIDに複数の構成情報のSIDが紐付いている場合は，一つの構成情報のSIDを指定してプラグイン関数を実行し，実行に成功した場合は，それ以降の構成情報のSIDは無視します。構成情報のSIDを指定する順番は，不定です。

プラグイン内でargs.setErrorメソッドが実行された場合，プラグイン関数の実行に失敗したと判断され，次の構成情報のSIDでプラグイン関数を実行します。

データ型はstringです。このメンバーは省略できます。省略した場合は，選択中のノードを指定したと仮定されます。

"method":"プラグイン関数名"

プラグイン関数名を指定します。プラグイン関数を追加したあとに，JP1/IM3-Managerサービスが再起動されているか確認してください。指定するプラグイン関数は，次のすべての条件を満たす必要があります。

module.exportsでモジュール化されている。

引数はobject型の「args」だけである。

returnではなく，args.setResult(Object result)メソッドでレスポンスを返却する。

「result」にはレスポンスを指定します。

例外ではなくargs.setError(String message)メソッドによって，エラー通知する。

「message」にはエラーメッセージを指定します。

「__」（アンダースコア二つ）から始まる関数名ではない。

データ型はstringです。このメンバーは省略できません。

"args":"プラグイン関数の引数"

実行するプラグイン関数の引数を指定します。渡す情報が存在しない場合は，空オブジェクトを指定します。指定したオブジェクトは，実行するプラグイン関数の引数args.methodArgsに渡されます。そのほかのプラグイン関数のargsに渡される値については，「5.7.1　プラグイン処理実行」を参照してください。

データ型はobjectです。このメンバーは省略できません。

descriptionメンバーについては，「(2)　対処アクション」の説明を参照してください。

指定例

次の条件のプラグイン関数を実行する場合の例です。

対象のIM管理ノード：選択中のIM管理ノード

プラグイン関数：jp1pfmSuggestionSetStatusOfEventsToProcessed

JP1イベントを対処済みにする関数です。jp1pfmSuggestionSetStatusOfEventsToProcessed関数の詳細については，マニュアル「JP1/Performance Management リファレンス」を参照してください。

引数：イベントSID

casesに指定したtypeが「pugin」の，3番目の提案活性条件で実行したプラグイン関数のレスポンスsuggestionの値です。

{
    "type":"plugin",
    "params":{
        "sid":"${.:tree:sid:}",
        "method":"jp1pfmSuggestionSetStatusOfEventsToProcessed",
        "args":{
            "eventSids":"${:plugin[3]::}"
        }
    },
    "description":"現在の状態が正常なアラームまたはエージェントのイベントの対処状況を「対処済」にする"
}

JP1/PFMと連携する場合は，JP1/PFMのプラグインメソッドが利用できます。詳細については，マニュアル「JP1/Performance Management 運用ガイド」を参照してください。

(c) typeに「cmd」を指定した場合の対処アクション

type（対処アクション種別）にcmdを指定した場合は，コマンドの実行を対処アクションに指定できます。

形式

{
    "type":"cmd",
    "params":{
        "host":"コマンドの実行先ホスト",
        "cmd":"実行コマンド",
        "env":"環境変数",
        "envFile":"環境変数ファイル名"
    },
    "description":"対処アクションの説明"
}

記述内容

"params"

対処アクションの対象となるコマンドの情報を指定するオブジェクトです。データ型はobjectです。このメンバーは省略できません。

"host":"コマンドの実行先ホスト"

コマンドの実行先ホスト名を指定します。指定できる範囲は，1〜254バイトです。データ型はstringです。このメンバーは省略できません。

"cmd":"実行コマンド"

実行コマンドと引数を指定します。指定できる範囲は，1〜4,095バイトです。

コマンド名に空白を含む場合は"（ダブルクォーテーション）で囲みます。データ型はstringです。このメンバーは省略できません。

"env":"環境変数"

実行先ホストでコマンドを実行する際の環境変数をオブジェクトのキーに，環境変数の値をオブジェクトの値に指定します。

最大30個まで指定できます。オブジェクトのキーと値は，全体で1〜7,107バイトの範囲で指定します。データ型はobjectです。このメンバーは省略できます。

"envFile":"環境変数ファイル名"

実行先ホストのファイル名を，絶対パス形式で指定します。指定できる範囲は，1〜255バイトです。データ型はstringです。このメンバーは省略できます。

typeが「cmd」の対処アクションに指定した変数は，変数を変換したあとに次の文字変換が実行されます。

次の制御文字が対処アクションに指定した変数に含まれていた場合，半角スペース（0x20）に変換します。

・0x01から0x1F（タブ（0x09）を除く）

・0x7F

文字変換は，イベント引き継ぎ情報変換設定ファイルに従って実行されます。詳細は，「イベント引き継ぎ情報変換設定ファイル（event_info_replace.conf）」（2.　定義ファイル）を参照してください。

descriptionメンバーについては，「(2)　対処アクション」の説明を参照してください。

指定例

次の条件のコマンドを実行する場合の例です。

コマンドの実行先ホスト名：選択中のIM管理ノード（JP1/IMのホストのノード）のノード名称

実行コマンド："C:¥Program Files (x86)¥Hitachi¥JP1IMM¥tools¥jim_log" -f C:¥¥temp -q

JP1/IMの資料採取コマンドです。

環境変数ファイル名：対象ホストのC:¥envFile.txt

{
    "type":"cmd",
    "params":{
        "host":"${.:tree:value.label:}",
        "cmd":"¥"C:¥¥Program Files (x86)¥¥Hitachi¥¥JP1IMM¥¥tools¥¥jim_log¥" -f C:¥¥temp -q",
        "envFile":"C:¥¥envFile.txt"
    },
    "description":"JP1/IMの資料採取コマンド実行"
}

(d) typeに「eventStatus」を指定した場合の対処アクション

type（対処アクション種別）にeventStatusを指定した場合は，JP1イベントの対処状況の変更を，対処アクションに指定できます。

形式

{
    "type":"eventStatus",
    "params":{
        "dealt":対処状況,
        "sid":"JP1イベントのSID,..."
    },
    "description":"対処アクションの説明"
}

記述内容

"params"

対処アクションの対象となるイベントと対処状況を指定するオブジェクトです。データ型はobjectです。このメンバーは省略できません。

"dealt":対処状況

変更後の対処状況を指定します。指定できる値を次に示します。

0：未対処

1：対処済

2：処理中

3：保留

データ型はnumberです。このメンバーは省略できません。

"sid":"JP1イベントのSID"

対処状況を取得したいJP1イベントのSIDを指定します。

複数のJP1イベントのSIDを指定する場合は，JP1イベントのSIDを「,」で連結して指定します。指定できる文字は，SIDの仕様に従います。指定できるイベントのSIDは1〜2,000個です。データ型はstringです。このメンバーは省略できません。

descriptionメンバーについては，「(2)　対処アクション」の説明を参照してください。

指定例

次の条件のイベントの対処状況を1（対処済み）に変更する場合の例です。

イベントSID：${:event[1]:sid:},${:event[2]:sid:}

casesに指定したtypeが「event」の１番目と2番目の提案活性条件に該当するJP1イベントのイベントSIDです。

{
    "type":"eventStatus",
    "params":{
        "dealt":1,
        "sid":"${:event[1]:sid:},${:event[2]:sid:}"
    },
    "description":"イベントID：${:event[1]:B.ID:}，${:event[2]:B.ID:}を対処済みに変更する"
}

(e) typeに「jump」を指定した場合の対処アクション

type（対処アクション種別）にjumpを指定した場合は，特定のURLまたは［繰り返しイベント一覧］画面へのジャンプを，対処アクションに指定できます。

形式

{
    "type":"jump",
    "params":{
        "url":"URL",
        "target":"HTMLのターゲット属性",
        "relatedEvent":繰り返しイベント一覧画面情報
    },
    "description":"対処アクションの説明"
}

記述内容

"params"

対処アクションの対象となるジャンプ先の情報を指定するオブジェクトです。データ型はobjectです。このメンバーは省略できません。

"url":"URL"

ジャンプ先のURLを，次のどちらかの形式で指定します。

指定できる文字は，半角英数字およびRFC 2396の仕様に準拠した次の記号です。

「;」，「/」，「?」，「:」，「@」，「&」，「=」，「+」，「$」，「,」，「-」，「_」，「.」，「!」，「~」，「*」，「'」，「(」，「)」，「%」

先頭には「http://」，「https://」，「index?」のどれかを指定します。

任意のURL

任意のURLを指定します。

JP1/IMのダイレクトアクセスURL

JP1/IMのダイレクトアクセスURLを，［統合オペレーション・ビューアー］画面のindexから指定します。画面を再読み込みしないで，現在開いている画面内で指定したURLにジャンプします。ダイレクトアクセスURLの形式については，マニュアル「JP1/Integrated Management 3 - Manager 構築ガイド」の「4.12　ダイレクトアクセスURLの設定」を参照してください。

データ型はstringです。このメンバーかrelatedEventメンバーのどちらかを，必ず指定する必要があります。

"tagret":"HTMLのターゲット属性"

ジャンプ先のURLを開く際のHTMLのtarget属性を指定します。省略した場合は「_blank」を指定したと仮定します。次の値は指定できません。

_self

_parent

_top

JP1IM_から始まる値

urlメンバーが省略されている場合，またはurlメンバーの値に「index」から始まるURLを指定した場合は，targetメンバーの値は無視します。データ型はstringです。このメンバーは省略できます。

"relatedEvent":検索条件の番号

［繰り返しイベント一覧］画面を表示する場合に指定します。対象となるのはtypeがeventの提案活性条件で検索されたイベントです。casesに指定したtypeがeventの提案活性条件のうち，何番目の条件で検索されたイベントかを1〜100の数字で指定します。

該当するJP1イベントが複数存在する場合は，登録日時が最も新しいJP1イベントの［繰り返しイベント一覧］画面が表示されます。

データ型はnumberです。このメンバーかurlメンバーのどちらかを，必ず指定する必要があります。

descriptionメンバーについては，「(2)　対処アクション」の説明を参照してください。

指定例１

ターゲット名を指定して特定URLにジャンプする場合の例です。

{
    "type":"jump",
    "params":{
        "url":"https://sample/web/application",
        "target":"sampleWebApplication"
    },
    "description":"「https://sample/web/application」にジャンプする"
}

指定例2

ダイレクトアクセスURLを指定する場合の例です。

{
    "type":"jump",
    "params":{
        "url":"index?sid=${../../..:tree:sid:URLENC}%2F%5FCATEGORY%5FmanagementApplications%2F%5FOBJECT%5FJP1AJSAGT&view=tree&eou=1"
    },
    "description":"JP1/IMの画面移動(同じホストのJP1/AJS - Managerのノード)"
}

指定例３

［繰り返しイベント一覧］画面を指定する場合の例です。

{
    "type":"jump",
    "params":{
        "relatedEvent":1
    },
    "description":"繰り返しイベント一覧画面を開く"
}

(3) 変数

提案活性条件と対処アクションには，変数を指定できます。変数は，選択中のIM管理ノードの情報，現在時刻を，提案活性条件の判定時に取得した情報に置き換えることができます。変数の使用によって，動的な提案活性条件，対処アクションの定義ができます。

変数による提案活性条件の指定例

提案活性条件

提案活性条件1：イベントIDがxxxのJP1イベントが存在する

提案活性条件2：登録日時が「提案活性条件1に該当するイベントの登録日時」以降のJP1イベントが存在する

「提案活性条件1に該当するイベントの登録日時」を変数で定義します。提案活性条件に指定した変数は，提案活性条件ごとに判定時に変換されます。判定がスキップされる場合は変換されません。判定のスキップについては「(1) 提案活性条件」の説明を参照してください。

対処アクションに指定された変数は，対処アクションを提案する条件を判定したあとに変換されます。判定が成立しない場合は，変換されません。

指定例

"cases":[
  ["提案活性条件1","提案活性条件2"],
  ["提案活性条件3"]
],
"action":"対処アクション"

上記の例の場合，次に示す順序で処理が実行されます。

提案活性条件1に指定されている変数の変換

提案活性条件1の判定（成立）

提案活性条件2に指定されている変数の変換

提案活性条件2の判定（不成立）

提案活性条件3に指定されている変数の変換

提案活性条件3の判定（成立）

対処アクションに指定されている変数の変換

対処アクションの提案

変数は提案活性条件，および対処アクションのtype以外のstring型のメンバー，および配列のstring型の要素，objectのstring型のメンバー（メンバー名は除く）に指定できます。変数の形式を次に示します。

${"対象ノード":"対象種別":"対象キー":"エンコード種別"}

重要

変数の形式の「:」（コロン）は省略できません。また，対象ノードに「$」，「{」，「}」は使用できません。対象種別，対象キー，エンコード種別に「:」，「$」，「{」，「}」は使用できません。

(A) 対象ノード

情報の取得元のIM管理ノードを，ツリーSIDまたは選択中のIM管理ノードからの相対パス形式で指定します。変数の変換対象の種別によっては省略できます。詳細は「表2-10　対象種別に指定できる値」を参照してください。対象ノードが不要な対象種別に対象ノードを指定した場合は無視されます。

相対パスの形式を次の表に示します。「/」で連結して指定してください。

表2‒9　相対パスの形式

項番

相対パスの形式

対象ノードの先頭に指定した場合に表すノード

対象ノードの1番目の「/」より後ろに指定した場合に表すノード

1

.

選択中のIM管理ノード，または対処アクション提案APIのリクエストで指定したツリーSIDのノードを表す場合に指定します。

指定できません。

2

..

選択中のIM管理ノードの上位ノード，または対処アクション提案APIのリクエストで指定したツリーSIDの上位ノードを表す場合に指定します。

現在のノードの上位ノードを表す場合に指定します。

3

構造化ID

ノードを絶対パス形式で指定する場合に，絶対パスの構造化IDを指定します。

構造化IDに指定できる文字については「7.1　SID」を参照してください。

現在のノードの下位のノードを指定する場合に，現在のノードのツリーSID以降の構造化IDを指定します。

構造化IDに指定できる文字については「7.1　SID」を参照してください。

4

リンクの方向<linkType>

指定できません。

現在のノードとリンク情報の種別<linkType>のリンクで，関連しているノードを表す場合に指定します。

ツリーSID，構成情報のSIDのどちらのリンク情報も指定できます。

リンクの方向には次のどちらかを指定できます。

<：先行ノード

>：後続ノード

<linkType>にTreeは指定できません。また，リンクの方向，<linkType>に該当するリンクが複数存在する場合は，最初のリンクの関連ノードを指定したものとして動作します。<linkType>に指定できる文字については，「IM管理ノードリンク定義ファイル（imdd_nodeLink_def.conf）」（2.　定義ファイル）の「type」（処理対象種別）の説明を参照してください。

(B) 対象種別

対象種別には，変数をイベント情報に変換する，REST API実行結果に変換するなど，どのように変換するのか，変換の対象種別を指定します。対象種別に指定できる値を，次の表に示します。

表2‒10　対象種別に指定できる値

項番

対象種別

説明

対象ノードの指定要否

1

target[製品名]

対象ノードの構成情報のSIDのうち，[製品名]の製品プラグインが作成した構成情報のSIDの情報に変換されます。

対象ノードに，対象の製品プラグインが作成した構成情報のSIDが複数存在する場合は，最初に取得した構成情報のSIDの情報に変換されます。取得する順番は不定です。

[製品名]は省略できます。省略した場合は，最初に取得した構成情報のSIDの情報に変換されます。この場合も，取得する順番は不定です。

[製品名]に指定できる値は，構成取得対象ホスト定義ファイルのproductに指定できる値と同じです。詳細については「構成取得対象ホスト定義ファイル（imdd_target_host.conf）」（2.　定義ファイル）を参照してください。

要

2

tree

対象ノードのツリーSIDの情報に変換されます。

要

3

time

時刻の情報に変換されます。

不要

4

event[n]

casesに指定したtypeが「event」の提案活性条件のうち，n番目の提案活性条件に該当するJP1イベントの情報に変換されます。

該当するJP1イベントが複数存在する場合は，登録日時が最も新しいJP1イベントの情報に変換されます。

[n]には1〜100の数字を指定してください。

不要

5

eventCount[n]

casesに指定したtypeが「eventCount」の提案活性条件のうち，n番目の提案活性条件に該当するJP1イベントの情報に変換されます。

該当するJP1イベントが複数存在する場合は，すべてのJP1イベントの情報をまとめた情報に変換されます。

[n]には1〜100の数字を指定してください。

不要

6

restApi[n]

casesに指定したtypeが「restApi」の提案活性条件のうち，n番目の提案活性条件で実行したREST APIのレスポンスの情報に変換されます。

[n]には1〜100の数字を指定してください。

不要

7

plugin[n]

casesに指定したtypeが「plugin」の提案活性条件のうち，n番目の提案活性条件で実行したプラグイン関数の実行結果の情報に変換されます。

[n]には1〜100の数字を指定してください。

不要

8

cmd[n]

casesに指定したtypeが「cmd」の提案活性条件のうち，n番目の提案活性条件で実行したコマンドの実行結果の情報に変換されます。

[n]には1〜100の数字を指定してください。

不要

(C) 対象キー

対象キーには，変数を変換する対象種別ごとの要素を指定します。例えば，REST APIの実行結果の場合は，レスポンスのステータスコード要素，ボティー要素などを指定します。対象キーに指定できる値は，対象種別によって異なります。対象種別ごとに指定できる対象キーについて説明します。

(a) 対象種別がtargetの場合

対象種別がtargetの場合，対象キーには構成情報のSIDの要素を指定します。指定できる対象キーを次に示します。

sid

対象ノードの構成情報のSIDの値に変換されます。

value.メンバー名

対象ノードの構成情報のSIDに付与されたvalue値のメンバー名に指定されたメンバーの値に変換されます。

オブジェクトの配下のメンバーをさらに指定したい場合は，次の形式で指定します。

オブジェクト名.メンバー名

ただし，指定したメンバーの型が配列，またはオブジェクトの場合は指定できません。

［統合オペレーション・ビューアー］画面の［関連ノード］タブ−［関連ノードのプロパティ］領域に表示される，製品プラグインが設定したプロパティの値を変換する場合は，次の形式で指定します。

value.property.プロパティ名

指定例

選択中のIM管理ノード（JP1/PFMのエージェントのIM管理ノード）のSIDからサービスIDを取得し，監視一時停止コマンドを実行する場合の例です。

なお，サービスIDは変数に次の値を指定して取得したものとします。

対象ノード：選択中のIM管理ノード

対象種別：target（構成情報のSID）

対象キー：value.property.SerViceId（Value値のpropertyのメンバーServiceId）

{
    "type":"cmd",
    "params":{
        ...
        "cmd":"¥"C:¥¥Program Files (x86)¥¥Hitachi¥¥jp1pc¥¥tools¥¥jpctool¥" monitor suspend -noquery -id ${.:target:value.property.ServiceId:}"
    },
    "description":"JP1/PFMの監視一時停止コマンドを実行"
}

(b) 対象種別がtreeの場合

対象種別がtreeの場合，対象キーにはツリーのSIDの要素を指定します。指定できる対象キーを次に示します。

sid

対象ノードのツリーのSIDの値に変換されます。

value.メンバー名

対象ノードのツリーのSIDに付与されたvalue値のメンバー名に指定されたメンバーの値に変換されます。

オブジェクトの配下のメンバーをさらに指定したい場合は，次の形式で指定します。

オブジェクト名.メンバー名

ただし，配列，またはオブジェクトのメンバーは指定できません。

指定例

選択中のノードのツリーSIDを指定した場合の例です。

{
    "type":"event",
    "key":{
        "sid":"${.:tree:sid:}",
        ...
    },
    ...
}

(c) 対象種別がtimeの場合

対象種別がtimeの場合，対象キーには現在日時（ISO8601形式のUTC時刻）からの相対日時を指定します。相対日時の指定形式を次に示します。

[+|-]値.単位.切り出し部分

対象キーは省略できます。省略した場合は，ISO8601形式の現在日時に変換されます。timeに指定できる対象キーを次に示します。

[+|-]

現在日時から未来，または過去の日時かどうかを指定します。

+：現在日時から未来の日時に変換されます。

-：現在日時から過去の日時に変換されます。

このキーは省略できます。省略した場合は現在の時間に変換されます。

値.単位

現在日時からどの程度，未来，過去の時刻かを指定します。

値には，1〜2147483647の整数を指定します。単位には次のどれかの値を指定します。

y：年

M：月

d：日

h：時間

m：分

s：秒

[+|-]の指定が省略されている場合，このキーは指定できません。[+|-]が指定されている場合，このキーの指定は省略できません。なお，変数の変換結果の日時が次の場合は，エラーとなります。

1970-01-01T00:00:00Zより過去の日時

9999-12-31T23:59:59Zより未来の日時

切り出し部分

指定した日時の一部だけを変換したい場合に，変換したい一部を切り出して指定します。指定できる値を次に示します。

y：年部分

M：月部分

d：日

h：時間分

m：分部分

s：秒部分

このキーは省略できます。省略した場合はすべてを変換します。

指定例

イベント条件で，昨日のUTC23時から今日のUTC2時の時間帯のイベントを指定した場合の例です。

なお，「昨日のUTC23時」，「今日のUTC2時」を次の変数の組み合わせで取得したものとします。

昨日のUTC23時

${:time:-1.d.y:} 現在時刻の1日前の年部分

${:time:-1.d.M:} 現在時刻の1日前の月部分

${:time:-1.d.d:} 現在時刻の1日前の日部分

各変数は対象種別にtime，対象キーに-1.d.切り出し部分を指定することで現在時刻の１日前の日時の切り出し部分の値を取得しています。

今日のUTC2時

${:time:..y:} 現在時刻の年部分

${:time:..M:} 現在時刻の月部分

${:time:..d:} 現在時刻の日部分

各変数は対象種別にtime，対象キーに切り出し部分を指定することで現在時刻の日時の切り出し部分の値を取得しています。

{
    "type":"event",
    "key":{
        "B.TIME":["${:time:-1.d.y:}-${:time:-1.d.M:}-${:time:-1.d.d:}T23:00:00Z", "${:time:..y:}-${:time:..M:}-${:time:..d:}T02:00:00Z"],
            ...
    },
    ...
}

(d) 対象種別がevent[n]の場合

対象種別がevent[n]の場合，対象キーにはJP1イベントの要素を指定します。指定できる対象キーを次に示します。

sid

JP1イベントのSIDに変換されます。

属性名

JP1イベントの<属性名>の属性の値に変換されます。指定できる属性名については「5.6.1　イベント検索」を参照してください。

指定例

イベント条件で未対処のイベントID：XXXXの後に，未対処イベントID：YYYYが発行されている条件を指定する場合の例です。

なお，2番目のイベント条件のB.TIME（登録日時）の１番目の要素に，1番目のイベント条件に該当したイベントの登録日時を指定し，2番目の要素に現在時刻を指定することでXXXXの後のYYYYのイベントという条件を指定したものとします。また，1番目のイベント条件に該当したイベントの登録日時は，変数に次の値を指定することで取得したものとします。

対象種別：event[1] 1番目のイベント条件

対象キー：B.TIME イベントの登録日時

"cases":[
    [
        {
            "type":"event",
            "key":{
                "sid":"${.:tree:sid:}",
                "statusFilter":[30],
                "B.ID":["XXXX"],
                "E.@JP1IM_DEALT":[0]
            },
            ...
        },
        {
            "type":"event",
            "key":{
                "sid":"${.:tree:sid:}",
                "statusFilter":[30],
                "B.TIME":["${:event[1]:B.TIME:}","${:time::}"],
                "B.ID":["YYYY"],
                "E.@JP1IM_DEALT":[0]
            },
            ...
        }
    ]
]

(e) 対象種別がeventCount[n]の場合

対象種別がeventCount[n]の場合，対象キーにはJP1イベントの要素を指定します。指定できる対象キーを次に示します。

sid

JP1イベントのSIDに変換されます。複数のJP1イベントが該当する場合は，各イベントを「,」で区切った文字列に変換されます。

指定例

JP1イベントの対処状況の変更の対処アクションで，イベント条件でヒットしたJP1イベントをすべて対処済みにする場合の例です。

{
    "type":"eventStatus",
    "params":{
        "sid":"${:eventCount[1]:sid:}",
        "dealt":1
    },
    "description":"該当するすべてのJP1イベントを対処済みに変更する"
}

(f) 対象種別がrestApi[n]の場合

対象種別がrestApi[n]の場合，対象キーにはREST APIのレスポンスの要素を指定します。指定できる対象キーを次に示します。

status

REST APIのレスポンスのステータスコードに変換されます。

headers

REST APIのレスポンスヘッダーに変換されます。変換後の形式については，「(1)(d) typeに「restApi」を指定した場合の提案活性条件」の「REST APIのレスポンスヘッダーの文字列の形式」の説明を参照してください。

body

REST APIのレスポンスボディーに変換されます。

指定例

プラグイン関数実行の対処アクションの引数に，REST APIの条件で実行したREST APIのレスポンスボディーを指定する場合の例です。

なお，REST APIの条件で実行したREST APIのレスポンスボディーは，変数に次の値を指定することで取得したものとします。

対象種別：restApi[1] １番目のREST APIの条件

対象キー：body レスポンスボディー

"cases":[
    [
        {
            "type":"restApi",
            ...
        }
]
...

"action": {
    "type":"plugin",
    "params":{
        ...
        "args":{
            "apiResponse":"${:restApi[1]:body:}"
        }
    },
    ...
}

(g) 対象種別がplugin[n]の場合

対象種別がplugin[n]の場合，対象キーを指定する必要はありません。案活性条件のkeyで指定したプラグイン関数が，args.setResultメソッドに渡したオブジェクトのsuggestionメンバーの値に変換されます。

指定例

プラグイン関数の実行の対処アクションの引数に，プラグイン関数の条件で実行したプラグイン関数のレスポンスを指定する場合の例です。

なお，プラグイン関数の条件で実行したプラグイン関数のレスポンは，変数に次の値を指定することで取得したものとします。

対象種別：plugin[1] プラグイン関数の条件

対象キー：指定なし

"cases":[
    [
        {
            "type":"plugin",
            ...
        }
]
...

"action": {
    "type":"plugin",
    "params":{
        ...,
        "args":{
            "pluginResult":"${:plugin[1]::}"
        }
    },
    ...
}

(h) 対象種別がcmd[n]の場合

対象種別がcmd[n]の場合，対象キーにはコマンドの実行結果の要素を指定します。指定できる対象キーを次に示します。

rc

コマンドの戻り値に変換されます。

stdout

コマンドの標準出力に変換されます。

stderr

コマンドの標準エラー出力に変換されます。

指定例

プラグイン関数の実行の対処アクションの引数に，コマンド実行の条件で実行したコマンドの標準出力を指定する場合の例です。

なお，コマンド実行の条件で実行したコマンドの標準出力は，変数に次の値を指定することで取得したものとします。

対象種別：cmd[1] １番目のコマンドの条件

対象キー：stdout 標準出力

"cases":[
    [
        {
            "type":"cmd",
            ...
        }
]
...

"action": {
    "type":"plugin",
    "params":{
        ...,
        "args":{
            "cmdStdOut":"${:cmd[1]:stdout:}"
        }
    },
    ...
}

(i) エンコード種別

変数を変換する際にエンコードする場合に指定します。エンコード種別は省略できます。省略した場合はエンコードされません。

指定できるエンコード種別を次に示します。

ENC：変数をBase64でエンコードします。

URLENC：変数をURLでエンコードします。

注意事項

提案定義ファイルには，Windowsの場合はAdministrator権限，UNIXの場合はroot権限を設定してください。

提案定義ファイルは，正規表現で指定できます。正規表現で指定する場合，すべての文字に一致する表現の「.*」を多用すると，マッピングに時間が掛かることがあります。「.*」を使用する場合は，必要な個所にだけ「.*」を使用するようにしてください。

提案定義ファイルの正規表現は部分一致のため，先頭および末尾に「.*」を指定した場合と，先頭および末尾に「.*」を指定しない場合は同じ条件になります。

例えば，次の例1と，例2は同じ条件になります。

(例1)「_OBJECT_JP1IMMGR」を含む文字列の場合に一致する正規表現

.*_OBJECT_JP1IMMGR.*

(例2)「_OBJECT_JP1IMMGR」を含む文字列の場合に一致する正規表現

_OBJECT_JP1IMMGR

先頭および末尾に「.*」を指定した場合，検索に時間が掛かることがあるので，先頭および末尾に「.*」は指定しないでください。

正規表現を使用していて，次に示すどちらかに一致している場合，jddupdatesuggestionコマンドを実行した際にKAJY22042-Wメッセージが表示されます。

正規表現として，先頭または末尾に「.*」が指定されている

正規表現として，「.*」が連続して指定されている

KAJY22042-Wメッセージの詳細については，マニュアル「JP1/Integrated Management 3 -Manager メッセージ」を参照してください。

一つのIM管理ノードで表示する提案情報の数によっては，提案活性条件の判定に時間が掛かる場合があります。十分にテスト運用し，問題ないことを確認してください。

定義例

次の条件の場合の提案定義ファイルの定義例について説明します。

提案表示条件

ヘルスチェックイベントがマッピングされるJP1/PFM - Agentのノードに提案を表示する。

ユーザーは，JP1_AJS_AdminまたはJP1_AJS_EditorのJP1権限を付与されている。

提案活性条件

選択中のIM管理ノードと同じホストにJP1/AJS - Agentのノードが存在し，かつ選択中のIM管理ノードに，過去1時間以内にホスト停止のヘルスチェックイベントが発行され，対処状況は未対処となっている。

対処アクション

選択中のIM管理ノードと同じホストに存在するJP1/AJS - Agentの［関連ノード］タブに画面を移動する。

図2‒2　同一ホスト内にJP1/AJS-AgentとJP1/PFM-Agentが存在する場合のツリー構成例

上記の図で「JP1/AJS3 - Agent」がJP1/AJS - Agentのノードです。ツリーSIDを次に示します。

_ROOT_AllSystems/_HOST_HOSTA/_CATEGORY_managementApplications/_OBJECT_JP1AJSAGT

上記の図で「HostA<Windows>」が，ヘルスチェックイベントがマッピングされるJP1/PFM - Agentのノードです。ツリーSIDを次に示します。

_ROOT_AllSystems/_HOST_HOSTA/_CATEGORY_managementApplications/_SUBCATEGORY_JP1%2FPFM%20-%20Windows/_OBJECT_JP1PFM-ATA1HostAJP1AGENTSERVICE

提案定義ファイルに記載する定義を次に示します。

{
  "meta":{
    "version":"1"
  },
  "suggestions":[
    {
      "suggestionId":"check_affected_rootJobnet",
      "label":"ホスト停止に影響されるルートジョブネットの影響",
      "node":"_CATEGORY_managementApplications.*_OBJECT_JP1PFM-A",
      "permissions":[
        ["JP1_AJS_Admin"],
        ["JP1_AJS_Editor"]
      ],
      "cases":[
        [
          {
            "type":"struct",
            "key":{
              "idType":"tree",
              "sid":"${../..:tree:sid:}/_OBJECT_JP1AJSAGT"
            },
            "ope":"EXIST",
            "val":true,
            "description":"選択中のノード(PFM-Agent)と同じホストにJP1/AJS-Agentのノードが存在する"
          },
          {
            "type":"event",
            "key":{
              "sid":"${.:tree:sid:}",
              "statusFilter":[20,30,40],
              "B.TIME":["${:time:-1.h.:}","${:time::}"],
              "B.ID":["00004860"],
              "REGEX_B.MESSAGE":"KAVL15022-E.*hcsstatus=Host Not Available",
              "E.@JP1IM_DEALT":[0]
            },
            "ope":"EXIST",
            "val":true,
            "description":"ホスト停止のJP1イベントが発行されている"
          }
        ]
      ],
      "action":{
        "type":"jump",
        "params":{
          "url":"index?sid=${../..:tree:sid:URLENC}%2F%5FOBJECT%5FJP1AJSAGT&view=tree&tab=relation&eou=1"
        },
        "description":"JP1/AJS-Agentのノードの［関連ノード］タブに移動"
      }
    }
  ]
}

シングルサインオンマッピング定義ファイル（imdd_sso_mapping.properties）

形式

OpenIDプロバイダのユーザーID = JP1ユーザー名
OpenIDプロバイダのユーザーID = JP1ユーザー名
...

ファイル

imdd_sso_mapping.properties

imdd_sso_mapping.properties.model（シングルサインオンマッピング定義ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Managerパス¥conf¥imdd¥

論理ホストのとき

共有フォルダ¥jp1imm¥conf¥imdd¥

UNIXの場合

物理ホストのとき

/etc/opt/jp1imm/conf/imdd/

論理ホストのとき

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

説明

インテリジェント統合管理基盤で使用するJP1ユーザー名とOpenIDプロバイダに登録されているユーザー名のマッピングを定義するファイルです。

定義の反映時期

jddupdatessomapコマンドが正常終了すると，シングルサインオンマッピング定義ファイルの設定がインテリジェント統合管理基盤に反映されます。

記述内容

シングルサインオンマッピング定義ファイルは，UTF-8で，BOM（byte order mark）が付与されないように保存してください。

シングルサインオンマッピング定義ファイルには，次に示す規則があります。

「#」または「!」で始まる行は，コメントになります。

OpenIDプロバイダのユーザーID，およびJP1ユーザー名は英小文字，英大文字を区別します。

指定した形式が不正な場合は，その行を無視して処理を続行します。

同じOpenIDプロバイダのユーザーIDを複数指定した場合は，最後に指定したものが有効になります。

定義数の上限はありません。

有効なプロパティが一つも存在しない状態で定義の反映を実行した場合はKAJY52031-Wメッセージを出力し，反映済みのシングルサインオンマッピング定義をクリアします。

OpenIDプロバイダのユーザーID

OpenIDプロバイダに登録済みのユーザーIDを指定します。右辺に指定したJP1ユーザー名とマッピングします。

JP1ユーザー名

JP1/Baseの認証サーバに登録済みのJP1ユーザー名を指定します。左辺に指定したOpenIDプロバイダに登録済みのユーザーIDとマッピングします。

JP1ユーザー名に指定できる文字については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1ユーザーには，インテリジェント統合管理基盤へのログインに必要なJP1_Console_Admin，JP1_Console_Operator，またはJP1_Console_UserのJP1権限レベルが必要です。登録されていないJP1ユーザーやJP1権限がないJP1ユーザーを指定した場合，ユーザー認証の際にKAJY52027-Eエラーとなります。

JP1/Baseのディレクトリサーバ連携で，JP1認証情報をディレクトリサーバで管理するDSユーザーは，シングルサインオンマッピング認証に使用できません。シングルサインオンマッピング定義ファイルにDSユーザーを設定して認証した場合，ユーザー認証の際にKAJY52027-Eエラーとなります。JP1/Baseのディレクトリサーバ連携の詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

注意事項

OpenIDプロバイダのユーザーIDには，最初の空白以外の文字から最初のエスケープされていない「=」，「:」または空白文字の手前まで，行末記号を除くすべての文字が含まれます。

OpenIDプロバイダのユーザーIDの終わりを示す文字（「=」，「:」または空白文字）をユーザーIDに含める場合は，終わりを示す文字の前にバックスラッシュを付与してエスケープしてください。

OpenIDプロバイダのユーザーIDの先頭のコメントを表す文字（「#」または「!」）をユーザーIDに含める場合は，コメントを表す文字の前にバックスラッシュを付与してエスケープしてください。

OpenIDプロバイダのユーザーIDに含める場合に，エスケープが必要な文字を次の表に示します。

表2‒11　 OpenIDプロバイダのユーザーIDに含める場合にエスケープが必要な文字

項番

文字

Unicode

エスケープが必要な条件

1

=

¥u003D

常に必要

2

:

¥u003A

3

スペース

¥u0020

4

#

¥u0023

先頭文字の場合は必要

5

!

¥u0021

定義例

OpenIDuser001 = JP1admin
OpenIDuser002 = JP1ope
...

自動対処アクション定義ファイル（autoactconf.json）

形式

「7.2.4(1) 自動対処アクション定義オブジェクト」と同じです。

ファイルサイズの上限は10MBです。

ファイル

autoactconf.json

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Managerパス¥conf¥imdd¥responseaction

論理ホストのとき

共有フォルダ¥jp1imm¥conf¥imdd¥responseaction

UNIXの場合

物理ホストのとき

/etc/opt/jp1imm/conf/imdd/responseaction

論理ホストのとき

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

文字コード

UTF-8（ファイルにBOMが付いていた場合，BOMを無視してロードします）

説明

自動対処アクションの実行条件，実行内容を記載した自動対処アクション定義を保存するファイルです。

定義の反映時期

JP1/IM - Managerのサービスの起動時，または，自動対処アクション定義ファイル反映コマンド（jddupdateaction）の実行時に，このファイルを読み込むことで，システムに反映されます。

記述内容

「7.2.4(1) 自動対処アクション定義オブジェクト」と同じです。

定義例

「7.2.4(1) 自動対処アクション定義オブジェクト」と同じです。

対処アクション状態監視定義ファイル（responseactionnotice.conf）

形式

{
    "meta":{
        "version":"バージョン情報",
    },
    "eventnotice":{
        "autoactionevent":"[通知を行う自動対処アクションの状態]",
    }
}

ファイル

responseactionnotice.conf

responseactionnotice.conf.model（対処アクション状態監視定義ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Managerパス¥conf¥imdd¥responseaction

論理ホストのとき

共有フォルダ¥jp1imm¥conf¥imdd¥responseaction

UNIXの場合

物理ホストのとき

/etc/opt/jp1imm/conf/imdd/responseaction

論理ホストのとき

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

文字コード

この定義ファイルは，UTF-8で，BOM（byte order mark）が付与されないように保存してください。

説明

自動対処アクションの実行状態の監視に関する設定を定義するファイルです。

定義の反映時期

JP1/IM - Managerの起動時に有効になります。

記述内容

指定できるメンバーを次の表に示します。

メンバー

データ型

説明

指定規則

meta

object

メタ情報の設定です。

必須

version

string

対処アクション状態監視定義ファイルのバージョンを指定します。

固定値として「1」を指定します。

必須

eventnotice

object

状態変更時にイベント通知を行うための設定です。

任意

autoactionevent

string[]

自動対処アクションの状態が，どの状態になったときに通知を行うかを指定します。

次のどれかを指定できます。

SENDED

実行先の統合エージェント制御基盤を管理するJP1/IM - Managerへの対処アクション実行要求送信が完了した場合（対処アクションの状態が「実行制御送信中」に変わった場合）にJP1イベントを発行する。

RUNNING

実行先の統合エージェント制御基盤への対処アクション実行要求送信が完了した場合（対処アクションの状態が「キューイング」となった場合）にJP1イベントを発行する。

ENDED

統合エージェント制御基盤でのコマンド実行が完了した場合（対処アクションの状態が「終了」または「強制終了」「キャンセル」となった場合）にJP1イベントを発行する。

ERROR

対処アクションの状態が異常な状態になった場合（対処アクションの状態が「実行不可」「通信失敗」もしくは「実行失敗」になった場合）にJP1イベントを発行する。

このメンバーは複数設定できます。

デフォルト（初期値，エラーが発生した場合の仮定値）は，このメンバーが設定されていない状態で動作します。

任意

定義例

自動対処アクションの実行終了時または実行失敗時に，JP1イベントを発行する場合の定義例を，次に示します。

{
    "meta":{
        "version":"1"
    },
    "eventnotice":{
        "autoactionevent":["ENDED","ERROR"]
    }
}

ユーザー作成定義ファイルリスト定義ファイル（imdd_user_deffile_list.json）

形式

定義ファイルの形式

{
  "filelist":[
    {
      "filename": "ファイル名",
      "filepath": "ファイルの絶対パス",
      "filecategoryID": "ファイルのカテゴリーID",
      "filecategoryName": "ファイルのカテゴリー名",
      "updateaction": "定義反映のための操作"
    }, ・・・
  ]
}

モデルファイルの形式

{
  "filelist":[
    {
      "filename": "",
      "filepath": "",
      "filecategoryID": "",
      "filecategoryName": "",
      "updateaction": ""
    }
  ]
}

ファイル

imdd_user_deffile_list.json

imdd_user_deffile_list.json.model（モデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Managerパス¥conf¥imdd¥fileoperation¥

論理ホストのとき

共有フォルダ¥jp1imm¥conf¥imdd¥fileoperation¥

UNIXの場合

物理ホストのとき

/etc/opt/jp1imm/conf/imdd/fileoperation/

論理ホストのとき

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

説明

ユーザーが作成する定義ファイルのうち，JP1/IM - Managerが提供する機能で更新や削除ができるファイルを定義するファイルです。

定義の反映時期

定義ファイル一覧取得APIの実行時に反映されます。

ファイルの文字コード

UTF-8（ファイルにBOMが付いていた場合，BOMを無視してロードします）

記述内容

項目名

省略可否

説明

filename

不可

ファイル名を記載します。

filepath

可

ファイルの配置先を絶対パスで記載します。

ファイルパス（ファイル名を含めた絶対パス）が，200文字を超えた場合はエラーとなります。

指定したファイルパスにfilenameで指定した名称のファイルが存在しない場合は，不正な定義とみなされます。

この設定項目を省略した場合，「Managerパス¥conf¥imdd¥user」が仮定されます（論理環境の場合は「Managerパス」を「共有フォルダ¥jp1imm」に読み替えてください）。

filecategoryID

可

複数のファイルをグルーピングしたい場合に指定するカテゴリーIDを記載します。

同一のカテゴリーIDを指定したファイルは，同じカテゴリー名に属すると判断されます。

指定できる文字は，半角英数字と「-」（ハイフン）と「_」（アンダースコア）です。最大32文字まで指定できます。「jp1_」から始まるカテゴリーIDは指定できません。

filecategoryName

可

カテゴリーIDに対するカテゴリー名を指定します。

制御文字以外の文字で指定します。最大32文字まで指定できます。

filecategoryIDの指定がない場合，この設定項目は無視されます。filecategoryIDの指定がある場合，この設定項目の指定がないときは，filecategoryIDの値が設定されます。

updateaction

可

定義ファイルを更新した場合に実行すべき操作（コマンドライン）を記載します。

詳細については，「■updateactionの記載について」を参照してください。

■updateactionの記載について

定義ファイルの更新後に実行するコマンドを記載できます。記載できるコマンドラインの長さは4,096バイトまでです。

実行先ホストが64ビット版のWindowsで，%WINDIR%¥System32フォルダ以下に配置されているコマンドを指定する場合は，WOW64のリダイレクト機能に留意してください。

実行できるコマンドの種類を次に示します。

コマンドを実行するホストがWindowsの場合

実行形式ファイル（.com，.exe）

バッチファイル（.bat）

JP1/Scriptのスクリプトファイル（.spt）（ただし，.sptファイルが実行できるよう関連づけが設定されていること）

コマンドを実行するホストがLinuxの場合

Linuxのコマンド

シェルスクリプト

なお，次のようなコマンドは実行できません。

対話操作を必要とするコマンド

画面を表示するコマンド

エスケープシーケンスや制御コードを伴うコマンド

デーモンなどの，終了しないコマンド

Windows メッセージ機構やDDEなど，デスクトップとの対話が必要なコマンド（Windowsの場合）

shutdownやhaltなど，OSをシャットダウンするコマンド

■ユーザー作成定義ファイルリスト定義ファイルに指定できるファイルについて

ユーザー作成定義ファイルリスト定義ファイルに記載できるファイルを，次に示します。

ユーザーが作成する提案定義ファイル（imdd_suggestion_任意のファイル名.conf）

相関イベント発行定義ファイル

相関イベント発行環境定義ファイル

イベント拡張属性定義ファイル

イベント拡張属性定義ファイル（拡張ファイル）

共通除外条件拡張定義ファイル

モニター画面呼び出し定義ファイル

ユーザー独自のメトリック定義ファイル（metrics_任意のPrometheusトレンド名.conf）

論理ホスト環境のJP1/IM3 - Managerの定義ファイルの更新のために，updateactionにjco_spmd_reloadコマンドを指定する場合，-hオプションの指定は不要です。

■ユーザーが作成する定義ファイルの格納先が任意のファイルについて

ユーザーが作成する定義ファイルについて，格納先に任意の場所を指定できるファイルの場合，定義ファイル操作機能を利用するときは，定義ファイルの格納先を次の場所にする必要があります。

Windowsの場合

物理ホストのとき

Managerパス¥conf¥imdd¥user¥

論理ホストのとき

共有フォルダ¥jp1imm¥conf¥imdd¥user¥

UNIXの場合

物理ホストのとき

/etc/opt/jp1imm/conf/imdd/user/

論理ホストのとき

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

定義例

{
  "filelist":[
    {
      "filename": "file_def.conf",
      "filepath": "C:¥¥Program Files (x86)¥¥Hitachi¥¥JP1IMM¥¥conf¥¥imdd¥¥user",
      "filecategoryID": "user_def",
      "filecategoryName": "user_def",
      "updateaction": "JP1Cons¥¥bin¥¥jco_spmd_reload.exe "
    }
  ]
}

定義ファイルプロパティファイル（imdd_file_properties.json）

形式

{
  "filelist":[
    {
      "filename": "ファイル名",
      "filepath": "ファイルの絶対パス",
      "updateaction": "定義反映のための操作",
      "message": "メッセージ"
    }, ・・・
  ]
}

ファイル

imdd_file_properties.json

格納先ディレクトリ

定義ファイルの取得機能または更新機能で操作する定義ファイルを，圧縮したzipファイルの中に配置します。

説明

定義ファイルの取得機能または更新機能で操作する定義ファイルのファイル名，ファイルパス，定義ファイル反映のための操作を記載したファイルです。

定義の反映時期

なし

記述内容

項目名

説明

filename

ファイル名を記載します。

filepath

ファイルの配置先を絶対パスで記載します。

ファイルパス（ファイル名含めた絶対パス）が，200文字を超えた場合はエラーとなります。

updateaction

Windowsの場合，ファイルの配置先ディレクトリを<インストールディレクトリ>の一階層上からの相対パスで定義ファイルを更新した場合に実行すべき操作（コマンドライン）を記載します。

Linuxの場合，/opt/からの相対パスで定義ファイルを更新した場合に実行すべき操作（コマンドライン）を記載します。

詳細については，「ユーザー作成定義ファイルリスト定義ファイル（imdd_user_deffile_list.json）」の「■updateactionの記載について」を参照してください。

message

エラーメッセージIDとそのメッセージ本文を返却します。成功した場合は省略します。

ファイルの文字コード

UTF-8（ファイルにBOMが付いていた場合，BOMを無視してロードします）

定義例

{
  "filelist":[
    {
      "filename": "file_def.conf",
      "filepath": "C:¥¥Program Files (x86)¥¥Hitachi¥¥JP1IMM¥¥conf¥¥imdd¥¥user",
      "updateaction": "JP1Cons¥¥bin¥¥jco_spmd_reload.exe"
    }
  ]
}

発生元ホストマッピング定義ファイル（user_hostmap.conf）

形式

[DESC_VERSION=バージョン情報]
#コメント
def 定義名1
    cnd
        イベント条件
    end-cnd
    source_attr 属性名
end-def
def 定義名2
    cnd
        イベント条件
    end-cnd
    source_attr 属性名
end-def

ファイル

user_hostmap.conf（発生元ホストマッピング定義ファイル）

user_hostmap.conf.model（発生元ホストマッピング定義ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Consoleパス¥conf¥hostmap¥

論理ホストのとき

共有フォルダ¥jp1cons¥conf¥hostmap¥

UNIXの場合

物理ホストのとき

/etc/opt/jp1cons/conf/hostmap/

論理ホストのとき

共有ディレクトリ/jp1cons/conf/hostmap/

説明

発生元ホストマッピングの機能で，発生元ホストをマッピングするJP1イベントの条件とマッピング元を定義するファイルです。発生元ホストマッピング定義ファイルの最大ファイルサイズは，17メガバイトです。

発生元ホストマッピングの機能は，このファイルの定義に従い，イベント条件に一致するJP1イベントの発生元ホストをマッピングします。

定義の反映時期

発生元ホストマッピングの機能が有効な場合で，次のどちらかが成立するときに有効になります。

JP1/IMを起動した場合

jco_spmd_reloadコマンドを実行した場合

記述内容

DESC_VERSION=バージョン情報

発生元ホストマッピング定義ファイルのファイルバージョンである1を指定します。DESC_VERSIONは，定義ファイルの先頭行（空行，コメント行を除いた行のうちファイルのはじめに記述された行）に指定します。先頭行にファイルバージョンがない場合は，ファイルバージョンを1と見なして処理します。

# コメント

発生元ホストマッピング定義ファイルの説明を記述します。

def 〜 end-def

マッピングの定義ブロックの開始と終了を示します。def〜end-defブロックは省略できます。

def以降には，発生元ホストマッピング定義の定義名を記述します。「def△△△定義1△△△定義2△△△」と指定した場合，「△△定義1△△△定義2△△△」が定義名となります（△は半角スペースを表す）。

定義名は，発生元ホストマッピング定義ファイル内で一意になるように指定します。文字列の長さは1から50バイトまでです。

使用できる文字は，制御文字を除くすべての文字です。

制御文字は，アスキーコードの0x00〜0x1Fと0x7F〜0x9Fです。

cnd 〜 end-cnd

マッピングするJP1イベントのイベント条件ブロックの開始と終了を示します。イベント条件ブロックは，マッピングの定義ブロック内に必ず一つだけ指定します。省略できません。受信したJP1イベントが，複数のイベント条件に一致する場合，発生元ホストマッピング定義ファイルの先頭に近い定義ブロックが優先されます。cnd，およびend-cndパラメーターの前後のタブまたはスペースは無視されます。

イベント条件

マッピングするJP1イベントの条件を指定します。イベント条件ブロックには，1件以上，最大256件のイベント条件を指定できます。イベント条件とイベント条件は，AND条件となります。イベント条件は，次の形式で指定します。

属性名 比較キーワード オペランド

属性名

属性名には，比較したい属性の名称を指定します。基本属性を指定する場合は，名称の前に「B.」を付けます。拡張属性（共通情報），拡張属性（固有情報）を指定する場合は，名称の前に「E.」を付けます。英大文字・英小文字を区別します。

指定できる属性名と比較キーワードの組み合わせおよびオペランドを次に示します。

表2‒12　指定できる属性名と比較キーワードの組み合わせおよびオペランド

項番

項目

属性名

比較キーワード

オペランド

1

イベントID

B.ID

と一致する

と一致しない

複数指定できる。複数指定では最大100件指定できる。

16進数形式で指定する。大文字・小文字は区別しない。

指定できる範囲は0〜7FFFFFFFである。

2

登録要因

B.REASON

と一致する

と一致しない

複数指定できる。複数指定では最大100件指定できる。

3

発行元プロセスID

B.PROCESSID

と一致する

と一致しない

複数指定できる。複数指定では最大100件指定できる。

指定できる範囲は，-2,147,483,648〜2,147,483,647である。

4

発行元ユーザーID

B.USERID

と一致する

と一致しない

複数指定できる。複数指定では最大100件指定できる。

指定できる範囲は，-2,147,483,648〜2,147,483,647である。

5

発行元グループID

B.GROUPID

と一致する

と一致しない

複数指定できる。複数指定では最大100件指定できる。

指定できる範囲は，-2,147,483,648〜2,147,483,647である。

6

発行元ユーザー名

B.USERNAME

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

7

発行元グループ名

B.GROUPNAME

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

8

発行元イベントサーバ名(登録ホスト名)※

B.SOURCESERVER

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

9

送信先イベントサーバ名※

B.DESTSERVER

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

10

メッセージ

B.MESSAGE

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

11

重大度

E.SEVERITY

と一致する

複数指定できる。複数指定した場合，同じ重大度は指定できない。正規表現を指定した場合は，複数指定できない。"Emergency"，"Alert"，"Critical"，"Error"，"Warning"，"Notice"，"Information"，"Debug"のどれかを指定できる。

12

ユーザー名

E.USER_NAME

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

13

プロダクト名

E.PRODUCT_NAME

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

14

オブジェクトタイプ

E.OBJECT_TYPE

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

15

オブジェクト名

E.OBJECT_NAME

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

16

登録名タイプ

E.ROOT_OBJECT_TYPE

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

17

登録名

E.ROOT_OBJECT_NAME

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

18

オブジェクトID

E.OBJECT_ID

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

19

事象種別

E.OCCURRENCE

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

20

終了コード

E.RESULT_CODE

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

21

拡張属性の固有情報

E.xxxxxxx

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

属性名には，先頭が英大文字で英大文字，数字，およびアンダースコア（_）から構成される32バイトまでの名称を設定できる。

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

注※

統合監視DBおよびIM構成管理DBが有効な場合に，比較キーワードが，「と一致する」「と一致しない」のとき，パス表記で業務グループ名を指定できます。

統合監視DBおよびIM構成管理DBが無効な場合，および［と一致する］［と一致しない］以外を選択した場合，パス表記で業務グループ名を指定しても，ホスト名として扱われます。

jcoimdefコマンドの-ignorecasehostオプションの指定を「ON」にしている場合に，比較キーワードで［正規表現］以外を選択すると，文字列の英大文字・英小文字を区別しません。

比較キーワード

比較キーワードには，「BEGIN（から始まる）」，「IN（と一致する）」，「NOTIN（と一致しない）」，「SUBSTR（を含む）」，「NOTSUBSTR（を含まない）」，「REGEX（正規表現）」のどれか一つを指定できます。英大文字・英小文字を区別します。

オペランド

比較キーワードで属性値と比較する値を文字列で指定します。英大文字・英小文字を区別します。

オペランドを複数指定する場合は，一つ以上の連続した半角スペースまたはタブをオペランドとオペランドの間に挿入します。オペランドとオペランドは，OR条件となります。ただし，正規表現を指定している場合は，複数指定できません。

オペランドに，半角スペース，タブを指定したい場合，次のように記述します。

項番

指定したい値

指定方法

1

タブ（0x09）

%09

2

半角スペース（0x20）

%20

3

%（0x25）

%25

4

CR（0x0d）

%0d

5

LF（0x0a）

%0a

定義フォーマットの上限チェックの場合，%20，%25は1文字として扱います。複数選択した場合の定義例「IDが100と200に一致する」を示します。

B.ID△IN△100△200

（凡例）　△：半角スペース（0x20）

オペランドは，イベント条件1件当たり4,096バイトまで，イベント条件ブロック1件当たり4,096バイト（イベント条件ブロックに記述したオペランドの合計バイト数）まで指定できます。

source_attr

マッピング元の属性値を指定します。source_attrには，発生元ホスト名が格納されている値を一つ指定できます。省略はできません。source_attrは，次の形式で指定します。

source_attr マッピング元属性値

マッピング元属性値には，属性名または変数名を指定できます。属性名を指定すると，属性値のすべてを格納します。変数名を指定すると，属性値の一部を切り出して格納します（部分切り出し）。

マッピング元属性値に指定できる属性は拡張属性（固有情報）です。拡張属性（固有情報）は，「表3-2　共通情報の一覧」にある共通情報以外の属性です。変数名には$EVENV1〜$EVENV9が指定できます。

定義例

イベントIDが100に一致，かつ重大度がWarningで，メッセージが「ホストAGENT_Aでエラーコード1111のエラーが発生しました」（AGENT_Aはホスト名）に一致する場合に，メッセージに含まれるホスト名（AGENT_A）を発生元ホスト名に設定する例を次に示します。

DESC_VERSION=1
#メッセージ中のホスト名を発生元ホスト名にマッピングする
def 発生元ホストマッピング1
    cnd
        B.ID IN 100
        E.SEVERITY IN Warning
        B.MESSAGE REGEX ホスト([a-zA-Z0-9¥-_]+)でエラーコード1111のエラーが発生しました
    end-cnd
    source_attr $EVENV1
end-def

自動アクション環境定義ファイル（action.conf.update）

形式

[論理ホスト名¥JP1CONSOLEMANAGER¥ACTION]
"ACTIONINFSIZE"=dword:16進数値
"EVENTALIVEPERIOD"=dword:16進数値
"ACTIONEXECUSER"="JP1ユーザー名"
"ACTIONDEFFILE"="ファイル名"
"HOSTINEVENT"="{remote | local}"
"ACTIONINFFILE"="ファイル名"
"ACTIONLIMIT"=dword:16進数値
"SENDABLE_EVENT"="イベントID"
"REGEXP"="{JP1|EXTENDED}"
"ACTIONPRIORITY"="{DEFAULT|V8COMPATIBLE}"

[論理ホスト名¥JP1CONSOLEMANAGER¥LOG_CONTROL¥JCAMAIN]
"LOGSIZE"=dword:16進数値

共通定義情報のパラメーター形式です。上記以外のパラメーターは，内部動作で使うパラメーターですので編集しないでください。

ファイル

action.conf.update（自動アクション環境定義ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

Consoleパス¥default¥

UNIXの場合

/etc/opt/jp1cons/default/

説明

自動アクションの実行環境の情報を定義するファイルです。

必要な定義内容をモデルファイルとして提供しています。設定を変更する場合は，モデルファイルをコピーして，定義ファイル（Windowsの場合Consoleパス¥conf¥action.conf，UNIXの場合/etc/opt/jp1cons/conf/action.conf）にリネームしたあと，内容を編集してください。

アクション情報ファイルの容量を小さくする場合

アクション情報ファイルのバックアップを採取し，アクション情報ファイルをいったん削除してから，設定を変更してください。

定義の反映時期

jbssetcnfコマンドを実行して定義をJP1共通定義情報に反映したあとに，JP1/IM - Managerを起動したときに有効になります。

次のパラメーターについては，jco_spmd_reloadコマンドによるリロードによっても，有効となります。

"EVENTALIVEPERIOD"

"ACTIONEXECUSER"

"HOSTINEVENT"

"SENDABLE_EVENT"

記述内容

[論理ホスト名¥JP1CONSOLEMANAGER¥ACTION]

アクション実行環境設定のキー名称です。

"論理ホスト名"の部分を，物理ホストの場合はJP1_DEFAULTに，論理ホストの場合は論理ホスト名に設定します。

"ACTIONINFSIZE"=dword:16進数値

アクション情報ファイル容量を16進数値（キロバイト単位）で指定します。

指定できる値は次のとおりです。

指定できる値は，「dword:00000001〜00001000」（1〜4,096キロバイト）です。デフォルト値は，「dword:00001000」（4,096キロバイト）です。

アクション情報ファイルは，自動アクションの実行情報を保存するファイルです。イベントコンソールおよびjcashowaコマンドでアクションを参照する場合や，アクション状態通知イベントを発行する場合は，アクション情報ファイルを参照します。

このファイルは，"ACTIONINFSIZE"で設定した値に達すると上書きされるラップアラウンド形式のファイルです。そのため，上書きされた古いアクション情報はイベントコンソールおよびjcashowaコマンドで参照できなくなったり，アクション状態通知イベントが発行されなくなったりすることがあります。過去のアクション実行結果を参照する場合や，アクション情報通知イベントを発行する場合は，参照したいアクション情報の容量を見積もって，"ACTIONINFSIZE"に設定しておく必要があります。

アクション情報ファイルの容量見積もりの詳細については，JP1/IM - Managerのリリースノートを参照してください。

アクション情報ファイル容量をデフォルト値に設定した場合は，65,535アクション分の情報を参照できます。

"EVENTALIVEPERIOD"=dword:16進数値

ANDイベント保管期限を，分単位で指定します。

1〜1,440（分）の16進数値で指定します。デフォルト値は「dword:0000003c」（60分）です。

"ACTIONEXECUSER"="JP1ユーザー名"

アクション実行標準ユーザーとしてJP1ユーザーを指定します。

15バイトまでの文字列で指定します。デフォルト値は""（なし）です。指定がない場合は，jp1adminが仮定されます。

自動アクションの定義で，実行ユーザーを指定しなかった場合は，ここで定義したJP1ユーザーでアクションを実行します。

"ACTIONDEFFILE"="ファイル名"

自動アクション定義ファイル名を指定します。

デフォルトで"actdef.conf"が指定されています。この値は変更せずに使用してください。

この自動アクション定義ファイルで，自動アクション機能によってアクションを実行する条件および実行するコマンドを定義します。

"HOSTINEVENT"="{remote | local}"

イベント発行元ホスト名取得方法を指定します。

"remote"または"local"のどちらかを指定します。デフォルト値は"remote"です。

"remote"を指定した場合は，イベント属性中の「発行元イベントサーバ名」をイベント発行元ホスト名として使用します。

"local"を指定した場合は，JP1/IM - Manager上でイベント属性中の「発行元IPアドレス」がIPv6アドレスのとき，getnameinfoを利用して求めたホスト名を，イベント発行元ホスト名として使用します。「発行元IPアドレス」がIPv4アドレスのとき，gethostbyaddrを利用して求めたホスト名を，イベント発行元ホスト名として使用します。ホスト名が求められなかった場合は，IPアドレスをイベント発行元ホスト名として使用します。

注意事項

"local"を指定した場合，DNSの問合せなどでアクションのマッチング処理に時間がかかることがあります。

"ACTIONINFFILE"="ファイル名"

アクション情報ファイル名を指定します。

デフォルトで"actinf.log"が指定されています。この値は変更せずに使用してください。

"ACTIONLIMIT"=dword:16進数値

コマンド先行入力数を指定します。

自動アクションの実行先ホストでJP1/Base 06-51以前を使用する場合に，実行先ホストのコマンド先行入力数を指定します。指定できる値は，「dword:00000001〜00000040」（1〜64件）です。デフォルト値は「dword:0000000a」（10件）です。

なお，自動アクションの実行先ホストでJP1/Base 06-71以降を使用する場合は，コマンド先行入力数は，実行先ホストのJP1/Baseで設定します。この場合，コマンド先行入力数は，実行先ホストでjcocmddefコマンドを使用して設定してください。デフォルト値は1,024件です。

詳細については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「14.7.6　コマンド実行環境の検討」を参照してください。

"SENDABLE_EVENT"="イベントID"

自動アクション発行イベント（イベントIDが20A0，20A1，20A2，20A3，および20A4のJP1イベント）を指定します。

指定できるのは20A0，20A1，20A2，20A3，20A4で，複数指定する場合は半角スペースで区切ります。

デフォルト値は"20A0 20A3 20A4"です。

JP1イベントの詳細については，「3.2.2　JP1/IM - Managerが出力するJP1イベントの詳細」を参照してください。

"REGEXP"="{JP1|EXTENDED}"

使用する正規表現の種類を指定します。

"JP1"または"EXTENDED"のどちらかを指定します。デフォルト値は"EXTENDED"です。

"JP1"を指定すると，JP1独自正規表現，"EXTENDED"を指定すると拡張正規表現が自動アクションの定義で使用できます。

なお，このパラメーターはWindows限定のパラメーターで，UNIXの場合指定する必要はありません。

"ACTIONPRIORITY"="{DEFAULT|V8COMPATIBLE}"

アクションの優先順位を指定します。

"DEFAULT"または"V8COMPATIBLE"のどちらかを指定します。大文字・小文字を区別します。

パラメーターが存在しない場合は"V8COMPATIBLE"で動作します。

JP1/IM - Managerを新規インストールした場合，"DEFAULT"が設定されます。

JP1/IM - Managerをバージョン8以前からバージョンアップした場合，ACTIONPRIORITYパラメーターは設定されません。

"DEFAULT"を指定すると，同一パラメーターのアクション定義が複数指定された場合，自動アクション定義ファイルの記述順で先頭行に近いアクション定義を優先します。

"V8COMPATIBLE"を指定すると，JP1/IM - Managerのバージョンが09-00より前の自動アクション機能と同じ優先順位となります。つまり，同一パラメーターのアクション定義が複数指定された場合，「イベントIDを指定したアクション定義」を「すべてのイベントを対象としたアクション定義」より優先し，次に自動アクション定義ファイルの記述順で先頭行に近いアクション定義を優先します。

[論理ホスト名¥JP1CONSOLEMANAGER¥LOG_CONTROL¥JCAMAIN]

自動アクションログ定義のキー名称です。

"論理ホスト名"の部分を，物理ホストの場合はJP1_DEFAULTに，論理ホストの場合は論理ホスト名に設定します。

"LOGSIZE"=dword:16進数値

自動アクショントレースログ（1ファイル）の最大サイズ値を指定します。

65,536〜104,857,600バイト（64キロバイト〜100メガバイト）の16進数値で指定します。単位はバイトです。デフォルト値は「dword:00500000」（5,242,880バイト（5メガバイト））です。

デフォルト値の場合，実行するコマンドの最大長が100バイトのアクションを3000コマンド実行したときでもラップアラウンドしない値です。ログサイズを変更する場合は，JP1/IM - Managerのリリースノートを参照してログサイズを見積もってください。

定義例

[JP1_DEFAULT¥JP1CONSOLEMANAGER¥ACTION]
"ACTIONINFSIZE"=dword:00001000
"EVENTALIVEPERIOD"=dword:0000003c
"ACTIONEXECUSER"="JP1USER"
"ACTIONDEFFILE"="actdef.conf"
"HOSTINEVENT"="remote"
"ACTIONINFFILE"="actinf.log"
"SENDABLE_EVENT"="20A0 20A3 20A4"
"REGEXP"="JP1"

[JP1_DEFAULT¥JP1CONSOLEMANAGER¥LOG_CONTROL¥JCAMAIN]
"LOGSIZE"=dword:00100000

ファイルの終端が最下行の先頭になるようにしてください。

自動アクション定義ファイル（actdef.conf）

形式

[#自動アクション定義ファイルバージョン]
[DESC_VERSION=バージョン情報]

[#自動アクション状態監視パラメーター]
cmn
    [sta {true|false}]
end-cmn

[#自動アクション定義パラメーター]
act アクション名
    [prm パラメーターグループ]
    [cmt コメント]
    aid アクションID
    [valid true|false]
    eid イベントID

    cnd
        イベント条件
    end-cnd

    [usr ユーザー名]
    [hst {実行ホスト名|グループ名|業務グループ名|監視グループ名}]
    [cmd アクション]
    [var 環境変数ファイル名]

    [det 抑止時間]
    [ret 遅延監視時間]
end-act

ファイル

actdef.conf（自動アクション定義ファイル）

actdef.conf.model（自動アクション定義ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Consoleパス¥conf¥action¥

論理ホストのとき

共有フォルダ¥jp1cons¥conf¥action¥

UNIXの場合

物理ホストのとき

/etc/opt/jp1cons/conf/action/

論理ホストのとき

共有ディレクトリ/jp1cons/conf/action/

説明

JP1/IMの自動アクション機能で，アクションを実行する条件と，アクションとして実行するコマンドについて定義するファイルです。このファイルは，JP1/IM - Managerの動作する言語コードで記述してください。

自動アクション定義ファイルの最大サイズは，22（23,068,672バイト）メガバイトです。

自動アクション機能はファイルの定義に従い，特定の条件を満たすJP1イベントを受信した時に，自動的にコマンドを実行します。

各行のアクションの定義をパラメーターといいます。自動アクション定義ファイルのパラメーターには，次の3種類があります。

自動アクション定義ファイルバージョン

自動アクション定義ファイルのフォーマットのバージョンを定義します。

自動アクション状態監視パラメーター（共通ブロック）

共通ブロック内では，cmnのパラメーターが指定でき，自動アクションの状態を監視するかどうかを定義します。

自動アクション定義パラメーター（アクションブロック）

アクションブロック内にはprmやcmtなどのパラメーターが指定でき，アクションを実行する条件と，アクションとして実行するコマンドについて定義します。

自動アクション定義ファイルバージョンおよび自動アクション状態監視パラメーターは，自動アクション定義パラメーターの前に記述してください。自動アクション定義パラメーターの後ろに，自動アクション定義ファイルバージョンおよび自動アクション状態監視パラメーターを記述した場合，定義内容は無効になります。

また，自動アクション定義ファイルバージョンおよび自動アクション状態監視パラメーターを，複数回定義した場合，最初の定義を有効，2回目以降の定義を無効とします。

定義の記述

パラメーターの各単語は，半角スペースまたはタブで区切ります。

各行の先頭のパラメーター名の前の半角スペース，タブは無視されます。

「#」で始まる行は，コメントになります。ただし「#」の前に文字列が入っている場合は，コメント行として扱いません。

アクション定義で設定できるパラメーター名は，小文字で指定してください。大文字を含むパラメーター名を指定した場合，無効なパラメーターとして定義エラーとなります。

アクションの優先度

受信したJP1イベントが，複数の自動アクション定義の実行条件と一致する場合，（後述するパラメーターグループごとに）最も優先順位の高い自動アクションが一つだけ実行されます。自動アクションの優先順位は，次の規則によって決まります。

自動アクション定義ファイルで前に記述されている（GUIでは［アクション設定］の画面で上に表示されている）自動アクションが優先されます。

アクションの優先度は，共通定義で変更できます。自動アクションの優先順位については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「6.3.2　実行条件の優先度」を参照してください。

パラメーターグループとAND条件

それぞれの自動アクション定義パラメーターは，パラメーターグループに属します。パラメーターグループとは，自動アクション実行の条件を判定する単位です。パラメーターグループによって，一つのJP1イベントで複数のアクションを実行する場合や，複数の条件を満たすときにアクションを実行する場合など，複雑な条件を指定できます。

一つのJP1イベントがJP1/IMのマネージャーホストに届くと，パラメーターグループごとに，優先順位の順に自動アクション定義パラメーターと実行条件を比較します。実行条件が一致する場合は，パラメーターグループごとに優先順位の最も高い自動アクション定義パラメーターが一つだけ実行されます。

パラメーターグループに「&」を指定すると，前の行に定義した自動アクション定義パラメーターとのAND条件となります。自動アクション定義パラメーターをAND条件として指定すると，すべての条件が満たされたときにアクションが実行されます。

指定内容の確認

作成した定義ファイルは，jcamakeaコマンドを使って定義ファイルの定義内容を確認してください。

定義の反映時期

自動アクションの定義は，JP1/IM - Managerの起動時，JP1/IM - Viewの［アクション設定］画面の［適用］ボタンをクリックして定義を有効にしたとき，またはjcachangeコマンドを実行して定義を再読み込みしたときに有効になります。

jcachangeコマンドを実行して定義を再読み込みする場合は，jcachangeコマンドを実行する前にjcamakeaコマンドを実行して定義に誤りがないことを確認してください。

記述内容（自動アクション定義ファイルバージョン）

自動アクション定義ファイルバージョンに記述する項目について説明します。

DESC_VERSION=バージョン情報

自動アクション定義ファイルのフォーマットのバージョンを定義します。この定義は，自動アクション定義ファイルの先頭行（空行，コメント行を除いた行のうちファイルのはじめに記述された行）に記載します。先頭行以外に記載した場合，定義エラーとなります。

表2‒13　自動アクション定義ファイルのフォーマットのバージョン情報

バージョン情報

説明

1

07-11〜07-51の自動アクション定義ファイルのバージョンを示す。

2

08-00〜08-50の自動アクション定義ファイルのバージョンを示す。

3

09-00〜11-10の自動アクション定義ファイルのバージョンを示す。

4

11-50以降の自動アクション定義ファイルのバージョンを示す。

このパラメーターを省略，または「1」を指定した場合は，バージョン情報を「2」と仮定して読み込みます。JP1/IM - Viewで［アクション設定］画面の［適用］ボタンをクリックしたとき，「2」に設定し直します。

このパラメーターに「1」，「2」，「3」，または「4」以外の値を指定した場合，統合トレースログにエラーが出力され，バージョン情報を「3」と仮定して読み込みます。このとき，JP1/IM - Viewで［アクション設定］画面は表示できません。バージョン情報を変更したい場合は，直接定義ファイルを編集してください。

旧バージョンの自動アクション定義ファイルのフォーマットは，08-00以降の自動アクション定義ファイルのフォーマットと互換性があるため，08-00以降のフォーマットとして読み込まれます。

このパラメーターが自動アクション定義パラメーター以降の行に記述されている場合，JP1/IM - Viewで［アクション設定］画面が表示できなくなります。

jcamakeaコマンドを実行して自動アクションの定義ファイルの内容をチェックすることをお勧めします。

記述内容（自動アクション状態監視パラメーター）

自動アクション状態監視パラメーターに記述する項目について説明します。

cmn 〜 end-cmn

すべてのアクション定義に有効なパラメーターを指定するブロックの開始と終了パラメーターです。cmn 〜 end-cmnで定義している部分を共通ブロックと呼びます。このブロックは，「自動アクション定義パラメーター」の前に指定する必要があります。なお，このパラメーターは，自動アクション定義ファイルに一つだけ指定します。なお，このブロックは，省略できます。省略した場合は，staパラメーターはfalseを仮定します。

sta {true|false}

アクションの状態を監視するかどうかを指定します。

「true」または「false」のどちらかを指定します。状態監視する場合は「true」，状態監視しない場合は「false」です。デフォルト値は「false」です。

記述内容（自動アクション定義パラメーター）

自動アクション定義パラメーターに記述する各項目について説明します。

act アクション名 〜 end-act

自動アクション定義の開始と終了パラメーターです。act 〜 end-act間で定義する件数に制限はありません。ただし，一つ以上定義する必要があります。act アクション名 〜 end-actで定義している部分をアクションブロックと呼びます。

actのあとにはアクション名を，1〜50バイトの文字列で指定します。指定できる文字は，制御文字（0x00〜0x1F，0x7F〜0x9F）以外の文字列です。

アクション名は，ほかのアクションブロックで指定したアクション名と重複できません。アクションブロックで指定できるパラメーターを次に示します。

prm，cmt，eid，cnd 〜 end-cnd，usr，hst，cmd，var，det，ret，aid，valid

prm パラメーターグループ

パラメーターグループを指定します。このパラメーターを省略した場合，「0」を仮定します。

パラメーターグループは，1けたの数字（0〜9）および「&」で指定できます。1けたの数字（0〜9）を指定した場合，アクション名は省略できません。「&」を指定すると，直前のアクションブロックとのAND条件の指定になります。この場合，このアクションブロックの自動アクション定義パラメーターが属するパラメーターグループは，直前のアクションブロックと同じになります。「&」を指定している場合は，アクション名を指定できません。

「&」を指定していないアクションブロックのあとに，AND条件のアクションブロックを最大9件（最初のアクションブロックを含めて10件）指定できます。

同一のパラメーターグループでは，アクションブロックで前に記述されている（GUIでは［アクション設定］の画面で上に表示されている）アクションブロックが優先します。一つのJP1イベントがマネージャーに届くと，パラメーターグループごとに，優先順位の順にアクションブロックのイベント条件とマッチングします。イベント条件が一致する場合は，パラメーターグループごとに優先順位の最も高いアクションブロックのアクションを実行し，実行したアクションブロック以降のアクションブロックはマッチングしません。また，パラメーターグループの小さいものから大きいものの順番にイベントとマッチングを実施します。自動アクションの優先順位については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「6.3.2　実行条件の優先度」を参照してください。

cmt コメント

アクションブロックの説明を記述します。このパラメーターは省略できます。コメントは1,040バイト以内で指定してください。指定できる文字は，すべての文字です。1,040バイトを超えた分は削除されます。

aid アクションID

アクションIDを指定します。このパラメーターは省略できません。アクションIDに指定できる範囲は0〜2,147,483,647です。ただし，パラメーターグループに&を指定する場合は，指定できません。

バージョン情報が4の場合だけ，このパラメーターを指定できます。

valid true|false

自動アクション定義を有効（true）または無効（false）に設定します。このパラメーターは省略できます。省略した場合，有効（true）を仮定します。ただし，パラメーターグループに&を指定する場合は，指定できません。パラメーターグループに&を指定する場合の有効，無効は，一つ前のアクション実行条件に従います。

バージョン情報が4の場合だけ，このパラメーターを指定できます。

eid イベントID

アクション条件のイベントIDを指定します。このパラメーターは省略できません。また，複数指定はできません。

イベントIDは，基本部および拡張部から構成されます。イベントIDは，1〜8桁の16進数で指定し，基本部および拡張部は「:」（半角コロン）で区切って指定します。英大文字・英小文字を区別しません。なお，拡張部は省略できます。任意のイベントIDを指定する場合は，「*」で指定します。「*」を指定するとすべてのイベントをアクションの対象にするため，JP1イベントの発生頻度が大きい場合にアクションが大量に発生し，実行が遅延することがあります。「*」を指定する場合は，その他の条件（メッセージ，イベント基本情報，イベント詳細情報，イベント拡張情報）でイベントを絞り込んでください。

指定例を次に示します。

例）イベントID Aを指定する場合，次のように指定します。

eid a

eid A

eid 0000000a

eid 0000000A

eid 0000000A:0

eid 0000000A:00000000

例）任意のイベントIDを指定する場合，次のように指定します。

eid *

cnd イベント条件 〜 end-cnd

アクションを実行するイベント条件を指定するブロックの開始と終了パラメーターです。イベント条件ブロックは省略できません。イベント条件ブロックは，アクションブロック内に一つだけ指定します。イベント条件ブロックには，0〜256件のイベント条件を指定できます。それぞれのイベント条件は，AND条件となります。

イベント条件

イベント条件は，次の形式で指定します（△は半角スペースを表す）。

　属性名△比較キーワード△オペランド[△オペランド]…

なお，半角スペース，または，タブだけで構成された行は，無視して処理を続行します。

属性名

属性名には，比較したい属性の名称を記述します。基本属性を指定する場合は，名称の前に「B.」を付けます。拡張属性（共通情報），拡張属性（固有情報）を指定する場合は，名称の前に「E.」を付けます。英大文字・英小文字を区別します。

比較キーワード

比較キーワードには，「BEGIN（から始まる）」，「IN（と一致する）」，「NOTIN（と一致しない）」，「SUBSTR（を含む）」，「NOTSUBSTR（を含まない）」，「REGEX（正規表現）」のどれか一つを指定できます。英大文字・英小文字を区別します。

オペランド

比較キーワードで属性値と比較する値を文字列で指定します。英大文字・英小文字を区別します。

オペランドを複数指定する場合は，一つ以上の連続した半角スペースまたはタブをオペランドとオペランドの間に挿入して区切ります。オペランドとオペランドは，OR条件となります。ただし，正規表現を指定している場合は，複数指定できません。

オペランドに，半角スペース，タブ，改行コード（CR，LF）および%を指定したい場合，次のように記述します。

項番

指定したい値

指定方法

1

タブ（0x09）

%09

2

半角スペース（0x20）

%20

3

%（0x25）

%25

4

改行コード LF（0x0a）

%0a

5

改行コード CR（0x0d）

%0d

%のあとに指定する文字コードは，英大文字・英小文字を区別しません。JP1正規表現を使用する場合，「%0d」は指定できません。複数選択した場合の定義例「IDが100と200に一致する」を示します。

B.ID△IN△100△200

（凡例）　△：半角スペース（0x20）

オペランドは，イベント条件1件当たり4,096バイトまで，イベント条件ブロック1件当たり4,096バイト（イベント条件ブロックに記述したオペランドの合計バイト数）まで指定できます。

イベント基本情報

属性名にB.BASICを指定すると，自動アクション定義ファイル（互換用）のイベント基本情報と同じ条件を設定できます。

属性名にB.BASICを指定した場合は，比較キーワードにはREGEXを指定してください。

オペランドは，自動アクション定義ファイル（互換用）のイベント基本情報と同じ形式で指定できます。ただし，半角スペース，タブ，改行（CR，LF），%は，%を使って記述してください。また，「/」は，「/」と記述してください。「¥/」と記述する必要はありません。

イベント詳細情報

属性名にB.DETAILを指定すると，自動アクション定義ファイル（互換用）のイベント詳細情報と同じ条件を設定できます。

属性名にB.DETAILを指定した場合は，比較キーワードにはREGEXを指定してください。

オペランドは，自動アクション定義ファイル（互換用）のイベント詳細情報と同じ形式で指定できます。ただし，半角スペース，タブ，改行(CR，LF)，%は，%を使って記述してください。また，「/」は，「/」と記述してください。「¥/」と記述する必要はありません。

イベント条件で指定できる属性名，比較キーワードおよびオペランドについて次の表に示します。

表2‒14　イベント条件で指定できる属性名，比較キーワードおよびオペランド

項番

項目

属性名

比較キーワード

オペランド

1

イベントID

B.ID

一致する

一致しない

正規表現

イベントIDを指定する。

複数指定できる。複数指定では最大100件指定できる。ただし，正規表現では複数指定はできない。

一致する，一致しないの場合は，イベントIDの大文字，小文字は区別しない。

指定できる範囲は0〜7FFFFFFFである。

正規表現の場合は，比較するイベントのイベントIDを，次の形式と見なして比較する。

・イベントID拡張部が0の場合：

イベントID基本部（16進数8桁の英大文字または数字の文字列）

・イベントID拡張部が0でない場合：

イベントID基本部（16進数8桁の英大文字または数字の文字列）:イベントID拡張部（16進数8桁の英大文字または数字の文字列）

イベントID基本部またはイベントID拡張部は，8桁未満の値であった場合は先頭を0で埋め，8桁の文字列とする。

2

発行元プロセスID

B.PROCESSID

一致する

一致しない

正規表現

発行元APのプロセスIDを指定する。

複数指定できる。複数指定では最大100件指定できる。ただし，正規表現では複数指定はできない。

指定できる範囲は，-2,147,483,648〜2,147,483,647である。

3

登録時刻

B.TIME

正規表現

JP1イベントが発行元ホストのイベントDBに登録された時刻を指定する。

設定方法はYYYYMMDDhhmmssの形式で正規表現で指定する。

4

到着時刻

B.ARRIVEDTIME

正規表現

JP1イベントが発行元ホストのイベントDBに到着した時刻を指定する。

設定方法はYYYYMMDDhhmmssの形式で正規表現で指定する。

5

発行元ユーザーID

B.USERID

一致する

一致しない

正規表現

発行元プロセスのユーザーID（数値）を設定する。

複数指定できる。複数指定では最大100件指定できる。ただし，正規表現では複数指定はできない。

指定できる範囲は，-2,147,483,648〜2,147,483,647である。

6

発行元グループID

B.GROUPID

一致する

一致しない

正規表現

発行元プロセスのグループID（数値）を設定する。

複数指定できる。複数指定では最大100件指定できる。ただし，正規表現では複数指定はできない。

指定できる範囲は，-2,147,483,648〜2,147,483,647である。

7

発行元ユーザー名

B.USERNAME

一致する

一致しない

含む

含まない

から始まる

正規表現

発行元プロセスのユーザー名を指定する。

複数指定できる。複数指定では最大100件指定できる。ただし，正規表現では複数指定はできない。

8

発行元グループ名

B.GROUPNAME

一致する

一致しない

含む

含まない

から始まる

正規表現

発行元プロセスのグループ名を指定する。

複数指定できる。複数指定では最大100件指定できる。ただし，正規表現では複数指定はできない。

9

発行元IPアドレス

B.SOURCEIPADDR

一致する

一致しない

含む

含まない

から始まる

正規表現

発行元イベントサーバに対応するIPアドレスを指定する。

複数指定できる。複数指定では最大100件指定できる。ただし，正規表現では複数指定はできない。

IPv6アドレスを指定する場合は，次に示すとおり，0〜9およびa〜fの4桁の16進数で指定する。英字部分は，英小文字で指定する。

（例）0011:2233:4455:6677:8899:aabb:ccdd:eeff

英字部分を英大文字にしたり，IPv4射影アドレス，IPv4互換アドレス，およびIPv6アドレスの省略形式を指定したりはできない。

10

発行元イベントサーバ名(登録ホスト名)※

B.SOURCESERVER

一致する

一致しない

含む

含まない

から始まる

正規表現

JP1イベントが発生したホストのホスト名（イベントサーバ名）を指定する。

複数指定できる。複数指定では最大100件指定できる。ただし，正規表現では複数指定はできない。

11

メッセージ

B.MESSAGE

一致する

一致しない

含む

含まない

から始まる

正規表現

イベント基本属性のメッセージを設定する。

複数指定できる。複数指定では最大100件指定できる。ただし，正規表現では複数指定はできない。

12

イベント詳細情報

B.DETAIL

一致する

一致しない

含む

含まない

から始まる

正規表現

イベント基本属性の詳細情報を設定する。

複数指定できる。複数指定では最大100件指定できる。ただし，正規表現では複数指定はできない。

JP1イベントの詳細情報にバイナリー形式のデータが設定されている場合，JP1イベントの詳細情報を空文字""（0バイト）として比較する。

互換用として使用できる。

13

登録要因

B.REASON

一致する

一致しない

登録要因を設定する。

複数指定できる。複数指定では最大100件指定できる。

14

開始時刻

E.START_TIME

正規表現

実行開始または再実行開始の時刻を設定する。

複数指定はできない。

通算秒の正規表現指定で設定する。

15

終了時刻

E.END_TIME

正規表現

実行終了の時刻を設定する。

複数指定はできない。

通算秒の正規表現指定で設定する。

16

プロダクト名

E.PRODUCT_NAME

一致する

一致しない

含む

含まない

から始まる

正規表現

JP1イベントを発行したプロダクトの名称を指定する。

複数指定できる。複数指定では最大100件指定できる。ただし，正規表現では複数指定はできない。

17

オブジェクトタイプ

E.OBJECT_TYPE

一致する

一致しない

含む

含まない

から始まる

正規表現

オブジェクトの種類を設定する。

複数指定できる。複数指定では最大100件指定できる。ただし，正規表現では複数指定はできない。

18

オブジェクト名

E.OBJECT_NAME

一致する

一致しない

含む

含まない

から始まる

正規表現

JP1イベントのオブジェクト名を指定する。

複数指定できる。複数指定では最大100件指定できる。ただし，正規表現では複数指定はできない。

19

登録名タイプ

E.ROOT_OBJECT_TYPE

一致する

一致しない

含む

含まない

から始まる

正規表現

JP1イベントの登録名タイプを指定する。

複数指定できる。複数指定では最大100件指定できる。ただし，正規表現では複数指定はできない。

20

登録名

E.ROOT_OBJECT_NAME

一致する

一致しない

含む

含まない

から始まる

正規表現

JP1イベントの登録名を指定する。

複数指定できる。複数指定では最大100件指定できる。ただし，正規表現では複数指定はできない。

21

オブジェクトID

E.OBJECT_ID

一致する

一致しない

含む

含まない

から始まる

正規表現

JP1イベントのオブジェクトIDを指定する。

複数指定できる。複数指定では最大100件指定できる。ただし，正規表現では複数指定はできない。

22

事象種別

E.OCCURRENCE

一致する

一致しない

含む

含まない

から始まる

正規表現

JP1イベントの事象種別を指定する。

複数指定できる。複数指定では最大100件指定できる。ただし，正規表現では複数指定はできない。

23

ユーザー名

E.USER_NAME

一致する

一致しない

含む

含まない

から始まる

正規表現

JP1イベントを発行したユーザー名を指定する。

複数指定できる。複数指定では最大100件指定できる。ただし，正規表現では複数指定はできない。

24

終了コード

E.RESULT_CODE

一致する

一致しない

含む

含まない

から始まる

正規表現

終了コードを設定する。

複数指定できる。複数指定では最大100件指定できる。ただし，正規表現では複数指定はできない。

25

重大度

E.SEVERITY

一致する

正規表現

JP1イベントの重大度を指定する。

"Emergency"（緊急），"Alert"（警戒），"Critical"（致命的），"Error"（エラー），"Warning"（警告），"Notice"（通知），"Information"（情報），"Debug"（デバッグ）の中から指定する。

複数指定できる。ただし，正規表現では複数指定はできない。

26

発生元ホスト名※

E.JP1_SOURCEHOST

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

JP1イベントの発生元ホスト名を指定する。

複数指定できる。複数指定では最大100件指定できる。ただし，正規表現では複数指定はできない。

27

イベント基本情報

B.BASIC

正規表現

バージョン8以前の互換用のイベント基本情報を設定できる。

28

固有の拡張属性

−

一致する

一致しない

含む

含まない

から始まる

正規表現

固有の拡張属性の属性名を指定する。

属性名を先頭が英大文字で，英大文字，数字，およびアンダースコア（_）から構成される32バイトまでの名称を設定できる。

複数指定できる。複数指定では最大100件指定できる。ただし，正規表現では複数指定はできない。

（凡例）

−：なし

注※

統合監視DBおよびIM構成管理DBが有効な場合に，比較キーワードが，「と一致する」「と一致しない」のとき，パス表記で業務グループ名を指定できます。

統合監視DBおよびIM構成管理DBが無効な場合，および［と一致する］［と一致しない］以外を選択した場合，パス表記で業務グループ名を指定しても，ホスト名として扱われます。

また，jcoimdefコマンドの-ignorecasehostオプションの指定を「ON」にしている場合に，比較キーワードで［正規表現］以外を選択すると，文字列の英大文字・英小文字を区別しません。

usr ユーザー名

アクションを実行するJP1ユーザー名を指定します。usrパラメーターは省略できます。省略した場合，自動アクションの実行環境の定義で，アクション実行標準ユーザーとして指定したJP1ユーザー名を仮定します。アクション実行標準ユーザーも指定されていない場合は，jp1adminを使用します。

ユーザー名に指定できる文字数は，1〜31バイトです。半角英数字だけを使用できます。英字は大文字・小文字を区別しません。また，ユーザー名には，変数を指定できます。受信したJP1イベントに含まれる情報をユーザー名に設定したい場合は，変数を指定します。

ユーザー名にはイベントの情報を設定できます。

アクションを実行するとき，実行先ホストで，ここで指定したJP1ユーザーをJP1/Baseの定義に従ってOSユーザーにユーザーマッピングしてコマンドを実行します。UNIXの場合は，ユーザーマッピングしたOSユーザーのシェル環境を使用して実行します。

hst {実行ホスト名|グループ名|業務グループ名|監視グループ名}

アクションを実行するホスト名，ホストグループ名，業務グループ名，および監視グループ名を指定します。ホスト名にはシステム構成の定義で管理対象ホストに設定したホスト名を指定します。hstパラメーターは省略できます。省略した場合，自ホストを仮定します。

実行ホスト名，ホストグループ名は，255バイト以内の文字列で指定します。実行ホスト名，ホストグループ名に半角スペースを含むものは指定できません。また，実行ホスト名，またはホストグループ名には，変数を指定できます。受信したJP1イベントに含まれる情報を実行ホスト名，またはホストグループ名に設定したい場合は，変数を指定します。例えば，イベント発行元のホストでアクションを実行したい場合は，「$EVHOST」と指定します。

実行ホスト名，ホストグループ名にはイベントの情報を設定できます。

業務グループ名，監視グループ名には，最大2,048バイトの文字列を指定できます。指定された文字列が「/」で始まる場合は，業務グループ名，監視グループ名と見なします。ただし，統合監視DBおよびIM構成管理DBが無効な場合は，ホスト名またはホストグループ名と見なします。

cmd アクション

アクションとして実行するコマンドを指定します。 指定できるコマンドについては，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「6.　自動アクションによるコマンド実行（JP1/Base連携）」を参照してください。

cmdパラメーターは省略できます。省略した場合，アクションを実行する条件が成立しても，何も実行しません。

ただし，次のパラメーターのどれかを指定した場合，cmdパラメーターを省略すると定義エラーとなります。

usr，var，hst，det，ret

また，cmdパラメーターは，複数指定できません。アクションは，4,096バイト以内の文字列で指定します。アクションの前のタブ・スペースは削除し，アクションの後ろのスペースは削除しません。

アクションにはイベントの情報を設定できます。

なお，変数を使うことで受信したJP1イベントに含まれる情報を指定できます。例えば，実行ホストがUNIXの場合，次のように記述すると，JP1イベントのイベント発行元ホスト名を環境変数HOSTNAMEに指定できます。

HOSTNAME="$EVHOST" アクション

　xxx_BASIC="$EVBASE" xxx_MESSAGE="$EVMSG" アクション

アクションのコマンド長に関する注意事項

アクションとして実行できるコマンドの長さは，アクション定義で使用できる変数（$EVMSGなど）の変換後の情報を含めて，4,096バイトまでです。コマンドの長さが4,096バイトを超えた場合は実行状態が「実行不可」になり，コマンドは実行されません。［アクション結果詳細］画面の［メッセージ］欄には，KAVB4421-Wのメッセージが表示されます。

アクションとして実行できるコマンドの長さは，JP1/IM - Manager，JP1/Baseを運用しているシステムによって変わります。

自動アクションの実行経路上のホスト（実行元マネージャーホスト，実行先ホストを含む）にバージョン6，バージョン7のJP1/IM - Manager，JP1/Baseがある場合には，コマンドの長さは，最大1,024バイトに抑える必要があります。コマンド長に関する注意事項の詳細については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「13.4.1　自動アクションを検討するときの注意事項」を参照してください。

アクション中の文字として認識できないコードについての注意事項

アクション中に，文字として認識できないコード（ASCIIコードおよび環境設定で指定したマルチバイト文字コードの文字集合に含まれない部分）が含まれた場合，実行先ホストのシェルなどの仕様で実行されない，または実行されても結果が不正になることがあります。この場合，アクションは実行失敗にならず，終了状態になります。定義ファイル中に上記の不正なコードを指定していなくても，アクション定義で使用できる変数から実行時に置き換えることでアクションに含まれる場合があります。アクション対象イベントを発行する各製品のマニュアルなどで確認し，アクション定義で使用できる変数を指定してください。

var 環境変数ファイル名

アクションとして実行するコマンドの環境変数を指定した環境変数ファイルのファイル名をフルパスで指定します。このパラメーターは省略できます。省略した場合，環境変数ファイルは仮定されません。環境変数ファイルの形式については，マニュアル「JP1/Base 運用ガイド」を参照してください。

環境変数ファイル名は，255バイト以内の文字列で指定します。環境変数ファイル名にはイベントの情報を設定できます。また，環境変数ファイル名には，変数を指定できます。受信したJP1イベントに含まれる情報を環境変数ファイル名に設定したい場合は，変数を指定します。例えば，ENVFILEという名称のJP1イベント拡張属性を環境変数ファイル名として設定したい場合は，「$EV"ENVFILE"」と指定します。

環境変数ファイル名の前後のスペースは削除しません。varの後ろにある1文字のタブ・スペースだけ削除します。

det 抑止時間

アクションを抑止する時間を指定します。このパラメーターで指定した時間内に発生した同一のアクション条件に対するアクションは抑止されます。このパラメーターは省略できます。省略した場合，アクションは抑止されません。抑止時間に指定できる範囲は1〜3,600（秒）です。パラメーターグループに「&」を指定している場合はこのパラメーターは指定できません。AND条件を使用する場合は，AND条件の最初に定義する自動アクション定義パラメーターに指定してください。

ret 遅延監視時間

アクションの実行時間を監視する時間を指定します。このパラメーターで指定した時間が，マネージャー上のJP1/BaseにJP1イベントが到着してから，実行先ホストのコマンド制御アクション実行終了メッセージを受信するまでの時間を超過した場合，JP1イベントの発行やコマンドの実行などの方法で，アクションに遅延が発生していることを通知します。このパラメーターは省略できます。省略した場合，アクションの遅延監視をしません。遅延監視時間に指定できる範囲は1〜86,400（秒）です。

#コメント行

#で始まる行は，コメント扱いとなります。なお，JP1/IM - Viewからアクション定義を設定した場合，#のコメント行は削除されます。

アクション定義で使用できる変数

自動アクション定義パラメーターの定義のうち，usr，var，hst，cmdパラメーターには，変数を使って，JP1イベントに含まれる情報を指定できます。

アクション実行時に，変数がJP1イベント中の情報に変換されて実行されます。

変数を自動アクション定義パラメーターに記述する場合は，「$EVID」のような形式で指定します。なお，「$」を文字列として扱いたい場合は，エスケープ文字「¥」を「$」の前に指定してください。

使用できる変数を次に示します。

表2‒15　アクション定義で使用できる変数

情報の種類

変数名

内容

JP1イベント基本属性に含まれる情報

EVBASE

イベント基本情報全体※1

EVID

イベントID（基本コード:拡張コード）

EVIDBASE

イベントID（基本コード）

EVDATE

イベント登録日（YYYY/MM/DD）※2

EVTIME

イベント登録時刻（hh:mm:ss）※2

EVPID

イベント発行元プロセスID

EVUSRID

イベント発行元プロセスのユーザーID

EVGRPID

イベント発行元プロセスのグループID

EVUSR

イベント発行元ユーザー名

EVGRP

イベント発行元グループ名

EVHOST

イベント発行元ホスト名

EVIPADDR

イベント発行元IPアドレス

EVSEQNO

イベントDB内通し番号

EVARVDATE

イベント到着日（YYYY/MM/DD）※2

EVARVTIME

イベント到着時刻（hh:mm:ss）※2

EVSRCNO

イベント発生元のイベントDB内通し番号

EVMSG

メッセージテキスト全体※3

EVDETAIL

イベント詳細情報全体※3，※4

JP1イベント拡張属性に含まれる情報

EVSEV

イベント拡張情報重大度（Emergency, Alert, Critical, Error, Warning, Notice, Information, Debug）※3

EVUSNAM

ユーザー名※3

EVOBTYP

オブジェクトタイプ※3

EVOBNAM

オブジェクト名※3

EVROBTYP

登録タイプ※3

EVROBNAM

登録名※3

EV"PRODUCT_NAME"

プロダクト名※5

EV"OBJECT_ID"

オブジェクトID※5

EV"OCCURRENCE"

事象種別※5

EV"START_TIME"

開始時刻※5

EV"END_TIME"

終了時刻※5

EV"RESULT_CODE"

終了コード※5

EV"JP1_SOURCEHOST"

発生ホスト名※5

EV"拡張属性名"

任意の拡張属性※5

その他

EV"@JP1IM_CORRELATE"

相関イベントフラグ

相関イベントではない：0

相関成立イベントである：1

相関不成立イベント：2

EV"@JP1IM_ORIGINAL_SEVERITY"

イベント拡張情報重大度(変更前)

（Emergency, Alert, Critical, Error, Warning, Notice, Information, Debug）※3

EV"@JP1IM_CHANGE_SEVERITY"

重大度変更フラグ

重大度を変更していない：0

重大度を変更した：1

EV"@JP1IM_DISPLAY_MESSAGE"

メッセージ(変更後)

EV"@JP1IM_CHANGE_MESSAGE"

表示メッセージ変更フラグ

メッセージを変更していない：0

メッセージを変更した：1

ACTHOST

アクション実行要求元マネージャーホスト名※3

EVENV1〜EVENV9

アクションの実行条件の指定で，正規表現中に"( )"を指定して切り出したデータ※5

（マネージャーホストで拡張正規表現を使用している場合だけ使用できる）

注※1　JP1イベントの基本情報が次の形式に変換されてアクションに渡されます（△は半角スペース）。

イベントID△イベント発行元ユーザー名△イベント発行元ユーザーID△イベント発行元グループ名△イベント発行元グループID△イベント発行元イベントサーバ名△イベント発行元プロセスID△イベント登録年月日△イベント登録時刻△イベント発行元ホストIPアドレス

設定されていない項目は空文字となります。

注※2　JP1/IM - Managerのタイムゾーンで変換してアクションに渡されます。

注※3　該当する属性が存在しない場合，アクション実行時に変数が空文字に変換されてアクションに渡されます。

注※4　JP1イベントの詳細属性の情報がバイナリー形式の場合は，変数が空文字に変換されてアクションに渡されます。

注※5　該当する属性が存在しない場合，変数の文字列がそのままアクションに渡されます。

また，JP1イベントの種類によっては，変数自体のないものや，各属性に含まれる情報に文字として認識できないコード（ASCIIコードおよび環境設定で指定したマルチバイト文字コードの文字集合に含まれない部分）が含まれていることで，アクションが実行できない，または実行されても結果が不正になる場合があります。また，JP1イベント発行元の制限によってJP1イベント中の情報が途中で切れ，アクションが実行できない，または実行されても結果が不正になる場合があります。JP1イベント発行元製品のマニュアルなどを事前に参照し，属性値の情報を確認してから置き換え文字を設定してください。

イベント引き継ぎ情報のエンコーディング

アクションの実行内容に関する項目のうち「アクション」については，イベント引き継ぎ情報の値をURLエンコーディングしたり，Base64エンコーディングしたりできます。指定形式は，「$変数名$エンコーディングの種類」です。エンコーディングの種類の直後に半角英数字，または_（アンダースコア）を指定する場合は，「${変数名$エンコーディング種類}」の形式で指定してください。「$」を文字列として扱いたい場合は，エスケープ文字「¥」を「$」の前に指定してください。

次の場合，「$変数名$エンコーディングの種類」または「${変数名$エンコーディング種類}」は，文字列と見なされて変換されません。

「変数名」に該当するイベントが存在しない。

指定形式が誤っている。

イベント引き継ぎ情報のエンコーディングの種類と指定形式を次に示します。

表2‒16　イベント引き継ぎ情報のエンコーディングの種類と指定形式

項番

エンコーディングの種類

指定形式

説明

1

URLエンコーディング

$変数名$URLENC

イベント引き継ぎ情報の値をUTF-8の文字列としてURLエンコーディングします。

${変数名$URLENC}

2

Base64エンコーディング

$変数名$ENC

イベント引き継ぎ情報の値をBase64エンコーディングします。

${変数名$ENC}

3

Base64コーディングとURLコーディングの両方

$変数名$ENC$URLENC

イベント引き継ぎ情報の値をBase64エンコーディングし，さらにURLエンコーディングします。

${変数名$ENC$URLENC}

4

エンコーディングしない

$変数名

URLエンコーディングもBase64エンコーディングもしない。

${変数名}

変数の記述での注意点

変数の直後に文字を記述する場合，変数の直後に英数字および「_」を指定すると正しく変換されません。このような場合は，変数を｛｝で囲んでください。次に指定例を示します。なお，次の例では，イベントID（$EVID）は100:0，拡張属性EX（$EV"EX"）はABCが設定されていると仮定します。

（指定例）

アクション定義 → 変換後の情報

「$EVID abc」 →「100:0 abc」

「$EVIDabc」 →「$EVIDabc」(Windowsの場合)，なし(UNIXの場合)

「${EVID}abc」 →「100:0abc」

「$EVID_abc」 →「$EVID_abc」(Windowsの場合)，なし(UNIXの場合)

「${EVID}_abc」→「100:0_abc」

「$EV"EX" abc」→「ABC abc」

「$EV"EX"abc」 →「ABCabc」

変換元の文字情報に，次に示す制御文字が含まれていた場合，その制御文字は半角スペース（0x20）に変換されて処理されます。

半角スペースに変換される制御文字：0x01〜0x1F（タブ（0x09）を除く），0x7F

例えば，$EVMSGの指定によって取得したメッセージの中に改行コード（0x0A）が含まれていた場合，改行コード（0x0A）は半角スペース（0x20）に変換されて処理されます。

（例）アクション（echo $EVMSG）を設定し，イベントのメッセージとして改行コードを含む文字列"1行目 0x0A 2行目"を受信した場合には，アクションとして実行されるコマンドは "echo 1行目△2行目"となります（△は半角スペースを表す）。

「$」は「¥」を直前に指定することで，文字として扱われます。ただし，ファイルパスなどで「¥」に続いて変数を指定したい場合は，「¥」が変換されて，文字列として扱われません。この場合の回避方法を，次に示します。

実行コマンドに指定する場合

変数を引数に指定したバッチファイルを作成します。「¥」を使用するコマンドラインの組み立ては，バッチファイル内で指定します。

実行コマンドの指定例：

・実行コマンド：AppTest.bat $ACTHOST

・バッチファイル：application.exe c:¥work¥%1¥result.txt

この例では，「%1」に「$ACTHOST」を変換した値が設定されます。

変数をファイルパスに使用する場合

変数に任意のプリフィックスを付けます。

「EV"PRODUCT_NAME"」に「IM-VIEW」が設定されている場合の例を，変換できる場合とできない場合に分けて次に示します。

変数を変換できない例：

・指定例：C:¥$EV"PRODUCT_NAME"

・変換結果：C:$EV"PRODUCT_NAME"

この例では，「¥$」が指定されているため，「EV"PRODUCT_NAME"」が変換されません。

変数を変換できる例：

・指定例：C:¥pre_$EV"PRODUCT_NAME"

・変換結果：C:¥pre_IM-VIEW

この例では，「pre_」を変数の前に付けることで，「EV"PRODUCT_NAME"」が変換されます。

UNIXの場合，最終的な展開はシェルの解釈に依存します。展開後のデータに「*」など，シェルで特別な意味を持つ文字がある場合，その内容に置き換えられます。置き換えられないようにするには，変数全体を「"」で囲み，「"$EVMSG"」のように記述してください。

変数で指定されたJP1イベントの情報に「"」や「'」など，コマンドで特別な意味を持つ文字がある場合，コマンドが正しく解釈されないときがあります。イベント引き継ぎ情報変換設定ファイルで文字変換することをお勧めします。イベント引き継ぎ情報変換設定ファイルの詳細については，「イベント引き継ぎ情報変換設定ファイル（event_info_replace.conf）」（2.　定義ファイル）を参照してください。

アクション定義での正規表現

自動アクションの定義で，イベント監視条件にJP1イベントの属性（メッセージテキスト・基本属性・詳細情報）を正規表現で指定する場合の指定方法について説明します。

使用できる正規表現は，OSによって異なります。Windowsの場合とUNIXの場合に分けて，使用できる正規表現を説明します。

複数のOSでアクション定義を共用する場合，正規表現の解釈が異なるので，どのOSでも使用できる表現で条件を記述するように注意してください。なお，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「付録G　正規表現」に各OS共通で使用できる正規表現を記載しています。これを参考にして使用する正規表現を決めてください。

Windows版の正規表現

Windows版では，使用できる正規表現をJP1独自の正規表現，拡張正規表現のどちらかにできます。デフォルトは拡張正規表現です。JP1独自の正規表現にする場合は，「自動アクション環境定義ファイル（action.conf.update）」（2.　定義ファイル）を参照して設定してください。

UNIX版の正規表現

UNIX版では「拡張正規表現」を使用します。使用できる正規表現の詳細については，OS提供の「regexp（5）」を参照してください。

正規表現に関する注意事項

自動アクションの正規表現は部分一致のため，先頭および末尾に「.*」を指定した場合と，先頭および末尾に「.*」を指定しない場合は同じ条件になります。

例えば，次の例1と，例2は同じ条件になります。

（例1）「A001△:△WEBサーバ」を含む文字列の場合に一致する正規表現

.*A001△:△WEBサーバ.*

（例2）「A001△:△WEBサーバ」を含む文字列の場合に一致する正規表現

A001△:△WEBサーバ

先頭および末尾に「.*」を指定した場合，検索に時間が掛かることがあるので，先頭および末尾に「.*」は指定しないでください。

正規表現を使用していて，次に示すどちらかに一致している場合，jcamakeaコマンドを実行した際にKAVB5759-Wメッセージが表示されます。

正規表現として，先頭または末尾に「.*」が指定されている

正規表現として，「.*」が連続して指定されている

KAVB5759-Wメッセージの詳細については，マニュアル「JP1/Integrated Management 3 - Manager メッセージ」を参照してください。

定義例

自動アクション定義ファイルの定義例を次に示します。なお，定義例は，正規表現の種別に拡張正規表現を指定しています。

定義例1：変数を使用した例1

変数を使用して受信したJP1イベントの情報を，アクションとして実行するコマンドの引数に指定する場合の定義例を次に示します。

イベント条件

イベントID（B.ID）が「00000001」

メッセージの形式が「メッセージID※△:△メッセージ本文」

注※　メッセージIDは，英字1文字と3けたの数字。

アクションとして実行するコマンド

alarm.bat△引数1△引数2

コマンドの引数に指定するJP1イベントの情報

引数1：メッセージの値（変数には，${EVMSG}を指定）

引数2：拡張属性AAAの値（変数には，${EV"AAA"}を指定）

受信したJP1イベントのメッセージ（B.MESSAGE）の値が「A001△:△WEBサーバーがダウンしました。」，拡張属性AAAの値が「kanshi」の場合，「alarm.bat△"kanshi"△"A001△:△WEBサーバーがダウンしました。"」というアクションを実行します。

定義例2：変数を使用した例2

変数「EVENV1」〜「EVENV9」を使用して受信したJP1イベントの情報の一部を，アクションとして実行するコマンドの引数に指定する場合の定義例を次に示します。

イベント条件

イベントID（B.ID）が「00000001」

メッセージの形式が「メッセージID※△:△メッセージ本文」

注※　メッセージIDは，英字1文字と3けたの数字。

アクションとして実行するコマンド

alarm.bat△引数1△引数2

コマンドの引数に指定するJP1イベントの情報

引数1：メッセージのメッセージIDの値（変数には，${EVENV1}を指定）

引数2：メッセージのメッセージ本文の値（変数には，${EVENV2}を指定）

受信したJP1イベントのメッセージ（B.MESSAGE）の値が「A001△:△WEBサーバーがダウンしました。」の場合，「alarm.bat△"A001"△"WEBサーバーがダウンしました。"」というアクションを実行します。

定義例3：イベントIDを正規表現で指定した例1

イベント条件の属性名に「B.ID」，比較キーワードに「REGEX」を指定する場合の定義例を次に示します。

イベント条件

イベントIDが00000001〜00000200（16進数のA〜Fの文字は含めない）

発行元イベントサーバ名（B.SOURCESERVER）が「kanshi」

アクションとして実行するコマンド

alarm.bat

イベント条件でイベントIDを指定する場合は，イベント条件で指定しているイベントIDが対象となるように，eidに「*」を指定してください。

定義例4：イベントIDを正規表現で指定した例2

イベント条件の属性名に「B.BASIC」を指定すると，自動アクション定義ファイル（互換用）のイベント基本情報と同じ形式で条件を設定できます。

イベント条件の属性名に「B.BASIC」，比較キーワードに「REGEX」を指定する場合の定義例を次に示します。

イベント条件

イベントIDが00000001〜00000200（16進数のA〜Fの文字は含めない）

発行元イベントサーバ名（B.SOURCESERVER）が「kanshi」

アクションとして実行するコマンド

alarm.bat

タブ，半角スペース，%，および改行コードの指定方法が自動アクション定義ファイル（互換用）と異なります。詳細については，「自動アクション定義ファイル（actdef.conf）（互換用）」（2.　定義ファイル）を参照してください。

定義例5：AND条件を使用した例

イベントAおよびイベントBを受信した場合にアクションを実行するように指定するときの定義例を次に示します。

イベントAの条件

イベントID（B.ID）が「00000201」

メッセージ（B.MESSAGE）が「WEBサーバーAがダウンしました。」

イベントBの条件

イベントID（B.ID）が「00000202」

メッセージ（B.MESSAGE）が「WEBサーバーBがダウンしました。」

アクションとして実行するコマンド

alarm.bat

AND条件を使用する場合は，相関イベント発行機能を使った自動アクションをお勧めします。相関イベント発行機能は，AND条件では考慮できない，JP1イベントの順序や件数を指定できます。相関イベントについては，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「4.3　相関イベントの発行」を参照してください。

自動アクション定義ファイル（actdef.conf）（互換用）

形式

[#自動アクション定義ファイルバージョン]
[DESC_VERSION=バージョン情報]

[#自動アクション状態監視パラメーター]
△₀[：state_watch={true | false}]

[#自動アクション定義パラメーター]
△₀[ {+パラメーターグループ番号|&}△₁] {$イベントID|*}△₁
[/メッセージ/] [,[/イベント基本情報/] [,[/イベント詳細情報/]
[,[/イベント拡張情報重大度/] ] ] ]△₁[イベント拡張情報属性名=/属性値/
[,イベント拡張情報属性名2=/属性値/][,…] ]△₀
: △₀[u=ユーザー名△₁] [e=環境変数ファイル名△₁]
[d=実行先ホスト名|グループ名△₁] [dt=抑止時間△₁]
[rt=遅延監視時間△₁] [アクション]
   ：

ファイル

actdef.conf（自動アクション定義ファイル）（互換用）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Consoleパス¥conf¥action¥

論理ホストのとき

共有フォルダ¥jp1cons¥conf¥action¥

UNIXの場合

物理ホストのとき

/etc/opt/jp1cons/conf/action/

論理ホストのとき

共有ディレクトリ/jp1cons/conf/action/

説明

JP1/IMの自動アクション機能で，アクションを実行する条件と，アクションとして実行するコマンドについて定義するファイルです。このファイルは，JP1/IM - Managerの動作する言語コードで記述してください。

自動アクション機能はこのファイルの定義に従い，特定の条件を満たすJP1イベントを受信した時に，自動的にコマンドを実行します。

各行のアクションの定義をパラメーターといいます。自動アクション定義ファイルのパラメーターには，次の3種類があります。

自動アクション定義ファイルバージョン

自動アクション定義ファイルのフォーマットのバージョンを定義します。

自動アクション状態監視パラメーター

自動アクションの状態を監視するかどうかを定義します。

自動アクション定義パラメーター

アクションを実行する条件と，アクションとして実行するコマンドについて定義します。

自動アクション定義ファイルバージョンおよび自動アクション状態監視パラメーターは，自動アクション定義パラメーターの前に記述してください。自動アクション定義パラメーターの後ろに，自動アクション定義ファイルバージョンおよび自動アクション状態監視パラメーターを記述した場合，定義内容は無効になります。

また，自動アクション定義ファイルバージョンおよび自動アクション状態監視パラメーターを，複数回定義した場合，最初の定義を有効，2回目以降の定義を無効とします。

定義の記述

自動アクション状態監視パラメーターおよび自動アクション定義パラメーターは，定義を１行に１件ずつ定義します。１行に書ききれない場合は，次の行に継続できます。

自動アクション定義パラメーターでは，「:」で区切られた二つの部分により「イベント監視条件：アクション実行定義」という形式で指定します。

一つの自動アクション定義パラメーターの最大長は，5,706バイトです。

バイト数には，空白を含みます。改行コードと，継続行にする場合の「¥」は含みません。

自動アクション定義パラメーターが長いときは，次の行に継続できます。

定義行を継続するときは，改行コードの直前に「¥」を記述します。「¥」と改行コードの間に空白など文字がある場合は継続行にならず，「¥」はデータとして扱います。

1カラム目が「#」の行はコメントになります。

コメントは1行で記述してください。複数行のコメントは，GUIで定義したときに定義行の直前の1行目以外が破棄されます。なお，行の途中や継続行の中の「#」はコメントではなくデータとして扱います。

イベント監視条件の優先度

受信したJP1イベントが，複数の自動アクション定義の実行条件と一致する場合，（後述するパラメーターグループごとに）最も優先順位の高い自動アクションが一つだけ実行されます。自動アクションの優先順位は，次の規則によって決まります。

イベントIDを指定した自動アクションは，イベントIDの「すべて」を対象にする自動アクションが優先されます。

自動アクション定義ファイルで前に記述されている（GUIでは［アクション設定］の画面で上に表示されている）自動アクションが優先されます。

パラメーターグループとAND条件

それぞれの自動アクション定義パラメーターは，パラメーターグループに属します。パラメーターグループとは，自動アクション実行の条件を判定する単位です。パラメーターグループによって，一つのJP1イベントで複数のアクションを実行する場合や，複数の条件を満たすときにアクションを実行する場合など，複雑な条件を指定できます。

一つのJP1イベントがJP1/IMのマネージャーに届くと，パラメーターグループごとに，優先順位の順に自動アクション定義パラメーターと実行条件と比較します。実行条件が一致する場合は，パラメーターグループごとに優先順位の最も高い自動アクション定義パラメーターが一つだけ実行されます。

パラメーターグループに「&」を指定すると，前の行に定義した自動アクション定義パラメーターとのAND条件となります。自動アクション定義パラメーターをAND条件として指定すると，すべての条件が満たされたときにアクションが実行されます。

自動アクション定義パラメーターのサイズチェック

自動アクション定義パラメーターでサイズチェックされる項目とその最大長を次に示します。

自動アクション定義パラメーターのサイズは5,706バイトまで。

自動アクション定義パラメーターのイベント監視条件のサイズは1,040バイトまで。

自動アクション定義パラメーターのアクションのサイズは4,096バイトまで。

最大長を超過した場合は，定義を反映するときにメッセージが表示され，該当する自動アクション定義パラメーターは無視されます。

指定内容の確認

作成した定義ファイルは，jcamakeaコマンドを使って定義ファイルの定義内容を確認してください。

自動アクション定義ファイル（actdef.conf）（互換用）では業務グループ名を使用できません。業務グループ名を指定した場合，ホスト名として扱われます。

定義の反映時期

自動アクションの定義は，JP1/IM - Managerの起動時，JP1/IM - Viewの［アクション設定］画面の［適用］ボタンをクリックして定義を有効にしたとき，またはjcachangeコマンドを実行して定義を再読み込みしたときに有効になります。

jcachangeコマンドを実行して定義を再読み込みする場合は，jcachangeコマンドを実行する前にjcamakeaコマンドを実行して定義に誤りがないことを確認してください。

記述内容（自動アクション定義ファイルバージョン）

自動アクション定義ファイルバージョンに記述する項目について説明します。

DESC_VERSION=バージョン情報

自動アクション定義ファイルのフォーマットのバージョンを定義します。

表2‒17　自動アクション定義ファイルのフォーマットのバージョン情報

バージョン情報

説明

1

07-11〜07-51の自動アクション定義ファイルのバージョンを示す。

2

08-00以降の自動アクション定義ファイルのバージョンを示す。

3

09-00以降の自動アクション定義ファイルのバージョンを示す。

4

11-50以降の自動アクション定義ファイルのバージョンを示す。

このパラメーターを省略，または「1」に指定した場合は，バージョン情報を「2」と仮定して読み込みます。JP1/IM - Viewで［アクション設定］画面の［適用］ボタンをクリックしたとき，「2」に設定し直します。

このパラメーターに「1」，「2」，「3」，または「4」以外の値を指定した場合，統合トレースログにエラーが出力され，バージョン情報を「3」と仮定して読み込みます。このとき，JP1/IM - Viewで［アクション設定］画面は表示できません。バージョン情報を変更したい場合は，直接定義ファイルを編集してください。

旧バージョンの自動アクション定義ファイルのフォーマットは，08-00以降の自動アクション定義ファイルのフォーマットと互換性があるため，08-00以降のフォーマットとして読み込まれます。

このパラメーターが自動アクション定義パラメーター以降の行に記述されている場合，JP1/IM - Viewで［アクション設定］画面が表示できなくなります。

jcamakeaコマンドを実行して自動アクションの定義ファイルの内容をチェックすることをお勧めします。

記述内容（自動アクション状態監視パラメーター）

自動アクション状態監視パラメーターに記述する項目について説明します。

state_watch={true | false}

アクションの状態を監視するかどうかを指定します。

「true」または「false」のどちらかを指定します。デフォルト値は「false」です。

「true」を指定した場合，バージョン07-10以前のJP1/IM - Viewで［アクション設定］画面を表示できません。

このパラメーターは，自動アクション定義パラメーターより前に記述されている場合にだけ有効となります。

このパラメーターが自動アクション定義パラメーター以降の行に記述されている場合，JP1/IM - Viewで［アクション設定］画面が表示できなくなります。

jcamakeaコマンドを実行して自動アクションの定義ファイルの内容をチェックすることをお勧めします。

バージョン07-11以降のJP1/IM - Viewが07-11以降のJP1/IM - Manager（セントラルコンソール）に接続している場合，アクションの状態を監視する・しないにかかわらず，自動アクション状態監視パラメーターは自動アクション定義ファイルに出力されます。

記述内容（自動アクション定義パラメーター）

自動アクション定義パラメーターに記述する各項目について説明します。なお，JP1イベントについては，「3.　JP1イベント」を参照してください。また，定義中に指定する正規表現と変数については，後述します。

イベント監視条件

自動アクション定義パラメーターの中で，実行条件として記述する項目を次に示します。実行条件として定義できるパラメーターの長さは1,040バイトまでです。

{+パラメーターグループ番号|&}

この行の自動アクション定義パラメーターが属しているパラメーターグループの番号を，「+」に続けて1けたの数字（0〜9）で指定します。指定を省略すると「0」を仮定します。

「&」を指定すると，直前の定義行とのAND条件の指定になります。この場合，この行の自動アクション定義パラメーターが属するパラメーターグループは，直前の定義行と同じになります。

なお，パラメーターグループの数字の大小は，実行条件判定の優先順位およびアクションの実行順序とは関係ありません。

$イベントID

イベントIDを「$」に続けて指定します。イベントIDの指定形式は次のとおりです。

　基本部[:拡張部]

基本部および拡張部は，16進数8桁以内（0〜7fffffff）の範囲で指定します。英字は小文字だけを指定できます。

*

すべてのイベントIDを対象にする場合に指定します。*を指定するとすべてのイベントをアクションの対象にするため，JP1イベントの発生頻度が大きい場合にアクションが大量に発生し，実行が遅延することがあります。*を指定する場合は，その他の条件（メッセージ，イベント基本情報，イベント詳細情報，イベント拡張情報）でイベントを絞り込んでください。

メッセージ

実行条件として，JP1イベントのメッセージテキストを指定します。条件には，正規表現を使うことができます。正規表現で指定する場合は，メッセージテキストの制御コード以外の部分を記述するようにしてください。

正規表現で「/」を表す場合は，「¥/」と記述してください。

イベント基本情報

実行条件として，JP1イベント基本属性の情報を指定します。指定には，正規表現を使うことができます。

正規表現で「/」を表す場合は，「¥/」と記述してください。正規表現の詳細については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「付録G　正規表現」を参照してください。

イベント基本情報は，JP1イベント基本属性の情報を次のように並べた形式で渡されます。この形式にあわせて，アクションを実行する条件を指定してください。

イベントID△イベント発行元ユーザー名△イベント発行元ユーザーID△

イベント発行元グループ名△イベント発行元グループID△

イベント発行元イベントサーバ名△イベント発行元プロセスID△

イベント登録年月日△イベント登録時刻△イベント発行元ホストIPアドレス

これらのJP1イベントの基本属性に含まれる情報については，「3.　JP1イベント」を参照してください。

イベント詳細情報

実行条件として，JP1イベント基本属性の詳細属性の情報を指定します。

指定には，正規表現を使うことができます。

正規表現で「/」を表す場合は，「¥/」と記述してください。正規表現の詳細については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「付録G　正規表現」を参照してください。

JP1イベント基本属性の詳細属性の情報は，JP1イベントの付加的な情報で，内容や形式はJP1イベントによって異なります。なお，JP1イベントの詳細属性の情報がバイナリー形式の場合は，情報がない（NULL）として扱われます。

・備考：JP1イベント基本属性の詳細属性は，主にバージョン5以前のJP1/SES形式と互換のイベントを発行する製品が，詳細情報を記録する場合などに使われます。バージョン6以降の製品の多くは，JP1イベント拡張属性を使って詳細な情報を記録します。

イベント拡張情報重大度

実行条件として，JP1イベント拡張属性の重大度を指定します。重大度は次の形式で，文字の部分を組み合わせて指定します。

　「-------E」　重大度：Emergency

　「------A-」　重大度：Alert

　「-----C--」　重大度：Critical

　「----E---」　重大度：Error

　「---W----」　重大度：Warning

　「--N-----」　重大度：Notice

　「-I------」　重大度：Information

　「D-------」　重大度：Debug

例えば，Error以上の重大度を条件として設定する場合は，/----ECAE/と指定します。

イベント拡張情報属性名=/属性値/

実行条件として，JP1イベント拡張属性の属性名と属性値を組み合わせて指定します。指定には，正規表現を使うことができます。

正規表現で「/」を表す場合は，「¥/」と記述してください。

属性名と属性値の組み合わせを，最大100組指定できます。

属性名は，英大文字，数字，およびアンダースコア（_）から構成される32バイトまでの名称を指定できます。属性名に「:」「=」を含むものは指定できません。属性名は，"PRODUCT_NAME"，"OBJECT_NAME"のように指定します。ほかの機能での設定とは異なり，属性名の先頭に"E."は付けません。

なお，この項目で重大度（項目名"SEVERITY"）を指定する場合，属性値は"Emergency"，"Alert"などの文字列で指定します。

アクション実行定義

自動アクション定義パラメーターの中で，アクション実行定義として設定する項目を次に示します。

u=ユーザー名

アクションを実行するJP1ユーザー名を指定します。

ユーザー名に指定できる文字数は，1〜31バイトです。半角英数字だけを使用できます。英字は大文字・小文字を区別しません。

このパラメーターを指定しなかった場合は，自動アクションの実行環境の定義で，アクション実行標準ユーザーとして指定したJP1ユーザー名を使用します。アクション実行標準ユーザーも指定されていない場合は，jp1adminを使用します。

JP1ユーザー名は，変数を使って，受信したJP1イベントに含まれる情報により指定することもできます。

アクションを実行するとき，実行先ホストで，ここで指定したJP1ユーザーをJP1/Baseの定義に従ってOSユーザーにユーザーマッピングしてコマンドを実行します。UNIXの場合は，ユーザーマッピングしたOSユーザーのシェル環境を使用して実行されます。

e=環境変数ファイル名

アクションとして実行するコマンドの環境変数を指定した，環境変数ファイルのファイル名をフルパスで指定します。

ファイル名には，255バイトまでの文字列が指定できます。ファイル名に空白を含む場合は""で囲んで指定してください。

ファイル名は，変数を使って，受信したJP1イベントに含まれる情報により指定することもできます。例えば，ENVFILEという名称のJP1イベント拡張属性を環境変数ファイル名として使う場合は「$EV"ENVFILE"」と指定します。

なお，環境変数ファイルの形式については，マニュアル「JP1/Base 運用ガイド」を参照してください。

d=実行先ホスト名|グループ名

アクションを実行するホスト名，またはホストグループ名を指定します。ホスト名にはシステム構成の定義で管理対象ホストに設定したホスト名を指定します。ホスト名・グループ名に空白を含むものは指定できません。

このパラメーターを省略した場合，アクションは自ホスト（自動アクション定義ファイルのあるホスト）で実行されます。

ホスト名・グループ名は，変数を使って，受信したJP1イベントに含まれる情報により指定することもできます。例えば，イベント発行元のホストでアクションを実行したい場合は，「$EVHOST」と指定します。

dt=抑止時間

アクションを抑止する時間を指定します。このパラメーターで指定した時間内に発生した同一のアクション条件に対するアクションは抑止されます。このパラメーターを省略した場合，抑止は実行されません。抑止時間は，4バイトまでの数字で指定します。指定できる範囲は1〜3,600（秒）です。

このパラメーターを指定した場合，バージョン07-10以前のJP1/IM - Viewで［アクション設定］画面を表示できません。

なお，次の場合は，このパラメーターは指定できません。

・「&」を指定している場合

rt=遅延監視時間

アクションの実行時間を監視する時間を指定します。このパラメーターで指定した時間が，マネージャー上のJP1/BaseにJP1イベントが到着してから，実行先ホストのコマンド制御アクション実行終了メッセージを受信するまでの時間を超過した場合，JP1イベントの発行やコマンドの実行などの方法で，アクションに遅延が発生していることを通知します。このパラメーターを省略した場合，アクションの遅延監視は実行されません。

遅延監視時間は，5バイトまでの数字で指定します。指定できる範囲は1〜86,400（秒）です。

このパラメーターを指定した場合，バージョン07-10以前のJP1/IM - Viewで［アクション設定］画面を表示できません。

アクション

アクションとして実行するコマンドを指定します。

指定できるコマンドについては，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「6.　自動アクションによるコマンド実行（JP1/Base連携）」を参照してください。

このパラメーターを省略した場合，アクションを実行する条件が成立しても，何も実行しません。

コマンドのパラメーターに，変数を使って，受信したJP1イベントに含まれる情報により指定することもできます。

自動アクションが定義されているホストがUNIXの場合は，コマンドの環境変数に，変数を使って，受信したJP1イベントに含まれる情報により指定することもできます。この場合は「MESSAGE="$EVMSG" command arg1 arg2」のように指定します。

なお，自動アクション定義パラメーターの「:」以降は，実行するアクションを指定しますが，「u=」「e=」「d=」「dt=」「rt=」を指定すると前述のユーザー名などの項目と見なされます。「u=」などを指定した場合は，アクションの指定を省略するとエラーになります。

また，アクションとして実行できるコマンドの長さは，アクション定義で使用できる変数（$EVMSG など）の変換後の情報を含めて，4,096バイトまでです。コマンドの長さが4,096バイトを超えた場合は実行状態が「実行不可」になり，コマンドは実行されません。［アクション結果詳細］画面の［メッセージ］欄には，KAVB4421-Wのメッセージが表示されます。

アクション中に，文字として認識できないコード（ASCIIコードおよび環境設定で指定したマルチバイト文字コードの文字集合に含まれない部分）が含まれた場合，実行先ホストのシェルなどの仕様で実行されない，または実行されても結果が不正になることがあります。この場合，アクションは実行失敗にならず，終了状態になります。定義ファイル中に上記の不正なコードを指定していなくても，アクション定義で使用できる変数から実行時に置き換えることでアクションに含まれる場合があります。アクション対象イベントを発行する各製品のマニュアルなどで確認の上，アクション定義で使用できる変数を指定してください。

アクションのコマンド長に関する注意事項

アクションとして実行できるコマンドの長さは，JP1/IM，JP1/Baseを運用しているシステムによって変わります。

自動アクションの実行経路上のホスト（実行元マネージャー，実行先ホストを含む）にバージョン6，バージョン7のJP1/IM，JP1/Baseがある場合には，コマンドの長さは，最大1,024バイトに抑える必要があります。コマンド長に関する注意事項の詳細については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「13.4.1　自動アクションを検討するときの注意事項」を参照してください。

アクション定義で使用できる変数

自動アクション定義パラメーターの定義のうち，実行するアクションの指定（:以降の指定）には，変数を使って，JP1イベントに含まれる情報を指定できます。アクション実行時に，変数がJP1イベント中の情報に変換されて実行されます。

変数を自動アクション定義パラメーターに記述する場合は，「$EVID」のような形式で指定します。

使用できる変数を次に示します。

表2‒18　アクション定義で使用できる変数

情報の種類

変数名

内容

JP1イベント基本属性に含まれる情報

EVBASE

イベント基本情報全体

EVID

イベントID（基本コード:拡張コード）

EVDATE

イベント発生日（YYYY/MM/DD）

EVTIME

イベント発生時刻（hh:mm:ss）

EVPID

イベント発行元プロセスID

EVUSRID

イベント発行元プロセスのユーザーID

EVGRPID

イベント発行元プロセスのグループID

EVUSR

イベント発行元ユーザー名

EVGRP

イベント発行元グループ名

EVHOST

イベント発行元ホスト名

EVIPADDR

イベント発行元IPアドレス

EVSEQNO

イベントDB内通し番号

EVARVDATE

イベント到着日（YYYY/MM/DD）

EVARVTIME

イベント到着時刻（hh:mm:ss）

EVSRCNO

イベント発生元のイベントDB内通し番号

EVMSG

メッセージテキスト全体

EVDETAIL

イベント詳細情報全体

JP1イベント拡張属性に含まれる情報

EVSEV

イベント拡張情報重大度（Emergency, Alert, Critical, Error, Warning, Notice, Information, Debug）

EV"拡張属性名"

任意の拡張属性

その他

ACTHOST

アクション実行要求元マネージャー名

EVENV1〜EVENV9

アクションの実行条件の指定で，正規表現中に"( )"を指定して切り出したデータ

（マネージャーで拡張正規表現を使用している場合だけ使用できる）

該当しない項目の変数の値はNULLになります。また，JP1イベントの種類によっては，変数自体のないものや，各属性に含まれる情報に文字として認識できないコード（ASCIIコードおよび環境設定で指定したマルチバイト文字コードの文字集合に含まれない部分）が含まれていることで，アクションが実行できない，または実行されても結果が不正になる場合があります。JP1イベント発行元製品のマニュアルなどを事前に参照し，設定してください。

変数の記述での注意点

変数の直後に文字を記述する場合，変数の直後に英数字および「_ 」を指定すると正しく変換されません。このような場合は，変数を｛｝で囲んでください。次に指定例を示します。なお，次の例では，イベントID（$EVID）は100:0，拡張属性EX（$EV"EX"）はABCが設定されていると仮定します。

（指定例）

アクション定義 → 変換後の情報

「$EVID abc」 →「100:0 abc」

「$EVIDabc」 →「$EVIDabc」(Windowsの場合)，なし(UNIXの場合)

「${EVID}abc」 →「100:0abc」

「$EVID_abc」 →「$EVID_abc」(Windowsの場合)，なし(UNIXの場合)

「${EVID}_abc」→「100:0_abc」

「$EV"EX" abc」→「ABC abc」

「$EV"EX"abc」 →「ABCabc」

変換元の文字情報に，次に示す制御文字が含まれていた場合，その制御文字は半角スペース（0x20）に変換されて処理されます。

半角スペースに変換される制御文字：0x01〜0x1F（タブ(0x09)を除く），0x7F

例えば，$EVMSGの指定によって取得したメッセージの中に改行コード（0x0A）が含まれていた場合，改行コード（0x0A）は半角スペース（0x20）に変換されて処理されます。

（例）アクション（echo $EVMSG）を設定し，イベントのメッセージとして改行コードを含む文字列"1行目 0x0A 2行目"を受信した場合には，アクションとして実行されるコマンドは "echo 1行目△2行目"となります（△は半角スペースを表す）。

UNIXの場合，最終的な展開はシェルの解釈に依存します。展開後のデータに「*」など，シェルで特別な意味を持つ文字がある場合，その内容に置き換えられます。置き換えをしないようにするには，変数全体を「"」で囲み，「"$EVMSG"」のように記述してください。

変数で指定されたJP1イベントの情報に「"」や「'」など，コマンドで特別な意味を持つ文字がある場合，コマンドが正しく解釈されないときがあります。イベント引き継ぎ情報変換設定ファイルで文字変換することをお勧めします。イベント引き継ぎ情報変換設定ファイルの詳細については，「イベント引き継ぎ情報変換設定ファイル（event_info_replace.conf）」（2.　定義ファイル）を参照してください。

アクション定義での正規表現

自動アクションの定義で，イベント監視条件にJP1イベントの属性（メッセージテキスト・基本属性・詳細情報）を正規表現で指定する場合の指定方法について説明します。

使用できる正規表現は，OSによって異なります。Windowsの場合とUNIXの場合に分けて，使用できる正規表現を説明します。

複数のOSでアクション定義を共用する場合，正規表現の解釈が異なるので，どのOSでも使用できる表現で条件を記述するように注意してください。なお，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「付録G　正規表現」に各OS共通で使用できる正規表現を記載しています。これを参考にして使用する正規表現を決めてください。

Windows版の正規表現

Windows版では，使用できる正規表現をJP1独自の正規表現，拡張正規表現のどちらかにできます。デフォルトは拡張正規表現です。JP1独自の正規表現にする場合は，「自動アクション環境定義ファイル（action.conf.update）」（2.　定義ファイル）を参照して設定してください。

JP1/IMの自動アクションでは，OSの正規表現に加えて，次の拡張記法も使えます。

「¥/」，「¥¥」

ブラケット式中でも，それぞれただの「/」，「¥」を表します。正規表現で「/」，「¥」を表すときはすべてこの方法を使います。

UNIX版の正規表現

UNIX版では「拡張正規表現」を使用します。使用できる正規表現の詳細については，OS提供の「regexp（5）」を参照してください。

JP1/IMの自動アクションでは，OSの正規表現に加えて，次の拡張記法も使えます。

「¥/」，「¥¥」

ブラケット式中でも，それぞれただの「/」，「¥」を表します。正規表現で「/」，「¥」を表すときはすべてこの方法を使います。

正規表現による基本属性・詳細属性の指定

イベント監視条件に，JP1イベントの基本属性・詳細情報を正規表現で指定する場合の方法について説明します。

自動アクション定義パラメーターの中では，JP1イベントの基本属性は，次の形式で表されます。

イベントID※1△イベント発行元ユーザー名△イベント発行元ユーザーID△

イベント発行元グループ名△イベント発行元グループID△

イベント発行元イベントサーバ名※2△イベント発行元プロセスID△

イベント登録年月日※3△イベント登録時刻※4△イベント発行元ホストIPアドレス

注※1

イベントIDは「基本コード:拡張コード」という形式で表されます。基本コードおよび拡張コードは，ともに8けたの16進数（A〜Fは大文字）です。IDの前の0は省略されます。拡張コードが00000000の場合は，「基本コード:0」と表されます。

注※2

イベントサーバ名とホスト名が異なる場合，イベント発行元ホスト名の取得方法が「local」に設定されていると，イベントサーバ名ではなくホスト名となります。

注※3

「YYYY/MM/DD」という形式で表されます。

注※4

イベント登録時刻は「hh:mm:ss」という形式で表されます。

JP1イベントの詳細情報は，次の形式で表されます。

情報1△情報2△情報3△…△情報n△

注

プログラムによっては，この形式でない場合や，固定長のためマルチバイト文字の1バイト目しか含まれていないなど，文字として認識できないコードが混入している場合もあります。形式については各プログラムのマニュアルを参照してください。

基本属性，詳細情報とも，情報中の各項目は，空白文字で区切られます。

該当する情報がない場合は，NULLになり，前後の区切りの空白が連続して表されます。また，最後の項目のあとには，将来の機能拡張などで情報が追加されることがあるので注意してください。

次に，基本属性および詳細情報中の各項目の指定方法を説明します。

基本属性，および詳細情報の先頭の項目を指定する場合は，先頭文字列を意味する「^」を使用します。例えば，イベントIDが00003A80のJP1イベントを指定するには，次のように指定します。

「^3A80:0△.*△.*△.*△.*△.*△.*△.*△.*△.*$」

2番目以降の項目を指定する場合は，「.* 」（任意の文字列と空白を示す）を繰り返して，不要な項目をスキップします。例えば，イベント基本属性の6番目の項目であるイベント発行ホスト名を指定する場合は，「.* 」を5回繰り返し，次のように指定します。

「^.*△.*△.*△.*△.*△host01」

次に，イベント情報の指定例を示します。

（例1）JP1USERで始まるユーザー名のユーザーから送信されたJP1イベント

^.*△JP1USER[_A-Z0-9]+△.*△.*△.*△.*△.*△.*△.*△.*$

（例2）host01〜host05で発行されたJP1イベント（拡張正規表現を使用している場合）

^.*△.*△.*△.*△.*△host0[1-5]△.*△.*△.*△.*$

（例3）host02で8時0分から8時10分に登録されたJP1イベント（拡張正規表現を使用している場合）

^.*△.*△.*△.*△.*△host02△.*△.*△08:(10|0[0-9]).*△.*$

（例4）詳細情報の3番目の項目が「prn」で始まるJP1イベント

^.*△.*△prn.*$

注　詳細情報の形式は，JP1イベントを発行するプログラムのマニュアルなどでご確認ください。

正規表現に関する注意事項

JP1独自正規表現（Windows）を拡張して，拡張正規表現を使用する場合には，拡張による誤動作を防ぐため，定義済みの設定を見直し，拡張正規表現用に定義し直す必要があります。

制御コード（改行，タブなど）は，製品やOSによって扱いが異なることがあります。このため，メッセージに対する条件を正規表現で記述する場合は，制御コード以外の部分を記述するようにしてください。

正規表現で，すべての文字に一致する表現の「.*」を多用すると，検索に時間が掛かることがあります。長いメッセージなどに対して「.*」を使用する場合は，必要な個所にだけ「.*」を使用するようにしてください。

また，拡張正規表現を使用できる環境で，かつ，空白以外の文字に一致させたい場合には，「.*」の代わりに「[^ ]*」が使用できます。「[^ ]*」を使用した方が検索に掛かる時間を短縮できます。

自動アクションの正規表現は部分一致のため，先頭および末尾に「.*」を指定した場合と，先頭および末尾に「.*」を指定しない場合は同じ条件になります。

例えば，次の例1と，例2は同じ条件になります。

（例1）「A001△:△WEBサーバ」を含む文字列の場合に一致する正規表現

.*A001△:△WEBサーバ.*

（例2）「A001△:△WEBサーバ」を含む文字列の場合に一致する正規表現

A001△:△WEBサーバ

先頭および末尾に「.*」を指定した場合，検索に時間が掛かることがあるので，先頭および末尾に「.*」は指定しないでください。

特殊文字である縦線「|」はOR条件を表します。このOR条件を正規表現中に使用する際は，次のことに注意してください。

OR条件の縦線「|」は正規表現の中で優先度が低いため，OR条件がかかる範囲を明示的に指定する必要があります。範囲を指定しない場合，動作しない，または誤動作する原因になることがあります。OR条件の範囲は，条件がかかる範囲を丸括弧「()」で囲むことで指定できます。イベント発行元サーバ名の条件をOR条件にするときの指定例を次に示します。

（例）gyoumuまたはhostで発行されたJP1イベント

^.*△.*△.*△.*△.*△(gyoumu|host)△.*△.*△.*△.*$

定義例

自動アクション定義ファイルの定義例を次に示します。なお，定義例は，正規表現の種別に拡張正規表現を指定しています。

定義例1：変数を使用した例1

変数を使用して受信したJP1イベントの情報を，アクションとして実行するコマンドの引数に指定する場合の定義例を次に示します。

イベント条件

イベントID（B.ID）が「00000001」

メッセージの形式が「メッセージID※△:△メッセージ本文」

注※　メッセージIDは，英字1文字と3けたの数字。

アクションとして実行するコマンド

alarm.bat△引数1△引数2

コマンドの引数に指定するJP1イベントの情報

引数1：メッセージの値（変数には，${EVMSG}を指定）

引数2：拡張属性AAAの値（変数には，${EV"AAA"}を指定）

受信したJP1イベントのメッセージ（B.MESSAGE）の値が「A001△:△WEBサーバーがダウンしました。」，拡張属性AAAの値が「kanshi」の場合，「alarm.bat△"kanshi"△"A001△:△WEBサーバーがダウンしました。"」というアクションを実行します。

定義例2：変数を使用した例2

変数「EVENV1」〜「EVENV9」を使用して受信したJP1イベントの情報の一部を，アクションとして実行するコマンドの引数に指定する場合の定義例を次に示します。

イベント条件

イベントID（B.ID）が「00000001」

メッセージの形式が「メッセージID※△:△メッセージ本文」

注※　メッセージIDは，英字1文字と3けたの数字。

アクションとして実行するコマンド

alarm.bat△引数1△引数2

コマンドの引数に指定するJP1イベントの情報

引数1：メッセージのメッセージIDの値（変数には，${EVENV1}を指定）

引数2：メッセージのメッセージ本文の値（変数には，${EVENV2}を指定）

受信したJP1イベントのメッセージ（B.MESSAGE）の値が「A001△:△WEBサーバーがダウンしました。」の場合，「alarm.bat△"A001"△"WEBサーバーがダウンしました。"」というアクションを実行します。

定義例3：イベントIDを正規表現で指定した例

イベント条件の属性名に「B.ID」，比較キーワードに「REGEX」を指定する場合の定義例を次に示します。

イベント条件

イベントIDが00000001〜00000200（16進数のA〜Fの文字は含めない）

発行元イベントサーバ名（B.SOURCESERVER）が「kanshi」

アクションとして実行するコマンド

alarm.bat

イベント基本情報でイベントIDを指定する場合は，イベント基本情報で指定しているイベントIDが対象となるように，eidに「*」を指定してください。

また，イベントIDの基本部と拡張部を8バイト以内の16進数で指定し，「：」で区切ってください。

定義例4：AND条件を使用した例

イベントAおよびイベントBを受信した場合にアクションを実行するように指定するときの定義例を次に示します。

イベントAの条件

イベントID（B.ID）が「00000201」

メッセージ（B.MESSAGE）が「WEBサーバーAがダウンしました。」

イベントBの条件

イベントID（B.ID）が「00000202」

メッセージ（B.MESSAGE）が「WEBサーバーBがダウンしました。」

アクションとして実行するコマンド

alarm.bat

AND条件を使用する場合は，相関イベント発行機能を使った自動アクションをお勧めします。相関イベント発行機能は，AND条件では考慮できない，JP1イベントの順序や件数を指定できます。相関イベントについては，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「4.3　相関イベントの発行」を参照してください。

自動アクション通知定義ファイル（actnotice.conf）

形式

[STATE_WATCH]
EVENT={true | false}
COMMAND=コマンド
[End]
[DELAY_WATCH]
EVENT={true | false}
COMMAND=コマンド
[End]

ファイル

actnotice.conf（自動アクション通知定義ファイル）

actnotice.conf.model（自動アクション通知定義ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Consoleパス¥conf¥action¥

論理ホストのとき

共有フォルダ¥jp1cons¥conf¥action¥

UNIXの場合

物理ホストのとき

/etc/opt/jp1cons/conf/action/

論理ホストのとき

共有ディレクトリ/jp1cons/conf/action/

説明

自動アクションの状態監視または遅延監視で異常を検知した場合に，JP1イベントの発行および通知コマンドの実行で，自動アクションの異常を通知するかどうかを定義するファイルです。このファイルは，JP1/IM - Managerの動作する言語コードで記述してください。

この定義ファイルで自動アクションの異常を通知するよう設定すると，自動アクションの状態監視では，「実行不可」「実行失敗」または「実行失敗（キャンセル失敗）」の状態となって異常終了した自動アクションを検知して，JP1イベントの発行および通知コマンドを実行し，オペレーターに異常状態になった自動アクションに対する対処を促します。また，自動アクションの遅延監視では，遅延監視時間で設定した時間内に終了しない自動アクションを検知して，JP1イベントの発行および通知コマンドを実行し，オペレーターに遅延状態になった自動アクションに対する対処を促します。

自動アクション通知定義ファイル（actnotice.conf）を削除した場合は，自動アクション通知定義ファイルのモデルファイル（actnotice.conf.model）をactnotice.confの名称でコピーし，必要に応じて，定義を変更してください。

定義の反映時期

次の場合に，自動アクション通知定義ファイルの設定が有効になります。

JP1/IM - Managerを起動した場合

jco_spmd_reloadコマンドによりリロードをした場合

記述内容

[STATE_WATCH]

自動アクションの状態監視で異常を検知した場合に，JP1イベントの発行および通知コマンドの実行で，自動アクションの異常を通知するかどうかを定義します。

EVENT={true | false}

自動アクションの状態監視で異常を検知した場合に，JP1イベント（イベントID：2011）を発行するかどうかを指定します。

「true」または「false」のどちらかを指定します。異常検知時にJP1イベントを発行する場合は「true」を，発行しない場合は「false」を指定します。デフォルトは「true」です。なお，「true」を指定すると，次の場合にもJP1イベント（イベントID：2016，2021）が発行されるようになります。

・アクション状態監視への通知抑止が解除された場合（イベントIDが2016のJP1イベントが発行される）

・アクション状態の監視中に，異常状態となったアクションがアクション情報ファイルからラップした場合（イベントIDが2021のJP1イベントが発行される）

JP1イベントの詳細については，「3.2.2　 JP1/IM - Managerが出力するJP1イベントの詳細」を参照してください。

COMMAND=コマンド

自動アクションの状態監視で異常を検知した場合に，実行する通知コマンドを指定します。

実行可能なコマンドの種類は次のとおりです。

コマンドを実行するホストがWindowsの場合

・実行形式ファイル（.com，.exe）

・バッチファイル（.bat）

・JP1/Scriptのスクリプトファイル（.spt）

（ただし.sptファイルが実行可能なよう関連づけが設定されていること）

コマンドを実行するホストがUNIXの場合

・実行形式ファイル（実行権限が付いていること）

・シェルスクリプト（実行権限が付いていること）

・上記以外の場合，または定義がない場合はデフォルト値「指定無し」を仮定します。

通知コマンドを定義する場合の注意事項を次に示します。

・「COMMAND=」から改行コードまでを一つのコマンドとして定義します。

・一つのコマンド定義の最大長は，1,023バイトです。

なお，変数を展開した文字列が1,023バイトを超える場合はコマンドを実行しません。

その際，統合トレースログにKAVB4409-Eのメッセージが出力されます。

・最大長のバイト数には，空白を含みます。改行コードは含みません。

・変数を指定する場合は，変数を「$」に続けて指定します。指定できる変数については，「表2-19　自動アクション通知定義ファイルで指定できる変数」を参照してください。

・COMMANDに指定された通知コマンドは，JP1/IM - Managerの実行環境を引き継ぎます。

・通知コマンドは，JP1/IM - Managerの実行権限（Windows：SYSTEMユーザー，UNIX：root）で実行されます。

・COMMANDに指定する通知コマンドは，フルパスで指定してください。

・通知コマンドは，必ず終了するコマンドを設定してください。バッチファイル（Windows）またはシェルスクリプト（UNIX）を設定する場合は，必ず exit 0 で終了するようにしてください。終了しないコマンドやGUIが起動するコマンドを指定した場合，実行した通知コマンドのプロセスが残ってしまいます。

・「$」を指定したい場合は「$$」と指定してください。

[DELAY_WATCH]

自動アクションの遅延監視で異常を検知した場合に，JP1イベントの発行および通知コマンドの実行で，自動アクションの異常を通知するかどうかを定義します。

EVENT={true | false}

自動アクションの遅延監視で異常を検知した場合に，JP1イベント（イベントID：2010）を発行するかどうかを指定します。

「true」または「false」のどちらかを指定します。異常検知時にJP1イベントを発行する場合は「true」を，発行しない場合は「false」を指定します。デフォルト値は「true」です。なお，「true」を指定すると，次の場合にもJP1イベント（イベントID：2015，2020）が発行されるようになります。

・アクション遅延監視への通知抑止が解除された場合（イベントIDが2015のJP1イベントが発行される）

・アクション遅延の監視中に，遅延状態となったアクションがアクション情報ファイルからラップした場合（イベントIDが2020のJP1イベントが発行される）

JP1イベントの詳細については，「3.2.2　 JP1/IM - Managerが出力するJP1イベントの詳細」を参照してください。

COMMAND=コマンド

自動アクションの遅延監視で異常を検知した場合に，実行する通知コマンドを指定します。

実行可能なコマンドの種類は次のとおりです。

コマンドを実行するホストがWindowsの場合

・実行形式ファイル（.com，.exe）

・バッチファイル（.bat）

・JP1/Scriptのスクリプトファイル（.spt）

（ただし.sptファイルが実行可能なよう関連づけが設定されていること）

コマンドを実行するホストがUNIXの場合

・実行形式ファイル（実行権限が付いていること）

・シェルスクリプト（実行権限が付いていること）

・上記以外の場合，または定義がない場合はデフォルト値「指定無し」を仮定します。

通知コマンドを定義する場合の注意事項を次に示します。

・「COMMAND=」から改行コードまでを一つのコマンドとして定義します。

・一つのコマンド定義の最大長は，1,023バイトです。

なお，変数を展開した文字列が1,023バイトを超える場合はコマンドを実行しません。

その際，統合トレースログにKAVB4409-Eのメッセージが出力されます。

・最大長のバイト数には，空白を含みます。改行コードは含みません。

・変数を指定する場合は，変数を「$」に続けて指定します。指定できる変数については，「表2-19　自動アクション通知定義ファイルで指定できる変数」を参照してください。

・COMMANDに指定された通知コマンドは，JP1/IM - Managerの実行環境を引き継ぎます。

・通知コマンドは，JP1/IM - Managerの実行権限（Windows：SYSTEMユーザー，UNIX：root）で実行されます。

・COMMANDに指定する通知コマンドは，フルパスで指定してください。

・通知コマンドは，必ず終了するコマンドを設定してください。バッチファイル（Windows）またはシェルスクリプト（UNIX）を設定する場合は，必ず exit 0 で終了するようにしてください。終了しないコマンドやGUIが起動するコマンドを指定した場合，実行した通知コマンドのプロセスが残ってしまいます。

・「$」を指定したい場合は「$$」と指定してください。

表2‒19　自動アクション通知定義ファイルで指定できる変数

変数名

内容

ACTSEQNO

遅延状態および異常状態となったアクションのアクション通し番号。

状態監視で指定した時に，異常状態となったアクションがアクション情報ファイルからラップした場合には，（----）と表示される。

EVID

遅延状態および異常状態となったアクション契機イベントのイベントID（基本コード（16進8桁）:拡張コード（16進8桁））。

遅延または異常状態となったアクションがアクション情報ファイルからラップした場合には，（----:----）と表示される。

EVARVTIME

遅延状態および異常状態となったアクション契機イベントのイベント到着時刻（YYYY/MM/DD hh:mm:ss）。

遅延もしくは異常状態となったアクションがアクション情報ファイルからラップした場合には，（----/--/-- --:--:--）と表示される。

ACTSTAT

遅延状態および異常状態となったアクションのアクション状態。

アクションの実行状態を表す次の文字列のどれか。

running（実行中）

ended（終了）

fail（実行不可）

error（実行失敗）

unknown（状態不明）

wait（送信待機）

send（送信中）

queue（キューイング）

cancel（キャンセル）

kill（強制終了）

アクションをJP1/IM - Viewからキャンセルした場合，上記の状態の後ろにキャンセル状態が表示される。

キャンセル状態がキャンセル中の場合。

running（canceling）

send（canceling）

queue（canceling）

wait（canceling）

キャンセル状態がキャンセル失敗の場合。

running（miss）

send（miss）

queue（miss）

wait（miss）

ended（miss）

error（miss）

アクション実行サービスの再起動時にコマンドが再実行，またはアクション再実行用ファイルに出力された場合は，状態の後ろに「-R」が付く。（例：ended-R）

JP1/IM - Viewから再実行をした場合は，上記の状態の後ろに「-RU」が付く。（例：ended-RU）

抑止されたアクションをJP1/IM - Viewから再実行した場合は，上記状態の後ろに「-RUD」が付く。（例：ended-RUD）

抑止されたアクションをJP1/IM - View から再実行し，かつ，再実行中にアクション実行サービスの再起動（系切り替え含む）の発生によって再実行，またはアクション再実行用ファイルに出力された場合は，状態の後ろに「-RD」が付く。（例：ended-RD）

抑止されたアクションの状態が「fail」（実行不可）になった場合は，状態の後ろに「-D」が付く。（例：fail-D）

遅延監視で指定した場合に，遅延となったアクションがアクション情報ファイルからラップしたときには，（----）と表示される。

状態監視で指定した場合に，異常状態となったアクションがアクション情報ファイルからラップしたときには，次の文字列のどれかになる。

fail（実行不可）

error（実行失敗）

ACTSTARTTIME

遅延状態となったアクションのアクション開始時刻（YYYY/MM/DD hh:mm:ss）。

遅延監視で指定したときだけ，時刻が表示される。

状態監視で指定した場合には，（----/--/-- --:--:--）と表示される。

遅延監視で指定した場合に，遅延となったアクションがアクション情報ファイルからラップしたときには，（----/--/-- --:--:--）と表示される。

ACTENDTIME

異常状態となったアクションのアクション終了時刻（YYYY/MM/DD hh:mm:ss）。

状態監視で指定したときだけ，時刻が表示される。

遅延監視で指定した場合には，（----/--/-- --:--:--）と表示される。

状態監視で指定した場合に，異常状態となったアクションがアクション情報ファイルからラップしたときには，（----/--/-- --:--:--）と表示される。

ACTHOST

遅延状態および異常状態となったアクションの実行先ホスト名。

遅延監視で指定した場合に，遅延となったアクションがアクション情報ファイルからラップしたときには，（----）と表示される。

状態監視で指定した場合に，「実行ホスト名」を設定していないアクション定義により発行されたアクションの状態が「実行不可」となったときには，（----）と表示される。

ACTUSR

遅延状態および異常状態となったアクションを実行しているJP1ユーザー名。

実行先ホストに登録されているユーザー名となる。

遅延監視で指定した場合に，遅延となったアクションがアクション情報ファイルからラップしたときには，（----）と表示される。

状態監視で指定した場合に，「実行ユーザー名」を設定していないアクション定義により発行されたアクションの状態が「実行不可」となったときには，（----）と表示される。

定義例

自動アクションの状態監視または遅延監視で異常を検知した場合に，JP1イベントを発行し，通知コマンドstatenotice01.exe（状態監視の場合）または，delaynotice01.exe（遅延監視の場合）を実行する。

[STATE_WATCH]
EVENT=true
COMMAND=C:¥Command¥statenotice01.exe
[End]
[DELAY_WATCH]
EVENT=true
COMMAND=C:¥Command¥delaynotice01.exe
[End]

イベント条件表示項目定義ファイル（attr_list.conf）

形式

# コメント行
属性名
属性名
属性名
　・
　・
　・
属性名

ファイル

attr_list.conf（イベント条件表示項目定義ファイル）

attr_list.conf.model（イベント条件表示項目定義ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Consoleパス¥conf¥action¥attr_list

論理ホストのとき

共有フォルダ¥jp1cons¥conf¥action¥attr_list

UNIXの場合

物理ホストのとき

/etc/opt/jp1cons/conf/action/attr_list

論理ホストのとき

共有ディレクトリ/jp1cons/conf/action/attr_list

説明

イベント条件表示項目定義ファイルは，［アクション詳細設定］画面の［属性名］表示領域に表示する表示項目を指定する定義ファイルです。［アクション詳細設定］画面は，イベント条件表示項目定義ファイルに指定された表示項目を指定された順番で［属性名］表示領域に表示します。

定義の反映時期

イベント条件表示項目定義ファイルは，セントラルコンソールの起動時，または，jco_spmd_reloadコマンド実行時に読み込みます。JP1/IM - Viewは，［アクション設定］画面を表示するときにセントラルコンソールが読み込んだイベント条件表示項目定義ファイルの内容を取得し，［アクション詳細設定］画面に反映します。

記述内容

属性名

イベント条件表示項目定義ファイルには，［アクション詳細設定］画面の［属性名］表示領域に表示する表示項目を指定します。表示項目は，表示項目に対応する属性名で1行に1件記述します。0〜256件の表示項目を指定できます。

英大文字・英小文字を区別します。属性名の両端に指定された空白（半角スペース）とタブ文字は無視されます。

指定できる属性名を次の表に示します。

SEPARATORを指定すると，［アクション詳細設定］画面の［属性名］表示領域に「--------------------」を表示します。SEPARATORは，よく使う項目と，あまり使わない項目を分けるときに設定します。

ただし，SEPARATORだけを指定した場合は，［属性名］表示領域には，「--------------------」だけが表示されます。この場合，「--------------------」を選択してイベント条件を追加しても，イベント条件は設定できません。

表2‒20　表示項目一覧

項番

表示項目

属性名

1

登録ホスト名

B.SOURCESERVER

2

重大度

E.SEVERITY

3

オブジェクトタイプ

E.OBJECT_TYPE

4

オブジェクト名

E.OBJECT_NAME

5

登録名タイプ

E.ROOT_OBJECT_TYPE

6

登録名

E.ROOT_OBJECT_NAME

7

事象種別

E.OCCURRENCE

8

ユーザー名

E.USER_NAME

9

メッセージ

B.MESSAGE

10

プロダクト名

E.PRODUCT_NAME

11

イベントID

B.ID

12

開始時刻

E.START_TIME

13

終了時刻

E.END_TIME

14

登録時刻

B.TIME

15

到着時刻

B.ARRIVEDTIME

16

固有の拡張属性

OTHER_EXTENDED_ATTRIBUTE

17

登録要因

B.REASON

18

発行元プロセスID

B.PROCESSID

19

発行元ユーザー名

B.USERNAME

20

発行元ユーザーID

B.USERID

21

発行元グループ名

B.GROUPNAME

22

発行元グループID

B.GROUPID

23

発行元IPアドレス

B.SOURCEIPADDR

24

オブジェクトID

E.OBJECT_ID

25

終了コード

E.RESULT_CODE

26

発生元ホスト名

E.JP1_SOURCEHOST

27

イベント基本情報

B.BASIC

28

イベント詳細情報

B.DETAIL

29

--------------------

SEPARATOR

注

同じ属性名が複数指定されていた場合，その値は無視されます。

また，イベント表示項目定義ファイルが読み込めなかった場合，有効な表示項目が0件のときは，項番1〜25が表示されます。

#コメント行

#で始まる行は，コメント扱いとなります。

定義例

B.SOURCESERVER
E.SEVERITY
E.OBJECT_TYPE
E.OBJECT_NAME
E.ROOT_OBJECT_TYPE
E.ROOT_OBJECT_NAME
E.OCCURRENCE
E.USER_NAME
B.MESSAGE
E.PRODUCT_NAME
B.ID
E.START_TIME
E.END_TIME
B.TIME
B.ARRIVEDTIME
OTHER_EXTENDED_ATTRIBUTE
B.REASON
B.PROCESSID
B.USERNAME
B.USERID
B.GROUPNAME
B.GROUPID
B.SOURCEIPADDR
E.OBJECT_ID
E.RESULT_CODE
E.JP1_SOURCEHOST

イベント引き継ぎ情報変換設定ファイル（event_info_replace.conf）

形式

変換前文字=変換後文字列
変換前文字=変換後文字列
      ：
変換前文字=変換後文字列

ファイル

event_info_replace.conf

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Consoleパス¥conf¥action

論理ホストのとき

共有フォルダ¥jp1cons¥conf¥action

UNIXの場合

物理ホストのとき

/etc/opt/jp1cons/conf/action

論理ホストのとき

共有ディレクトリ/jp1cons/conf/action

ファイルの権限

イベント引き継ぎ情報変換設定ファイルに必要な権限を次に示します。

Windowsの場合

AdministratorsグループおよびSYSTEMユーザーが参照できる必要があります。

UNIXの場合

root権限を持つユーザーが参照できる必要があります。

説明

次に示す変換ルールを指定するファイルです。

自動アクションおよびコマンド実行のイベント引き継ぎ情報変換機能の変換ルール

提案機能での種別が「cmd」の場合の，提案活性条件と対処アクションの文字列の変換ルール

自動対処アクションおよび手動対処アクションでの種別が「cmd」の場合の，文字列の変換ルール

上記の文字列は，イベント引き継ぎ情報変換設定ファイルの変換ルールに従って，イベント引き継ぎ情報に含まれる特定のASCII文字を別の文字列に変換できます。

提案機能での種別が「cmd」の場合の，提案活性条件と対処アクションの文字列の詳細については「提案定義ファイル（imdd_suggestion.conf）」（2.　定義ファイル）を参照してください。

自動対処アクションでの種別が「cmd」の場合の詳細については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「7. 対処アクションの自動実行と手動実行（JP1/IM - Agent連携）」の「対処アクションの自動実行」について説明している個所を参照してください。

手動対処アクションでの種別が「cmd」の場合の詳細については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「7. 対処アクションの自動実行と手動実行（JP1/IM - Agent連携）」の「対処アクションの手動実行」について説明している個所を参照してください。

イベント引き継ぎ情報変換設定ファイルは，JP1/IM - Managerのインストール時に作成されません。使用する際は「event_info_replace.conf」をテキストエディターで作成・編集してください。

定義の反映時期

自動アクションの場合

イベント引き継ぎ情報変換設定ファイルの内容は，JP1/IM - Managerの起動時，JP1/IM - Viewの［アクション設定］画面の［適用］ボタンをクリックして定義を有効にしたとき，またはjcachangeコマンドを実行して定義を再読み込みしたときに有効になります。

コマンド実行の場合

イベント引き継ぎ情報変換設定ファイルの内容は，［コマンド実行］画面の起動時に有効になります。

インテリジェント統合管理基盤（提案機能，対処アクションの自動実行機能および手動実行機能）の場合

イベント引き継ぎ情報変換設定ファイルの内容は，JP1/IM3-Managerサービスの起動時，jddupdatesuggestionコマンドを実行して提案定義を読み込んだとき，またはREST APIを実行して自動対処アクション定義を読み込んだときに有効になります。

JP1/IM3-Managerサービスの起動時に，イベント引き継ぎ情報変換設定ファイルの読み込みに失敗した場合は，変換ルール無しで変換されます。jddupdatesuggestionコマンドを実行して提案定義を読み込んだとき，またはREST APIを実行して自動対処アクション定義を読み込んだときに，イベント引き継ぎ情報変換設定ファイルの読み込みに失敗した場合は，提案定義を読み込みする前の変換ルールで変換されます。

なお，イベント引き継ぎ情報変換設定ファイルが存在しない場合は，変換ルール無しで動作します。

記述内容

変換前文字=変換後文字列

イベント引き継ぎ情報変換設定ファイルには，イベント引き継ぎ情報の変換機能で「変換前の文字」と「変換後の文字列」を記述し，変換ルールを指定します。0〜34件の変換ルールを指定できます。

イベント引き継ぎ情報変換設定ファイルの半角スペース，タブ，改行だけの行は無視されます。1行に一つの変換ルールを指定します。変換前文字，変換後文字列は，「=」で区切って指定します。

定義した1行が「変換前文字=変換後文字列」の形式でない場合は，その定義を無視して処理を続行します。また，変換後文字列が指定されていない場合，イベント引き継ぎ情報の変換時に変換前の文字を削除する設定とします。

変換前文字の同じ変換ルールは指定できません。変換前文字の同じ変換ルールが複数あった場合，ファイルの先頭行に近い変換ルールが有効となり，その他の変換前文字の同じ変換ルールは無効となります。

イベント引き継ぎ情報に制御文字（0x01〜0x08，0x0A〜0x1F，0x7F）が含まれていた場合，その制御文字は半角スペース（0x20）に変換されます。

次に示す場合，変換ルールを無視して処理を続行します。

変換前文字に指定できない文字を指定した場合。

変換前の文字が2文字以上の場合。

変換前文字

変換前文字には，次の表の変換前文字で○となっているASCII文字（0x00〜0x7F）を1文字指定できます。

変換前文字として指定できるASCII文字を次に示します。

表2‒21　変換前文字および変換後文字列として指定できる文字

文字

16進数

変換前文字

変換後文字列

制御文字

0x00〜0x08

×

×

タブ

0x09

○

○

制御文字

0x0a〜0x1f

×

×

半角スペース

0x20

○

○

!

0x21

○

○

"

0x22

○

○

#

0x23

○

○

$

0x24

○

○

%

0x25

○

○

&

0x26

○

○

'

0x27

○

○

(

0x28

○

○

)

0x29

○

○

*

0x2a

○

○

+

0x2b

○

○

,

0x2c

○

○

-

0x2d

○

○

.

0x2e

○

○

/

0x2f

○

○

0〜9（数字）

0x30〜0x39

×

○

:

0x3a

○

○

;

0x3b

○

○

<

0x3c

○

○

=

0x3d

○

○

>

0x3e

○

○

?

0x3f

○

○

@

0x40

○

○

A〜Z（アルファベット大文字）

0x41〜0x5a

×

○

[

0x5b

○

○

¥

0x5c

○

○

]

0x5d

○

○

^

0x5e

○

○

_

0x5f

○

○

`

0x60

○

○

a〜z（アルファベット小文字）

0x61〜0x7a

×

○

{

0x7b

○

○

|

0x7c

○

○

}

0x7d

○

○

~

0x7e

○

○

制御文字

0x7f

×

×

（凡例）

○：指定できる

×：指定できない

変換後文字列

変換後文字列には，上記の表の変換後文字列で○となっているASCII文字（0x00〜0x7F）を0〜2文字まで指定できます。

定義例

「"」「'」および「*」を「_」に変換する例を次に示します。

"=_
'=_
*=_

メッセージ（B.MESSAGE）の値が「WEBサーバがダウンしました。詳細："Network△Error"」というJP1イベントを受信すると，メッセージテキスト全体（変数：EVMSG）の値は，「WEBサーバがダウンしました。詳細：_Network△Error_」となります。

拡張起動プロセス定義ファイル（jp1co_service.conf）

形式

プロセス名|起動オプション|再起動可否|再起動回数|リトライ間隔|再起動回数リセット時間|

ファイル

jp1co_service.conf（拡張起動プロセス定義ファイル）

jp1co_service.conf.model（拡張起動プロセス定義ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Consoleパス¥conf¥

論理ホストのとき

共有フォルダ¥jp1cons¥conf¥

UNIXの場合

物理ホストのとき

/etc/opt/jp1cons/conf/

論理ホストのとき

共有ディレクトリ/jp1cons/conf/

説明

JP1/IM - Managerを構成する機能のプロセス情報を定義するファイルです。

JP1/IM - Managerはプロセス管理機能によって，プロセス異常終了時の再起動を制御しています。プロセス管理機能は，拡張起動プロセス定義ファイルの定義に従ってプロセスを制御します。

空白など，不要な文字を記述しないでください。編集を許可されているパラメーターの数値だけを編集してください。

「再起動可否」のパラメーターだけを，運用にあわせてカスタマイズするようにしてください。ほかのパラメーターは，各プロセスに合わせて適切な値がデフォルト値として設定されているため，通常は設定を変える必要はありません。

クラスタ構成では，論理ホストのプロセス管理のプロセスを起動する際，論理ホストのconfフォルダに拡張起動プロセス定義ファイルがない場合，物理ホストの拡張起動プロセス定義ファイルがコピーされます。

定義の反映時期

定義ファイルの内容は，JP1/IM - Managerの起動時，またはjco_spmd_reloadコマンドを実行して定義を再読み込みしたときに有効になります。なお，「起動オプション」のパラメーター変更についてはJP1/IM - Managerの起動時にだけ有効になります。

記述内容

プロセス名

JP1/IM - Managerのプロセス管理機能により起動停止するプロセス名を指定します。

JP1/IM - Managerのプロセス名があらかじめ指定されています。編集しないでください。

なお，ここで指定した名称は，jco_spmd_statusコマンドでプロセス名として表示されます。

起動オプション

プロセスの起動オプションを指定します。

-Xmxパラメーター

-Xmxパラメーターは，Javaヒープ領域の最大サイズを設定するパラメーターです。

evtconプロセスおよびjddmainプロセスのヒープ領域使用量は，ユーザーの設定により初期値を超えることがあります。evtconプロセスは，デフォルト指定は-Xmx 512mで，512メガバイトがデフォルトサイズとなります。jddmainプロセスは，デフォルト指定はなしで，8,192メガバイトがデフォルトサイズとなります。ヒープ領域を見積もり，使用量がデフォルト値を超える場合には-Xmxパラメーターの値を見積もり後の値に変更する必要があります。

ヒープ領域の見積もりについては，JP1/IM - Managerのリリースノートを参照してください。

起動オプションの注意事項

・JP1/IM - Managerのevtconプロセスのヒープ領域サイズを変更する場合は，十分にテスト運用して問題ないことを確認してください。ヒープ領域範囲内で指定される場合であっても，メモリー不足によりJP1/IM - Managerが停止したり，［イベントコンソール］画面のイベント表示が更新されなくなったりするなど，動作が不安定になることがあります。この場合は，ヒープ領域見積もり式を参照し，［イベントバッファー］および［検索時のイベント取得件数］の設定を見直してください。

・JP1/IM - Managerのリリースノートに記載している最大メモリー容量は論理値です。OS種別，ご使用の環境，同時に稼働するアプリケーションの影響により，設定したヒープ領域を確保できない場合があります。ヒープ領域を確保できなかった場合や，デフォルト値を下回る値を設定した場合は，JP1/IM - Managerが起動できないなど，不具合が生じることがあります。

Windowsで，evtconプロセスのヒープ領域サイズを512メガバイトから1,024メガバイトに変更した場合の設定例を次に示します。

（設定例）

<ヒープ領域サイズを1,024メガバイトに変更する前（初期値）の状態>

evtcon|-Xmx512m|0|3|3|3600|

<ヒープ領域サイズを1,024メガバイトに変更したあとの状態>

evtcon|-Xmx1024m|0|3|3|3600|

再起動可否

プロセスが異常終了した場合に，再起動するかどうかを指定します。

再起動しない場合は0，再起動する場合は1を指定します。

デフォルトは0です。

再起動回数

プロセスの再起動の試行回数を指定します。

指定できる値は，0〜99です。デフォルトは3です。

なお，再起動可否のフィールドに0が指定されている場合は，値が指定されていても無効になります。

リトライ間隔

プロセスの再起動のリトライ間隔を，秒単位で指定します。

指定できる値は，0〜3,600です。デフォルトは3です。

なお，再起動可否のフィールドに0が指定されている場合は，値が指定されていても無効になります。

再起動回数リセット時間

再起動によってプロセスが起動してから何時間後に再起動回数をリセットするかを，秒単位で指定します。

指定できる値は，3,600〜2,147,483,647（秒）です。デフォルトは3,600です。

プロセスが起動してから，指定した時間が経過すると，再起動回数がリセットされます。再度プロセスが異常終了した場合は，再起動回数が1からカウントされます。再起動によってプロセスが起動してから，指定した時間より前に再度異常終了した場合は，前回の再起動回数を引き継ぎます。

なお，再起動可否のフィールドに0が指定されている場合は，値が指定されていても無効になります。

定義例

拡張起動プロセス定義ファイルの定義例を次に示します。

evflow||0|3|3|3600|
jcamain||0|3|3|3600|
evtcon|-Xmx512m|0|3|3|3600|
evgen||0|3|3|3600|
jcsmain||0|3|3|3600|
jcfmain||0|3|3|3600|
jddmain||0|3|3|3600|
imbase||0|3|3|3600|
imbaseproxy||0|3|3|3600|

IMパラメーター定義ファイル（jp1co_param_V7.conf）

形式

[論理ホスト名¥JP1CONSOLEMANAGER]
"SEND_PROCESS_TERMINATED_ABNORMALLY_EVENT"=dword:値
"SEND_PROCESS_RESTART_EVENT"=dword:値

ファイル

jp1co_param_V7.conf（IMパラメーター定義ファイル）

jp1co_param_V7.conf.model（IMパラメーター定義ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Consoleパス¥conf¥

論理ホストのとき

共有フォルダ¥jp1cons¥conf¥

UNIXの場合

物理ホストのとき

/etc/opt/jp1cons/conf/

論理ホストのとき

共有ディレクトリ/jp1cons/conf/

説明

JP1/IM - Managerのプロセスの異常，また，異常終了からの自動復旧時にJP1イベントを発行するかどうかを定義するファイルです。JP1/IM - Managerのプロセス，および発行できるJP1イベントは次のようになります。

JP1/IM - Managerのプロセス

イベントコンソールサービス（evtcon）

イベント基盤サービス（evflow）

アクション実行サービス（jcamain）

セントラルスコープサービス（jcsmain）

相関イベント発行サービス（evgen）

発行できるJP1イベント

イベントIDが3F90のJP1イベント：プロセスが異常終了した場合に発行できる。

イベントIDが3F91のJP1イベント：プロセス起動時にタイムアウトした場合に発行できる。

イベントIDが3F92のJP1イベント：異常終了したプロセスが再起動を完了した場合に発行できる。

プロセスの異常や異常終了からの自動復旧時にJP1イベントを発行することにより，JP1/IM - Manager自身の障害を履歴管理できるようになります。このため，この定義ファイルを使って，JP1イベントを発行する設定にすることをお勧めします。

必要な定義内容をモデルファイルとして提供しています。設定を変更する場合は，モデルファイルをコピーして，内容を編集してください。

定義の反映時期

この定義ファイルを引数にjbssetcnfコマンドを実行し，JP1/IM - Managerを再起動したあとに有効になります。

記述内容

[論理ホスト名¥JP1CONSOLEMANAGER]

JP1/IM - Managerの環境設定のキー名称です。

論理ホスト名の部分を，物理ホストの場合はJP1_DEFAULTに，論理ホストの場合は論理ホスト名に設定します。

"SEND_PROCESS_TERMINATED_ABNORMALLY_EVENT"=dword:値

値を「1」にすると，次の場合にJP1イベントを発行します。

プロセスが異常終了した場合（イベントIDが3F90のJP1イベントが発行される）

起動時に起動通知がなく，タイムアウトした場合（イベントIDが3F91のJP1イベントが発行される）

デフォルトは「0」でJP1イベントを発行しません。

JP1イベントの詳細については，「3.2.2　JP1/IM - Managerが出力するJP1イベントの詳細」を参照してください。

"SEND_PROCESS_RESTART_EVENT"=dword:値

値を「1」にすると，次の場合にJP1イベントを発行します。

プロセス再起動の機能により，異常終了したプロセスの再起動が完了した場合（イベントIDが3F92のJP1イベントが発行される）

デフォルトは「0」でJP1イベントを発行しません。

JP1イベントの詳細については，「3.2.2　JP1/IM - Managerが出力するJP1イベントの詳細」を参照してください。

定義例

[JP1_DEFAULT¥JP1CONSOLEMANAGER]
"SEND_PROCESS_TERMINATED_ABNORMALLY_EVENT"=dword:0
"SEND_PROCESS_RESTART_EVENT"=dword:0

ファイルの終端が最下行の先頭になるようにしてください。

システムプロファイル（.system）

形式

DESC_VERSION=15
     :
[ServerDefine]
InvalidateTime = 1440
EventCount = イベントバッファー数
Debug = true
[End]
     :
[RetryInfo]
RetryCount = リトライ回数
RetryInterval = リトライ間隔
[End]

ファイル

.system（システムプロファイル）

.system.model（システムプロファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Consoleパス¥conf¥console¥profile¥

論理ホストのとき

共有フォルダ¥jp1cons¥conf¥console¥profile¥

UNIXの場合

物理ホストのとき

/etc/opt/jp1cons/conf/console/profile/

論理ホストのとき

共有ディレクトリ/jp1cons/conf/console/profile/

説明

イベントコンソールの基本動作を定義するファイルです。

各マネージャー（JP1/IM - Manager）に一つあり，イベントコンソールのシステム環境（イベントバッファー数やイベント検索時のイベントサービスとの接続リトライ回数など）についての環境情報を設定します。このプロファイルで設定した内容は，このプロファイルがあるマネージャーに接続されているすべてのJP1/IM - Viewに影響します。

定義の反映時期

JP1/IM - Manager起動時，または［システム環境設定］画面で［適用］ボタンをクリックしたときに，その定義が有効になります。

記述内容

EventCount = イベントバッファー数

イベントサービスからイベントを抽出してマネージャー上にバッファリングするときのイベント件数の上限を指定します。

指定できる値は10〜2,000，デフォルトは2,000です。

RetryCount = リトライ回数

イベント検索時にイベントサービスと接続ができなかった，または接続が切断された場合に自動的に再接続するリトライ回数を指定します。

指定できる値は0〜100，デフォルトは3です。

RetryInterval = リトライ間隔

イベント検索時にイベントサービスと接続ができなかった，または接続が切断された場合に自動的に再接続するリトライ間隔をミリ秒単位で指定します。

指定できる値は1〜86,400,000，デフォルトは10,000です。

注意事項

特別な理由がない場合は，［システム環境設定］画面で設定してください。

システムプロファイルの内容はイベントコンソールの動作のすべてに影響するため，操作にはご注意ください。また，説明していない属性および属性値については一切変更しないでください。変更した場合，イベントコンソールの動作が不正になることがあります。

システムプロファイルを編集する前に，JP1/IM - Viewを終了させてください。

システムプロファイルは，マネージャーごとにあります。そのため，ログインするマネージャーを変更した場合は，その接続先のシステムプロファイルを変更する必要があります。

.systemファイルの内容を変更する場合には，あらかじめバックアップを作成してから変更されることをお勧めします。

属性値が範囲外など，システムプロファイルに誤りがある場合，イベントコンソールは正しく動作しないことがあります。

定義例

DESC_VERSION=15
    :
[End]
[ServerDefine]
InvalidateTime = 1440
EventCount = 500
Debug = true
[End]
    :
[RetryInfo]
RetryCount = 3
RetryInterval = 10000
[End]

ユーザープロファイル（defaultUser | profile_ユーザー名）

形式

DESC_VERSION=ファイルバージョン
[DisplayItemContainer]
    :
[DisplayItemInformation]※
ValidTab=All
Visible=表示可否
AttrName=JP1イベント属性名
AttrOrder=並び順
ColumnSize=列幅
[End]
[End]
    :

注※　ValidTab=Allが記載されている[DisplayItemInformation]〜[End]内の太字部分だけが変更できます。

ファイル

defaultUser（デフォルトユーザープロファイル）

defaultUser.model（デフォルトユーザープロファイルのモデルファイル）

profile_ユーザー名（各JP1ユーザー用ユーザープロファイル）

格納ディレクトリ

Windowsの場合

物理ホストのとき

Consoleパス¥conf¥console¥profile¥

論理ホストのとき

共有フォルダ¥jp1cons¥conf¥console¥profile¥

UNIXの場合

物理ホストのとき

/etc/opt/jp1cons/conf/console/profile/

論理ホストのとき

共有ディレクトリ/jp1cons/conf/console/profile/

説明

イベントコンソールの画面表示に関する環境情報をユーザーごとに定義するファイルです。

マネージャー上のユーザーごとにあり，イベントコンソールのユーザー環境（主に画面表示に関する環境情報）を設定します。ユーザーごとのプロファイルは，JP1ユーザー名に対応して「profile_ユーザー名」という名称で作成されます。なお，ユーザープロファイルにはすべてのユーザーのデフォルトとなる「defaultUser」プロファイルが用意してあります。この「defaultUser」プロファイルを変更しておくと，それ以降作成するユーザープロファイルは変更した「defaultUser」プロファイルを基準にします。

profile_ユーザー名（各JP1ユーザー用ユーザープロファイル）は，JP1/IM - Viewの［ユーザー環境設定］画面から定義できます。ユーザープロファイルに誤りがある場合，［イベントコンソール］画面が正しく表示されないことがありますので，JP1/IM - Viewの［ユーザー環境設定］画面から定義してください。

定義の反映時期

JP1/IM - Manager（セントラルコンソール）に再ログインするとその定義が有効になります。

記述内容

DESC_VERSION=ファイルバージョン

ユーザープロファイルの形式のバージョンを表しています。

ファイルバージョンにより，[DisplayItemInformation]〜[End]で指定できる項目が変わります。バージョン11-00以降はファイルバージョンに15を指定してください。ファイルバージョンに11以前が指定されている場合は，ファイルバージョンを変更しないでください。

profile_ユーザー名（各JP1ユーザー用ユーザープロファイル）は，次の操作によって最新のファイルバージョンに更新されます。

JP1/IM - Viewから［ユーザー環境設定］画面を保存する場合

JP1/IM - Viewのログアウト時に，［イベントコンソール］画面の各ページのイベント一覧に表示される項目の列幅の大きさを保存する場合

defaultUser（デフォルトユーザープロファイル）をファイルバージョン12にしたい場合は，defaultUser.model（デフォルトユーザープロファイルのモデルファイル）をdefaultUserに上書きした上で編集してください。

[DisplayItemInformation]〜[End]

[DisplayItemInformation]〜[End]内にイベントコンソール画面に表示するJP1イベントの属性を指定します。

[DisplayItemInformation]〜[End]で一つの定義ブロックとなります。定義ブロックの内容は，［イベントコンソール］画面の三つのページすべてに反映されます。定義ブロックを追加する場合は，[DisplayItemContainer]〜[End]の間に挿入します。

[DisplayItemInformation]〜[End]で指定できるパラメーターを次に示します。

なお，「AttrOrder=0」が指定されている[DisplayItemInformation]〜[End]は，システムが使用する定義となりますので，編集しないでください。

ValidTab = All

固定の文字列です。変更しないでください。

Visible = 表示可否

AttrNameで指定した属性の情報を表示するかどうかを指定します。表示可否に「true」を指定した場合は，AttrNameで指定した属性の情報が表示されます。表示可否に「false」を指定した場合は，AttrNameで指定した属性の情報は表示されません。なお，「false」を指定すると，［ユーザー環境設定］画面の「表示できる項目」に表示されます。表示可否に「false」を指定した場合は，AttrOrderには「-1」を指定してください。

AttrName = 表示する属性名

JP1イベントの属性名を指定します。ここで指定した属性の情報が［イベントコンソール］画面に表示されます。

設定可能な属性の一覧を次の表に示します。

表2‒22　「表示する属性名」に指定できる属性名の一覧

項番

指定可能な属性

属性の名称

DESC_VERSION

1〜10※1

11

12〜14

15

1

IM.EVENT_TYPE

種別

○

○

○

○

2

B.SEQNO

イベントDB内通し番号

○

○

○

○

3

B.IDBASE

イベントID

○

○

○

○

4

B.PROCESSID

発行元プロセスID

○

○

○

○

5

B.TIME

登録時刻

○

○

○

○

6

B.ARRIVEDTIME

到着時刻

○

○

○

○

7

B.USERID

発行元ユーザーID

○

○

○

○

8

B.GROUPID

発行元グループID

○

○

○

○

9

B.USERNAME

発行元ユーザー名

○

○

○

○

10

B.GROUPNAME

発行元グループ名

○

○

○

○

11

B.SOURCESERVER

登録ホスト名

○

○

○

○

12

B.SOURCESEQNO

発行元イベントDB内通し番号

○

○

○

○

13

B.MESSAGE

メッセージ

○

○

○

○

14

E.SEVERITY

重大度

○

○

○

○

15

E.USER_NAME

ユーザー名

○

○

○

○

16

E.PRODUCT_NAME

プロダクト名

○

○

○

○

17

E.OBJECT_TYPE

オブジェクトタイプ

○

○

○

○

18

E.OBJECT_NAME

オブジェクト名

○

○

○

○

19

E.OBJECT_ID

オブジェクトID

○

○

○

○

20

E.ROOT_OBJECT_TYPE

登録名タイプ

○

○

○

○

21

E.ROOT_OBJECT_NAME

登録名

○

○

○

○

22

E.OCCURRENCE

事象種別

○

○

○

○

23

E.START_TIME

開始時刻

○

○

○

○

24

E.END_TIME

終了時刻

○

○

○

○

25

E.@JP1IM_ACTCONTROL

アクション

×

○

○

○

26

E.@JP1IM_ACTTYPE

アクション種別

×

○

○

○

27

E.@JP1IM_ORIGINAL_SEVERITY

重大度(変更前)

×

○

○

○

28

E.@JP1IM_CHANGE_SEVERITY

重大度変更

×

○

○

○

29

E.@JP1IM_DISPLAY_MESSAGE

メッセージ(変更後)

×

×

×

○

30

E.@JP1IM_CHANGE_MESSAGE

表示メッセージ変更

×

×

×

○

31

E.@JP1IM_CHANGE_MESSAGE_NAME

表示メッセージ変更定義名

×

×

×

○

32

E.@JP1IM_MEMO

メモ

×

○

○

○

33

E.JP1_SOURCEHOST

発生元ホスト名

×

×

○

○

34

E.ACTION_TARGET※2

アクション

○

×

×

×

35

IM.ACTION_TYPE※2

アクション種別

○

×

×

×

36

E.*

固有の拡張属性

×

×

×

○

（凡例）

○：指定できる

×：指定できない

注※1

１〜10で指定できる項目は同じです。

注※2

バージョン8互換の項目です。DESC_VERSIONが10以前（バージョン8以前の定義）の場合に，次のように変換されます。

　　E.ACTION_TARGET → E.@JP1IM_ACTCONTROL

　　IM.ACTION_TYPE → E.@JP1IM_ACTTYPE

AttrOrder = 並び順

左から何列目に表示させるかを指定します。1を指定すると，イベント一覧のいちばん左側に表示されます。なお，ほかと同じ値は指定しないでください。

また，0はシステムで使用する値のため指定しないでください。

ユーザープロファイルに誤りがある場合，［イベントコンソール］画面が正しく表示されないことがありますので，JP1/IM - Viewの［ユーザー環境設定］画面から定義してください。

ColumnSize = 列幅

列の幅を指定します。指定できる値は，1〜1,000です。

注意事項

ユーザープロファイルの内容はイベントコンソールの動作のすべてに影響するため，操作にはご注意ください。また，説明していない属性および属性値については一切変更しないでください。変更した場合，イベントコンソールの動作が不正になることがあります。

JP1/IM - Viewの動作中および終了時には，ユーザープロファイルが上書きされることがあります。このため，ユーザープロファイルを編集する場合は，編集する前にJP1/IM - Viewを終了させてください。

ユーザープロファイルは，マネージャーごとにあります。そのため，ログインするマネージャーを変更した場合は，その接続先のプロファイルを変更する必要があります。

defaultUserファイルの内容を変更する場合には，あらかじめバックアップを作成してから変更されることをお勧めします。

JP1/Baseのユーザー管理でユーザーを削除しても，ユーザープロファイルは削除されません。

JP1/Baseのユーザー管理でユーザー名を変更しても，ユーザープロファイルは引き継がれません。

属性値が範囲外など，ユーザープロファイルに誤りがある場合，イベントコンソールは正しく動作しないことがあります。

通信環境定義ファイル（console.conf.update）

形式

[論理ホスト名¥JP1CONSOLEMANAGER¥EVCONS]
"COM_SO_TIMEOUT"=dword:16進数値

[JP1_DEFAULT¥JP1CONSOLE_CMD]
"COM_SO_TIMEOUT"=dword:16進数値
"COM_RETRY_COUNT"=dword:16進数値
"COM_RETRY_INTERVAL"=dword:16進数値
"COM_RMI_TIMEOUT"=dword:16進数値

ファイル

console.conf.update（通信環境定義ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

Consoleパス¥default¥

UNIXの場合

/etc/opt/jp1cons/default/

説明

JP1/IM - Managerとビューアー，jcochstatコマンドとの通信処理（タイムアウト時間）を定義するファイルです。

ビューアーとJP1/IM - Managerとの通信で，ネットワークに低速の回線が使われていたり，ビューアーの負荷が高かったりするときに，ビューアーの通信処理でタイムアウトによる通信エラーが発生することがあります。このような場合，通信のタイムアウト時間を変更することで通信エラーの発生を防げます。

また，ほかのマネージャーからjcochstatコマンドを使って自ホストのJP1イベントの対処状況を変更する場合にも，何らかの理由によって通信処理でタイムアウトによる通信エラーが発生することがあります。このような場合，通信のタイムアウト時間や接続リトライ回数を変更することで通信エラーの発生を防げます。

JP1/IM - View（イベントコンソール）を使用している場合は，JP1/IM - View（イベントコンソール）の通信環境定義ファイル（view.conf.update）も変更が必要です。

必要な定義内容をモデルファイルとして提供しています。設定を変更する場合は，モデルファイルをコピーして，定義ファイル（Windowsの場合Consoleパス¥conf¥console.conf，UNIXの場合/etc/opt/jp1cons/conf/console.conf）にリネームしたあと，内容を編集してください。

定義の反映時期

jbssetcnfコマンドを実行し，JP1/IM - Managerを再起動したあとに有効になります。

記述内容

[論理ホスト名¥JP1CONSOLEMANAGER¥EVCONS]

イベントコンソールサービス環境設定のキー名称です。

論理ホスト名の部分を，物理ホストの場合はJP1_DEFAULTに，論理ホストの場合は論理ホスト名に設定します。

"COM_SO_TIMEOUT"=dword:16進数値

タイムアウト時間を16進数値で指定します。単位はミリ秒です。デフォルト値はdword:0000EA60（60,000ミリ秒）です。

指定できる値の範囲は0x00000001〜0x0036EE80（3,600,000ミリ秒）です。

また，通信環境定義ファイル（console.conf.update），および通信環境定義ファイル（view.conf.update）の"COM_RMI_TIMEOUT"値（デフォルト：0000EA60）を超えないように指定してください。なお，接続元の設定値（タイムアウト時間）を確認してください。

[JP1_DEFAULT¥JP1CONSOLE_CMD]

jcochstatコマンド環境設定のキー名称です。

"COM_SO_TIMEOUT"=dword:16進数値

タイムアウト時間を16進数値で指定します。単位はミリ秒です。デフォルト値はdword:0000EA60（60,000ミリ秒）です。

指定できる値の範囲は0x00000001〜0x0036EE80（3,600,000ミリ秒）です。

また，通信環境定義ファイル（console.conf.update）の"COM_RMI_TIMEOUT"値（デフォルト：0000EA60）を超えないように指定してください。

"COM_RETRY_COUNT"=dword:16進数値

通信エラーが発生したときのリトライ回数を16進数で指定します。デフォルト値はdword:00000003（3回）です。

指定できる値の範囲は，0x00000001〜0x7fffffff（2,147,483,647回）です。

"COM_RETRY_INTERVAL"=dword:16進数値

リトライするまでの待ち時間を16進数で指定します。単位はミリ秒です。デフォルト値はdword:00000BB8（3,000ミリ秒）です。

指定できる値の範囲は，0x00000001〜0x7fffffff（2,147,483,647ミリ秒）です。

"COM_RMI_TIMEOUT"=dword:16進数値

イベントの対処状況変更のタイムアウト時間を16進数で指定します。単位はミリ秒です。指定できる値は0000EA60〜0036EE80（60,000〜3,600,000ミリ秒），デフォルト値はdword:0000EA60（60,000ミリ秒）です。

KAVB1205-Eが頻繁に表示される場合，タイムアウト時間を長めに設定します。

定義例

[JP1_DEFAULT¥JP1CONSOLEMANAGER¥EVCONS]
"COM_SO_TIMEOUT"=dword:000009C4

[JP1_DEFAULT¥JP1CONSOLE_CMD]
"COM_SO_TIMEOUT"=dword:0000EA60
"COM_RETRY_COUNT"=dword:00000003
"COM_RETRY_INTERVAL"=dword:00000BB8

ファイルの終端が最下行の先頭になるようにしてください。

ヘルスチェック定義ファイル（jcohc.conf）

形式

[HEALTHCHECK]
ENABLE={true | false}
FAILOVER={true | false}
EVENT={true | false}
COMMAND=コマンド
NO_RESPONSE_TIME=無応答時間
ERROR_THRESHOLD=異常と見なす無応答回数
BASE_NO_RESPONSE_TIME=無応答時間
BASE_ERROR_THRESHOLD=異常と見なす無応答回数
[End]

ファイル

jcohc.conf（ヘルスチェック定義ファイル）

jcohc.conf.model（ヘルスチェック定義ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Consoleパス¥conf¥health¥

論理ホストのとき

共有フォルダ¥jp1cons¥conf¥health¥

UNIXの場合

物理ホストのとき

/etc/opt/jp1cons/conf/health/

論理ホストのとき

共有ディレクトリ/jp1cons/conf/health/

説明

ヘルスチェック機能を有効にするかどうかを定義するファイルです。ヘルスチェック機能を有効に設定する場合，異常を検知したときに，JP1イベントの発行および通知コマンドの実行で，異常を通知するかどうかも定義できます。

この定義ファイルは，JP1/IM - Managerの動作する言語コードで記述してください。

ヘルスチェック定義ファイル（jcohc.conf）を削除した場合は，ヘルスチェック定義ファイルのモデルファイル（jcohc.conf.model）をjcohc.confの名称でコピーし，必要に応じて，定義を変更してください。

セントラルスコープサービス（jcsmain）はヘルスチェック機能で監視できません。

この定義ファイルでヘルスチェック機能を有効に設定すると，JP1/IM - Managerの各プロセスおよび自ホスト上のJP1/Baseのイベントサービスが正常に動作しているかどうかをチェックできます。

ヘルスチェック機能で異常を検知できるプロセスを次に示します。

イベントコンソールサービス（evtcon）

アクション実行サービス（jcamain）

イベント基盤サービス（evflow）

相関イベント発行サービス（evgen）

イベントサービス（jevservice）

これらのプロセスがハングアップ※や異常終了となった場合に，異常を検知し，JP1イベントを発行したり，設定した通知コマンドを実行したりして，オペレーターにプロセスの回復を促します。

注※

プロセスのハングアップとは，デッドロックや無限ループなどが原因で，プロセスが処理要求を受け付けなくなる状態です。

定義の反映時期

次の場合に，ヘルスチェック定義ファイルの設定が有効になります。

JP1/IM - Managerを起動した場合

jco_spmd_reloadコマンドによりリロードをした場合

記述内容

ENABLE={true | false}

ヘルスチェック機能を有効にするかどうかを指定します。

「true」または「false」のどちらかを指定します。ヘルスチェック機能を有効にする場合は「true」を，無効にする場合は「false」を指定します。デフォルトは「false」です。

ヘルスチェック機能を有効にすると，ヘルスチェック定義ファイル内のEVENTの設定が「true」か「false」かに関係なく，ヘルスチェック機能で異常を検知した場合に統合トレースおよびWindowsイベントログ（syslog）にメッセージ（KAVB8060-E，KAVB8062-E）が出力されます。

FAILOVER={true | false}

クラスタシステムを使用している場合に使用します。ヘルスチェック機能で異常を検知した場合のJP1/IM - Managerの動作を「true」または「false」のどちらかで指定します。デフォルトは「false」です。クラスタシステムを使用していない場合には，デフォルトのままにしてください。

Windowsの場合

異常を検知したときにJP1/IM - Managerを停止する場合は「true」を，停止しない場合は「false」を指定します。ヘルスチェック機能で異常を検知したときにJP1/IM - Managerを停止することで，クラスタシステムにJP1/IM - Managerの異常を通知します。クラスタシステムでJP1/IM - Managerの障害時に，フェールオーバーするように設定しておくことで，ヘルスチェックが異常を検知した場合にフェールオーバーできます。

UNIXの場合

異常検知したJP1/IM - Managerのプロセスを停止する場合は「true」を，停止しない場合は「false」を指定します。ヘルスチェック機能で異常を検知したときにJP1/IM - Managerを停止することで，クラスタシステムにJP1/IM - Managerの異常を通知します。クラスタシステムでJP1/IM - Managerの障害時に，jco_killall.clusterコマンドで強制的に終了し，フェールオーバーするように設定しておくことで，ヘルスチェックが異常を検知した場合にフェールオーバーできます。

EVENT={true | false}

ヘルスチェック機能で異常を検知した場合に，JP1イベント（イベントID：2012，2013）を発行するかどうかを指定します。

「true」または「false」のどちらかを指定します。イベントを発行する場合は「true」を，発行しない場合は「false」を指定します。

デフォルトは「true」です。なお，「true」を指定すると，次の場合にもJP1イベント（イベントID：2014）が発行されるようになります。

ヘルスチェック機能が異常回復を検知した場合

JP1イベントの詳細については，「3.2.2　JP1/IM - Managerが出力するJP1イベントの詳細」を参照してください。

COMMAND=コマンド

ヘルスチェック機能で異常を検知した場合に，実行する通知コマンドを指定します。

実行可能なコマンドの種類は次のとおりです。

コマンドを実行するホストがWindowsの場合

実行形式ファイル（.com，.exe）

バッチファイル（.bat）

JP1/Scriptのスクリプトファイル（.spt）

　（ただし.sptファイルが実行可能なよう関連づけが設定されていること）

コマンドを実行するホストがUNIXの場合

実行形式ファイル（実行権限が付いていること）

シェルスクリプト（実行権限が付いていること）

通知コマンドを定義する場合の注意事項を次に示します。

「COMMAND=」から改行コードまでを一つのコマンドとして定義します。

一つのコマンド定義の最大長は，1,023バイトです。最大長のバイト数には，空白を含みます。改行コードは含みません。1,024バイトを超えた場合は，デフォルト値を仮定します。なお，変数を指定する場合は，変数を展開した文字列が1,023バイトを超えるときはコマンドを実行しません。その際，統合トレースログにKAVB8072-Eのメッセージが出力されます。

変数を指定する場合は，変数を「$」に続けて指定します。指定できる変数を次に示します。

表2‒23　通知コマンドに指定できる変数

変数名

内容

HCHOST

異常が発生したホスト名

HCFUNC

異常が発生した機能名

（evflow，jcamain，evtcon，evgenまたはjevservice）

HCPNAME

異常が発生したプロセスのプロセス名

（evflow，jcamain，evtcon，evgenまたはjevservice）

HCPID

evflow，jcamain，evtcon，evgenの場合

異常が発生したプロセスのプロセスID

jevserviceの場合

-1

HCDATE

異常が発生した日付（YYYY/MM/DD）

HCTIME

異常が発生した時刻（hh:mm:ss）

通知コマンドは，必ず終了するコマンドを設定してください。バッチファイル（Windows）またはシェルスクリプト（UNIX）を設定する場合は，必ず exit 0 で終了するようにしてください。終了しないコマンドやGUIが起動するコマンドを指定した場合，実行した通知コマンドのプロセスが残ってしまいます。

COMMANDに指定された通知コマンドは，JP1/IM - Managerの実行環境を引き継ぎます。

通知コマンドは，JP1/IM - Managerの実行権限（Windows：SYSTEMユーザー，UNIX：root）で実行されます。

COMMANDに指定する通知コマンドは，フルパスで指定してください。

また，設定した通知コマンドが正常に動作するかどうかは，jcohctestコマンドを使って十分にテストしてください。jcohctestコマンドについては，「jcohctest」（1.　コマンド）を参照してください。

デフォルトは指定なしの「COMMAND=」で，通知コマンドを実行しません。

「$」を指定したい場合は「$$」と指定してください。

Windowsでは，%WINDIR%¥System32フォルダ以下に配置されているコマンドを実行すると，WOW64のリダイレクト機能によって，%WINDIR%¥SysWow64フォルダ以下に配置されているコマンドにリダイレクトされます。リダイレクト先のコマンドがない場合，コマンドの実行に失敗することがあります。%WINDIR%¥System32フォルダ以下に配置されているコマンドを実行コマンドに指定する場合は注意してください。

NO_RESPONSE_TIME=無応答時間

JP1/IM - Managerのプロセスの無応答時間のチェック間隔を秒単位で指定します。指定できる範囲は，60〜3,600秒です。デフォルト値は「60」秒です。

指定範囲外の値が設定された場合や定義がない場合は，デフォルト値「60」秒を仮定します。

なお，このパラメーターはJP1/IM - Managerのインストール時に配置されるヘルスチェック定義ファイル（jcohc.conf）に記載されていません。設定をデフォルト値から変更する場合は，パラメーターを追記する必要があります。

ERROR_THRESHOLD=異常と見なす無応答回数

JP1/IM - Managerのプロセスについて異常と見なす無応答回数を指定します。指定できる範囲は，1〜60回です。デフォルト値は「3」回です。

指定範囲外の値が設定された場合や定義がない場合は，デフォルト値「3」回を仮定します。

BASE_NO_RESPONSE_TIME=無応答時間

マネージャー上のJP1/Baseのイベントサービスの無応答時間のチェック間隔を秒単位で指定します。指定できる範囲は，60〜3,600秒です。デフォルト値は「300」秒です。

指定範囲外の値が設定された場合や定義がない場合は，デフォルト値「300」秒を仮定します。

BASE_ERROR_THRESHOLD=異常と見なす無応答回数

マネージャー上のJP1/Baseのイベントサービスについて異常と見なす無応答回数を指定します。指定できる範囲は，1〜60回です。デフォルト値は2です。

指定範囲外の値が設定された場合や定義がない場合は，デフォルト値「2」回を仮定します。

定義例

ヘルスチェック機能で異常を検知した場合に，JP1イベントを発行し，通知コマンドjcohc01.exeを実行します。

[HEALTHCHECK]
ENABLE=true
FAILOVER=false
EVENT=true
COMMAND=C:¥Command¥jcohc01.exe
NO_RESPONSE_TIME=60
ERROR_THRESHOLD=3
BASE_NO_RESPONSE_TIME=300
BASE_ERROR_THRESHOLD=2
[End]

イベントガイド情報ファイル（jco_guide.txt）

形式

DESC_VERSION=ファイルバージョン

[EV_GUIDE_イベントガイド番号]
EV_USER=JP1ユーザー名
EV_COMP=属性名:属性値
EV_GUIDE=イベントガイドメッセージ
[END]
[EV_GUIDE_イベントガイド番号]
EV_COMP=属性名:属性値
EV_COMP=属性名:属性値
EV_FILE=イベントガイドメッセージファイル名
[END]
   :

ファイル

sample_jco_guide_ja.txt（イベントガイド情報ファイルのサンプルファイル（日本語））

sample_jco_guide_en.txt（イベントガイド情報ファイルのサンプルファイル（英語））

sample_jco_guide_ja.txt.model（イベントガイド情報サンプルのモデルファイル（日本語））

sample_jco_guide_en.txt.model（イベントガイド情報サンプルのモデルファイル（英語））

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Consoleパス¥conf¥guide¥

論理ホストのとき

共有フォルダ¥jp1cons¥conf¥guide¥

UNIXの場合

物理ホストのとき

/etc/opt/jp1cons/conf/guide/

論理ホストのとき

共有ディレクトリ/jp1cons/conf/guide/

説明

JP1イベントに対して，イベントガイド情報を定義するファイルです。このファイルで記述した内容は，JP1/IM - Viewおよび統合オペレーション・ビューアーの［イベント詳細］画面に表示されます。

イベントガイド情報ファイルの最大サイズは，1メガバイトです。また，イベントガイド情報ファイルの最大件数は，1,000件です。

イベントガイド情報ファイルは，JP1/IM - Managerの動作する言語コードで記述してください。

なお，イベントガイド情報ファイルは，jco_guide.txtというファイル名で作成する必要があります。JP1/IM - Managerの動作する言語コードに合わせてsample_jco_guide_ja.txtまたはsample_jco_guide_en.txtをコピーし，ファイル名をjco_guide.txtに変更してから使用するようにしてください。また，格納先のディレクトリは，サンプルファイルと同じディレクトリにしてください。EV_FILEパラメーターで指定するファイル（イベントガイドメッセージファイル）と異なり，ファイル名は任意ではないため，注意してください。

発行されたJP1イベントに対して，複数のイベントガイド情報が一致する場合，イベントガイド情報ファイルで先に記述してある方が有効になります。

#を指定した場合，#以降は改行されるまでコメント扱いとなります。ただし，開始タグ，属性情報，終了タグの後方にコメントを記述できません。開始タグと終了タグの後方にコメントを記述した場合は，エラーとなります。また，属性値の後方にコメントを書いた場合は，属性値の一部として認識されます。

¥を記述する場合，¥¥と記述する必要があります。¥nおよび¥$以外に¥を記述していた場合はログが出力され，¥を記述した行を無視して処理します。

イベントガイド情報ファイル，イベントガイドメッセージファイルに記述されているHTMLの構文チェックはしません。

定義の反映時期

イベントガイド情報ファイルを編集後，JP1/IM - Managerを再起動するか，jco_spmd_reloadコマンドを実行したときから有効になります。なお，JP1/IM - Viewおよび統合オペレーション・ビューアーでのログイン時，［イベント詳細］画面にイベントガイド情報の表示領域がない場合，定義を有効にしたあと再ログインすることで，表示領域が表示されます。

イベントガイドメッセージファイルを編集した場合は，［イベント詳細］画面を表示し直すことで，編集内容が更新されます。

記述内容

DESC_VERSION=ファイルバージョン

イベントガイド情報ファイルの形式のバージョンを表しています。1または2を指定できます。2を指定すると，EV_USERパラメーターを指定できます。

[EV_GUIDE_イベントガイド番号]

イベントガイド情報の開始タグです。[EV_GUIDE_イベントガイド番号]〜[END]で一つの定義ブロックとなります。このパラメーターと[END]の間に［イベント詳細］画面への表示対象となるJP1イベントの比較条件および表示するメッセージを記述します。イベントガイド番号は，1〜9999の数字を10進数で指定します。

複数の定義ブロックがある場合でも順序性を持たせる必要はありませんが，同一のイベントガイド番号を指定するとエラーになり，定義ブロックが無効になります。なお，[EV_GUIDE_1]と[EV_GUIDE_0001]は異なります。

EV_GUIDE_イベントガイド番号タグ内の文字列は一意にしてください。不正な文字列がある場合はログが出力され，該当個所を無視して処理します。

EV_GUIDE_イベントガイド番号タグ内に記述できる属性以外が記述されている場合は，該当個所を無視して処理します。

EV_USER=JP1ユーザー名

イベントガイドメッセージの表示対象となるJP1ユーザー名を指定します。指定できる文字数は，1〜31バイトです。半角英数字だけを使用できます。英字は大文字・小文字を区別しません。このパラメーターを指定する場合は，DESC_VERSIONに2を指定してください。このパラメーターは，複数指定できません。また，このパラメーターを省略した場合は，すべてのJP1ユーザーを対象ユーザーと仮定し動作します。

JP1/IM - Managerのバージョンが09-50以降の場合に指定できます。JP1ユーザー名とJP1ユーザー名は，一つ以上の空白で区切り，最大100個指定できます。

（例）

EV_USER=jp1user1 jp1user2 jp1user3

EV_COMP=属性名:属性値

このパラメーターは，JP1イベントを比較する属性の数だけ記述します。複数記述した場合は，AND条件になります。例えば，EV_COMPパラメーターを二つ以上指定した場合，すべての条件が成立したときにだけ，イベントガイドメッセージを［イベント詳細］画面に表示します。

EV_COMPパラメーターの属性名にイベントIDを指定する場合には，B.IDとB.IDBASEのどちらかを指定できます。B.IDの場合は属性値を基本部:拡張部の16桁で，B.IDBASEの場合は基本部8桁で記述します。

（例）

EV_COMP=B.ID:00004107:00000000

EV_COMP=B.IDBASE:00004107

なお，EV_COMPに指定できる条件は100件までです。EV_COMPを二つ以上指定する場合の例については，以降の定義例を参照してください。

また，発行元イベントサーバ名（B.SOURCESERVER），送信先イベントサーバ名（B.DESTSERVER），発生元ホスト名（E.JP1_SOURCEHOST）には業務グループ名を使用できません。業務グループ名を指定した場合，ホスト名として扱われます。

属性名

次の属性を指定できます。

・JP1イベントの基本属性：指定する場合「B.属性名」と指定します。

・JP1イベントの拡張属性：指定する場合「E.属性名」と指定します。

なお，登録要因（B.REASON），コードセット（B.CODESET）は指定できません。

属性名に登録時刻（B.TIME）または到着時刻（B.ARRIVEDTIME）を指定した場合はUTC 1970年1月1日00:00:00からの通算ミリ秒で比較を行います。

（例）到着時刻が2013/6/12 10:20:00.000（通算ミリ秒表記で1371000000000）のJP1イベントを指定する場合

EV_COMP=B.TIME:1371000000000

属性値

属性名で指定した属性の内容を正規表現で記述します。正規表現には拡張正規表現を使用します。正規表現の詳細については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「付録G　正規表現」を参照してください。

デフォルトでは，指定した正規表現とJP1イベントの属性値全体を比較し，完全に一致した場合だけ条件が成立します。

部分一致にしたいときは，次の共通定義情報を定義した任意のファイルを引数にjbssetcnfコマンドを実行したあと，定義を有効にするため，JP1/IM - Managerを再起動してください。定義ファイル作成時にはファイルの終端が最下行の先頭になるようにしてください。

・物理ホストの場合

[JP1_DEFAULT¥JP1CONSOLEMANAGER]

"GUIDE_EV_COMP"="find"

・論理ホストの場合

[論理ホスト名¥JP1CONSOLEMANAGER]

"GUIDE_EV_COMP"="find"

定義内容を完全一致（デフォルト）に戻す場合は，共通定義情報"GUIDE_EV_COMP"の値に"match"を指定してください。

共通定義情報の設定がない場合や，値が不正な場合は"match"を仮定し完全一致で動作します。

なお，この共通定義情報はインストール直後の状態では設定されていません。

発行元IPアドレス（B.SOURCEIPADDR）および送信先IPアドレス（B.DESTIPADDR）にIPv6アドレスを指定する場合，次のように英字部分を英小文字で指定してください。

0011:2233:4455:6677:8899:aabb:ccdd:eeff

また，次のようなIPアドレスの省略形式は指定できません。

2012:7:8::a:b

登録時刻（B.TIME），または到着時刻（B.ARRIVEDTIME）を指定する場合は，UTC 1970-01-01 00:00:00からの秒数をミリ秒で指定してください。

EV_GUIDE=イベントガイドメッセージ

イベントガイドメッセージには，イベントガイドとして表示したい文字列を1行で記述します。指定した文字列は，［イベント詳細］画面のイベントガイド情報が表示される領域（［メッセージ］の下の［ガイド］）に表示されます。

なお，このパラメーターは，[EV_GUIDE_イベントガイド番号]と[END]の間に一つしか記述できません。

EV_GUIDE=イベントガイドメッセージとEV_FILE=イベントガイドメッセージファイル名を同時に指定した場合，EV_FILE=イベントガイドメッセージファイル名の記述が優先されます。

メッセージ中に¥を記述する場合は¥¥，$を記述する場合は¥$と記述します。メッセージに改行を入れる場合は，¥nと記述します。

また，イベントガイドメッセージでは，HTMLタグを使ったり，JP1イベントの属性を変数として記述したりすることもできます。

HTMLタグの記述

HTMLタグを記述すれば，［イベント詳細］画面に表示されるイベントガイドメッセージをHTML形式で表示できます（記述できるHTMLタグはEV_FILEの説明文にある「表2-27　イベントガイドメッセージとして使用できるHTMLタグ」を参照のこと）。

JP1イベントの属性を変数として記述

メッセージ中に「$B.属性名△」，「$E.属性名△」を指定した場合，JP1イベントの属性名に対応する属性値がメッセージとして展開されます（△は半角スペースを表す）。ただし，登録要因（B.REASON），コードセット（B.CODESET）は指定できません。また，対応する属性が存在しない場合は空に置き換えられます。

メッセージ中に指定できる属性名を，次表に一覧で示します。なお，JP1イベントの属性の詳細については，「3.1　JP1イベントの属性」を参照してください。

表2‒24　メッセージ中に指定できる属性名の一覧

JP1イベントの属性

メッセージ中の記述

基本属性

イベントDB内通し番号

B.SEQNO

イベントID

次の2とおり

B.ID

B.IDBASE

発行元プロセスID

B.PROCESSID

登録時刻

B.TIME

到着時刻

B.ARRIVEDTIME

発行元ユーザーID

B.USERID

発行元グループID

B.GROUPID

発行元ユーザー名

B.USERNAME

発行元グループ名

B.GROUPNAME

発行元イベントサーバ名

B.SOURCESERVER

送信先イベントサーバ名

B.DESTSERVER

発行元イベントDB内通し番号

B.SOURCESEQNO

メッセージ

B.MESSAGE

拡張属性

重大度

E.SEVERITY

ユーザー名

E.USER_NAME

プロダクト名

E.PRODUCT_NAME

オブジェクトタイプ

E.OBJECT_TYPE

オブジェクト名

E.OBJECT_NAME

登録名タイプ

E.ROOT_OBJECT_TYPE

登録名

E.ROOT_OBJECT_NAME

オブジェクトID

E.OBJECT_ID

事象種別

E.OCCURRENCE

開始時刻

E.START_TIME

終了時刻

E.END_TIME

終了コード

E.RESULT_CODE

発生元ホスト名

E.JP1_SOURCEHOST

上記以外の拡張属性

E.xxxxxx※

注※

各JP1製品固有の拡張属性も使用できます。例えば，JP1/AJSのジョブの実行ホストは，E.C0です。製品固有の拡張属性についての詳細は，JP1イベントを発行する各製品のマニュアルを参照してください。

イベントガイドメッセージに記述する文字数は196,608文字以内にしてください。196,608文字よりも長く記述した場合，196,609文字以降のメッセージは，［イベント詳細］画面に表示されません。

なお，イベントガイドメッセージは，次の表に示す置き換え文字を指定することで，連携製品のWWWページなどを文字化けすることなく表示できます。

表2‒25　指定できる置き換え文字

指定形式

説明

$B.属性名△

$E.属性名△

属性値をそのまま展開する。

ガイド情報の形式がHTML形式の場合は，HTMLエンコードを行う。

JP1イベントの属性値をイベントガイドメッセージで表示する文章の一部として表示する場合に指定する。

（例）$B.MESSAGE△

$B.属性名$URLENC△

$E.属性名$URLENC△

属性値をUTF-8の文字列としてURLエンコードして展開する。

WWWページアプリケーションの引数（URLパラメーター）としてJP1イベントの属性値をUTF-8の文字列として渡す場合に使用する。

（例）<a href="http://host/page?msg=$B.MESSAGE$URLENC△">

$B.属性名$ENC△

$E.属性名$ENC△

属性値をUTF-8の文字列としてBase64でエンコードして展開する。

JP1イベントの属性値をUTF-8の文字列としてBase64でエンコードした値をイベントガイドメッセージで表示する文章の一部として表示する場合に指定する。

ただし，WWWページアプリケーションの引数（URLパラメーター）として渡す場合は，「$B.属性名$ENC$URLENC△，$E.属性名$ENC$URLENC△」の変数を使用する。

（例）$B.MESSAGE$ENC△

$B.属性名$ENC$URLENC△

$E.属性名$ENC$URLENC△

属性値をUTF-8の文字列としてBase64でエンコード後，さらにURLエンコードして展開する。

WWWページアプリケーションの引数（URLパラメーター）としてJP1イベントの属性値のBase64値を渡す場合に使用する。

（例）<a href="http://host/page?msg=$B.MESSAGE$ENC$URLENC△">

注

$URLENC，または$ENCを指定する場合は，DESC_VERSIONの値に2を指定する必要があります。

EV_FILE=イベントガイドメッセージファイル名

イベントガイドメッセージファイル名には，［イベント詳細］画面に表示されるイベントガイドメッセージの内容を記述したファイルの名称をフルパスで指定します。このパラメーターは，[EV_GUIDE_イベントガイド番号]と[END]の間に一つしか記述できません。なお，イベントガイドメッセージファイル名に何も記述していない場合，次のファイル名を指定したと見なされます。

表2‒26　イベントガイドメッセージファイル名

OS

イベントガイドメッセージファイル名

Windows

Consoleパス¥conf¥guide¥EV_GUIDE_イベントガイド番号.txt

共有フォルダ¥jp1cons¥conf¥guide¥EV_GUIDE_イベントガイド番号.txt

UNIX

/etc/opt/jp1cons/conf/guide/EV_GUIDE_イベントガイド番号.txt

共有ディレクトリ/jp1cons/conf/guide/EV_GUIDE_イベントガイド番号.txt

ファイル名は，パスを含めて1,024文字以内にしてください。1,024文字を超えた場合，JP1/IM - Managerの起動時またはJP1/IM - Viewおよび統合オペレーション・ビューアーからのイベントガイドメッセージファイル呼び出し時にエラーとなります。

ガイドメッセージファイルとして指定できるファイルの名称，拡張子はユーザー任意です。ファイル名称には管理しやすい名称を，拡張子は表示するイベントガイドメッセージがTXT形式であれば.txtを，HTML形式であれば.html，.htmを使用することをお勧めします。

（例）jco_guidemes001_AJS2.txt，またはjco_guidemes001_AJS2.htm

イベントガイドメッセージファイル

イベントガイドメッセージファイルには，［イベント詳細］画面から表示させたい情報をTXT形式またはHTML形式で記述します。記述できる内容は，イベントガイド情報ファイルのEV_GUIDEで記述できる内容と同じです。つまり，HTMLタグを使用したり，JP1イベントの属性を変数として記述したりできます。メッセージ中に¥を記述する場合は¥¥，$を記述する場合は¥$と記述します。メッセージに改行を入れる場合は，¥nと記述します。

なお，1行でメッセージを記載するEV_GUIDEと違い，イベントガイドメッセージファイルの場合，改行を挿入して体裁を整えることができます。

作成したイベントガイドメッセージファイルは，任意のフォルダに格納できます。

イベントガイドメッセージファイルの最大サイズは，1メガバイトです。1メガバイトを超えた場合，JP1/IM - Viewおよび統合オペレーション・ビューアーの［イベント詳細］画面からのイベントガイドメッセージファイル読み込み時にエラーとなります。

HTML形式のイベントガイドメッセージファイルを作成する場合に使用できるHTMLタグおよび属性を次に示します。なお，このほかのHTMLタグについては動作保証していません。

表2‒27　イベントガイドメッセージとして使用できるHTMLタグ

タグ

属性

説明

HTML

−

HTML文章であることを宣言します。このタグは必須です。

HEAD

−

HTML文章のヘッダーを宣言します。

このタグは必須です。

BODY

−

HTML文章の本文を宣言します。

このタグは必須です。

A※1

HREF="URL"

リンク先URLを指定します。※2，※3「http://」，または「https://」で始まるURLが指定できます。

それ以外は動作保証されません。

ここで指定したリンクは［イベント詳細］画面（HTML形式）に表示されます。クリックするとWWWブラウザーが起動し，指定したURLにアクセスできます。エンコードできる文字数は2,083文字までです。

TARGET※5

HREFで指定したURLが示すページの表示先ウィンドウの名前を指定します。

［統合オペレーション・ビューアー］画面を表示しているWWWブラウザーの同一セッションの範囲に，同名の表示先ウィンドウがある場合は，そのウィンドウを表示先とします。

表示先ウィンドウが無い場合は，新しくウィンドウを開いて表示先とします。

次の文字を指定できます。

半角英大文字，半角英小文字

半角数字

空白

記号（!"#$%&'()*+,-./:;<=>?@[¥]^_`{|}~）

なお，半角数字，空白，記号は先頭の文字には指定できません。ただし，_blankを指定する場合は，先頭の文字に「_」を指定できます。

次の名前は，使用できません。大文字・小文字は区別しません。

_parent

_self

_top

JP1IM_で始まる名前

target=""のような長さ0の名前

H1，H2，H3，H4，H5，H6

−

見出しを指定します。

FONT

SIZE="文字サイズ"

文字サイズを指定します。指定できる値は1〜7です。

COLOR="文字色"

文字色を指定します。指定できる色は次の16色です。

black，silver，gray，white，maroon，red，purple，fuchsia，green，lime，olive，yellow，navy，blue，teal，aqua

これ以外の文字色は動作保証されません。

B

−

文字を太字にします。

I※4

−

文字を斜体にします。

HR

−

けい線を引きます。

BR

−

強制的に改行します。

（凡例）　−：なし

注※1　AタグのURLの解釈および表示される画面は，WWWブラウザーなどの環境に依存します。

注※2　JP1/Navigation Platformと連携する場合のURLを次に記述します。

【記述例】

http://hostA:8080/ucnpBase/portal/screen/Home/action/PLoginUser?contentId=f24077e7-0136-1000-8000-00000ad20b6f-0

JP1/Navigation Platformとの連携については，JP1/Navigation PlatformのマニュアルのJP1製品からナビゲーションプラットフォームを呼び出すためのURLについて説明されている個所を参照してください。

注※3　JP1/AJSと連携する場合のURLについては，JP1/AJSのマニュアルを参照してください。

注※4　［統合オペレーション・ビューアー］画面の場合，日本語にIタグを指定しても斜体になりません。

注※5　［統合オペレーション・ビューアー］画面の場合にだけ，使用できる属性です。

[END]

イベントガイド情報の終了タグです。小文字，大文字の区別はしません。

定義例

# JP1/IM-CC Guide Information File.

DESC_VERSION=1
[EV_GUIDE_001]
EV_COMP=B.ID:00004107:00000000
EV_COMP=E.SEVERITY:Error
EV_GUIDE=ジョブが異常終了しました。¥n$E.C0 のホストで異常が発生していないか確認してください。
[END]

システムカラー定義ファイル（systemColor.conf）

形式

DESC_VERSION=ファイルバージョン

# コメント行
[DEFAULT.BackgroundColor=カラー]
[DEFAULT.TextColor=カラー]

[SEVERITY.重大度.BackgroundColor=カラー]
[SEVERITY.重大度.TextColor=カラー]
：

ファイル

systemColor.conf（システムカラー定義ファイル）

systemColor.conf.model（システムカラー定義ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Consoleパス¥conf¥console¥profile

論理ホストのとき

共有フォルダ¥jp1cons¥conf¥console¥profile

UNIXの場合

物理ホストのとき

/etc/opt/jp1cons/conf/console/profile

論理ホストのとき

共有ディレクトリ/jp1cons/conf/console/profile

説明

［イベントコンソール］画面の［イベント監視］ページ，［重要イベント］ページ，および［イベント検索］ページでのカラーリングを定義するファイルです。

ファイルの権限

Windowsの場合

AdministratorsグループおよびSYSTEMユーザーが参照できる必要があります。

UNIXの場合

root権限を持つユーザーが参照できる必要があります。

定義の反映時期

［ユーザー環境設定］画面の［カラーリング］項目の［有効］チェックボックスをチェックすると，システムカラー定義ファイルの設定内容に従ってイベント一覧のイベントがカラーリングされます。

JP1/IM - Viewはログイン時のシステムカラー定義ファイルの設定内容に従ってカラーリングを行います。

ログイン中にシステムカラー定義ファイルの設定内容を変更した場合は，JP1/IM - Viewを再起動することで設定内容を有効にできます。

記述内容

DESC_VERSION=ファイルバージョン

システムカラー定義ファイルの形式のバージョンを表しています。指定する値は1です。省略した場合や1以外の数値を指定した場合は，1が仮定されます。

#コメント行

#で始まる行は，コメント扱いとなります。

[DEFAULT.BackgroundColor=カラー]

デフォルトの背景色を指定します。重大度の背景色の指定がない，または重大度の背景色の指定に一致しないJP1イベントは，このパラメーターで指定した背景色となります。このパラメーターは省略できます。背景色はカラー名またはRGB値で指定します。カラー名とRGB値の対応を次に示します。

カラー名

RGB値

black

0,0,0

blue

0,0,255

cyan

0,255,255

darkGray

64,64,64

gray

128,128,128

green

0,255,0

lightGray

192,192,192

magenta

255,0,255

orange

255,200,0

pink

255,175,175

red

255,0,0

white

255,255,255

yellow

255,255,0

カラー名は，大文字・小文字を区別しません。

指定できるRGB値の範囲は，0〜255です。デフォルトはwhite（255,255,255）です。RGB値は「,」（半角コンマ）で区切ります。

[DEFAULT.TextColor=カラー]

文字の色が指定されていない重大度の文字の色を指定します。このパラメーターは省略できます。カラー名，RGB値およびRGB値の範囲は，DEFAULT.BackgroundColor=カラーと同じです。カラー名は，大文字・小文字を区別しません。

デフォルトはblack（0,0,0）です。

[SEVERITY.重大度.BackgroundColor=カラー]

重大度の背景色を指定します。このパラメーターは省略できます。カラー名，RGB値およびRGB値の範囲は，DEFAULT.BackgroundColor=カラーと同じです。カラー名は，大文字・小文字を区別しません。

指定できる重大度は，"Emergency"（緊急），"Alert"（警戒），"Critical"（致命的），"Error"（エラー），"Warning"（警告），"Notice"（通知），"Information"（情報），"Debug"（デバッグ）です。重大度は，大文字・小文字を区別します。

[SEVERITY.重大度.TextColor=カラー]

重大度の文字の色を指定します。このパラメーターは省略できます。カラー名，RGB値およびRGB値の範囲は，DEFAULT.BackgroundColor=カラーと同じです。カラー名は，大文字・小文字を区別しません。

指定できる重大度は，"Emergency"（緊急），"Alert"（警戒），"Critical"（致命的），"Error"（エラー），"Warning"（警告），"Notice"（通知），"Information"（情報），"Debug"（デバッグ）です。重大度は，大文字・小文字を区別します。

定義例

DESC_VERSION=1

DEFAULT.TextColor=black
DEFAULT.BackgroundColor=white

SEVERITY.Emergency.TextColor=white
SEVERITY.Emergency.BackgroundColor=red

SEVERITY.Alert.TextColor=white
SEVERITY.Alert.BackgroundColor=red

SEVERITY.Critical.TextColor=white
SEVERITY.Critical.BackgroundColor=red

SEVERITY.Error.TextColor=white
SEVERITY.Error.BackgroundColor=255,128,0

SEVERITY.Warning.TextColor=black
SEVERITY.Warning.BackgroundColor=yellow

イベント拡張属性定義ファイル

形式

@encode 文字コード
@file type="定義ファイルタイプ", version="定義フォーマットバージョン";
@product name="プロダクト名";
@define-block type="event-attr-def";
block lang = "言語種別", platform="プラットフォーム種別"
attr name="属性名", title="表示項目名"[, type="属性表示タイプ"];
・・・
@define-block-end;
@define-block type="event-attr-group-def";
block platform="プラットフォーム種別"
group name="グループ名", attrs="属性名並び";
・・・
@define-block-end;
@define-block type="event-attr-order-def";
block platform="プラットフォーム種別"
order id="イベントID定義文字列", attrs="属性名並び";
・・・
@define-block-end;

ファイル

イベント拡張属性定義ファイルの拡張子は.conf（小文字）としてください。

default.conf（デフォルトのイベント拡張属性定義ファイル）

hitachi_xxxx.conf（連携製品のイベント拡張属性定義ファイル）

会社名_製品名_attr.conf（ユーザー定義のイベント拡張属性定義ファイル）

なお，「製品名」は，「シリーズ名_製品名」とすることもできます。JP1イベント発行時の「PRODUCT_NAME」に指定する値の「/」を「_」に変更してファイル名に使用することをお勧めします。また，標準提供ファイル名称用に「hitachi」を使用しているため，「会社名」には「hitachi」以外の名称を使用してください。

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Consoleパス¥conf¥console¥attribute¥

論理ホストのとき

共有フォルダ¥JP1Cons¥conf¥console¥attribute¥

UNIXの場合

物理ホストのとき

/etc/opt/jp1cons/conf/console/attribute/

論理ホストのとき

共有ディレクトリ/jp1cons/conf/console/attribute/

説明

イベント拡張属性定義ファイルは，［イベント詳細］画面に表示するイベント属性の並び順や表示する属性名を定義します。

イベント拡張属性定義ファイルには，次の4種類のファイルがあります。

表2‒28　イベント拡張属性定義ファイルの種類

項番

種類

説明

1

標準ファイル

すべてのイベントに共通の基本属性，および拡張属性の共通情報に対するイベント詳細情報定義

2

拡張ファイル

固有の拡張属性を指定する定義

3

連携製品提供ファイル

JP1イベントを発行する連携製品の拡張属性の固有情報定義

4

ユーザー定義ファイル

ユーザー定義の拡張属性の固有情報

上記表の項番1と項番3の2種類のファイルは，JP1/IMの定義ファイル格納先ディレクトリに格納されています。JP1/IM - Managerがインストール時に作成するこの2種類のファイルは，システム標準の定義情報であり，ユーザーによる追加・変更・削除はできません。

新たにJP1イベントに対する拡張属性の固有情報を追加する場合，ユーザーは，項番2と項番4の定義ファイルを作成し，格納先ディレクトリに格納します。

項番2の詳細については，「イベント拡張属性定義ファイル（拡張ファイル）」（2.　定義ファイル）を参照してください。

作成契機

イベント拡張属性定義ファイルの作成契機を次に示します。

項番

ファイル

作成契機

1

default.conf

JP1/IM - Manager インストール時に作成する。

2

hitachi_xxxx.conf

JP1/IM - Manager インストール時に作成する。

3

会社名_製品名_attr.conf

ユーザーが追加して個別に作成する。

定義の反映時期

次のどちらかが成立する場合に，イベント拡張属性定義ファイルの記述内容を反映します。

JP1/IM - Managerを起動した場合

jco_spmd_reloadコマンドを実行した場合

記述内容

イベント拡張属性定義ファイルは，JP1/IM - View および統合オペレーション・ビューアーの［イベント詳細］画面に表示するイベント属性の並び順や表示する属性名を定義します。

イベント拡張属性定義ファイルには，次の3種類のファイルがあります。

すべてのイベントに共通の基本属性，および拡張属性の共通情報に対するイベント詳細情報定義（標準提供：default.conf）

JP1イベントを発行する連携製品の拡張属性の固有情報定義（標準提供：hitachi_xxxx.conf）

ユーザー定義の拡張属性の固有情報（ユーザーが個別作成）

JP1/IM - Managerがインストール時に作成するイベント拡張属性定義ファイルは，システム標準定義情報であるため，ユーザーによる追加，変更，削除はできません。

新たにJP1イベントに対する拡張属性の固有情報を追加する場合は，この定義ファイル格納ディレクトリに「表2-2　定義ファイルの命名規則」の名称基準に従って作成した定義ファイルを格納してください。

この定義ファイルを作成する場合，次のことに注意してください。

Linux版のJP1/IM - ManagerではUTF-8コード，Linux版以外のJP1/IM - ManagerではシフトJIS，またはEUCコードで定義する必要があります。

定義ファイルに誤って基本属性や拡張属性の共通情報を定義した場合，属性（属性名，項目名，属性表示タイプ）が重複していると次のように表示されます。

属性名だけ，または項目名だけが重複している場合：それぞれの定義ファイルに定義された属性名および項目名が表示されます。

すべての属性が重複している場合：イベント拡張属性定義ファイルの標準ファイル（default.conf）の指定を無視します。

なお，JP1/IMには，イベント拡張属性定義ファイルの記述内容をチェックするためのコマンド「jcoattrfcheck」が用意されています。このコマンドの詳細については，「jcoattrfcheck」（1.　コマンド）を参照してください。

イベント拡張属性定義ファイルには，次のステートメントとブロックを記述できます。

表2‒29　イベント拡張属性定義ファイルに記述できるステートメントおよびブロック

ステートメントまたはブロック

意味

@encodeステートメント

定義ファイルで使用している文字コードを指定する

@fileステートメント

定義ファイルタイプおよびバージョンを宣言する

@productステートメント

定義中のプログラム情報を宣言する

イベント拡張属性定義ブロック

イベント属性の表示について定義する

属性グループ定義ブロック

イベント属性のグループを定義する

属性表示順序定義ブロック

［イベント詳細］画面表示時の順序をIDごとに定義する

記述内容（文字コードの指定）

@encode

イベント拡張属性定義ファイルで使用する文字コードを指定します。

イベント拡張属性定義ファイルを追加で作成する場合は，@encodeステートメントで定義ファイルの文字コードを指定してください。

項目名には，@encodeステートメントに指定した文字コードで表現できる文字を記載します。また，イベント拡張属性定義ファイルは，@encodeステートメントに指定した文字コードで保存します。

次の場合，JP1/IM - Viewおよび統合オペレーション・ビューアーに表示される項目名が文字化けすることがあります。

項目名に，@encodeステートメントに指定した文字コードで表現できない文字を使用した場合

@encodeステートメントに指定した文字コード，ファイルを保存した文字コード，および@encodeステートメントに指定した文字コードが不一致の場合

@encodeステートメントが存在しない場合，および@encodeステートメントのあとに指定した文字コードに誤りがある場合は，文字コードが自動判別されます。ただし，定義ファイルの内容によっては正しく判別できないおそれがあります。

指定できる文字コードは次のとおりです。

C

EUCJIS

SJIS

UTF-8

GB18030

注意事項

定義ファイルをUTF-8で保存する場合は，BOM（byte order mark）が付与されないように保存してください。

次の場合，エラーが出力されます。

C，EUCJIS，SJIS，UTF-8，およびGB18030以外の文字コードを指定した場合

@encodeを定義ファイルの先頭以外に記述した場合

@encodeのあとに文字コードを指定しなかった場合

注意事項

他製品から提供されたイベント拡張属性定義ファイルを使用する場合，定義ファイルで使用されている文字コードと，@encodeステートメントに指定する文字コードが一致していることを確認してください。また，定義ファイルを転送して配置する際は，定義ファイルの文字コードを変換しないようにしてください。

記述内容（ファイル内ステートメントの生成規則）

@fileステートメント

この定義ファイルがイベント拡張属性定義ファイルであること，および定義記述フォーマットのバージョンが0300であることを宣言します。このステートメントは必須です。

なお，このステートメントは，ファイルの先頭行または@encodeの次の行に記述しなければなりません。記述しない場合，動作は保証できません。

構文

@file type="extended-attributes-definition", version="0300";

@productステートメント

ファイル内で定義する各ステートメントのプロダクト情報を定義します。

なお，定義する際には次の内容に注意してください。

指定値は，JP1イベントの拡張属性「PRODUCT_NAME」と一致させる必要があります。記述しない場合，動作は保証できません。

解析処理では，使用禁止文字や形式はチェックされません。指定した文字列がそのまま使用されます。

構文

@product name="プロダクト名";

name="プロダクト名"

プロダクト名は，スラントで区切られた半角英数字列です。次のどちらかの形式になります。

/会社名/シリーズ名/プロダクト名

/会社名/プロダクト名

定義例

定義情報ヘッダー用ステートメントの定義例を次に示します。

@file type="extended-attributes-definition", version="0300";
@product name="/HITACHI/JP1/CentralConsole";
@define-block type="event-attr-def";
block lang="Japanese", platform="NT";
attr name="E.SAMPLE_TIME", title="サンプル時刻";
attr name="E.SAMPLE_HOST", title="サンプルホスト";
attr name="E.SAMPLE_USER", title="サンプルユーザー";
@define-block-end;

記述内容（イベント拡張属性定義ファイルのブロックの生成規則）

イベント拡張属性定義ファイルに記述できるブロックについて説明します。なお，それぞれのブロックに記述できるステートメント以外のステートメントを記述した場合は，エラー出力され，該当するステートメントだけが無視されます。

イベント拡張属性定義ブロック

［イベント詳細］画面で，イベント属性名とその表示項目名（日本語名，英語名，中国語名）を関連づけます。このブロックは，定義ファイル内に複数個記述できます。ただし，ブロックのキーとなる属性（後述のblockステートメントの指定値）が同じブロックは，複数個記述できません。

なお，複数の言語を指定する場合は，後述のattrステートメントの属性名が指定した言語のすべてに対応している必要があります。

記述できるステートメント種別

このブロックには，次のステートメントを記述できます。

・blockステートメント

・attrステートメント

属性グループ定義ブロック

イベント拡張属性定義ブロックで定義したイベント属性をグループ化します。グループ化することにより，属性表示順序定義ブロック内のorderステートメントで属性を何度も定義する必要がなくなります。

このブロックは省略できます。

記述できるステートメント種別

このブロックには，次のステートメントを記述できます。

・blockステートメント

・groupステートメント

属性表示順序定義ブロック

イベント単位でそのイベントが詳細表示されたときに表示するイベント属性の順序や属性の表示名の順序を定義します。

記述できるステートメント種別

このブロックには，次のステートメントを記述できます。

・blockステートメント

・orderステートメント

記述内容（イベント拡張属性定義ブロック内のステートメント生成規則）

blockステートメント

ブロックの属性を定義します。このステートメントは，ブロックの先頭に1回だけ記述できます。

構文

block lang=言語種別, platform=プラットフォーム種別;

lang=言語種別

イベント拡張属性定義ブロックの言語種別を宣言します。指定できる言語種別を次に示します。

・"Japanese"

日本語環境時の定義であることを示します。

・"English"

英語環境時の定義であることを示します。

・"Chinese"

中国語環境時の定義であることを示します。

platform=プラットフォーム種別

ブロック内の定義が有効になるプラットフォームを指定します。

定義できるプラットフォームを次に示します。

・"base"

すべてのプラットフォームで有効にする場合に使用します。

platformパラメーターに「"base"」を指定する場合は，「,extended="false"」を記述する必要があります。

・"ユーザー定義"

ユーザー定義のプラットフォームで有効になります。「ユーザー定義」には，半角英数字列だけを使用できます。ただし，この文字列についてエラーチェックは実行されません。

platformパラメーターで指定したプラットフォーム名称は，JP1イベントの拡張属性「PLATFORM」と比較され，一致した場合にだけ詳細情報の処理の対象になります。したがって，ここに指定するプラットフォーム名と同一の文字列がJP1イベントの拡張属性「PLATFORM」にない場合は，処理の対象になりません。ただし，JP1イベントの発行時に拡張属性「PLATFORM」を設定していない場合は，「"base"」が指定されたものとしてファイルの解析が実行されます。

定義例

次の「attrステートメント」の定義例を参照してください。

attrステートメント

［イベント詳細］画面の属性名欄に表示する項目名と，属性値のタイプを指定します。このステートメントはブロック内に複数個指定できます。

なお，このステートメントで定義するのは，基本属性，および拡張属性の共通情報を除いた拡張属性の固有情報だけです。拡張属性の固有情報以外が指定された場合，エラーは出力されないで処理が続行されますが，表示時には標準提供の定義と重複して表示されます。標準提供の定義については，次の「定義例」を参照してください。

構文

attr name=属性名, title=表示項目名[,type="elapsed_time/

date_format:CLIENT"];

name=属性名

属性名を定義します。

表示可能な属性の一覧を次に示します。

項番

指定形式

属性の内容

1

"B.SEQNO"

イベントDB内通し番号

2

"B.IDBASE"

イベントID

3

"B.PROCESSID"

発行元プロセスID

4

"B.TIME"

登録時刻

5

"B.ARRIVEDTIME"

到着時刻

6

"B.USERID"

発行元ユーザーID

7

"B.GROUPID"

発行元グループID

8

"B.USERNAME"

発行元ユーザー名

9

"B.GROUPNAME"

発行元グループ名

10

"B.SOURCESERVER"

発行元イベントサーバ名

11

"B.DESTSERVER"

送信先イベントサーバ名

12

"B.SOURCESEQNO"

発行元イベントDB内通し番号

13

"B.MESSAGE"

メッセージ

14

"B.SOURCEIPADDR"

発行元IPアドレス

15

"E.拡張属性名"

拡張属性

title=表示項目名

［イベント詳細］画面表示時の属性名欄に表示する文字列を指定します。その際には，blockステートメントで指定した言語種別が使用されます。指定文字列に半角仮名を含めることはできません。

type="elapsed_time/date_format:CLIENT"

属性値のタイプと表示形式を指定します。属性値「elapsed_time」は，UTC 1970年1月1日00:00:00からの経過秒数を10進文字列で表記した値です。表示形式「date_format:CLIENT」は，表示するビューアーのローカルタイムゾーンで指定された時刻を使用して，時刻形式で書式化して表示することを示します。

定義例

JP1イベントの拡張属性の固有情報定義例を示します。プラットフォームが"W2K"で次の表の四つの拡張属性（固有情報）を表示させたい場合の「イベント拡張属性定義ブロック」の定義例を示します。

表2‒30　イベント拡張属性定義ブロックの定義例

画面表示名

拡張属性名(固有情報)

SAMPLE共通属性1

COMMON_ATTR1

SAMPLE共通属性2

COMMON_ATTR2

SAMPLE開始属性1

START_ATTR1

SAMPLE開始属性2

START_ATTR2

@define-block type="event-attr-def";
block lang="Japanese", platform="w2k";
attr name="E.COMMON_ATTR1",    title="SAMPLE共通属性1";
attr name="E.COMMON_ATTR2",    title="SAMPLE共通属性2";
attr name="E.START_ATTR1",     title="SAMPLE開始属性1";
attr name="E.START_ATTR2",     title="SAMPLE開始属性2";
@define-block-end;

記述内容（属性グループ定義ブロック内のステートメント生成規則）

blockステートメント

ブロックの属性を定義します。このステートメントは，ブロックの先頭に1回だけ記述できます。

なお，定義する際には次の内容に注意してください。

このブロックにはlangパラメーターは使用できません。

構文

block platform=プラットフォーム種別;

platform=プラットフォーム種別

ブロック内の定義が有効になるプラットフォームを指定します。指定できる値を次に示します。

指定できる値

説明

"base"

すべてのプラットフォームで有効にする場合に使用します。

platformパラメーターに「"base"」を指定する場合は，「,extended="false"」を記述する必要があります。

"ユーザー定義"

ユーザー定義のプラットフォームで有効になります。「ユーザー定義」には，半角英数字列だけを使用できます。ただし，この文字列についてエラーチェックは実行されません。

platformパラメーターで指定したプラットフォーム名称は，JP1イベントの拡張属性「PLATFORM」と比較され，一致した場合にだけ詳細情報の処理の対象となります。したがって，ここに指定するプラットフォーム名と同一の文字列がイベントの拡張属性「PLATFORM」にない場合は，処理の対象となりません。ただし，JP1イベントの発行時に拡張属性「PLATFORM」を設定していない場合は，「"base"」が指定されたものとしてファイルの解析が実行されます。

定義例

次の「groupステートメント」の定義例を参照してください。

groupステートメント

［イベント詳細］画面上に表示する属性の並び順に名称を付けてグループ化します。このステートメントはブロック内に複数個指定できます。

構文

group name=グループ名, attrs=属性名並び;

name=グループ名

属性名並びに付ける名称を指定します。名称は，32バイト以内の半角英数字で指定します。大文字と小文字は区別されません。ここで付けた名称は，定義ファイル内のorderブロック中で使用できます。

attrs=属性名並び

グループ化する属性を一つ以上並べて指定します。複数個並べた場合は，［イベント詳細］画面に上からその順序で表示されます。指定形式は次のとおりです。

・一つの場合：attrs="E.A0"

・複数の場合：attrs="E.A0|E.A1"

なお，指定できる属性は拡張属性の固有情報だけです。基本属性または拡張属性の共通情報を指定した場合は，指定した属性値が［イベント詳細］画面上に複数個表示されます。

定義例

JP1イベントの基本属性および拡張属性の共通情報の定義を示します。これらの定義は，イベント拡張属性定義ファイルに標準で提供されています。

@define-block type="event-attr-group-def";
block platform="base", extended="false";
group name="BASE",   attrs="B.GROUPID|B.GROUPNAME|B.IDBASE|B.PROCESSID|B.SEQNO|B.SOURCEIPADDR|
B.SOURCESEQNO|B.SOURCESERVER|B.TIME|B.USERID|B.USERNAME|B.ARRIVEDTIME";
group name="COMMON", attrs="E.SEVERITY|E.USER_NAME|E.PRODUCT_NAME|E.OBJECT_TYPE|E.OBJECT_NAME|
E.ROOT_OBJECT_TYPE|E.ROOT_OBJECT_NAME|E.OBJECT_ID|E.OCCURRENCE|
E.START_TIME|E.END_TIME|E.RESULT_CODE";
@define-block-end;

記述内容（属性表示順序定義ブロック内のステートメント生成規則）

blockステートメント

属性表示順序定義ブロックに依存するブロック属性を定義します。このステートメントは，ブロックの先頭に1回だけ記述できます。

なお，定義する際には次の内容に注意してください。

このブロックではlangパラメーターは使用できません。

構文

block platform=プラットフォーム種別;

platform=プラットフォーム種別

ブロック内の定義が有効になるプラットフォームを指定します。定義できるプラットフォームを次に示します。

表2‒31　指定できるプラットフォーム

指定できる値

説明

"base"

すべてのプラットフォームで有効にする場合に使用します。

platformパラメーターに「"base"」を指定する場合は，「,extended="false"」を記述する必要があります。

"ユーザー定義"

ユーザー定義のプラットフォームで有効になります。「ユーザー定義」には，半角英数字列だけを使用できます。ただし，この文字列についてエラーチェックは実行されません。

platformパラメーターで指定したプラットフォーム名称は，JP1イベントの拡張属性「PLATFORM」と比較され，一致した場合にだけ詳細情報の処理の対象となります。したがって，ここに指定するプラットフォーム名と同一の文字列がイベントの拡張属性「PLATFORM」にない場合は，処理の対象となりません。ただし，JP1イベントの発行時に拡張属性「PLATFORM」を設定していない場合は，「"base"」が指定されたものとしてファイルの解析が実行されます。

定義例

次の「orderステートメント」の定義例を参照してください。

orderステートメント

［イベント詳細］画面上に表示する属性とその並び順をIDごとに定義します。このステートメントはブロック内に複数個指定できます。

構文

order id=イベントID定義文字列, attrs=属性名並び;

id=イベントID定義文字列

attrsパラメーターで指定した順序で属性を表示するイベントIDを一つ指定します。

指定形式は次のとおりです。

id="200"

イベントIDは，8けた以内の16進数文字列で指定します。8けた未満の場合，先頭に0を補って8けたにする必要はありません。16進数文字列の英字（a〜f）は，大文字と小文字のどちらでもかまいません。

IDの範囲指定はできません。

attrs=属性名並び

表示する属性，グループ，またはその両方が混在したものを並べて指定します。複数個並べた場合は，［イベント詳細］画面に上からその順序で表示されます。

指定形式は次のとおりです。

・一つの場合：attrs="E.A0"

・複数の場合：attrs="E.A0|E.A1|GROUP1"

groupステートメントの場合と同様に，指定できる属性は固有の拡張属性だけです。基本属性または共通の拡張属性を指定した場合は，指定した属性値が［イベント詳細］画面上に複数個表示されます。

定義例

イベントIDが00001000の場合にBASEグループとCOMMONグループを表示する定義例を次に示します。

@define-block type="event-attr-order-def";
block platform="base", extended="false";
order id=00001000, attrs="BASE|COMMON"
@define-block-end;

イベント拡張属性定義ファイルの定義例

@encode UTF-8
@file type="extended-attributes-definition",version="0300";
@product name="/HITACHI/JP1/SAMPLE";
@define-block type="event-attr-def";
block platform="base", lang="Japanese", extended="false";
attr name="E.SAMPLE_CLUSTER_NAME", title="クラスタ名";
attr name="E.SAMPLE_PRINT_SERVER_NAME", title="プリントサーバ名";
attr name="E.SAMPLE_PRINTER_NAME", title="プリンタ名";
attr name="E.SAMPLE_PORT_NAME", title="ポート名";
@define-block-end;
@define-block type="event-attr-group-def";
block platform="base", extended="false";
group name="_PRINTER_INFO",
attrs="E.SAMPLE_PRINT_SERVER_NAME|E.SAMPLE_PRINTER_NAME";
group name="_CLUSTER_INFO", attrs="E.SAMPLE_CLUSTER_NAME|E.SAMPLE_PORT_NAME";
@define-block-end;
@define-block type="event-attr-order-def";
block platform="base", extended="false";
order id="00003100",attrs="_PRINTER_INFO";
order id="00003101",attrs="_CLUSTER_INFO";
order id="00003102", attrs="_PRINTER_INFO|_CLUSTER_INFO";

@define-block-end;

標準提供されているイベント拡張属性定義ファイル

JP1イベントの基本属性および拡張属性の共通情報の定義を次に示します。これらの定義は，イベント拡張属性定義ファイルとして標準提供されています。

@define-block type="event-attr-def";
block lang="Japanese", platform="base", extended="false";
attr name="B.SEQNO",            title="イベントDB内通し番号";
attr name="B.IDBASE",           title="イベントID";
attr name="B.PROCESSID",        title="発行元プロセスID";
attr name="B.TIME",             title="登録時刻", type="elapsed_time_in_milli/date_format:CLIENT";
attr name="B.ARRIVEDTIME",      title="到着時間", type="elapsed_time_in_milli/date_format:CLIENT";
attr name="B.USERID",           title="発行元ユーザーID";
attr name="B.GROUPID",          title="発行元グループID";
attr name="B.USERNAME",         title="発行元ユーザー名";
attr name="B.GROUPNAME",        title="発行元グループ名";
attr name="E.JP1_SOURCEHOST",   title="発生元ホスト名";
attr name="B.SOURCESERVER",     title="発行元イベントサーバ名";
attr name="B.SOURCEIPADDR",     title="発行元IPアドレス";
attr name="B.SOURCESEQNO",      title="発行元イベントDB内通し番号";
attr name="E.SEVERITY",         title="重大度";
attr name="E.USER_NAME",        title="ユーザー名";
attr name="E.PRODUCT_NAME",     title="プロダクト名";
attr name="E.OBJECT_TYPE",      title="オブジェクトタイプ";
attr name="E.OBJECT_NAME",      title="オブジェクト名";
attr name="E.ROOT_OBJECT_TYPE", title="登録名タイプ";
attr name="E.ROOT_OBJECT_NAME", title="登録名";
attr name="E.OBJECT_ID",        title="オブジェクトID";
attr name="E.OCCURRENCE",       title="事象種別";
attr name="E.START_TIME",       title="開始時刻", type="elapsed_time/date_format:CLIENT";
attr name="E.END_TIME",         title="終了時刻",type="elapsed_time/date_format:CLIENT";
attr name="E.RESULT_CODE",      title="終了コード";
attr name="E.JP1_GENERATE_SOURCE_SEQNO", title="関連イベントDB内通し番号";
attr name="E.JP1_GENERATE_NAME",         title="相関イベント発行条件名";
attr name="E.@JP1IM_ORIGINAL_SEVERITY",  title="重大度(変更前)";
attr name="E.JP1_IMSUPPRESS_ID",   title="監視抑止ID";
attr name="E.JP1_IMSUPPRESS_NAME", title="繰り返しイベント条件名";
attr name="E.JP1_TRAP_ID",      title="監視ID";
attr name="E.JP1_TRAP_NAME",    title="監視名";
attr name="E.@JP1IM_CHANGE_MESSAGE_NAME",    title="表示メッセージ変更定義名";
attr name="E.JP1_IMCOMEXCLUDE_ID",   title="共通除外条件群ID";
attr name="E.JP1_IMCOMEXCLUDE_NAME", title="共通除外条件群名";
attr name="E.JP1_IMCOMEXCLUDE_TARGET", title="共通除外条件群除外対象";
attr name="E.SUGGESTION_ID", title="提案ID";
attr name="E.TREE_SID", title="ツリーのSID";
@define-block-end;

イベント拡張属性定義ファイル（拡張ファイル）

形式

[@encode 文字コード]
@file type="extended-attributes-definition", version="0300";
@define-block type="event-attr-def";
attr name="属性名", title="項目名";
・・・
@define-block-end;

ファイル

template_extend_attr_ja.conf（日本語の拡張ファイル）

template_extend_attr_ja.conf.model（日本語の拡張ファイルのモデルファイル）

template_extend_attr_en.conf（英語の拡張ファイル）

template_extend_attr_en.conf.model（英語の拡張ファイルのモデルファイル）

template_extend_attr_zh.conf（中国語の拡張ファイル）

template_extend_attr_zh.conf.model（中国語の拡張ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Consoleパス¥conf¥console¥attribute¥extend

論理ホストのとき

共有フォルダ¥JP1Cons¥conf¥console¥attribute¥extend

UNIXの場合

物理ホストのとき

/etc/opt/jp1cons/conf/console/attribute/extend

論理ホストのとき

共有ディレクトリ/jp1cons/conf/console/attribute/extend

説明

イベント拡張属性定義ファイル（拡張ファイル）は，項目名でJP1/IM - Viewおよび統合オペレーション・ビューアーの画面に表示したり，項目名でイベントレポート出力したりする固有の拡張属性を定義します。

JP1/IM - Managerに同梱する定義ファイルは，ファイル名の先頭に「template_」が付いています。「extend_attr_ja.conf」のようにリネームしてから設定してください。

拡張ファイル以外のイベント拡張属性定義ファイルの詳細については，「イベント拡張属性定義ファイル」（2.　定義ファイル）を参照してください。

作成契機

JP1/IM - Managerインストール時に作成します。

定義の反映時期

次のどちらかが成立する場合に，イベント拡張属性定義ファイル（拡張ファイル）の記述内容を反映します。

JP1/IM - Managerを起動した場合

jco_spmd_reloadコマンドを実行した場合

なお，JP1/IM - Viewまたは統合オペレーション・ビューアーに接続中に定義を反映した場合は，JP1/IM - Viewまたは統合オペレーション・ビューアーの再起動が必要です。

記述内容

イベント拡張属性定義ファイル（拡張ファイル）は，項目名で画面に表示したり，項目名でイベントレポート出力したりする固有の拡張属性を定義します。拡張ファイルはJP1/IM - Managerの定義ファイルで，JP1/IM - Managerの動作言語ごとに定義します。

複数の言語の拡張ファイルをJP1/IM - Managerに配置する場合は，すべての拡張ファイルに指定する属性名を一致させる必要があります。JP1/IM - Viewおよび統合オペレーション・ビューアーに表示する属性はシステム全体で一意に決まるため，JP1/IM - Viewおよび統合オペレーション・ビューアーの言語ごとに異なる属性は表示できません。

すべての拡張ファイルに指定した属性名に不一致がある場合は，jcoattrfcheckコマンドで拡張ファイルをチェックした際，KAVB5820-Wの警告メッセージを出力します。また，拡張ファイルに指定していない属性がJP1/IM - Viewまたは統合オペレーション・ビューアーに表示される場合があります。例えば，英語の拡張ファイルにだけ「E.SYSTEM」という属性名を指定している場合，日本語や中国語のJP1/IM - Viewにも「E.SYSTEM」が表示されます。このとき，日本語や中国語のJP1/IM - Viewに表示される「E.SYSTEM」の項目名は，属性名と同じ「E.SYSTEM」となります。

なお，JP1/IMには，イベント拡張属性定義ファイル（拡張ファイル）の記述内容をチェックするためのコマンド「jcoattrfcheck」が用意されています。このコマンドの詳細については，「jcoattrfcheck」（1.　コマンド）を参照してください。

イベント拡張属性定義ファイル（拡張ファイル）には，次のステートメントとブロックを記述できます。

表2‒32　イベント拡張属性定義ファイル（拡張ファイル）に記述できるステートメントおよびブロック

ステートメントまたはブロック

意味

@encodeステートメント

定義ファイルで使用している文字コードを指定する

@fileステートメント

定義ファイルタイプおよびバージョンを宣言する

イベント拡張属性定義ブロック

イベント属性の表示について定義する

表に示したステートメントおよびブロック以外を記述した場合は，記述内容は無視されます。また，イベント拡張属性定義ファイル（拡張ファイル）の記述に誤りがある場合は，誤りのある行を無視して有効な行だけで動作します。ただし，blockステートメント（block lang="";）のように，拡張ファイル以外のイベント拡張属性定義ファイルでは読み込むが，イベント拡張属性定義ファイル（拡張ファイル）では読み込まない定義の記述があり，それが不正だった場合はエラーとなります。拡張ファイル以外のイベント拡張属性定義ファイルの詳細については，「イベント拡張属性定義ファイル」（2.　定義ファイル）を参照してください。

記述内容（文字コードの指定）

@encode

イベント拡張属性定義ファイル（拡張ファイル）で使用する文字コードを指定します。

項目名には，@encodeステートメントに指定した文字コードで表現できる文字を記載します。また，イベント拡張属性定義ファイル（拡張ファイル）は，@encodeステートメントに指定した文字コードで保存します。

次の場合，JP1/IM - Viewおよび統合オペレーション・ビューアーに表示される項目名が文字化けすることがあります。

項目名に，@encodeステートメントに指定した文字コードで表現できない文字を使用した場合

@encodeステートメントに指定した文字コード，ファイルを保存した文字コード，および@encodeステートメントに指定した文字コードが不一致の場合

@encodeステートメントがない場合，および@encodeステートメントのあとに指定した文字コードに誤りがある場合は，文字コードが自動判別されます。ただし，定義ファイルの内容によっては正しく判別できないおそれがあります。

指定できる文字コードは次のとおりです。

表2‒33　指定できる定義ファイルの文字コード

項番

ファイルの文字コード

指定可否

Linux以外

Linux

1

C

○

○

2

EUCJIS

○

×

3

SJIS

○

○※

4

UTF-8

○

○

5

GB18030

○

○

（凡例）

○：指定できる

×：指定できない

注※

SUSE Linuxの場合だけ指定できます。

注意事項

定義ファイルをUTF-8で保存する場合は，BOM（byte order mark）が付与されないように保存してください。

次の場合，エラーが出力されます。

C，EUCJIS，SJIS，UTF-8，およびGB18030以外の文字コードを指定した場合

@encodeを定義ファイルの先頭以外に記述した場合

@encodeのあとに文字コードを指定しなかった場合

記述内容（ファイル内ステートメントの生成規則）

@fileステートメント

この定義ファイルがイベント拡張属性定義ファイル（拡張ファイル）であること，および定義記述フォーマットのバージョンが0300であることを宣言します。このステートメントは必須です。

なお，このステートメントは，ファイルの先頭行に記述しなければなりません。記述しない場合，動作は保証できません。

構文

@file type="extended-attributes-definition", version="0300";

記述内容（イベント拡張属性定義ファイルのブロックの生成規則）

イベント拡張属性定義ファイル（拡張ファイル）に記述できるブロックについて説明します。なお，それぞれのブロックに記述できるステートメント以外のステートメントを記述した場合は，エラー出力され，該当するステートメントだけが無視されます。

イベント拡張属性定義ブロック

イベント属性の属性名とその表示項目名を関連づけます。このブロックは，定義ファイル内に一つだけ記述できます。イベント拡張属性定義ブロックを複数記述した場合，エラーや警告は出力されず，二つ目以降のイベント拡張属性定義ブロックは無視されます。

記述できるステートメント種別

このブロックには，次のステートメントを記述できます。

・attrステートメント

記述内容（イベント拡張属性定義ブロック内のステートメント生成規則）

attrステートメント

項目名で画面に表示したり，項目名でイベントレポート出力したりする固有の拡張属性の属性名と，属性名に対応する項目名を指定します。このステートメントはブロック内に100個まで指定できます。100個を超えるattrステートメントを指定した場合は，jcoattrfcheckコマンドでのチェック時にKAVB5803-Wのメッセージが出力されます。

構文

attr name=属性名, title=項目名;

name=属性名

拡張属性名を定義します。値の形式は次のとおりです。

"E.拡張属性名"

属性名は，先頭が英大文字で英大文字，数字，およびアンダースコア（_）から構成される32バイトまでの名称を指定できます。

32バイトを超える拡張属性名を指定した場合は，jcoattrfcheckコマンドでのチェック時やjcoevtreportコマンドの実行時にKAVB5803-Wのメッセージが出力されます。また，JP1/IM - Managerの起動時やjco_spmd_reloadコマンドの実行時にイベント拡張属性定義ファイル（拡張ファイル）を読み込んだ際，KAVB5822-Wのメッセージが出力されます。

指定できる属性は固有の拡張属性だけです。ただし，発生元ホスト名（E.JP1_SOURCEHOST）や監視名（E.JP1_TRAP_NAME）など，イベント拡張属性定義ファイルの標準ファイル（default.conf）に指定した拡張属性と重複する属性は指定できません。イベント拡張属性定義ファイルの標準ファイル（default.conf）と重複する拡張属性を指定した場合は，標準ファイルに指定した項目名が適用されます。

なお，イベント拡張属性定義ファイルの標準ファイル（default.conf）と重複する拡張属性を指定した場合，jcoevtreportコマンドの実行時やjcoattrfcheckコマンドの実行時にイベント拡張属性定義ファイル（拡張ファイル）を読み込んだ際，KAVB5802-W※のメッセージが出力されます。jcoevtreportコマンドは，イベント拡張属性定義ファイル（拡張ファイル）に指定された重複する属性を無視して動作します。また，JP1/IM - Managerの起動時やjco_spmd_reloadコマンドの実行時にイベント拡張属性定義ファイル（拡張ファイル）を読み込んだ際，KAVB5822-Wメッセージが出力されます。JP1/IM - Managerは，イベント拡張属性定義ファイル（拡張ファイル）に指定された重複する属性を無視して動作します。

基本属性（B.属性名）やIM属性（E.@属性名）など，拡張属性（E.属性名）以外を指定した場合は，jcoevtreportコマンドの実行時やjcoattrfcheckコマンドの実行時にイベント拡張属性定義ファイル（拡張ファイル）を読み込んだ際，KAVB5821-W※のメッセージが出力されます。また，JP1/IM - Managerの起動時やjco_spmd_reloadコマンドの実行時にイベント拡張属性定義ファイル（拡張ファイル）を読み込んだ際，KAVB5822-Wメッセージが出力されます。

注※　KAVB5802-WまたはKAVB5821-Wのメッセージが出力されていても，jcoevtreportコマンドでレポート出力に成功した場合，およびjcoattrfcheckコマンドで定義ファイルのチェックが完了した場合は，各コマンドの戻り値は0（正常終了）になります。

複数の言語の拡張ファイルをJP1/IM - Managerに配置する場合は，すべてのイベント拡張属性定義ファイル（拡張ファイル）に指定する属性名を一致させる必要があります。すべてのイベント拡張属性定義ファイル（拡張ファイル）に指定した属性名に不一致がある場合は，jcoevtreportコマンドの実行時やjcoattrfcheckコマンドの実行時にイベント拡張属性定義ファイル（拡張ファイル）を読み込んだ際，KAVB5820-Wのメッセージが出力されます。また，JP1/IM - Managerの起動時やjco_spmd_reloadコマンドの実行時にイベント拡張属性定義ファイル（拡張ファイル）を読み込んだ際，KAVB5822-Wメッセージが出力されます。

title=項目名

固有の拡張属性の項目名を定義します。項目名には，@encodeステートメントで指定した文字コードで表現できる文字を使用します。@encodeステートメントで指定した文字コードで表現できない文字を使用した場合，JP1/IM - Viewおよび統合オペレーション・ビューアーに表示される項目名が文字化けします。

また，jcoevtreportコマンドで出力するレポートの文字コードで表現できない文字を使用した場合，CSVファイルに出力される項目名が文字化けします。

項目名で画面に表示したり，項目名でイベントレポート出力したりする固有の拡張属性の項目名を文字列で指定します。このパラメーターには，指定文字列に半角仮名および「,（コンマ）」は使用できません。半角仮名および「,（コンマ）」がある場合，正常に出力できません。

項目名の最大長は255バイトです。255バイトを超える項目名を指定した場合は，jcoattrfcheckコマンドでのチェック時やjcoevtreportコマンドの実行時にKAVB5803-Wのメッセージが出力されます。また，JP1/IM - Managerの起動時やjco_spmd_reloadコマンドの実行時にイベント拡張属性定義ファイル（拡張ファイル）を読み込んだ際，KAVB5822-Wのメッセージが出力されます。

注意事項

イベント拡張属性定義ファイルの標準ファイル（default.conf）とイベント拡張属性定義ファイル（拡張ファイル）で重複する固有の拡張属性を指定した場合，［イベントコンソール］画面のイベント一覧やイベントレポート出力で出力されるCSVのヘッダーには，イベント拡張属性定義ファイルの標準ファイル（default.conf）に指定した固有の拡張属性の項目名が表示または出力されます。

定義例

イベント拡張属性定義ファイル（拡張ファイル）の定義例を次に示します。

@encode UTF-8
@file type="extended-attributes-definition", version="0300";
@define-block type="event-attr-def";
attr name="E.SYSTEM",    title="システム名";
attr name="E.ROLE",     title="サーバ用途";
@define-block-end;

共通除外条件拡張定義ファイル

形式

DESC_VERSION=ファイルバージョン
#コメント行
def 条件群名
    [cmt コメント]
    id 条件群ID
    [valid {true | false}]
    [ex-target 除外対象]
    [date 開始日-終了日]
    [rtime 開始時刻-終了時刻]
    [week 曜日]
    cnd
        イベント条件
    end-cnd
end-def

def 条件群名2
・・・
end-def
   :

ファイル

任意のファイルを使用します。

格納先ディレクトリ

Windowsの場合

任意のフォルダ

UNIXの場合

任意のディレクトリ

説明

拡張モードの共通除外条件のイベント条件や適用期間を定義するファイルです。

このファイルは，JP1/IM - Managerの動作する言語コードで記述してください。

次の場合に共通除外条件拡張定義ファイルのバックアップファイルがcommon_exclude_filter_backup.confとして出力されます。

jcochcefmodeコマンドで共通除外条件の動作モードを基本モードから拡張モードに変更した場合で正規表現に問題があるとき

動作モードを拡張モードから基本モードに変更した場合

jcochcefmodeコマンドおよび共通除外条件拡張定義ファイルのバックアップファイルについては，「jcochcefmode」（1.　コマンド）を参照してください。

なお，イベント取得フィルター（互換用）を使用している場合，共通除外条件を使用できません。イベント取得フィルター（互換用）を使用している場合は，jcochafmodeコマンドでイベント取得フィルターに変更してください。jcochafmodeコマンドについては，「jcochafmode（UNIX限定）」（1.　コマンド）を参照してください。

共通除外条件拡張定義ファイルの最大サイズは，シフトJISコード換算で15メガバイトです。

なお，最大サイズは，共通除外条件拡張定義ファイルのサイズと追加共通除外条件定義のサイズの合計となります。そのため，共通除外条件拡張定義ファイルがシフトJISコード換算で15メガバイトになるように定義を記述すると追加共通除外条件を追加できなくなります。

定義の反映時期

jcochfilterコマンドの-efオプションを指定すると，定義内容が反映されます。jcochfilterコマンドについては，「jcochfilter」（1.　コマンド）を参照してください。

記述内容

DESC_VERSION=ファイルバージョン

共通除外条件拡張定義ファイルのバージョンを表します。指定できる値は1または2です。省略した場合，「1」を仮定します。

#コメント行

#で始まる行は，コメント扱いとなります。

def〜end-def（定義ブロック）

拡張モードの共通除外条件定義の開始と終了のパラメーターです。def〜end-defブロックは省略できます。def以降には，拡張モードの共通除外条件の条件群名を記述します。「def△△△条件群名1△△△条件群名2△△△」と指定した場合，「△△条件群名1△△△条件群名2△△△」が定義名となります（△は半角スペースを表す）。

条件群名は，共通除外条件拡張定義ファイル内でユニークになるようにシフトJISコード換算で1〜50バイトの文字列で指定します。指定できる文字は，制御文字（0x00〜0x1F，0x7F〜0x9F）以外の文字列です。

定義ブロックは最大2,500件記述できます。

なお，最大件数は，共通除外条件拡張定義ファイルに記述した定義ブロック数と追加共通除外条件群の件数の合計となります。そのため，共通除外条件群拡張定義ファイルに定義ブロックを最大の2,500件記述すると，追加共通除外条件群を作成できなくなります。

cmt コメント

拡張モードの共通除外条件の説明を記述します。このパラメーターは省略できます。コメントはシフトJISコード換算で1〜1,024バイトの文字列で指定します。指定できる文字は，制御文字（0x00〜0x1F，0x7F〜0x9F）以外の文字列です。

id 条件群ID

拡張モードの共通除外条件の条件群IDを指定するパラメーターです。0以上，最大定義数から1を引いた値以下で指定できます。このパラメーターは省略できません。

idパラメーターに指定できるIDは，0〜2,499です。

valid {true | false}

拡張モードの共通除外条件を有効にするかどうかを指定するパラメーターです。

大文字・小文字を区別しません。省略した場合，trueが指定されます。

ex-target 除外対象

除外対象を指定するパラメーターです。共通除外条件に一致するJP1イベントを自動アクションの実行対象外にする場合，除外対象にactionの文字列を指定します。大文字小文字の区別はありません。このパラメーターを省略した場合，共通除外条件に一致するJP1イベントは取得対象外になります。このパラメーターは，定義ブロック内に一つだけ指定できます。また，共通除外条件拡張定義ファイルのバージョンが2の場合だけ定義できます。

date 開始日-終了日

拡張モードの共通除外条件を適用する期間を指定するパラメーターです。このパラメーターは省略できます。次の形式で指定します。

　date△YYYYMMDD-YYYYMMDD

　（凡例）△：半角スペース

指定できる期間は1970/01/01〜2099/12/31です。

このパラメーターを省略した場合，常に適用となります。

開始日を省略した場合，拡張モードの共通除外条件を定義した時点から終了日まで適用されます。開始日を省略するには次の形式で終了日だけを指定します。

　date△-YYYYMMDD

　（凡例）△：半角スペース

終了日を省略した場合，開始日から常に適用となります。終了日を省略するには次のどちらかの形式で開始日だけを指定します。

　date△YYYYMMDD

　date△YYYYMMDD-

　（凡例）△：半角スペース

適用期間については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「4.2.7　共通除外条件」を参照してください。

rtime 開始時刻-終了時刻

拡張モードの共通除外条件を適用する時刻を指定するパラメーターです。このパラメーターは省略できます。次の形式で指定します。

　rtime△HHMM-HHMM

　（凡例）△：半角スペース

このパラメーターを省略した場合，開始時刻を9:00，終了時刻を開始時刻の24時間後と仮定します。また，開始時刻は省略できません。終了時刻を省略した場合，開始時刻から24時間後まで適用されます。

終了時刻を省略するには次の形式で開始時刻だけを指定します。

　rtime△HHMM

　rtime△HHMM-

　（凡例）△：半角スペース

開始時刻，終了時刻に指定できる時刻は00:00〜23:59です。

開始時刻より前の時刻を終了時刻に指定した場合，終了時刻を翌日の時刻として動作します。また，開始時刻と終了時刻に同じ時刻を指定した場合も同様に，終了時刻を翌日の時刻として動作します。

パラメーターの終了時刻の省略パターンを次の表に示します。

表2‒34　rtimeパラメーターの終了時刻の省略パターン

項番

省略パターン

説明

1

rtime△開始時刻

開始時刻から24時間後まで適用する。

2

rtime△開始時刻-

3

rtime△開始時刻-終了時刻

開始日から終了日まで適用する。

（凡例）

△：半角スペース

開始時刻，終了時刻は，HHMMの形式で指定してください。HHには時，MMには分を指定します。

適用期間には，開始時刻は含まれますが，終了時刻は含まれません。例えば，曜日指定を月曜日，開始時刻を21:00，終了時刻を03:00に設定した場合，適用期間は，月曜日の21:00:00から，翌火曜日の02:59:59までとなります。

適用期間については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「4.2.7　共通除外条件」を参照してください。

week 曜日

拡張モードの共通除外条件を適用する曜日を指定するパラメーターです。このパラメーターは省略できます。複数の曜日を指定する場合は「,」（半角コンマ）で区切ります。次の形式で指定します。

　week△0,1,2,3,4,5,6

　（凡例）△：半角スペース

曜日と数値は次のとおり対応しています。

日曜日：0

月曜日：1

火曜日：2

水曜日：3

木曜日：4

金曜日：5

土曜日：6

曜日を省略した場合，すべての曜日として適用されます。

適用期間については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「4.2.7　共通除外条件」を参照してください。

cnd〜end-cnd（イベント条件ブロック）

拡張モードの共通除外条件のイベント条件を指定する，ブロックの開始と終了のパラメーターです。イベント条件ブロックは，定義ブロック内に必ず一つ指定する必要があります。省略はできません。cndおよびend-cndパラメーターの前後のタブやスペースは，無視されます。

一つの定義ブロック内に複数のイベント条件ブロックを指定することはできません。

イベント条件

拡張モードの共通除外条件で除外するJP1イベントの条件を指定します。イベント条件ブロックには，0〜256件のイベント条件を指定できます。イベント条件とイベント条件は，AND条件となります。次の形式で指定します。

　属性名△比較キーワード△オペランド

　（凡例）△：半角スペース

なお，半角スペース，またはタブだけで構成された行は，無視して処理を続行します。

属性名

属性名には，比較したい属性の名称を記述します。基本属性を指定する場合は，名称の前に「B.」を付けます。拡張属性（共通情報），拡張属性（固有情報）を指定する場合は，名称の前に「E.」を付けます。英大文字・英小文字を区別します。

指定できる属性名と比較キーワードの組み合わせおよびオペランドを次に示します。

表2‒35　指定できる属性名と比較キーワードの組み合わせおよびオペランド

項番

項目

属性名

比較

キーワード

オペランド

1

イベントID

B.ID

と一致する

と一致しない

JP1イベントのイベントIDを指定する。

最大100件複数指定できる。

16進数形式で指定する。

英大文字・英小文字は区別しない。

指定できる範囲は0〜7FFFFFFFである。

2

登録要因

B.REASON

と一致する

と一致しない

JP1イベントの登録要因を設定する。

最大100件複数指定できる。

指定できる範囲は，-2,147,483,648〜2,147,483,647である。

3

発行元プロセスID

B.PROCESSID

と一致する

と一致しない

JP1イベントの発行元アプリケーションのプロセス別IDを指定する。

最大100件複数指定できる。

指定できる範囲は，-2,147,483,648〜2,147,483,647である。

4

登録時刻

B.TIME

時刻範囲

JP1イベントが発行元ホストのイベントDBに登録された時刻を指定する。

JP1/IM - Managerが稼働している環境の時刻で指定する。

範囲開始日時および範囲終了日時，または期間を指定する。

範囲開始日時≦時刻≦範囲終了日時が成立する場合に比較できる。

5

到着時刻

B.ARRIVEDTIME

時刻範囲

JP1イベントがマネージャーホストのイベントDBに登録された時刻を指定する。

JP1/IM - Managerが稼働している環境の時刻で指定する。

範囲開始日時および範囲終了日時，または期間を指定する。

6

発行元ユーザーID

B.USERID

と一致する

と一致しない

JP1イベントの発行元プロセスのユーザーIDを指定する。

最大100件複数指定できる。

指定できる範囲は，-2,147,483,648〜2,147,483,647である。

7

発行元グループID

B.GROUPID

と一致する

と一致しない

JP1イベントの発行元プロセスのグループIDを指定する。

最大100件複数指定できる。

指定できる範囲は，-2,147,483,648〜2,147,483,647である。

8

発行元ユーザー名

B.USERNAME

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

JP1イベントの発行元プロセスのユーザー名を指定する。

最大100件複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。

英大文字・英小文字は区別する。

9

発行元グループ名

B.GROUPNAME

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

JP1イベントの発行元プロセスのグループ名を指定する。

最大100件複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。

英大文字・英小文字は区別する。

10

発行元IPアドレス

B.SOURCEIPADDR

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

JP1イベントの発行元イベントサーバに対応するIPアドレスを指定する。

最大100件複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。

IPv6アドレスを指定する場合は，次に示すとおり，0〜9およびa〜fの4桁の16進数で指定する。英字部分は，英小文字で指定する。

（例）0011:2233:4455:6677:8899:aabb:ccdd:eeff

英字部分を英大文字にしたり，IPv4射影アドレス，IPv4互換アドレス，およびIPv6アドレスの省略形式を指定したりはできない。

11

発行元イベントサーバ名(登録ホスト名)※

B.SOURCESERVER

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

JP1イベントの登録ホスト名（イベントサーバ名）を指定する。

最大100件複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。

英大文字・英小文字は区別する。

12

メッセージ

B.MESSAGE

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

JP1イベントのメッセージを設定する。

最大100件複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。

英大文字・英小文字は区別する。

13

重大度

(重大度変更機能が有効の場合，変更前の重大度を指定する)

E.SEVERITY

属性有

属性無

と一致する

JP1イベントの重大度の有無，種類を指定できる。

比較キーワードが「と一致する」の場合，"Emergency"（緊急），"Alert"（警戒），"Critical"（致命的），"Error"（エラー），"Warning"（警告），"Notice"（通知），"Information"（情報），"Debug"（デバッグ）の中から複数指定できる。

14

ユーザー名

E.USER_NAME

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

JP1イベントを発行したユーザー名を指定する。

最大100件複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。

英大文字・英小文字は区別する。

15

プロダクト名

E.PRODUCT_NAME

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

JP1イベントを発行したプログラムの名称を指定する。

最大100件複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。

英大文字・英小文字は区別する。

16

オブジェクトタイプ

E.OBJECT_TYPE

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

JP1イベントのオブジェクトの種類を指定する。

最大100件複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。

英大文字・英小文字は区別する。

17

オブジェクト名

E.OBJECT_NAME

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

JP1イベントのオブジェクト名を指定する。

最大100件複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。

英大文字・英小文字は区別する。

18

登録名タイプ

E.ROOT_OBJECT_TYPE

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

JP1イベントの登録名タイプを指定する。

最大100件複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。

英大文字・英小文字は区別する。

19

登録名

E.ROOT_OBJECT_NAME

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

JP1イベントの登録名を指定する。

最大100件複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。

英大文字・英小文字は区別する。

20

オブジェクトID

E.OBJECT_ID

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

JP1イベントのオブジェクトタイプを指定する。

最大100件複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。

英大文字・英小文字は区別する。

21

事象種別

E.OCCURRENCE

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

JP1イベントの事象種別を指定する。

最大100件複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。

英大文字・英小文字は区別する。

22

開始時刻

E.START_TIME

時刻範囲

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

JP1イベントの実行開始または再実行開始の時刻を設定する。

比較キーワードが「時刻範囲」の場合

・範囲開始日時および範囲終了日時，または期間を指定する。

・範囲開始日時≦時刻≦範囲終了日時が成立する場合に比較できる。

・比較対象の属性が10進数の場合，通算秒として比較する。

比較キーワードが「時刻範囲」以外の場合

・最大100件複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。

・オペランドを文字列として指定した比較キーワードで比較する。

23

終了時刻

E.END_TIME

時刻範囲

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

JP1イベント実行終了の時刻を設定する。

比較キーワードが「時刻範囲」の場合

・範囲開始日時および範囲終了日時，または期間を指定する。

・範囲開始日時≦時刻≦範囲終了日時が成立する場合に比較できる。

・比較対象の属性が10進数の場合，通算秒として比較する。

比較キーワードが「時刻範囲」以外の場合

・最大100件複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。

・オペランドを文字列として指定した比較キーワードで比較する。

24

終了コード

E.RESULT_CODE

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

JP1イベントの終了コードを設定する。

最大100件複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。

英大文字・英小文字は区別する。

25

発生元ホスト名※

E.JP1_SOURCEHOST

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

JP1イベントの発生元ホストのホスト名を指定する。

最大100件複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。

英大文字・英小文字は区別する。

26

固有の拡張属性

E.xxxxxxx

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

JP1イベントの固有の拡張属性の属性名を指定する。

属性名には，先頭が英大文字で英大文字，数字，およびアンダースコア（_）から構成される32バイトまでの名称を設定できる。

最大100件複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。

英大文字・英小文字は区別する。

注※

統合監視DBおよびIM構成管理DBが有効な場合に，比較キーワードが，「と一致する」「と一致しない」のとき，パス表記で業務グループ名を指定できます。

統合監視DBおよびIM構成管理DBが無効な場合，および［と一致する］［と一致しない］以外を選択した場合，パス表記で業務グループ名を指定しても，ホスト名として扱われます。

jcoimdefコマンドの-ignorecasehostオプションの指定を「ON」にしている場合に，比較キーワードで［正規表現］以外を選択すると，文字列の英大文字・英小文字を区別しません。

比較キーワード

比較キーワードには，「BEGIN（から始まる）」，「IN（と一致する）」，「NOTIN（と一致しない）」，「SUBSTR（を含む）」，「NOTSUBSTR（を含まない）」，「REGEX（正規表現）」，「TRANGE（時刻範囲）」，「DEFINED（属性有）」，「NOTDEFINED（属性無）」のどれか一つを指定できます。小文字と大文字で区別します。

比較キーワードに「TRANGE（時刻範囲）」を使用する場合，次の表に示すように指定します。

表2‒36　TRANGEの指定形式

比較方法

形式

指定できる範囲

指定例

日時指定

開始日時△終了日時

開始日時≦属性値≦終了日時

2018年5月1日00:00:00〜2018年5月31日23:59:59を指定する場合

20180501000000 20180531235959

期間指定

分前

基準日時△-期間（分）MIN

基準日時 - 期間（分）≦属性値≦基準日時

2018年5月1日00:00:00から330分前までの期間を指定する場合

20180501000000 -330MIN

分後

基準日時△+期間（分）MIN

基準日時≦属性値≦基準日時 + 期間（分）

2018年5月1日00:00:00から330分後までの期間を指定する場合

20180501000000 +330MIN

時間前

基準日時△-期間（時）HOUR

基準日時 - 期間（時）≦属性値≦基準日時

2018年5月1日00:00:00から120時間前までの期間を指定する場合

20180501000000 -120HOUR

時間後

基準日時△+期間（時）HOUR

基準日時≦属性値≦基準日時 + 期間（時）

2018年5月1日00:00:00から120時間後までの期間を指定する場合

20180501000000 +120HOUR

日前

基準日時△-期間（日）DAY

基準日時 - 期間（日）≦属性値≦基準日時

2018年5月1日00:00:00から180日前までの期間を指定する場合

20180501000000 -180DAY

日後

基準日時△+期間（日）DAY

基準日時≦属性値≦基準日時 + 期間（日）

2018年5月1日00:00:00から180日後までの期間を指定する場合

20180501000000 +180DAY

（凡例）

△：半角スペース

開始日時，終了日時および基準日時は，YYYYMMDDhhmmss形式で指定します。

期間（分，時，日）は，1〜9,999の範囲の数字で指定します。MIN，HOUR，DAYは，大文字・小文字を区別します。

期間指定の場合，指定した基準日時からの期間が，日時の範囲（UTC1970 年1 月1 日00:00:00〜UTC2099 年12 月31 日23:59:59）を超える場合，エラーとなります。

オペランド

比較キーワードで属性値と比較する値を文字列で指定します。小文字と大文字で区別します。

オペランドを複数指定する場合は，一つ以上の連続した半角スペースまたはタブをオペランドとオペランドの間に挿入して区切ります。オペランドとオペランドは，OR条件となります。ただし，正規表現を指定している場合は，複数指定できません。

オペランドに，半角スペース，タブ，改行コード（CR，LF）および%を指定したい場合，次のように記述します。また，これらの値は定義フォーマットの上限チェックの場合，1文字として扱います。

オペランドに最大長制限はありません。ただし，cnd〜end-cnd（イベント条件ブロック）に記述できるイベント条件（属性名，比較キーワード，オペランド）の合計はシフトJISコード換算で最大65,536バイトです。

項番

指定したい値

指定方法

1

タブ（0x09）

%09

2

半角スペース（0x20）

%20

3

%（0x25）

%25

4

改行コード LF（0x0a）

%0a

5

改行コード CR（0x0d）

%0d

注意事項

date，rtime，weekの設定値の関連について

date，rtime，weekを設定した場合，dateで指定した期間内のweekで指定した曜日に合致する日ごとに，rtimeで指定した開始時刻から終了時刻まで共通除外条件が有効となります。

rtimeで終了時刻が翌日となるような指定をした場合は，指定された翌日の終了時刻まで共通除外条件は有効となります。

適用期間については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「4.2.7　共通除外条件」を参照してください。

定義例

次の条件の場合に，2010/10/01〜2010/10/31の毎週月曜〜土曜10:00〜12:00の期間でイベントを除外する定義例を示します。

イベントIDが1に一致

重大度がEmergencyまたはAlert

登録ホストが正規表現で次のとおり指定

host[0-9][0-9]

DESC_VERSION=1
# コメント
def 共通除外条件群1
    cmt 期限：2010/10/31
    id 1
    valid true
    date 20101001-20101031
    week 1,2,3,4,5,6
    rtime 1000-1200
    cnd
        B.ID IN 00000001
        E.SEVERITY IN Emergency Alert
        B.SOURCESERVER REGEX host[0-9][0-9]
    end-cnd
end-def

次の条件の場合に，2017/04/01〜2017/05/01の毎週月曜〜土曜23:00〜翌02:00の期間でイベントを自動アクションの実行対象外にする定義例を示します。

イベントIDが2に一致

重大度がEmergencyまたはAlert

登録ホストが正規表現で次のとおり指定

host[0-9][0-9]

DESC_VERSION=2
# コメント
def 共通除外条件群1
    cmt 期限：2017/05/01
    id 1
    valid true
    ex-target action
    date 20170401-20170501
    week 1,2,3,4,5,6
    rtime 2300-0200
    cnd
        B.ID IN 00000002
        E.SEVERITY IN Emergency Alert
        B.SOURCESERVER REGEX host[0-9][0-9]
    end-cnd
end-def

共通除外条件表示項目定義ファイル（common_exclude_filter_attr_list.conf）

形式

# コメント行
属性名
属性名
属性名
　・
　・
　・
属性名

ファイル

common_exclude_filter_attr_list.conf（共通除外条件表示項目定義ファイル）

common_exclude_filter_attr_list.conf.model（共通除外条件表示項目定義ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Consoleパス¥conf¥console¥filter¥attr_list

論理ホストのとき

共有フォルダ¥jp1cons¥conf¥console¥filter¥attr_list

UNIXの場合

物理ホストのとき

/etc/opt/jp1cons/conf/console/filter/attr_list

論理ホストのとき

共有ディレクトリ/jp1cons/conf/console/filter/attr_list

説明

［共通除外条件設定(拡張)］画面の［属性名］表示領域に表示する項目を指定する定義ファイルです。共通除外条件表示項目定義ファイルに指定された表示項目を指定された順番で［共通除外条件設定(拡張)］画面の［属性名］表示領域に表示します。

定義の反映時期

定義ファイルの内容は，セントラルコンソールの起動時，またはjco_spmd_reloadコマンドを実行して定義を再読み込みしたときに有効になります。

記述内容

#コメント行

#で始まる行は，コメント扱いとなります。

属性名

共通除外条件表示項目定義ファイルには，［共通除外条件設定(拡張)］画面の［属性名］表示領域に表示する表示項目を指定します。表示項目は，表示項目に対応する属性名で1行に1件記述します。0〜256件の表示項目を指定できます。

英大文字・英小文字を区別します。属性名の両端に指定された空白（半角スペース）とタブ文字は無視されます。

SEPARATORを指定すると，［共通除外条件設定(拡張)］画面の［属性名］表示領域に「--------------------」を表示します。SEPARATORは，よく使う項目と，あまり使わない項目を分けるときに設定します。

ただし，SEPARATORだけを指定した場合は，［属性名］表示領域には，「--------------------」だけが表示されます。この場合，「--------------------」を選択しても，属性名は設定できません。

指定できる属性名を次の表に示します。

表2‒37　表示項目一覧

項番

表示項目

属性名

1

発生元ホスト名※

E.JP1_SOURCEHOST

2

登録ホスト名

B.SOURCESERVER

3

重大度

E.SEVERITY

4

オブジェクトタイプ

E.OBJECT_TYPE

5

オブジェクト名

E.OBJECT_NAME

6

登録名タイプ

E.ROOT_OBJECT_TYPE

7

登録名

E.ROOT_OBJECT_NAME

8

事象種別

E.OCCURRENCE

9

ユーザー名

E.USER_NAME

10

メッセージ

B.MESSAGE

11

プロダクト名

E.PRODUCT_NAME

12

イベントID

B.ID

13

開始時刻

E.START_TIME

14

終了時刻

E.END_TIME

15

登録時刻

B.TIME

16

到着時刻

B.ARRIVEDTIME

17

固有の拡張属性

OTHER_EXTENDED_ATTRIBUTE

18

登録要因

B.REASON

19

発行元プロセスID

B.PROCESSID

20

発行元ユーザー名

B.USERNAME

21

発行元ユーザーID

B.USERID

22

発行元グループ名

B.GROUPNAME

23

発行元グループID

B.GROUPID

24

発行元IPアドレス

B.SOURCEIPADDR

25

オブジェクトID

E.OBJECT_ID

26

終了コード

E.RESULT_CODE

27

--------------------

SEPARATOR

注

同じ属性名が複数指定されていた場合，その値は無視されます。

また，共通除外条件表示項目定義ファイルが読み込めなかった場合，有効な表示項目が0件のときは，項番1〜26が表示されます。

注※

発生元ホストのマッピング機能が有効でない場合，［共通除外条件設定(拡張)］画面には表示されません。

共通除外条件自動入力定義ファイル（common_exclude_filter_auto_list.conf）

形式

# コメント行
[DEFAULT_NAME 共通除外条件群名]
属性名
属性名
　・
　・
属性名
属性名

ファイル

common_exclude_filter_auto_list.conf

common_exclude_filter_auto_list.conf.model（共通除外条件自動入力定義ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Consoleパス¥conf¥console¥filter¥auto_list

論理ホストのとき

共有フォルダ¥jp1cons¥conf¥console¥filter¥auto_list

UNIXの場合

物理ホストのとき

/etc/opt/jp1cons/conf/console/filter/auto_list

論理ホストのとき

共有ディレクトリ/jp1cons/conf/console/filter/auto_list

説明

［イベントコンソール］画面のイベント一覧でJP1イベントを選択後，［表示］−［共通除外条件で除外］を選択して［共通除外条件設定(拡張)］画面を開いたときに，自動で設定されるJP1イベント属性を定義するファイルです。また，追加共通除外条件群名のデフォルト名も定義できます。

定義の反映時期

定義ファイルの内容は，セントラルコンソールの起動時，またはjco_spmd_reloadコマンドを実行して定義を再読み込みしたときに有効になります。

記述内容

DEFAULT_NAME 共通除外条件群名

共通除外条件群名を定義する識別子を表しています。識別子は，コメントと空行を除いたファイルの先頭に記述してください。

このパラメーターに指定した共通除外条件群名が，［イベントコンソール］画面のイベント一覧でJP1イベントを選択後，［表示］−［共通除外条件で除外］を選択して［共通除外条件設定(拡張)］画面を開いたときに，初期値として表示されます。

40バイトまでの文字列で指定します。指定できる文字は，制御文字（0x00〜0x1F，0x7F〜0x9F）以外の文字列です。40バイトを超えて指定した場合，41バイト以上の文字列を切り捨てた文字列が共通除外条件群名となります。指定しなかった場合，「追加共通除外条件群」が共通除外条件群名となります。

#コメント行

#で始まる行は，コメント扱いとなります。

属性名

共通除外条件自動入力定義ファイルには，［イベントコンソール］画面のイベント一覧でJP1イベントを選択後，［表示］−［共通除外条件で除外］を選択して［共通除外条件設定(拡張)］画面を開いたときに，イベント条件として設定されるJP1イベントの属性を指定します。このパラメーターに指定した属性名の条件が，［イベントコンソール］画面のイベント一覧でJP1イベントを選択後，［表示］−［共通除外条件で除外］を選択して［共通除外条件設定(拡張)］画面を開いたときに，初期値として表示されます。

定義項目は，設定されるJP1イベントの属性名を1行に1件記述します。

英大文字・英小文字を区別します。属性名の両端に指定された空白（半角スペース）とタブ文字は無視されます。

同じ属性名が複数指定されていた場合，その値は無視し，KAVB1160-Wメッセージを統合トレースログに出力します。

［共通除外条件設定(拡張)］画面の［イベント条件］に自動的に表示されるJP1イベントの属性の順序は，共通除外条件表示項目定義ファイル（common_exclude_filter_attr_list.conf）の属性の記載順に設定されます。

指定できる属性名を次の表に示します。

表2‒38　表示項目一覧

項番

表示項目

属性名

1

発生元ホスト名

E.JP1_SOURCEHOST

2

登録ホスト名

B.SOURCESERVER

3

重大度

E.SEVERITY

4

オブジェクトタイプ

E.OBJECT_TYPE

5

オブジェクト名

E.OBJECT_NAME

6

登録名タイプ

E.ROOT_OBJECT_TYPE

7

登録名

E.ROOT_OBJECT_NAME

8

事象種別

E.OCCURRENCE

9

ユーザー名

E.USER_NAME

10

メッセージ

B.MESSAGE

11

プロダクト名

E.PRODUCT_NAME

12

イベントID

B.ID

13

登録要因

B.REASON

14

発行元プロセスID

B.PROCESSID

15

発行元ユーザー名

B.USERNAME

16

発行元ユーザーID

B.USERID

17

発行元グループ名

B.GROUPNAME

18

発行元グループID

B.GROUPID

19

発行元IPアドレス

B.SOURCEIPADDR

20

オブジェクトID

E.OBJECT_ID

21

終了コード

E.RESULT_CODE

注

同じ属性名が複数指定されていた場合，その値は無視されます。

また，共通除外条件自動入力定義ファイルが読み込めなかった場合，有効な表示項目が0件のときは，項番1〜3，項番10〜12が表示されます。

繰り返しイベント条件表示項目定義ファイル（event_storm_attr_list.conf）

形式

# コメント行
属性名
属性名
　・
属性名

ファイル

event_storm_attr_list.conf（繰り返しイベント条件表示項目定義ファイル）

event_storm_attr_list.conf.model（繰り返しイベント条件表示項目定義ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Consoleパス¥conf¥console¥event_storm¥attr_list

論理ホストのとき

共有フォルダ¥jp1cons¥conf¥console¥event_storm¥attr_list

UNIXの場合

物理ホストのとき

/etc/opt/jp1cons/conf/console/event_storm/attr_list

論理ホストのとき

共有ディレクトリ/jp1cons/conf/console/event_storm/attr_list

説明

［繰り返しイベント条件設定］画面の［属性名］表示領域に表示する項目を指定する定義ファイルです。繰り返しイベント条件表示項目定義ファイルに指定された表示項目を指定された順番で［繰り返しイベント条件設定］画面の［属性名］表示領域に表示します。

定義の反映時期

定義ファイルの内容は，セントラルコンソールの起動時，およびjco_spmd_reloadコマンドを実行して定義を再読み込みしたときに有効になります。

記述内容

#コメント行

#で始まる行は，コメント扱いとなります。

属性名

繰り返しイベント条件表示項目定義ファイルには，［繰り返しイベント条件設定］画面の［属性名］表示領域に表示する表示項目を指定します。表示項目は，表示項目に対応する属性名で1行に1件記述します。0〜256件の表示項目を指定できます。

英大文字・英小文字を区別します。属性名の両端に指定された空白（半角スペース）とタブ文字は無視されます。

SEPARATORを指定すると，［繰り返しイベント条件設定］画面の［属性名］表示領域に「--------------------」を表示します。SEPARATORは，よく使う項目と，あまり使わない項目を分けるときに設定します。

ただし，SEPARATORだけを指定した場合は，［属性名］表示領域には，「--------------------」だけが表示されます。この場合，「--------------------」を選択しても，属性名は設定できません。

指定できる属性名を次の表に示します。

表2‒39　表示項目一覧

項番

表示項目

属性名

1

発生元ホスト名※

E.JP1_SOURCEHOST

2

登録ホスト名

B.SOURCESERVER

3

重大度

E.SEVERITY

4

オブジェクトタイプ

E.OBJECT_TYPE

5

オブジェクト名

E.OBJECT_NAME

6

登録名タイプ

E.ROOT_OBJECT_TYPE

7

登録名

E.ROOT_OBJECT_NAME

8

事象種別

E.OCCURRENCE

9

ユーザー名

E.USER_NAME

10

メッセージ

B.MESSAGE

11

プロダクト名

E.PRODUCT_NAME

12

イベントID

B.ID

13

開始時刻

E.START_TIME

14

終了時刻

E.END_TIME

15

登録時刻

B.TIME

16

到着時刻

B.ARRIVEDTIME

17

固有の拡張属性

OTHER_EXTENDED_ATTRIBUTE

18

登録要因

B.REASON

19

発行元プロセスID

B.PROCESSID

20

発行元ユーザー名

B.USERNAME

21

発行元ユーザーID

B.USERID

22

発行元グループ名

B.GROUPNAME

23

発行元グループID

B.GROUPID

24

発行元IPアドレス

B.SOURCEIPADDR

25

オブジェクトID

E.OBJECT_ID

26

終了コード

E.RESULT_CODE

27

--------------------

SEPARATOR

注

同じ属性名が複数指定されていた場合，その値は無視されます。

また，繰り返しイベント条件表示項目定義ファイルが読み込めなかった場合，有効な表示項目が0件のときは，項番1〜26が表示されます。

注※

発生元ホストのマッピング機能が有効でない場合，［繰り返しイベント条件設定］画面には表示されません。

繰り返しイベント条件自動入力定義ファイル（event_storm_auto_list.conf）

形式

# コメント行
[DEFAULT_NAME 繰り返しイベント条件名]
属性名
属性名
　・
　・
属性名
属性名

ファイル

event_storm_auto_list.conf

event_storm_auto_list.conf.model（繰り返しイベント条件自動入力定義ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Consoleパス¥conf¥console¥event_storm¥auto_list

論理ホストのとき

共有フォルダ¥jp1cons¥conf¥console¥event_storm¥auto_list

UNIXの場合

物理ホストのとき

/etc/opt/jp1cons/conf/console/event_storm/auto_list

論理ホストのとき

共有ディレクトリ/jp1cons/conf/console/event_storm/auto_list

説明

［イベントコンソール］画面のイベント一覧でJP1イベントを選択後，［表示］−［繰り返しイベント条件で抑止］を選択して［繰り返しイベント条件設定］画面を開いたときに，自動で設定されるJP1イベント属性を定義するファイルです。また，繰り返しイベント条件名のデフォルト名も定義できます。

定義の反映時期

定義ファイルの内容は，セントラルコンソールの起動時，およびjco_spmd_reloadコマンドを実行して定義を再読み込みしたときに有効になります。

記述内容

DEFAULT_NAME 繰り返しイベント条件名

繰り返しイベント条件名を定義する識別子を表しています。識別子は，コメントと空行を除いたファイルの先頭に記述してください。

このパラメーターに指定した共通除外条件群名が，［イベントコンソール］画面のイベント一覧でJP1イベントを選択後，［表示］−［繰り返しイベント条件で抑止］を選択して［繰り返しイベント条件設定］画面を開いたときに，初期値として表示されます。

40バイトまでの文字列で指定します。指定できる文字は，制御文字（0x00〜0x1F，0x7F〜0x9F）以外の文字列です。40バイトを超えて指定した場合，41バイト以上の文字列を切り捨てた文字列が繰り返しイベント条件名となります。指定しなかった場合，「追加繰り返しイベント条件」が繰り返しイベント条件名となります。

#コメント行

#で始まる行は，コメント扱いとなります。

属性名

繰り返しイベント条件自動入力定義ファイルには，［イベントコンソール］画面のイベント一覧でJP1イベントを選択後，［表示］−［繰り返しイベント条件で抑止］を選択して［繰り返しイベント条件設定］画面を開いたときに，イベント条件として設定されるJP1イベントの属性を指定します。このパラメーターに指定した属性名の条件が，［イベントコンソール］画面のイベント一覧でJP1イベントを選択後，［表示］−［繰り返しイベント条件で抑止］を選択して［繰り返しイベント条件設定］画面を開いたときに，初期値として表示されます。

定義項目は，設定されるJP1イベントの属性名を1行に1件記述します。

英大文字・英小文字を区別します。属性名の両端に指定された空白（半角スペース）とタブ文字は無視されます。

同じ属性名が複数指定されていた場合，その値は無視し，KAVB1896-Wメッセージを統合トレースログに出力します。

［繰り返しイベント条件設定］画面の［イベント条件］に自動的に表示されるJP1イベントの属性の順序は，繰り返しイベント条件表示項目定義ファイル（event_storm_attr_list.conf）の属性の記載順に設定されます。

指定できる属性名を次の表に示します。

表2‒40　表示項目一覧

項番

表示項目

属性名

1

発生元ホスト名

E.JP1_SOURCEHOST

2

登録ホスト名

B.SOURCESERVER

3

重大度

E.SEVERITY

4

オブジェクトタイプ

E.OBJECT_TYPE

5

オブジェクト名

E.OBJECT_NAME

6

登録名タイプ

E.ROOT_OBJECT_TYPE

7

登録名

E.ROOT_OBJECT_NAME

8

事象種別

E.OCCURRENCE

9

ユーザー名

E.USER_NAME

10

メッセージ

B.MESSAGE

11

プロダクト名

E.PRODUCT_NAME

12

イベントID

B.ID

13

登録要因

B.REASON

14

発行元プロセスID

B.PROCESSID

15

発行元ユーザー名

B.USERNAME

16

発行元ユーザーID

B.USERID

17

発行元グループ名

B.GROUPNAME

18

発行元グループID

B.GROUPID

19

発行元IPアドレス

B.SOURCEIPADDR

20

オブジェクトID

E.OBJECT_ID

21

終了コード

E.RESULT_CODE

注

同じ属性名が複数指定されていた場合，その値は無視されます。

また，繰り返しイベント条件自動入力定義ファイルが読み込めなかった場合，有効な表示項目が0件のときは，項番1〜3，項番10〜12が表示されます。

対処状況イベント定義ファイル（processupdate.conf）

形式

[PROCESSUPDATE]
PROCESS_UPDATE_EVENT_OPTION={true | false}
[End]

ファイル

processupdate.conf（対処状況イベント定義ファイル）

processupdate.conf.model（対処状況イベント定義ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Consoleパス¥conf¥processupdate¥

論理ホストのとき

共有フォルダ¥jp1cons¥conf¥processupdate¥

UNIXの場合

物理ホストのとき

/etc/opt/jp1cons/conf/processupdate/

論理ホストのとき

共有ディレクトリ/jp1cons/conf/processupdate/

説明

対処状況を変更したときにJP1イベントを発行するかどうかを定義するファイルです。

定義の反映時期

次の場合に，対処状況イベント定義ファイルの設定が有効になります。

JP1/IM - Managerを起動した場合

記述内容

PROCESS_UPDATE_EVENT_OPTION={true | false}

対処状況変更時にJP1イベント（イベントID：3F11）を発行するかどうかを指定します。なお，大文字・小文字は区別しません。

trueを指定すると対処状況変更時にJP1イベントを発行します。

falseを指定すると対処状況変更時にJP1イベントを発行しません。デフォルトはfalseです。

省略した場合や値が不正な場合はfalseが仮定されます。

JP1イベントの詳細については，「3.2.2　JP1/IM - Managerが出力するJP1イベントの詳細」を参照してください。

注意事項

JP1イベントの発行設定をすると，対処されたJP1イベント一つに対し，3F11のJP1イベントが一つ発行されるようになります。例えば，［イベントコンソール］画面の［重要イベント］ページでJP1イベントを複数選択し，対処状況を変更した場合は，その対処状況を変更したJP1イベント数分，3F11のJP1イベントが発行されます。

大量のJP1イベントの対処状況をまとめて変更する運用をされている場合はこの機能を有効にしないでください。

相関イベント発行システムプロファイル（egs_system.conf）

形式

VERSION=1

START_OPTION={cold | warm}

ファイル

egs_system.conf（相関イベント発行システムプロファイル）

egs_system.conf.model（相関イベント発行システムプロファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Consoleパス¥conf¥evgen¥profile¥

論理ホストのとき

共有フォルダ¥jp1cons¥conf¥evgen¥profile¥

UNIXの場合

物理ホストのとき

/etc/opt/jp1cons/conf/evgen/profile/

論理ホストのとき

共有ディレクトリ/jp1cons/conf/evgen/profile/

説明

相関イベント発行サービスの起動時および停止時の動作を定義するファイルです。

定義の反映時期

次の場合に，相関イベント発行システムプロファイルの設定が有効になります。

JP1/IM - Managerを起動した場合

jco_spmd_reloadコマンドでリロードをした場合

記述内容

VERSION=1

ファイルのバージョンを表しています。編集不要です。省略した場合や1以外の数値を指定した場合は，VERSION=1が仮定されます。

START_OPTION={cold | warm}

相関イベント発行サービスの起動オプションです。

起動時および停止時の動作を決めるための値を指定します。値に指定できるのは，coldとwarmの二つです。デフォルトはwarmです。大文字・小文字は区別されません。省略した場合や値が不正な場合はwarmが仮定されます。

統合監視DBを使用しない場合と統合監視DBを使用する場合とで動作が異なります。

統合監視DBを使用しない場合にcold，warmそれぞれを指定したときの相関イベント発行サービスの動作を起動時，停止時に分けて次の表に示します。用途に合わせて値を変更してください。

表2‒41　起動オプションの違いによる相関イベント発行サービス起動時・停止時の動作の違い（統合監視DBを使用しない場合）

起動オプション

相関イベント発行サービスの動作

起動時の動作※1

停止時の動作

cold

前回停止時の起動オプションがcoldの場合：

相関イベント発行サービスが起動したあとに登録されたJP1イベントから，発行処理の対象とする。

発行処理中の相関イベントをすべて不成立にして，相関イベント発行履歴ファイルに出力する。

前回停止時の起動オプションがwarmの場合：

発行処理中の相関イベントをすべて不成立にして，相関イベント発行サービスが起動したあとに取得したJP1イベントから，発行処理の対象とする。

warm

前回停止時の起動オプションがcoldの場合：

相関イベント発行サービスが前回停止時に取得したJP1イベントの続きから発行処理の対象とする。

停止前の最後に取得したJP1イベントの情報，発行処理の内容，および相関イベントの発行定義の内容を内部ログに出力・保管する。

前回停止時の起動オプションがwarmの場合：

前回停止時の相関イベントの発行処理の内容を引き継ぎ，前回停止時に取得したJP1イベントの続きから発行処理の対象とする。※2

注※1

相関イベント発行サービスが初めて起動するときは，起動オプションの値に関係なく次のように動作します。

・相関イベント発行サービス起動後に登録されたJP1イベントから取得を開始する。

・相関イベント発行定義を読み込み，定義に従って処理を開始する。

なお，デフォルトでは，相関イベント発行定義が設定されていないため，相関イベントは発行されません。

注※2

JP1/IM - Managerの停止時と次の起動時で相関イベント発行定義が異なる場合，発行処理中の相関イベントはすべて不成立になります。いったん，内容がクリアされたあとは，前回停止時に取得したJP1イベントの続きから，発行処理の対象になります。

統合監視DBを使用する場合，相関イベント発行機能は，イベント基盤サービスが取得したイベントに対して，相関イベント発行定義を関連づけし，相関イベントを発行します。

イベント基盤サービスは，起動後にJP1/BaseのイベントDBからJP1イベントの取得を開始する位置を選択できます。JP1イベントの取得を開始する位置は，jcoimdefコマンドの-bオプションで選択できます。

相関イベントの発行処理は，JP1イベントの取得を開始する位置および起動オプションの組み合わせによって次のように異なります。

表2‒42　起動オプションの違いによる相関イベント発行サービス起動時・停止時の動作の違い（統合監視DBを使用する場合）

起動オプション

-bオプションの値

処理

warm

-1（デフォルト値）

相関イベントの発行処理中であるJP1イベントの状態を引き継ぎます。

JP1イベントの取得を開始する位置は，前回の停止時に取得を終えていたJP1イベントの次のJP1イベントからです。なお，前回の停止時に取得を終えていたJP1イベントがない場合は，イベントDBに登録されているイベントの中で最も古いJP1イベントから取得を開始します。

0〜144

KAJV2316-Wメッセージを出力し，相関イベントの発行処理中であるJP1イベントの状態を引き継ぎません。

cold

-1〜144

相関イベントの発行処理は，すべて停止し，終了します。相関イベントの発行処理中であるJP1イベントの状態を引き継げません。

なお，統合監視DBを使用する場合，一度，相関イベント発行処理の対象となったJP1イベントは，再度，相関イベント発行処理の対象にはなりません。

JP1/IM - Managerをクラスタシステムで運用する場合にはwarmに設定を変更してください。

フェールオーバー時には，JP1/IM - Manager停止→JP1/Base停止→JP1/Base起動→JP1/IM - Manager起動，の順に製品の停止・起動処理がされます。coldの設定状態でフェールオーバーした場合，JP1/IM - Manager停止→JP1/Base停止の間に発生したJP1イベントやJP1/Base起動→JP1/IM - Manager起動の間に発生したJP1イベントを取得できません。このため，cold設定のままだと，発行処理の対象となるJP1イベントを取り漏らすことがあります。

相関イベント発行定義ファイル

形式

VERSION={1 | 2}

#コメント行
[発行条件名]
TARGET=相関の対象範囲の絞り込み条件
CON=イベント条件
TIMEOUT=タイムアウト時間
TYPE=イベント相関タイプ
SAME_ATTRIBUTE=同一属性値条件
CORRELATION_NUM=同時相関数
SUCCESS_EVENT=相関成立イベント
FAIL_EVENT=相関不成立イベント

[発行条件名]
TARGET=相関の対象範囲の絞り込み条件
CON=イベント条件
TIMEOUT=タイムアウト時間
TYPE=イベント相関タイプ
SAME_ATTRIBUTE=同一属性値条件
CORRELATION_NUM=同時相関数
SUCCESS_EVENT=相関成立イベント
FAIL_EVENT=相関不成立イベント
          :

ファイル

任意のファイルを使用します。ただし，次の制限があります。

拡張子は.confとしてください。

ファイル名に使用できる文字は，半角英数字とアンダースコア「_」だけです。

格納先ディレクトリ

Windowsの場合

任意のフォルダ

UNIXの場合

任意のディレクトリ

説明

相関の対象とするJP1イベントの条件，および条件成立時に発行する相関イベントを定義するファイルです。このファイルは，JP1/IM - Managerの動作する言語コードで記述してください。

定義の反映時期

jcoegschangeコマンドで相関イベント発行定義を反映したあとに有効になります。

記述内容

VERSION={1 | 2}

相関イベント発行定義ファイルのバージョンです。

1または2を指定します。

1を指定すると，次のパラメーターを指定できません。ここで説明しているすべてのパラメーターを指定したい場合，2を指定してください。

表2‒43　指定できないパラメーター一覧

バージョン

パラメーター名

1

TARGET

SAME_ATTRIBUTE

CORRELATION_NUM

2

なし

値の前に0を指定した場合，0は無視されます。例えば，VERSION=0001とVERSION=1は同じ意味です。省略した場合は，VERSION=1が仮定されます。

1または2以外の値を指定した場合，定義不正になります。また，VERSIONを複数指定した場合は，定義不正になります。

#コメント行

#で始まる行は，コメント扱いとなります。

[発行条件名]

相関イベント発行条件の定義ブロックの開始タグです。[発行条件名]から，次の[発行条件名]の直前までが一つの定義ブロックになります。省略できません。相関イベント発行条件は1,000件まで定義できます。1,000件を超えて定義した場合，定義不正となります。

発行条件名は[ ]（半角角括弧）で囲って指定します。発行条件名には，半角英数字，-（ハイフン），_（アンダースコア）および/（スラッシュ）が使用できます。指定できる文字数は，1文字以上32文字以下です。

また，大文字，小文字は区別されます。例えば，［JP1_HAKKOUZYOUKEN］と［jp1_hakkouzyouken］は別の定義になります。

なお，相関イベント発行定義ファイル内で，同じ発行条件名は使用できません。同じ発行条件名を定義した場合，ファイル内で先に記述してある方が有効になります。また，「IM_」で始まる発行条件名は指定できません。指定した場合，定義不正になります。「IM_」の大文字・小文字は区別されません。

[発行条件名]の横には発行条件のコメントを付けられます。コメントを付ける場合は，[発行条件名]#発行条件のコメントと記述します。

TARGET=相関の対象範囲の絞り込み条件

相関イベントの発行処理の対象とするJP1イベントの範囲を絞り込みたいときに定義します。省略すると，取得したすべてのJP1イベントが相関イベントの発行処理の対象になります。

1件の相関イベント発行条件に指定できる相関の対象範囲の絞り込み条件は一つだけです。複数定義した場合，定義不正となります。

形式を次に示します。

　TARGET=イベント属性条件1［,イベント属性条件2…］

イベント属性条件を複数指定する場合，「,」（半角コンマ）で区切ります。複数指定すると，それぞれのイベント属性条件はAND条件となります。複数指定したイベント属性条件がすべて成立するJP1イベントが発行された場合に，条件が成立します。

イベント属性条件は次の形式で指定します。

　属性名 比較条件 属性値

イベント属性条件の設定項目を次に示します。

表2‒44　イベント属性条件の設定項目

項番

設定項目

説明

1

属性名

JP1イベントの基本属性または拡張属性を指定します。 基本属性には「B.」を，拡張属性には「E.」を付けます。例えば，メッセージを指定する場合「B.MESSAGE」と指定します。

拡張属性を指定する場合，「E.」のあとの文字列は，32バイト以内で指定します。なお，次の入力規則があります。

先頭は大文字の半角英字

2バイト目以降は大文字の半角英数字，または_（アンダースコア）

指定できる属性名については，「表2-45　相関の対象範囲の絞り込み条件に指定できる属性名の一覧」を参照してください。

2

比較条件

使用できる比較条件は次のとおりです。これ以外のものを指定すると定義不正となります。

比較条件：意味

==　：と一致する

!=　：と一致しない

^=　：から始まる

>=　：を含む

<=　：を含まない

*=　：正規表現※

注※　使用できる正規表現については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「付録G　正規表現」を参照してください。

3

属性値

属性値には比較する値を指定します。属性値に指定できる文字数は最大2,048（JP1/IM - Managerのバージョンが09-10までの場合は1,023）バイトです。2,048（JP1/IM - Managerのバージョンが09-10までの場合は1,023）バイトを超えると定義不正となります。

なお，イベント属性条件を複数指定する場合は，指定できる文字数が，全条件の属性値の合計で最大2,305（JP1/IM - Managerのバージョンが09-10までの場合は1,280）バイトになります。2,305（JP1/IM - Managerのバージョンが09-10までの場合は1,280）バイトを超えると定義不正となります。

例えば，イベント属性条件を五つ設定した場合，その五つの属性値の合計を2,305（JP1/IM - Managerのバージョンが09-10までの場合は1,280）バイト以内にする必要があります。

属性値を複数定義する場合は;（セミコロン）で属性値を区切ります。なお，属性値の間に;（セミコロン）が連続してあっても一つの;（セミコロン）と見なします。例えば，B.ID==A;;;;;BはB.ID==A;Bと見なします。

例：E.xxx==A;Bと設定したとき，E.xxxがAまたはBと一致したときに条件が成立します。

,（半角コンマ），;（セミコロン）を属性値として使用する場合，または空白を属性値の両端に使用する場合は，一つの属性値として指定したい範囲を"（ダブルクォーテーション）で囲みます。

"（ダブルクォーテーション），¥（半角エンマーク）を属性値として使用する場合は直前に¥（半角エンマーク）を付けます。

一つの属性名に対して，属性値を複数指定した場合，次に示す例のように条件が成立します。

例1：E.xxx==A;Bと指定した場合，E.xxxがAまたはBのどちらか一方に一致したときに条件が成立します。

例2：E.xxx!=A;Bと指定した場合，E.xxxがAまたはBの両方に一致しないときに条件が成立します。

例3：E.xxx^=A;Bと指定した場合，E.xxxがAまたはBのどちらかで始まるときに条件が成立します。

例4：E.xxx>=A;Bと指定した場合，E.xxxがAまたはBのどちらかを含むときに条件が成立します。

例5：E.xxx<=A;Bと指定した場合，E.xxxがAまたはBの両方を含まないときに条件が成立します。

例6：E.xxx*=A;Bと指定した場合，E.xxxがAまたはBのどちらかの正規表現に一致したときに条件が成立します。

一つのイベント属性条件に，同一の属性名を複数指定する場合，次のような組み合わせは定義不正になりますので，注意してください。

・絶対に一致しない組み合わせ

　メッセージ(B.MESSAGE)がKAVBで始まり，メッセージがKAVBを含まない

・冗長な組み合わせ

　メッセージ(B.MESSAGE)がKAVBで始まり，メッセージがKAVBを含む

属性名，比較条件，および属性値の間，セミコロンで区切って指定した属性値の両端，またはイベント属性条件の両端に指定された空白（半角スペースとASCIIコード0x01〜0x1Fの文字）は無視されます。

例：メッセージが「KAJVxxxx-I△実行しました」またはErrorと一致する条件

次の△部分に空白がある場合，無視されます。

△B.MESSAGE△==△"KAJVxxxx-I△実行しました";△Error△

上記の例と同じ意味になる指定方法の例を示します。

B.MESSAGE==KAJVxxxx-I△実行しました;Error

B.MESSAGE=="KAJVxxxx-I△実行しました";Error

属性名にイベントID（B.ID）を指定する場合は，比較条件は完全一致（==）しか使用できません。

相関の対象範囲の絞り込み条件に指定できる属性名の一覧を次に示します。

表2‒45　相関の対象範囲の絞り込み条件に指定できる属性名の一覧

項番

属性名

項目

1

B.SOURCESERVER※1

発行元イベントサーバ名

2

B.DESTSERVER※1

送信先イベントサーバ名

3

B.MESSAGE

メッセージ

4

B.ID

イベントID

5

B.REASON

登録要因

6

B.USERID

発行元ユーザーID

7

B.GROUPID

発行元グループID

8

B.USERNAME

発行元ユーザー名

9

B.GROUPNAME

発行元グループ名

10

E.JP1_SOURCEHOST※1

発生元ホスト名

11

E.xxxxxxx※2

拡張属性（共通情報・固有情報）

注※1

統合監視DBおよびIM構成管理DBが有効な場合に，パス表記で業務グループ名を指定できます。

統合監視DBおよびIM構成管理DBが無効な場合，パス表記で業務グループ名を指定しても，ホスト名として扱われます。

jcoimdefコマンドの-ignorecasehostオプションの指定を「ON」にしている場合に，比較キーワードで［正規表現］以外を選択すると，文字列の英大文字・英小文字を区別しません。

注※2

各JP1製品固有の拡張属性も使用できます。例えば，JP1/AJSのジョブの実行ホストは，E.C0です。製品固有の拡張属性についての詳細は，JP1イベントを発行する各製品のマニュアルを参照してください。

CON=イベント条件

相関イベントの発行処理の対象，または対象外とするJP1イベントの条件を定義します。イベント条件は複数指定できます。また，1件の相関イベント発行条件内に少なくとも1件以上定義する必要があります。イベント条件は10件まで定義できます。なお，定義していない場合，または定義が正しくない場合は，定義不正となります。

形式を次に示します。

　CON={NOT|[CID:n]},イベント属性条件1 [, イベント属性条件2[, イベント属性条件3 …] ]

イベント属性条件を複数指定する場合，「,」（半角コンマ）で区切ります。複数指定すると，それぞれのイベント属性条件はAND条件となります。複数指定したイベント属性条件がすべて成立するJP1イベントが発行された場合に，条件が成立します。

イベント条件の設定項目を次に示します。

表2‒46　イベント条件の設定項目

項番

設定項目

説明

1

NOT

相関イベントの発行処理の対象外にするJP1イベントを指定します。

イベント条件にNOTを指定した場合，イベント条件（CON）の定義順序に関係なく，その条件が最初に適用されます。

2

CID:n

条件IDです。相関イベントの発行時に，変数を使って相関元イベントの情報をほかのパラメーター（SAME_ATTRIBUTE，SUCCESS_EVENT）に引き継ぐ場合に指定します。1〜999の整数値で指定します。

例えば，複数のJP1イベントを相関元イベントとし，SUCCESS_EVENTパラメーターに変数 $EVn_B.MESSAGEを指定する場合，条件IDの指定に従って，相関イベントに相関元イベントのメッセージ情報を引き継ぎます。

省略した場合，ほかのパラメーターに情報を引き継ぐことはできません。また，指定値の前に0を付けたり，同じCIDを指定したりすると定義不正になります。

3

イベント属性条件

イベント属性条件は次の形式で指定します。

形式

　属性名 比較条件 属性値

属性名

JP1イベントの基本属性または拡張属性を指定します。

基本属性には「B.」を，拡張属性には「E.」を付けます。

例えば，メッセージを指定する場合「B.MESSAGE」と指定します。

拡張属性を指定する場合，「E.」のあとの文字列は，32バイト以内で指定します。なお，次の入力規則があります。

先頭は大文字の半角英字

2バイト目以降は大文字の半角英数字，または_（アンダースコア）

基本属性，拡張属性については，「3.1　JP1イベントの属性」を参照してください。なお，製品固有の拡張属性を指定する場合，JP1イベントを発行する各製品のマニュアルを参照してください。ただし，発行元IPアドレス（SOURCEIPADDR）は，指定することができません。

比較条件および属性値

比較条件および属性値の指定方法は，TARGETにイベント属性条件を指定する場合と同じです。

「表2-44　イベント属性条件の設定項目」および表下の説明を参照してください。

TIMEOUT=タイムアウト時間

相関イベント発行条件のタイムアウト時間を指定します。指定できる値は，1〜86,400（単位：秒）です。省略した場合は，60秒が仮定されます。

TYPE=イベント相関タイプ

イベント相関タイプを指定します。

イベント相関タイプには，sequence（順序性），combination（組み合わせ）およびthreshold（しきい値）があります。イベント相関タイプに指定できる値を次に示します。

sequence

順序性を考慮し，定義したイベント条件と一致するJP1イベントが定義順に発行されたときに相関イベント発行条件が成立します。

combination

順序性を考慮せず，定義したイベント条件の組み合わせでJP1イベントが発行されたときに相関イベント発行条件が成立します。

threshold:n

定義したイベント条件に一致するJP1イベントの発行する数がしきい値に達した時点で相関イベント発行条件が成立します。イベント条件が複数定義されている場合，そのどれかに一致したJP1イベントの合計がしきい値に達した時点で相関イベント発行条件が成立します。

しきい値は1〜100（単位：件）で指定できます。例えば，しきい値を10とする場合，次のように指定します。

threshold:10

大文字，小文字は区別されません。また，イベント相関タイプの指定を省略した場合は，combination（組み合わせ）が仮定されます。

SAME_ATTRIBUTE=同一属性値条件

同一属性値条件を指定します。

イベント条件に一致したJP1イベント（相関元イベント）に対し，特定の属性値ごとにグルーピングして，グループ単位に相関イベントを発行したい場合に定義します。

同一属性値条件は1件の相関イベント発行条件に三つまで定義できます。省略することもできます。

形式を次に示します。

　SAME_ATTRIBUTE=属性名 | {$EVn_属性名 | $EVn_ENVo} [, {$EVn_属性名 | $EVn_ENVo} …]

同一属性値条件の設定項目について説明します。

表2‒47　同一属性値条件の設定項目

項番

設定項目

説明

1

属性名

JP1イベントの基本属性または拡張属性を指定します。

ここで指定した属性名に対応する相関元イベントの属性値がグルーピングのキーになります。

属性名は，一つの同一属性値条件に対して一つだけ指定できます。

基本属性には「B.」を，拡張属性には「E.」を付けます。拡張属性を指定する場合，「E.」のあとの文字列は，32バイト以内で指定します。なお，次の入力規則があります。

先頭は大文字の半角英字

2バイト目以降は大文字の半角英数字，または_（アンダースコア）

指定できる属性名については，「表2-48　同一属性値条件に指定できる属性名の一覧」を参照してください。

2

変数

$EVn_属性名

グルーピングのキーにしたい属性値が，相関元イベントごとに異なる属性に入っている場合に指定します。

例えば，相関元イベントAの属性A'と，相関元イベントBの属性B'をグルーピングのキーにしたいときに使用します。

$EVn_属性名は，一つの同一属性値条件に対して$EVn_ENVoと合わせて10個まで指定できます。

詳細については，「(1)(a)　相関元イベントの属性値を同一属性値条件として使用する」を参照してください。

3

変数

$EVn_ENVo

相関元イベントの属性値の一部を切り出して，同一属性値条件として使用する場合に指定します。

例えば，メッセージ（B.MESSAGE）の一部を切り出して，グルーピングのキーにしたいときに使用します。

$EVn_ENVoは，一つの同一属性値条件に対して$EVn_属性名と合わせて10個まで指定できます。

詳細については，「(1)(b)　相関元イベントの属性値の一部を同一属性値条件として使用する」を参照してください。

属性名および変数に置き換わる値（属性値または属性値の一部）は，全角，半角および大文字，小文字が区別されます。完全に同一の値だけが同一属性値条件になります。

属性名および変数に置き換わる値（属性値または属性値の一部）が相関元イベントにない場合，空文字（0バイト）に置き換わります。このため，空文字をキーにしてグルーピングします。空文字で処理された場合，相関イベント発行履歴ファイルに次の文字列が出力されます。

A JP1 event that matches the correlation event generation condition occurred, and the correlation event generation processing started, but the event attribute defined in that attribute value condition does not exist in the JP1 event. (発行条件名(発行処理番号) イベントDB内通し番号 属性名)

SAME_ATTRIBUTE=同一属性値条件 を複数指定すると，それぞれの同一属性値条件ごとに相関イベントが発行されます。

例えば，ホスト名（B.SOURCESERVER）およびユーザー名（B.USERNAME）ごとに相関イベントを発行する場合，次のように定義します。

　　　　　：

SAME_ATTRIBUTE=B.SOURCESERVER

SAME_ATTRIBUTE=B.USERNAME

　　　　　：

同一属性値条件に複数個の変数を指定する場合は「,」（半角コンマ）で区切ってください。変数に置き換わる属性値ごとに相関イベントが発行されます。

属性名および変数（$EVn_属性名，$EVn_ENVo）の間，または同一属性値条件の両端に指定された空白（半角スペースとASCIIコード0x01〜0x1Fの文字）は無視されます（次の例の△部分）。

例：

△SAME_ATTRIBUTE△=△$EV1_ENV1△,△$EV2_ENV2△

同一属性値条件に指定できる属性名の一覧を次に示します。

表2‒48　同一属性値条件に指定できる属性名の一覧

項番

属性名

項目

1

B.SOURCESERVER

発行元イベントサーバ名

2

B.DESTSERVER

送信先イベントサーバ名

3

B.MESSAGE

メッセージ

4

B.ID

イベントID

5

B.REASON

登録要因

6

B.USERID

発行元ユーザーID

7

B.GROUPID

発行元グループID

8

B.USERNAME

発行元ユーザー名

9

B.GROUPNAME

発行元グループ名

10

E.xxxxxxx※

拡張属性（共通情報・固有情報）

注※

各JP1製品固有の拡張属性も使用できます。例えば，JP1/AJSのジョブの実行ホストは，E.C0です。製品固有の拡張属性についての詳細は，JP1イベントを発行する各製品のマニュアルを参照してください。

CORRELATION_NUM=同時相関数

相関イベント発行条件で保持できるJP1イベントの組数を指定します。1件の相関イベント発行条件に定義できる同時相関数は一つだけです。

指定できる値は，1〜1,024（単位：組）です。項目を省略した場合は，10組が仮定されます。

注意

同時相関数を多くの相関イベント発行条件に指定し，かつ，大きな値を指定する，などの運用はお勧めできません。

相関イベント発行サービスが同時に処理するJP1イベントの組数が多くなるため，メモリー所要量が増加したり，処理速度が低下したりします。

また，すべての相関イベント発行条件で同時に発行処理できるJP1イベントの組数は20,000組です。20,000組に達すると，JP1イベント（イベントID：00003F28）が出力されます。新たにイベント条件に一致するJP1イベントが発行されても，組数が20,000組を下回るまでは処理されません。

SUCCESS_EVENT=相関成立イベント

相関イベント発行条件が相関成立になった場合に発行するJP1イベント(相関イベント)を定義します。1件の相関イベント発行条件に定義できる相関成立イベントは一つだけです。相関成立になる条件については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「4.3.6(1)　相関成立の場合」を参照してください。

なお，相関イベント発行条件に「FAIL_EVENT=相関不成立イベント」が定義されている場合，この定義を省略できます。省略した場合，相関イベント発行条件が相関成立になっても，相関成立イベントは発行されません。

相関成立イベントは，次の形式で記述します。

　属性名:属性値

各項目について説明します。

属性名

JP1イベント（相関元イベント）の基本属性または拡張属性を指定します。基本属性には「B.」を，拡張属性には「E.」を付けます。拡張属性を指定する場合，「E.」のあとの文字列は，32バイト以内で指定します。なお，次の入力規則があります。

・先頭は大文字の半角英字

・2バイト目以降は大文字の半角英数字，または_（アンダースコア）

次の属性に対してはユーザーが任意に値を設定できます。

・イベントID（B.ID）

・メッセージ（B.MESSAGE）

・次の表に示す以外の拡張属性

表2‒49　値を指定できない拡張属性

属性種別

項目

属性名

内容

共通情報

プロダクト名

E.PRODUCT_NAME

/HITACHI/JP1/IM/GENERATE_EVENT

オブジェクトタイプ

E.OBJECT_TYPE

SERVICE

オブジェクト名

E.OBJECT_NAME

EGS

事象種別

E.OCCURRENCE

SUCCESS

固有情報

関連イベントDB内通し番号

E.JP1_GENERATE_SOURCE_SEQNO

相関元のイベントのイベントDB内通し番号を半角スペース区切りで格納します。

イベントDB内通し番号1△イベントDB内通し番号2△イベントDB内通し番号3・・・イベントDB内通し番号n

nは最大100です。

相関イベント発行条件名

E.JP1_GENERATE_NAME

成立した相関イベント発行条件名

予約語

E.JP1_で始まる拡張属性

発生元ホスト名（E.JP1_SOURCEHOST）を除くJP1/IM - Managerが予約している拡張属性

相関元イベントの属性値を相関イベントに引き継ぎたい場合，変数を指定します。また，相関成立イベントは次の形式で指定します。

　属性名:$EVn_属性名

この場合，イベント条件のCIDで引き継ぎたい相関元イベントを指定し，nにCIDの値を指定します。また，:の右側に変数を指定します。

詳細については，「(2)(a)　相関元イベントの属性値を相関イベントの属性値に引き継ぐ」を参照してください。

イベント相関タイプでしきい値（threshold）を指定，かつ，相関元イベントの属性値を相関イベントに引き継ぎたい場合，相関成立イベントは，次の形式で指定します。

　属性名:$EVn_m_属性名

この場合，CIDで引き継ぎたい相関元イベントを指定し，nにCIDの値を指定します。また，:の右側に変数を指定します。かつ，mに何番目に処理された相関元イベントの属性値を引き継ぐかを指定します。

詳細については，「(2)(b)　相関元イベントの属性値を相関イベントの属性値に引き継ぐ（イベント相関タイプがしきい値の場合）」を参照してください。

相関元イベントの属性値の一部を切り出して，相関イベントに引き継ぎたい場合，変数 $EVn_ENVoを指定します。また，イベント条件は正規表現で指定し，属性値の切り出したい部分を( )で囲みます。

相関成立イベントは次の形式で指定します。

　属性名:$EVn_ENVo

この場合，CIDで引き継ぎたい相関元イベントを指定し，nにCIDの値を指定します。また，ENVoのoに切り出した順番を指定します。

詳細については，「(2)(c)　相関元イベントの属性値の一部を相関イベントの属性値に引き継ぐ」を参照してください。

基本属性，拡張属性については，「3.1　JP1イベントの属性」を参照してください。なお，製品固有の拡張属性を指定する場合，JP1イベントを発行する各製品のマニュアルを参照してください。

相関成立イベントに項目を複数指定する場合は「,」（半角コンマ）で区切ってください。

基本属性のイベントID（B.ID）は必ず指定してください。指定できるイベントIDの範囲は，0〜1FFF，7FFF8000〜7FFFFFFFです。指定しなかった場合，イベントIDには0が設定されます。

一つの相関成立イベントの最大長は8,192バイトです。また，B.MESSAGEの最大長は1,023バイトです。最大長のバイト数には，空白を含み，改行コードは含みません。

属性名および属性値の間，またはSUCCESS_EVENT=相関成立イベントの両端に指定された空白（半角スペースとASCIIコード0x01〜0x1Fの文字）は無視されます（次の例の△部分）。

例：

△SUCCESS_EVENT△=△B.ID△:△1△

,（半角コンマ），空白を属性値として使用する場合は"（ダブルクォーテーション）で囲みます。

"（ダブルクォーテーション），¥（半角エンマーク）を指定する場合は直前に¥（半角エンマーク）を付け，「¥"」，「¥¥」とします。

特殊文字（^ $ . * + ? | ( ) { } [ ] ¥）を打ち消す場合は，「¥¥特殊文字」とします。

例えば，「$」を通常の文字として扱う場合は，「¥¥$」とします。また，¥（半角エンマーク）を通常の文字として扱う場合は「¥¥¥¥」とします。

属性値を省略すると，相関イベントの発行時に何も設定されません。ただし，属性名（B.ID）の属性値の記述を省略した場合は，0が設定されます。

変数 $EVn_属性名に設定値を続けて記述する場合は，変数のあとに空白（次の例に△で表記）を記述します。

例：

SUCCESS_EVENT=B.MESSAGE:"$EVn_B.ID△$EVn_B.TIME△・・・"

変数を使用する場合，一致する属性名がない場合は空白に置き換わります。また，相関イベントの発行時に変数を属性値に置き換えたことによって，属性値の最大長を超えた場合は相関イベントは発行されません。

拡張属性は94件まで指定できます。

FAIL_EVENT=相関不成立イベント

相関イベント発行条件が相関不成立になった場合に発行するJP1イベント(相関イベント)を定義します。1件の相関イベント発行条件に定義できる相関不成立イベントは一つだけです。相関不成立になる条件については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「4.3.6(2)　相関不成立の場合」を参照してください。

なお，相関イベント発行条件に「SUCCESS_EVENT=相関成立イベント」が定義されている場合，この定義を省略できます。省略した場合，相関イベント発行条件が不成立になっても，相関不成立イベントは発行されません。

相関不成立イベントは，相関成立イベントと同じ形式で記述します。「SUCCESS_EVENT=相関成立イベント」を参照してください。

(1) 同一属性値条件（SAME_ATTRIBUTE）に変数を使用する

同一属性値条件（SAME_ATTRIBUTE）に変数（$EVnまたは$EVn_ENVo）を使用する方法について説明します。

(a) 相関元イベントの属性値を同一属性値条件として使用する

相関元イベントの属性値を，同一属性値条件として使用する場合，変数 $EVn_属性名を使用します。形式を次に示します。

　SAME_ATTRIBUTE=$EVn_属性名

nにはイベント条件の条件ID（CID）に対応した値を指定します。指定できる条件IDの値の範囲は1〜999です。

属性名には，グルーピングのキーにしたい属性名を指定します。なお，指定できる属性名については，「表2-48　同一属性値条件に指定できる属性名の一覧」を参照してください。

例えば，WindowsログトラップのJP1イベント（イベントID：00003A71）と，JP1/AJSが発行したJP1イベント（イベントID：00004107）のように，ホスト情報が異なる属性値に入っているJP1イベントを関連づけ，ホストごとに相関イベントを発行したい場合，次のように定義します。

CON=CID:1,B.ID==3A71,E.A0==host1;host2
CON=CID:2,B.ID==4107,E.C0==host1;host2
          ：
SAME_ATTRIBUTE=$EV1_E.A0,$EV2_E.C0
          ：

(b) 相関元イベントの属性値の一部を同一属性値条件として使用する

相関元イベントの属性値の一部を切り出して，同一属性値条件として使用する場合，変数 $EVn_ENVoを使用します。形式を次に示します。

　SAME_ATTRIBUTE=$EVn_ENVo

$EVn_ENVoを指定する場合，イベント条件は正規表現（*=）で指定し，属性値の切り出したい部分を( )で囲みます。

nにはイベント条件の条件ID（CID）に対応した値を指定します。指定できる条件IDの値の範囲は1〜999です。

また，ENVoのoに切り出しの順番を指定します。切り出しの順番とは，イベント条件の右辺に記述されている( )を左から右に数えた値です。指定できる切り出しの順番の範囲は1〜9です。

イベント条件（CON）と$EVn_ENVoで切り出される部分の対応を次の図に示します。

図2‒3　イベント条件（CON）と$EVn_ENVoで切り出される部分の対応

一つのイベント条件（CON）に，正規表現を指定したイベント属性条件が複数ある場合も，左から右に" ( " を数え，切り出したい個所の順番をoに指定します。

例えば，相関元イベントのメッセージの一部にホスト名が入っていて，このホスト名が同一のイベントごとに相関イベントを発行したい場合は次のように定義します。

CON=CID:1, B.ID==1001, B.MESSAGE*=.*HOST=(.*¥¥))
TYPE=threshold:5
SAME_ATTRIBUTE=$EV1_ENV1
          ：

(2) 相関成立イベント（SUCCESS_EVENT）に変数を使用する

相関元イベントの属性値を相関イベントに引き継ぎたい場合，相関成立イベント（SUCCESS_EVENT）に変数を使用します。

(a) 相関元イベントの属性値を相関イベントの属性値に引き継ぐ

相関元イベントの属性値を，そのまま相関イベントの属性値に引き継ぐ場合，変数 $EVn_属性名を使用します。形式を次に示します。

　SUCCESS_EVENT=属性名:$EVn_属性名

nにはイベント条件で指定した条件ID（CID）を指定します。また，右側の属性名には，相関元イベントから引き継ぎたい属性を指定します。ただし，左側の属性名にイベントID(B.ID)を指定している場合は, 相関元イベントの属性値を引き継げません。

変数に指定できる属性名の一覧を次に示します。

表2‒50　変数に指定できる属性名の一覧

項番

属性名

項目

形式

1

B.SEQNO

イベントDB内通し番号

数値

2

B.ID

イベントID

基本部：拡張部の16進数

3

B.PROCESSID

発行元プロセスID

数値

4

B.TIME

登録時刻

YYYY/MM/DD hh:mm:ss※1

5

B.ARRIVEDTIME

到着時刻

YYYY/MM/DD hh:mm:ss※1

6

B.REASON

登録要因

文字列

7

B.USERID

発行元ユーザーID

数値

8

B.GROUPID

発行元グループID

数値

9

B.USERNAME

発行元ユーザー名

文字列

10

B.GROUPNAME

発行元グループ名

文字列

11

B.SOURCESERVER

発行元イベントサーバ名

文字列

12

B.DESTSERVER

送信先イベントサーバ名

文字列

13

B.SOURCESEQNO

発行元イベントDB内通し番号

数値

14

B.MESSAGE

メッセージ

文字列

15

E.SEVERITY

重要度

文字列

16

E.USER_NAME

ユーザー名

文字列

17

E.PRODUCT_NAME

プロダクト名

文字列

18

E.OBJECT_TYPE

オブジェクトタイプ

文字列

19

E.OBJECT_NAME

オブジェクト名

文字列

20

E.ROOT_OBJECT_TYPE

登録名タイプ

文字列

21

E.ROOT_OBJECT_NAME

登録名

文字列

22

E.OBJECT_ID

オブジェクトID

文字列

23

E.OCCURRENCE

事象種別

文字列

24

E.START_TIME

開始時刻

YYYY/MM/DD hh:mm:ss※1

25

E.END_TIME

終了時刻

YYYY/MM/DD hh:mm:ss※1

26

E.xxxxxx※2

上記以外の拡張属性

文字列

注※1

JP1イベントに入っているGMT時間をJP1/IM - Managerのタイムゾーンで変換した値になります。

注※2

各JP1製品固有の拡張属性も使用できます。例えば，JP1/AJSのジョブの実行ホストは，E.C0です。製品固有の拡張属性についての詳細は，JP1イベントを発行する各製品のマニュアルを参照してください。

相関元イベントの属性値の引き継ぎ例を次の図に示します。

図2‒4　変数を使用した場合の相関成立イベントへの引き継ぎ例

上記の例では，JP1/AJSおよびJP1/Baseの発行した重大度がエラーのJP1イベントを関連づけて，相関イベントを発行しています。

また，相関成立イベントは次のように定義されています。

相関イベントの重大度は，JP1/AJSの発行したJP1イベントの重大度を引き継ぐ。

相関イベントのメッセージは，JP1/AJSおよびJP1/Baseの発行したJP1イベントのメッセージを引き継ぐ。

(b) 相関元イベントの属性値を相関イベントの属性値に引き継ぐ（イベント相関タイプがしきい値の場合）

次にイベント相関タイプがしきい値の場合に，変数を使用して相関成立イベントを定義する方法について説明します。

イベント相関タイプがしきい値の場合，一つのイベント条件（CON）に複数のJP1イベントが一致します。例えば，次の図ような場合です。

図2‒5　イベント相関タイプがしきい値の場合の問題

上記の図に示したとおり，$EV1_B.MESSAGEに一致するJP1イベントが，イベント1，イベント2，およびイベント3の三つになってしまいます。三つのうちのどのJP1イベントのメッセージを引き継ぐかを指定する必要があります。

このため，次の形式で相関成立イベントを指定します。

　SUCCESS_EVENT=属性名:$EVn_m_属性名

nはこれまで説明してきたとおり，イベント条件で指定した条件ID（CID）を指定します。また，右側の属性名には，相関元イベントから引き継ぎたい属性を指定します。ただし，左側の属性名にイベントID(B.ID)を指定している場合は, 相関元イベントの属性値を引き継げません。

加えて，mには発行されたJP1イベント（相関元イベント）の処理順序を指定します。つまり，3番目に処理されたJP1イベントの属性値を引き継ぎたい場合，mに3を指定します。なお，mに指定した値が，しきい値（threshold:n）に指定した件数より大きい場合は定義不正になります。

イベント相関タイプがしきい値の場合の引き継ぎ例を次の図に示します。

図2‒6　イベント相関タイプがしきい値の場合の引き継ぎ例

属性名:$EVn_m_属性名のn，mはどちらも省略できます。n，mを省略した場合の引き継ぎについて，例を用いて説明します。

例1

メッセージにLogin errorを含むJP1イベントが3回発行された場合に相関元イベントのメッセージを引き継いだ相関イベントを発行する。

相関イベント発行定義ファイルの定義内容

[ex.1]

CON=CID:1,B.MESSAGE*="Login error"

TYPE=threshold:3

SUCCESS_EVENT=B.ID:A00,E.SEVERITY:Error,B.MESSAGE:設定値

表2‒51　満たしたい要件と設定値（例1の場合）

項番

満たしたい要件

設定値

1

1番目（最初）にイベント条件に合致したJP1イベントのメッセージを相関イベントに引き継ぐ。

$EV1_1_B.MESSAGE，

または$EV_1_B.MESSAGE

2

2番目にイベント条件に合致したJP1イベントのメッセージを引き継ぐ。

$EV1_2_B.MESSAGE，

または$EV_2_B.MESSAGE

3

3番目（最後）にイベント条件に合致したJP1イベントのメッセージを引き継ぐ。

$EV1_3_B.MESSAGE，

$EV1_B.MESSAGE，

$EV_3_B.MESSAGE，

または$EV_B.MESSAGE

例2

次の条件のどれかに該当するJP1イベントが10回発行された場合に，相関元イベントのメッセージを引き継いだ相関イベントを発行する。

イベントIDが100で，メッセージにWarningを含む。

イベントIDが200で，メッセージにWarningまたはErrorを含む。

相関イベント発行定義ファイルの定義内容

[ex.2]

CON=CID:100,B.ID==100,B.MESSAGE*="Warning"

CON=CID:200,B.ID==200,B.MESSAGE*="Warning";"Error"

TYPE=threshold:10

SUCCESS_EVENT=B.ID:B00,E.SEVERITY:Error,B.MESSAGE:設定値

表2‒52　満たしたい要件と設定値（例2の場合）

項番

要件

設定値

1

イベント条件（条件ID：100）に1番目（最初）に合致したJP1イベントのメッセージを相関イベントに引き継ぐ。

$EV100_1_B.MESSAGE

2

イベント条件（条件ID：100）に5番目に合致したJP1イベントのメッセージを相関イベントに引き継ぐ。

$EV100_5_B.MESSAGE

3

イベント条件（条件ID：100）に10番目（最後）に合致したJP1イベントのメッセージを相関イベントに引き継ぐ。

$EV100_10_B.MESSAGE

4

イベント条件に関係なく，1番目（最初）に処理されたJP1イベントのメッセージを相関イベントに引き継ぐ。

$EV_1_B.MESSAGE

5

イベント条件に関係なく，5番目に処理されたJP1イベントのメッセージを相関イベントに引き継ぐ。

$EV_5_B.MESSAGE

6

イベント条件に関係なく，10番目（最後）に処理されたJP1イベントのメッセージを相関イベントに引き継ぐ。

$EV_10_B.MESSAGE，

または$EV_B.MESSAGE

まとめると次のようになります。

nを省略した場合

nを省略すると，イベント条件に関係なく，mに指定した相関元イベントの順番だけで判定されます。つまり，mに3を指定していれば，相関イベントには，3番目に処理された相関元イベントの属性値が引き継がれます。

mを省略した場合

mを省略すると，順番に関係なく，最後に処理された相関元イベントが対象になります。しきい値が10件であれば，10番目に処理された相関元イベントの属性値が引き継がれます。

同時にnを指定していれば，イベント条件で最後に処理された相関元イベントの属性値が引き継がれます。

nおよびmを省略した場合

nおよびmを省略すると，イベント条件および処理の順番に関係なく，最後に処理された相関元イベントが対象になります。

なお，n，mのどちらを指定した場合でも，条件に合う（引き継ぎ元の）JP1イベントがない場合は，変数の部分が空文字（0バイト）に置き換わります。

(c) 相関元イベントの属性値の一部を相関イベントの属性値に引き継ぐ

相関元イベントの属性値の一部を切り出して，相関イベントに引き継ぎたい場合，変数 $EVn_ENVoを指定します。また，イベント条件は正規表現（*=）で指定し，属性値の切り出したい部分を( )で囲みます。

相関成立イベントは次の形式で指定します。

　SUCCESS_EVENT=属性名:$EVn_ENVo

この場合，CIDで引き継ぎたい相関元イベントを指定し，nにCIDの値を指定します。また，ENVoのoに切り出した順番を指定します。属性値の一部を切り出した場合の引き継ぎ例を次の図に示します。

図2‒7　変数$EVn_ENVoを使用した場合の相関成立イベントへの引き継ぎ例

上記の例では，条件ID（CID）=1の条件および条件ID（CID）=2で指定した相関元イベントのErrorCode=の右辺を( )を使って切り出し，相関イベントのメッセージに引き継いでいます。

変数 $EVn_ENVoを使うと，属性値に特定の文字列を含む相関元イベントが発行された場合に相関イベントを発行し，かつ，属性値に含まれる文字列の一部を相関イベントに引き継ぐこともできます。

この場合，イベント条件に指定した正規表現(*=)のあとの" ( " が何番目かでENVoのoに番号を指定します。つまり，イベント条件の正規表現(*=)のあとに続く相関元イベントの属性値に対して，左から右に" ( " を数え，引き継ぎたい個所の順番をoに指定します。

$EVn_ENVoで切り出される部分については，同一属性値条件に$EVn_ENVoを指定した場合と同じです。詳細については，「図2-3　イベント条件（CON）と$EVn_ENVoで切り出される部分の対応」を参照してください。

属性値に特定の文字列を含む相関元イベントが発行された場合に相関イベントを発行し，かつ，属性値に含まれる文字列の一部を相関イベントに引き継ぐ例を次に示します。

図2‒8　属性値に含まれる特定の文字列の一部を相関イベントに引き継ぐ例

上記の例では，次に示す相関元イベントが発行された場合に，相関イベントにその属性値を引き継ぐよう定義しています。

host= のあとに「MANAGER_A」または「AGENT_A，B，Cのどれか」を含む。

ErrorCode= のあとに4文字以上の文字列を含む※。

注※

4文字を超える場合は，4文字までを引き継ぎます。

ErrorCode=12345678・・・の場合，「1234」となります。

4文字未満の場合は，ErrorCode= 文字列のあとに続く文字列を含んで4文字を引き継ぎます。

ErrorCode=1 2006/11/11・・・の場合，「1 20」となります。

なお，ErrorCode=のあとの文字列が4文字未満だった場合，相関イベントは発行されません。

定義例

定義例1：重大度がエラー以上のJP1イベントを相関イベントとして発行する場合

VERSION=2

#エラー以上のJP1イベントを相関イベントとして発行する
[filter_over_error]
CON=CID:1,B.ID==1,E.SEVERITY==Error;Critical;Alert;Emergency
SUCCESS_EVENT=E.SEVERITY:Emergency,B.MESSAGE:$EV1_B.MESSAGE

定義例2：重大度がエラー以上のJP1イベント，およびJP1/AJSが発行した重大度がエラーのJP1イベントを相関イベントとして発行する場合

次のように設定した場合，JP1/AJSがエラーのJP1イベントを発行すると，相関イベント発行条件over_error，およびajs2_over_errorに一致するため，相関イベントは二つ発行されます。

VERSION=2

#エラー以上のJP1イベントを相関イベントとして発行する
[over_error]
CON=CID:1,E.SEVERITY==Error;Critical;Alert;Emergency
SUCCESS_EVENT=E.SEVERITY:Emergency,B.MESSAGE:$EV1_B.MESSAGE

#JP1/AJS2のエラーのJP1イベントを相関イベントとして発行する
[ajs2_over_error]
CON=CID:1,E.SEVERITY==Error,E.PRODUCT_NAME==/HITACHI/JP1/AJS2
SUCCESS_EVENT=E.SEVERITY:Emergency,B.MESSAGE:$EV1_B.MESSAGE

なお，JP1/AJSがエラーのJP1イベントを発行した場合に，相関イベントを1件だけ発行したい場合は，一つ目の相関イベント発行条件を次のように設定します。

VERSION=2

#エラー以上のJP1イベントを相関イベントとして発行する
#JP1/AJS2が発行したイベントは除外する
[over_error_and_not_ajs2]
CON=NOT,E.SEVERITY==Error,E.PRODUCT_NAME==/HITACHI/JP1/AJS2
CON=CID:1,E.SEVERITY==Error;Critical;Alert;Emergency
SUCCESS_EVENT=E.SEVERITY:Emergency,B.MESSAGE:$EV1_B.MESSAGE

#JP1/AJS2のエラーのJP1イベントを相関イベントとして発行する
[ajs2_over_error]
CON=CID:1,E.SEVERITY==Error,E.PRODUCT_NAME==/HITACHI/JP1/AJS2
SUCCESS_EVENT=E.SEVERITY:Emergency,B.MESSAGE:$EV1_B.MESSAGE

定義例3：タイムアウト時間を定義した場合

VERSION=2

[condition]
CON=NOT,E.SEVERITY==Error,E.PRODUCT_NAME==/HITACHI/JP1/AJS2

CON=CID:1,B.ID==1,B.MESSAGE==TEST,E.SEVERITY==Warning
CON=CID:2,B.ID==1,B.MESSAGE==TEST,E.SEVERITY==Error
CON=CID:3,B.ID==1,B.MESSAGE==TEST,E.SEVERITY==Critical

TIMEOUT=10
SUCCESS_EVENT=E.SEVERITY:Emergency,B.MESSAGE:$EV1_B.MESSAGE

定義例4：JP1/AJS2およびJP1/Baseの発行したエラーのJP1イベントのメッセージをまとめて，1件の相関イベントとして発行する場合

VERSION=2

[cond1]

CON=CID:1,E.SEVERITY==Error,E.PRODUCT_NAME>=HITACHI/JP1/AJS2
CON=CID:5,E.SEVERITY==Error,E.PRODUCT_NAME>=HITACHI/JP1/Base

SUCCESS_EVENT=E.SEVERITY:$EV1_E.SEVERITY,B.MESSAGE:"$EV1_B.MESSAGE $EV5_B.MESSAGE"

定義例5：変数 $EVn_ENVoを使った切り出しの例

メッセージに含まれる詳細コード「error△code△=△n△」を相関イベントのメッセージに設定する場合（nは任意の文字列，△は半角スペース）

VERSION=2

[SAMPLE]

CON=CID:100, B.MESSAGE*=(error△code△=.*△)
SUCCESS_EVENT=B.ID:100,E.SEVERITY:Emergency,B.MESSAGE:エラー情報[$EV100_ENV1△]

定義例6：相関の対象範囲をホストで絞り込み，同時相関数を20としてユーザーごとに相関イベントを発行する場合

VERSION=2

[condition2]
TARGET=B.SOURCESERVER==host1;host2;host3
CON=NOT, E.SEVERITY==Error, E.PRODUCT_NAME==/HITACHI/JP1/AJS2

CON=CID:1, B.ID==1, B.MESSAGE==TEST, E.SEVERITY==Warning
CON=CID:2, B.ID==1, B.MESSAGE==TEST, E.SEVERITY==Error
CON=CID:3, B.ID==1, B.MESSAGE==TEST, E.SEVERITY==Critical

SAME_ATTRIBUTE=E.USERNAME
CORRELATION_NUM=20
TIMEOUT=10
SUCCESS_EVENT=B.MESSAGE:$EV1_B.MESSAGE

相関イベント発行環境定義ファイル

形式

[論理ホスト名¥JP1CONSOLEMANAGER¥EVGEN]
"OPERATION_LOG_SIZE"=dword:16進数値
"OPERATION_LOG_NUM"=dword:16進数値

ファイル

任意のファイルを使用します。

格納先ディレクトリ

Windowsの場合

任意のフォルダ

UNIXの場合

任意のディレクトリ

説明

相関イベント発行履歴ファイルのサイズ，面数を定義するファイルです。

このファイルを更新する場合，JP1/IM - Managerが管理するプロセスのすべてが定義情報を更新します。

定義の反映時期

jbssetcnfコマンドを実行して定義を共通定義情報に反映したあとに，JP1/IM - Managerを再起動，またはjco_spmd_reloadコマンドを実行することで有効になります。

記述内容

[論理ホスト名¥JP1CONSOLEMANAGER¥EVGEN]

JP1/IM - Managerの環境設定のキー名称です。

論理ホスト名の部分を，物理ホストの場合はJP1_DEFAULTに，論理ホストの場合は論理ホスト名に設定します。

"OPERATION_LOG_SIZE"=dword:16進数値

相関イベント発行履歴ファイルの1面当たりのファイルサイズを16進数で指定します。00010000〜06400000（64キロバイト〜100メガバイト）の範囲で指定できます。デフォルトは，00A00000です。

"OPERATION_LOG_NUM"=dword:16進数値

相関イベント発行履歴ファイルの面数を16進で指定します。00000003から00000064（3面〜100面）の範囲で指定できます。デフォルトは，00000003（3面）です。

相関イベント発行履歴ファイルのサイズ，面数の算出方法

相関イベント発行履歴ファイルのサイズ，面数の調整をする場合，1日で増加する相関イベント発行履歴ファイルのサイズを算出し，必要に応じて保存したい日数を掛けてください。調整する場合は，算出された値より少し大きめの値にしてください。

見積もりの詳細については，JP1/IM - Managerのリリースノートを参照してください。

インシデント手動登録定義ファイル（incident.conf）

形式

VERSION=バージョン情報
SS_MODE={1|2|3}

#コメント行
[SS_URL=http://JP1/Service Supportのホスト:ポート番号]

ファイル

incident.conf（インシデント手動登録定義ファイル）

incident.conf.model（インシデント手動登録定義ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Consoleパス¥conf¥console¥incident¥

論理ホストのとき

共有フォルダ¥jp1cons¥conf¥console¥incident¥

UNIXの場合

物理ホストのとき

/etc/opt/jp1cons/conf/console/incident/

論理ホストのとき

共有ディレクトリ/jp1cons/conf/console/incident/

説明

JP1/IM - ViewのJP1イベントをインシデントとして他製品に登録する定義ファイルです。

定義の反映時期

jco_spmd_reloadコマンドを実行したあと，またはJP1/IM - Managerを再起動したあと，JP1/IM - ViewでJP1/IM - Manager（セントラルコンソール）にログインすると，インシデント手動登録定義ファイルの設定が有効になります。

記述内容

VERSION=バージョン情報

インシデント手動登録定義ファイルのバージョンを指定します。バージョン情報には，3を指定してください。このパラメーターを省略した場合，または値を正しく指定しなかった場合は，SS_URLパラメーター，およびSS_MODEパラメーターは無視されます。なお，このパラメーターを複数指定した場合は，最後の行に指定したものが有効になります。

表2‒53　バージョン情報とインシデント手動登録定義ファイルで指定できるパラメーター一覧

バージョン情報

パラメーター名

2

SS_URL※

3

SS_URL

SS_MODE

注※

SS_MODE=1での動作となります。

SS_MODE={1|2|3}

インシデントの登録モードを指定します。このパラメーターを指定する場合は，VERSIONパラメーターに3を指定してください。VERSIONパラメーターに3が指定されていない場合，このパラメーターは無視されます。指定できる値は，1，2，または3です。インシデントの登録モードの説明と選択基準を次の表に示します。

表2‒54　インシデントの登録モードの説明と選択基準

インシデントの登録モード

説明

選択基準

JP1/IM - Manager，JP1/IM - View，JP1/Service Supportの対応バージョン

SS_MODE=1

引き継ぐ属性と引き継ぎ先は固定している。

JP1/IM - Manager 10-00以前と同じ仕様でJP1/Service Supportと連携する場合

09-50以降

SS_MODE=2

引き継ぐ属性と引き継ぎ先は固定している。

SS_MODE=1で引き継ぐ属性のほかにイベントID（B.IDBASE）が引き継がれる。

イベントIDを登録する場合

JP1/IM - Manager，JP1/Service Support，JP1/Navigation Platformで連携する場合

10-10以降

SS_MODE=3

引き継ぐ属性と引き継ぎ先の組合せを設定できる。

1件の引き継ぎ先に，複数の属性を引き継ぐことができる。

任意の文字列を引き継ぐことができる。

任意の属性や任意の文字列を登録する場合

JP1/IM - Manager，JP1/Service Support，JP1/Navigation Platformでの連携も可能

11-50以降

このパラメーターを省略した場合，または値を正しく指定しなかった場合は，1が仮定されます。なお，このパラメーターを複数指定した場合は，最後の行に指定したものが有効になります。

インシデントの登録モードを指定すると，インシデントとして登録される情報が変化します。インシデントの登録モードとインシデントとして登録される情報については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「10.1.1　JP1/Service Supportと連携する場合にインシデントとして登録できるJP1イベントの属性」を参照してください。

#コメント行

#で始まる行は，コメント扱いとなります。

[SS_URL=http://JP1/Service Supportのホスト:ポート番号]

インシデントを登録するJP1/Service SupportのWWWページのURLを半角英数字および記号で指定します。デフォルトは，「SS_URL=」となっていて，何も設定されていません。

JP1/Service Supportを呼び出す際のURLの最大長は2,046文字です。インシデントの登録モードを2に設定した場合，イベントIDを引き継ぐため，登録モードを1に設定した場合より，引き継げるメッセージが短くなります。メッセージが途中で切れている場合は，ユーザーが［イベント詳細］画面に表示されているメッセージをJP1/Service Supportにコピー&ペーストしてください。

なお，このパラメーターに記載したJP1/Service Supportのポート番号については，JP1/IM - ViewのマシンからJP1/Service Supportのマシンに対して，ファイアウォールを通過できるよう設定する必要があります。

なお，JP1/IM - Managerをバージョンアップ後にJP1/Service Supportと連携する場合は，この行を追加したあと，次の作業を実施してください。

バージョン情報を"2"または"3"に変更する。

イベントIDを登録する場合（SS_MODE=2），または任意のJP1イベントの属性や文字列をインシデントとして引き継ぐ場合（SS_MODE=3）は，SS_MODEの行を追加し登録モードを指定する。

IDM_URLで始まる行をコメント扱いに変更する（#を付ける）。

JP1/IM - Managerを再起動またはjco_spmd_reloadコマンドを実行して定義内容を反映する。JP1/IM - Viewにログインしている場合は，JP1/IM - Viewを再起動する。

インシデント引き継ぎ情報設定ファイル（incident_info.conf）

形式

[@encode UTF-8]
#item-field-ID=value-to-be-set-for-the-item
JP1/Service Supportの案件項目指定ID=案件項目に設定する値[改行文字]

ファイル

incident_info.conf（インシデント引き継ぎ情報設定ファイル）

incident_info.conf.model（インシデント引き継ぎ情報設定ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Consoleパス¥conf¥console¥incident¥

論理ホストのとき

共有フォルダ¥jp1cons¥conf¥console¥incident¥

UNIXの場合

物理ホストのとき

/etc/opt/jp1cons/conf/console/incident/

論理ホストのとき

共有ディレクトリ/jp1cons/conf/console/incident/

説明

任意のJP1イベントの属性や文字列をJP1/Service Supportにインシデントとして引き継ぐ場合に，JP1イベントの属性や文字列を，JP1/Service Supportの［案件作成］画面のどの案件項目に引き継ぐかを定義します。

定義の反映時期

インシデントの登録モードを3に設定し，jco_spmd_reloadコマンドを実行したあと，またはJP1/IM - Managerを再起動したあと，JP1/IM - ViewでJP1/IM - Manager（セントラルコンソール）にログインすると，インシデント引き継ぎ情報設定ファイルの設定が有効になります。

記述内容

[@encode UTF-8]

インシデント引き継ぎ情報設定ファイルで使用する文字コードを指定します。@encodeステートメントは必ず先頭行に指定します。@encodeステートメントを省略した場合，マネージャーの文字コードを仮定します。指定できる文字コードはUTF-8です。UTF-8を指定した場合，定義ファイルのエンコーディングはUTF-8になります。

次の場合は，エラーメッセージ（KAVB1115-W）を出力してマネージャーの文字コードを仮定します。

@encodeを定義ファイルの先頭以外に記述した場合

@encodeのあとに文字コードを指定しなかった場合

次の場合は，エラーメッセージ（KAVB1119-W）を出力してマネージャーの文字コードを仮定します。

UTF-8以外の文字コードを指定した場合

マネージャーの文字コードは次のとおりです。

Windowsの場合

システムロケールごとに次のとおりです。

日本語：MS932（ただし，使用できる文字はSJISコードの範囲です。）

英語：C

中国語：GB18030

日本語または中国語以外：C

UNIXの場合

/etc/opt/jp1cons/conf/jp1co_env.confファイルに記述する環境変数LANGの設定に依存します。

#コメント行

#で始まる行は，コメント扱いとなります。

JP1/Service Supportの案件項目指定ID=案件項目に設定する値[改行文字]

インシデントとして登録するJP1イベントの属性や文字列，およびその情報をJP1/Service Supportの［案件作成］画面のどの案件項目に引き継ぐかを指定します。

JP1/Service Supportの案件項目指定ID

JP1/Service Supportの案件項目指定IDを指定します。案件項目指定IDが重複した場合は，先に定義した内容が優先されます。案件項目指定IDについては，マニュアル「JP1/Service Support 構築・運用ガイド」を参照してください。

案件項目に設定する値[改行文字]

任意の文字列および変数を指定します。引き継ぐ変数は複数指定でき，数に制限はありません。

指定できる文字列は，制御文字以外の任意の文字列です。制御文字（0x00〜0x0F，0x14〜0x1F，0x7F）を指定した場合は，空白（0x20）に置き換えられます。「$」を文字として指定したい場合は，エスケープ文字「¥」を「$」の前に指定します。文字列に改行を入れる場合は，改行を「¥n」で指定します。「¥n」を文字として指定したいは，「¥¥n」と指定します。

変数の指定方法を次の表に示します。

表2‒55　変数の指定方法

形式

説明

$変数名

変数は，「$変数名」の形式で指定します。指定できるJP1イベントの属性値と対応する変数名は，「表2-57　JP1/Service Supportの案件項目に指定できる変数」を参照してください。

${変数名}

変数の直後に英数字および_（アンダースコア）を指定する場合は，変数名を｛｝で囲みます。

$変数名$URLENC

${変数名$URLENC}

属性値をUTF-8の文字列としてURLエンコードして展開します。

$変数名$ENC

${変数名$ENC}

属性値をBase64でエンコードして展開します。

$変数名$ENC$URLENC

${変数名$ENC$URLENC}

属性値をBase64でエンコード後，URLエンコードして展開します。

変数の指定例を次の表に示します。この例では，イベントID（$EVID）は100:0，拡張属性EX（$EV"EX"）はABCが設定されていると仮定します。

表2‒56　変数の指定例

指定例

変換後の情報

$EVID abc

100:0 abc

$EVIDabc

Windowsの場合

$EVIDabc

UNIXの場合

なし

${EVID}abc

100:0abc

$EVID_abc

Windowsの場合

$EVID_abc

UNIXの場合

なし

${EVID}_abc

100:0_abc

$EV"EX" abc

ABC abc

$EV"EX"abc

ABCabc

次の表に示す変数名を使用することで，任意の属性を引き継ぐことができます。なお，引き継ぎ個所は任意のため，引き継ぐ属性と引き継ぎ個所の表示の型の整合性がとれるように設定してください。

表2‒57　JP1/Service Supportの案件項目に指定できる変数

項目

引き継ぐ内容

変数名

イベント基本情報全体

イベント基本情報全体

EVBASE

イベントID（基本部:拡張部）

イベントID（基本コード:拡張コード）の値

基本コードはイベントID（B.ID），拡張コードはイベントID（拡張部）（B.IDEXT）の値。基本コードおよび拡張コードは，どちらも8桁の16進数（A〜Fは大文字），IDの前の0は省略する。拡張コードが00000000の場合，「基本コード:0」に変換する。

EVID

イベントID（基本部）

イベントID（基本コード）の値

8桁の16進数（A〜Fは大文字），IDの前の0は省略する。

EVIDBASE

イベント登録日

登録時刻（B.TIME）を「yyyy/mm/dd」形式にした文字列

EVDATE

イベント登録時刻（hh:mm:ss）

登録時刻（B.TIME）を「hh:mm:ss」形式にした文字列

EVTIME

発行元プロセスID

B.PROCESSIDの値

EVPID

発行元プロセスのユーザーID

B.USERIDの値

EVUSRID

発行元プロセスのグループID

B.GROUPIDの値

EVGRPID

発行元ユーザー名

B.USERNAMEの値

EVUSR

発行元グループ名

B.GROUPNAMEの値

EVGRP

発行元イベントサーバ名

B.SOURCESERVERの値

発生元ホストマッピングが無効の場合だけ

EVHOST

発行元IPアドレス

B.SOURCEIPADDRの値

EVIPADDR

イベントDB内通し番号

B.SEQNOの値

EVSEQNO

イベント到着日

到着時刻（B.ARRIVEDTIME）を「yyyy/mm/dd」形式にした文字列

EVARVDATE

イベント到着時刻

到着時刻（B.ARRIVEDTIME）を「hh:mm:ss」形式にした文字列

EVARVTIME

発生元のイベントDB内通し番号

B.SOURCESEQNOの値

EVSRCNO

メッセージ

B.MESSAGEの値

EVMSG

詳細情報

詳細情報（B.DETAIL）を「情報1△情報2△情報3△…情報n△」形式にした文字列

△：半角スペース

EVDETAIL

重大度

E.SEVERITYの値

EVSEV

ユーザー名

E.USER_NAMEの値

EVUSNAM

オブジェクトタイプ

E.OBJECT_TYPEの値

EVOBTYP

オブジェクト名

E.OBJECT_NAMEの値

EVOBNAM

登録名タイプ

E.ROOT_OBJECT_TYPEの値

EVROBTYP

登録名

E.ROOT_OBJECT_NAMEの値

EVROBNAM

プロダクト名

E.PRODUCT_NAMEの値

EV"PRODUCT_NAME"

オブジェクトID

E.OBJECT_IDの値

EV"OBJECT_ID"

事象種別

E.OCCURRENCEの値

EV"OCCURRENCE"

開始時刻

E.START_TIMEの値

EV"START_TIME"

終了時刻

E.END_TIMEの値

EV"END_TIME"

終了コード

E.RESULT_CODEの値

EV"RESULT_CODE"

発生元ホスト名

E.JP1_SOURCEHOSTの値

発生元ホストマッピングが有効の場合だけ

EV"JP1_SOURCEHOST"

任意の拡張属性

拡張属性名で指定された属性の属性値

EV"拡張属性名"

相関イベントフラグ

E.@JP1IM_CORRELATEの値

相関イベントではない：0

相関成立イベント：1

相関不成立イベント：2

相関イベント発行機能が有効で，かつ統合監視DBが有効な場合だけ

EV"@JP1IM_CORRELATE"

変更前の重大度

E.@JP1IM_ORIGINAL_SEVERITYの値

重大度変更機能が有効な場合だけ

EV"@JP1IM_ORIGINAL_SEVERITY"

重大度変更フラグ

E.@JP1IM_CHANGE_SEVERITYの値

重大度を変更していない：0

重大度を変更した：1

重大度変更機能が有効な場合だけ

EV"@JP1IM_CHANGE_SEVERITY"

変更後のメッセージ

E.@JP1IM_DISPLAY_MESSAGEの値

表示メッセージ変更機能が有効な場合だけ

EV"@JP1IM_DISPLAY_MESSAGE"

表示メッセージ変更フラグ

E.@JP1IM_CHANGE_MESSAGEの値

メッセージを変更していない：0

メッセージを変更した：1

表示メッセージ変更機能が有効な場合だけ

EV"@JP1IM_CHANGE_MESSAGE"

メモ

E.@JP1IM_MEMOの値

メモを設定したあとに設定される属性

EV"@JP1IM_MEMO"

共通除外条件群ID

E.JP1_IMCOMEXCLUDE_IDの値

共通除外の拡張モードが有効で，かつ統合監視DBが有効な場合だけ

EV"JP1_IMCOMEXCLUDE_ID"

共通除外条件群名

E.JP1_IMCOMEXCLUDE_NAMEの値

共通除外の拡張モードが有効で，かつ統合監視DBが有効な場合だけ

EV"JP1_IMCOMEXCLUDE_NAME"

共通除外条件群除外対象

E.JP1_IMCOMEXCLUDE_TARGETの値

共通除外の拡張モードが有効で，かつ統合監視DBが有効な場合だけ

EV"JP1_IMCOMEXCLUDE_TARGET"

表に示す変数名以外が指定された場合，変数が記述されている個所はイベント引き継ぎ情報に変換しません。例えば，変数名「AAA」を「$AAA」として指定した場合，JP1/Service Supportの［案件作成］画面には「$AAA」が引き継がれます。

EV"拡張属性名"で指定された属性の値が取得できなかった場合，変数が記述されている個所はイベント引き継ぎ情報に変換しません。例えば，「$EV"BBB"」と指定しているとき，JP1イベントに拡張属性「BBB」がない場合，JP1/Service Supportの［案件作成］画面には「$EV"BBB"」が引き継がれます。

EV"拡張属性名"以外の変数で指定された属性の値が取得できなかった場合，変数が記述されている個所は空文字に変換します。例えば，「$EVSEV」を指定しているとき，JP1イベントに拡張属性「SEVERITY」がなければ，JP1/Service Supportの［案件作成］画面には「」（空文字）が引き継がれます。

定義例

JP1/Service Supportの［案件作成］画面のタイトル項目に，「発生元ホスト（IPアドレス）で発生したイベント：イベントID」と表示する場合（発生元ホストマッピングが有効のとき）

TITLE=$EV"JP1_SOURCEHOST"($EVIPADDR)で発生したイベント：$EVIDBASE

JP1/Service Supportの［案件作成］画面の関連情報項目に，URLリンクを表示する（属性値をUTF-8の文字列としてURLエンコードする）場合

LINKURL=http://host/page?msg=$EVMSG$URLENC

ホスト情報ファイル（jcs_hosts）

形式

IPアドレス ホスト名1 ホスト名2 ホスト名3 ... ホスト名8
IPアドレス ホスト名1 ホスト名2 ホスト名3 ... ホスト名8
              :

ファイル

jcs_hosts（ホスト情報ファイル）

jcs_hosts.model（ホスト情報ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Scopeパス¥conf¥

論理ホストのとき

共有フォルダ¥jp1scope¥conf¥

UNIXの場合

物理ホストのとき

/etc/opt/jp1scope/conf/

論理ホストのとき

共有ディレクトリ/jp1scope/conf/

説明

JP1/IM - Manager（セントラルスコープ）が管理するホスト情報を定義するファイルです。

ホスト情報ファイルは，監視ツリーの自動生成，および監視オブジェクトの状態を変更するJP1イベント照合処理の際のホスト名比較に使用するホスト情報を記述するファイルです。なお，ホスト情報ファイルの形式は，hostsファイルと同じです。

#を指定した場合，#以降は改行されるまでコメント扱いとなります。

定義の反映時期

ホスト情報ファイルの内容は，jcshostsimportコマンド実行後，JP1/IM - Managerを再起動，またはjco_spmd_reloadコマンドを実行することで有効になります。

jcshostsimportコマンドでホスト情報ファイルの内容をホスト情報DBに格納すると，ホスト名はすべて小文字になります。そのため，jcshostsexportで出力するホスト情報のホスト名も，すべて小文字になります。

jcshostsimportコマンドでは，ホスト情報ファイルのコメントは格納されません。

記述内容

IPアドレス ホスト名1 ホスト名2 ホスト名3 ... ホスト名8

空白を除く行の先頭にIPアドレスを記述し，複数の空白またはタブのあとにホスト名，エイリアス名を記述します。

IPアドレスの文字数は，最大63バイトです。IPv6アドレス形式のIPアドレスには対応していません。

ホスト名，エイリアス名の文字数は，一つにつき最大255バイトです。

一つのIPアドレスに対し，最大八つホスト名を記述できます。また，一つのホスト名に対し，指定できるIPアドレスの数は最大八つです。

同じIPアドレスの記述が複数存在した場合は，最初の定義が有効になります。

IPアドレスだけを指定した行がある場合はjcshostsimportコマンド実行時にエラーとなります。

ホスト名の大文字・小文字は区別されません。ホスト名には，日本語を使用できません。IPアドレスは，16進数表記でも記述できます。

定義例

#
# jcs_hosts
#
# Internet Address Hostname
100.100.10.10     samplehost1  samplehost2

ガイド情報ファイル（jcs_guide_xxx.txt）

形式1

DESC_VERSION=1

[EV_GUIDE_数字]
NUM=数字
EV_COMP_数字=属性指定:正規表現
EV_TITLE=文字列
EV_GUIDE=メッセージ
[END]
[EV_GUIDE_数字]
NUM=数字
EV_COMP_数字=属性指定:正規表現
EV_TITLE=文字列
EV_GUIDE=メッセージ
[END]
   :

形式2

DESC_VERSION=2

[EV_GUIDE_数字]
NUM=数字
EV_COMP_数字=属性指定:正規表現
EV_TITLE=文字列
EV_FILE=ガイドメッセージファイル
[END]
[EV_GUIDE_数字]
NUM=数字
EV_COMP_数字=属性指定:正規表現
EV_TITLE=文字列
EV_FILE=ガイドメッセージファイル
[END]
   :

ファイル

ガイド情報ファイル（jcs_guide_xxx.txt）は，JP1/IMの動作する言語コードによって，編集するファイルが異なります。JP1/IMの動作する言語コードと，編集するガイド情報ファイルの対応を次の表に示します。

表2‒58　JP1/IMの動作する言語コードとガイド情報ファイルの対応

OS

言語種別

JP1/IMの動作する言語コード

編集するファイル

Windows

日本語

jcs_guide_sjis.txt（ガイド情報ファイル）

jcs_guide_sjis.txt.model

（ガイド情報ファイルのモデルファイル）

英語

jcs_guide.txt（ガイド情報ファイル）

jcs_guide.txt.model（ガイド情報ファイルのモデルファイル）

中国語

jcs_guide_GB18030.txt（ガイド情報ファイル）

UNIX※

日本語

シフトJISコード

jcs_guide_sjis.txt（ガイド情報ファイル）

jcs_guide_sjis.txt.model

（ガイド情報ファイルのモデルファイル）

EUCコード

jcs_guide_euc.txt（ガイド情報ファイル）

jcs_guide_euc.txt.model

（ガイド情報ファイルのモデルファイル）

UTF-8コード

/etc/opt/jp1scope/conf/jcs_guide_UTF-8.txt

共有ディレクトリ/jp1scope/conf/jcs_guide_UTF-8.txt

英語

jcs_guide.txt（ガイド情報ファイル）

jcs_guide.txt.model

（ガイド情報ファイルのモデルファイル）

中国語

GB18030コード

jcs_guide_GB18030.txt（ガイド情報ファイル）

注※　OSがサポートしている言語と対応するファイルだけが存在します。

言語コードに対応したガイド情報ファイルを使用してください。

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Scopeパス¥conf¥

論理ホストのとき

共有フォルダ¥jp1scope¥conf¥

UNIXの場合

物理ホストのとき

/etc/opt/jp1scope/conf/

論理ホストのとき

共有ディレクトリ/jp1scope/conf/

説明

監視オブジェクトの状態変更の契機となったJP1イベントに関するガイド情報を定義するファイルです。

このファイルで記述した内容は，JP1/IM - Viewの［ガイド］画面に表示されます。

ガイド情報ファイルの最大サイズは，1メガバイトです。

形式2は，ユーザーによって作成されたTXT形式またはHTML形式のファイルをガイドメッセージファイルとして読み込んで［ガイド］画面に表示させる場合に，記述する方法です。

複数のガイド情報が一致する場合，ガイド情報ファイルで先に記述してある情報が有効になります。

Windowsの場合，07-00のJP1/IM - Manager（セントラルスコープ）のガイド情報ファイルは，08-00以降のJP1/IM - Managerでも読み込めます。

Windowsの場合，08-00以降のJP1/IM - Managerのガイド情報ファイルは，07-00のJP1/IM - Manager（セントラルスコープ）でも読み込むことはできますが，DESC_VERSION=2のEV_FILE=ガイドメッセージファイルの記述は無視され，EV_GUIDE=メッセージの記述が優先されます。両方の記述がない場合はエラーとなります。

#を指定した場合，#以降は改行されるまでコメント扱いとなります。ただし，開始タグ，属性情報，終了タグの後方にコメントを記述できません。開始タグと終了タグの後方にコメントを記述した場合は，エラーとなります。また，属性値の後方にコメントを書いた場合は，属性値の一部として認識されます。

¥を記述する場合，¥¥と記述する必要があります。¥nおよび¥$以外に¥を記述していた場合はログが出力され，¥を記述した行を無視して処理します。

定義の反映時期

ガイド情報ファイル編集後，JP1/IM - Managerを再起動，またはjco_spmd_reloadコマンドを実行することで有効になります。

記述内容

DESC_VERSION=1 | 2

ガイド情報ファイルのバージョンを表しています。指定できる値は1または2です。

EV_FILEパラメーターを指定してガイドメッセージファイル呼び出す場合は，値を2にする必要があります。

DESC_VERSION=1でEV_GUIDE=メッセージとEV_FILE=ガイドメッセージファイルを同時に指定した場合，EV_FILE=ガイドメッセージファイルの記述は無視されます。

DESC_VERSION=2でEV_GUIDE=メッセージとEV_FILE=ガイドメッセージファイルを同時に指定した場合，EV_FILE=ガイドメッセージファイルの記述が優先されます。

[EV_GUIDE_数字]

ガイド情報の開始タグです。[EV_GUIDE_数字]〜[END]で一つの定義ブロックとなります。このパラメーターと[END]の間に［ガイド］画面への表示対象となるJP1イベントの条件および表示するメッセージを記述します。数字は，1からガイドの数だけ1ずつ増加します。

EV_GUIDE_数字タグ内の文字列は一意にしてください。不正な文字列がある場合はログが出力され，該当個所を無視して処理します。

EV_GUIDE_数字タグ内に記述できる属性以外が記述されている場合は，該当個所を無視して処理します。

NUM=数字

数字には，EV_COMP_数字のエントリー数を記述します。

EV_COMP_数字=属性指定:正規表現

このパラメーターは，比較する属性の数だけ記述します。数字は，1から1ずつ増加します。複数記述した場合は，AND条件が成立すると，EV_GUIDEパラメーターで記述したメッセージを［ガイド］画面に表示します。

EV_COMP_数字の数字は，NUMで指定された範囲内の数字(1〜NUM)でない場合は，無視されます。

イベントIDは8けた表記で記述してください。なお，EV_COMP_数字の属性指定にB.IDと記述し，一致条件にイベントIDの基本部だけを指定する場合，拡張部の記述を省略できます。

例

EV_COMP_1=B.ID:00004107:00000000またはEV_COMP_1=B.ID:00004107

属性指定

次の属性を指定できます。

・JP1イベントの基本属性：指定する場合「B.属性名」と指定します。

・JP1イベントの拡張属性：指定する場合「E.属性名」と指定します。

・監視ノードの属性：指定する場合「T.MONNODEID」(監視ノードID)を指定できます（監視ノードIDは，16進数8桁で指定してください）。

正規表現

属性指定で指定した属性の内容を正規表現で記述します。正規表現には拡張正規表現を使用します。正規表現の詳細については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「付録G　正規表現」を参照してください。

EV_TITLE=文字列

文字列には，［ガイド］画面のタイトルに表示される文字列を記述します。このパラメーターは，[EV_GUIDE_数字]と[END]の間に一つしか記述できません。

EV_GUIDE=メッセージ

メッセージには，［ガイド］画面のガイドメッセージに表示される文字列を記述します。HTMLタグを記述すれば，［ガイド］画面に表示されるガイドメッセージをHTML形式で表示できます（記述できるHTMLタグはEV_FILEの説明文にある「表2-59　ガイドメッセージとして使用できるHTMLタグ」を参照のこと）。このパラメーターは，[EV_GUIDE_数字]と[END]の間に一つしか記述できません。

また，文字数は10,240バイト以内にしてください。10,241バイト以上記述した場合，10,241バイト以降のメッセージは，［ガイド］画面に表示されません。

なお，メッセージ中に¥を記述する場合は¥¥，$を記述する場合は¥$と記述します。メッセージ中に$B.属性名△，$E.属性名△を指定した場合，JP1イベントの属性名に対応する属性値がメッセージとして展開されます（△は半角スペースを表す）。また，$T.MONNODEID△を指定した場合は，監視ノードIDに置き換えられます（△は半角スペースを表す）。対応する属性が存在しない場合は，空に置き換えられます。

メッセージに改行を入れる場合は，¥nと指定します。

EV_FILE=ガイドメッセージファイル

ガイドメッセージファイルには，［ガイド］画面に表示されるガイドメッセージの内容を記述したファイルの名称をフルパスまたは相対パス（起点はScopeパス¥conf¥guide¥，または/etc/opt/jp1scope/conf/guide/）で指定します。このパラメーターは，[EV_GUIDE_数字]と[END]の間に一つしか記述できません。

ファイル名は，パスを含めて1,024バイト以内の文字数にしてください。1,024バイトを超えた場合，JP1/IM - Managerの起動時またはJP1/IM - Viewからのガイドメッセージファイル呼び出し時にエラーとなります。

また，このパラメーターを指定する場合は，DESC_VERSIONの値を2にしてください。

ガイドメッセージファイルとして指定できるファイルの名称，拡張子はユーザー任意です。なお，ファイル名称にはご利用元で管理しやすい名称を，拡張子は表示するガイドメッセージがTXT形式であれば.txtを，HTML形式であれば.html，.htmを使用することをお勧めします。

（例）guide001_AJS2.txt，またはguide001_AJS2.htm

ガイドメッセージファイル

ガイドメッセージファイルには，［ガイド］画面から表示させたい情報をTXT形式またはHTML形式で記述します。記述できる内容は，ガイド情報ファイルのEV_GUIDEで記述できる内容と同じです。なお，ガイドメッセージファイルの場合，改行を挿入して体裁を整えることもできます。

ガイドメッセージファイルに記述されている内容および構文チェックはしません。

作成したガイドメッセージファイルは，任意のフォルダに格納できますが，クラスタ構成の場合にシステムのフェールオーバーに対応するためには次のフォルダに格納することを推奨します。

・Windowsの場合

共有フォルダ¥jp1scope¥conf¥guide¥

・UNIXの場合

共有ディレクトリ/jp1scope/conf/guide/

ガイドメッセージファイルの最大サイズは，1メガバイトです。1メガバイトを超えた場合，JP1/IM - Viewの［ガイド］画面からのガイドメッセージファイル読み込み時にエラーとなります。

HTML形式のガイドメッセージファイルを作成する場合に使用できるHTMLタグおよび属性を次に示します。

表2‒59　ガイドメッセージとして使用できるHTMLタグ

タグ

属性

説明

HTML

−

HTML文章であることを宣言します。このタグは必須です。

HEAD

−

HTML文章のヘッダーを宣言します。

このタグは必須です。

BODY

−

HTML文章の本文を宣言します。

このタグは必須です。

A

HREF="URL"

リンク先URLを指定します。相対パスおよび「mailto:」で始まるURLは動作保証されません。

ここで指定したリンクは［ガイド］画面（HTML形式）に表示されます。クリックするとWWWブラウザーが起動し，指定したURLにアクセスできます。

H1，H2，H3，H4，H5，H6

−

見出しを指定します。

FONT

SIZE="文字サイズ"

文字サイズを指定します。指定できる値は1〜7です。

COLOR="文字色"

文字色を指定します。指定できる色は次の16色です。

black，silver，gray，white，maroon，red，purple，fuchsia，green，lime，olive，yellow，navy，blue，teal，aqua

これ以外の文字色は動作保証されません。

B

−

文字を太字にします。

I

−

文字を斜体にします。

HR

−

けい線を引きます。

BR

−

強制的に改行します。

（凡例）　−：なし

なお，このほかのHTMLタグについては動作保証していません。

[END]

ガイド情報の終了タグです。

定義例

# JP1/IM-CS Guide Information File.

DESC_VERSION=1
[EV_GUIDE_1]
NUM=2
EV_TITLE=JP1/AJS2　業務Aの異常終了
EV_COMP_1=T.MONNODEID:0000000A
EV_COMP_2=B.ID:00000111
EV_GUIDE=業務Aが異常終了しました。$E.C0 のホストで異常が発生していないか確認してください。
[END]
[EV_GUIDE_2]
NUM=1
EV_COMP_1=B.ID:00004107
EV_GUIDE=ジョブが異常終了しました。$E.C0 のホストで異常が発生していないか確認してください。¥n以前の障害例として，ホストAではメモリ不足によりジョブが失敗した事があります。vmstatコマンドでメモリ空き容量を確認してください。
[END]

状態変更イベント件数の上限監視設定ファイル（evhist_warn_event_xxx.conf）

形式

[論理ホスト名¥JP1SCOPE¥BMS¥EVHISTORY]
"EVHIST_WARN_EVENT"=dword:値

ファイル

evhist_warn_event_on.conf（状態変更イベント件数の上限監視を有効にする場合に使用します）

evhist_warn_event_off.conf（状態変更イベント件数の上限監視を無効にする場合に使用します）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Scopeパス¥conf¥

論理ホストのとき

共有フォルダ¥jp1scope¥conf¥

UNIXの場合

物理ホストのとき

/etc/opt/jp1scope/conf/

論理ホストのとき

共有ディレクトリ/jp1scope/conf/

説明

状態変更イベントの件数が上限（100件）を超えた場合に，JP1イベントの発行を有効にするかどうかを設定するファイルです。

有効にした場合は，監視オブジェクトの状態変更イベントが100件を超えたときに，JP1イベントを発行します。発行されるJP1イベントは，イベントIDが3FB1の警告イベントです。

JP1/IM - Managerを新規インストールした場合は，有効（JP1イベントを発行する）になっています。バージョンアップ時は，バージョンアップ前に設定を無効にしていた場合は，無効（JP1イベントを発行しない）になっています。

定義の反映時期

jbssetcnfコマンドを実行し，JP1/IM - Managerを再起動したあとに有効になります。

記述内容

[論理ホスト名¥JP1SCOPE¥BMS¥EVHISTORY]

JP1/IMの環境設定のキー名称です。

論理ホスト名の部分を，物理ホストの場合はJP1_DEFAULTに，論理ホストの場合は論理ホスト名に設定します。

"EVHIST_WARN_EVENT"=dword:値

evhist_warn_event_on.confは，値が「00000001」です（イベントIDが3FB1のJP1イベントが発行される）。

evhist_warn_event_off.confは，値が「00000000」です（イベントIDが3FB1のJP1イベントが発行されない）。

このパラメーターは編集しないでください。

JP1イベントの詳細については，「3.2.2　JP1/IM - Managerが出力するJP1イベントの詳細」を参照してください。

対処済み連動設定ファイル（action_complete_xxx.conf）

形式

[論理ホスト名¥JP1SCOPE¥BMS]
"ACTION_COMPLETE_MODE"=dword:値

ファイル

action_complete_on.conf（対処済み連動機能を有効にする場合に使用します）

action_complete_off.conf（対処済み連動機能を無効にする場合に使用します）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Scopeパス¥conf¥

論理ホストのとき

共有フォルダ¥jp1scope¥conf¥

UNIXの場合

物理ホストのとき

/etc/opt/jp1scope/conf/

論理ホストのとき

共有ディレクトリ/jp1scope/conf/

説明

対処済み連動機能を有効にするかどうかを設定するファイルです。

有効にした場合は，セントラルコンソールでのJP1イベントの対処状況に連動して，セントラルスコープの監視オブジェクトの状態が変わります。

JP1/IM - Managerを新規インストールした場合は，有効になっています。バージョンアップ時は，バージョンアップ前に設定を無効にしていた場合は，無効になっています。

定義の反映時期

jbssetcnfコマンドを実行し，JP1/IM - Managerを再起動したあとに有効になります。

記述内容

[論理ホスト名¥JP1SCOPE¥BMS]

JP1/IMの環境設定のキー名称です。

論理ホスト名の部分を，物理ホストの場合はJP1_DEFAULTに，論理ホストの場合は論理ホスト名に設定します。

"ACTION_COMPLETE_MODE"=dword:値

action_complete_on.confは，値が「00000001」です。

action_complete_off.confは，値が「00000000」です。

このパラメーターは編集しないでください。

状態変更イベント自動削除設定ファイル

形式

[論理ホスト名¥JP1SCOPE¥BMS¥EVHISTORY]
"EVPROCESSED_MODE"=dword:値

ファイル

任意のファイルを使用します。

格納先ディレクトリ

Windowsの場合

任意のフォルダ

UNIXの場合

任意のディレクトリ

説明

JP1イベントの対処状況を「対処済」にしたときに，状態変更イベントを自動で削除する機能を有効にするための定義ファイルです。

JP1/IM - Managerを新規インストールした場合は，無効になっています。バージョンアップ時は，バージョンアップ前に設定を有効にしていた場合は，有効になっています。

定義の反映時期

jbssetcnfコマンドを実行し，JP1/IM - Managerを再起動したあとに有効になります。

記述内容

[論理ホスト名¥JP1SCOPE¥BMS¥EVHISTORY]

JP1/IMの環境設定のキー名称です。

論理ホスト名の部分を，物理ホストの場合はJP1_DEFAULTに，論理ホストの場合は論理ホスト名に設定します。

"EVPROCESSED_MODE"=dword:値

状態変更イベントの自動削除機能を有効にする場合は「1」を，無効にする場合は「0」を指定します。

監視オブジェクト初期化設定ファイル

形式

[論理ホスト名¥JP1SCOPE¥BMS]
"AUTO_INITIALIZE_MODE"=dword:値

ファイル

任意のファイルを使用します。

格納先ディレクトリ

Windowsの場合

任意のフォルダ

UNIXの場合

任意のディレクトリ

説明

特定のJP1イベントを受信したときに，監視オブジェクトを自動で初期化する機能を有効にするための定義ファイルです。

JP1/IM - Managerを新規インストールした場合は，無効になっています。バージョンアップ時は，バージョンアップ前に設定を有効にしていた場合は，有効になっています。

定義の反映時期

jbssetcnfコマンドを実行し，JP1/IM - Managerを再起動したあとに有効になります。

記述内容

[論理ホスト名¥JP1SCOPE¥BMS]

JP1/IMの環境設定のキー名称です。

論理ホスト名の部分を，物理ホストの場合はJP1_DEFAULTに，論理ホストの場合は論理ホスト名に設定します。

"AUTO_INITIALIZE_MODE"=dword:値

監視オブジェクトの自動初期化機能を有効にする場合は「1」を，無効にする場合は「0」を指定します。

監視オブジェクトDBの自動バックアップ・リカバリー設定ファイル（auto_dbbackup_xxx.conf）

形式

[論理ホスト名¥JP1SCOPE¥BMS]
"AUTO_DB_BACKUP_RECOVERY"=dword:値

ファイル

auto_dbbackup_on.conf（監視オブジェクトDBのバックアップ・リカバリーを有効にする場合に使用します）

auto_dbbackup_off.conf（監視オブジェクトDBのバックアップ・リカバリーを無効にする場合に使用します）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Scopeパス¥conf¥

論理ホストのとき

共有フォルダ¥jp1scope¥conf¥

UNIXの場合

物理ホストのとき

/etc/opt/jp1scope/conf/

論理ホストのとき

共有ディレクトリ/jp1scope/conf/

説明

監視ツリー更新中の，OSのシャットダウンやクラスタシステムの系切り替え発生による，監視オブジェクトDBの破損を防ぐための機能（監視オブジェクトDBの自動バックアップ・リカバリー機能）を有効にするかどうかを設定するファイルです。

有効にした場合は，監視ツリー更新時に更新前の監視オブジェクトDBをバックアップし，障害発生時には，バックアップした監視オブジェクトDBをリカバリーします（障害の発生なしで更新処理が終了した場合には，バックアップデータは自動的に削除されます）。

JP1/IM - Managerを新規インストールした場合は，デフォルトで有効になっています。バージョンアップした場合には，従来の設定を引き継ぎます。

なお，クラスタ運用している場合は，必ず有効に設定してください。

定義の反映時期

jbssetcnfコマンドを実行し，JP1/IM - Managerを再起動したあとに有効になります。

記述内容

[論理ホスト名¥JP1SCOPE¥BMS]

JP1/IMの環境設定のキー名称です。

論理ホスト名の部分を，物理ホストの場合はJP1_DEFAULTに，論理ホストの場合は論理ホスト名に設定します。

"AUTO_DB_BACKUP_RECOVERY"=dword:値

auto_dbbackup_on.confは，値が「00000001」です。

auto_dbbackup_off.confは，値が「00000000」です。

このパラメーターは編集しないでください。

記述例

論理ホストHostAのJP1/IM - Managerに対し，監視オブジェクトDBの自動バック・リカバリー機能を有効にします。

[HostA¥JP1SCOPE¥BMS¥JCSDB]"AUTO_DB_BACKUP_RECOVERY"=dword:00000001

オブジェクトタイプ定義ファイル

形式

@encode 文字コード
[コメント]
[ObjectType]
定義ブロック [コメント]
[End]
[コメント]

ファイル

会社名_製品名_会社名_製品名_obj.ja（オブジェクトタイプ定義ファイル）

なお，「製品名」は，「シリーズ名_製品名」とすることもできます。JP1イベント発行時の「PRODUCT_NAME」に指定する値の「/」を「_」に変更してファイル名に使用することをお勧めします。また，標準提供ファイル名称用に「hitachi」を使用しているため，「会社名」には「hitachi」以外の名称を使用してください。

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Consoleパス¥conf¥console¥object_type¥

論理ホストのとき

共有フォルダ¥jp1cons¥conf¥console¥object_type¥

UNIXの場合

物理ホストのとき

/etc/opt/jp1cons/conf/console/object_type/

論理ホストのとき

共有ディレクトリ/jp1cons/conf/console/object_type/

説明

オブジェクトタイプ定義ファイルは，次に示すJP1/IM - Viewの画面の［オブジェクトタイプ］および［登録名タイプ］に表示するオブジェクトタイプおよび登録名タイプを設定します。

［重要イベント定義］画面

［イベント取得条件設定］画面

［共通除外条件設定］画面

［共通除外条件設定(拡張)］画面

［繰り返しイベント条件設定］画面

［イベント検索条件設定］画面

［表示フィルター設定］画面

［ユーザーフィルター詳細設定］画面

［アクション詳細設定］画面

［重大度変更定義設定］画面（［追加重大度変更定義設定］画面）

［表示メッセージ変更定義設定］画面（［追加表示メッセージ変更定義設定］画面）

この定義ファイルは，Linux版のJP1/IM - ManagerではUTF-8コード，Linux版以外のJP1/IM - ManagerではシフトJIS，またはEUCコードで定義する必要があります。

複数のファイルに同一のオブジェクトタイプが存在した場合の動作は保証されません。

定義の反映時期

JP1/IM - Viewを再起動したあとに有効になります。

記述内容

@encode 文字コード

オブジェクトタイプ定義ファイルで使用する文字コードを指定します。

オブジェクトタイプ定義ファイルを追加で作成する場合は，@encodeステートメントで定義ファイルの文字コードを指定してください。

項目名には，@encodeステートメントに指定した文字コードで表現できる文字を記載します。また，オブジェクトタイプ定義ファイルは，@encodeステートメントに指定した文字コードで保存します。

次の場合，JP1/IM - Viewに表示される項目名が文字化けすることがあります。

項目名に，@encodeステートメントに指定した文字コードで表現できない文字を使用した場合

@encodeステートメントに指定した文字コード，ファイルを保存した文字コード，および@encodeステートメントに指定した文字コードが不一致の場合

@encodeステートメントが存在しない場合，および@encodeステートメントのあとに指定した文字コードに誤りがある場合は，文字コードが自動判別されます。ただし，定義ファイルの内容によっては正しく判別できないおそれがあります。

指定できる文字コードは次のとおりです。

C

EUCJIS

SJIS

UTF-8

GB18030

注意事項

定義ファイルをUTF-8で保存する場合は，BOM（byte order mark）が付与されないように保存してください。

次の場合，エラーが出力されます。

C，EUCJIS，SJIS，UTF-8，およびGB18030以外の文字コードを指定した場合

@encodeを定義ファイルの先頭以外に記述した場合

@encodeのあとに文字コードを指定しなかった場合

[コメント]

コメントは，「#」で開始する改行を含まない文字列です。

[ObjectType]

「[ObjectType]」および「[End]」は「[」および「]」を含めてそのまま記述します。

定義ブロック [コメント]

定義ブロックは，拡張属性値とリスト表示文字列で構成されます。拡張属性値は，オブジェクトタイプまたは登録名タイプに格納される文字列です。リスト表示文字列は，ドロップダウンリストに一覧表示する文字列です。

[End]

「[End]」は「[」および「]」を含めてそのまま記述します。

なお，定義する際には次の内容に注意してください。

オブジェクトタイプ（拡張属性値）に空白を入れることはできません。

リスト表示文字列には，日本語ではなく拡張属性値そのものを記述してください。

定義例

オブジェクトタイプ定義ファイルの定義例を次に示します。

@encode UTF-8
[ObjectType]
# 拡張属性値,  リスト表示文字列   コメント
ACTION,        ACTION          // アクション
ACTIONFLOW,    ACTIONFLOW      // アクションフロー
BATCHQUEUE,    BATCHQUEUE      // バッチキュー
JOB,           JOB             // ジョブ
JOBNET,        JOBNET          // ジョブネット
MEDIA,         MEDIA           // メディア
PRINTER,       PRINTER         // プリンタ
PRINTJOB,      PRINTJOB        // プリントジョブ
PRINTQUEUE,    PRINTQUEUE      // パイプキュー
PROCESS,       PROCESS         // プロセス
RESTORE,       RESTORE         // リストア
[End]

アプリケーション実行定義ファイル

形式

@file type="定義ファイルタイプ", version="定義フォーマットバージョン";
#コメント行
@define-block type="application-execution-def";
id="アプリケーション実行定義識別子";
path="コマンドパス";
description="アプリケーション実行の説明文";
@define-block-end;

ファイル

!JP1_CC_APP0.conf（アプリケーション実行定義ファイル）

!JP1_CC_APP0.conf.model（アプリケーション実行定義ファイルのモデルファイル）

格納先ディレクトリ

Viewパス¥conf¥appexecute¥ja¥

説明

アプリケーション実行定義ファイルは，［イベントコンソール］画面から起動するアプリケーションなどの実行形式ファイルのIDとパスを定義するファイルです。

なお，JP1/IMには，アプリケーション実行定義ファイルの記述内容をチェックするためのコマンド「jcoappexecfcheck」が用意されています。このコマンドの詳細については，「jcoappexecfcheck（Windows限定）」（1.　コマンド）を参照してください。

定義の反映時期

JP1/IM - Viewを再起動したあとに有効になります。

記述内容

@file type="application-execution-definition";

この定義ファイルがアプリケーション実行定義ファイルであることを宣言します。このステートメントは必須です。

このステートメントは，ファイルの先頭行に記述しなければなりません。

#コメント行

#で始まる行は，コメント扱いとなります。

アプリケーション実行定義ブロック

［イベントコンソール］画面から起動するアプリケーションなどの実行形式ファイルのパスを定義し，ほかの定義ファイルからリンクするためのID付けをします。

このブロックには次のステートメントを記述できます。

idステートメント

pathステートメント

descriptionステートメント

これ以外のステートメントが記述された場合は，エラー出力し，該当するステートメントだけを無視されます。

次にステートメントについて説明します。

id="アプリケーション実行定義識別子";

このブロックで指定するコマンドパスにIDを付けます。このステートメントは必須です。このステートメントは，ブロック内で1回だけ記述できます。

同一のidを持つブロックが解析対象のファイル内に複数個存在した場合，次の順に優先順位が決定され，最優先のブロックが有効になります。

1. ファイル名を昇順でソートしてあとの方のブロック

2. ファイル内の位置があとの方のブロック

それ以外のブロックは無効になります。

アプリケーション実行定義識別子は，32バイト以内の半角英数字で構成される文字列です。この文字列は定義内でユニークでなければなりません。ユニーク性を保持するために，次の命名規則に従ってください。

会社名_製品名[_機能名(または画面名)]

「"jco_"」で始まる文字列，および「"default_browser"」は，アプリケーション実行定義識別子として予約されているため，使用できません。

path="コマンドパス";

idステートメントで指定したアプリケーション実行定義識別子と関連づける実行形式ファイルのパスを定義します。このステートメントは必須です。このステートメントは，同一ブロック中に複数個指定できます。起動する実行形式ファイルは，フルパスで指定します。後述の置き換えキーワードを使用して，レジストリーなどからパスを組み立てることもできます。

このステートメントを複数個指定した場合は，記述順にパスが検索され，最初に見つかったパスが使用されます。

pathステートメントで指定できる実行形式ファイルは，.exeまたは.batファイルです。

コマンド実行時のカレントディレクトリは不定です。カレントディレクトリから相対パスを意識するコマンドなどは指定できません。.batファイルなどでcdコマンドを実行したあと，実行するようにしてください。

検索処理はJP1/IM - Viewの起動時にだけ実行されます。そのため，起動対象となるアプリケーションをJP1/IM - Viewの実行中にインストールした場合は，JP1/IM - Viewを再起動する必要があります。

64ビット版のWindowsでは，%WINDIR%¥System32フォルダ以下に配置されているコマンドを実行すると，WOW64のリダイレクト機能によって，%WINDIR%¥SysWow64フォルダ以下に配置されているコマンドにリダイレクトされます。リダイレクト先のコマンドがない場合，コマンドの実行に失敗することがあります。%WINDIR%¥System32フォルダ以下に配置されているコマンドを実行コマンドに指定する場合は注意してください。

・置換文字列

pathステートメントには，実行時に置き換え可能な置換文字列を指定できます。

(1)キーワード置換文字列

指定された定義内にキーワード置換文字列が存在する場合は，記述されたキーワードに従って文字列の置換が実行されます。形式を次に示します。

%置き換えキーワード%

置き換えキーワードの一覧を次に示します。

表2‒60　置き換えキーワードの一覧

キーワード

置換する内容

JCO_JP1USER

JP1/IM - ManagerにログインしたJP1のユーザー

JCO_INSTALL_PATH

JP1/IM - Viewのインストールフォルダの名称

(2)レジストリー置換文字列

定義内にレジストリー置換文字列を指定すると，記述されたレジストリーから値を取得して文字列の置換が実行されます。レジストリー置換文字列の形式を次に示します。

[¥レジストリーキー¥レジストリーキー¥…¥レジストリー値]

レジストリー置換文字列の中には，さらに，レジストリー専用の置き換えキーワード「%UPPER%」を使用できます。「%UPPER%」を使用すると，レジストリーキーの中で同一階層のキーの中からキー名称で文字列比較が実行され，最も大きな文字列を選択して置換が実行されます。このキーワードの目的は，レジストリーキー内でバージョンごとにキーを分けているときに，常に最新のバージョンが得られるようにすることです。

「%UPPER%」は，レジストリー文字列内に１か所だけ指定できます。次に，「%UPPER%」を使用してJP1/SAMPLEのレジストリーを指定する例を示します。

[¥HKEY_LOCAL_MACHINE¥SOFTWARE¥HITACHI¥SAMPLE¥%UPPER%¥PATHNAME¥PATH00]

このように指定すると，「%UPPER%」の部分が最新バージョンに置き換えられ，常に最新の実行形式ファイルが得られます。

例えば，レジストリーキーに次の二つが存在した場合，"0700">"0671"となるため，"0700"のレジストリーから値を取得します。

[¥HKEY_LOCAL_MACHINE¥SOFTWARE¥HITACHI¥SAMPLE¥0671¥PATHNAME¥PATH00]

[¥HKEY_LOCAL_MACHINE¥SOFTWARE¥HITACHI¥SAMPLE¥0700¥PATHNAME¥PATH00]

description="アプリケーション実行の説明文";

ブロック内のアプリケーション実行定義に説明を付加します。このステートメントは，ブロック内で1回だけ記述できます。

文字数の制限はありませんが，50文字以内にすることをお勧めします。

アプリケーション実行定義ブロックの定義例を次に示します。

@define-block type="application-execution-def";

id="HITACHI_JP1_SAMPLE";

path="C:¥Program Files¥Hitachi¥JP1¥bin¥sample.exe";

description="日立のサンプルプログラム";

@define-block-end;

定義例

アプリケーション実行定義ファイルの定義例を次に示します。

@file type="application-execution-definition", version="0300";
#-----------------------------------------
@define-block type="application-execution-def";
id="jco_notepad";
path="C:¥winnt40¥system32¥notepad.exe";
@define-block-end;
#-----------------------------------------
@define-block type="application-execution-def";
id="jco_dmp";
path="[¥HKEY_LOCAL_MACHINE¥SOFTWARE¥HITACHI¥NETM/DM/P¥0521/
    A¥PathName¥Path00]¥bin¥DMPSTS.exe";
@define-block-end;

状態変更条件メモリー常駐機能の設定ファイル

形式

[論理ホスト名¥JP1SCOPE¥BMS]
"EVENT_MATCH_MODE"=dword:値

ファイル

任意のファイルを使用します。

格納先ディレクトリ

Windowsの場合

任意のフォルダ

UNIXの場合

任意のディレクトリ

説明

状態変更条件メモリー常駐機能を有効にするための定義ファイルです。

JP1/IM - Managerを新規インストールした場合は，有効になっています。バージョンアップ時は，バージョンアップ前に設定を無効にしていた場合は，無効になっています。

定義の反映時期

jbssetcnfコマンドを実行し，JP1/IM - Managerを再起動したあとに有効になります。

記述内容

[論理ホスト名¥JP1SCOPE¥BMS]

JP1/IMの環境設定のキー名称です。

論理ホスト名の部分を，物理ホストの場合はJP1_DEFAULTに，論理ホストの場合は論理ホスト名に設定します。

"EVENT_MATCH_MODE"=dword:値

状態変更条件メモリー常駐機能を有効にする場合は「1」を，無効にする場合は「0」を指定します。

重大度変更定義ファイル（jcochsev.conf）

形式

DESC_VERSION=バージョン情報

def 定義名1
    [cmt コメント]
    [define {enable | disable}]
    [addflag {true | false}]
    cnd
        イベント条件
    end-cnd
    sev 重大度
end-def

def 定義名2
    [cmt コメント]
    [define {enable | disable}]
    [addflag {true | false}]
    cnd
        イベント条件
    end-cnd
    sev 重大度
end-def

ファイル

jcochsev.conf（重大度変更定義ファイル）

jcochsev.conf.model（重大度変更定義ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Consoleパス¥conf¥chsev¥

論理ホストのとき

共有フォルダ¥jp1cons¥conf¥chsev¥

UNIXの場合

物理ホストのとき

/etc/opt/jp1cons/conf/chsev/

論理ホストのとき

共有ディレクトリ/jp1cons/conf/chsev/

説明

イベントの重大度変更機能で，重大度を変更するJP1イベントの条件と変更後の重大度を定義するファイルです。イベントの重大度変更機能は，このファイルの定義に従い，イベント条件に一致するJP1イベントの重大度を変更します。このファイルは，JP1/IM - Managerの動作する言語コードで記述してください。

このファイルの最大サイズは，17メガバイト（17,825,792バイト）です。定義件数に上限はありません。

重大度変更定義ファイルのパラメーターには，次の2種類があります。

重大度変更定義ファイルバージョン

重大度変更定義ファイルのフォーマットのバージョンを定義します。

重大度変更定義パラメーター

重大度を変更するJP1イベントの条件と変更後の重大度を定義します。重大度変更定義ファイルで上に記述されている重大度変更定義ほど，優先順位が高くなります。

定義の反映時期

イベントの重大度変更機能が有効で，次のどれかが成立する場合に有効になります。

JP1/IM - Managerを起動した場合

jco_spmd_reloadコマンドを実行した場合

［追加重大度変更定義設定］画面で［OK］ボタンをクリックした場合

［重大度変更定義一覧］画面で［適用］ボタンをクリックした場合

記述内容（重大度変更定義ファイルバージョン）

DESC_VERSION

DESC_VERSIONには，重大度変更定義ファイルの形式を決定するファイルバージョンをバージョン情報として定義します。指定する値は2です。DESC_VERSIONの指定を省略した場合，ファイルバージョンを2と見なして処理します。

DESC_VERSIONは，定義ファイルの先頭行（空行，コメント行を除いた行のうちファイルのはじめに記述された行）に記載します。先頭行にファイルバージョンがなかった場合は，ファイルバージョンを2と見なして処理します。

表2‒61　重大度変更定義ファイルのフォーマットのバージョン情報

バージョン情報

説明

1

10-10以前の重大度変更定義ファイルのバージョンを示す。

2

10-50の重大度変更定義ファイルのバージョンを示す。

表2‒62　バージョン情報と重大度変更定義ファイルで指定できるパラメーター一覧

バージョン情報

パラメーター名

1

def〜end-def（定義ブロック）

cnd〜end-cnd（イベント条件ブロック）

sev

2

def〜end-def（定義ブロック）

cmt コメント

define {enable | disable}

addflag {true | false}

cnd〜end-cnd（イベント条件ブロック）

sev

記述内容（重大度変更定義パラメーター）

重大度変更定義パラメーターは，図に示すとおり，定義ブロックとイベント条件ブロックで構成されています。

図2‒9　重大度変更定義パラメーター

def〜end-def（定義ブロック）

重大度変更定義の開始と終了のパラメーターです。def〜end-defブロックは省略でき，この場合「すべてのJP1イベントの重大度を変更しない」と解釈します。def以降には，重大度変更定義の定義名を記述します。「def△△△定義1△△△定義2△△△」と指定した場合，「△△定義1△△△定義2△△△」が定義名となります（△は半角スペースを表す）。

定義名は，重大度定義ファイル内でユニークになるように1〜50バイトの文字列で指定します。指定できる文字は，制御文字（0x00〜0x1F，0x7F〜0x9F）以外の文字列です。

cmt コメント

重大度変更定義のコメントを記述します。cmtに指定されたコメントは，［重大度変更定義設定］画面のコメント欄に表示されます。cmtパラメーターは，定義ブロック内に一つだけ指定できます。このパラメーターは省略できます。コメントは1,024バイト以内で指定してください。指定できる文字は，制御文字（0x00〜0x1F，0x7F〜0x9F）以外の文字列です。

バージョン情報が1の場合，このパラメーターを指定するとエラーになります。

define {enable | disable}

重大度変更定義を有効にするかどうかを指定します。defineパラメーターは，定義ブロック内に一つだけ指定できます。重大度変更定義を有効にする場合は「enable」を，無効にする場合は「disable」を指定します。defineパラメーターは，省略できます。デフォルトは，「enable」です。英大文字・英小文字は区別しません。

バージョン情報が1の場合，このパラメーターを指定するとエラーになります。

addflag {true | false}

追加重大度変更定義を画面から追加したことを示すパラメーターで，重大度変更定義が追加重大度変更定義かどうかを指定します。そのため，重大度変更定義ファイルを編集する場合は，addflagパラメーターを指定する必要はありません。addflagパラメーターは定義ブロック内に一つだけ指定できます。追加重大度変更定義の場合は「true」を，重大度変更定義の場合は「false」を指定します。「true」を指定した場合は，［重大度変更定義一覧］画面の［種別］にアイコン（[図データ]）が表示されます。addflagパラメーターは，省略できます。デフォルトは，「false」です。英大文字・英小文字は区別しません。

バージョン情報が1の場合，このパラメーターを指定するとエラーになります。

cnd〜end-cnd（イベント条件ブロック）

重大度を変更するJP1イベントのイベント条件を指定する，ブロックの開始と終了のパラメーターです。イベント条件ブロックは，定義ブロック内に必ず一つ指定する必要があります。省略はできません。受信したJP1イベントが，複数のイベント条件に一致する場合，重大度変更定義ファイルの先頭に近い定義ブロックが優先されます。cndおよびend-cndパラメーターの前後のタブやスペースは，無視されます。

イベント条件

重大度を変更するJP1イベントの条件を指定します。イベント条件ブロックには，0〜256件のイベント条件を指定できます。イベント条件とイベント条件は，AND条件となります。イベント条件は，次の形式で指定します（△は半角スペースを表す）。

　属性名△比較キーワード△オペランド[△オペランド]…

なお，半角スペースまたはタブだけで構成された行は，無視して処理を続行します。

・属性名

属性名には，比較したい属性の名称を記述します。基本属性を指定する場合は，名称の前に「B.」を付けます。拡張属性（共通情報），拡張属性（固有情報）を指定する場合は，名称の前に「E.」を付けます。英大文字・英小文字を区別します。

指定できる属性名と比較キーワードの組み合わせおよびオペランドを次に示します。

表2‒63　指定できる属性名と比較キーワードの組み合わせおよびオペランド

項番

項目

属性名

比較

キーワード

オペランド

1

イベントID

B.ID

と一致する

と一致しない

複数指定できる。複数指定では最大100件指定できる。

16進数形式で指定する。大文字・小文字は区別しない。

指定できる範囲は0〜7FFFFFFFである。

2

登録要因

B.REASON

と一致する

と一致しない

複数指定できる。複数指定では最大100件指定できる。

3

発行元プロセスID

B.PROCESSID

と一致する

と一致しない

複数指定できる。複数指定では最大100件指定できる。

指定できる範囲は，-2,147,483,648〜2,147,483,647である。

4

発行元ユーザーID

B.USERID

と一致する

と一致しない

複数指定できる。複数指定では最大100件指定できる。

指定できる範囲は，-2,147,483,648〜2,147,483,647である。

5

発行元グループID

B.GROUPID

と一致する

と一致しない

複数指定できる。複数指定では最大100件指定できる。

指定できる範囲は，-2,147,483,648〜2,147,483,647である。

6

発行元ユーザー名

B.USERNAME

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

7

発行元グループ名

B.GROUPNAME

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

8

発行元イベントサーバ名(登録ホスト名)※1

B.SOURCESERVER

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

9

送信先イベントサーバ名※1

B.DESTSERVER

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

10

メッセージ

B.MESSAGE

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

11

重大度

E.SEVERITY

と一致する

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。"Emergency"，"Alert"，"Critical"，"Error"，"Warning"，"Notice"，"Information"，"Debug"のどれかを指定できる。

12

ユーザー名

E.USER_NAME

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

13

プロダクト名

E.PRODUCT_NAME

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

14

オブジェクトタイプ

E.OBJECT_TYPE

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

15

オブジェクト名

E.OBJECT_NAME

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

16

登録名タイプ

E.ROOT_OBJECT_TYPE

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

17

登録名

E.ROOT_OBJECT_NAME

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

18

オブジェクトID

E.OBJECT_ID

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

19

事象種別

E.OCCURRENCE

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

20

終了コード

E.RESULT_CODE

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

21

発生元ホスト名※1

E.JP1_SOURCEHOST

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

22

固有の拡張属性※3

E.xxxxxxx

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

属性名には，先頭が英大文字で英大文字，数字，およびアンダースコア（_）から構成される32バイトまでの名称を設定できる。

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

注※1

統合監視DBおよびIM構成管理DBが有効な場合に，比較キーワードが，「と一致する」「と一致しない」のとき，パス表記で業務グループ名を指定できます。

統合監視DBおよびIM構成管理DBが無効な場合，および［と一致する］［と一致しない］以外を選択した場合，パス表記で業務グループ名を指定しても，ホスト名として扱われます。

jcoimdefコマンドの-ignorecasehostオプションの指定を「ON」にしている場合に，比較キーワードで［正規表現］以外を選択すると，文字列の英大文字・英小文字を区別しません。

注※2

各JP1製品固有の拡張属性も使用できます。例えば，JP1/AJSのジョブの実行ホストは，E.C0です。製品固有の拡張属性についての詳細は，JP1イベントを発行する各製品のマニュアルを参照してください。

・比較キーワード

比較キーワードには，「BEGIN（から始まる）」，「IN（と一致する）」，「NOTIN（と一致しない）」，「SUBSTR（を含む）」，「NOTSUBSTR（を含まない）」，「REGEX（正規表現）」のどれか一つを指定できます。英大文字・英小文字を区別します。

・オペランド

比較キーワードで属性値と比較する値を文字列で指定します。英大文字・英小文字を区別します。

オペランドを複数指定する場合は，一つ以上の連続した半角スペースまたはタブをオペランドとオペランドの間に挿入して区切ります。オペランドとオペランドは，OR条件となります。ただし，正規表現を指定している場合は，複数指定できません。

オペランドに，半角スペース，タブ，改行コード（CR，LF）および%を指定したい場合，次のように記述します。

項番

指定したい値

指定方法

1

タブ（0x09）

%09

2

半角スペース（0x20）

%20

3

%（0x25）

%25

4

改行コード LF（0x0a）

%0a

5

改行コード CR（0x0d）

%0d

定義フォーマットの上限チェックの場合，%20，%25は1文字として扱います。%のあとに指定する文字コードは，英大文字・英小文字を区別しません。複数選択した場合の定義例「IDが100と200に一致する」を示します。

B.ID△IN△100△200

（凡例）　△：半角スペース（0x20）

オペランドは，イベント条件1件当たり4,096バイトまで，イベント条件ブロック1件当たり4,096バイト（イベント条件ブロックに記述したオペランドの合計バイト数）まで指定できます。

sev

変更後の重大度を記述するパラメーターです。

sevパラメーターは，定義ブロック内に必ず一つ指定する必要があります。省略はできません。

sevパラメーターに指定できる値は，"Emergency"（緊急），"Alert"（警戒），"Critical"（致命的），"Error"（エラー），"Warning"（警告），"Notice"（通知），"Information"（情報），"Debug"（デバッグ）のどれかです。

#コメント行

#で始まる行は，コメント扱いとなります。なお，JP1/IM - Viewから重大度変更定義を設定した場合，#のコメント行は削除されます。

定義例

イベントIDが100または200に一致，かつ重大度がWarningで，かつ登録ホストがhostA，hostB，hostCに一致する場合に，重大度をEmergencyに変更する例を次に示します。

DESC_VERSION=2
def 重大度変更1
    cmt コメント1
    define enable
    cnd
        B.ID IN 100 200
        E.SEVERITY IN Warning
        B.SOURCESERVER IN hostA hostB hostC
    end-cnd
    sev Emergency
end-def

重大度変更定義表示項目定義ファイル（chsev_attr_list.conf）

形式

# コメント行
属性名
属性名
　・
　・
属性名

ファイル

chsev_attr_list.conf（重大度変更定義表示項目定義ファイル）

chsev_attr_list.conf.model（重大度変更定義表示項目定義ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Consoleパス¥conf¥chsev¥attr_list

論理ホストのとき

共有フォルダ¥jp1cons¥conf¥chsev¥attr_list

UNIXの場合

物理ホストのとき

/etc/opt/jp1cons/conf/chsev/attr_list

論理ホストのとき

共有ディレクトリ/jp1cons/conf/chsev/attr_list

説明

［重大度変更定義設定］画面の［属性名］表示領域に表示する項目を指定する定義ファイルです。重大度変更定義表示項目定義ファイルに指定された表示項目を指定された順番で［重大度変更定義設定］画面の［属性名］表示領域に表示します。

定義の反映時期

定義ファイルの内容は，セントラルコンソールの起動時，およびjco_spmd_reloadコマンドを実行して定義を再読み込みしたときに有効になります。

記述内容

#コメント行

#で始まる行は，コメント扱いとなります。

属性名

重大度変更定義表示項目定義ファイルには，［重大度変更定義設定］画面の［属性名］表示領域に表示する表示項目を指定します。表示項目は，表示項目に対応する属性名で1行に1件記述します。0〜256件の表示項目を指定できます。

英大文字・英小文字を区別します。属性名の両端に指定された空白（半角スペース）とタブ文字は無視されます。

SEPARATORを指定すると，［重大度変更定義設定］画面の［属性名］表示領域に「--------------------」を表示します。SEPARATORは，よく使う項目と，あまり使わない項目を分けるときに設定します。

ただし，SEPARATORだけを指定した場合は，［属性名］表示領域には，「--------------------」だけが表示されます。この場合，「--------------------」を選択しても，属性名は設定できません。

指定できる属性名を次の表に示します。

表2‒64　表示項目一覧

項番

表示項目

属性名

1

発生元ホスト名※

E.JP1_SOURCEHOST

2

登録ホスト名

B.SOURCESERVER

3

重大度

E.SEVERITY

4

オブジェクトタイプ

E.OBJECT_TYPE

5

オブジェクト名

E.OBJECT_NAME

6

登録名タイプ

E.ROOT_OBJECT_TYPE

7

登録名

E.ROOT_OBJECT_NAME

8

事象種別

E.OCCURRENCE

9

ユーザー名

E.USER_NAME

10

メッセージ

B.MESSAGE

11

プロダクト名

E.PRODUCT_NAME

12

イベントID

B.ID

13

送信先イベントサーバ名

B.DESTSERVER

14

固有の拡張属性

OTHER_EXTENDED_ATTRIBUTE

15

登録要因

B.REASON

16

発行元プロセスID

B.PROCESSID

17

発行元ユーザー名

B.USERNAME

18

発行元ユーザーID

B.USERID

19

発行元グループ名

B.GROUPNAME

20

発行元グループID

B.GROUPID

21

オブジェクトID

E.OBJECT_ID

22

終了コード

E.RESULT_CODE

23

--------------------

SEPARATOR

注

同じ属性名が複数指定されていた場合，その値は無視されます。

また，重大度変更定義表示項目定義ファイルが読み込めなかった場合，有効な表示項目が0件のときは，項番1〜22が表示されます。

注※

発生元ホストのマッピング機能が有効でない場合，［重大度変更定義設定］画面には表示されません。

重大度変更定義自動入力定義ファイル（chsev_auto_list.conf）

形式

# コメント行
[DEFAULT_NAME 重大度変更定義名]
属性名
属性名
　・
　・
属性名
属性名

ファイル

chsev_auto_list.conf

chsev_auto_list.conf.model（重大度変更定義自動入力定義ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Consoleパス¥conf¥chsev¥auto_list

論理ホストのとき

共有フォルダ¥jp1cons¥conf¥chsev¥auto_list

UNIXの場合

物理ホストのとき

/etc/opt/jp1cons/conf/chsev/auto_list

論理ホストのとき

共有ディレクトリ/jp1cons/conf/chsev/auto_list

説明

［イベントコンソール］画面のイベント一覧でJP1イベントを選択後，［表示］−［重大度変更定義を設定］メニューを選択して［追加重大度変更定義設定］画面を開いたときに，自動で設定されるJP1イベント属性を定義するファイルです。また，重大度変更定義名のデフォルト名も定義できます。

定義の反映時期

定義ファイルの内容は，セントラルコンソールの起動時，およびjco_spmd_reloadコマンドを実行して定義を再読み込みしたときに有効になります。

記述内容

#コメント行

#で始まる行は，コメント扱いとなります。

DEFAULT_NAME 重大度変更定義名

重大度変更定義名を定義する識別子を表しています。識別子は，コメントと空行を除いたファイルの先頭に記述してください。

このパラメーターに指定した重大度変更定義名が，［イベントコンソール］画面のイベント一覧でJP1イベントを選択後，［表示］−［重大度変更定義を設定］を選択して［追加重大度変更定義設定］画面を開いたときに，初期値として表示されます。

40バイトまでの文字列で指定します。指定できる文字は，制御文字（0x00〜0x1F，0x7F〜0x9F）以外の文字列です。40バイトを超えて指定した場合，41バイト以上の文字列を切り捨てた文字列が重大度変更定義名となります。指定しなかった場合，「追加重大度変更定義」が重大度変更定義名となります。

属性名

重大度変更定義自動入力定義ファイルには，［イベントコンソール］画面のイベント一覧でJP1イベントを選択後，［表示］−［重大度変更定義を設定］を選択して［追加重大度変更定義設定］画面を開いたときに，イベント条件として設定されるJP1イベントの属性を指定します。このパラメーターに指定した属性名の条件が，［イベントコンソール］画面のイベント一覧でJP1イベントを選択後，［表示］−［重大度変更定義を設定］を選択して［追加重大度変更定義設定］画面を開いたときに，初期値として表示されます。

定義項目は，設定されるJP1イベントの属性名を1行に1件記述します。

英大文字・英小文字を区別します。属性名の両端に指定された空白（半角スペース）とタブ文字は無視されます。

同じ属性名が複数指定されていた場合，その値は無視し，KAVB1935-Wメッセージを統合トレースログに出力します。

［重大度変更定義設定］画面の［イベント条件］に自動的に表示されるJP1イベントの属性の順序は，重大度変更定義表示項目定義ファイル（chsev_attr_list.conf）の属性の記載順に設定されます。

指定できる属性名を次の表に示します。

表2‒65　表示項目一覧

項番

表示項目

属性名

1

発生元ホスト名※

E.JP1_SOURCEHOST

2

登録ホスト名

B.SOURCESERVER

3

重大度

E.SEVERITY

4

オブジェクトタイプ

E.OBJECT_TYPE

5

オブジェクト名

E.OBJECT_NAME

6

登録名タイプ

E.ROOT_OBJECT_TYPE

7

登録名

E.ROOT_OBJECT_NAME

8

事象種別

E.OCCURRENCE

9

ユーザー名

E.USER_NAME

10

メッセージ

B.MESSAGE

11

プロダクト名

E.PRODUCT_NAME

12

イベントID

B.ID

13

送信先イベントサーバ名

B.DESTSERVER

14

登録要因

B.REASON

15

発行元プロセスID

B.PROCESSID

16

発行元ユーザー名

B.USERNAME

17

発行元ユーザーID

B.USERID

18

発行元グループ名

B.GROUPNAME

19

発行元グループID

B.GROUPID

20

オブジェクトID

E.OBJECT_ID

21

終了コード

E.RESULT_CODE

注

同じ属性名が複数指定されていた場合，その値は無視されます。

また，重大度変更定義自動入力定義ファイルが読み込めなかった場合，有効な表示項目が0件のときは，項番1〜3，項番10〜12が表示されます。

注※

発生元ホストのマッピング機能が有効でない場合，［追加重大度変更定義設定］画面には表示されません。

通信環境定義ファイル（view.conf.update）

形式

[JP1_DEFAULT¥JP1CONSOLEVIEW]
"COM_SO_TIMEOUT"=dword:16進数値
"COM_RMI_TIMEOUT"=dword:16進数値

ファイル

view.conf.update（通信環境定義ファイルのモデルファイル）

格納先ディレクトリ

Viewパス¥default¥

説明

JP1/IM - ViewとJP1/IM - Manager（セントラルコンソール）間の通信でのタイムアウト時間を定義するファイルです。

ネットワークに低速の回線が使われていたり，ビューアーの負荷が高かったりするときに，ビューアーの通信処理でタイムアウトによる通信エラーが発生することがあります。このような場合に，通信のタイムアウト時間を変更することで通信エラーの発生を防げます。タイムアウト時間を設定する場合は，接続するJP1/IM - Manager（セントラルコンソール）でも同様の設定が必要です。

なお，この定義ファイルの値を変更する場合は，JP1/IM - Manager（セントラルコンソール）用の通信環境定義ファイルの値も変更する必要があります。

必要な定義内容をモデルファイルとして提供しています。設定を変更する場合は，モデルファイルをコピーして，内容を編集してください。

定義の反映時期

jbssetcnfコマンドを実行し，JP1/IM - Viewを再起動したあとに有効になります。

記述内容

[JP1_DEFAULT¥JP1CONSOLEVIEW]

JP1/IM - View環境設定のキー名称です。

JP1/IM - Viewの場合，このパラメーターは固定です。

"COM_SO_TIMEOUT"=dword:16進数値

受信データの到着待ち時間（ソケットタイムアウト値）を16進数で指定します。単位はミリ秒です。デフォルト値はdword:0000EA60（60,000ミリ秒）です。

低速回線や，イベントトラフィックが高い環境の場合は長めに設定します。

指定できる値の範囲は0x00000001〜0x0036EE80（3,600,000ミリ秒）です。

また，通信環境定義ファイル（view.conf.update）の"COM_RMI_TIMEOUT"値（デフォルト：0000EA60）を超えないように指定してください。

"COM_RMI_TIMEOUT"=dword:16進数値

次に示す操作または設定時に発生する通信処理のタイムアウト時間（サーバ処理タイムアウト値）を16進数で指定します。単位はミリ秒です。

ログイン

ログアウト

［イベントコンソール］画面の手動および自動更新

イベントの対処状況の変更

重要イベントの削除

イベント検索

ユーザー環境設定

重要イベント設定

自動アクション設定

フィルター設定

コマンド実行操作

機能状態通知復帰の操作

応答待ちイベントに対する応答・滞留解除

指定できる値は0000EA60〜0036EE80（60,000〜3,600,000ミリ秒），デフォルト値はdword:0000EA60（60,000ミリ秒）です。

定義例

[JP1_DEFAULT¥JP1CONSOLEVIEW]
"COM_SO_TIMEOUT"=dword:000009C4
"COM_RMI_TIMEOUT"=dword:0000EA60

通信環境定義ファイル（tree_view.conf.update）

形式

[JP1_DEFAULT¥JP1CONSOLEVIEW]
"SOV_LOGIN_TIMEOUT"=dword:16進数値
"SOV_GETTREE_TIMEOUT"=dword:16進数値
"SOV_SETTREE_TIMEOUT"=dword:16進数値
"SOV_MAKETREE_TIMEOUT"=dword:16進数値
"SOV_GETMAP_TIMEOUT"=dword:16進数値
"SOV_SETMAP_TIMEOUT"=dword:16進数値
"SOV_GETPROFILE_TIMEOUT"=dword:16進数値
"SOV_SETPROFILE_TIMEOUT"=dword:16進数値
"SOV_DEF_TIMEOUT"=dword:16進数値

ファイル

tree_view.conf.update（通信環境定義ファイルのモデルファイル）

格納先ディレクトリ

Viewパス¥default¥

説明

JP1/IM - ViewとJP1/IM - Manager（セントラルスコープ）間の通信でのタイムアウト時間を定義するファイルです。

ネットワークに低速の回線が使われていたり，ビューアーの負荷が高かったりするときに，ビューアーの通信処理でタイムアウトによる通信エラーが発生することがあります。このような場合に，通信のタイムアウト時間を変更することで通信エラーの発生を防げます。

必要な定義内容をモデルファイルとして提供しています。設定を変更する場合は，モデルファイルをコピーして，内容を編集してください。

定義の反映時期

jbssetcnfコマンドを実行し，JP1/IM - Viewを再起動したあとに有効になります。

記述内容

[JP1_DEFAULT¥JP1CONSOLEVIEW]

JP1/IM - View環境設定のキー名称です。

JP1/IM - Viewの場合，このパラメーターは固定です。

"SOV_LOGIN_TIMEOUT"=dword:16進数値

ログイン・ログアウト処理のサーバ応答待ち時間を16進数で指定します。単位はミリ秒です。指定できる値は0000EA60〜0036EE80（60,000〜3,600,000ミリ秒），デフォルト値はdword:0002BF20（180,000ミリ秒）です。

"SOV_GETTREE_TIMEOUT"=dword:16進数値

監視オブジェクトの状態取得，監視ツリーの更新，［監視ツリー(編集中)］画面の表示処理のサーバ応答待ち時間を16進数で指定します。単位はミリ秒です。指定できる値は0000EA60〜0036EE80（60,000〜3,600,000ミリ秒），デフォルト値はdword:0036EE80（3,600,000ミリ秒）です。

"SOV_SETTREE_TIMEOUT"=dword:16進数値

監視オブジェクトの状態変更，監視対象設定，ツリー更新処理のサーバ応答待ち時間を16進数で指定します。単位はミリ秒です。指定できる値は0000EA60〜0036EE80（60,000〜3,600,000ミリ秒），デフォルト値はdword:0036EE80（3,600,000ミリ秒）です。

"SOV_MAKETREE_TIMEOUT"=dword:16進数値

監視ツリーの自動生成処理のサーバ応答待ち時間を16進数で指定します。単位はミリ秒です。指定できる値は0000EA60〜0036EE80（60,000〜3,600,000ミリ秒），デフォルト値はdword:0036EE80（3,600,000ミリ秒）です。

"SOV_GETMAP_TIMEOUT"=dword:16進数値

ビジュアル監視一覧の表示，ビジュアル監視画面の表示処理のサーバ応答待ち時間を16進数で指定します。単位はミリ秒です。指定できる値は0000EA60〜0036EE80（60,000〜3,600,000ミリ秒），デフォルト値はdword:0002BF20（180,000ミリ秒）です。

"SOV_SETMAP_TIMEOUT"=dword:16進数値

ビジュアル監視の作成，削除，コピー，ビジュアル監視更新処理のサーバ応答待ち時間を16進数で指定します。単位はミリ秒です。指定できる値は0000EA60〜0036EE80（60,000〜3,600,000ミリ秒），デフォルト値はdword:0002BF20（180,000ミリ秒）です。

"SOV_GETPROFILE_TIMEOUT"=dword:16進数値

監視ツリー画面用システム環境設定，ユーザー環境設定の取得処理のサーバ応答待ち時間を16進数で指定します。単位はミリ秒です。指定できる値は0000EA60〜0036EE80（60,000〜3,600,000ミリ秒），デフォルト値はdword:0002BF20（180,000ミリ秒）です。

"SOV_SETPROFILE_TIMEOUT"=dword:16進数値

監視ツリー画面用システム環境設定，ユーザー環境設定の反映処理のサーバ応答待ち時間を16進数で指定します。単位はミリ秒です。指定できる値は0000EA60〜0036EE80（60,000〜3,600,000ミリ秒），デフォルト値はdword:0002BF20（180,000ミリ秒）です。

"SOV_DEF_TIMEOUT"=dword:16進数値

監視オブジェクトのプロパティ取得，監視オブジェクトのプロパティ設定，ログインユーザー一覧取得，自動生成構成選択の取得処理のサーバ応答待ち時間を16進数で指定します。単位はミリ秒です。指定できる値は0000EA60〜0036EE80（60,000〜3,600,000ミリ秒），デフォルト値はdword:001B7740（1,800,000ミリ秒）です。

定義例

[JP1_DEFAULT¥JP1CONSOLEVIEW]
"SOV_LOGIN_TIMEOUT"=dword:0002BF20
"SOV_GETTREE_TIMEOUT"=dword:0002BF20
"SOV_SETTREE_TIMEOUT"=dword:0002BF20
"SOV_MAKETREE_TIMEOUT"=dword:0036EE80
"SOV_GETMAP_TIMEOUT"=dword:0002BF20
"SOV_SETMAP_TIMEOUT"=dword:0002BF20
"SOV_GETPROFILE_TIMEOUT"=dword:0002BF20
"SOV_SETPROFILE_TIMEOUT"=dword:0002BF20
"SOV_DEF_TIMEOUT"=dword:0002BF20

非暗号化通信ホスト設定ファイル（nosslhost.conf）

形式

[NO_SSL_HOST]
マネージャーホスト名
マネージャーホスト名
    ：
マネージャーホスト名

ファイル

nosslhost.conf（非暗号化通信ホスト設定ファイル）

nosslhost.conf.model（非暗号化通信ホスト設定ファイルのモデルファイル）

格納先ディレクトリ

Viewパス¥conf¥ssl

説明

非暗号化通信をするホストを設定するファイルです。初期値はすべてのホストで非暗号化通信となるため，暗号化通信をする場合は，このファイルを設定する必要があります。JP1/IM - Viewが，ログインするマネージャーホストとの通信を，非暗号化通信する場合に定義します。このファイルに定義のないマネージャーホストとは暗号化通信をします。

JP1/IM - Viewはログイン画面の接続先ホスト名，またはjcoviewコマンドの-hオプションおよびjcfviewコマンドの-hオプションで指定した接続ホスト名と，定義ファイルに記載してあるマネージャーホスト名を突き合わせて一致した場合は，非暗号化通信を行います。大文字，小文字の区別はしません。

定義の反映時期

次の場合に，非暗号化通信ホスト設定ファイルの設定が有効になります。

セントラルコンソール・ビューアーからセントラルコンソール，セントラルスコープ・ビューアーからセントラルスコープ，およびIM構成管理・ビューアーからIM構成管理にログインする場合（ログイン画面を表示し，ログインする場合は，ログイン画面の［OK］ボタンをクリックした場合）。

IM構成管理・ビューアーからセントラルコンソール・ビューアー，またはセントラルスコープ・ビューアーを表示した場合。

IM構成管理・ビューアーから拠点マネージャーのIM構成管理・ビューアーを表示（拠点ビュー起動）した場合。

次に，それぞれのビューアーの起動と定義ファイルの読み込みについて示します。

表2‒66　それぞれのビューアー起動時の非暗号化通信ホスト設定ファイルの読み込み

呼び出し元画面（呼び出し元画面での操作）

チェックボックス

起動するビューアー

定義ファイルを読み込むかどうか

セントラルコンソール

セントラルスコープ

セントラルコンソール・ビューアー，セントラルスコープ・ビューアーのログイン画面（［OK］ボタンをクリックしたとき）

あり

なし

セントラルコンソール

○

なし

あり

セントラルスコープ

○

あり

あり

セントラルコンソール，セントラルスコープ

○※

IM構成管理・ビューアーログイン画面（［OK］ボタンをクリックしたとき）

IM構成管理

○

セントラルスコープ・ビューアーログイン画面（［OK］ボタンをクリックしたとき）

［監視ツリー(編集中)］画面からの起動

セントラルスコープ

○

セントラルコンソール・ビューアー（メインメニュー，ツールバー）

セントラルスコープ

×

セントラルスコープ・ビューアー（メインメニュー，ツールバー）

セントラルコンソール

×

IM構成管理・ビューアー（メインメニュー，ツールバー）

セントラルコンソール

○

セントラルスコープ

○

IM構成管理・ビューアー（拠点ビュー起動）

拠点マネージャーのIM構成管理

○

（凡例）

○：読み込む

×：読み込まない

あり：チェックあり

なし：チェックなし

注※

起動するのはセントラルコンソール・ビューアー，およびセントラルスコープ・ビューアーの二つですが，読み込み処理は1回です。

記述内容

[NO_SSL_HOST]

このブロックは必須項目です。英大文字・英小文字を区別します。[NO_SSL_HOST]の前後の半角スペース，およびタブは無視されます。

マネージャーホスト名

非暗号化通信（暗号化通信しない）をする接続先のマネージャーホストのホスト名，またはIPv4アドレスを指定します。マネージャーホスト名のホスト名はFQDN形式も記載できます。初期設定では，「*」が設定されています。「*」は接続するすべてのマネージャーホストと非暗号化通信をします。最大定義数は1,024件です。同じマネージャーホスト名を複数記載することはできません。大文字・小文字を区別しません。指定できる値は，0〜255文字です。マネージャーホスト名の前後の半角スペース，およびタブは無視されます。

定義例

定義例1：すべてのマネージャーホストとの通信を非暗号化通信にする場合

[NO_SSL_HOST]
*

「*」が定義されることで，すべてのマネージャーホストとの通信が非暗号化通信となります。「*」を記載する場合，上記以外の記載は，エラーとなります。

定義例2：すべてのマネージャーホストとの通信を暗号化通信にする場合

[NO_SSL_HOST]

すべてのマネージャーホストとの通信を暗号化通信にする場合は「*」を削除します。

定義例3：マネージャーホストとの通信が非暗号化通信と暗号化通信で混在する場合

[NO_SSL_HOST]
hostA
hostB

マネージャーホスト（hostA，hostB）との通信は非暗号化通信となり，hostA，hostB以外のマネージャーホストとの通信は暗号化通信となります。

IM-View設定ファイル（tuning.conf）

形式

LOGIN_HISTORY_MAX=接続先ホスト入力履歴数
MENU_AUTO_START={ON | OFF}
ACTIONLIST_AUTO_START={ON | OFF}
WWW_BROWSER_PATH=起動ブラウザーのパス
CLIPBOARD_OUTPUT={ON | OFF}
LOGIN_USER_HISTORY_MAX={0|1}
SCREEN_TITLE_LOGININFO={ON|OFF}

ファイル

tuning.conf（IM-View設定ファイル）

tuning.conf.model（IM-View設定ファイルのモデルファイル）

格納先ディレクトリ

Viewパス¥conf¥

説明

JP1/IM - Viewの動作を定義するファイルです。ログイン画面での接続先ホスト入力履歴数，イベントコンソール画面表示時の動作，およびクリップボードへのコピー可否を設定します。

tuning.confファイルの各項目は，「パラメーター名=値」という形式で記述します。定義ファイル中の，次の行は無視されます。

空白文字だけの行

空白文字を除いた先頭の文字が「#」の行（コメント行）

定義の反映時期

JP1/IM - Viewを再起動したあとに有効になります。

記述内容

LOGIN_HISTORY_MAX=接続先ホスト入力履歴数

ログイン画面の［接続ホスト名］リストボックスに表示する入力履歴の数を指定します。

指定できる値は，0〜20です。0を指定した場合は，入力履歴を表示しません。このパラメーターを指定しなかった場合は，「5」を仮定します。デフォルトは，「5」です。

MENU_AUTO_START={ON | OFF}

イベントコンソール画面を表示したときに統合機能メニューを起動するかどうかを指定します。「ON」を指定すると，イベントコンソール画面表示時に統合機能メニュー画面を起動します。「OFF」を指定すると，イベントコンソール画面表示時に統合機能メニュー画面を起動しません。このパラメーターを指定しなかった場合は，「OFF」を仮定します。デフォルトは，「OFF」です。

ACTIONLIST_AUTO_START={ON | OFF}

イベントコンソール画面を表示したときに［アクション結果一覧］画面を表示するかどうかを指定します。「ON」を指定すると，イベントコンソール画面表示時に［アクション結果一覧］画面を起動します。「OFF」を指定すると，イベントコンソール画面表示時に［アクション結果一覧］画面を起動しません。このパラメーターを指定しなかった場合は，「OFF」を仮定します。デフォルトは，「OFF」です。

WWW_BROWSER_PATH=起動ブラウザーのパス

統合機能メニューおよびモニター画面呼び出しで使用するWWWブラウザーの起動パスを指定します。なお，このパラメーターはデフォルトでは記述されていません。指定する場合は，パラメーターを定義ファイルに追加する必要があります。

パスの指定ではパスに含まれる「¥」を「¥¥」と記述します。起動パス名は「"」で囲まないで記述します。指定するWWWブラウザーが，統合機能メニューおよびモニター画面呼び出しで起動するアプリケーションが前提としているWWWブラウザーかどうかを確認しておいてください。

このパラメーターを指定しなかった場合は，そのホストでファイルタイプ「.html」に関連づけられているWWWブラウザーが使用されます。ファイルタイプ「.html」に関連づけられているWWWブラウザー以外のWWWブラウザー（バージョンが異なるものも含む）を使用したい場合に，このパラメーターを指定します。

CLIPBOARD_OUTPUT={ON | OFF}

JP1イベント情報，アクション結果，コマンド実行結果をクリップボードにコピーする機能を有効にするかどうかを指定します。

「ON」を指定すると，クリップボードへのコピー機能が有効になります。JP1/IM - Viewの画面でコピーしたい情報を選択し［Ctrl］+［C］キーを押すと，選択している情報がCSV形式でクリップボードにコピーされます。また，［イベントコンソール］画面の［編集］メニューに［コピー］が表示されます。

「OFF」を指定すると，クリップボードへのコピー機能が無効になります。

このパラメーターを指定しなかった場合は，「ON」を仮定します。

LOGIN_USER_HISTORY_MAX={0|1}

［ログイン］画面のユーザー名に前回ログインしたJP1ユーザー名を表示するかどうかを指定します。1を指定すると，前回ログインしたJP1ユーザー名を表示します。0を指定すると，前回ログインしたJP1ユーザー名を表示しません。このパラメーターを指定しなかった場合や，0または1以外を指定した場合は，1を仮定します。デフォルトは1です。

SCREEN_TITLE_LOGININFO={ON|OFF}

［監視ツリー］画面，［監視ツリー（編集中）］画面，［ビジュアル監視（編集中）］画面，［イベントコンソール］画面，［コマンド実行］画面，および［アクション結果一覧］画面のタイトル部分に表示されるログイン中のJP1ユーザー名を非表示にできます。「ON」を指定すると，ログイン中のJP1ユーザー名を表示します。「OFF」を指定すると，ログイン中のJP1ユーザー名を表示しません。デフォルトは，「ON」です。このパラメーターを指定しなかった場合や，「ON」または「OFF」以外を指定した場合は，「ON」を仮定します。指定値は大文字と小文字を区別します。

定義例

# ************************************************************************
# ***  JP1/Integrated Management - View   Tuning definition file       ***
# ************************************************************************

# Input history maximum number in connected hostname input field on log in screen
LOGIN_HISTORY_MAX=5
# Tool Launcher is automatically started at log in whether (ON) (OFF).
MENU_AUTO_START=OFF
# List of Action Result is automatically started at log in whether (ON) (OFF).
 ACTIONLIST_AUTO_START=OFFCLIPBOARD_OUTPUT=ON
# Copies JP1 event information, action results, and command execution results to the clipboard (ON) (OFF).
CLIPBOARD_OUTPUT=ON
# Displays the previous user name in the Login window (1) (0).
LOGIN_USER_HISTORY_MAX=1
# Displays the user name in the window title bar (ON) (OFF).
SCREEN_TITLE_LOGININFO=ON

モニター画面呼び出し定義ファイル

形式

[@encode 文字コード]
DESC_VERSION=0300
{キー定義(SUBKEYパラメーターを使用)
サブキー定義
関連づけ定義
|キー定義(INTERFACEパラメーターを使用)}
呼び出しインターフェース定義

ファイル

hitachi_xxxx_mon.conf（連携製品のモニター画面呼び出し定義ファイル）

会社名_製品名_mon.conf（ユーザー定義のモニター画面呼び出し定義ファイル）

会社名_シリーズ名_製品名_mon.conf（ユーザー定義のモニター画面呼び出し定義ファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Consoleパス¥conf¥console¥monitor¥

論理ホストのとき

共有フォルダ¥jp1cons¥conf¥console¥monitor¥

UNIXの場合

物理ホストのとき

/etc/opt/jp1cons/conf/console/monitor/

論理ホストのとき

共有ディレクトリ/jp1cons/conf/console/monitor/

説明

モニター画面呼び出し定義ファイルは，インテリジェント統合管理基盤の統合オペレーション・ビューアー，またはセントラルコンソールの［イベントコンソール］画面から，イベント発行元などのモニター画面を呼び出すための定義ファイルです。この定義ファイルは，イベントIDや属性などの情報からキーを作り，イベント属性からコマンドラインパラメーターを作成するために使用します。

モニター画面呼び出し定義ファイルは，Linux版のJP1/IM - ManagerではUTF-8コード，Linux版以外のJP1/IM - ManagerではシフトJIS，またはEUCJISコードで定義する必要があります。また，標準提供ファイル名称用に「hitachi」を使用しているため，「会社名」には「hitachi」以外の名称を使用してください。

会社名が「hitachi」のモニター画面呼び出し定義ファイルは，システム標準定義情報であるため，ユーザーによる新規作成，変更，削除はできません。

なお，JP1/IMには，モニター画面呼び出し定義ファイルの記述内容をチェックするためのコマンド「jcomonitorfcheck」が用意されています。このコマンドの詳細については，「jcomonitorfcheck」（1.　コマンド）を参照してください。

定義の反映時期

JP1/IM - Managerを再起動したあと，またはjco_spmd_reloadコマンドを実行すると定義内容が有効になります。なお，インテリジェント統合管理基盤またはJP1/IM - Viewのログイン中に定義を変更した場合，ログイン中のインテリジェント統合管理基盤またはJP1/IM - Viewに変更した定義内容は反映されません。変更した定義を有効にするには，インテリジェント統合管理基盤またはJP1/IM - Viewを再起動する必要があります。

記述内容

@encode

モニター画面呼び出し定義ファイルで使用する文字コードを指定します。

モニター画面呼び出し定義ファイルを追加で作成する場合は，@encodeステートメントで定義ファイルの文字コードを指定してください。

項目名には，@encodeステートメントに指定した文字コードで表現できる文字を記載します。また，モニター画面呼び出し定義ファイルは，@encodeステートメントに指定した文字コードで保存します。

次の場合，統合オペレーション・ビューアーまたはJP1/IM - Viewに表示される項目名が文字化けすることがあります。

項目名に，@encodeステートメントに指定した文字コードで表現できない文字を使用した場合

@encodeステートメントに指定した文字コード，ファイルを保存した文字コード，および@encodeステートメントに指定した文字コードが不一致の場合

@encodeステートメントが存在しない場合，および@encodeステートメントのあとに指定した文字コードに誤りがある場合は，文字コードが自動判別されます。ただし，定義ファイルの内容によっては正しく判別できないおそれがあります。

指定できる文字コードは次のとおりです。

C

EUCJIS

SJIS

UTF-8

GB18030

注意事項

定義ファイルをUTF-8で保存する場合は，BOM（byte order mark）が付与されないように保存してください。

次の場合，エラーが出力されます。

C，EUCJIS，SJIS，UTF-8，およびGB18030以外の文字コードを指定した場合

@encodeを定義ファイルの先頭以外に記述した場合

@encodeのあとに文字コードを指定しなかった場合

注意事項

他製品から提供されたイベント拡張属性定義ファイルを使用する場合，定義ファイルで使用されている文字コードと，@encodeステートメントに指定する文字コードが一致していることを確認してください。また，定義ファイルを転送して配置する際は，定義ファイルの文字コードを変換しないようにしてください。

DESC_VERSION=0300

テーブルバージョンレコードです。

キー定義

モニター画面の呼び出し時にイベント属性中で固定的にキーとなる項目を定義します。キーとなる項目は次の三つです。

イベントID

プロダクト名

バージョン

それぞれの属性の組み合わせによって，動作やサブキーへのリンクを定義します。

形式

DEF_KEY PRODUCT_NAME="プロダクト名"

EVENT_ID=イベントID

[VERSION=バージョン|ALL]

{SUBKEY=サブキー

|INTERFACE=インターフェース名}

引数

・PRODUCT_NAME="プロダクト名"

/HITACHI/JP1/AJSなどの製品名を表す文字列です。拡張属性「PRODUCT_NAME」に設定する値と同一のものを指定します。

・EVENT_ID=イベントID

8けたの16進数値文字列で，IDの基本部だけを指定します。拡張部は無視されます。JP1/SES形式のイベントに設定されている拡張部を含める場合は，サブキーを使用してください。

・VERSION=バージョン

ここで指定したバージョンは，JP1イベントの拡張属性「ACTION_VERSION」と比較されます。バージョンとして使用できる文字は，半角の数字（0〜9），英字（A〜Z），「/」，「-」です。英字の大文字と小文字は区別されません。

一つのバージョンは8バイト以内で指定します。バージョンの範囲を指定する場合は，開始バージョンと終了バージョンの両方を「-」で区切って指定します。その場合，区切りとなる「-」の前後に一つ以上の空白が必要です。

ほかのキー定義で指定したバージョンと重複するバージョンは指定できません。

・SUBKEY=サブキー

サブキーの名称を記述します。このパラメーターとINTERFACEパラメーターは，どちらかを指定できます。

SUBKEYパラメーターを指定した場合は，SUBKEYに指定したサブキー名に対応したサブキー定義，関連づけ定義が必要です。

・INTERFACE=インターフェース名

インターフェースの名称を記述します。定義するキーに対して，モニター画面起動時のインターフェースを一つだけ指定します。このパラメーターとSUBKEYパラメーターは，どちらかを指定できます。

INTERFACEパラメーターを指定した場合はサブキー定義，関連づけ定義は使用できません。

注意事項

・バージョンの比較は昇順で実行されます。開始バージョンよりも終了バージョンの方が小さい場合は，エラーは発行されませんが，そのキー定義自体が無視されます。

・「PRODUCT_NAME」に指定する値は，JP1イベントの拡張属性「PRODUCT_NAME」に指定する値と同じにする必要があります。

サブキー定義

サブキー定義は，モニター画面の呼び出し時に固定キーからリンクされ，イベント属性をキーとして登録します。

形式

DEF_SUBKEY

NAME=サブキー名

KEYS=属性名1 [, 属性名2[,属性名3[,属性名4]]]

引数

・NAME=サブキー名

サブキーの名称を指定します。名称は，空白や制御文字を含まない16バイト以内の半角英数字文字列で指定します。大文字と小文字は区別されません。

・KEYS=属性名1 [, 属性名2[,属性名3[,属性名4]]]

属性名の指定形式を次に示します。

表2‒67　属性名の指定形式

指定形式

値の形式

意味および内容

B.ARRIVEDTIME

13けたの10進数文字列

到着時刻（UTC1970年1月1日00:00:00からのミリ秒数）

B.DESTSERVER

文字列

送信先イベントサーバ名

B.GROUPNAME

文字列

発行元グループ名

B.IDBASE

8けたの16進数文字列

イベントIDの基本部

B.IDEXT

8けたの16進数文字列

イベントIDの拡張部

B.PROCESSID

10進数文字列

発行元プロセスID

B.SEQNO

10進数文字列

DB内通し番号

B.SOURCESEQNO

10進数文字列

発行元別通し番号

B.SOURCESERVER※

文字列

発行元イベントサーバ名

B.TIME

13けたの10進数文字列

登録時刻（UTC1970年1月1日00:00:00からのミリ秒数）

B.USERNAME

文字列

発行元ユーザー名

B.MESSAGE

文字列

メッセージ

E.JP1_SOURCEHOST※

文字列

発生元ホスト名

E.xxxxxxx

文字列

拡張属性

注※

発行元イベントサーバ名（B.SOURCESERVER），発生元ホスト名（E.JP1_SOURCEHOST）には業務グループ名を使用できません。業務グループ名を指定した場合，ホスト名として扱われます。

関連づけ定義

サブキーの値とインターフェースの関連づけを定義します。

形式

DEF_IF_RELATION

SUBKEY_NAME=サブキー名

｛ VALUE1=" 属性値1"[[ VALUE2=" 属性値2"]…]

|KEY_DEFAULT ｝

IF_NAME=インターフェース名

引数

・SUBKEY_NAME=サブキー名

サブキーの名称を指定します。名称は，空白や制御文字を含まない16バイト以内の半角英数字文字列で指定します。大文字と小文字は区別されません。

・VALUEn=" 属性値"

nは，サブキー定義のKEYSパラメーターで指定した属性の並び順に1〜4の数です。キーの値は完全に一致させる必要があります。値に正規表現などは使用できません。指定できる属性の一覧と指定形式については，サブキー定義の説明を参照してください。

VALUE1，VALUE2，…のすべての属性が完全に一致しないJP1イベントは，「KEY_DEFAULT」で指定したインターフェースとなります。

・KEY_DEFAULT

VALUE1，VALUE2，…に指定した値と一致しないケースをインターフェースと関連づける際に，VALUE1，VALUE2，…の代わりに指定します。

・IF_NAME=インターフェース名

サブキー値が一致した場合に呼び出すインターフェース名称を指定します。インターフェース名称は，空白や制御文字を含まない16バイト以内の半角英数字文字列で指定します。大文字と小文字は区別されません。

呼び出しインターフェース定義

モニター画面呼び出し時のインターフェースを定義します。

形式

DEF_MTR_CALL

NAME=インターフェース名

EXEC_ID=アプリケーション実行定義識別子

PATH="コマンド引数"

[PARAM= 属性名1[,属性名2…]]

引数

・NAME=インターフェース名

インターフェースの名称を指定します。名称は，空白や制御文字を含まない16バイト以内の半角英数字文字列で指定します。大文字と小文字は区別されません。

・EXEC_ID=アプリケーション実行定義識別子

アプリケーション実行定義識別子を指定します。識別子には，ビューアー上のアプリケーション実行定義ファイルで定義したIDを指定します。

EXEC_IDパラメーターには「"default_browser"」を指定してデフォルトのブラウザーを起動できます。また，EXEC_IDパラメーターに「"default_browser"」を指定する場合は，PATHパラメーターにURLを記載します。

なお，「"jco_"」で始まる文字列はアプリケーション実行定義識別子として予約されているため，使用できません。

・PATH="コマンド引数"

EXEC_IDで指定した実行形式ファイルに渡すコマンド引数を指定します。EXEC_IDで指定した実行形式ファイル名とここで指定した引数によってコマンドラインが構成されます。例えば，次のようなコマンドラインがあるとします。

"app.exe arg1 arg2"

コマンド引数には，この「arg1」「arg2」の部分を指定します。

PATHには，ビューアーの動作環境属性およびイベント属性値で置換できる予約キーワードを指定できます。置き換えキーワードを次に示します。

表2‒68　置き換えキーワード

キーワード

置換する語句

%JCO_JP1USER%

インテリジェント統合管理基盤またはセントラルコンソールのログインユーザー名

%JCO_INSTALL_PATH%※

ビューアーのインストールフォルダ名

%IM_EVC_PARAMETER_n%

PARAMで指定したイベント属性値に置き換える

（nは1以上の整数）

%IM_EVC_LANGUAGE%

言語環境に応じて「Japanese」または「English」に置き換える

注※

インテリジェント統合管理基盤の場合は置き換えされません。

・PARAM=属性名1 [, 属性名2…]

イベント属性値で置き換える場合のイベント属性を属性名で指定します。属性名には，指定した順に1から順序番号が付けられます。順序番号は，置き換えキーワードの「n」に当たります。

複数のイベント属性を指定する場合は，「,」で区切って指定します。例を示します。

B.EXTID,E.A0

指定できるイベント属性は，基本属性の一部と拡張属性です。指定できる属性と指定形式については，サブキーの説明を参照してください。

定義例

WindowsのイベントログをトラップしたJP1イベントからモニター画面を呼ぶ場合の例を示します。

注

この例では，説明のために行頭に行番号を入れて示しています。

1行目

定義ファイルの文字コードで，文字コードが「UTF-8」であることを示します。

2行目

「DESC_VERSION=0300」は，このファイルの記述形式のバージョンが「0300」であることを示します。

3〜5行目

コメント行です。動作バージョンの適用範囲を含めることをお勧めします。

6行目

キー定義レコードで，プロダクト名が「/HITACHI/JP1/NTEVENT_LOGTRAP」，イベントIDが「00003A71」の場合に，サブキー「SAMPLE」を使用して，呼び出すモニター画面を決定することを意味します。

7行目

サブキー定義レコードで，サブキー名を「SAMPLE」として，拡張属性「PRODUCT_NAME」と，拡張属性「A5」（WindowsのイベントログのID）を使用することを宣言します。

8行目

関連づけ定義レコードで，サブキーに設定した「E.A5」の値が「8010」と一致した場合，インターフェース「NETM_DM」を使用してモニター画面を表示することを意味します。

9行目

呼び出しインターフェース定義レコードです。インターフェース名称を「NETM_DM」とし，アプリケーション実行定義識別子が「HITACHI_NETM_DM」で定義されているコマンドに引数として「netmdm_argument」を渡して実行することを意味します。

メール環境定義ファイル（jimmail.conf）

形式

Charset=メールの文字コード
From=送信元メールアドレス
DefaultTo=デフォルトの送信先メールアドレス[,デフォルトの送信先メールアドレス…]
SmtpServer=SMTPサーバ名
SmtpPort=SMTPポート番号
AuthMethod=メール送信時の認証方式
SmtpAuthPort=SMTP-AUTH認証のサブミッションポート番号
Pop3Server=POP3サーバ名
Pop3Port=POP3ポート番号
AuthUser=認証アカウント名
AuthPassword=認証パスワード
ConnectTimeout=ネットワーク接続タイムアウト時間
SoTimeout=通信タイムアウト時間
MailSubjectCutting=メール主題の切り捨て設定
MailNewLine=メールの改行コード

ファイル

jimmail.conf（メール環境定義ファイル)

jimmail.conf.model（メール環境定義ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Consoleパス¥conf¥mail

論理ホストのとき

共有フォルダ¥JP1Cons¥conf¥mail

説明

メール環境定義ファイルは，メールサーバのホスト名や認証方式，認証アカウント名・パスワードなどメール送信に必要な情報を設定する定義ファイルです。

定義の反映時期

jimmailコマンドを実行したときに有効になります。

記述内容

メール環境定義ファイルには，次に示す規則があります。

設定項目の1行は「パラメーター名=設定値」形式で記述し，パラメーター名と設定値は，1行の最初の"="（0x3d）で区切ります。

改行は，「CR（0x0d）」「LF（0x0a）」です。「CRLF」以外の改行コードを含む場合，jimmailpasswdコマンドでパスワードを設定すると「CRLF」に統一して出力します。

パラメーター名は大文字・小文字を区別します。

先頭が「#（0x23）」または「△#」で始まる行は，コメント行になります。ただし，#の前に半角スペース（0x20）またはタブ（0x09）を除く文字がある場合は，コメント行として扱いません（△は半角スペースまたはタブ）。

半角スペースまたはタブの扱いは次のとおりです（△は半角スペースまたはタブ）。

パラメーター名の前後の半角スペースおよびタブは無視されます。

例）△パラメーター名△=設定値

設定値の前後の半角スペースおよびタブ文字は無視されます。ただし，AuthPasswordパラメーターの場合だけ，前後の半角スペースおよびタブ文字を無視しないで，文字として扱います。

例）パラメーター名=△設定値△

無効なパラメーターが記述してある場合，エラーとなります。また，パラメーター名の後ろに"="がない場合も，エラーとなります。

Charset=メールの文字コード

送信するメールの件名と本文の文字コードを定義します。

文字コードは大文字・小文字を区別しません。

Charsetパラメーターの初期値と，Charsetパラメーターの値を取得できなかった場合の設定値を次の表に示します。

表2‒69　Charsetパラメーターの初期値と値を取得できなかった場合の設定値

環境

初期値

値を取得できなかった場合の設定値

日本語環境

iso-2022-jp

iso-8859-1

日本語環境以外

iso-8859-1

iso-8859-1

Charsetに指定できる文字コードを次の表に示します。

指定できない文字コードを定義した場合，上記表の値を取得できなかった場合の設定値として処理を行います。

表2‒70　Charsetに指定できる文字コード

文字コード

説明

iso-2022-jp

JISコード

shift_jis

シフトJISコード

euc-jp

EUCコード

utf-8

UTF-8コード

iso-8859-1

Latin1コード

us-ascii

ANSIコード

GB18030

GB18030コード（ただし，GBK範囲だけ）

上記以外

指定できない。

パラメーターがない場合，パラメーターに値がない場合，またはパラメーターに指定できない文字コードが定義されている場合は，KAVB8715-Wのメッセージを出力して，初期値で処理を継続します。

From=送信元メールアドレス

通知メールの送信元メールアドレスを定義します。

初期値は，空文字（""）です。

送信元メールアドレスは，1件だけ定義できます。

この項目は，省略できません。

送信元メールアドレスは，1〜256バイトの範囲で指定してください。

使用できる文字は，次の表に示す文字です。

表2‒71　Fromで使用できる文字コード

使用できる文字

説明

半角英数字

0-9，a-z

@

アットマーク（0x40）

.

ピリオド（0x2e）

-

ハイフン（0x2d）

_

アンダースコア（0x5f）

必須パラメーターがない場合，パラメーターに値がない場合，パラメーターに使用できない文字が定義されている場合，パラメーターがRFC822フォーマットではない場合，またはパラメーターが最大長を超えている場合は，KAVB8714-Eのメッセージを出力して，異常終了します。

DefaultTo=デフォルトの送信先メールアドレス[,デフォルトの送信先メールアドレス…]

デフォルトの送信先メールアドレスを定義します。

初期値は，空文字（""）です。

送信先メールアドレスは，20件定義できます。複数のメールアドレスを指定する場合は，「,（コンマ）」でアドレスを区切って指定してください。

メールアドレスと「,（コンマ）」の間の半角スペース，タブは無視されます。

連続した「,（コンマ）」は一つの「,（コンマ）」と見なし，先頭と末尾の「,（コンマ）」は無視されます。同じメールアドレスを複数指定した場合，指定したアドレスにはメールを1件だけ送信します。

このパラメーターは省略できます。省略した場合，jimmailコマンドの-toオプションは必ず指定してください。

DefaultToパラメーターとjimmailコマンドの-toオプションどちらも指定されている場合，-toオプションが優先されます。

送信先メールアドレスは，1〜256バイトの範囲で指定してください。

使用できる文字は，送信元メールアドレスと同じです。

使用できない文字が指定されている場合，パラメーターがRFC822フォーマットではない場合，またはパラメーターが最大長を超えている場合は，KAVB8714-Eのメッセージを出力して，異常終了します。

また，DefaultToパラメーターとjimmailコマンドの-toオプションどちらも指定がない場合は，KAVB8712-Eのメッセージを出力して，異常終了します。

SmtpServer=SMTPサーバ名

メール送信時に接続するSMTPサーバのホスト名またはIPアドレスを定義します。SMTPサーバ名のホスト名解決ができるように，次のどれかのファイルを設定します。

マネージャーホスト上のJP1/Baseのjp1hostsファイル

マネージャーホスト上のJP1/Baseのjp1hosts2ファイル

hostsファイルまたはDNS

IPアドレスは，IPv4アドレスだけを指定できます。IPv6アドレスは指定できません。

SmtpServerパラメーターの初期値は，空文字（""）です。

SMTPサーバ名は，システムで一つだけ指定します。

また，このパラメーターは省略できません。

ホスト名を指定する場合，1〜255バイトの半角文字で指定してください。

必須パラメーターがない場合，パラメーターに値がない場合，パラメーターに使用できない文字が定義されている場合，またはパラメーターが最大長を超えている場合は，KAVB8714-Eのメッセージを出力して，異常終了します。

SmtpPort=SMTPポート番号

SMTPサーバの通信ポートのポート番号を定義します。

SmtpPortパラメーターの初期値は25です。値を取得できなかった場合，25を仮定します。ポート番号は，1〜65535の範囲で指定してください。

AuthMethodで「NONE」または「POP」を定義した場合，この項目は有効になります。

パラメーターがない場合，パラメーターに値がない場合，パラメーターに数値でない文字列が指定されている場合，またはパラメーターに範囲外の値が指定されている場合は，KAVB8715-Wのメッセージが出力され，初期値で処理を継続します。

AuthMethod=メール送信時の認証方法

メール送信時の認証方式を定義します。

このパラメーターは，省略できません。

認証方式は，次の表に示す値で定義します。初期値は「NONE」です。

表2‒72　AuthMethodの認証方式

AuthMethodの値

認証方式

NONE

認証なし

POP

POP before SMTP認証

SMTP

SMTP-AUTH認証

メール送信時の認証方式によって，メール環境定義ファイルの設定の必須・任意項目が変わります。

必須パラメーターがない場合，パラメーターに値がない場合，またはパラメーターに範囲外の値が指定されている場合は，KAVB8714-Eのメッセージを出力して，異常終了します。

AuthMethodの値ごとの設定項目の一覧を次に示します。

表2‒73　AuthMethodがNONEのときの設定項目

パラメーター名

設定要否

省略

省略時の値

Charset

○

省略可能

iso-8859-1

From

○

必須

−

DefaultTo

○

省略可能

""

AuthMethod

○

必須

−

SmtpServer

○

必須

−

SmtpPort

○

省略可能

25

SmtpAuthPort

×

−

−

Pop3Server

×

−

−

Pop3Port

×

−

−

AuthUser

×

−

−

AuthPassword

×

−

−

ConnectTimeout

○

省略可能

10,000

SoTimeout

○

省略可能

10,000

MailSubjectCutting

○

省略可能

OFF

MailNewLine

○

省略可能

CRLF

（凡例）

○：設定の必要あり

×：設定の必要なし

表2‒74　AuthMethodがPOPのときの設定項目

パラメーター名

設定要否

省略

省略時の値

Charset

○

省略可能

iso-8859-1

From

○

必須

−

DefaultTo

○

省略可能

""

AuthMethod

○

必須

−

SmtpServer

○

必須

−

SmtpPort

○

省略可能

25

SmtpAuthPort

×

−

−

Pop3Server

○

必須

−

Pop3Port

○

省略可能

110

AuthUser

○

必須

−

AuthPassword

○

必須

−

ConnectTimeout

○

省略可能

10,000

SoTimeout

○

省略可能

10,000

MailSubjectCutting

○

省略可能

OFF

MailNewLine

○

省略可能

CRLF

（凡例）

○：設定の必要あり

×：設定の必要なし

表2‒75　AuthMethodがSMTPのときの設定項目

パラメーター名

設定要否

省略

省略時の値

Charset

○

省略可能

iso-8859-1

From

○

必須

−

DefaultTo

○

省略可能

""

AuthMethod

○

必須

−

SmtpServer

○

必須

−

SmtpPort

×

−

−

SmtpAuthPort

○

必須

587

Pop3Server

×

−

−

Pop3Port

×

−

−

AuthUser

○

必須

−

AuthPassword

○

必須

−

ConnectTimeout

○

省略可能

10,000

SoTimeout

○

省略可能

10,000

MailSubjectCutting

○

省略可能

OFF

MailNewLine

○

省略可能

CRLF

（凡例）

○：設定の必要あり

×：設定の必要なし

SmtpAuthPort=SMTP-AUTH認証のサブミッションポート番号

SMTP-AUTH認証用の通信ポートのサブミッションポート番号を定義します。初期値は587です。値を取得できなかった場合，587を仮定します。ポート番号は，1〜65535の範囲で指定してください。

SMTP-AUTH認証を使用する場合，接続メールサーバがサブミッションポートを使用しないときは，SmtpAuthPortパラメーターには，接続するSMTPサーバが使用する宛先ポート番号を指定してください。

AuthMethodで「SMTP」を定義した場合，この項目は有効になります。

パラメーターがない場合，パラメーターに値がない場合，パラメーターに数値でない文字列が指定されている場合，またはパラメーターに範囲外の値が指定されている場合は，KAVB8715-Wのメッセージが出力され，初期値で処理を継続します。

Pop3Server=POP3サーバ名

POP before SMTP認証で使用するPOP3サーバのホスト名またはIPアドレスを定義します。POP3サーバ名のホスト名解決ができるように，次のどれかのファイルを設定します。

マネージャーホスト上のJP1/Baseのjp1hostsファイル

マネージャーホスト上のJP1/Baseのjp1hosts2ファイル

hostsファイルまたはDNS

IPアドレスは，IPv4アドレスを指定できます。IPv6アドレスは指定できません。

メールサーバがSMTPサーバとPOP3サーバを兼ねている場合，SmtpServerに指定したSMTPサーバ名を指定してください。

POP3サーバ名は，システムで一つだけ指定してください。

POP3サーバのホスト名を指定する場合，1〜255バイトの半角文字で指定します。初期値は，空文字（""）です。POP3サーバのホスト名に使用できる文字は，SMTPサーバのホスト名に使用できる文字と同じです。

AuthMethodで「POP」を定義した場合，この項目は有効になります。有効の場合，このパラメーターの指定は必須です。

必須パラメーターがない場合，パラメーターに値がない場合，パラメーターに使用できない文字が定義されている場合，またはパラメーターが最大長を超えている場合は，KAVB8714-Eのメッセージを出力して，異常終了します。

Pop3Port=POP3ポート番号

POP before SMTP認証で使用するPOP3サーバの通信ポートのポート番号を定義します。

パラメーターの初期値は110です。値を取得できなかった場合，110を仮定します。ポート番号は，1〜65535の範囲で指定してください。

AuthMethodで「POP」を定義した場合，この項目は有効になります。

パラメーターがない場合，パラメーターに値がない場合，パラメーターに数値でない文字列が指定されている場合，またはパラメーターに範囲外の値が指定されている場合は，KAVB8715-Wのメッセージが出力され，初期値で処理を継続します。

AuthUser=認証アカウント名

AuthUserパラメーターでは，POP before SMTP認証またはSMTP-AUTH認証で使用する認証アカウント名を定義します。

認証アカウント名は，1〜255バイトの半角文字で指定します。

初期値は空文字（""）です。

AuthMethodパラメーターに「POP」または「SMTP」を指定した場合，この項目は有効になります。

必須パラメーターがない場合，パラメーターに値がない場合，パラメーターに使用できない文字（マルチバイト）が定義されている場合，またはパラメーターが最大長を超えている場合は，KAVB8714-Eのメッセージを出力して，異常終了します。

AuthPassword=認証パスワード

AuthPasswordパラメーターでは，POP before SMTP認証またはSMTP-AUTH認証の認証パスワードが設定されます。

AuthPasswordパラメーターの認証パスワードはjimmailpasswdコマンドで設定します。

メール環境定義ファイルを直接編集してAuthPasswordパラメーターに平文のパスワードを設定した場合，メールサーバ接続時に認証パスワードが一致しないため，メールサーバにログインできません。

AuthMethodパラメーターに「POP」または「SMTP」を指定した場合，この項目は有効になります。

必須パラメーターがない場合，パラメーターに値がない場合，パラメーターに使用できない文字（マルチバイト）が指定されている場合，またはパラメーターが最大長を超えている場合は，KAVB8714-Eのメッセージを出力して，異常終了します。

ConnectTimeout=ネットワーク接続タイムアウト時間

ConnectTimeoutパラメーターには，SMTPとPOP3サーバとの接続完了を待つタイムアウト時間をミリ秒単位で定義します。初期値は10,000ミリ秒（10秒）です。

タイムアウト時間は1,000〜3,600,000（1〜3,600秒）の範囲で指定します。

初期値で接続タイムアウトが発生する場合だけ，運用環境に合わせて変更してください。

パラメーターがない場合，パラメーターに値がない場合，パラメーターに数値でない文字列が指定されている場合，またはパラメーターに範囲外の値が指定されている場合は，KAVB8715-Wのメッセージが出力され，初期値で処理を継続します。

SoTimeout=通信タイムアウト時間

SoTimeoutパラメーターには，SMTPとPOP3サーバからの応答を受信するまでのタイムアウト時間をミリ秒単位で定義します。初期値は10,000ミリ秒（10秒）です。

タイムアウト時間は1,000〜3,600,000（1〜3,600秒）の範囲で指定します。

初期値で通信タイムアウトのエラーが発生する場合だけ，運用環境に合わせて変更してください。

パラメーターがない場合，パラメーターに値がない場合，パラメーターに数値でない文字列が指定されている場合，またはパラメーターに範囲外の値が指定されている場合は，KAVB8715-Wのメッセージが出力され，初期値で処理を継続します。

MailSubjectCutting=メール主題の切り捨て設定

MailSubjectCuttingパラメーターには，メール送信時にメール主題が最大長を超えていた場合にメールの主題を切り捨てて強制的に送信を行うかを定義します。

「OFF」の場合は，メールの主題は切り捨てないで，jimmailコマンドが異常終了します。

「ON」の場合は，メールの主題をCharsetパラメーターで指定したメールの文字コードに従い512バイト以内になるように切り捨てて，メール送信を継続します。

初期値は，「OFF」です。設定値は大文字・小文字の区別はしません。

パラメーターがない場合，パラメーターに値がない場合，またはパラメーターに「ON」「OFF」以外の値が指定されている場合は，KAVB8715-Wのメッセージが出力され，初期値で処理を継続します。

MailNewLine=メール本文の改行コード

MailNewLineパラメーターには，メール本文で使用する改行コードを定義します。jimmailコマンドは，コマンドのオプション引数で指定した改行文字「¥n」を，このパラメーターで指定した改行コードに置き換えてメール送信します。初期値は，「CRLF」です。

設定値は，大文字・小文字を区別しません。

RFCでメールの改行コードは「CRLF」と規定されていて，理由がないかぎり初期値から変更しないでください。メールサーバによっては，「CRLF」以外の改行コードを使用した場合，メール送信に失敗したり，メールの改行が行われなかったりなどの問題が発生するおそれがあります。

改行コードは，次の表に示す値で定義します。

表2‒76　MailNewLineの設定値

設定値

説明

CRLF

CR（0x0d）+LF（0x0a）

LF

LF（0x0a）

CR

CR（0x0d）

パラメーターがない場合，パラメーターに値がない場合，またはパラメーターに範囲外の値が定義されている場合は，KAVB8715-Wのメッセージが出力され，初期値で処理を継続します。

定義例

インストール直後の日本語環境のメール環境定義ファイルを次に示します。

Charset=iso-2022-jp
From=
DefaultTo=
SmtpServer=
SmtpPort=25
AuthMethod=NONE
SmtpAuthPort=587
Pop3Server=
Pop3Port=110
AuthUser=
AuthPassword=
ConnectTimeout=10000
SoTimeout=10000
MailSubjectCutting=OFF
MailNewLine=CRLF

インストール直後の日本語環境以外のメール環境定義ファイルを次に示します。

Charset=iso-8859-1
From=
DefaultTo=
SmtpServer=
SmtpPort=25
AuthMethod=NONE
SmtpAuthPort=587
Pop3Server=
Pop3Port=110
AuthUser=
AuthPassword=
ConnectTimeout=10000
SoTimeout=10000
MailSubjectCutting=OFF
MailNewLine=CRLF

表示メッセージ変更定義ファイル（jcochmsg.conf）

形式

DESC_VERSION=1
#表示メッセージ変更定義のコメント
def 定義名1
    [cmt コメント]
    [define {enable | disable}]
    [addflag {true | false}]
    cnd
        イベント条件
    end-cnd
    msg メッセージ
end-def

def 定義名2
    [cmt コメント]
    [define {enable | disable}]
    [addflag {true | false}]
    cnd
        イベント条件
    end-cnd
    msg メッセージ
end-def

ファイル

jcochmsg.conf（表示メッセージ変更定義ファイル）

jcochmsg.conf.model（表示メッセージ変更定義ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Consoleパス¥conf¥chattr¥ jcochmsg.conf

論理ホストのとき

共有フォルダ¥jp1cons¥conf¥chattr¥jcochmsg.conf

UNIXの場合

物理ホストのとき

/etc/opt/jp1cons/conf/chattr/jcochmsg.conf

論理ホストのとき

共有ディレクトリ/jp1cons/conf/chattr/jcochmsg.conf

説明

表示メッセージ変更機能でメッセージの表示を変更するJP1イベントの条件と，変更後のメッセージを定義するファイルです。このファイルの定義に従い，イベント条件に一致するJP1イベントの属性を変更します。このファイルは，JP1/IM - Managerの動作する言語コードで記述してください。

このファイルの最大サイズは，22メガバイト（23,068,672バイト）です。

表示メッセージ変更定義ファイルのパラメーターには，次の2種類があります。

表示メッセージ変更定義ファイルバージョン

表示メッセージ変更定義ファイルのフォーマットのバージョンを定義します。

表示メッセージ変更定義パラメーター

表示メッセージを変更するJP1イベントの条件と変更後の表示メッセージを定義します。表示メッセージ変更定義ファイルで上に記述されている表示メッセージ変更定義ほど，優先順位が高くなります。

定義の反映時期

イベントの表示メッセージ変更機能が有効で，次のどれかが成立する場合に有効になります

JP1/IM - Managerを起動した場合

jco_spmd_reloadコマンドを実行した場合

［表示メッセージ変更定義を設定］メニューから開いた［追加表示メッセージ変更定義設定］画面で［OK］ボタンをクリックした場合

［表示メッセージ変更定義一覧］画面で［適用］ボタンをクリックした場合

記述内容（表示メッセージ変更定義ファイルバージョン）

DESC_VERSION

DESC_VERSIONには，表示メッセージ変更定義ファイルの形式を決定するファイルバージョンをバージョン情報として定義します。指定する値は1です。DESC_VERSIONの指定を省略した場合，ファイルバージョンを1と見なして処理します。

DESC_VERSIONは，定義ファイルの先頭行（空行，コメント行を除いた行のうちファイルのはじめに記述された行）に記載します。先頭行にファイルバージョンがなかった場合は，ファイルバージョンを1と見なして処理します。

記述内容（表示メッセージ変更定義パラメーター）

表示メッセージ変更定義パラメーターは，図に示すとおり，定義ブロックとイベント条件ブロックで構成されています。

図2‒10　表示メッセージ変更パラメーター

定義ブロックは複数指定できます。指定できる定義ブロックの数は，0〜3,000個です。定義ブロックの数が最大数を超えていた場合，KAVB4640-Wのメッセージを出力し，3,001個以降の定義ブロックを無視して処理を続行します。

def〜end-def（定義ブロック）

表示メッセージ変更定義の開始と終了のパラメーターです。def〜end-defブロックは省略でき，この場合「すべてのJP1イベントのメッセージ変更をしない」と解釈します。

def以降には，表示メッセージ変更定義の定義名を記述します。「def△△△定義1△△△定義2△△△」と指定した場合，「△△定義1△△△定義2△△△」が定義名となります（△は半角スペースを表す）。

定義名は，表示メッセージ変更定義ファイル内で一意になるように1〜50バイトの文字列を指定します。指定できる文字は，制御文字（0x00〜0x1F，0x7F〜0x9F）以外の文字列です。

cmt コメント

表示メッセージ変更定義のコメントを記述します。cmtに指定されたコメントは，［表示メッセージ変更定義設定］画面のコメント欄に表示されます。cmtパラメーターは，定義ブロック内に一つだけ指定できます。このパラメーターは省略できます。コメントは1,024バイト以内で指定してください。指定できる文字は，制御文字（0x00〜0x1F，0x7F〜0x9F）以外の文字列です。

define {enable | disable}

表示メッセージ変更定義を有効にするかどうかを指定します。defineパラメーターは，定義ブロック内に一つだけ指定できます。表示メッセージ変更定義を有効にする場合は「enable」を，無効にする場合は「disable」を指定します。defineパラメーターは，省略できます。デフォルトは，「enable」です。英大文字・英小文字は区別しません。

addflag {true | false}

追加表示メッセージ変更定義を画面から追加したことを示すパラメーターで，表示メッセージ変更定義が追加表示メッセージ変更定義かどうかを指定します。そのため，表示メッセージ変更定義ファイルを編集する場合は，addflagパラメーターを指定する必要はありません。addflagパラメーターは定義ブロック内に一つだけ指定できます。追加表示メッセージ変更定義の場合は「true」を，表示メッセージ変更定義の場合は「false」を指定します。「true」を指定した場合は，［表示メッセージ変更定義一覧］画面の［種別］にアイコン（[図データ]）が表示されます。addflagパラメーターは，省略できます。デフォルトは，「false」です。英大文字・英小文字は区別しません。

cnd〜end-cnd（イベント条件ブロック）

表示メッセージを変更するJP1イベントのイベント条件を指定する，ブロックの開始と終了のパラメーターです。イベント条件ブロックは，定義ブロック内に必ず一つ指定します。省略はできません。受信したJP1イベントが，複数のイベント条件に一致する場合，表示メッセージ変更定義ファイルの先頭に近い定義ブロックが優先されます。cndおよびend-cndパラメーターの前後のタブやスペースは，無視されます。

イベント条件

表示メッセージを変更するJP1イベントの条件を指定します。イベント条件ブロックに指定できるイベント条件は0〜256件です。イベント条件とイベント条件は，AND条件となります。イベント条件は，次の形式で指定します（△は半角スペースを表す）。

　属性名△比較キーワード△オペランド[△オペランド]…

なお，半角スペースまたはタブだけで構成された行は，無視して処理を続行します。

・属性名

属性名には，比較したい属性の名称を記述します。基本属性を指定する場合は，名称の前に「B.」を付けます。拡張属性（共通情報），拡張属性（固有情報）を指定する場合は，名称の前に「E.」を付けます。英大文字・英小文字を区別します。

指定できる属性名と比較キーワードの組み合わせおよびオペランドを次に示します。

表2‒77　指定できる属性名と比較キーワードの組み合わせおよびオペランド

項番

項目

属性名

比較

キーワード

オペランド

1

イベントID

B.ID

と一致する

と一致しない

複数指定できる。複数指定では最大100件指定できる。

16進数形式で指定する。大文字・小文字は区別しない。

指定できる範囲は0〜7FFFFFFFである。

2

登録要因

B.REASON

と一致する

と一致しない

複数指定できる。複数指定では最大100件指定できる。

3

発行元プロセスID

B.PROCESSID

と一致する

と一致しない

複数指定できる。複数指定では最大100件指定できる。

指定できる範囲は，-2,147,483,648〜2,147,483,647である。

4

発行元ユーザーID

B.USERID

と一致する

と一致しない

複数指定できる。複数指定では最大100件指定できる。

指定できる範囲は，-2,147,483,648〜2,147,483,647である。

5

発行元グループID

B.GROUPID

と一致する

と一致しない

複数指定できる。複数指定では最大100件指定できる。

指定できる範囲は，-2,147,483,648〜2,147,483,647である。

6

発行元ユーザー名

B.USERNAME

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

7

発行元グループ名

B.GROUPNAME

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

8

発行元イベントサーバ名(登録ホスト名)※1

B.SOURCESERVER

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

9

送信先イベントサーバ名※1

B.DESTSERVER

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

10

メッセージ

B.MESSAGE

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

11

重大度

E.SEVERITY

と一致する

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。"Emergency"，"Alert"，"Critical"，"Error"，"Warning"，"Notice"，"Information"，"Debug"のどれかを指定できる。

12

ユーザー名

E.USER_NAME

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

13

プロダクト名

E.PRODUCT_NAME

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

14

オブジェクトタイプ

E.OBJECT_TYPE

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

15

オブジェクト名

E.OBJECT_NAME

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

16

登録名タイプ

E.ROOT_OBJECT_TYPE

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

17

登録名

E.ROOT_OBJECT_NAME

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

18

オブジェクトID

E.OBJECT_ID

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

19

事象種別

E.OCCURRENCE

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

20

終了コード

E.RESULT_CODE

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

21

発生元ホスト名※1

E.JP1_SOURCEHOST

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

22

固有の拡張属性※3

E.xxxxxxx

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

属性名には，先頭が英大文字で英大文字，数字，およびアンダースコア（_）から構成される32バイトまでの名称を設定できる。

複数指定できる。ただし，正規表現を指定した場合は，複数指定できない。複数指定では最大100件指定できる。

注※1

統合監視DBおよびIM構成管理DBが有効な場合に，比較キーワードが，「と一致する」「と一致しない」のとき，パス表記で業務グループ名を指定できます。

統合監視DBおよびIM構成管理DBが無効な場合，および［と一致する］［と一致しない］以外を選択した場合，パス表記で業務グループ名を指定しても，ホスト名として扱われます。

jcoimdefコマンドの-ignorecasehostオプションの指定を「ON」にしている場合に，比較キーワードで［正規表現］以外を選択すると，文字列の英大文字・英小文字を区別しません。

注※2

各JP1製品固有の拡張属性も使用できます。例えば，JP1/AJSのジョブの実行ホストは，E.C0です。製品固有の拡張属性についての詳細は，JP1イベントを発行する各製品のマニュアルを参照してください。

・比較キーワード

比較キーワードには，「BEGIN（から始まる）」，「IN（と一致する）」，「NOTIN（と一致しない）」，「SUBSTR（を含む）」，「NOTSUBSTR（を含まない）」，「REGEX（正規表現）」のどれか一つを指定できます。英大文字・英小文字を区別します。

・オペランド

比較キーワードで属性値と比較する値を文字列で指定します。英大文字・英小文字を区別します。

オペランドを複数指定する場合は，一つ以上の連続した半角スペースまたはタブをオペランドとオペランドの間に挿入して区切ります。オペランドとオペランドは，OR条件となります。ただし，正規表現を指定している場合は，複数指定できません。

オペランドに，半角スペース，タブ，改行コード（CR，LF）および%を指定したい場合，次のように記述します。

項番

指定したい値

指定方法

1

タブ（0x09）

%09

2

半角スペース（0x20）

%20

3

%（0x25）

%25

4

改行コード LF（0x0a）

%0a

5

改行コード CR（0x0d）

%0d

定義フォーマットの上限チェックの場合，%20，%25は1文字として扱います。%のあとに指定する文字コードは，英大文字・英小文字を区別しません。複数選択した場合の定義例「IDが100と200に一致する」を示します。

B.ID△IN△100△200

（凡例）　△：半角スペース（0x20）

オペランドは，イベント条件1件当たり4,096バイトまで，イベント条件ブロック1件当たり4,096バイト（イベント条件ブロックに記述したオペランドの合計バイト数）まで指定できます。

msg

表示用のメッセージを記述するパラメーターです。

msgパラメーターは，定義ブロック内に必ず一つ指定します。省略はできません。

msgは1,023バイト以内で指定してください。指定できる文字は，制御文字（0x00〜0x1F，0x7F〜0x9F）以外の文字列です。

msgパラメーターが，定義ブロックの外で指定された場合，KAVB4629-Wのメッセージを出力し，msgパラメーターの指定を無視して処理を続行します。

また，msgパラメーターが次の場合，KAVB4631-Wのメッセージを出力し，エラーがあった定義ブロックを無視して処理を続行します。

msgパラメーターを省略した場合

msgパラメーターの指定が複数ある場合

msgパラメーターに指定したメッセージが1,023バイトを超える場合

msgパラメーターに指定したメッセージに制御文字が指定されていた場合

変更後のメッセージに$EVSEVのように変数を指定すると，イベントの属性値の引き継ぎができます。

指定できる変数を次に示します。

情報の種類

変数名

内容

JP1イベント基本属性に含まれる情報

EVBASE

イベント基本情報全体※1

EVID

イベントID（基本コード:拡張コード）

EVIDBASE

イベントID（基本コード）

EVDATE

イベント登録日（YYYY/MM/DD）※2

EVTIME

イベント登録時刻（hh:mm:ss）※2

EVPID

イベント発行元プロセスID

EVUSRID

イベント発行元プロセスのユーザーID

EVGRPID

イベント発行元プロセスのグループID

EVUSR

イベント発行元ユーザー名

EVGRP

イベント発行元グループ名

EVHOST

イベント発行元ホスト名

EVIPADDR

イベント発行元IPアドレス

EVSEQNO

イベントDB内通し番号

EVARVDATE

イベント到着日（YYYY/MM/DD）※2

EVARVTIME

イベント到着時刻（hh:mm:ss）※2

EVSRCNO

イベント発生元のイベントDB内通し番号

EVMSG

メッセージテキスト全体※3

EVDETAIL

イベント詳細情報全体※3，※4

JP1イベント拡張属性に含まれる情報

EVSEV

イベント拡張情報重大度（Emergency, Alert, Critical, Error, Warning, Notice, Information, Debug）※3

EVUSNAM

ユーザー名※3

EVOBTYP

オブジェクトタイプ※3

EVOBNAM

オブジェクト名※3

EVROBTYP

登録タイプ※3

EVROBNAM

登録名※3

EV"PRODUCT_NAME"

プロダクト名※5

EV"OBJECT_ID"

オブジェクトID※5

EV"OCCURRENCE"

事象種別※5

EV"START_TIME"

開始時刻※5

EV"END_TIME"

終了時刻※5

EV"RESULT_CODE"

終了コード※5

EV"JP1_SOURCEHOST"

発生ホスト名※5

EV"拡張属性名"

任意の拡張属性※5

その他

EV"@JP1IM_CORRELATE"

相関イベントフラグ

相関イベントではない：0

相関成立イベントである：1

相関不成立イベント：2

EV"@JP1IM_ORIGINAL_SEVERITY"

イベント拡張情報重大度(変更前)

（Emergency, Alert, Critical, Error, Warning, Notice, Information, Debug）※3

EV"@JP1IM_CHANGE_SEVERITY"

重大度変更フラグ

重大度を変更していない：0

重大度を変更した：1

ACTHOST

マネージャーホスト名の値※3

EVENV1〜EVENV20

イベント条件の指定で，正規表現中に"( )"を指定して切り出したデータ※5

（マネージャーホストで拡張正規表現を使用している場合だけ使用できる）

注※1

JP1イベントの基本情報が次の形式に変換されて変更後のメッセージに渡されます（△は半角スペース）。

イベントID△イベント発行元ユーザー名△イベント発行元ユーザーID△イベント発行元グループ名△イベント発行元グループID△イベント発行元イベントサーバ名△イベント発行元プロセスID△イベント登録年月日△イベント登録時刻△イベント発行元ホストIPアドレス

設定されていない項目は空文字となります。

注※2

JP1/IM - Managerのタイムゾーンで変換して変更後のメッセージに渡されます。

注※3

該当する属性が存在しない場合，メッセージ変更時に変数が空文字に変換されて変更後のメッセージに渡されます。

注※4

JP1イベントの詳細属性の情報がバイナリー形式の場合は，変数が空文字に変換されて変更後のメッセージに渡されます。

注※5

該当する属性が存在しない場合，変数の文字列がそのまま変更後のメッセージに渡されます。

変数の記述での注意点

「$」を文字として指定したい場合は，エスケープ文字「¥」を「$」の前に指定します。

変数の直後に文字を記述する場合，変数の直後に英数字および「_」を指定すると正しく変換されません。このような場合は，変数を｛｝で囲んでください。次に指定例を示します。なお，次の例では，イベントID（$EVID）は100:0，拡張属性EX（$EV"EX"）はABCが設定されていると仮定します。

（指定例）

表示メッセージ変更定義 → 変換後の情報

「$EVID abc」 → 「100:0 abc」

「$EVIDabc」 → 「$EVIDabc」

「${EVID}abc」 → 「100:0abc」

「$EVID_abc」 → 「$EVID_abc」

「${EVID}_abc」 → 「100:0_abc」

「$EV"EX" abc」 → 「ABC abc」

「$EV"EX"abc」 → 「ABCabc」

変数名以外が指定された場合，変数が記述されている個所をイベント引き継ぎ情報に変換されません。例えば，指定していない変数名「AAA」を「$AAA」として指定した場合，変更後のメッセージには「$AAA」が設定されます。

EV"拡張属性名"，EVENV1〜EVENV20で指定された属性の値が取得できなかった場合，変数が記述されている個所をイベント引き継ぎ情報に変換されません。例えば，「$EV"BBB"」と指定している場合，JP1イベントに拡張属性「BBB」がないとき，変更後のメッセージには「$EV"BBB"」が設定されます。

EV"拡張属性名"，EVENV1〜EVENV20以外の変数で指定された属性の値が取得できなかった場合は，変数が記述されている個所を空文字に変換されます。例えば，「$EVSEV」を指定しているとき，JP1イベントに拡張属性「SEVERITY」がなければ，変更後のメッセージには「」（空文字）が設定されます。

正規表現を使ったイベント条件が複数ある場合は上から順に，さらに記述された正規表現に"( )"が複数ある場合は左から順に，EVENV1〜EVENV20まで順次対応付けがされます。

イベント引き継ぎ情報の変換機能

イベント引き継ぎ情報をユーザーが指定した長さの文字列に変換できます。メッセージIDや日付などを固定長にそろえて，イベント一覧に見やすく表示できます。

イベント引き継ぎ情報の長さがユーザーの指定した長さ未満の場合は，半角スペースを追加し，指定した長さにします。

イベント引き継ぎ情報の長さがユーザーの指定した長さより大きい場合は，イベント引き継ぎ情報をユーザーが指定した長さに切り捨てます。

マルチバイト文字が切り捨てられる場合は，文字が壊れないように切り捨てられます。切り捨て後の長さがユーザーの指定した長さに満たない場合は，半角スペースが追加されます。

＜指定形式＞

$変数名$FIXLEN=<バイト数>

バイト数には1〜1,023の数値を指定します。指定形式が不正な場合は，「$FIXLEN=<バイト数>」を文字列として扱います。

変数名を｛｝で囲むことにより，パラメーターとして扱う位置を指定できます。

項番

指定形式

$変数名の文字列

メッセージに設定する文字列

備考

1

$変数名$FIXLEN=6

ABC

ABC△△△

指定した長さより短いため，足りない桁に半角スペースを追加する。

2

ABCDEFG

ABCDEF

指定した長さより長いため，文字列を切り捨てる。

3

$変数名$FIXLEN=1024

ABC

ABC$FIXLEN=1024

指定している値が最大数1023を超えているので，文字列として扱う。

4

$変数名$FIXLEN=10225

ABC

ABC△…△5

△…△：△が1,019個を表す

$FIXLEN=の後ろの文字列は4文字だけがパラメーターとなり，5文字目以降は文字列として扱う。

5

${変数名$FIXLEN=10}235

ABC

ABC△△△△△△△235

「10」までを｛｝で囲みパラメーターとして扱い，「235」を文字列として扱う。

（凡例） △：半角スペース

メッセージの数値にゼロ埋めをして，表示する数値の桁数をそろえることができます。秒数を示す数値を「ss」「ss. sss」「ss.ssssss」等のフォーマットに変換したい場合に使用します。

＜指定形式＞

$変数名$FIXNUM=<00>.<000000>

整数は0〜2桁，小数は0〜6桁が指定できます。

変数に格納されている値が数値の文字列の場合も変換できます。

数値以外の文字列が設定されている場合，整数が指定した桁数より多い場合，または変数に格納されている値が100以上の場合は変換しません。

小数が指定した桁数より多い場合は，小数以下は切り捨てます。また，変数に格納されている値に小数第７位以降が設定されている場合も切り捨てます。

項番

指定形式

$変数名の文字列

メッセージに設定する文字列

備考

1

$変数名$FIXNUM=00.000

1

01.000

整数，小数の足りない桁はゼロ埋めする。

2

123.123456

123.123456

値が100以上のため，変換しない。

3

$変数名$FIXNUM=0.00

15

15.00

整数が指定した桁数（1桁）より多いため，整数は変換しない。

4

$変数名$FIXNUM=00

1

01

整数の足りない桁はゼロ埋めする。

5

1.5

01

小数が指定した桁数より多い場合は，小数以下は切り捨る。

6

$変数名$FIXNUM=00.000000

0.1234567

00.123456

小数第７位以降は切り捨てる。

7

$変数名$FIXNUM=.00

1

1.00

小数の足りない桁はゼロ埋めする。

8

$変数名$FIXNUM=00.

1

01

整数の足りない桁はゼロ埋めする。

9

$変数名$FIXNUM=ABC

1

1$FIXNUM=ABC

$FIXNUMの指定が不正なため，文字列として扱う。

10

$変数名$FIXNUM=0.00

ABC

ABC

$変数名の値が数値以外のため，変換しない。

11

0.0000000A

0.0000000A

1970/01/01からの経過秒数を年，月，日，時，分，秒の文字列に変換します。

マネージャーホストのタイムゾーンで変換します。

変数に格納されている値が0〜4,102,444,799の数値の文字列以外の場合，変換しません。

項番

指定形式

変換内容

1

$変数名$YEAR

1970/01/01からの経過秒数を年に変換する。

変換後はYYYY形式で出力する。出力する年数が４桁未満でもゼロ埋めして4桁にする。

2

$変数名$MONTH

1970/01/01からの経過秒数を月に変換する。

変換後はMM形式で出力する。出力する月が2桁未満でもゼロ埋めして2桁にする。

3

$変数名$DAY

1970/01/01からの経過秒数を日に変換する。

変換後はDD形式で出力する。出力する日が2桁未満でもゼロ埋めして2桁にする。

4

$変数名$HOUR

1970/01/01からの経過秒数を時に変換する。

変換後はhh形式で出力する。出力する時が2桁未満でもゼロ埋めして2桁にする。

時間は24時間表記で出力する。

5

$変数名$MIN

1970/01/01からの経過秒数を分に変換する。

変換後はmm形式で出力する。出力する分が2桁未満でもゼロ埋めして2桁にする。

6

$変数名$SEC

1970/01/01からの経過秒数を秒に変換する。

変換後はmm形式で出力する。出力する秒が2桁未満でもゼロ埋めして2桁にする。

フォーマット変換の機能は連続して指定できます。

連続してフォーマット変換の機能を指定した場合，左にあるフォーマット変換の指定から順に変換します。

先に実行したフォーマット変換が失敗した場合でも，後続のフォーマット変換の処理は実行されます。

図2‒11　連続したフォーマット変換

#コメント行

#で始まる行は，コメント扱いとなります。なお，JP1/IM - Viewから表示メッセージ変更定義を設定した場合，#のコメント行は削除されます。

定義例

イベントIDが100または200に一致，かつ重大度がWarningで，かつ登録ホストがhostA，hostB，hostCに一致する場合に，メッセージの先頭に日付時刻を付加して「DBサーバで障害が発生しました」に変更する例を次に示します。

DESC_VERSION=1
def 表示メッセージ変更1
    cmt コメント1
    define enable
    addflag false
    cnd
        B.ID IN 100 200
        E.SEVERITY IN Warning
        B.SOURCESERVER IN hostA hostB hostC
    end-cnd
    msg $EVDATE $EVTIME DBサーバで障害が発生しました
end-def

HntrログのメッセージID，メッセージテキスト部分を抽出する例を次に示します。

DESC_VERSION=1
def 表示メッセージ変更1
    cmt コメント1
    define enable
    addflag false
    cnd
        E.OBJECT_TYPE IN LOGFILE
        E.OBJECT_NAME SUBSTR HNTRLib2
        E.ROOT_OBJECT_TYPE IN LOGFILE
        E.PRODUCT_NAME IN /HITACHI/JP1/NT_LOGTRAP
        B.MESSAGE REGEX [0-9]{4}%20[0-9]{4}/[0-9]{2}/[0-9]{2}%20[0-9]{2}:[0-9]{2}:[0-9]{2}¥.[0-9]{3}[%20]+.*[%20]+[0-9A-Z]+%20[0-9A-Z]+[%20]+([^%20]+)[%20]+(.*)
    end-cnd
    msg $EVENV1 $EVENV2
end-def

特定プロダクトのメッセージの先頭に，一律で文字列を追加する例を次に示します。

DESC_VERSION=1
    def 表示メッセージ変更1
    cmt コメント1
    define enable
    addflag false
    cnd
        E.PRODUCT_NAME IN PRODUCT_A
    end-cnd
    msg [製品A]$EVMSG
end-def

表示メッセージ変更定義表示項目定義ファイル（chmsg_attr_list.conf）

形式

# コメント行
属性名
属性名
　・
　・
属性名

ファイル

chmsg_attr_list.conf（表示メッセージ変更定義表示項目定義ファイル）

chmsg_attr_list.conf.model（表示メッセージ変更定義表示項目定義ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Consoleパス¥conf¥chattr¥attr_list

論理ホストのとき

共有フォルダ¥jp1cons¥conf¥chattr¥attr_list

UNIXの場合

物理ホストのとき

/etc/opt/jp1cons/conf/chattr/attr_list

論理ホストのとき

共有ディレクトリ/jp1cons/conf/chattr/attr_list

説明

［表示メッセージ変更定義設定］画面の［属性名］表示領域に表示する項目を指定する定義ファイルです。表示メッセージ変更定義表示項目定義ファイルに指定された表示項目を指定された順番で［表示メッセージ変更定義設定］画面の［属性名］表示領域に表示します。

定義の反映時期

定義ファイルの内容は，セントラルコンソールの起動時，およびjco_spmd_reloadコマンドを実行して定義を再読み込みしたときに有効になります。

記述内容

#コメント行

#で始まる行は，コメント扱いとなります。

属性名

表示メッセージ変更定義表示項目定義ファイルには，［表示メッセージ変更定義設定］画面の［属性名］表示領域に表示する表示項目を指定します。表示項目は，表示項目に対応する属性名で1行に1件記述します。0〜256件の表示項目を指定できます。

英大文字・英小文字を区別します。属性名の両端に指定された空白（半角スペース）とタブ文字は無視されます。

SEPARATORを指定すると，［表示メッセージ変更定義設定］画面の［属性名］表示領域に「--------------------」を表示します。SEPARATORは，よく使う項目と，あまり使わない項目を分けるときに設定します。

ただし，SEPARATORだけを指定した場合は，［属性名］表示領域には，「--------------------」だけが表示されます。この場合，「--------------------」を選択しても，属性名は設定できません。

指定できる属性名を次の表に示します。

表2‒78　表示項目一覧

項番

表示項目

属性名

1

発生元ホスト名※

E.JP1_SOURCEHOST

2

登録ホスト名

B.SOURCESERVER

3

重大度

E.SEVERITY

4

オブジェクトタイプ

E.OBJECT_TYPE

5

オブジェクト名

E.OBJECT_NAME

6

登録名タイプ

E.ROOT_OBJECT_TYPE

7

登録名

E.ROOT_OBJECT_NAME

8

事象種別

E.OCCURRENCE

9

ユーザー名

E.USER_NAME

10

メッセージ

B.MESSAGE

11

プロダクト名

E.PRODUCT_NAME

12

イベントID

B.ID

13

送信先イベントサーバ名

B.DESTSERVER

14

固有の拡張属性

OTHER_EXTENDED_ATTRIBUTE

15

登録要因

B.REASON

16

発行元プロセスID

B.PROCESSID

17

発行元ユーザー名

B.USERNAME

18

発行元ユーザーID

B.USERID

19

発行元グループ名

B.GROUPNAME

20

発行元グループID

B.GROUPID

21

オブジェクトID

E.OBJECT_ID

22

終了コード

E.RESULT_CODE

23

--------------------

SEPARATOR

注

同じ属性名が複数指定されていた場合，その値は無視されます。

また，表示メッセージ変更定義表示項目定義ファイルが読み込めなかった場合，有効な表示項目が0件のときは，項番1〜22が表示されます。

注※

発生元ホストのマッピング機能が有効でない場合，［表示メッセージ変更定義設定］画面には表示されません。

定義例

E.JP1_SOURCEHOST
B.SOURCESERVER
E.SEVERITY
E.OBJECT_TYPE
E.OBJECT_NAME
E.ROOT_OBJECT_TYPE
E.ROOT_OBJECT_NAME
E.OCCURRENCE
E.USER_NAME
B.MESSAGE
E.PRODUCT_NAME
B.ID
B.DESTSERVER
OTHER_EXTENDED_ATTRIBUTE
B.REASON
B.PROCESSID
B.USERNAME
B.USERID
B.GROUPNAME
B.GROUPID
E.OBJECT_ID
E.RESULT_CODE

表示メッセージ変更定義自動入力定義ファイル（chmsg_auto_list.conf）

形式

# コメント行
[DEFAULT_NAME 表示メッセージ変更定義名]
属性名
属性名
　・
　・
属性名
属性名

ファイル

chmsg_auto_list.conf（表示メッセージ変更定義自動入力定義ファイル）

chmsg_auto_list.conf.model（表示メッセージ変更定義自動入力定義ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Consoleパス¥conf¥chattr¥auto_list

論理ホストのとき

共有フォルダ¥jp1cons¥conf¥chattr¥auto_list

UNIXの場合

物理ホストのとき

/etc/opt/jp1cons/conf/chattr/auto_list

論理ホストのとき

共有ディレクトリ/jp1cons/conf/chattr/auto_list

説明

［イベントコンソール］画面のイベント一覧でJP1イベントを選択後，［表示］−［表示メッセージ変更定義を設定］メニューを選択して［追加表示メッセージ変更定義設定］画面を開いたときに，自動で設定されるJP1イベント属性を定義するファイルです。また，表示メッセージ変更定義名のデフォルト名も定義できます。

定義の反映時期

定義ファイルの内容は，セントラルコンソールの起動時，およびjco_spmd_reloadコマンドを実行して定義を再読み込みしたときに有効になります。

記述内容

#コメント行

#で始まる行は，コメント扱いとなります。

DEFAULT_NAME 表示メッセージ変更定義名

表示メッセージ変更定義名を定義する識別子を表しています。識別子は，コメントと空行を除いたファイルの先頭に記述してください。

このパラメーターに指定した表示メッセージ変更定義名が，［イベントコンソール］画面のイベント一覧でJP1イベントを選択後，［表示］−［表示メッセージ変更定義を設定］を選択して［追加表示メッセージ変更定義設定］画面を開いたときに，初期値として表示されます。

40バイトまでの文字列で指定します。指定できる文字は，制御文字（0x00〜0x1F，0x7F〜0x9F）以外の文字列です。40バイトを超えて指定した場合，41バイト以上の文字列を切り捨てた文字列が表示メッセージ変更定義名となります。指定しなかった場合，「追加表示メッセージ変更定義」が表示メッセージ変更定義名となります。

属性名

表示メッセージ変更定義自動入力定義ファイルには，［イベントコンソール］画面のイベント一覧でJP1イベントを選択後，［表示］−［表示メッセージ変更定義を設定］を選択して［追加表示メッセージ変更定義設定］画面を開いたときに，イベント条件として設定されるJP1イベントの属性を指定します。このパラメーターに指定した属性名の条件が，［イベントコンソール］画面のイベント一覧でJP1イベントを選択後，［表示］−［表示メッセージ変更定義を設定］を選択して［追加表示メッセージ変更定義設定］画面を開いたときに，初期値として表示されます。

定義項目は，設定されるJP1イベントの属性名を1行に1件記述します。

英大文字・英小文字を区別します。属性名の両端に指定された空白（半角スペース）とタブ文字は無視されます。

有効な属性名が0件のときは，KAVB1952-Wメッセージを統合トレースログに出力し，デフォルト値項目を使用します。

同じ属性名が複数指定されていた場合，その値は無視し，KAVB1954-Wメッセージを統合トレースログに出力します。

［表示メッセージ変更定義設定］画面の［イベント条件］に自動的に表示されるJP1イベントの属性の順序は，表示メッセージ変更定義自動入力定義ファイル（chmsg_auto_list.conf）の属性の記載順に設定されます。

指定できる属性名でない場合は，KAVB1953-Wメッセージを統合トレースログに出力し，その属性名を無視されます。

指定できる属性名を次の表に示します。

表2‒79　表示項目一覧

項番

表示項目

属性名

1

発生元ホスト名※

E.JP1_SOURCEHOST

2

登録ホスト名

B.SOURCESERVER

3

重大度

E.SEVERITY

4

オブジェクトタイプ

E.OBJECT_TYPE

5

オブジェクト名

E.OBJECT_NAME

6

登録名タイプ

E.ROOT_OBJECT_TYPE

7

登録名

E.ROOT_OBJECT_NAME

8

事象種別

E.OCCURRENCE

9

ユーザー名

E.USER_NAME

10

メッセージ

B.MESSAGE

11

プロダクト名

E.PRODUCT_NAME

12

イベントID

B.ID

13

送信先イベントサーバ名

B.DESTSERVER

14

登録要因

B.REASON

15

発行元プロセスID

B.PROCESSID

16

発行元ユーザー名

B.USERNAME

17

発行元ユーザーID

B.USERID

18

発行元グループ名

B.GROUPNAME

19

発行元グループID

B.GROUPID

20

オブジェクトID

E.OBJECT_ID

21

終了コード

E.RESULT_CODE

注

同じ属性名が複数指定されていた場合，その値は無視されます。

また，表示メッセージ変更定義自動入力定義ファイルが読み込めなかった場合，有効な表示項目が0件のときは，項番1〜3，項番10〜12が表示されます。

注※

発生元ホストのマッピング機能が有効でない場合，［追加表示メッセージ変更定義設定］画面には表示されません。

定義例

DEFAULT_NAME 表示メッセージ変更定義名
E.JP1_SOURCEHOST
B.SOURCESERVER
E.SEVERITY
B.MESSAGE
E.PRODUCT_NAME
B.ID

表示メッセージ変更後イベント環境定義ファイル（chmsgevent.conf）

形式

[論理ホスト名¥JP1CONSOLEMANAGER]
"SEND_CHANGE_MESSAGE_EVENT"=dword:16進数値

ファイル

chmsgevent.conf.update（表示メッセージ変更後イベント環境定義ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

Consoleパス¥default¥

UNIXの場合

/etc/opt/jp1cons/default/

説明

表示メッセージ変更した後にイベントを発行する機能の実行環境の情報を定義するファイルです。機能を有効にするかどうかを指定します。

必要な定義内容をモデルファイルとして提供しています。設定を変更する場合は，モデルファイルをコピーして，定義ファイル（Windowsの場合Consoleパス¥conf¥chmsgevent.conf，UNIXの場合/etc/opt/jp1cons/conf/chmsgevent.conf）にリネームしたあと，内容を編集してください。

定義の反映時期

JP1/Baseのjbssetcnfコマンドで，表示メッセージ変更後イベント環境定義ファイルをJP1共通定義情報に反映した後に，JP1/IM - Managerを再起動すると有効になります。

記述内容

[論理ホスト名¥JP1CONSOLEMANAGER]

JP1/IM - Managerの環境設定のキー名称を示します。

"論理ホスト名"の部分を，物理ホストの場合はJP1_DEFAULTに，論理ホストの場合は論理ホスト名に設定します。

"SEND_CHANGE_MESSAGE_EVENT"=dword:16進数値

表示メッセージ変更した後にイベントを発行する機能を有効にするかどうかを指定します。

00000001：有効（表示メッセージ変更した後にイベントを発行する）

00000000：無効（表示メッセージ変更した後にイベントを発行しない）

デフォルトは「00000000」（無効）です。

定義例

[JP1_DEFAULT¥JP1CONSOLEMANAGER]
"SEND_CHANGE_MESSAGE_EVENT"=dword:00000000

WWWページ呼び出し定義ファイル（hitachi_jp1_製品名.html）

形式

<HTML>
<HEAD>
<META HTTP-EQUIV="refresh" CONTENT="0;URL=他製品のWWWページのURL">
</HEAD>
</HTML>

ファイル

hitachi_jp1_製品名.html（WWWページ呼び出し定義ファイル）

hitachi_jp1_製品名.html.model（WWWページ呼び出し定義ファイルのモデルファイル）

格納先ディレクトリ

Viewパス¥conf¥webdata¥ja¥

説明

統合機能メニューから他製品のWWWページを呼び出すときに使用するファイルです。

統合機能メニューから他製品のWWWページを呼び出す場合，いったんWWWページ呼び出し定義ファイルを参照し，このファイルで定義されているURLにジャンプするようになっています。ユーザーは，他製品のWWWページを統合機能メニューから呼び出す場合，自分の環境に合わせてこのファイルに記述されたURLを編集する必要があります。

なお，URLの編集をせずに統合機能メニューからWWWページを表示しようとすると，設定方法を記述したページが表示されます。

WWWページ呼び出し定義ファイル一覧

JP1/IMでは，次の表に示す定義ファイルを提供しています。連携製品の対応バージョン，および対応OSの詳細については，各連携製品のマニュアルをご確認ください。

表2‒80　統合機能メニューの名称と対応するWWWページ呼び出し定義ファイル一覧

統合機能メニューのメニュー項目

WWWページ呼び出し定義ファイル名

製品名

フォルダ名

サブフォルダ名

機能名

ネットワーク管理

−

ネットワークノードマネージャー

hitachi_jp1_cm2.html

JP1/Cm2/NNM

HP NNM

資産・配布管理

−

統合資産管理

hitachi_jp1_assetinfomationmanager.html

JP1/NETM/Asset Information Manager

−

資産・配布管理※

hitachi_jp1_netmdm.html

JP1/NETM/DM Manager

ストレージ管理

ストレージエリア管理

ストレージシステム稼働管理

hitachi_jp1_hicommand_tuning_manager.html

JP1/HiCommand Tuning Manager

ストレージハードウェア管理

hitachi_jp1_hicommand_device_manager.html

JP1/HiCommand Device Manager

ストレージリソース割り当て管理

hitachi_jp1_hicommand_provisioning_manager.html

JP1/HiCommand Provisioning Manager

ストレージレプリケーション管理

hitachi_jp1_hicommand_replication_manager.html

Hitachi Replication Manager

階層ストレージリソース管理

hitachi_jp1_hicommand_tiered_storage_manager.html

JP1/HiCommand Tiered Storage Manager

グローバル入出力パス稼働管理

hitachi_jp1_hicommandGLAM.html

JP1/HiCommand Global Link Availability Manager

サーバ管理

−

Webコンソール

hitachi_jp1_systemmanager.html

JP1/Server Conductor

（凡例）

−：なし

注※

Windows版のJP1/IM - Viewでは，JP1/NETM/DM ManagerのWWWページ版との連携はできません。JP1/NETM/DMは日本国内の製品名称です。

［WWWページ呼び出し定義ファイル名］列に記載しているhtmlファイルに記述されたURLを各製品のWWWページのURLに変更することで，［統合機能メニュー］画面からほかの製品のWWWページを起動できるようになります。

定義の反映時期

JP1/IM - Viewを再起動すると，有効になります。

記述内容

<META HTTP-EQUIV="refresh" CONTENT="0;URL=他製品のWWWページのURL">

他製品のWWWページのURLを指定します。

なお，URLの編集をせずに統合機能メニューから他製品のWWWページを表示しようとすると，設定方法を記述したページ※（Viewパス¥conf¥webdata¥ja¥webconfig_hitachi_jp1_製品名.html）が表示されます。このページを参考にしてURLを指定してください。

注※

・このページに記述されたURLは標準的な値です。製品によってはユーザーがURLをカスタマイズできるものがあるため，他製品側で使用しているURLを事前にご確認ください。

また，他製品のバージョンアップなどによってURLが変更になる場合があります。URLを設定しても画面が起動されない場合には，各製品のマニュアルなどをご確認ください。

・「ホスト名」には，WWWページに対応する製品をインストールしたマシンのホスト名またはIPアドレスを指定してください。

定義例

<HTML>
<HEAD>
<META HTTP-EQUIV="refresh" CONTENT="0;URL=http://hostA/OvCgi/ovlaunch.exe">
</HEAD>
</HTML>

統合機能メニュー定義ファイル

形式

@file type="定義ファイルタイプ", version="定義フォーマットバージョン";
#コメント行
@define-block type="function-tree-def";
フォルダ定義
機能定義
@define-block-end;

ファイル

!JP1_CC_FTREE0.conf（統合機能メニュー定義ファイル）

!JP1_CC_FTREE0.conf.model（統合機能メニュー定義ファイルのモデルファイル）

格納先ディレクトリ

Viewパス¥conf¥function¥ja¥

説明

統合機能メニュー定義ファイルは，JP1/IM - Viewの［統合機能メニュー］画面に表示するツリー構造や表示項目などを定義するためのファイルです。

なお，JP1/IMには，統合機能メニュー定義ファイルの記述内容をチェックするためのコマンド「jcofuncfcheck」が用意されています。このコマンドの詳細については，「jcofuncfcheck（Windows限定）」（1.　コマンド）を参照してください。

定義の反映時期

JP1/IM - Viewを再起動したあとに有効になります。

記述内容

@file type="function-definition"

この定義ファイルが統合機能メニュー定義ファイルであることを宣言します。このステートメントは必須です。

常にfunction-definitionを指定してください。

このステートメントは，ファイル内の先頭行に記述しなければなりません。

version="0300";

常に0300を指定してください。

#コメント行

#で始まる行は，コメント扱いとなります。

@define-block type="function-tree-def"; 〜 @define-block-end;（統合機能メニュー定義ブロック）

［統合機能メニュー］画面に表示するフォルダまたは機能を作成し，機能が選択されたときに実行するアプリケーションとの関連をアプリケーション実行定義識別子で定義します。

なお，［統合機能メニュー］画面に表示される機能の順序はファイル名順になります。一つのファイル内では，定義ブロック順になります。メニューの表示順序を変更したい場合は，これらの順序を変更してください。

このブロックに記述できるステートメントは，フォルダを定義する場合と機能を定義する場合で異なります。

表2‒81　ステートメント

フォルダを定義する場合

機能を定義する場合

idステートメント

parent_idステートメント

nameステートメント

idステートメント

parent_idステートメント

nameステートメント

execute_idステートメント

iconステートメント

argumentsステートメント

これ以外のステートメントが記述された場合は，エラー出力され，該当するステートメントだけが無視されます。

次に，ステートメントについて説明します。

id="メニュー識別子";

機能ツリーメニュー定義ブロックのメニュー識別子を定義します。このステートメントは必須です。このステートメントはブロック内に1回だけ記述できます。

同一の「id」を持つブロックが解析対象のファイル内に複数個存在した場合，次の順に優先順位が決定され，最優先のブロックが有効になります。

1. ファイル名を昇順でソートしてあとの方のブロック

2. ファイル内の位置があとの方のブロック

それ以外のブロックは無効になります。

メニュー識別子には，32バイト以内の半角英数字を指定できます。この文字列は，統合機能メニュー定義ファイル内でユニークでなければなりません。ユニーク性を保持するために，次の命名規則に従ってください。

・フォルダを定義する場合

会社名[_製品名]

・機能を定義する場合

会社名_製品名[_機能名(または画面名)]

適切なフォルダ名称がすでに存在している場合は，フォルダを新規に追加しないで，定義ファイル格納場所のほかの定義ファイルに記述してあるフォルダを使用してください。

「"root"」は最上位のメニュー識別子として予約されているため，使用できません。

「"jco_"」で始まる文字列はアプリケーション実行識別子として予約されているため，使用できません。

parent_id="親メニュー識別子";

自メニュー識別子に対して，ツリー構造上の上位にあるrootまたはメニュー識別子を指定します。階層は，rootを含めて3階層まで指定できます。このステートメントは必須です。このステートメントはブロック内に1回だけ記述できます。

複数の親メニュー識別子を指定して複数の上位フォルダを持つことはできません。

name="表示名称";

［統合機能メニュー］画面に表示する名称を定義します。このステートメントは必須です。このステートメントはブロック内に1回だけ記述できます。

表示名称には，［統合機能メニュー］画面上に表示される文字列を指定します。文字列には日本語文字を含めることができます。内容のわかりやすい簡潔な表示名称を指定してください。

指定した値はメニュー上に表示されるため，名詞にすることをお勧めします。例えば，「コマンド実行機能」などの文字列にします。

指定する値は，定義内でユニークでなくてもかまいませんが，操作性を考えてユニークにすることをお勧めします。

execute_id="アプリケーション実行定義識別子";

統合機能メニューに表示される機能をダブルクリックしたときに実行するアプリケーション実行定義識別子を指定します。このステートメントは機能を指定する場合は必須です。このステートメントは，ブロック内で1回だけ指定できます。

execute_idパラメーターには「"default_browser"」を指定してデフォルトのブラウザーを起動できます。また，execute_idパラメーターに「"default_browser"」を指定する場合は，argumentsパラメーターにURLを記載します。

フォルダを作成する場合は，このステートメントを指定しても無視されます。

指定したアプリケーション実行定義識別子が存在しない場合，メニューは表示されません。

「"jco_"」で始まる文字列はアプリケーション実行定義識別子として予約されているため，使用できません。

icon="表示アイコンファイル名";

［統合機能メニュー］画面に表示するアイコンを指定します。アイコンは，GIFファイルのファイル名称をフルパスで指定します。GIFファイルの推奨サイズは16×16ピクセルです。それ以外のサイズはリサイズして表示します。

このステートメントは，機能を指定する場合にだけ使用できます。

フォルダを作成する場合は，このステートメントを指定しても無視されます。

このステートメントが省略された場合は，共通のアイコンが使用されます。

arguments="コマンド引数";

execute_idで指定したアプリケーションに対する引数を指定します。このステートメントは，機能を指定する場合にだけ使用できます。このステートメントは，ブロック内で1回だけ指定できます。

argumentsには，ビューアーの動作環境属性で置き換える予約キーワードや，レジストリーの値から置き換える置換文字列も使用できます。置換文字列の詳細については，「アプリケーション実行定義ファイル」（2.　定義ファイル）の「置換文字列」を参照してください。

フォルダを作成する場合は，このステートメントを指定しても無視されます。

execute_idで指定した実行形式ファイルへのフルパスと，置換文字列を置換したあとのargumentsは，1個の半角スペースを付加して連結されます。

argumentsは，コマンド引数の前後の「"」を外して連結されます。

このときのコマンドラインの長さが1,024文字を超えた場合は，実行できません。

アプリケーションに半角スペースを含む文字列を引数として指定したい場合は，「arguments=""文字列""」のように「"」で囲んだコマンド引数を指定してください。

コマンドラインにはコマンド引数の前後の「"」を外して連結されるため，

統合機能メニューでMicrosoft Edgeを起動する場合，置換文字列を置換したあとのargumentsに半角スペースが含まれると意図しない動作となる場合があります。

半角スペースを含む文字列を引数として指定したい場合は，「arguments=""文字列""」のように「"」で囲んだ文字列を指定してください。

機能ツリーメニューブロックの定義例を次に示します。

@define-block type="function-tree-def";

id="hitachi_jp1";

parent_id="root";

name="サンプル管理";

@define-block-end;

@define-block type="function-tree-def";

id="hitachi_jp1_seihin_sample";

parent_id="hitachi_jp1";

name="サンプル画面";

icon="sample.gif";

execute_id="hitachi_jp1_seihin_sample_execute";

arguments="node_map";

@define-block-end;

定義例

統合機能メニュー定義ファイルの定義例を次に示します。

#
# All Rights Reserved, Copyright (C) 2000, Hitachi, Ltd.
#
@file type="function-definition", version="0300";
#----------------------------------------------------------
@define-block type="function-tree-def";
id="jco_folder_Network";
parent_id="root";
name="ネットワーク管理";
@define-block-end;
#----------------------------------------------------------
@define-block type="function-tree-def";
id="jco_JP1_Cm2";
parent_id="jco_folder_Network";
name="ネットワーク管理";
icon="%JCO_INSTALL_PATH%¥image¥menu¥cm2_manager.gif";
execute_id="default_browser";
arguments="%JCO_INSTALL_PATH%¥conf¥webdata¥ja¥hitachi_jp1_cm2.html";
@define-block-end;
#----------------------------------------------------------
@define-block type="function-tree-def";
id="jco_folder_JobSystemOperation";
parent_id="root";
name="ジョブシステム運用";
@define-block-end;
#----------------------------------------------------------
@define-block type="function-tree-def";
id="jco_JP1_AJS2";
parent_id="jco_folder_JobSystemOperation";
name="ジョブシステム運用";
icon="%JCO_INSTALL_PATH%¥image¥menu¥ajs2_manager.gif";
execute_id="jco_JP1_AJS2";
arguments="-t "%JCO_JP1TOKEN%"";
@define-block-end;
#----------------------------------------------------------

コマンドボタン定義ファイル（cmdbtn.conf）

形式

DESC_VERSION=ファイルバージョン

# コメント行
def
  [usr 対象ユーザー名 対象ユーザー名 …]

  btn ［コマンド］ボタン名
    [cmt ［コマンド］ボタンのコメント]
    [cmdtype {agent|client}]
    [inev {true|false}]
    [hst 実行ホスト名]
    cmd コマンドライン
    [var 環境変数ファイル名]
    [qui {true|false}]
    [preview {true|false}]
  end-btn
  ：
  ：
end-def
：
：

ファイル

cmdbtn.conf

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Consoleパス¥conf¥console¥rmtcmd¥

論理ホストのとき

共有フォルダ¥jp1cons¥conf¥console¥rmtcmd¥

UNIXの場合

物理ホストのとき

/etc/opt/jp1cons/conf/console/rmtcmd/

論理ホストのとき

共有ディレクトリ/jp1cons/conf/console/rmtcmd/

ファイルの権限

Windowsの場合

AdministratorsグループおよびSYSTEMユーザー

UNIXの場合

root権限を持つユーザー

説明

［コマンド実行］画面に表示する［コマンド］ボタンを定義するファイルです。コマンドボタン定義ファイルの最大ファイルサイズは，10メガバイトです。なお，使用できるコマンドボタン定義が複数ある場合は，コマンドボタン定義ファイルの先頭に近い定義内容が表示されます。

定義の反映時期

［コマンド］ボタン定義の内容は，jcoimdefコマンドを実行して［コマンド］ボタンが有効な場合に，［コマンド実行］画面を表示するときに反映されます。

なお，JP1/IM - Viewを起動中に［コマンド］ボタン定義の内容を変更した場合は，JP1/IM - Viewの再起動が必要です。

記述内容

DESC_VERSION=ファイルバージョン

コマンドボタン定義ファイルの形式のバージョンを指定します。指定する値は1または2です。クライアントアプリケーションまたはイベント情報の引き継ぎ機能を使用する場合は，2を指定します。2を指定すると，次のパラメーターを指定できます。

cmdtype

inev

preview

ファイルバージョンを省略した場合や1または2以外の数値を指定した場合は，1が仮定されます。

#コメント行

#で始まる行は，コメント扱いとなります。

def〜end-def（定義ブロック）

コマンドボタン定義の開始と終了のパラメーターです。64個まで指定できます。

[usr 対象ユーザー名 対象ユーザー名 …]

［コマンド］ボタンを使用するJP1ユーザー名を指定します。対象ユーザー名に指定できる文字数は，1〜31バイトです。半角英数字だけを使用できます。英字は大文字・小文字を区別しません。複数指定する場合は，一つ以上の連続した半角スペースまたはタブを対象ユーザー名と対象ユーザー名の間に挿入して区切ります。複数指定では，100個まで指定できます。101個目以降の対象ユーザー名は無視されます。省略した場合，すべてのJP1ユーザーを対象ユーザーとします。def〜end-defの間に1個指定できます。btn〜end-btnの間には指定できません。

btn ［コマンド］ボタン名〜end-btn

［コマンド］ボタンの開始と終了パラメーターです。［コマンド］ボタン名は，［コマンド］ボタンの名称として［コマンド実行］画面の上に表示されます。一つの［コマンド］ボタン名に対して，8文字まで指定できます。指定できる文字は，制御文字（0x00〜0x1F，0x7F〜0x9F）以外の文字列です。大文字・小文字は区別します。［コマンド］ボタンは，定義ブロックの中に16個まで定義できます。重複した［コマンド］ボタン名は指定できません。［コマンド］ボタン名が最大文字数を超える場合，または［コマンド］ボタン名が重複している場合，その［コマンド］ボタン名は読み込めません。

[cmt ［コマンド］ボタンのコメント]

［コマンド］ボタンの説明を記述します。コメントは，ツールチップとして表示されます。このパラメーターは省略できます。コメントは40文字まで指定できます。41文字以降の文字は無視されます。指定できる文字は，すべての文字です。

[cmdtype {agent|client}]

［コマンド］ボタンで実行するコマンドの種類を指定します。管理対象ホストのコマンド，またはクライアントアプリケーションのどちらのコマンドなのかを選択します。クライアントアプリケーションは，クライアントアプリケーション実行機能で実行されます。このパラメーターを指定する場合は，DESC_VERSIONに2を指定してください。

エージェントまたはマネージャーホストでコマンドを実行する場合，agentパラメーターを指定します。クライアントアプリケーションを実行する場合，clientを指定します。

cmdtypeにclientを指定した場合は，hstおよびvarパラメーターを指定できません。

agentまたはclientは，大文字・小文字を区別しません。

[inev {true|false}]

［コマンド］ボタンを使用してイベント情報を引き継ぐかどうかを指定します。このパラメーターを指定する場合は，DESC_VERSIONに2を指定してください。

［コマンド］ボタンをクリックしたときに指定したイベント情報を引き継いでコマンドを実行させる場合はtrue，実行させない場合はfalseを指定します。省略した場合，falseが指定されます。

trueまたはfalseは，大文字・小文字を区別しません。

[hst 実行ホスト名]

コマンドを実行するホスト名を指定します。実行ホスト名には，ホスト名，ホストグループ名，業務グループ名，および監視グループ名を指定できます。

ホスト名，ホストグループ名には，最大255バイトの文字列を指定できます。業務グループ名，監視グループ名には，最大2,048バイトの文字列を指定できます。このパラメーターは省略できます。

統合監視DBおよびIM構成管理DBが有効な場合に，パス表記で業務グループ名を指定できます。

統合監視DBおよびIM構成管理DBが無効な場合，パス表記で業務グループ名を指定しても，ホスト名またはホストグループ名として扱われます。

イベント引き継ぎ情報は，変数で指定します。指定できるイベント引き継ぎ情報については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「4.19.5(1)　指定できるイベント引き継ぎ情報」を参照してください。イベント引き継ぎ情報を指定する場合は，inevパラメーターにtrueを指定してください。イベント引き継ぎ情報を指定する場合は，変数をJP1イベントの情報に置き換えたあとの文字列の長さが，実行ホスト名の最大バイト数以下になるように指定してください。置き換えたあとの文字列の長さが実行ホスト名の最大バイト数を超える場合は，最大バイト数に収まるように切り捨てられた文字列が実行ホスト名に指定されます。

cmd コマンドライン

実行するコマンドを指定します。コマンドラインは4,096バイトまで指定できます。このパラメーターは省略できません。

イベント引き継ぎ情報は，変数で指定します。イベント引き継ぎ情報を指定する場合は，inevパラメーターにtrueを指定してください。イベント引き継ぎ情報を指定する場合は，変数をJP1イベントの情報に置き換えたあとの文字列の長さが，コマンドラインの最大バイト数以下になるように指定してください。置き換えたあとの文字列の長さがコマンドラインの最大バイト数を超える場合は，最大バイト数に収まるように切り捨てられた文字列が環境変数ファイルに指定されます。

[var 環境変数ファイル名]

実行するコマンドの環境変数を指定した環境変数ファイルのファイル名を指定します。このパラメーターは省略できます。環境変数ファイルの形式については，マニュアル「JP1/Base 運用ガイド」を参照してください。環境変数ファイル名は255バイト以内の文字列で指定します。環境変数ファイル名が最大バイト数を超える場合は，コマンドボタンを読み込みません。

イベント引き継ぎ情報は，変数で指定します。イベント引き継ぎ情報を指定する場合は，inevパラメーターにtrueを指定してください。イベント引き継ぎ情報を指定する場合は，変数をJP1イベントの情報に置き換えたあとの文字列の長さが，環境変数ファイルの最大バイト数以下になるように指定してください。置き換えたあとの文字列の長さが環境変数ファイルの最大バイト数を超える場合は，最大バイト数に収まるように切り捨てられた文字列が環境変数ファイルに指定されます。

[qui {true|false}]

［コマンド］ボタンを使用してコマンドを実行する前に，コマンドを実行してもよいか確認するメッセージを表示させるかどうかを指定します。確認するメッセージを表示させないと，［コマンド］ボタンをクリックすると同時にコマンドが実行されます。

確認するメッセージを表示させない場合はtrue，表示させる場合はfalseを指定します。省略した場合，falseが指定されます。ただし，previewパラメーターにtrueを指定した場合は，［コマンド実行内容プレビュー］画面が表示されます。

trueまたはfalseは，大文字・小文字を区別しません。

[preview {true|false}]

［コマンド］ボタンを使用してイベント情報を引き継ぐ場合，引き継ぎ後のコマンド実行内容をプレビューで確認するかどうかを設定するパラメーターです。このパラメーターを指定する場合は，DESC_VERSIONに2を指定してください。

プレビューを表示させる場合はtrue，表示させない場合はfalseを指定します。省略した場合，trueが指定されます。

trueまたはfalseは，大文字・小文字を区別しません。

このパラメーターは，inevパラメーターがfalseの場合は無視されます。

previewパラメーターにfalse，quiパラメーターにtrueを指定した場合は，コマンドボタンをクリックすると同時にコマンドが実行されます。［コマンド実行内容プレビュー］画面およびコマンド実行の確認メッセージは表示されません。

定義例

DESC_VERSION=2

def
# ビューアーホストでコマンドを実行する。
# 実行コマンドにイベント引き継ぎ情報を指定する。
# 実行前にプレビュー画面を表示する。
  btn App1
    cmt App1を実行します。
    cmdtype client
    inev true
    cmd C:¥kansi¥app1.exe $EVIDBASE $EVSEQNO "$EVMSG"
  end-btn

# ビューアーホストでコマンドを実行する。
# 実行コマンドにイベント引き継ぎ情報を指定する。
# 実行前に確認ダイアログを表示する。プレビュー画面は表示しない。
  btn App2
    cmt App2を実行します。
    cmdtype client
    inev true
    cmd C:¥kansi¥app2.exe $EVIDBASE $EVSEQNO "$EVMSG"
    preview false
  end-btn

# ビューアーホストでコマンドを実行する。
# 実行コマンドにイベント引き継ぎ情報を指定する。
# 実行前に確認ダイアログもプレビュー画面も表示しない。
  btn App3
    cmt App3を実行します。
    cmdtype client
    inev true
    cmd C:¥kansi¥app3.exe $EVIDBASE $EVSEQNO "$EVMSG"
    qui true
    preview false
  end-btn

# エージェントまたはマネージャーホストでコマンドを実行する。
# 実行コマンドにイベント引き継ぎ情報を指定する。
# 実行前にプレビュー画面を表示する。
  btn Cmd1
    cmt cmd1を実行します。
    cmdtype agent
    inev true
    hst $EVHOST
    cmd /kansi/cmd1 $EVIDBASE $EVSEQNO '$EVMSG'
  end-btn

# エージェントまたはマネージャーホストでコマンドを実行する。
# 実行コマンドにイベント引き継ぎ情報は指定しない。
# 実行前に確認ダイアログを表示する。
  btn Cmd2
    cmt cmd2を実行します。
    hst agent2
    cmd /kansi/cmd2
  end-btn

end-def

起動プログラム定義ファイル（!JP1_CS_APP0.conf）

形式

@define-block type="application-execution-def";
id="プログラム識別子";
path="起動プログラムのパス";
@define-block-end;

ファイル

!JP1_CS_APP0.conf（起動プログラム定義ファイル）

!JP1_CS_APP0.conf.model（起動プログラム定義ファイルのモデルファイル）

格納先ディレクトリ

Viewパス¥conf¥sovtoolexec¥ja¥

説明

監視ツリー画面のツールバーに追加するプログラムの起動パスを定義するファイルです。

なお，監視ツリー画面のツールバーにプログラムを追加し，ツールバーからそのプログラムを起動するには，次の定義ファイルも編集する必要があります。

ツールバー定義ファイル

アイコン動作定義ファイル

定義の反映時期

監視ツリー画面を再起動すると有効になります。

記述内容

@define-block type〜@define-block-end;

@define-block type〜@define-block-end;で一つの定義ブロックとなります。監視ツリー画面のツールバーにプログラムを複数追加する場合は，この定義ブロックを複数記述します。この定義ブロックに記述できるパラメーターを次に示します。

id="プログラム識別子"

起動するプログラムを表す識別子を指定します。指定できるのは，32バイト以内の半角英数字で構成される文字列です。この文字列は定義ファイル内でユニークである必要があります。また，このパラメーターで指定するプログラム識別子は，アイコン動作定義ファイル（!JP1_CS_FTREE0.conf）で指定するプログラム識別子と同一にする必要があります。アイコン動作定義ファイル（!JP1_CS_FTREE0.conf）の詳細については，「アイコン動作定義ファイル（!JP1_CS_FTREE0.conf）」（2.　定義ファイル）を参照してください。

path="起動プログラムのパス"

起動するプログラムのパスを指定します。指定できる実行形式ファイルは，.exeまたは.batファイルです。

定義例

#
# All Rights Reserved. Copyright (C) 2003, Hitachi, Ltd.
#
@file type="application-execution-definition", version="0300";
#----------------------------------------------------------
@define-block type="application-execution-def";
id="app_notepad";
path="C:¥WINNT¥NOTEPAD.EXE";
@define-block-end;
#----------------------------------------------------------

ツールバー定義ファイル（!JP1_CS_FTOOL0.conf）

形式

@define-block type="function-toolbar-def";
toolbar="sov_JP1_IM_Central_Console|sov_JP1_IM_Function_Tree|sov_JP1_IM_Visual_View|sov_JP1_IM_Bmv_Help|アイコン識別子...";
@define-block-end;

ファイル

!JP1_CS_FTOOL0.conf（ツールバー定義ファイル）

!JP1_CS_FTOOL0.conf.model（ツールバー定義ファイルのモデルファイル）

格納先ディレクトリ

Viewパス¥conf¥sovtoolitem¥ja¥

説明

監視ツリー画面のツールバーに追加するプログラムの並び順を定義するファイルです。

なお，監視ツリー画面のツールバーにプログラムを追加し，ツールバーからそのプログラムを起動するには，次の定義ファイルも編集する必要があります。

起動プログラム定義ファイル

アイコン動作定義ファイル

定義の反映時期

監視ツリー画面を再起動すると有効になります。

記述内容

@define-block type〜@define-block-end;

@define-block type〜@define-block-end;で一つの定義ブロックとなります。定義ファイル中一つしか定義できません。

toolbar="sov_JP1_IM_Central_Console|sov_JP1_IM_Function_Tree|sov_JP1_IM_Visual_View|sov_JP1_IM_Bmv_Help|アイコン識別子";

アイコンを表す識別子は「|」で区切られ，この記載順序に従ってアイコンは，［監視ツリー］画面で左から並んで表示されます。識別子として指定できるのは，32バイト以内の半角英数字で構成される文字列です。この文字列は定義ファイル内でユニークである必要があります。また，このパラメーターで指定するアイコン識別子は，アイコン動作定義ファイル（!JP1_CS_FTREE0.conf）で指定するアイコン識別子と同一にする必要があります。アイコン動作定義ファイル（!JP1_CS_FTREE0.conf）の詳細については，「アイコン動作定義ファイル（!JP1_CS_FTREE0.conf）」（2.　定義ファイル）を参照してください。

定義例

#
# All Rights Reserved. Copyright (C) 2003, Hitachi, Ltd.
#
@file type="function-definition", version="0300";
#----------------------------------------------------------
@define-block type="function-toolbar-def";
toolbar="sov_JP1_IM_New_Info|sov_JP1_IM_Visual_View|sov_JP1_IM_Function_Tree|sov_JP1_IM_Central_Console|sov_JP1_IM_Bmv_Help|tool_notepad";
@define-block-end;
#----------------------------------------------------------

アイコン動作定義ファイル（!JP1_CS_FTREE0.conf）

形式

@define-block type="function-tree-def";
id="アイコン識別子";
name="ツールチップ";
iconstandard="アイコン格納パス";
icondown="アイコン格納パス";
iconrollover="アイコン格納パス";
icondisable="アイコン格納パス";
execute_id="プログラム識別子";
arguments="引数";
@define-block-end;

ファイル

!JP1_CS_FTREE0.conf（アイコン動作定義ファイル）

!JP1_CS_FTREE0.conf.model（アイコン動作定義ファイルのモデルファイル）

格納先ディレクトリ

Viewパス¥conf¥sovtoolitem¥ja¥

説明

監視ツリー画面のツールバーに表示するアイコンの動作を定義するファイルです。

なお，監視ツリー画面のツールバーにプログラムを追加し，ツールバーからそのプログラムを起動するには，次の定義ファイルも編集する必要があります。

起動プログラム定義ファイル

ツールバー定義ファイル

定義の反映時期

監視ツリー画面を再起動すると有効になります。

記述内容

@define-block type〜@define-block-end;

@define-block type〜@define-block-end;で一つの定義ブロックとなります。

監視ツリー画面のツールバーにプログラムを複数追加する場合は，この定義ブロックを複数記述します。この定義ブロックに記述できるパラメーターを次に示します。

id="アイコン識別子";

アイコンを表す識別子を指定します。識別子として指定できるのは，32バイト以内の半角英数字で構成される文字列です。この文字列は定義ファイル内でユニークである必要があります。また，このパラメーターで指定するアイコン識別子は，ツールバー定義ファイル（!JP1_CS_FTOOL0.conf）で指定するアイコン識別子と同一にする必要があります。ツールバー定義ファイル（!JP1_CS_FTOOL0.conf）の詳細については，「ツールバー定義ファイル（!JP1_CS_FTOOL0.conf）」（2.　定義ファイル）を参照してください。

name="ツールチップ";

カーソルをアイコンの上に置いたときに表示されるツールチップを指定します。

iconstandard="アイコン格納パス";

通常時に表示されるアイコンをフルパスで指定します。

icondown="アイコン格納パス";

アイコンをクリックしたときに表示されるアイコンをフルパスで指定します。

iconrollover="アイコン格納パス";

カーソルをアイコンの上に移動したときに表示されるアイコンをフルパスで指定します。

icondisable="アイコン格納パス";

そのプログラムが起動できない場合に表示されるアイコンをフルパスで指定します。

execute_id="プログラム識別子";

起動するプログラムを表す識別子を指定します。識別子として指定できるのは，32バイト以内の半角英数字で構成される文字列です。この文字列は定義ファイル内でユニークである必要があります。また，このパラメーターで指定するプログラム識別子は，起動プログラム定義ファイル（!JP1_CS_APP0.conf）で指定するプログラム識別子と同一にする必要があります。起動プログラム定義ファイル（!JP1_CS_APP0.conf）の詳細については，「起動プログラム定義ファイル（!JP1_CS_APP0.conf）」（2.　定義ファイル）を参照してください。

arguments="引数";

起動プログラム定義ファイル（!JP1_CS_APP0.conf）で定義した起動するプログラム（起動パス）に対する引数を指定します。起動プログラム定義ファイル（!JP1_CS_APP0.conf）の詳細については，「起動プログラム定義ファイル（!JP1_CS_APP0.conf）」（2.　定義ファイル）を参照してください。

定義例

#----------------------------------------------------------
# Definition changed by 07-00.
@define-block type="function-tree-def";
id="tool_notepad";
name="メモ帳";
iconstandard="%SOV_INSTALL_PATH%¥image¥sovtool¥blank_standard.gif";
icondown="%SOV_INSTALL_PATH%¥image¥sovtool¥blank_down.gif";
iconrollover="%SOV_INSTALL_PATH%¥image¥sovtool¥blank_over.gif";
icondisable="%SOV_INSTALL_PATH%¥image¥sovtool¥blank_disable.gif";
execute_id="app_notepad";
arguments="C:¥test.txt";
@define-block-end;
#----------------------------------------------------------

ツリー構成ファイル

形式

TREE:BUILD=値;ID=値;[DATE=生成日時;]CSV_VER=09000000;MSCOPE=ON（改行）
OBJ:監視ノード名※, NID:監視ノードID※, ICO:アイコン名, TYPE:監視ノード種別, CLASS:監視オブジェクト種別, STA:状態ID, CHDT:状態更新時刻, OBS:監視状態, STD:基本情報(属性名1=属性値1※), BKIMG=背景画像ファイル名, POT:X=X座標;Y=Y座標;Z=Z座標, CON:NAME=状態変更条件名※, STA=遷移状態ID, CID=共通条件ID;共通条件情報, GCON:NAME=状態変更条件名※, STA=遷移状態ID, CSTA=子ノードの状態ID, NUM>=子ノードの個数, RATIO>=子ノードの比率, (個別条件名==個別条件値※), EVE:STA=状態ID, RES:JP1資源グループ名, OWN:監視ノード所有者名, OPE:操作項目のリスト（改行）
          :

（凡例）

（改行）：改行を意味する

注※：編集できることを意味する（ほかの個所は編集できない）。

ファイル

任意のファイル（ツリー構成ファイル）

格納先ディレクトリ

任意のフォルダ

説明

［監視ツリー］画面に表示される監視ツリーのツリー構成を定義したファイルです。

ツリー構成ファイルを編集することで，監視ツリーに表示される監視ノードの名称，基本情報の属性値などを変更できます。ツリー構成ファイルは，［監視ツリー］画面または［監視ツリー(編集中)］画面からツリー構成をローカルに保存することで作成できます。なお，これらの方法以外で，ツリー構成ファイルを作成しないでください。また，ツリー構成ファイルを編集する場合，次の記述内容で説明する値以外は変更しないでください。

編集してはならない値を誤って更新した場合，ツリー構成ファイルのバックアップがあるときはツリー構成ファイルを更新し直してください。バックアップがないときはjcsdbsetupまたはjcsdbimportコマンドを使用して監視オブジェクトDBをセットアップし直してください。

特別な理由がない場合は，［監視ツリー(編集中)］画面を使って監視ツリーを編集することを推奨します。

全角文字を使用する場合は，文字コードをMS932に統一してください。外字は使用できません。エスケープ文字は入力しないでください。

定義の反映時期

［監視ツリー(編集中)］画面でこの定義ファイルを開いたあと，JP1/IM - Managerに反映することで有効になります。

記述内容

TREE

TREEに含まれる次のパラメーターの内容は変更できません。

BUILD=値

値にはツリー生成番号が表示されます。なお，このパラメーターの値は，サーバへの更新によって変更されます。

ID=値

値にはツリーIDが表示されます。

DATE=生成日時

生成日時にはツリー生成日時が表示されます。なお，このパラメーターの値は，サーバへの更新および監視ノードの状態変更によって更新されます。

CSV_VER=09000000

CSVファイルのフォーマットバージョンです。JP1/IM - Managerのバージョンによって値が異なる場合があります。

MSCOPE={ON | OFF}

監視範囲設定の有効・無効が表示されます。ONの場合，監視範囲設定が有効です。

OBJ:監視ノード名

監視ノード名には監視ツリーに表示される監視ノード名が表示されます。ユーザーが変更できます。指定できる文字数は最大255バイトです。半角英数字，全角文字（外字を除く）を使用できます。なお，監視ノードにセミコロン（;）を入力する場合には，セミコロンを二つ重ねて入力してください。

監視ノード名にコンマ（,）を入力する場合は，OBJの項目全体をダブルクォーテーション（"）で囲んでください。

例

監視ノード名を「監視,ノード」とする場合は，次のように記述します。

"OBJ:監視,ノード"

監視ノード名にダブルクォーテーション（"）を入力する場合は，OBJの項目全体をダブルクォーテーション（"）で囲み，さらに監視ノード名のダブルクォーテーション（"）の前にもう一つダブルクォーテーション（"）を記述してください。

例

監視ノード名を「"監視ノード"」とする場合，次のように記述します。

"OBJ:""監視ノード"""

NID:監視ノードID

監視ノードIDには監視ツリーに表示される監視ノードのIDが16進数8けたで表示されます。ユーザーが変更できます。

なお，監視ノードIDは，ほかの監視ノードの監視ノードIDと重複しないように注意してください。監視ノードIDには，00000001〜7FFFFFFFを指定してください。

ICO:アイコン名

監視ノードのアイコン名が最大で三つ，セミコロン（;）区切りで表示されます。

このパラメーターは変更できません。

TYPE:監視ノード種別

監視グループ，監視オブジェクト，および仮想ルートノードを識別するIDが表示されます。このパラメーターは変更できません。

CLASS:監視オブジェクト種別

監視オブジェクトの種別が表示されます。このパラメーターは変更できません。

STA:状態ID

監視ノードの状態を示すIDが表示されます。このパラメーターは変更できません。

CHDT:状態更新時刻

監視ノードの状態が更新された時刻が表示されます。このパラメーターは変更できません。

OBS:監視状態

監視ノードの監視状態が表示されます。このパラメーターは変更できません。

STD:属性名=属性値

監視ノードの基本情報を定義した場合には，その属性名と属性値が表示されます。基本情報は，複数指定がある場合，セミコロン（;）で区切られます。

属性値だけ変更できます。属性値に指定できる文字数は最大1,023バイト※です。なお，属性値にセミコロン（;）を入力する場合には，セミコロンを二つ重ねて入力してください。

注※　全フィールドのトータルでは1,280バイト以内です（例えば基本情報を五つ設定した場合，五つの属性値の合計が1,280バイト以内にする必要がある）。

属性値にコンマ（,）を入力する場合は，STDの項目全体をダブルクォーテーション（"）で囲んでください。

例

属性値を「属性,値」とする場合は，次のように記述します。

"STD:属性名=""属性,値"

属性値にダブルクォーテーション（"）を入力する場合は，STDの項目全体をダブルクォーテーション（"）で囲み，さらに属性値のダブルクォーテーション（"）の前にもう一つダブルクォーテーション（"）を記述してください。

例

属性値を「"属性値"」とする場合は，次のように記述します。

"STD:属性名=""属性値"""

BKIMG=背景画像ファイル名

［監視ツリー(編集中)］画面のマップ表示時，または［ビジュアル監視(編集中)］画面で設定されている背景画像ファイル名が表示されます。このパラメーターは変更できません。

POT:X=X座標;Y=Y座標;Z=Z座標

［監視ツリー(編集中)］画面のマップ表示時，または［ビジュアル監視(編集中)］画面で設定されているアイコンの位置情報（座標軸）が表示されます。このパラメーターは変更できません。

CON

CONに含まれるパラメーターには次のものがあります。なお，CONパラメーターはTYPEの値が1（監視グループ）の場合は表示されません。

NAME=状態変更条件名

状態変更条件名が表示されます。ユーザーが変更できます。指定できる文字数は最大63バイトです。半角英数字，全角文字（外字を除く）を使用できます。* " ' ¥ : ; | = + ? <.>は使用できません。なお，同行にNAMEパラメーターが複数ある場合，その中で同じ状態変更条件名は使用できないため，注意してください。

状態変更条件名にコンマ（,）を入力する場合は，CONの項目全体をダブルクォーテーション（"）で囲んでください。

例

　状態変更条件名を「状態変更,条件名」とする場合，次のように記述します。

　"CON:NAME=状態変更,条件名;STA=700;個別条件名==個別条件値"

STA=遷移状態ID

遷移状態IDが表示されます。このパラメーターは変更できません。

CID=共通条件ID;共通条件情報

共通条件IDおよび共通条件情報が表示されます。共通条件情報には，［状態変更条件設定］画面で設定した，システムが管理するために必要なIDや情報などの共通条件が表示され，セミコロン（;）で区切られます。なお，これらのパラメーターは変更できません。

GCON

GCONに含まれるパラメーターには次のものがあります。

なお，GCONパラメーターはTYPEの値が2（監視オブジェクト）の場合や，監視グループの状態変更条件を一つも設定していない場合は表示されません。

NAME=状態変更条件名

状態変更条件名が表示されます。ユーザーが変更できます。指定できる文字数は最大63バイトです。半角英数字，全角文字（外字を除く）を使用できます。* " ' ¥ : ; | = + ? <.>は使用できません。なお，同行にNAMEパラメーターが複数ある場合，その中で同じ状態変更条件名は使用できないため，注意してください。

状態変更条件名にコンマ(,)を入力する場合は，GCONの項目全体をダブルクォーテーション（"）で囲んでください。

STA=遷移状態ID

遷移状態IDが表示されます。このパラメーターは変更できません。

CSTA=子ノードの状態ID

子ノードの状態IDが表示されます。このパラメーターは変更できません。

NUM>=子ノードの個数

子ノードの個数が表示されます。このパラメーターは変更できません。また，RATIOと同時に指定できません。

RATIO>=子ノードの比率

子ノードの比率が表示されます。このパラメーターは変更できません。また，NUMと同時に指定できません。

個別条件名==個別条件値

［状態変更条件設定］画面で個別条件を設定した場合に表示されます。個別条件は，複数指定がある場合，セミコロン（;）で区切られます。個別条件値だけ変更できます。なお，==部分はGUIでの設定によって次のように変わりますが，この部分は変更しないでください。

==：「と一致する」

!=：「と一致しない」

^=：「から始まる」

>=：「を含む」

<=：「を含まない」

*=：「正規表現」

+=：「ホスト名比較」

個別条件値に指定できる文字数は最大1,023バイト※です。なお，個別条件値にセミコロン（;）を入力する場合には，セミコロンを二つ重ねて入力してください。

注※　全フィールドのトータルでは1,280バイト以内です（例えば個別条件を五つ設定した場合，五つの条件値の合計が1,280バイト以内にする必要がある）。

個別条件値にコンマ（,）を入力する場合は，CONの項目全体をダブルクォーテーション（"）で囲んでください。

例

　個別条件値を「個別,条件値」とする場合は，次のように記述します。

　"CON:NAME=状態変更条件名;STA=700;個別条件名==個別,条件値"

個別条件値にダブルクォーテーション（"）を入力する場合は，CONの項目全体をダブルクォーテーション（"）で囲み，さらに属性値のダブルクォーテーション（"）の前にもう一つダブルクォーテーション（"）を記述してください。

例

　個別条件値を「"個別条件値"」とする場合は，次のように記述します。

　"CON:NAME=状態変更条件名,;STA=700;個別条件名==""個別条件値"""

EVE:STA=状態ID

イベント発行条件で設定した状態の状態IDが表示されます。このパラメーターは変更できません。

RES:JP1資源グループ名

監視ノードのJP1資源グループ名が表示されます。このパラメーターは変更できません。

OWN:監視ノード所有者名

監視ノードの所有者名が表示されます。このパラメーターは変更できません。

OPE:操作項目のリスト

ログインしたユーザーが監視ノードに対して保有する操作項目のリストが表示されます。このパラメーターは変更できません。

注意事項

監視ノードIDを変更すると，［ビジュアル監視］画面に影響がでるおそれがあります。これは，［監視ツリー］画面，［ビジュアル監視］画面に表示される監視ノードが監視ノードIDをキーに管理されているためです。

監視ノードIDを変更した場合は，画面表示に問題がないか［ビジュアル監視］画面の確認をしてください。

システムプロファイル（セントラルスコープ）（jcs_sysprofile_xxx.def）

形式

DESC_VERSION=1※1
[SystemProfile]
  FrameVisible={true | false}
  Movable={true | false}
[DisplayColor]
    :
  [ColorItem]※2
    Status=監視ノードの状態識別子
    Name=監視ノードの状態名
    [Label]
      R=値
      G=値
      B=値
      A=値
    [END]
    [TEXT]
      R=値
      G=値
      B=値
    [End]
  [End]
      :
[End]
[DisplayLamp]
  Status=監視ノードの状態識別子
[End]
[End]

注※1　DESC_VERSION=1は，変更しないでください。

注※2　[ColorItem]〜[End]内のStatus，Nameの値は，変更しないでください。

ファイル

システムプロファイル（セントラルスコープ）（jcs_sysprofile_xxx.def）は，JP1/IMの動作する言語コードによって，編集するファイルが異なります。JP1/IMの動作する言語コードと，編集するシステムプロファイル（セントラルスコープ）の対応を次の表に示します。

表2‒82　JP1/IMの動作する言語コードとシステムプロファイル（セントラルスコープ）の対応

OS

言語種別

JP1/IMの動作する言語コード

定義ファイル

Windows

日本語

jcs_sysprofile_sjis.def（システムプロファイル（セントラルスコープ））

jcs_sysprofile_sjis.def.model（システムプロファイル（セントラルスコープ）のモデルファイル）

英語

jcs_sysprofile.def（システムプロファイル（セントラルスコープ））

jcs_sysprofile.def.model（システムプロファイル（セントラルスコープ）のモデルファイル）

中国語

jcs_sysprofile_GB18030.def（システムプロファイル（セントラルスコープ））

jcs_sysprofile_GB18030.def.model（システムプロファイル（セントラルスコープ）のモデルファイル）

UNIX※

日本語

シフトJISコード

jcs_sysprofile_sjis.def（システムプロファイル（セントラルスコープ））

jcs_sysprofile_sjis.def.model（システムプロファイル（セントラルスコープ）のモデルファイル）

EUCコード

jcs_sysprofile_euc.def（システムプロファイル（セントラルスコープ））

jcs_sysprofile_euc.def.model（システムプロファイル（セントラルスコープ）のモデルファイル）

UTF-8コード

jcs_sysprofile_UTF-8.def（システムプロファイル（セントラルスコープ））

jcs_sysprofile_UTF-8.def.model（システムプロファイル（セントラルスコープ）のモデルファイル）

英語

jcs_sysprofile.def（システムプロファイル（セントラルスコープ））

jcs_sysprofile.def.model（システムプロファイル（セントラルスコープ）のモデルファイル）

中国語

GB18030コード

jcs_sysprofile_GB18030.def（システムプロファイル（セントラルスコープ））

jcs_sysprofile_GB18030.def.model（システムプロファイル（セントラルスコープ）のモデルファイル）

注※

OSがサポートしている言語と対応するファイルだけが存在します。

言語コードに対応したシステムプロファイル（セントラルスコープ）（jcs_sysprofile_xxx.def）を使用してください。

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Scopeパス¥conf

論理ホストのとき

共有フォルダ¥jp1scope¥conf

UNIXの場合

物理ホストのとき

/etc/opt/jp1scope/conf

論理ホストのとき

共有ディレクトリ/jp1scope/conf

説明

セントラルスコープ・ビューアーの共通の定義情報です。この定義ファイルの内容は，次の画面に反映されます。

［監視ツリー］画面

［ビジュアル監視］画面

定義の反映時期

セントラルスコープにログインするとその定義が有効になります。ただし，［イベントコンソール］画面からセントラルスコープにログインする場合は，定義ファイルの編集後に［イベントコンソール］画面を再起動してからセントラルスコープにログインする必要があります。

記述内容

DESC_VERSION=1

システムプロファイルの形式のバージョンを表しています。

セントラルスコープ・ビューアーの動作が不正になることがあるため，この値は変更しないでください。

[SystemProfile]〜[End]

システムプロファイルの定義開始タグ，および定義終了タグです。

FrameVisible={true | false}

監視ノード名およびアイコン余白を表示するかどうかを指定します。指定できる値は「true」または「false」です。設定値の大文字・小文字は区別しません。このパラメーターは，[SystemProfile]〜[End]内に記載します。

「true」を指定した場合は，監視ノード名およびアイコン余白を表示します。「false」を指定した場合は，監視ノード名およびアイコン余白を表示しません。

このパラメーターを省略した場合，および「true」「false」以外の値を指定した場合は，「true」を仮定します。

JP1/IM - Managerをバージョン10-10以前からバージョンアップした場合，論理ホストのシステムプロファイルには，このパラメーターは設定されません。このパラメーターを指定したいときは，記述を追加してください。

Movable={true | false}

［監視ツリー］画面のマップ表示，および［ビジュアル監視］画面で監視ノードアイコンをドラッグ&ドロップで移動できるようにするかどうかを指定します。指定できる値は「true」または「false」です。設定値の大文字・小文字は区別しません。このパラメーターは，[SystemProfile]〜[End]内に記載します。

「true」を指定した場合は，監視ノードアイコンを移動できます。「false」を指定した場合は，監視ノードアイコンを移動できません。

このパラメーターを省略した場合，および「true」「false」以外の値を指定した場合は，「true」を仮定します。

JP1/IM - Managerをバージョン10-10以前からバージョンアップした場合，論理ホストのシステムプロファイルには，このパラメーターは設定されません。このパラメーターを指定したいときは，記述を追加してください。

[DisplayColor]〜[End]

[DisplayColor]〜[End]内に監視ノードの状態を定義するための定義ブロックを記載します。この定義ブロックは[SystemProfile]〜[End]内に一つだけ記載します。

[ColorItem]〜[End]

[ColorItem]〜[End]内に状態識別子，状態名，状態色を定義するためのパラメーター，および定義ブロックを記載します。この定義ブロックは[DisplayColor]〜[End]内に状態ごとに記載します。

Status=監視ノードの状態識別子

状態識別子を指定します。このパラメーターは[ColorItem]〜[End]内に記載します。セントラルスコープ・ビューアーの動作が不正になることがあるため，この値は変更しないでください。

Name=監視ノードの状態名

状態名を指定します。このパラメーターは[ColorItem]〜[End]内に記載します。セントラルスコープ・ビューアーの動作が不正になることがあるため，この値は変更しないでください。

[Label]〜[End]

[Label]〜[End]内に監視ノードの状態色，および監視ノードの状態色を透過するかどうかを指定するためのパラメーターを記載します。監視ノードの状態が遷移すると，状態色が遷移先の状態に対応する[Label]〜[End]で指定された色に変化します。この定義ブロックは[ColorItem]〜[End]内に一つだけ記載します。

R=値，G=値，B=値

監視ノードの状態色をRGB値で指定します。このパラメーターは[Label]〜[End]内に記載します。指定できる値は0〜255の整数です。

このパラメーターを省略した場合，0未満の整数値を指定した場合，および整数値以外を指定した場合は，0を仮定します。256以上の整数値を指定した場合は，255を仮定します。

A=値

監視ノードの状態色を透過するかどうかを指定します。このパラメーターは[Label]〜[End]内に記載します。FrameVisibleパラメーターが指定されていない場合，およびFrameVisibleパラメーターに「true」が指定されている場合は，Aに指定した値に関係なく状態色を透過しません。指定できる値は0〜255の整数です。指定した値が小さいほど，透過率が高くなります。0を指定した場合，状態色を完全に透過します。255を指定した場合，状態色を透過しません。

このパラメーターを省略した場合，および指定できる値以外の値を指定した場合は，255を仮定します。

[TEXT]〜[End]

[TEXT]〜[End]内に監視ノード名のテキストの色を指定するためのパラメーターを記載します。監視ノードの状態が遷移すると，監視ノード名のテキストの色が遷移先の状態に対応する[TEXT]〜[End]で指定された色に変化します。この定義ブロックは[ColorItem]〜[End]内に一つだけ記載します。

R=値，G=値，B=値

監視ノード名のテキストの色をRGB値で指定します。このパラメーターは[TEXT]〜[End]内に記載します。指定できる値は0〜255の整数です。

このパラメーターを省略した場合，0未満の値を指定した場合，および整数値以外を指定した場合は，0を仮定します。256以上の値を指定した場合は，255を仮定します。インストール時点ではすべての値に0が指定されています。

[DisplayLamp]〜[End]

アラームランプが点灯する状態を指定するためのパラメーターを指定します。最上位監視ノードの状態が遷移した場合に，遷移先の状態に指定された状態識別子が[DisplayLamp]〜[End]で指定された値以上であるときに，アラームランプが点灯します。この定義ブロックは[SystemProfile]〜[End]内に記載します。

Status=監視ノードの状態識別子

アラームランプが点灯する状態を指定します。このパラメーターは[DisplayLamp]〜[End]内に記載します。指定できる値は-2,147,483,648〜2,147,483,647の10進数整数です。

このパラメーターを省略した場合，および指定できる値以外の値を指定した場合は，0を仮定します。最上位監視ノードの状態に指定された状態識別子が，このパラメーターに指定された値より大きい場合，アラームランプが点灯します。このパラメーターで指定した値とアラームランプが点灯する状態の対応を，次の表に示します。

表2‒83　指定した値とアラームランプが点灯する状態の対応

指定した値

アラームランプが点灯する状態

-2,147,483,648〜100

初期状態，デバッグ，正常，警告，エラー，致命的，警戒，緊急

101〜200

デバッグ，正常，警告，エラー，致命的，警戒，緊急

201〜300

正常，警告，エラー，致命的，警戒，緊急

301〜400

警告，エラー，致命的，警戒，緊急

401〜500

エラー，致命的，警戒，緊急

501〜600

致命的，警戒，緊急

601〜700

警戒，緊急

701〜800

緊急

801〜2,147,483,648

点灯しない

なお，値は「200」「300」「400」「500」「600」「700」「800」の中から指定することをお勧めします。

注意事項

設定項目名は，大文字・小文字を区別します。

各設定項目の設定値は「=」の直後に設定してください。スペースやタグなどを入れた場合は，設定した値が認識されません。

定義の開始タグが誤って削除された場合は，ファイルフォーマット不正のメッセージ（KAVB7303-E）を出力し，JP1/IM - Viewの操作を中断します。また，誤って変更した場合は，定義が認識されません。

定義の終了タグが誤って変更または削除された場合は，ファイルフォーマット不正のメッセージ（KAVB7303-E）を出力し，JP1/IM - Viewの操作を中断します。

システムプロファイル（セントラルスコープ）（jcs_sysprofile_xxx.def）を編集しても，［監視ツリー(編集中)］画面および［ビジュアル監視(編集中)］画面には編集結果が反映されません。これらの画面の設定を変更したい場合は，システムプロファイル（セントラルスコープ・ビューアー）（system.conf）を編集してください。

システムプロファイル（セントラルスコープ・ビューアー）（system.conf）

形式

DESC_VERSION=1
[SystemProfile]
  FrameVisible={true | false}
 [DisplayColor]
    :
  [ColorItem]
    Status=監視ノードの状態識別子
    Name=監視ノードの状態名
    [Label]
      R=値
      G=値
      B=値
      A=値
    [END]
    [TEXT]
      R=値
      G=値
      B=値
    [End]
  [End]
      :
[End]

[End]

ファイル

system.conf（システムプロファイル（セントラルスコープ・ビューアー））

system.conf.model（システムプロファイル（セントラルスコープ・ビューアー）のモデルファイル）

格納先ディレクトリ

日本語OSの場合

Viewパス¥conf¥sovsystem¥ja¥

英語OSの場合

Viewパス¥conf¥sovsystem¥en¥

中国語OSの場合

Viewパス¥conf¥sovsystem¥zh¥

説明

セントラルスコープ・ビューアーの共通の定義情報です。この定義ファイルの内容は，次の画面に反映されます。

［監視ツリー(編集中)］画面

［ビジュアル監視(編集中)］画面

定義の反映時期

［監視ツリー(編集中)］画面，または［ビジュアル監視(編集中)］画面を表示したときに有効になります。

記述内容

Movableが指定できないこと以外は，システムプロファイル（セントラルスコープ）（jcs_sysprofile_xxx.def）と同じです。詳細については，「システムプロファイル（セントラルスコープ）（jcs_sysprofile_xxx.def）」（2.　定義ファイル）を参照してください。

注意事項

システムプロファイル（セントラルスコープ・ビューアー）（system.conf）特有の注意事項について説明します。ここに記載している以外の注意事項については，「システムプロファイル（セントラルスコープ）（jcs_sysprofile_xxx.def）」（2.　定義ファイル）を参照してください。

［監視ツリー(編集中)］画面，および［ビジュアル監視(編集中)］画面の監視ノードの状態は，常に初期状態です。そのため，初期状態以外の状態については，定義が画面に反映されません。

システムプロファイル（セントラルスコープ・ビューアー）（system.conf）を編集しても，［監視ツリー］画面および［ビジュアル監視］画面には編集結果が反映されません。これらの画面の設定を変更したい場合は，システムプロファイル（セントラルスコープ）（jcs_sysprofile_xxx.def）を編集してください。

性能レポート表示定義ファイル（performance.conf）

形式

# (JP1/PFM - Web Console URL)
[JP1/PFM - Web ConsoleのURL]

ファイル

performance.conf（性能レポート表示定義ファイル）

performance.conf.model（性能レポート表示定義ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Consoleパス¥conf¥console¥performance

論理ホストのとき

共有フォルダ¥jp1cons¥conf¥console¥performance

UNIXの場合

物理ホストのとき

/etc/opt/jp1cons/conf/console/performance

論理ホストのとき

共有ディレクトリ/jp1cons/conf/console/performance

説明

事象発生元ホストの性能レポート表示機能の定義ファイルです。接続先のJP1/PFM - Web ConsoleのURLを定義します。

定義の反映時期

jco_spmd_reloadコマンドを実行したあと，またはJP1/IM - Managerを再起動したあと，JP1/IM - ViewでJP1/IM - Managerにログインすると，性能レポート表示定義ファイルの設定が有効になります。

記述内容

タブ，および行の前方と後方の半角スペースは無視されます。

半角スペースまたはタブだけで構成された行，および空行（改行だけの行）は，無視して処理を続行します。

「#」で始まる行は，コメントになります。

[JP1/PFM - Web ConsoleのURL]

接続先のJP1/PFM - Web ConsoleのURLを半角英数字および記号で指定します。

JP1/PFM - Web ConsoleのURLの詳細については，JP1/PFMのマニュアルを参照してください。

注意事項

ファイルの文字コードは，マネージャーの文字コード設定と同じ文字コードを使用してください。

IM構成管理・ビューアー動作定義ファイル（jcfview.conf）

形式

jcfview.login.host.max=ホストの最大記録数
jcfview.login.user.max={0|1}
jcfview.screen.history.enable={0|1}
jcfview.response.wait.time=サーバ応答待ちタイムアウト時間
jcfview.imconfigreflect.response.wait.time=システムの階層構成の反映応答待ちタイムアウト時間
jcfview.screen.title.logininfo.enable={0|1}

ファイル

jcfview.conf（IM構成管理・ビューアー動作定義ファイル）

jcfview.conf.model（IM構成管理・ビューアー動作定義ファイルのモデルファイル）

格納先ディレクトリ

Viewパス¥conf¥jcfview¥

説明

IM構成管理・ビューアーの動作を指定するファイルです。

定義の反映時期

IM構成管理・ビューアーの起動時に有効になります。

記述内容

jcfview.login.host.max=ホストの最大記録数

ログインに成功したホストの最大記録数を10進数で記述します。指定できる値は0〜20です。デフォルトは5です。

jcfview.login.user.max={0|1}

［ログイン］画面のユーザー名に前回ログインしたJP1ユーザー名を表示するかどうかを指定します。1を指定すると，前回ログインしたJP1ユーザー名を表示します。0を指定すると，前回ログインしたJP1ユーザー名を表示しません。このパラメーターを指定しなかった場合や，0または1以外を指定した場合は，1を仮定します。デフォルトは1です。

jcfview.screen.history.enable={0|1}

画面起動時に前回のIM構成管理・ビューアー画面の表示位置，表示サイズ，および表示ボタンの選択状態の履歴を使用するかどうかを指定します。対象となる画面は，［IM構成管理］画面，［エージェント構成編集］画面，［リモート監視構成編集］画面，および［プロファイル表示/編集］画面です。

指定できる値は，次のとおりです。

0：画面表示設定履歴機能を使用しません。

1：画面表示設定履歴機能を使用します（デフォルト値）。

なお，0を設定してIM-Viewを起動した場合，すべての画面表示設定履歴ファイルを削除します。

jcfview.response.wait.time=サーバ応答待ちタイムアウト時間

サーバ応答待ちのタイムアウト時間を10進数で記述します。単位はミリ秒です。

指摘できる値は，60,000〜3,600,000，デフォルトは1,800,000です。最小値より小さい値，最大値より大きい値，不正な値が指定された場合，または定義がない場合は，デフォルト値が使用されます。

タイムアウトが発生した場合は，KNAN20105-Eのメッセージが表示されます。KNAN20105-Eのメッセージが頻繁に出力される場合は，タイムアウト時間の設定を見直してください。

jcfview.imconfigreflect.response.wait.time=システムの階層構成の反映応答待ちタイムアウト時間

システムの階層構成（IM構成）が反映されるまでの応答待ちのタイムアウト時間を10進数で記述します。単位はミリ秒です。指摘できる値は，60,000〜36,000,000，デフォルトは18,000,000です。最小値より小さい値，最大値より大きい値，不正な値が指定された場合，または定義がない場合は，デフォルト値が使用されます。

タイムアウトが発生した場合は，KNAN20105-Eのメッセージが表示されます。KNAN20105-Eのメッセージが頻繁に出力される場合は，タイムアウト時間の設定を見直してください。

jcfview.screen.title.logininfo.enable={0|1}

[IM構成管理]画面，[エージェント構成編集]画面，[リモート監視構成編集]画面，および[プロファイル表示/編集]画面のタイトル部分に表示されるログイン中のJP1ユーザー名を非表示にできます。1を指定すると，ログイン中のJP1ユーザー名を表示します。0を指定すると，ログイン中のJP1ユーザー名を表示しません。このパラメーターを指定しなかった場合や，0または1以外が指定されたときは，1を仮定します。デフォルトは1です。

定義例

jcfview.login.host.max=5
jcfview.login.user.max=1
jcfview.screen.history.enable=1
jcfview.response.wait.time=1800000
jcfview.imconfigreflect.response.wait.time=18000000
jcfview.screen.title.logininfo.enable=1

IM構成反映方式設定ファイル（jp1cf_applyconfig.conf）

形式

[論理ホスト名¥JP1CONFIG]
"APPLY_CONFIG_TYPE"=dword:{00000000 | 00000001}

ファイル

jp1cf_applyconfig.conf（IM構成反映方式設定ファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Managerパス¥conf¥imcf¥

論理ホストのとき

共有フォルダ¥JP1IMM¥conf¥imcf¥

UNIXの場合

物理ホストのとき

/etc/opt/jp1imm/conf/imcf/

論理ホストのとき

共有ディレクトリ/jp1imm/conf/imcf/

説明

システムの階層構成の反映方式を定義するファイルです。

エージェント構成の反映には，差分配布方式，一括配布方式（構成削除あり），および一括配布方式（構成削除なし）があります。

次に示す条件の場合，IM構成反映方式設定ファイルで，反映方式を一括配布方式（構成削除あり）または一括配布方式（構成削除なし）に切り替えられます。

JP1/Baseの構成定義情報の配布の設定で差分配布機能が無効の場合，かつ業務グループの参照・操作制限機能が無効の場合

システムの階層構成の反映方式については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「8.2.6　システムの階層構成の反映」を参照してください。

定義の反映時期

jbssetcnfコマンドを実行して定義をJP1共通定義情報に反映したあと，JP1/IM - Managerを起動・再起動した場合か，jco_spmd_reloadコマンドでリロードした場合に設定を反映します。

記述内容

[論理ホスト名¥JP1CONFIG]

IM構成反映方式設定のキー名称です。

論理ホスト名の部分を，物理ホストの場合はJP1_DEFAULTに，論理ホストの場合は論理ホスト名に設定します。

"APPLY_CONFIG_TYPE"=dword:{00000000 | 00000001}

システムの階層構成の反映方式を指定します。

00000000

システムの階層構成の反映方式が一括配布方式（構成削除あり）になります。システムの階層構成を削除後に反映します。この項目は，デフォルトで設定されています。

00000001

システムの階層構成の反映方式が一括配布方式（構成削除なし）になります。システムの階層構成を削除しないで反映します。

値が不正または共通定義が設定されていない場合は，デフォルトが仮定されます。

定義例

[JP1_DEFAULT¥JP1CONFIG]
"APPLY_CONFIG_TYPE"=dword:00000001

ホスト入力情報ファイル（host_input_data.csv）

形式

製品名;ファイルフォーマットバージョン;文字コード
Host_name,IPAddress,Host_list,Comment,Host_type,Running_host_name,Standby_host_name,VMM_host_name,Virtual_manager_type,Username,Password,Domain_name,Connection_type,Virtual_host_manager,Remote_connection_type,Authentication_section,Port_number,SSH_private_key_path
ホスト名,IPアドレス,ホスト名一覧,コメント,ホスト種別,実行系ホスト,待機系ホスト,VMMホスト,仮想化管理種別,ユーザー名,パスワード,ドメイン名,通信種別,仮想化管理元ホスト,リモート通信種別,認証情報の区分,ポート番号,秘密鍵パス

ファイル

host_input_data.csv（ホスト入力情報ファイル）

格納先ディレクトリ

Windowsの場合

任意のフォルダ

UNIXの場合

任意のディレクトリ

説明

IM構成管理の管理対象ホストに関するホスト入力情報のエクスポートファイルです。ホスト入力情報ファイルを編集してインポートできます。

定義の反映時期

jcfimportコマンドでファイルをインポートしたときに反映されます。

記述内容

ホスト入力情報ファイルに出力されるホスト情報を次の表に示します。

表2‒84　エクスポートされるホスト情報（ホスト入力情報ファイル）

行

出力項目

出力値

1行目（ヘッダー情報）

製品名

JP1/IM-CF

ファイルフォーマットバージョン

ファイルフォーマットのバージョン

例えば，JP1/IM - Managerのバージョンが10-50の場合は，「101000」と出力されます。

文字コード

文字コード

マネージャーの環境変数LANGの設定に依存します。詳細は，「表2-85　ファイルの文字コード」を参照してください。

2行目（ヘッダー情報）

ホスト名

Host_name

IPアドレス

IPAddress

ホスト名一覧

Host_list

コメント

Comment

ホスト種別

Host_type

実行系ホスト

Running_host_name

待機系ホスト

Standby_host_name

VMMホスト

VMM_host_name

仮想化管理種別

Virtual_manager_type

ユーザー名

Username

パスワード

Password

ドメイン名

Domain_name

通信種別

Connection_type

仮想化管理元ホスト

Virtual_host_manager

リモート通信種別

Remote_connection_type

認証情報の区分

Authentication_section

ポート番号

Port_number

秘密鍵パス

SSH_private_key_path

3行目以降

ホスト名

システムの階層構成に登録したホストのホスト名

IPアドレス

システムの階層構成に登録したホストのIPアドレス（複数ある場合はコンマ（,）で区切り，全体をダブルクォーテーション（"）で囲む）

ホスト名一覧

ホストに登録したホスト名の一覧（複数ある場合はコンマ（,）で区切り，全体をダブルクォーテーション（"）で囲む）

コメント

ホストに登録したコメント

ホスト種別

ホストの種別（physical，logical，virtual，unknown）

実行系ホスト

実行系となるホストのホスト名

待機系ホスト

待機系となるホストのホスト名（複数ある場合はコンマ（,）で区切り，全体をダブルクォーテーション（"）で囲む）

VMMホスト

仮想マシンモニターが動作しているホストのホスト名

仮想化管理種別

仮想化管理の種別（vCenter，JP1/SC/CM，SCVMM，HCSM，ESX※1，Hyper-V，KVM，Virtage※2）

ユーザー名

ユーザー名

パスワード

パスワード情報であるため出力されません。

ドメイン名

仮想マシンモニターが動作しているホストのドメイン名

通信種別

通信種別（http，https，ssh）

仮想化管理元ホスト

ホストに登録したホスト名

リモート通信種別

リモート監視の場合に出力される通信種別（disable，ssh，wmi）

認証情報の区分

リモート監視の場合に出力される認証情報（common，host，空白）

ポート番号

通信で使用するポート番号

秘密鍵パス

SSH接続で使用する秘密鍵ファイルの絶対パス

注※1　ESXは，VMware ESXを指します。

注※2　Virtageは，日立サーバ論理分割機構を指します。

表2‒85　ファイルの文字コード

OS

環境変数LANGの形式

変換する文字コード

Windows

−

日本語OS：MS932

英語OS：C（ISO-8859-1）

中国語OS：GB18030

Linux

ja_JP.UTF-8またはja_JP.utf8

日本語OS：UTF-8

ja_JP.sjisまたはja_JP.SJIS※

日本語OS：Shift_JIS

C

英語OS：C（ISO-8859-1）

zh_CN.gb18030

中国語OS：GB18030

−

上記以外

UTF-8

（凡例）

−：該当なし

注※　OSがSUSE Linuxの場合だけ有効です。

出力例

JP1/IM-CF;101000;MS932,,,,,,,,,,,,,,,,
Host_name,IPAddress,Host_list,Comment,Host_type,Running_host_name,Standby_host_name,VMM_host_name, Virtual_manager_type,Username,Password, Domain_name, Connection_type,Virtual_host_manager,Remote_connection_type,Authentication_section, Port_number, SSH_private_key_path
infch05340,192.168.105.251,infch05340.supp528,,physical,,,,,,,,,,disable,,
infch05356,192.168.105.193,infch05356,,physical,,,,,,,,,,disable,,
infch02272,192.168.105.84,infch02272,,physical,,,,KVM,,,,,,disable,22,<ssh_private_key_path>

ホスト収集情報ファイル（host_collect_data.csv）

形式

製品名;ファイルフォーマットバージョン;文字コード
Real_host_name,OS_name,JP1_product_name,JP1_product_id,JP1_product_version,Install_path,Conf_dir,Date,Total_time,Host_name,Virtual_manager_type,Virtual_manager_version
実ホスト名,OS名,製品名,製品形名,バージョン,インストールパス,環境設定ファイル格納フォルダ,更新日時,更新日時（GMT）,ホスト名,仮想化管理種別,仮想化製品バージョン

ファイル

host_collect_data.csv（ホスト収集情報ファイル）

格納先ディレクトリ

Windowsの場合

任意のフォルダ

UNIXの場合

任意のディレクトリ

説明

IM構成管理の管理対象ホストに関するホスト収集情報のエクスポートファイルです。ホスト収集情報ファイルを編集したりインポートしたりできません。

記述内容

ホスト収集情報ファイルに出力されるホスト情報を次の表に示します。

表2‒86　エクスポートされるホスト情報（ホスト収集情報ファイル）

行

出力項目

出力値

1行目（ヘッダー情報）

製品名

JP1/IM-CF

ファイルフォーマットバージョン

ファイルフォーマットのバージョン

例えば，JP1/IM - Managerのバージョンが10-50の場合は，「101000」と出力されます。

文字コード

文字コード

マネージャーの環境変数LANGの設定に依存します。詳細は，「表2-85　ファイルの文字コード」を参照してください。

2行目（ヘッダー情報）

実ホスト名

Real_host_name

OS名

OS_name

製品名

JP1_product_name

製品形名

JP1_product_id

バージョン

JP1_product_version

インストールパス

Install_path

環境設定ファイル格納フォルダ

Conf_dir

更新日時

Date

更新日時（GMT）

Total_time

ホスト名

Host_name

仮想化管理種別

Virtual_manager_type

仮想化製品バージョン

Virtual_manager_version

3行目以降

実ホスト名

ホストの実ホスト名

OS名

ホスト上で動作しているOS名

製品名

ホスト上で動作している製品名

製品形名

製品の型名

バージョン

製品のバージョン

インストールパス

製品のインストールパス

環境設定ファイル格納フォルダ

製品の環境設定ファイルを格納したフォルダ

更新日時

YYYY/MM/DD hh:mm:ss

更新日時（GMT）

YYYY/MM/DD hh:mm:ss（GMT）※1

ホスト名

システムの階層構成に登録したホストのホスト名

仮想化管理種別

仮想化製品の種別（vCenter，JP1/SC/CM，SCVMM，HCSM，ESX※2，Hyper-V，KVM，Virtage※3）

仮想化製品バージョン※4

仮想化製品のバージョン

更新日時は，仮想化構成収集日時を出力します。

注※1　仮想化ソフトウェアおよび仮想化環境管理ソフトウェアを使用している場合は，仮想化構成収集日時が出力されます。

注※2　ESXは，VMware ESXを指します。

注※3　Virtageは，日立サーバ論理分割機構を指します。

注※4　仮想化管理種別がHCSMの場合，バージョンにはHCSMの外部接続インターフェースのバージョンが表示されます。そのため，表示されるバージョンと実際のHCSMのバージョンが異なるときがあります。また，仮想化構成情報をHCSMから収集した場合，仮想化管理種別が日立サーバ論理分割機構のホストではバージョン番号が表示されません。

出力例

JP1/IM-CF;101000;UTF-8,,,,,,,,,,,
Real_host_name,OS_name,JP1_product_name,JP1_product_id,JP1_product_version,Install_path,Conf_dir,Date,Total_time,Host_name,Virtual_manager_type,Virtual_manager_version
jp1_bs1,Windows,JP1/Base,P-242C-6L94,0900,C:¥Program Files¥Hitachi¥JP1Base,C:¥Program Files¥Hitachi¥JP1Base¥conf,2009/11/28 10:45:20,1205115658437,jp1-bs1,,
jp1-bs2,Windows, , , , , ,2009/11/28 10:45:20,1205115658437,jp1-bs2,ESX,3.5
jp1-bs3,Windows, , , , , ,2009/11/28 10:45:20,1205115658437,jp1-bs3,vCenter,4.0

プロファイル管理環境定義ファイル（jp1cf_profile_manager.conf）

形式

[論理ホスト名¥JP1CONFIG¥PROFILE_MANAGER¥JP1BASE]
"LOGFILETRAP_AUTO_START_CONTROL"=dword:16進数
"AGENT_PROFILE_UPDATE_NOTICE"=dword:16進数

ファイル

jp1cf_profile_manager.conf（プロファイル管理環境定義ファイル）

jp1cf_profile_manager.conf.model（プロファイル管理環境定義ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

Managerパス¥conf¥imcf

UNIXの場合

/etc/opt/jp1imm/conf/imcf

説明

プロファイル管理機能の実行環境の情報を定義するファイルです。

定義の反映時期

JP1/Baseのjbssetcnfコマンドで，プロファイル管理環境定義ファイルの定義をJP1共通定義情報に反映したあとに，JP1/IM - Managerを再起動すると有効になります。

記述内容

[論理ホスト名¥JP1CONFIG¥PROFILE_MANAGER¥JP1BASE]

プロファイル管理環境定義のキー名称です。

論理ホスト名の部分を，物理ホストの場合はJP1_DEFAULTに，論理ホストの場合は論理ホスト名に設定します。

"LOGFILETRAP_AUTO_START_CONTROL"=dword:16進数

JP1/IM - Viewの［プロファイル表示/編集］画面で，ログファイルトラップの自動起動を設定する機能を有効にするかどうかを指定します。有効の場合，［起動オプション］の［ログファイルトラップサービスが起動したときに自動でプロセス起動する］チェックボックスが表示されます。

00000001：有効

00000000：無効

デフォルトは「00000001」（有効）です。

"AGENT_PROFILE_UPDATE_NOTICE"=dword:16進数

JP1/IM - Viewの［プロファイル表示/編集］画面で，プロファイルの編集や反映をする際，エージェントのプロファイルが更新された可能性があることを通知する機能を有効にするかどうかを指定します。

00000001：有効

00000000：無効

デフォルトは「00000001」（有効）です。

リモートログトラップ環境定義ファイル（jp1cf_remote_logtrap.conf）

形式

[論理ホスト名¥JP1CONFIG¥AGTLESS_MGR]
"MAX_COLLECT_EVENTLOG_DATA_SIZE"=dword:16進数
"MAX_COLLECT_WIN_LOG_DATA_SIZE"=dword:16進数
"MAX_COLLECT_UNIX_LOG_DATA_SIZE"=dword:16進数
"START_OPTION"="warm" | "cold"

ファイル

jp1cf_remote_logtrap.conf（リモートログトラップ環境定義ファイル）

jp1cf_remote_logtrap.conf.model（リモートログトラップ環境定義ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

Managerパス¥conf¥imcf

UNIXの場合

/etc/opt/jp1imm/conf/imcf

説明

リモート監視ログファイルトラップ機能とリモート監視イベントログトラップ機能の実行環境を定義するファイルです。

定義の反映時期

jbssetcnfコマンドの引数にリモートログトラップ環境定義ファイルを指定して共通定義に設定します。そのあと，次に示す契機でリモートログトラップ環境定義ファイルの設定が有効になります。

JP1/IM - Managerを起動したとき

jco_spmd_reloadコマンドを実行してリロードしたとき

なお，定義を反映した際に，1台のJP1/IM - Managerで監視できるログの総容量のチェックを実施し，10MBを超えていると警告メッセージKNAN26143-Wを統合トレースログに出力します。

記述内容

[論理ホスト名¥JP1CONFIG¥AGTLESS_MGR]

リモートログトラップ環境定義のキー名称です。

論理ホスト名の部分を，物理ホストの場合はJP1_DEFAULTに，論理ホストの場合は論理ホスト名に設定します。

"MAX_COLLECT_EVENTLOG_DATA_SIZE"=dword:16進数

リモート監視イベントログトラップの1回の監視間隔で収集できるイベントログの取得上限を16進数で指定します。0x00002800〜0x00032000（10KB〜200KB）の範囲で指定できます。省略した場合，0x00002800（10KB）が仮定されます。

"MAX_COLLECT_WIN_LOG_DATA_SIZE"=dword:16進数

監視対象ホストがWindowsの場合のリモート監視ログファイルトラップの1回の監視間隔で収集できるログの取得上限を16進数で指定します。0x00002800〜0x00032000（10KB〜200KB）の範囲で指定できます。省略した場合，0x00002800（10KB）が仮定されます。

"MAX_COLLECT_UNIX_LOG_DATA_SIZE"=dword:16進数

監視対象ホストがUNIXの場合のリモート監視ログファイルトラップの1回の監視間隔で収集できるログの取得上限を16進数で指定します。0x00002800〜0x0000C800（10KB〜50KB）の範囲で指定できます。省略した場合，0x00002800（10KB）が仮定されます。

"START_OPTION"="warm" | "cold"

リモート監視を停止し，リモート監視を起動した場合，停止中に出力されたログを収集するかどうかを指定します。

"warm"を指定した場合，停止中に出力されたログを収集します。

"cold"を指定した場合，停止中に出力されたログを収集しません。

定義ファイルの指定を省略した場合は，"warm"が仮定されます。

定義例

定義例1：Windowsの場合

[JP1_DEFAULT¥JP1CONFIG¥AGTLESS_MGR]
"MAX_COLLECT_EVENTLOG_DATA_SIZE"=dword:00002800
"MAX_COLLECT_WIN_LOG_DATA_SIZE"=dword:00002800
"MAX_COLLECT_UNIX_LOG_DATA_SIZE"=dword:00002800
"START_OPTION"="warm"

定義例2：UNIXの場合

[JP1_DEFAULT¥JP1CONFIG¥AGTLESS_MGR]
"MAX_COLLECT_UNIX_LOG_DATA_SIZE"=dword:00002800
"START_OPTION"="warm"

マネージャーホストがUNIXで監視対象ホストがWindowsの場合，リモート監視はできないため，MAX_COLLECT_EVENTLOG_DATA_SIZEおよびMAX_COLLECT_WIN_LOG_DATA_SIZEを指定しても定義は設定されません。

リモート監視ログファイルトラップ動作定義ファイル

形式

retry-times=リトライ回数
retry-interval=リトライ間隔
open-retry-times=リトライ回数
open-retry-interval=リトライ間隔
hold-count=JP1イベントの保留件数
keep-event={ OLD | NEW }
unset-extattr=出力を抑止する属性
FILETYPE={ SEQ | SEQ2 | WRAP2 }
HEADLINE=ヘッダーの行数
MARKSTR=[!]"正規表現"
[!]"正規表現n"※
ACTDEF=[{EXIT}][重大度][イベントID][!]"正規表現"
[!]"正規表現n"※

注※　「正規表現n」は複数の正規表現の指定を表します。

ファイル

任意のファイルを使用します。

格納先ディレクトリ

Windowsの場合

任意のフォルダ

UNIXの場合

任意のディレクトリ

説明

リモート監視のログファイルトラップ機能の動作を定義するファイルです。リモート監視のログファイルトラップ機能の起動時にその内容を参照します。

UTF-8で保存する場合は，BOM（byte order mark）が付与されないように保存してください。

定義の反映時期

次の場合に，リモート監視ログファイルトラップ動作定義ファイルの設定が有効になります。

［プロファイル表示/編集］画面でリロードまたは再起動

［プロファイル表示/編集］画面については，マニュアル「JP1/Integrated Management 3 - Manager 画面リファレンス」の「5.9　［プロファイル表示/編集］画面」を参照してください。

jcfallogstartコマンドまたはjcfallogreloadコマンドの実行

jcfallogstartコマンドの詳細については，「jcfallogstart」（1.　コマンド）を参照してください。jcfallogreloadコマンドの詳細については，「jcfallogreload」（1.　コマンド）を参照してください。

JP1/IM - Managerの再起動

記述内容

retry-times

一時的な通信障害で，イベントサービスへの接続に失敗した場合に行うリトライの回数を0〜86,400の範囲で指定します。省略した場合，リトライ処理はしません。

retry-interval

通信障害で，イベントサービスへの接続に失敗した場合に行うリトライ処理の間隔を1〜600（秒）の範囲で指定します。省略した場合，リトライ間隔を10秒と見なします。イベントサービスへの接続のリトライ回数を1以上に設定した場合に有効になります。リトライ間隔は，イベントサービスへの接続に失敗してから次にイベントサービスへの接続を試みるまでの間隔です。イベントサービスへの接続処理に掛かる時間は含みません。retry-timesおよびretry-intervalの組み合わせで24時間以上の設定もできますが，リトライを開始した時刻から24時間以上経過した場合，リトライ処理は打ち切られます。

open-retry-times

ログファイルの読み込みに失敗，または監視対象ホストに接続できなかった場合に行うリトライの回数を1〜3,600の範囲で指定します。省略した場合，リトライ回数を1回と見なします。指定したリトライ回数を超えた場合，ログファイルの監視を停止します。

open-retry-interval

ログファイルの読み込みに失敗，または監視対象ホストに接続できなかった場合に行うリトライ処理の間隔を3〜600（秒）の範囲で指定します。省略した場合，リトライ間隔を3秒と見なします。リトライ間隔は，エラー発生後，リトライを試みるまでの間隔です。

hold-count

リトライ処理中に保留できるJP1イベントの件数を1〜100の範囲で指定します。省略した場合，保留件数を100件と見なします。リトライ処理を行う場合，リトライ処理中に変換されたJP1イベントを保留するためのリソースが必要となります。リトライ処理を行う場合に必要なメモリー所要量を次に示します。

JP1イベントの保留件数 × 1KB

keep-event={ OLD | NEW }

リトライ処理中に保留されたJP1イベントが保留件数を超過した場合，超過したJP1イベントは消去されます。超過した場合に，古いJP1イベントと新しいJP1イベントのどちらを残すかを次のどちらかの値で指定します。省略した場合，OLDが指定されたものと見なします。

OLD

古いJP1イベントを残したい場合に指定します。この場合，hold-countに指定した保留件数までのJP1イベントが保留され，以降に発生したJP1イベントは消去されます。

NEW

新しいJP1イベントを残したい場合に指定します。この場合，JP1イベントの保留件数を超過すると，古いJP1イベントから消去されます。

unset-extattr

属性を出力しない場合に指定します。JP1/Baseのバージョンが10-50以降の場合に，設定できます。監視名を出力しない場合は，TRAP_NAMEを指定します。監視IDを出力しない場合は，TRAP_IDを指定します。監視名と監視IDの両方を出力しない場合は，TRAP_NAMEとTRAP_IDをコンマ（,）区切りで指定します。監視名と監視IDの両方を出力しない指定例を次に示します。

（例）

TRAP_NAME,TRAP_ID

このパラメーターは，1行で記述します。

FILETYPE={ SEQ | SEQ2 | WRAP2 }

トラップするログファイルのデータ出力形式を指定します。省略した場合，SEQが指定されたものと見なします。

トラップするログファイルのデータ出力形式については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「8.6.3(1)　ログファイルトラップ情報の出力形式」を参照してください。

HEADLINE

読み込むログファイルの先頭にヘッダーがある場合，ヘッダーの行数を0〜99,999の範囲で指定します。省略した場合，ヘッダーがないものと見なします。

なお，指定したヘッダーに含まれる文字列のサイズが，ヘッダーサイズの上限（10キロバイト）を超えている場合は，エラーとなります。

MARKSTR=[!]"正規表現"

ログデータ以外のデータなど，監視の対象外にしたいデータを正規表現で指定します。省略した場合，指定がないものと見なします。正規表現は「"」で囲んでください。ログデータ以外のデータとは，一定間隔でログファイル中に出力されるデータなどです。ログデータ以外のデータの例を次に示します。

（例）

"==== 13:00:00 JP1/Base Event ===="

「!」を「"　"」の前に付けた場合，除外条件となり，指定した正規表現に一致しないデータを監視の対象外とします。

一つのMARKSTRには，複数の正規表現を指定できます。複数の正規表現を指定した場合，AND条件となり，「!」の指定も含むすべての正規表現の条件に一致するデータだけを監視対象外とします。なお，複数の正規表現を指定する場合は，正規表現の間を改行で区切ってください。2行目からは値だけを指定します。この場合，2行目以降の値の前に一つ以上の空白を入れてください。次に，「====」および「MARK」を含むデータを監視の対象外に指定する場合の例を示します。

（例）

MARKSTR="===="（改行）

△△△△△"MARK"

（凡例）△：空白

このパラメーターは複数指定できます。指定できる個数に制限はありません。複数指定した場合，OR条件となり，それぞれの指定に一致するデータをすべて監視対象外とします。

このパラメーターに指定した正規表現がチェックされるのは，入力したログデータのうち，先頭からjevlogstartコマンドの-mオプションで指定した長さまでの間だけです。このパラメーターを省略すると，ログデータ以外のデータはないと仮定されます。

ACTDEF＝[{EXIT}][重大度][イベントID][!]"正規表現"

JP1イベントに変換するログデータの正規表現と，対応するJP1イベントのイベントIDおよび重大度を指定します。省略した場合，指定がないものと見なします。正規表現に一致するログがあると，指定したイベントIDでJP1イベントを発行します。なお，「=」，「EXIT」，「重大度」，および「イベントID」の間にはスペースまたはタブを入れないでください。入れた場合は文法エラーになります。

EXIT

複数のACTDEFパラメーターを指定した場合に，「EXIT」を指定した条件に一致した時点で，そのログデータの監視を終了します。

複数のACTDEFパラメーターを指定した場合，一つのログデータが複数のACTDEFパラメーターの条件に一致すると，一致した数だけJP1イベントが発行されます。「EXIT」を指定しておくと，「EXIT」を指定した条件のイベントIDでJP1イベントが発行され，以降の監視は行われません。

重大度

JP1イベントの拡張属性の重大度を「<　>」で囲んで指定します。重大度とイベントIDは，対にして指定します。指定できる値を次に示します。

Emergency

Alert

Critical

Error

Warning

Notice

Information

Debug

指定を省略した場合はNoticeが仮定されます。

イベントID

イベントサーバにJP1イベントを登録する際のイベントIDを指定します。イベントIDは上位4バイト（基本コード）と下位4バイト（拡張コード）をコロン「:」で区切り，16進数で記述します。A〜Fは大文字で記述してください。なお，下位4バイトまたはコロン以下の下位4バイトは省略できます。この場合，省略値には0を仮定します。また，上位下位とも8桁に満たない場合は前から補われます。ユーザーが指定できる範囲の値，0:0〜1FFF:0および7FFF8000:0〜7FFFFFFF:0を指定してください。なお，拡張コードには0を指定してください。イベントIDの表記例を次に示します。

（例）

次に示す3とおりの表記は同じ意味になります。

0000011A:00000000

11A:0

11A

"正規表現"

JP1イベントに変換するログデータを正規表現で指定します。使用できる正規表現は拡張正規表現固定となります。正規表現は「"」で囲んでください。「!」を一つ目の「"　"」の手前に付けた場合，除外条件となり，指定した正規表現に一致しないデータを変換対象とします。

一つのACTDEFパラメーターには，複数の正規表現を指定できます。複数の正規表現を指定した場合，AND条件となり，「!」の指定も含むすべての正規表現の条件に一致するデータだけをJP1イベントに変換します。なお，複数の正規表現を指定する場合は，正規表現の間を改行で区切ってください。2行目からは正規表現だけを指定します。この場合，2行目以降の値の前に一つ以上の空白を入れてください。次に，「jp1base」および「error」を含むデータを，イベントID「00000333」でJP1イベントに変換する場合の指定例を示します。

（例）

ACTDEF=00000333 "jp1base"（改行）

△△△△△"error"

（凡例）△：空白

このパラメーターは複数指定できます。指定できる個数に制限はありません。複数指定した場合，OR条件となり，それぞれの指定に一致するデータをすべてJP1イベントに変換します。

このパラメーターに指定した正規表現がチェックされるのは，入力したログデータのうち，先頭から「起動オプションのイベント化するデータの最大長（バイト）」まで指定した長さまでの間だけです。

このパラメーターは省略できません。

定義例

MARKSTRパラメーターおよびACTDEFパラメーターの定義例

次に示すログデータを基に，MARKSTRパラメーターおよびACTDEFパラメーター部分の定義例を説明します。

定義例1

ログファイルトラップの条件を左に，ログファイルトラップ動作定義ファイルの定義例を右に示します。

定義例2

定義例1とは異なるログファイルトラップの条件を左に，ログファイルトラップ動作定義ファイルの定義例を右に示します。

リモート監視イベントログトラップ動作定義ファイル

形式

retry-times リトライ回数
retry-interval リトライ間隔
open-retry-times=リトライ回数（イベントログの収集のリトライ回数）
open-retry-interval=リトライ間隔（イベントログの収集のリトライ間隔）
trap-interval 監視間隔
matching-level 比較レベル
filter-check-level フィルターチェックレベル
# フィルター
filter　ログの種別　[id=イベントID]　[trap-name=監視名]
　　条件文1
　　条件文2
　　　：
　　条件文n
end-filter

ファイル

任意のファイルを使用します。

格納先ディレクトリ

Windowsの場合

任意のフォルダ

UNIXの場合

任意のディレクトリ

説明

リモート監視のイベントログトラップ機能の動作を定義するファイルです。リモート監視のイベントログトラップ機能の起動時にその内容を参照します。

UTF-8で保存する場合は，BOM（byte order mark）が付与されないように保存してください。

定義の反映時期

次の場合に，リモート監視イベントログトラップ動作定義ファイルの設定が有効になります。

［プロファイル表示/編集］画面でリロードまたは再起動

［プロファイル表示/編集］画面については，マニュアル「JP1/Integrated Management 3 - Manager 画面リファレンス」の「5.9　［プロファイル表示/編集］画面」を参照してください。

jcfaleltstartコマンドまたはjcfaleltreloadコマンドの実行

jcfaleltstartコマンドの詳細については，「jcfaleltstart（Windows限定）」（1.　コマンド）を参照してください。jcfaleltreloadコマンドの詳細については，「jcfaleltreload（Windows限定）」（1.　コマンド）を参照してください。

JP1/IM - Managerの再起動

記述内容

retry-times

一時的な通信障害で，イベントサービスへの接続に失敗した場合に行うリトライの回数を0〜86,400の範囲で指定します。省略した場合，リトライ処理はしません。指定された回数のリトライが成功しない場合はエラーとします。retry-timesおよびretry-intervalの組み合わせで24時間以上の設定もできますが，リトライを開始した時刻から24時間以上経過した場合，リトライ処理は打ち切られます。

retry-interval

一時的な通信障害で，イベントサービスへの接続に失敗した場合に行うリトライ間隔を1〜600（秒）の範囲で指定します。省略した場合，リトライ間隔を10秒と見なします。

open-retry-times

イベントログの収集に失敗，または監視対象ホストに接続できなかった場合に行うリトライの回数を1〜3,600の範囲で指定します。省略した場合，リトライ回数を3回と見なします。指定したリトライ回数を超えた場合，ログファイルの監視を停止します。

open-retry-interval

イベントログの収集に失敗，または監視対象ホストに接続できなかった場合に行うリトライ処理の間隔を3〜600（秒）の範囲で指定します。省略した場合，trap-intervalが指定されているときは，trap-intervalに指定した値になります。trap-intervalが指定されていないときは，300秒になります。リトライ間隔は，エラー発生後，リトライを試みるまでの間隔です。

trap-interval

イベントログを監視する間隔を60〜86,400（秒）の範囲で指定します。省略した場合，300秒と見なします。イベントログトラップは，一定の間隔でイベントログを監視します。

matching-level

フィルターにmessage属性またはcategory属性を指定した場合で，メッセージDLLまたはカテゴリーDLLが正しく設定されてないなどの理由で，イベントログの説明文の読み込みに失敗したときの，イベントログと定義内容の比較レベルを指定します。0を指定すると，比較しないで次のフィルターと比較をします。1を指定すると，比較します。省略した場合，0を指定したものと見なします。

filter-check-level

フィルターに不正な（システムに存在しない）ログの種別や不正な正規表現指定がある場合のチェックレベルを指定します。0を指定すると，フィルターに不正なログの種別や不正な正規表現がある場合，該当するフィルターを無効にします。ただし，有効なフィルターが一つでもある場合，リモート監視イベントログトラップの起動またはリロードは成功します。有効なフィルターが一つもない場合，リモート監視イベントログトラップの起動またはリロードは失敗します。1を指定すると，フィルターに不正なログの種別や不正な正規表現が一つでもある場合，リモート監視イベントログトラップの起動またはリロードは失敗します。

省略した場合，0を指定したものと見なします。

filter〜end-filter

ログの種別

監視の対象となるイベントログの種別を指定します。

（例）

"アプリケーション"または"Application"

"セキュリティ"または"Security"

"システム"または"System"

"DNS Server"

"Directory Service"

"ファイルレプリケーションサービス"または"File Replication Service"

"DFS レプリケーション"または"DFS Replication"

複数のフィルターに同一のログの種別を指定した場合，それらのフィルターのどれかの条件を満たすときに成立します。

[id=イベントID]

イベントサーバにJP1イベントを登録する際のイベントIDを指定します。イベントIDは上位4バイト（基本コード）と下位4バイト（拡張コード）をコロン「:」で区切り，16進数で記述します。A〜Fは大文字で記述してください。なお，下位4バイトまたはコロン以下の下位4バイトは省略できます。この場合，省略値には0を仮定します。また，上位下位とも8桁に満たない場合は前から補われます。ユーザーが指定できる範囲の値，0:0〜1FFF:0および7FFF8000:0〜7FFFFFFF:0を指定してください。「id=」と値の間には，スペースやタブを入れないでください。ログの種別と監視名の間には，スペースを入れてください。この値を省略すると，イベントID（00003A71）が指定されます。イベントIDの表記例を次に示します。

（例）

次に示す3とおりの表記は同じ意味になります。

0000011A:00000000

11A:0

11A

[trap-name=監視名]

イベントログを変換して登録されたJP1イベントが，どのフィルターに該当したものなのか判別する際の監視名を指定します。監視名の先頭の文字は，必ず英数字を指定してください。英大文字・英小文字を区別します。スペースやタブを入れないでください。このパラメーターを省略すると，JP1イベント変換時に拡張属性（E.JP1_TRAP_NAME）が作成されません。

条件文

条件文の指定は次のとおりです。

・属性指定にtype以外を指定した場合

属性指定　正規表現１　正規表現２　正規表現３ …

・属性指定にtypeを指定した場合

type ログの種類１ ログの種類２　ログの種類３ …

属性指定のあとに列挙された正規表現（またはログの種類）のどれかが成立した場合に成立します。なお，フィルター内の条件文はAND条件，フィルター間はOR条件です。

属性設定

属性設定は次のとおりです。

属性名

記述する内容

type

ログの種類

source

ソース

category

分類

id

イベントID

user

ユーザー

message

説明

computer

コンピュータ名

・注意事項

属性設定で"message"を指定した場合，イベントログの説明文で「〜に関する説明が見つかりませんでした」という説明文（メッセージDLLが存在しない説明文）を含んだイベントログは，メッセージを作成できません。このため，トラップ対象外となります。挿入句にトラップ対象の語句が含まれていたとしてもトラップされません。

上記の場合，Windowsのイベントログの仕組みに従って，イベントログの説明文を記載したメッセージDLLが正しく設定された状態でご利用ください。メッセージDLLが正しく設定されていないと，イベントログから説明文を読み込めないため，トラップの対象にできないことがあります。なお，メッセージDLLがないメッセージをトラップしたい場合は，matching-levelパラメーターを1に設定してください。

なお，監視できるログ情報の詳細については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「8.6.3　監視できるログ情報」を参照してください。

正規表現

正規表現は，’...’ のように引用符で囲まれた文字列で指定します。!’...’のように引用符の前に感嘆符を付加した場合，指定した正規表現以外の文字列という意味となります。正規表現中に ’ を指定する場合は ¥’ のようにエスケープ指定する必要があります。正規表現は，ログの種類がtype以外の場合に指定できます。

ログの種類

ログの種類は次のとおりです。

ログの種類

内容

重大度

Information

情報

Information（情報）

Warning

警告

Warning（警告）

Error

エラー

Error（エラー）

Audit_success

成功の監査

Notice（通知）

Audit_failure

失敗の監査

Notice（通知）

定義例

定義例1：OR条件とAND条件

OR条件の定義例

ログの種別が「システムログ」で，説明に「TEXT」，「MSG」，または「-W」のどれかを含む。

filter "System"
    message 'TEXT' 'MSG' '-W'
end-filter

条件をスペースまたはタブで区切って指定すると，OR条件になります。

AND条件の定義例

ログの種類が「システムログ」で，説明に「TEXT」，「MSG」，および「-W」をすべて含む。

filter "System"
    message 'TEXT'
    message 'MSG'
    message '-W'
end-filter

条件を改行で区切って指定すると，AND条件になります。改行した場合は，属性名から記述してください。

定義例2：複数のフィルターを設定する

ログの種別が「アプリケーションログ」のイベントログのうち，次に示す条件のイベントログをトラップする。

フィルター1

・種別：アプリケーションログ

・種類：エラー

・説明：「-E」および「JP1/Base」を含む。

フィルター2

・種別：アプリケーションログ

・種類：警告

・説明：「-W」または「warning」を含む。

#フィルター1
filter "Application"
    type Error
    message '-E'
    message 'JP1/Base'
end-filter
#フィルター2
filter "Application"
    type Warning
    message '-W' 'warning'
end-filter

定義例3：正規表現を使用する

次に示す条件のイベントログをトラップする。

種別：アプリケーションログ

種類：エラー

イベントID：111

説明：「-E」または「MSG」を含み，かつ「TEXT」を含まない。

filter "Application"
    type Error
    id '^111$'
    message '-E' 'MSG'
    message !'TEXT'
end-filter

「111」のイベントIDを条件にしたい場合は，正規表現を使用して，「id '^111$'」と指定してください。「id '111'」と指定すると，「イベントIDに111を含む」という条件になるため，イベントIDが「1112」や「0111」でも条件が成立します。「!」を「'　'」の手前に付けた場合は，指定した正規表現に一致しないデータを選択します。正規表現は，JP1/Baseの拡張正規表現固定となります。拡張正規表現の詳細については，マニュアル「JP1/Base 運用ガイド」の正規表現の文法を説明している個所を参照してください。

定義例4：特定のイベントログだけ変換しない

ログの種別が「システムログ」で，ログの種類が「警告」のイベントログのうち，次に示す条件のイベントログだけトラップしない。

ソース：AAA

イベントID：111

説明：「TEXT」を含む。

#ソースがAAAのイベントログはトラップしない。

filter "System"
    type Warning
    source !'AAA'
end-filter
#ソースがAAA，かつイベントIDが111以外のイベントログをトラップする。
filter "System"
    type Warning
    source 'AAA'
    id !'^111$'
end-filter
#ソースがAAA，イベントIDが111，かつ説明に「TEXT」を含まないイベントログをトラップする。
filter "System"
    type Warning
    source 'AAA'
    id '^111$'
    message !'TEXT'

end-filter

セットアップ情報ファイル（jimdbsetupinfo.conf）

形式

#IM DATABASE SERVICE - DB Size
IMDBSIZE=値
#IM DATABASE SERVICE - Data Storage Directory
IMDBDIR=値
#IM DATABASE SERVICE - Port Number
IMDBPORT=値
#IM DATABASE SERVICE - DB Install Directory
IMDBENVDIR=値
#IM DATABASE SERVICE - Host Name
IMDBHOSTNAME=値

ファイル

jimdbsetupinfo.conf（セットアップ情報ファイル）

jimdbsetupinfo.conf.model（セットアップ情報ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

Managerパス¥conf¥imdb¥setup¥

UNIXの場合

/etc/opt/jp1imm/conf/imdb/setup/

説明

統合監視DBおよびIM構成管理DBのセットアップ時に，IMデータベースのサイズやIMデータベースのデータを格納するディレクトリなどを記述するファイルです。

なお，セットアップ情報ファイルは，統合監視DBとIM構成管理DBのセットアップ時に共通で参照します。統合監視DBまたはIM構成管理DBをセットアップしたあとに，もう一方のデータベースを作成する場合には，同じ値を指定する必要があります。

セットアップ情報ファイルに指定するIMデータベースのサイズごとのおおよそのディスク占有量を，次の表に示します。

なお，次の表に記載の領域のほかに，IMデータベースのサイズに関わらず，IMデータベースインストール先ディレクトリ（IMDBENVDIR）に，約0.2ギガバイトの空き領域が必要です。ディスク占有量の詳細な値については，JP1/IM - Managerのリリースノートを参照してください。ディスク占有量を見積もる際は，JP1/IM - Managerのリリースノートに記載された値を使用してください。

表2‒87　作成するデータベースのサイズ

サイズ

システムDB領域※1※2（ギガバイト）

統合監視DB領域※1※3（ギガバイト）

IM構成管理DB領域※1※4（ギガバイト）

合計（ギガバイト）

S

2

9

2

13

M

3

33

2

38

L

7

98

11

116

注※1

セットアップ情報ファイルに指定したデータベース格納先ディレクトリ（IMDBDIR）の直下に作成されます。

注※2

IMデータベースをセットアップ中に作られる統合監視DBおよびIM構成管理DBが共有する領域です。

注※3

jcodbsetupコマンドを実行したときに作られる領域です。

注※4

jcfdbsetupコマンドを実行したときに作られる領域です。

定義の反映時期

セットアップ時に，このファイルの内容を読み込み，各項目に指定された値でIMデータベースの環境を構築します。

記述内容

IMDBSIZE

作成するIMデータベースのサイズを半角英大文字のS，M，Lで指定します。デフォルトはSです。

IMDBDIR

IMデータベースのデータを格納するディレクトリを絶対パス形式で指定します。指定したディレクトリの直下にimdbディレクトリを作成し，IMデータベースのファイル（領域）を格納します。デフォルトは次のとおりです。

Windowsの場合：Managerパス¥database

ネットワークドライブが指定された場合またはWindowsの予約デバイスファイルが指定された場合はエラーとなります。また，指定したディレクトリが存在しない場合は，コマンドの実行に失敗します。コマンドを実行する前に，必ずディレクトリを作成してください。

UNIXの場合：/var/opt/jp1imm/database

指定するディレクトリは，常にマウント状態にあるディレクトリを指定し，アンマウントされやすいディレクトリは指定しないでください。運用中にアンマウントされると，データベースの起動やアクセスに失敗します。また，指定したディレクトリが存在しない場合は，コマンドの実行に失敗します。コマンドを実行する前に，必ずディレクトリを作成してください。

必要なディレクトリの権限は表2-88を参照してください。

絶対パス形式で使用できる文字列を次に示します。

Windowsの場合：

半角英数字，_，¥，(，)，.（ピリオド），および半角スペースで構成される95文字以内の文字列です。ドライブ名で始める必要があります。

UNIXの場合：

半角英数字，_，/，および.（ピリオド）で構成される95文字以内の文字列です。パス区切り文字（/）で始める必要があります。

IMDBPORT

IMデータベースが使用するポート番号を指定します。指定できる範囲は，5001〜65535です。デフォルトは20700です。

ここで指定するポート番号は，次のポート番号とは重複できません。

ほかの論理ホストのセットアップで指定したポート番号

servicesファイルに記載されているポート番号※

ほかの製品の組み込みHiRDBで使用しているポート番号

ほかの製品，OSなどが使用する一時ポート番号

注※　IMDBPORTに設定したポート番号を，あとでservicesファイルに記載しないようにしてください。

IMDBENVDIR

IMデータベースをインストールするディレクトリを絶対パス形式で指定します。指定したディレクトリの直下にディレクトリ（JMn：nはLOGICALHOSTNUMBERと一致します）を作成し，IMデータベースをインストールします。デフォルトは次のとおりです。

Windowsの場合：Managerパス¥dbms

ネットワークドライブが指定された場合またはWindowsの予約デバイスファイルが指定された場合はエラーとなります。また，指定したディレクトリが存在しない場合は，コマンドの実行に失敗します。コマンドを実行する前に，必ずディレクトリを作成してください。

UNIXの場合：/var/opt/jp1imm/dbms

指定するディレクトリは，常にマウント状態にあるディレクトリを指定し，アンマウントされやすいディレクトリは指定しないでください。運用中にアンマウントされると，データベースの起動やアクセスに失敗します。また，指定したディレクトリが存在しない場合は，コマンドの実行に失敗します。コマンドを実行する前に，必ずディレクトリを作成してください。

また，シンボリックリンクを含むパスは指定しないでください。

ディレクトリの権限を次の表に示します。

表2‒88　OSとディレクトリ権限の対応

OS

権限

Linux

所有者：root

グループ：root

モード：755

絶対パス形式で使用できる文字列を次に示します。

Windowsの場合：

半角英数字，_，¥，(，)，および半角スペースで構成される195文字以内の文字列です。ドライブ名で始める必要があります。

UNIXの場合：

半角英数字，_，/，および.（ピリオド）で構成される123文字以内（Linuxの場合は22文字以内）の文字列です。パス区切り文字（/）で始める必要があります。

IMDBHOSTNAME

ほかのホストで動作するJP1/IM - MOおよびJP1/OAとの通信に使用するホスト名，またはIPアドレスを指定します。ほかのホストのJP1/IM - MOおよびJP1/OAと連携していない場合は，この項目を指定する行を記載しないでください。

デフォルトは，ローカルホスト名です。値を省略した場合は，ローカルホスト名が仮定されます。使用できる文字列は，32文字以内の半角英数字，-，および.（ピリオド）です。

定義例

#IM DATABASE SERVICE - DB Size
IMDBSIZE=S
#IM DATABASE SERVICE - Data Storage Directory
IMDBDIR=Managerパス¥database
#IM DATABASE SERVICE - Port Number
IMDBPORT=20700
#IM DATABASE SERVICE - DB Install Directory
IMDBENVDIR=Managerパス¥dbms
#IM DATABASE SERVICE - DB Host Name
IMDBHOSTNAME=

クラスタセットアップ情報ファイル（jimdbclustersetupinfo.conf）

形式

#IM DATABASE SERVICE - Logical Host Number
LOGICALHOSTNUMBER=値
#IM DATABASE SERVICE - Logical Host Name
LOGICALHOSTNAME=値
#IM DATABASE SERVICE - DB Size
IMDBSIZE=S
#IM DATABASE SERVICE - Port Number
IMDBPORT=値
#IM DATABASE SERVICE - Data Storage Directory (Local Work Area)
IMDBDIR=Managerパス¥db
#IM DATABASE SERVICE - Data Storage Directory (Shared Data Area)
SHAREDBDIR=共有ディレクトリ¥db
#IM DATABASE SERVICE - Online Host Name
ONLINEHOSTNAME=値
#IM DATABASE SERVICE - DB Install Directory
IMDBENVDIR=Managerパス¥dbms

ファイル

jimdbclustersetupinfo.conf（クラスタセットアップ情報ファイル）

jimdbclustersetupinfo.conf.model（クラスタセットアップ情報ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

Managerパス¥conf¥imdb¥setup¥

UNIXの場合

/etc/opt/jp1imm/conf/imdb/setup/

説明

統合監視DBおよびIM構成管理DBのクラスタ環境のセットアップ時に，論理ホスト用のIMデータベースのサイズや論理ホスト用のIMデータベースのデータを格納するディレクトリなどを記述するファイルです。

なお，クラスタセットアップ情報ファイルは，統合監視DBとIM構成管理DBのセットアップ時に共通で参照します。統合監視DBまたはIM構成管理DBをセットアップしたあとに，もう一方のデータベースを作成する場合には，同じ値を指定する必要があります。また，クラスタ環境を構築する場合，待機系のセットアップをするときは，実行系で使用したクラスタセットアップ情報ファイルをコピーし，実行してください。同一ホストに複数の論理ホストを設定する場合は，jimdbclustersetupinfo.conf（クラスタセットアップ情報ファイル）を別名でコピーし，設定情報を変更する必要があります。

クラスタセットアップ情報ファイルに指定するIMデータベースのサイズごとのおおよそのディスク占有量を，次の表に示します。

なお，次の表に記載の領域のほかに，IMデータベースのサイズに関わらず，ローカルディスクのIMデータベースインストール先ディレクトリ（IMDBENVDIR）に，約0.2ギガバイトの空き領域が必要です。ディスク占有量の詳細な値については，JP1/IM - Managerのリリースノートを参照してください。ディスク占有量を見積もる際は，JP1/IM - Managerのリリースノートに記載された値を使用してください。

表2‒89　作成するデータベースのサイズ

サイズ

ローカルディスク

共有ディスク

システムDB領域（ローカルディスク）※1（ギガバイト）

システムDB領域（共有ディスク）※2（ギガバイト）

統合監視DB領域※2（ギガバイト）

IM構成管理DB領域※2（ギガバイト）

合計（ギガバイト）

S

0.1

2

9

2

13

M

0.1

3

33

2

38

L

0.2

7

98

11

116

注※1

システムDB領域（ローカルディスク）は，クラスタセットアップ情報ファイルに指定したローカルデータベース格納ディレクトリの直下（IMDBDIR）に作成されます。

注※2

システムDB領域（共有ディスク），統合監視DB領域とIM構成管理DB領域は，クラスタセットアップ情報ファイルに指定した共有データベース格納先ディレクトリ（SHAREDBDIR）の直下に作成されます。

定義の反映時期

セットアップ時に，このファイルの内容を読み込み，各項目に指定された値で論理ホスト用のIMデータベースの環境を構築します。

記述内容

LOGICALHOSTNUMBER

論理ホスト用のIMデータベースで論理ホストを識別する番号を1〜9の半角数値で指定します。

論理ホストを追加する場合は，別の番号を指定する必要があります。実行系と待機系で同じ番号を指定してください。

LOGICALHOSTNAME

論理ホスト名を指定します。論理ホスト名には，jp1cohasetupコマンドおよびjp1cc_setup_clusterコマンドで指定した論理ホスト名を指定してください。IMデータベースは，jp1hostsファイルおよびjp1hosts2ファイルを参照しません。このため，LOGICALHOSTNAMEにはhostsファイルなどOSの機能で名前解決できる論理ホスト名を指定してください。指定できる文字列は，半角英数字および-で構成される32文字以内の文字列です。

なお，論理ホスト名は，大文字・小文字を区別します。論理ホスト名には，JP1/Baseで設定した論理ホスト名を，大文字・小文字を含めて正確に指定してください。論理ホストのJP1/Baseのセットアップについては，マニュアル「JP1/Integrated Management 3 - Manager 構築ガイド」の次の個所を参照してください。

Windowsの場合

参照先：7.4.3(2)　JP1/Baseのセットアップ

UNIXの場合

参照先：8.4.3(2)　JP1/Baseのセットアップ

IMDBSIZE

作成する論理ホスト用のIMデータベースのサイズを半角英大文字のS，M，Lで指定します。デフォルトはSです。

IMDBDIR

論理ホスト用のIMデータベースのデータを格納するディレクトリを絶対パス形式で指定します。クラスタの共有ディスクは指定しないでください。指定したディレクトリの直下にimdbディレクトリを作成し，論理ホスト用のIMデータベースのファイル（ローカル作業領域用）を格納します。

Windowsの場合：

ネットワークドライブが指定された場合またはWindowsの予約デバイスファイルが指定された場合はエラーとなります。また，指定したディレクトリが存在しない場合は，コマンドの実行に失敗します。コマンドを実行する前に，必ずディレクトリを作成してください。

UNIXの場合：

指定するディレクトリは，常にマウント状態にあるディレクトリを指定し，アンマウントされやすいディレクトリは指定しないでください。運用中にアンマウントされると，データベースの起動やアクセスに失敗します。また，指定したディレクトリが存在しない場合は，コマンドの実行に失敗します。コマンドを実行する前に，必ずディレクトリを作成してください。

ディレクトリの権限を次の表に示します。

表2‒90　OSとディレクトリ権限の対応

OS

権限

Linux

所有者：root

グループ：root

モード：755

絶対パス形式で使用できる文字列を次に示します。

Windowsの場合：

半角英数字，_，¥，(，)，.（ピリオド），および半角スペースで構成される95文字以内の文字列です。ドライブ名で始める必要があります。

UNIXの場合：

半角英数字，_，/，および.（ピリオド）で構成される95文字以内の文字列です。パス区切り文字（/）で始める必要があります。

IMDBPORT

論理ホスト用のIMデータベースが使用するポート番号を指定します。指定できる範囲は，5001〜65535です。

ここで指定するポート番号は，次のポート番号とは重複できません。

ほかの論理ホストのセットアップで指定したポート番号

servicesファイルに記載されているポート番号※

ほかの製品の組み込みHiRDBで使用しているポート番号

ほかの製品，OSなどが使用する一時ポート番号

注※　IMDBPORTに設定したポート番号を，あとでservicesファイルに記載しないようにしてください。

SHAREDBDIR

クラスタ構成時に実行系と待機系で共有する，論理ホスト用のIMデータベースのデータを格納するディレクトリを絶対パス形式で指定します。共有ディスク上のディレクトリを指定してください。指定したディレクトリの直下にimdbディレクトリを作成し，論理ホスト用のIMデータベースのファイル（共有データ領域用）を格納します。

絶対パス形式で使用できる文字列を次に示します。

Windowsの場合：

半角英数字，_，¥，(，)，.（ピリオド），および半角スペースで構成される95文字以内の文字列です。ドライブ名で始める必要があります。

ネットワークドライブが指定された場合またはWindowsの予約デバイスファイルが指定された場合はエラーとなります。また，指定したディレクトリが存在しない場合は，コマンドの実行に失敗します。コマンドを実行する前に，必ずディレクトリを作成してください。

UNIXの場合：

半角英数字，_，/，および.（ピリオド）で構成される95文字以内の文字列です。パス区切り文字（/）で始める必要があります。

指定するディレクトリは，常にマウント状態にあるディレクトリを指定し，アンマウントされやすいディレクトリは指定しないでください。運用中にアンマウントされると，データベースの起動やアクセスに失敗します。また，指定したディレクトリが存在しない場合は，コマンドの実行に失敗します。コマンドを実行する前に，必ずディレクトリを作成してください。

必要なディレクトリの権限は表2-90を参照してください。

ONLINEHOSTNAME

実行系のホスト名を指定します。実行系のホスト名には，名前解決できるホスト名を指定してください。指定できる文字列は，半角英数字，-，および.（ピリオド）で構成される32文字以内の文字列です。なお，実行系のホスト名は，大文字・小文字を区別します。実行系のホスト名は大文字・小文字を含めて正確に指定してください。

IMDBENVDIR

論理ホスト用のIMデータベースをインストールするディレクトリを絶対パス形式で指定します。クラスタの共有ディスクは指定しないでください。指定したディレクトリの直下にディレクトリ（JMn：nはLOGICALHOSTNUMBERと一致します）を作成し，論理ホスト用のIMデータベースをインストールします。デフォルトは次のとおりです。

Windowsの場合：Managerパス¥dbms

ネットワークドライブが指定された場合またはWindowsの予約デバイスファイルが指定された場合はエラーとなります。また，指定したディレクトリが存在しない場合は，コマンドの実行に失敗します。コマンドを実行する前に，必ずディレクトリを作成してください。

UNIXの場合：/var/opt/jp1imm/dbms

指定するディレクトリは，常にマウント状態にあるディレクトリを指定し，アンマウントされやすいディレクトリは指定しないでください。運用中にアンマウントされると，データベースの起動やアクセスに失敗します。また，指定したディレクトリが存在しない場合は，コマンドの実行に失敗します。コマンドを実行する前に，必ずディレクトリを作成してください。

また，シンボリックリンクを含むパスは指定しないでください。

必要なディレクトリの権限は表2-90を参照してください。

絶対パス形式で使用できる文字列を次に示します。

Windowsの場合：

半角英数字，_，¥，(，)，および半角スペースで構成される195文字以内の文字列です。ドライブ名で始める必要があります。

UNIXの場合：

半角英数字，_，/，および.（ピリオド）で構成される123文字以内（Linuxの場合は22文字以内）の文字列です。パス区切り文字（/）で始める必要があります。

定義例

#IM DATABASE SERVICE - Logical Host Number
LOGICALHOSTNUMBER=1
#IM DATABASE SERVICE - Logical Host Name
LOGICALHOSTNAME=host1
#IM DATABASE SERVICE - DB Size
IMDBSIZE=S
#IM DATABASE SERVICE - Data Storage Directory (Local Work Area)
IMDBDIR=Managerパス¥db
#IM DATABASE SERVICE - Port Number
IMDBPORT=20750
#IM DATABASE SERVICE - Data Storage Directory (Shared Data Area)
SHAREDBDIR=共有ディレクトリ¥db
#IM DATABASE SERVICE - Online Host Name
ONLINEHOSTNAME=host_H1
#IM DATABASE SERVICE - DB Install Directory
IMDBENVDIR=Managerパス¥dbms

インテリジェント統合管理データベースセットアップ情報ファイル（jimgndbsetupinfo.conf）

形式

#IM GNDATABASE SERVICE - Port Number
IMGNDBPORT=インテリジェント統合管理データベースのポート番号
#TREND DATA MANEGEMENT SERVICE - Port Number
TDMSPORT=トレンドデータ管理サービスのポート番号
#IM GNDATABASE SERVICE - Data Storage Directory
IMGNDBDIR=インテリジェント統合管理データベースのデータ格納ディレクトリ
#IM GNDATABASE SERVICE - Data Base Binary
IMGNDBENVDIR=インテリジェント統合管理データベースのインストール先ディレクトリ
#IM GNDATABASE SERVICE - Retention
RETENTION=トレンドデータ管理DBの時系列データの保存期間
#IM GNDATABASE SERVICE - Username
USERNAME=インテリジェント統合管理データベースの起動に使用するOSのユーザー名
# TREND DATA DATABASE - MAX DISK SIZE [GB]
TDDBDISKMAX=トレンドデータ管理DBの最大ディスク所要量
# TREND DATA DATABASE - CUT-OFF TERM [Days]
TDDBCUTOFFTERM=トレンドデータを削除する場合の切り捨て期間

ファイル

jimgndbsetupinfo.conf※

jimgndbsetupinfo.conf.model（モデルファイル）

注※　インストーラーによって，モデルファイルの複製から拡張子「.model」を削除して作成されます。

格納先ディレクトリ

Windowsの場合

Managerパス¥conf¥imgndb¥setup¥

Linuxの場合

/etc/opt/jp1imm/conf/imgndb/setup/

説明

インテリジェント統合管理データベースのセットアップ時に必要な定義を記述するファイルです。

文字コード

ASCII（マルチバイトは指定できません）

定義の反映時期

セットアップ時（jimgndbsetupコマンドの実行時）に，このファイルの内容を読み込み，各項目に指定された値でインテリジェント統合管理データベースの環境を構築します。

記述内容

IMGNDBPORT=インテリジェント統合管理データベースのポート番号

インテリジェント統合管理データベースが使用するポート番号を指定します。

指定するポート番号は，システムおよびセットアップで作成するホスト単位で一意の値である必要があります。

デフォルトは20705です。指定を省略した場合は，デフォルトの値が仮定されます。

運用中に設定を変更する場合，この値を変更して，jimgndbsetupコマンドを実行します。コマンドの延長でサービスを再起動し，反映されます。

TDMSPORT=トレンドデータ管理サービスのポート番号

トレンドデータ管理サービスが使用するポート番号を指定します。

指定するポート番号はシステムおよびセットアップで作成するホスト単位で一意の値である必要があります。

デフォルトは20706です。指定を省略した場合は，デフォルトの値が仮定されます。

運用中に設定を変更する場合，この値を変更して，jimgndbsetupコマンドを実行します。コマンドの延長でサービスを再起動し，反映されます。

IMGNDBDIR=インテリジェント統合管理データベースのデータ格納ディレクトリ

インテリジェント統合管理データベースのデータを格納するディレクトリを絶対パス形式で指定します。

Windowsの場合

半角英数字，「_」（アンダースコア），「¥」，「(」，「)」，「.」（ピリオド），および半角スペースで構成される100文字以内の文字列で指定してください。

Linuxの場合

半角英数字，「_」（アンダースコア），「/」（スラッシュ），および「.」（ピリオド）で構成される100文字以内の文字列で指定してください。

セットアップ時，指定したディレクトリの直下にimgndbディレクトリを作成し，トレンドデータ管理DBを構築します。すでにトレンドデータ管理DBを構築済みの場合は，構築時の指定内容から変更できません。

デフォルトは次のとおりです。

Windowsの場合：Managerパス¥database

Linuxの場合：/var/opt/jp1imm/database

指定を省略した場合は，デフォルトの値が仮定されます。

IMGNDBENVDIR=インテリジェント統合管理データベースのインストール先ディレクトリ

インテリジェント統合管理データベースをインストールするディレクトリを絶対パス形式で指定します。

Windowsの場合

半角英数字，「_」（アンダースコア），「¥」，「(」，「)」，「.」（ピリオド），および半角スペースで構成される200文字以内の文字列で指定してください。

Linuxの場合

半角英数字，「_」（アンダースコア），「/」（スラッシュ），および「.」（ピリオド）で構成される200文字以内の文字列で指定してください。

セットアップ時，指定したディレクトリの直下にimgndbbinディレクトリを作成し，インテリジェント統合管理データベースを展開します。すでにインテリジェント統合管理データベースを構築済みの場合は，構築時の指定内容から変更できません。

デフォルトは次のとおりです。

Windowsの場合：Managerパス¥dbms

Linuxの場合：/var/opt/jp1imm/dbms

指定を省略した場合は，デフォルトの値が仮定されます。

RETENTION=トレンドデータ管理DBの時系列データ保存期間

トレンドデータ管理DBに保存したデータの保存期間（単位：日）を指定します。

指定できる範囲は，1〜1096です。

デフォルトは32です。指定を省略した場合は，デフォルトの値が仮定されます。

運用中に設定を変更する場合，この値を変更して，jimgndbsetupコマンドを実行します。コマンドの延長でサービスを再起動し，反映されます。

USERNAME=インテリジェント統合管理データベースの起動に使用するOSユーザー名

Linux環境でインテリジェント統合管理データベースを起動するOSユーザー名（root以外のユーザーで実際に存在するユーザー，かつ，ログイン可能なユーザー）を指定します。Windows環境で指定した場合は無視されます。

デフォルトの値はありません。指定は省略できません。

運用中に設定を変更する場合，この値を変更して，jimgndbsetupコマンドを実行します。コマンドの延長でサービスを再起動し，反映されます。

TDDBDISKMAX=トレンドデータ管理DBの最大ディスク所要量

トレンドデータ管理DBのディスク所要量の上限（単位：ギガバイト）を指定します。トレンドデータ管理DBのディスク所要量がこの値の90％を超えた場合に，データの自動削除が行われます。0を指定した場合は，上限を設定しません。

指定できる範囲は，0または10〜131072です。

デフォルトは150です。指定を省略した場合は，デフォルトの値が仮定されます。

運用中に設定を変更する場合，この値を変更して，jimgndbsetupコマンドを実行します。コマンドの延長でサービスを再起動し，反映されます。

注意事項

トレンドデータ管理DBのディスク所要量の監視機能を利用する場合，この項目には，トレンドデータ管理DBに格納されるトレンドデータの10日分のデータサイズを超える値を指定することを推奨します。

TDDBCUTOFFTERM=トレンドデータを削除する場合の切り捨て期間

トレンドデータ管理DBのディスク所要量がTDDBDISKMAXに指定したサイズの90％に達した場合に，削除するトレンドデータの期間（単位：日）を指定します。TDDBDISKMAXに0を指定した場合，この項目は無視されます。

指定できる範囲は，1〜31です。

デフォルトは7です。指定を省略した場合は，デフォルトの値が仮定されます。

運用中に設定を変更する場合，この値を変更して，jimgndbsetupコマンドを実行します。コマンドの延長でサービスを再起動し，反映されます。

定義例

Windowsの場合

#IM GNDATABASE SERVICE - Port Number
IMGNDBPORT=20705
#TREND DATA MANEGEMENT SERVICE - Port Number
TDMSPORT=20706
#IM GNDATABASE SERVICE - Data Storage Directory
IMGNDBDIR=C:¥Program Files (x86)¥Hitachi¥JP1IMM¥database
#IM GNDATABASE SERVICE - Data Base Binary
IMGNDBENVDIR=C:¥Program Files (x86)¥Hitachi¥JP1IMM¥dbms
# IM GNDATABASE SERVICE - Retention
RETENTION=32
# TREND DATA DATABASE - MAX DISK SIZE [GB]
TDDBDISKMAX=764
# TREND DATA DATABASE - CUT-OFF TERM [Days]
TDDBCUTOFFTERM=7

Linuxの場合

#IM GNDATABASE SERVICE - Port Number
IMGNDBPORT=20705
#TREND DATA MANEGEMENT SERVICE - Port Number
TDMSPORT=20706
#IM GNDATABASE SERVICE - Data Storage Directory
IMGNDBDIR=/var/opt/jp1imm/database
#IM GNDATABASE SERVICE - Data Base Binary
IMGNDBENVDIR=/var/opt/jp1imm/dbms
# IM GNDATABASE SERVICE - Retention
RETENTION=32
# IM GNDATABASE SERVICE - Username
USERNAME=USER01
# TREND DATA DATABASE - MAX DISK SIZE [GB]
TDDBDISKMAX=764
# TREND DATA DATABASE - CUT-OFF TERM [Days]
TDDBCUTOFFTERM=7

クラスタ環境インテリジェント統合管理データベースセットアップ情報ファイル（jimgndbclustersetupinfo.conf）

形式

#IM DATABASE SERVICE - Logical Host Name
LOGICALHOSTNAME=インテリジェント統合管理データベースの論理ホスト名
#IM GNDATABASE SERVICE - Port Number
IMGNDBPORT=インテリジェント統合管理データベースのポート番号
#TREND DATA MANEGEMENT SERVICE - Port Number
TDMSPORT=トレンドデータ管理サービスのポート番号
#IM DATABASE SERVICE - Data Storage Directory (Shared Data Area)
SHAREGNDBDIR=インテリジェント統合管理データベースのデータ格納ディレクトリ
#IM GNDATABASE SERVICE - Data Base Binary
IMGNDBENVDIR=インテリジェント統合管理データベースのインストール先ディレクトリ
#IM DATABASE SERVICE - Logical Host Number
LOGICALHOSTNUMBER=論理ホスト番号
#IM GNDATABASE SERVICE - Retention
RETENTION=トレンドデータ管理DBの時系列データの保存期間
#IM GNDATABASE SERVICE - Username
USERNAME=インテリジェント統合管理データベースの起動に使用するOSのユーザー名
# TREND DATA DATABASE - MAX DISK SIZE [GB]
TDDBDISKMAX=トレンドデータ管理DBの最大ディスク所要量
# TREND DATA DATABASE - CUT-OFF TERM [Days]
TDDBCUTOFFTERM=トレンドデータを削除する場合の切り捨て期間

ファイル

jimgndbclustersetupinfo.conf※

jimgndbclustersetupinfo.conf.model（モデルファイル）

注※　インストーラーによって，モデルファイルの複製から拡張子「.model」を削除して作成されます。

格納先ディレクトリ

Windowsの場合

Managerパス¥conf¥imgndb¥setup¥

Linuxの場合

/etc/opt/jp1imm/conf/imgndb/setup/

説明

インテリジェント統合管理データベースのクラスタ環境のセットアップ時に必要な定義を記述するファイルです。

文字コード

ASCII（マルチバイトは指定できません）

定義の反映時期

クラスタ環境のセットアップ時（jimgndbsetupコマンド（-hオプション指定）の実行時）に，このファイルの内容を読み込み，各項目に指定された値で論理ホスト用のインテリジェント統合管理データベースの環境を構築します。

記述内容

LOGICALHOSTNAME=インテリジェント統合管理データベースの論理ホスト名

インテリジェント統合管理データベースの論理ホスト名を指定します。

指定できる文字列は，半角英数字および「-」（ハイフン）で構成される63バイト以内の文字列です。大文字と小文字は区別されます。

値が空の場合，または指定を省略した場合，jimgndbsetupコマンドの実行時には，jimgndbsetupコマンドの-hオプションに指定した値が使用されます。

また，論理ホスト名には，OS上で名前解決できるホスト名を指定してください。

デフォルトの値はありません。

IMGNDBPORT=インテリジェント統合管理データベースのポート番号

インテリジェント統合管理データベースが使用するポート番号を指定します。

指定するポート番号は，システムおよびセットアップで作成するホスト単位で一意の値である必要があります。

デフォルトの値はありません。指定は省略できません。

運用中に設定を変更する場合，この値を変更して，jimgndbsetupコマンドを実行します。論理ホスト環境では，コマンドの延長でサービスは再起動せず停止したままとなるため，コマンドの実行後に手動でサービスを開始する必要があります。

TDMSPORT=トレンドデータ管理サービスのポート番号

トレンドデータ管理サービスが使用するポート番号を指定します。

指定するポート番号はシステムおよびセットアップで作成するホスト単位で一意の値である必要があります。

デフォルトの値はありません。指定は省略できません。

運用中に設定を変更する場合，この値を変更して，jimgndbsetupコマンドを実行します。論理ホスト環境では，コマンドの延長でサービスは再起動せず停止したままとなるため，コマンドの実行後に手動でサービスを開始する必要があります。

SHAREGNDBDIR=インテリジェント統合管理データベースのデータ格納ディレクトリ

論理ホスト用のインテリジェント統合管理データベースのデータを格納するクラスタ環境の共有ディスク上のディレクトリを絶対パス形式で指定します。

Windowsの場合

半角英数字，「_」（アンダースコア），「¥」，「(」，「)」，「.」（ピリオド），および半角スペースで構成される100文字以内の文字列で指定してください。

Linuxの場合

半角英数字，「_」（アンダースコア），「/」（スラッシュ），および「.」（ピリオド）で構成される100文字以内の文字列で指定してください。

セットアップ時，指定したディレクトリの直下に「imgndb+論理ホスト番号」のディレクトリを作成し，インテリジェント統合管理データベースを構築します。すでにインテリジェント統合管理データベースを構築済みの場合は，構築時の指定内容から変更できません。

デフォルトの値はありません。指定は省略できません。

IMGNDBENVDIR=インテリジェント統合管理データベースのインストール先ディレクトリ

論理ホスト用のインテリジェント統合管理データベースをインストールするローカルディスク上のディレクトリを絶対パス形式で指定します。クラスタ環境の共有ディスクは指定しないでくさい。

Windowsの場合

半角英数字，「_」（アンダースコア），「¥」，「(」，「)」，「.」（ピリオド），および半角スペースで構成される200文字以内の文字列で指定してください。

Linuxの場合

半角英数字，「_」（アンダースコア），「/」（スラッシュ），および「.」（ピリオド）で構成される200文字以内の文字列で指定してください。

セットアップ時，指定したディレクトリの直下に「imgndbbin+論理ホスト番号」のディレクトリを作成し，インテリジェント統合管理データベースを展開します。すでにインテリジェント統合管理データベースを構築済みの場合は，構築時の指定内容から変更できません。

デフォルトは次のとおりです。

Windowsの場合：Managerパス¥dbms

Linuxの場合：/var/opt/jp1imm/dbms

指定を省略した場合は，デフォルトの値が仮定されます。

LOGICALHOSTNUMBER=論理ホスト番号

論理ホスト用のインテリジェント統合管理データベースで論理ホストを識別する番号を1〜9の半角数値で指定します。

論理ホストを追加する場合は，すでに存在する番号と同じ番号は指定できません。

実行系と待機系で同じ番号を指定してください。

すでにインテリジェント統合管理データベースを構築済みの場合は，構築時の指定内容から変更できません。

デフォルトの値はありません。指定は省略できません。

RETENTION=トレンドデータ管理DBの時系列データ保存期間

トレンドデータ管理DBに保存したデータの保存期間（単位：日）を指定します。

指定できる範囲は，1〜1096です。

デフォルトは32です。指定を省略した場合は，デフォルトの値が仮定されます。

運用中に設定を変更する場合，この値を変更して，jimgndbsetupコマンドを実行します。論理ホスト環境では，コマンドの延長でサービスは再起動せず停止したままとなるため，コマンドの実行後に手動でサービスを開始する必要があります。

USERNAME=インテリジェント統合管理データベースの起動に使用するOSユーザー名

Linux環境でインテリジェント統合管理データベースを起動するOSユーザー名（root以外のユーザーで実際に存在するユーザー，かつ，ログイン可能なユーザー）を指定します。Windows環境で指定した場合は無視されます。

デフォルトの値はありません。指定は省略できません。

運用中に設定を変更する場合，この値を変更して，jimgndbsetupコマンドを実行します。論理ホスト環境では，コマンドの延長でサービスは再起動せず停止したままとなるため，コマンドの実行後に手動でサービスを開始する必要があります。

TDDBDISKMAX=トレンドデータ管理DBの最大ディスク所要量

トレンドデータ管理DBのディスク所要量の上限（単位：ギガバイト）を指定します。トレンドデータ管理DBのディスク所要量がこの値の90％を超えた場合に，データの自動削除が行われます。0を指定した場合は，上限を設定しません。

指定できる範囲は，0または10〜131072です。

デフォルトは150です。指定を省略した場合は，デフォルトの値が仮定されます。

運用中に設定を変更する場合，この値を変更して，jimgndbsetupコマンドを実行します。コマンドの延長でサービスを再起動し，反映されます。

注意事項

トレンドデータ管理DBのディスク所要量の監視機能を利用する場合，この項目には，トレンドデータ管理DBに格納されるトレンドデータの10日分のデータサイズを超える値を指定することを推奨します。

TDDBCUTOFFTERM=トレンドデータを削除する場合の切り捨て期間

トレンドデータ管理DBのディスク所要量がTDDBDISKMAXに指定したサイズの90％に達した場合に，削除するトレンドデータの期間（単位：日）を指定します。TDDBDISKMAXに0を指定した場合，この項目は無視されます。

指定できる範囲は，1〜31です。

デフォルトは7です。指定を省略した場合は，デフォルトの値が仮定されます。

運用中に設定を変更する場合，この値を変更して，jimgndbsetupコマンドを実行します。コマンドの延長でサービスを再起動し，反映されます。

定義例

Windowsの場合

#IM DATABASE SERVICE - Logical Host Number
LOGICALHOSTNUMBER=1
#IM DATABASE SERVICE - Logical Host Name
LOGICALHOSTNAME=
#IM GNDATABASE SERVICE - Port Number
IMGNDBPORT=5433
#TREND DATA MANEGEMENT SERVICE - Port Number
TDMSPORT=5434
#IM DATABASE SERVICE - Data Storage Directory (Shared Data Area)
SHAREGNDBDIR=S:¥share¥JP1IMM¥gndb
#IM GNDATABASE SERVICE - Data Base Binary
IMGNDBENVDIR=C:¥Program Files (x86)¥Hitachi¥JP1IMM¥dbms
# IM GNDATABASE SERVICE - Retention
RETENTION=32
# TREND DATA DATABASE - MAX DISK SIZE [GB]
TDDBDISKMAX=764
# TREND DATA DATABASE - CUT-OFF TERM [Days]
TDDBCUTOFFTERM=7

Linuxの場合

#IM DATABASE SERVICE - Logical Host Number
LOGICALHOSTNUMBER=1
#IM DATABASE SERVICE - Logical Host Name
LOGICALHOSTNAME=
#IM GNDATABASE SERVICE - Port Number
IMGNDBPORT=5433
#TREND DATA MANEGEMENT SERVICE - Port Number
TDMSPORT=5434
#IM DATABASE SERVICE - Data Storage Directory (Shared Data Area)
SHAREGNDBDIR=/share/jp1imm/gndb
#IM GNDATABASE SERVICE - Data Base Binary
IMGNDBENVDIR=/var/opt/jp1imm/dbms
# IM GNDATABASE SERVICE - Retention
RETENTION=32
# IM GNDATABASE SERVICE - Username
USERNAME=USER01
# TREND DATA DATABASE - MAX DISK SIZE [GB]
TDDBDISKMAX=764
# TREND DATA DATABASE - CUT-OFF TERM [Days]
TDDBCUTOFFTERM=7

インテリジェント統合管理データベースの設定ファイル（postgresql.conf）

形式

パラメーター = JP1/IM - Managerでの設定値
パラメーター = JP1/IM - Managerでの設定値
　　：
パラメーター = JP1/IM - Managerでの設定値

ファイル

postgresql.conf

postgresql.conf.model（モデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Managerパス¥conf¥imgndb¥

論理ホストのとき

共有フォルダ※¥jp1imm¥conf¥imgndb¥

Linuxの場合

物理ホストのとき

/etc/opt/jp1imm/conf/imgndb/

論理ホストのとき

共有ディレクトリ※/jp1imm/conf/imgndb/

注※

JP1/IM - Managerの論理ホスト環境の構築時に指定している共有ディスク上のディレクトリ（論理ホストごとに区別して指定しているディレクトリ）

説明

インテリジェント統合管理データベース（PostgreSQL）に関するパラメーターの定義を記述するファイルです。

定義の反映時期

パラメーターの設定内容を変更した場合，インテリジェント統合管理データベースの再起動が必要です。

また，パラメーターの中には，インテリジェント統合管理データベースのセットアップ時に，動作環境のリソース状況に合わせて値が自動設定されるパラメーターもあります。

記述内容

パラメーター = JP1/IM - Managerでの設定値

設定できるパラメーターは，PostgreSQLが提供しているものと同じです。

ユーザーが編集できるパラメーターを，次の表に示します。

パラメーター

型

説明

JP1/IM - Managerでの設定値

authentication_timeout

integer

クライアント認証を完了するまでの最大時間を設定します。

このパラメーターは，postgresql.confファイル，またはサーバのコマンドラインでだけ設定できます。

1min

log_filename

string

logging_collectorパラメーターが有効な場合，作成されたログファイルのファイル名を設定します。

このパラメーターは，postgresql.confファイル，またはサーバのコマンドラインでだけ設定できます。

'postgresql-%a.log'

log_rotation_age

integer

logging_collectorパラメーターが有効な場合，個々のログファイルを使用する最大時間を設定します。

このパラメーターは，postgresql.confファイル，またはサーバのコマンドラインでだけ設定できます。

1d

log_rotation_size

integer

logging_collectorパラメーターが有効な場合，個々のログファイルの最大サイズを設定します。

このパラメーターは，postgresql.confファイル，またはサーバのコマンドラインでだけ設定できます。

−

log_min_messages

enum

サーバログに書き込むメッセージレベルを設定します。

warning

log_min_error_statement

enum

エラー状態を引き起こすSQLステートメントをサーバログに記録するかどうかを設定します。

error

log_line_prefix

string

各ログ行の先頭に出力されるprintfスタイルの文字列を設定します。

'%m [%p] %e'

lc_messages

string

メッセージが表示される言語を設定します。

'C'

lc_monetary

string

to_charファミリーの関数を使用して，金額の書式設定に使用するロケールを設定します。

'C'

lc_numeric

string

to_charファミリーの関数を使用して，数値の書式設定に使用するロケールを設定します。

'C'

lc_time

string

to_charファミリーの関数を使用して，日付と時刻の書式設定に使用するロケールを設定します。

'C'

（凡例）

−：JP1/IM - Managerでは使用しません。

イベントレポート出力の項目ファイル

形式

[@]項目名
# コメント行
    ：

ファイル

任意のファイルを使用します。

格納先ディレクトリ

Windowsの場合

任意のフォルダ

UNIXの場合

任意のディレクトリ

説明

イベントレポート出力で出力したいJP1イベントの属性を指定するファイルです。

このファイルの最大サイズは，32キロバイト（32,768バイト）です。

定義の記述

半角スペースまたはタブだけで構成された行は無視されます。

各行の先頭のパラメーター名の前，および末尾の半角スペース，タブは無視されます。

定義の反映時期

-kオプションを指定してjcoevtreportコマンドを実行すると，指定した項目ファイルを読み込み，項目ファイルに従ってJP1イベントの属性値をイベントレポート出力します。

ファイル内容

項目名

イベントレポート出力で出力したい項目を指定します。

指定できる項目を次の表に示します。

項番

指定できる項目

内容

1

B.SEQNO

イベントDB内通し番号

2

B.ID

イベントID

3

B.PROCESSID

発行元プロセスID

4

B.TIME

登録時刻

5

B.ARRIVEDTIME

到着時刻

6

B.REASON

登録要因

7

B.USERID

発行元ユーザーID

8

B.GROUPID

発行元グループID

9

B.USERNAME

発行元ユーザー名

10

B.GROUPNAME

発行元グループ名

11

B.SOURCESERVER

登録ホスト名

12

B.DESTSERVER

送信先イベントサーバ名

13

B.SOURCEIPADDR

発行元IPアドレス

14

B.DESTIPADDR

送信先IPアドレス

15

B.SOURCESEQNO

発行元イベントDB内通し番号

16

B.CODESET

コードセット

17

B.MESSAGE

メッセージ

18

E.SEVERITY

重大度

19

E.USER_NAME

ユーザー名

20

E.PRODUCT_NAME

プロダクト名

21

E.OBJECT_TYPE

オブジェクトタイプ

22

E.OBJECT_NAME

オブジェクト名

23

E.ROOT_OBJECT_TYPE

登録名タイプ

24

E.ROOT_OBJECT_NAME

登録名

25

E.OBJECT_ID

オブジェクトID

26

E.OCCURRENCE

事象種別

27

E.START_TIME

開始時刻

28

E.END_TIME

終了時刻

29

E.RESULT_CODE

終了コード

30

E.JP1_SOURCEHOST

発生元ホスト名

31

E.@JP1IM_ACTTYPE

アクション種別

32

E.@JP1IM_ACTCONTROL

アクション

33

E.@JP1IM_SEVERE

重要イベント

34

E.@JP1IM_CORRELATE

相関イベント

35

E.@JP1IM_RESPONSE

応答待ちイベント

36

E.@JP1IM_ORIGINAL_SEVERITY

重大度(変更前)

37

E.@JP1IM_CHANGE_SEVERITY

重大度変更

38

E.@JP1IM_DEALT

対処状況

39

E.@JP1IM_RELEASE

重要イベント解除

40

E.@JP1IM_DISMISSED

重要イベント削除

41

E.@JP1IM_MEMO

メモ

42

E.@JP1IM_DISPLAY_MESSAGE

メッセージ(変更後)

43

E.@JP1IM_CHANGE_MESSAGE

表示メッセージ変更

44

E.@JP1IM_CHANGE_MESSAGE_NAME

表示メッセージ変更定義名

45

E.固有の拡張属性名

固有の拡張属性

JP1イベントに属性がない場合は，空文字を出力します。また，項目名の先頭に「@」を指定すると，基本属性および拡張属性の日時項目をYYYYMMDDhhmmss形式で出力します。ただし，「@」を指定したJP1イベントの属性に次の値が入っている場合は変換しないで出力します。

数値以外の値

0未満の数値，または4,102,444,800以上の数値

#コメント行

#で始まる行は，コメント扱いとなります。

定義例

B.SEQNO
B.ID
B.PROCESSID
B.TIME
　：

イベントレポート出力環境定義ファイル（evtreport.conf）

形式

[論理ホスト名¥JP1CONSOLEMANAGER]
"PROGRAM_SPECIFIC_EX_ATTR_COLUMN"=dword:16進数値

ファイル

evtreport.conf.update（イベントレポート出力環境定義ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

Consoleパス¥default¥

UNIXの場合

/etc/opt/jp1cons/default/

説明

イベントレポート出力機能の実行環境の情報を定義するファイルです。機能を有効にするかどうかを指定します。

必要な定義内容をモデルファイルとして提供しています。設定を変更する場合は，モデルファイルをコピーして，定義ファイル（Windowsの場合Consoleパス¥conf¥evtreport.conf，UNIXの場合/etc/opt/jp1cons/conf/evtreport.conf）にリネームしたあと，内容を編集してください。

定義の反映時期

JP1/Baseのjbssetcnfコマンドで，イベントレポート出力環境定義ファイルをJP1共通定義情報に反映した後に，JP1/IM - Managerを再起動すると有効になります。

記述内容

[論理ホスト名¥JP1CONSOLEMANAGER]

JP1/IM - Managerの環境設定のキー名称を示します。

"論理ホスト名"の部分を，物理ホストの場合はJP1_DEFAULTに，論理ホストの場合は論理ホスト名に設定します。

"PROGRAM_SPECIFIC_EX_ATTR_COLUMN"=dword:16進数値

jcoevtreportコマンドで固有の拡張属性を出力するときに，基本属性，共通の拡張属性，およびIM属性と同じように1件の固有の拡張属性に一つの列を割り当てて出力する機能を有効にするかどうかを指定します。

00000001：有効

00000000：無効

デフォルトは「00000001」（有効）です。

定義例

[JP1_DEFAULT¥JP1CONSOLEMANAGER]
"PROGRAM_SPECIFIC_EX_ATTR_COLUMN"=dword:00000001

イベントレポート出力のフィルターファイル

形式

イベント条件
    ：
OR
イベント条件
    ：
EXCLUDE
イベント条件
    ：

ファイル

任意のファイルを使用します。

格納先ディレクトリ

Windowsの場合

任意のフォルダ

UNIXの場合

任意のディレクトリ

説明

イベントレポート出力時のフィルター条件を指定する定義ファイルです。-fオプションを指定してjcoevtreportコマンドを実行すると読み込まれます。

このファイルの最大サイズは，256キロバイト（262,144バイト）です。

定義の反映時期

-fオプションを指定してjcoevtreportコマンドを実行すると，指定した項目ファイルを読み込み，指定された条件と一致するJP1イベントを統合監視DBから取得してイベントレポート出力します。

ファイル内容

通過条件群，除外条件群

jcoevtreportコマンドは，すべての除外条件群に一致しないJP1イベント，かつ，通過条件群のどれか一つが一致するJP1イベントを出力対象のJP1イベントと判断します。フィルター条件には，0〜5件の通過条件群と0〜5件の除外条件群を記述できます。

通過条件群または除外条件群には，0〜50件のイベント条件を指定できます。ただし，拡張属性（固有情報）のイベント条件は，一つの通過条件群または除外条件群に最大5件指定できます。

OR

条件群を複数指定する場合は，各条件群の間に「OR」を記述します。

EXCLUDE

通過条件群と除外条件群の間には，「EXCLUDE」を記述します。「EXCLUDE」以降のイベント条件は，除外条件群と見なします。「EXCLUDE」以降にイベント条件がない場合は，通過条件群だけが有効になります。

イベント条件

イベント条件は，次の形式で指定します（△は半角スペースを表す）。

　属性名△比較キーワード△オペランド[△オペランド]…

なお，半角スペース，または，タブだけで構成された行は，無視して処理を続行します。

属性名

属性名には，比較したい属性の名称を記述します。基本属性を指定する場合は，名称の前に「B.」を付けます。拡張属性（共通情報），拡張属性（固有情報）を指定する場合は，名称の前に「E.」を付けます。英大文字・英小文字を区別します。

比較キーワード

比較キーワードには，「BEGIN（から始まる）」，「IN（と一致する）」，「NOTIN（と一致しない）」，「SUBSTR（を含む）」，「NOTSUBSTR（を含まない）」，「REGEX（正規表現）」のどれか一つを指定できます。英大文字・英小文字を区別します。

オペランド

比較キーワードで属性値と比較する値を文字列で指定します。英大文字・英小文字を区別します。

オペランドを複数指定する場合は，一つ以上の連続した半角スペースまたはタブをオペランドとオペランドの間に挿入して区切ります。オペランドとオペランドは，OR条件となります。ただし，比較キーワードに正規表現を指定している場合は，複数指定できません。

オペランドに，半角スペース，タブ，改行コード（CR，LF）および%を指定したい場合，次のように記述します。

項番

指定したい値

指定方法

1

タブ（0x09）

%09

2

半角スペース（0x20）

%20

3

%（0x25）

%25

4

改行コード LF（0x0a）

%0a

5

改行コード CR（0x0d）

%0d

定義フォーマットの上限チェックの場合，%20，%25は1文字として扱います。%のあとに指定する文字コードは，英大文字・英小文字を区別しません。複数選択した場合の定義例「IDが100と200に一致する」を示します。

B.ID△IN△100△200

（凡例）　△：半角スペース（0x20）

オペランドは，イベント条件1件当たり4,096バイトまで，イベント条件ブロック1件当たり4,096バイト（イベント条件ブロックに記述したオペランドの合計バイト数）まで指定できます。

イベント条件で指定できる属性名，比較キーワードおよびオペランドについて次の表に示します。

項番

項目

属性名

比較キーワード

オペランド

1

イベントID

B.ID

一致する

一致しない

複数指定できる。複数指定では最大100件指定できる。

イベントIDの英大文字・英小文字は区別しない。

指定できる範囲は0〜7FFFFFFFである。

2

登録要因

B.REASON

一致する

一致しない

複数指定できる。複数指定では最大100件指定できる。

指定できる範囲は，-2,147,483,648〜2,147,483,647である。

3

発行元プロセスID

B.PROCESSID

4

発行元ユーザーID

B.USERID

5

発行元グループID

B.GROUPID

から始まる

一致する

一致しない

を含む

を含まない

正規表現

複数指定できる。複数指定では最大100件指定できる。ただし，正規表現では複数指定はできない。

6

発行元ユーザー名

B.USERNAME

7

発行元グループ名

B.GROUPNAME

8

発行元イベントサーバ名※1

B.SOURCESERVER

9

送信先イベントサーバ名※1

B.DESTSERVER

10

メッセージ

B.MESSAGE

11

重大度

E.SEVERITY

一致する

"Emergency"（緊急），"Alert"（警戒），"Critical"（致命的），"Error"（エラー），"Warning"（警告），"Notice"（通知），"Information"（情報），"Debug"（デバッグ）の中から指定できる。

複数指定できる。ただし，重複した重大度は指定できない。

12

拡張属性※2

E.xxxxxxx

から始まる

一致する

一致しない

を含む

を含まない

正規表現

拡張属性名には，先頭が英大文字で英大文字，数字，およびアンダースコア（_）から構成される32バイトまでの名称を設定できる。

複数指定できる。複数指定では最大100件指定できる。ただし，正規表現では複数指定はできない。

13

アクション種別

E.@JP1IM_ACTTYPE

一致する

一致しない

次の数値を指定できる。

0（アクション対象外）

1（コマンド）

複数指定できる。

14

アクション抑止

E.@JP1IM_ACTCONTROL

次の数値を指定できる。

0（アクション対象外）

1（実行）

2（抑止）

3（一部抑止）

複数指定できる。

15

重要イベント

E.@JP1IM_SEVERE

次の数値を指定できる。

0（重要イベントではない）

1（重要イベント）

複数指定できる。

16

相関イベント

E.@JP1IM_CORRELATE

次の数値を指定できる。

0（相関イベントではない）

1（相関成立イベント）

2（相関不成立イベント）

複数指定できる。

17

応答待ちイベント

E.@JP1IM_RESPONSE

次の数値を指定できる。

0（応答待ちイベントではない）

1（応答待ちイベント）

複数指定できる。

18

重大度(変更前)

E.@JP1IM_ORIGINAL_SEVERITY

から始まる

一致する

一致しない

を含む

を含まない

正規表現

複数指定できる。複数指定では最大100件指定できる。ただし，正規表現では複数指定はできない。

19

重大度変更

E.@JP1IM_CHANGE_SEVERITY

一致する

一致しない

次の数値を指定できる。

0（重大度変更なし）

1（重大度変更あり）

複数指定できる。

20

対処状況

E.@JP1IM_DEALT

次の数値を指定できる。

0（未対処）

1（対処済）

2（処理中）

3（保留）

複数指定できる。

21

重要イベント解除

E.@JP1IM_RELEASE

次の数値を指定できる。

0（重要イベントを解除していない）

1（重要イベントを解除している）

複数指定できる。

22

重要イベント削除

E.@JP1IM_DISMISSED

次の数値を指定できる。

0（重要イベントを削除していない）

1（重要イベントを削除している）

複数指定できる。

23

メモ

E.@JP1IM_MEMO

から始まる

一致する

一致しない

を含む

を含まない

正規表現

複数指定できる。

複数指定では最大100件指定できる。ただし，正規表現では複数指定はできない。

24

メッセージ(変更後)※3

E.@JP1IM_DISPLAY_MESSAGE

から始まる

一致する

一致しない

を含む

を含まない

正規表現

複数指定できる。

複数指定では最大100件指定できる。ただし，正規表現では複数指定はできない。

25

表示メッセージ変更※3

E.@JP1IM_CHANGE_MESSAGE

一致する

一致しない

指定できる範囲は，-2,147,483,648〜2,147,483,647である。

26

表示メッセージ変更定義名※3

E.@JP1IM_CHANGE_MESSAGE_NAME

から始まる

一致する

一致しない

を含む

を含まない

正規表現

複数指定できる。

複数指定では最大100件指定できる。ただし，正規表現では複数指定はできない。

27

発生元ホスト名※2

E.JP1_SOURCEHOST

から始まる

一致する

一致しない

を含む

を含まない

正規表現

複数指定できる。

複数指定では最大100件指定できる。ただし，正規表現では複数指定はできない。

注※1

統合監視DBおよびIM構成管理DBが有効な場合に，比較キーワードが，「と一致する」「と一致しない」のとき，パス表記で業務グループ名を指定できます。

統合監視DBおよびIM構成管理DBが無効な場合，および［と一致する］［と一致しない］以外を選択した場合，パス表記で業務グループ名を指定しても，ホスト名として扱われます。

jcoimdefコマンドの-ignorecasehostオプションの指定を「ON」にしている場合に，比較キーワードで［正規表現］以外を選択すると，文字列の英大文字・英小文字を区別しません。

注※2

E.START_TIME（開始時刻），E.END_TIME（終了時刻）は指定できません。

注※3

10-50以前のJP1/IM - Managerからバージョンアップした場合に，jimdbupdateコマンドで統合監視DBのアップデートを実施していないときは，出力されません。

定義例

B.ID IN 1
B.MESSAGE SUBSTR 警告
B.SOURCESERVER IN host1 host2 host3 host4
OR
B.ID IN 1
B.MESSAGE SUBSTR エラー
B.SOURCESERVER IN host1 host2 host3 host4
EXCLUDE
B.SOURCESERVER IN host3

定義ファイルのステートメントの詳細

JP1/IMの定義ファイルに記述できるステートメントの種類，構造，および指定できる値を一覧で示します。

注

この節の説明は次の三つの定義ファイルだけに該当します。

イベント拡張属性定義ファイル

アプリケーション実行定義ファイル

統合機能メニュー定義ファイル

ステートメントの種類

表2‒91　ステートメントの種類

ステートメントの分類

ステートメントの種類

ファイル内ステートメント

ブロック開始ステートメント

ブロック終了ステートメント

ファイル属性ステートメント

プロダクトステートメント

ブロック内ステートメント

機能メニューコマンドオプション定義ステートメント

イベント属性定義ステートメント

ブロック属性定義ステートメント

機能メニュー実行定義識別子定義ステートメント

アプリケーション説明定義ステートメント

グループ定義ステートメント

機能メニュー表示アイコン定義ステートメント

アプリケーション実行定義識別子定義ステートメント

機能メニュー識別子定義ステートメント

機能メニュー表示名定義ステートメント

順序定義ステートメント

機能メニュー親識別子定義ステートメント

アプリケーションパス定義ステートメント

ステートメントの構造

表2‒92　ステートメントの構造

ステートメントの種類

記述形式

ブロック開始ステートメント

@define-block type=ブロック種別

ブロック終了ステートメント

@define-block-end

ファイル属性ステートメント

@file type=定義ファイルタイプ[, version=定義フォーマットバージョン]

プロダクトステートメント

@product name=プロダクト名

機能メニューコマンドオプション定義ステートメント

arguments=コマンド引数

イベント属性定義ステートメント

attr name=属性名, title=表示項目名[, type=属性表示タイプ]

ブロック属性定義ステートメント

block lang=言語種別|platform=プラットフォーム種別|version=適用バージョン

機能メニュー実行定義識別子定義ステートメント

execute_id=アプリケーション実行定義識別子

アプリケーション説明定義ステートメント

description=アプリケーション実行の説明文

グループ定義ステートメント

group name=グループ名, attrs=属性名並び

機能メニュー表示アイコン定義ステートメント

icon=表示アイコンファイル名

アプリケーション実行定義識別子定義ステートメント

id=アプリケーション実行定義識別子

機能メニュー識別子定義ステートメント

id=機能メニュー識別子

機能メニュー表示名定義ステートメント

name=表示名称

順序定義ステートメント

order id=イベントID定義文字列, attrs=属性名並び

機能メニュー親識別子定義ステートメント

parent_id=親機能メニュー識別子

アプリケーションパス定義ステートメント

path=コマンドパス

ステートメント内の構成要素の生成規則

ステートメント内の構成要素に指定できる値を次に示します。

表2‒93　ステートメント内の構成要素に指定できる値

構成要素

指定できる値

16進数値文字

0〜9およびA〜F

EUCJIS

EUCJIS

GB18030

GB18030

JIS

JIS

Shift-JIS

SJIS

UTF-8

UTF-8

アプリケーション実行の説明文

1〜50バイトのユーザー定義文字列

アプリケーション実行定義

application-execution-definition

アプリケーション実行定義ブロック

application-execution-def

アプリケーション実行定義識別子

1〜32バイトの半角英数字

イベントID

1〜8バイトの16進数値文字

イベントID定義文字列

イベントID|イベントID定義文字列 列挙セパレーター イベントID

イベントオブジェクトタイプ定義ブロック

event-object-def

イベント拡張属性定義

extended-attributes-definition

イベント属性グループ定義ブロック

event-attr-group-def

イベント属性定義ブロック

event-attr-def

イベント表示順序定義ブロック

event-attr-order-def

インターフェース名

1〜32バイトの半角英数字

グループ名

1〜32バイトの半角英数字

コマンドパス

ファイル名

コマンド引数

コマンド引数として意味のあるユーザー定義文字列

サブキー名

1〜32バイトの半角英数字

スラント

/

スラント区切り英数字列

スラント|英数字|スラント区切り英数字列 スラント

|スラント区切り英数字列 英数字

デフォルト

default

バージョン

1〜7バイトの半角英数字のバージョン文字列

バージョン記号文字

/|.|

バージョン範囲指定

バージョン 空白-空白 バージョン

バージョン文字

英大文字|数字|バージョン記号文字

ファイル記号文字

.|/|¥¥|-|_|~

ファイル名

ファイルパスとして意味のある文字列

ファイル名文字列

ファイル記号文字|英数字|ファイル名文字列 ファイル記号文字|ファイル名文字列 英数字

プラットフォーム種別

base|半角英数字列

プロダクト名

スラント区切り半角英数字列

ブロック種別

イベント属性定義ブロック|イベント属性グループ定義ブロック|イベント表示順序定義ブロック|アプリケーション実行定義ブロック

ユーザー定義文字

半角英数字|日本語文字|記号

英語

English

英字

小文字および大文字の半角英字

英小文字

a〜z

英数字

半角の英字および数字

英大文字

A〜Z

機能ツリーノード定義ブロック

function-tree-def

統合ツリーメニュー定義

function-definition

機能メニュー識別子

1〜32バイトの半角英数字

機能メニュー識別子列

[0〜9バイトの機能メニュー識別子 列挙セパレーター]

機能メニュー識別子

言語種別

日本語|英語

親機能メニュー識別子

機能メニュー識別子

数字

0〜9

説明

1〜50バイトのユーザー定義文字

属性値

1〜10,000バイトの文字

属性値タイプ

elapsed_time

属性表示タイプ

属性値タイプ/表示フォーマット

属性名

(B|).属性名文字列

属性名文字

半角英大文字|半角数字|_

属性名文字列

0〜31バイトの半角英大文字の属性名文字

属性名並び

属性名|属性名並び¥|属性名

定義ファイルタイプ

イベント拡張属性定義|アプリケーション実行定義|モニター画面呼び出し定義|統合機能メニュー定義

定義フォーマットバージョン

0300

適用バージョン

ALL|バージョン|バージョン範囲指定

日時表示フォーマット

date_format:表示タイムゾーン

日本語

Japanese

日本語文字

半角仮名を除く2バイト文字

日本語文字コード

Shift-JIS|EUCJIS|JIS|UTF-8

表示アイコンファイル名

ファイル名

表示タイムゾーン

CLIENT

表示フォーマット

日時表示フォーマット

表示項目文字

英数字|空白|-|_|日本語文字

表示項目文字列

0〜64バイトの表示項目文字列

表示項目名

表示項目文字列

表示名称

1〜32バイトのユーザー定義文字列

列挙セパレーター

¥|

Node exporterのメトリック定義ファイル（metrics_node_exporter.conf）

形式

[
  {
    "name":"トレンドデータのメトリック名",
    "default":デフォルト選択状態,
    "promql":"PromQL文",
    "resource_en":{
      "category":"メトリックのカテゴリ（英語）",
      "label":"メトリック表示名（英語）",
      "description":"メトリックの説明（英語）",
      "unit":"メトリックの単位（英語）"
    },
    "resource_ja":{
      "category":"メトリックのカテゴリ（日本語）",
      "label":"メトリック表示名（日本語）",
      "description":"メトリックの説明（日本語）",
      "unit":"メトリックの単位（日本語）"
    },
    "drop_legend_labels": ["ラベル名", ･･･]
  }, ･･･
]※

注※

[]内に記述できる要素の数は1〜1,000個です。範囲外の個数の要素を記述した場合は，KAJY24609-Eのエラーメッセージを出力します。

ファイル

metrics_node_exporter.conf

metrics_node_exporter.conf.model（モデルファイル）

格納先ディレクトリ

■統合マネージャーホスト

Windowsの場合

物理ホストのとき

Managerパス¥conf¥imdd¥plugin¥jp1pccs¥

論理ホストのとき

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

Linuxの場合

物理ホストのとき

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

論理ホストのとき

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

説明

［統合オペレーション・ビューアー］画面の［トレンド］タブで表示するNode exporterのメトリック情報を定義するファイルです。

定義内容は，JP1/IM - Agentの製品プラグインの__metricListGetメソッド，および__timeSeriesDataGetメソッドの返却値に使用します。

JP1/IM - Managerが階層構成で，統合マネージャーから，下位マネージャーのトレンドデータ管理DBに保存されているトレンドデータを参照する場合，統合マネージャーのメトリック定義ファイルに，参照するトレンドデータのメトリックを追加する必要があります。

文字コード

UTF-8（BOM無し）

改行コード

Windowsの場合：CR+LF

Linuxの場合：LF

定義の反映時期

［統合オペレーション・ビューアー］画面の［トレンド］タブ，または，REST APIで，メトリックの情報を取得したときに反映されます。

記述内容

表2‒94　 メトリック定義ファイルの各メンバーに設定する値

メンバー名

省略可否

型

設定する値

name

不可

string

トレンドデータのメトリック名を設定します。

トレンドデータ（時系列データ）のメトリック名は，［統合オペレーション・ビューアー］画面の［トレンド］タブで，トレンドデータの種類を示す文字列として表示されます。

1〜255文字で，次に示す文字を指定できます。

半角英数字

-（ハイフン）

_（アンダースコア）

指定不可の文字を含む場合，KAJY24604-EまたはKAJY24605-Eのエラーメッセージが出力されます。

メトリック名は，メトリック定義ファイル内で一意にしてください。一意でない場合，KAJY24608-Eのエラーメッセージが出力されます。

default

可

boolean

デフォルトの選択状態を設定します。

［統合オペレーション・ビューアー］画面の［トレンド］タブで選択するトレンドデータのチェックボックスに，デフォルトでチェックを入れるかどうかを指定します。

true：デフォルトでチェックを入れます。

false：デフォルトでチェックを入れません。

省略時はデフォルトでチェックを入れません。

promql

不可

string

PromQL文を設定します。

JP1/IMのトレンドデータの参照用APIで使用できるPromQL文を設定できます。

PromQL文に含まれる文字列「$jp1im_TrendData_labels」は，下記の「■$jp1im_TrendData_labelsの置き換え」に記載するPromQL文に置き換えられます。PromQL文に関する注意事項については，「PromQL文に関する注意事項」を参照してください。

1〜1023文字で，制御文字（0x00〜0x1F，0x7F〜0x9F）を除く文字を指定します。

指定不可の文字を含む場合，KAJY24604-EまたはKAJY24605-Eのエラーメッセージが出力されます。

resource_en

不可

object

メトリックのリソース情報（英語）を設定します。

category

可

string

メトリックのカテゴリ（英語）を設定します。

1〜255文字で，制御文字（0x00〜0x1F，0x7F〜0x9F）を除く文字を指定します。

指定不可の文字を含む場合，KAJY24604-EまたはKAJY24605-Eのエラーメッセージが出力されます。

省略時はメトリックのカテゴリ（英語）を設定しません。

label

可

string

メトリックの表示名（英語）を設定します。

1〜255文字で，制御文字（0x00〜0x1F，0x7F〜0x9F）を除く文字を指定します。

指定不可の文字を含む場合，KAJY24604-EまたはKAJY24605-Eのエラーメッセージが出力されます。

省略時は［統合オペレーション・ビューアー］画面の［トレンド］タブのメトリックの表示名にnameメンバーの設定内容を使用します。また，メトリック一覧取得APIでメトリックの表示名を返却しません。

description

可

string

メトリックの説明（英語）を設定します。

1〜1,023文字で，制御文字（0x00〜0x1F，0x7F〜0x9F）を除く文字を指定します。

指定不可の文字を含む場合，KAJY24604-EまたはKAJY24605-Eのエラーメッセージが出力されます。

省略時は［統合オペレーション・ビューアー］画面の［トレンド］タブにメトリックの説明を表示しません。また，メトリック一覧取得APIでメトリックの説明を返却しません。

unit

不可

string

メトリックの単位（英語）を設定します。

1〜255文字で，制御文字（0x00〜0x1F，0x7F〜0x9F）を除く文字を指定します。

指定不可の文字を含む場合，KAJY24604-EまたはKAJY24605-Eのエラーメッセージが出力されます。

resource_ja

可

object

メトリックのリソース情報（日本語）を設定します。

省略時はresource_enの設定内容を使用します。

category

可

string

メトリックのカテゴリ（日本語）を設定します。

1〜255文字で，制御文字（0x00〜0x1F，0x7F〜0x9F）を除く文字を指定します。

指定不可の文字を含む場合，KAJY24604-EまたはKAJY24605-Eのエラーメッセージが出力されます。

省略時はresource_enのcategoryの設定内容を使用します。

label

可

string

メトリックの表示名（日本語）を設定します。

1〜255文字で，制御文字（0x00〜0x1F，0x7F〜0x9F）を除く文字を指定します。

指定不可の文字を含む場合，KAJY24604-EまたはKAJY24605-Eのエラーメッセージが出力されます。

省略時はresource_enのlabelの設定内容を使用します。

description

可

string

メトリックの説明（日本語）を設定します。

1〜1,023文字で，制御文字（0x00〜0x1F，0x7F〜0x9F）を除く文字を指定します。

指定不可の文字を含む場合，KAJY24604-EまたはKAJY24605-Eのエラーメッセージが出力されます。

省略時はresource_enのdescriptionの設定内容を使用します。

unit

可

string

メトリックの単位（日本語）を設定します。

1〜255文字で，制御文字（0x00〜0x1F，0x7F〜0x9F）を除く文字を指定します。

指定不可の文字を含む場合，KAJY24604-EまたはKAJY24605-Eのエラーメッセージが出力されます。

省略時はresource_enのunitの設定内容を使用します。

drop_legend_labels

可

配列（string）

トレンドグラフの凡例から除外するラベルを追加する場合にラベル名を設定します。

マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「3.15.6(4)(b)インスタンス名（グラフの凡例として表示する文字列）」に示す除外対象のラベル以外に，トレンドグラフの凡例から除外するラベル名を記載します。

1〜255文字で，制御文字（0x00〜0x1F，0x7F〜0x9F）を除く文字を指定します。

指定不可の文字を含む場合，トレンドグラフの凡例から除外されません。

ラベルの数は100個まで指定できます。100個を超えた場合，101個目以降のラベルは無視されます。

■$jp1im_TrendData_labelsの置き換え

promqlの値に含まれる文字列「$jp1im_TrendData_labels」は，パフォーマンスデータを取得するときに，取得対象を絞り込むためのPromQL文に置き換えられます。

トレンドのAPIまたは統合オペレーション・ビューアーで指定した，構成情報のSIDの種類ごと（EC2以外のCloudWatchSIDについては，監視対象のAWS名前空間ごと）の，置き換え後のPromQL文を次に示します。太字部分（可変値）は，それぞれに対応するSIDで管理するExporterの設定や，Exporterが出力するサンプルの値に置き換えられます。

表2‒95　 $jp1im_TrendData_labelsの置き換え後のPromQL文

構成情報のSIDの種類

置き換え後のPromQL文

エージェントSID

{jp1_pc_prome_hostname="Prometheusのホスト名",job="スクレイプジョブ名",instance="instanceラベルの値"}

リモートエージェントSID

EC2のCloudWatchSID

{jp1_pc_prome_hostname="Prometheusのホスト名",job="スクレイプジョブ名",instance="instanceラベルの値"},jp1_pc_nodelabel="AWSのリソースのjp1_pc_nodelabelタグに設定した値"}

EC2以外のCloudWatchSID

モデルファイルの設定内容（初期状態）

Node exporterのメトリック定義ファイルのモデルファイルに記述されている各メトリックの設定内容（初期状態）を，次に示します。

cpu_used_rate※

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

cpu_used_rate

default

true

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

(avg by (instance,job,jp1_pc_nodelabel,jp1_pc_prome_hostname) (rate(node_cpu_seconds_total{mode=¥"system¥"}[2m]) and $jp1im_TrendData_labels) + avg by (instance,job,jp1_pc_nodelabel,jp1_pc_prome_hostname) (rate(node_cpu_seconds_total{mode=¥"user¥"}[2m]) and $jp1im_TrendData_labels)) * 100

resource_en

category

platform_unix

label

CPU used rate

description

CPU usage.It also indicates the average value per processor. [Units: %]

unit

%

resource_ja

category

platform_unix

label

CPU使用率

description

CPU使用率（%）。

プロセッサごとの割合の平均値でもある。

unit

%

注※

JP1/PFM - Agent for Platform（UNIX）のPIレコードのCPU %フィールドと同等です。

memory_unused※

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

memory_unused

default

false

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

(node_memory_MemAvailable_bytes and $jp1im_TrendData_labels)/1024/1024/1024

resource_en

category

platform_unix

label

Memory unused

description

Size of the physical memory that can actually be used by the application.

unit

GB

resource_ja

category

platform_unix

label

空きメモリ量

description

実際にアプリケーションが使用することができる物理メモリーのサイズ。

unit

ギガバイト

注※

JP1/PFM - Agent for Platform（UNIX）のPIレコードのEffective Free Mem Mbytesフィールドと同等です。

ただし，単位が異なります。

memory_unused_rate※

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

memory_unused_rate

default

false

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

(node_memory_MemAvailable_bytes and $jp1im_TrendData_labels) / (node_memory_MemTotal_bytes and $jp1im_TrendData_labels) * 100

resource_en

category

platform_unix

label

Available memory percentage

description

Percentage of physical memory actually available to the application

unit

%

resource_ja

category

platform_unix

label

空きメモリ率

description

実際にアプリケーションが使用することができる物理メモリーの割合。

unit

%

注※

JP1/PFM - Agent for Platform（UNIX）のPIレコードのEffective Free Mem %フィールドと同等です。

disk_unused※

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

disk_unused

default

false

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

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

resource_en

category

platform_unix

label

Disk unused

description

Size of the unused area of the disk. [Units: GB]

unit

GB

resource_ja

category

platform_unix

label

空きディスク領域

description

ディスクの未使用領域のサイズ。（単位:ギガバイト）

unit

ギガバイト

注※

JP1/PFM - Agent for Platform（UNIX）のPD_FSLレコードのMbytes Freeフィールドと同等です。

ただし，単位が異なります。

disk_unused_rate※

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

disk_unused_rate

default

false

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

(node_filesystem_free_bytes and $jp1im_TrendData_labels) / (node_filesystem_size_bytes and $jp1im_TrendData_labels) * 100

resource_en

category

platform_unix

label

Unused disk space percentage

description

Percentage of unused disk space

unit

%

resource_ja

category

platform_unix

label

空きディスク率

description

ディスクの未使用領域の割合。

unit

%

注※

JP1/PFM - Agent for Platform（UNIX）のPD_FSLレコードのMbytes Free %フィールドと同等です。

disk_busy_rate※

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

disk_busy_rate

default

false

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

(rate(node_disk_io_time_seconds_total[2m]) and $jp1im_TrendData_labels)*100

resource_en

category

platform_unix

label

Disk busy rate

description

Percentage of time the disk was busy with read and write requests. This value may exceed 100 when processes are continuously executed on a device. [Units: %]

unit

%

resource_ja

category

platform_unix

label

ディスクビジー率

description

ディスクのビジー率（%）。

デバイスに対する処理が連続で行われる場合に「100」を超えることがあります。

unit

%

注※

JP1/PFM - Agent for Platform（UNIX）のPI_DEVDレコードのBusy %フィールドと同等です。

disk_read_latency

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

disk_read_latency

default

false

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

(rate(node_disk_read_time_seconds_total[2m]) and $jp1im_TrendData_labels) / (rate(node_disk_reads_completed_total[2m]) and $jp1im_TrendData_labels)

resource_en

category

platform_unix

label

Disk read latency

description

Average time (in seconds) taken to perform a single disk read operation

unit

second

resource_ja

category

platform_unix

label

ディスク読み込みレイテンシー

description

1回あたりのディスク読み込みにかかった平均時間（秒）。

unit

秒

disk_write_latency

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

disk_write_latency

default

false

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

(rate(node_disk_write_time_seconds_total[2m]) and $jp1im_TrendData_labels) / (rate(node_disk_writes_completed_total[2m]) and $jp1im_TrendData_labels)

resource_en

category

platform_unix

label

Disk write latency

description

Average time (in seconds) taken to perform a single disk write operation

unit

second

resource_ja

category

platform_unix

label

ディスク書き込みレイテンシー

description

1回あたりのディスク書き込みにかかった平均時間（秒）。

unit

秒

disk_io_latency

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

disk_io_latency

default

false

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

((rate(node_disk_read_time_seconds_total[2m]) and $jp1im_TrendData_labels) + (rate(node_disk_write_time_seconds_total[2m]) and $jp1im_TrendData_labels)) / ((rate(node_disk_reads_completed_total[2m]) and $jp1im_TrendData_labels) + (rate(node_disk_writes_completed_total[2m]) and $jp1im_TrendData_labels))

resource_en

category

platform_unix

label

Disk I/O latency

description

Average time (in seconds) taken to perform a single disk write and read operation

unit

second

resource_ja

category

platform_unix

label

ディスクIOレイテンシー

description

1回あたりのディスク書き込みとディスク読み込みにかかった平均時間（秒）。

unit

秒

network_sent※

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

network_sent

default

false

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

(rate(node_network_transmit_packets_total[2m]) and $jp1im_TrendData_labels)

resource_en

category

platform_unix

label

Network sent

description

Rate at which packets were sent throughthe network interface. [Units: packets/second]

unit

packets/second

resource_ja

category

platform_unix

label

ネットワークの送信速度

description

ネットワークインターフェースで送信されるパケットの割合。（単位：パケット／秒）

unit

パケット／秒

注※

JP1/PFM - Agent for Platform（UNIX）のPI_NINDレコードのPkts Xmitd/secフィールドと同等です。

network_received※

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

network_received

default

false

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

(rate(node_network_receive_packets_total[2m]) and $jp1im_TrendData_labels)

resource_en

category

platform_unix

label

Network received

description

Rate at which packets were receivedthrough the network interface. [Units: packets/second]

unit

packets/second

resource_ja

category

platform_unix

label

ネットワークの受信速度

description

ネットワークインターフェースで受信されるパケットの割合。（単位：パケット／秒）

unit

パケット/秒

注※

JP1/PFM - Agent for Platform（UNIX）のPI_NINDレコードのPkts Rcvd/secフィールドと同等です。

Process exporterのメトリック定義ファイル（metrics_process_exporter.conf）

形式

JP1/IM - Agentの「Node exporterのメトリック定義ファイル」と同じです。

ファイル

metrics_process_exporter.conf

metrics_process_exporter.conf.model（モデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Managerパス¥conf¥imdd¥plugin¥jp1pccs¥

論理ホストのとき

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

Linuxの場合

物理ホストのとき

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

論理ホストのとき

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

説明

［統合オペレーション・ビューアー］画面の［トレンド］タブで表示するProcess exporterのメトリック情報を定義するファイルです。

定義内容は，JP1/IM - Agentの製品プラグインの__metricListGetメソッド，および__timeSeriesDataGetメソッドの返却値に使用します。JP1/IM - Managerが階層構成で，統合マネージャーから下位マネージャーのトレンドデータ管理DBに保存されているトレンドデータを参照する場合，統合マネージャーのメトリック定義ファイルに参照するトレンドデータのメトリックを追加する必要があります。

文字コード

UTF-8（BOM無し）

改行コード

Windowsの場合：CR+LF

Linuxの場合：LF

定義の反映時期

［統合オペレーション・ビューアー］画面の［トレンド］タブ，または，REST APIで，メトリックの情報を取得したときに反映されます。

記述内容

JP1/IM - Agentの「Node exporterのメトリック定義ファイル」と同じです。

モデルファイルの設定内容（初期状態）

Process exporterのメトリック定義ファイルのモデルファイルに記述されている各メトリックの設定内容（初期状態）を，次に示します。

process_pgm_process_count※

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

process_pgm_process_count

default

true

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

sum by (program, instance, job, jp1_pc_nodelabel, jp1_pc_prome_hostname) (namedprocess_namegroup_num_procs and $jp1im_TrendData_labels)

resource_en

category

platform_unix_process

label

Process count

description

Number of processes that are executing programs. Number of processes that have this program name inside the process table.

unit

count

resource_ja

category

platform_unix_process

label

プロセス数

description

プログラムを実行しているプロセス数。プロセステーブル内で，このプログラム名を持つプロセスの数。

unit

個

注※

JP1/PFM - Agent for Platform（UNIX）のPD_PGMレコードのStart Time Process Count（PROCESS_COUNT）フィールドと同等です。

Node exporter（サービス監視）のメトリック定義ファイル（metrics_node_exporter_service.conf）

形式

「Node exporterのメトリック定義ファイル（metrics_node_exporter.conf）」の「形式」を参照してください。

ファイル

metrics_node_exporter_service.conf

metrics_node_exporter_service.conf.model（モデルファイル）

格納先ディレクトリ

■統合マネージャーホスト

Windowsの場合

物理ホストのとき

Managerパス¥conf¥imdd¥plugin¥jp1pccs¥

論理ホストのとき

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

Linuxの場合

物理ホストのとき

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

論理ホストのとき

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

説明

Linuxのサービス監視機能でトレンドを取得する場合に使用します。サービス監視機能の詳細については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「3.15.1(1)(d)Node exporter（Linux性能情報収集機能）」の「監視対象サービスの指定」を参照してください。

この定義ファイルには，サービスのIM管理ノードで取得できるメトリック情報を定義します。

JP1/IM - Managerが階層構成で，統合マネージャーから，下位マネージャーのトレンドデータ管理DBに保存されているトレンドデータを参照する場合，統合マネージャーのメトリック定義ファイルに，参照するトレンドデータのメトリックを追加する必要があります。

文字コード

UTF-8（BOM無し）

改行コード

Windowsの場合：CR+LF

Linuxの場合：LF

定義の反映時期

［統合オペレーション・ビューアー］画面の［トレンド］タブ，または，REST APIで，メトリックの情報を取得したときに反映されます。

記述内容

「Node exporterのメトリック定義ファイル（metrics_node_exporter.conf）」の「記述内容」を参照してください。

モデルファイルの設定内容（初期状態）

service_state※

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

service_state

default

true

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

node_systemd_unit_state{state=¥"active¥"} and $jp1im_TrendData_labels

resource_en

category

platform_linux_service

label

Service state

description

Shows the state of the service.

0: Indicates that the service is not active.

1: Indicates that the service is active

unit

-

resource_ja

category

platform_linux_service

label

サービスの状態

description

サービスの状態を表します。

0:サービスの状態が，実行中ではないことを表す

1:サービスの状態が，実行中であることを表す

unit

-

注※

JP1/PFM - Agent for Platform（UNIX）に該当するフィールドはありません。

Windows exporterのメトリック定義ファイル（metrics_windows_exporter.conf）

形式

「Node exporterのメトリック定義ファイル（metrics_node_exporter.conf）」の「形式」を参照してください。

ファイル

metrics_windows_exporter.conf

metrics_windows_exporter.conf.model（モデルファイル）

格納先ディレクトリ

■統合マネージャーホスト

Windowsの場合

物理ホストのとき

Managerパス¥conf¥imdd¥plugin¥jp1pccs¥

論理ホストのとき

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

Linuxの場合

物理ホストのとき

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

論理ホストのとき

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

説明

［統合オペレーション・ビューアー］画面の［トレンド］タブで表示するWindows exporterのメトリック情報を定義するファイルです。

定義内容は，JP1/IM - Agentの製品プラグインの__metricListGetメソッド，および__timeSeriesDataGetメソッドの返却値に使用します。

JP1/IM - Managerが階層構成で，統合マネージャーから，下位マネージャーのトレンドデータ管理DBに保存されているトレンドデータを参照する場合，統合マネージャーのメトリック定義ファイルに，参照するトレンドデータのメトリックを追加する必要があります。

文字コード

UTF-8（BOM無し）

改行コード

Windowsの場合：CR+LF

Linuxの場合：LF

定義の反映時期

［統合オペレーション・ビューアー］画面の［トレンド］タブ，または，REST APIで，メトリックの情報を取得したときに反映されます。

記述内容

「Node exporterのメトリック定義ファイル（metrics_node_exporter.conf）」の「記述内容」を参照してください。

モデルファイルの設定内容（初期状態）

Windows exporterのメトリック定義ファイルのモデルファイルに記述されている各メトリックの設定内容（初期状態）を，次に示します。

cpu_used_rate※

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

cpu_used_rate

default

true

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

100 - (avg by (instance,job,jp1_pc_nodelabel,jp1_pc_prome_hostname) (rate(windows_cpu_time_total{mode=¥"idle¥"}[2m]) and $jp1im_TrendData_labels) * 100)

resource_en

category

platform_windows

label

CPU used rate

description

Processor usage. Percentage of elapsed time used by the processor for executing non-idle threads. [Units: %]

unit

%

resource_ja

category

platform_windows

label

CPU使用率

description

プロセッサの使用率。プロセッサが非アイドル状態のスレッドを実行した経過時間の割合。（単位:%）

unit

%

注※

JP1/PFM - Agent for Platform（Windows）のPIレコードのCPU %フィールドと同等です。

memory_unused※

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

memory_unused

default

false

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

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

resource_en

category

platform_windows

label

Memory unused

description

Available size in the physical memory area. The combined total of zero memory, free memory, and standby memory (cached) that can be immediately allocated to a process or be used by the system. [Units: GB]

unit

GB

resource_ja

category

platform_windows

label

空きメモリ量

description

物理メモリー領域の未使用サイズ。プロセスへの割り当て，またはシステムがすぐに利用できるゼロメモリー，空きメモリー，およびスタンバイメモリー（キャッシュ済み）の領域の合計。（単位:ギガバイト）

unit

ギガバイト

注※

JP1/PFM - Agent for Platform（Windows）のPIレコードのAvailable Mbytesフィールドと同等です。

ただし，単位が異なります。

memory_unused_rate※

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

memory_unused_rate

default

false

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

(windows_memory_available_bytes and $jp1im_TrendData_labels) / (windows_cs_physical_memory_bytes and $jp1im_TrendData_labels) * 100

resource_en

category

platform_windows

label

Available memory percentage

description

Percentage of available physical memory

unit

%

resource_ja

category

platform_windows

label

空きメモリ率

description

物理メモリの空き容量の割合。

unit

%

注※

JP1/PFM - Agent for Platform（Windows）に該当するフィールドはありません。

disk_unused※

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

disk_unused

default

false

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

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

resource_en

category

platform_windows

label

Disk unused

description

Size of the unused area of the disk. [Units: GB]

unit

GB

resource_ja

category

platform_windows

label

空きディスク領域

description

ディスクの未使用領域のサイズ。（単位:ギガバイト）

unit

ギガバイト

注※

JP1/PFM - Agent for Platform（Windows）のPI_LOGDレコードのFree Mbytesフィールドと同等です。

ただし，単位が異なります。

disk_unused_rate※

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

disk_unused_rate

default

false

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

(windows_logical_disk_free_bytes and $jp1im_TrendData_labels) / (windows_logical_disk_size_bytes and $jp1im_TrendData_labels) * 100

resource_en

category

platform_windows

label

Unused disk space percentage

description

Percentage of unused disk space

unit

%

resource_ja

category

platform_windows

label

空きディスク率

description

ディスクの未使用領域の割合。

unit

%

注※

JP1/PFM - Agent for Platform（Windows）のPI_LOGDレコードの% Free Spaceフィールドと同等です。

disk_busy_rate※

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

disk_busy_rate

default

false

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

100 - (rate(windows_logical_disk_idle_seconds_total[2m]) and $jp1im_TrendData_labels)/((rate(windows_logical_disk_write_seconds_total[2m]) and $jp1im_TrendData_labels) + (rate(windows_logical_disk_read_seconds_total[2m]) and $jp1im_TrendData_labels) + (rate(windows_logical_disk_idle_seconds_total[2m]) and $jp1im_TrendData_labels)) * 100

resource_en

category

platform_windows

label

Disk busy rate

description

Percentage of time the disk was busy when a read or write request was processed. [Units: %]

unit

%

resource_ja

category

platform_windows

label

ディスクビジー率

description

読み込みおよび書き込み要求の処理でディスクがビジーだった経過時間の割合。（単位:%）

unit

%

注※

JP1/PFM - Agent for Platform（Windows）のPI_PHYDレコードの% Disk Timeフィールドと同等です。

disk_read_latency※

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

disk_read_latency

default

false

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

(rate(windows_logical_disk_read_seconds_total[2m]) and $jp1im_TrendData_labels) / (rate(windows_logical_disk_reads_total[2m]) and $jp1im_TrendData_labels)

resource_en

category

platform_windows

label

Disk read latency

description

Average time (in seconds) taken to perform a single disk read operation

unit

second

resource_ja

category

platform_windows

label

ディスク読み込みレイテンシー

description

1回あたりのディスク読み込みにかかった平均時間（秒）。

unit

秒

注※

JP1/PFM - Agent for Platform（Windows）のPI_LOGDレコードのAvg Disk Secs/Readフィールドと同等です。

disk_write_latency※

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

disk_write_latency

default

false

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

(rate(windows_logical_disk_write_seconds_total[2m]) and $jp1im_TrendData_labels) / (rate(windows_logical_disk_writes_total[2m]) and $jp1im_TrendData_labels)

resource_en

category

platform_windows

label

Disk write latency

description

Average time (in seconds) taken to perform a single disk write operation

unit

second

resource_ja

category

platform_windows

label

ディスク書き込みレイテンシー

description

1回あたりのディスク書き込みにかかった平均時間（秒）。

unit

秒

注※

JP1/PFM - Agent for Platform（Windows）のPI_LOGDレコードのAvg Disk Secs/Writeフィールドと同等です。

disk_io_latency※

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

disk_io_latency

default

false

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

((rate(windows_logical_disk_read_seconds_total[2m]) and $jp1im_TrendData_labels) + (rate(windows_logical_disk_write_seconds_total[2m]) and $jp1im_TrendData_labels)) / ((rate(windows_logical_disk_reads_total[2m]) and $jp1im_TrendData_labels) + (rate(windows_logical_disk_writes_total[2m]) and $jp1im_TrendData_labels))

resource_en

category

platform_windows

label

Disk I/O latency

description

Average time (in seconds) taken to perform a single disk write and read operation

unit

second

resource_ja

category

platform_windows

label

ディスクIOレイテンシー

description

1回あたりのディスク書き込みと読み込みにかかった平均時間（秒）。

unit

秒

注※

JP1/PFM - Agent for Platform（Windows）のPI_LOGDレコードのAvg Disk Secs/Xferフィールドと同等です。

network_sent※

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

network_sent

default

false

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

rate(windows_net_packets_sent_total[2m]) and $jp1im_TrendData_labels

resource_en

category

platform_windows

label

Network sent

description

Rate at which packets were sent through the network interface. [Units: packets/second]

unit

packets/second

resource_ja

category

platform_windows

label

ネットワークの送信速度

description

ネットワークインターフェースで送信されるパケットの割合（パケット／秒）。

unit

パケット/秒

注※

JP1/PFM - Agent for Platform（Windows）のPI_NETIレコードのPkts Sent/secフィールドと同等です。

network_received※

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

network_received

default

false

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

rate(windows_net_packets_received_total[2m]) and $jp1im_TrendData_labels

resource_en

category

platform_windows

label

Network received

description

Rate at which packets were received through the network interface. [Units: packets/second]

unit

packets/second

resource_ja

category

platform_windows

label

ネットワークの受信速度

description

ネットワークインターフェースで受信されるパケットの割合（パケット／秒）。

unit

パケット/秒

注※

JP1/PFM - Agent for Platform（Windows）のPI_NETIレコードのPkts Rcvd/secフィールドと同等です。

Windows exporter（プロセス監視）のメトリック定義ファイル（metrics_windows_exporter_process.conf）

形式

JP1/IM - Agentの「Windows exporterのメトリック定義ファイル」と同じです。

ファイル

metrics_windows_exporter_process.conf

metrics_windows_exporter_process.conf.model（モデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Managerパス¥conf¥imdd¥plugin¥jp1pccs¥

論理ホストのとき

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

Linuxの場合

物理ホストのとき

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

論理ホストのとき

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

説明

［統合オペレーション・ビューアー］画面の［トレンド］タブで表示するWindows exporter（プロセス監視）のメトリック情報を定義するファイルです。

定義内容は，JP1/IM - Agentの製品プラグインの__metricListGetメソッド，および__timeSeriesDataGetメソッドの返却値に使用します。JP1/IM - Managerが階層構成で，統合マネージャーから下位マネージャーのトレンドデータ管理DBに保存されているトレンドデータを参照する場合，統合マネージャーのメトリック定義ファイルに参照するトレンドデータのメトリックを追加する必要があります。

文字コード

UTF-8（BOM無し）

改行コード

Windowsの場合：CR+LF

Linuxの場合：LF

定義の反映時期

JP1/IM - Agentの「Windows exporterのメトリック定義ファイル」と同じです。

記述内容

JP1/IM - Agentの「Windows exporterのメトリック定義ファイル」と同じです。

モデルファイルの設定内容（初期状態）

Windows exporter（プロセス監視）のメトリック定義ファイルのモデルファイルに記述されている各メトリックの設定内容（初期状態）を，次に示します。

process_pgm_process_count※

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

process_pgm_process_count

default

true

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

count by (instance, job, jp1_pc_nodelabel, jp1_pc_prome_hostname) (windows_process_start_time and $jp1im_TrendData_labels)

resource_en

category

platform_windows_process

label

Process count

description

Number of processes that are executing programs. Number of processes that have this program name inside the process table. [Units: count]

unit

count

resource_ja

category

platform_windows_process

label

プロセス数

description

プログラムを実行しているプロセス数。プロセステーブル内で，このプログラム名を持つプロセスの数。（単位:個）

unit

個

注※

JP1/PFM - Agent for Platform（Windows）で同等のフィールドはありません。JP1/PFM - Agent for Platform（UNIX）のPD_PGMレコードのPROCESS_COUNTフィールド（死活監視のために追加）と同等です。

Windows exporter（サービス監視）のメトリック定義ファイル（metrics_windows_exporter_service.conf）

形式

「Node exporterのメトリック定義ファイル（metrics_node_exporter.conf）」の「形式」を参照してください。

ファイル

metrics_windows_exporter_service.conf

metrics_windows_exporter_service.conf.model（モデルファイル）

格納先ディレクトリ

■統合マネージャーホスト

Windowsの場合

物理ホストのとき

Managerパス¥conf¥imdd¥plugin¥jp1pccs¥

論理ホストのとき

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

Linuxの場合

物理ホストのとき

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

論理ホストのとき

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

説明

Windowsのサービス監視機能でトレンドを取得する場合に使用します。サービス監視機能については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「3.15.1(1)(c)Windows exporter（Windows性能情報収集機能）」の「監視対象サービスの指定」を参照してください。

この定義ファイルには，サービスのIM管理ノードで取得できるメトリック情報を定義します。

JP1/IM - Managerが階層構成で，統合マネージャーから，下位マネージャーのトレンドデータ管理DBに保存されているトレンドデータを参照する場合，統合マネージャーのメトリック定義ファイルに，参照するトレンドデータのメトリックを追加する必要があります。

文字コード

UTF-8（BOM無し）

改行コード

Windowsの場合：CR+LF

Linuxの場合：LF

定義の反映時期

［統合オペレーション・ビューアー］画面の［トレンド］タブ，または，REST APIで，メトリックの情報を取得したときに反映されます。

記述内容

「Node exporterのメトリック定義ファイル（metrics_node_exporter.conf）」の「記述内容」を参照してください。

モデルファイルの設定内容（初期状態）

Windows exporter（サービス監視）のメトリック定義ファイルのモデルファイルに記述されている各メトリックの設定内容（初期状態）を次に示します。

service_state※

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

service_state

default

true

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

windows_service_state{state=¥"running¥"} and $jp1im_TrendData_labels

resource_en

category

platform_windows_service

label

Service state

description

Shows the state of the service.

0: Indicates that the service is not running.

1: Indicates that the service is running

unit

-

resource_ja

category

platform_windows_service

label

サービスの状態

description

サービスの状態を表します。

0:サービスの状態が，実行中ではないことを表す

1:サービスの状態が，実行中であることを表す

unit

-

注※

JP1/PFM - Agent for Platform（Windows）のPD_SVCレコードのStateフィールドと同等です。

Node exporter for AIXのメトリック定義ファイル（metrics_node_exporter_aix.conf）

形式

「Node exporterのメトリック定義ファイル（metrics_node_exporter.conf）」の「形式」を参照してください。

ファイル

metrics_node_exporter_aix.conf

metrics_node_exporter_aix.conf.model（モデルファイル）

格納先ディレクトリ

■統合マネージャーホスト

Windowsの場合

物理ホストのとき

Managerパス¥conf¥imdd¥plugin¥jp1pccs¥

論理ホストのとき

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

Linuxの場合

物理ホストのとき

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

論理ホストのとき

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

説明

［統合オペレーション・ビューアー］画面の［トレンド］タブで表示するNode exporter for AIXのメトリック情報を定義するファイルです。

定義内容は，JP1/IM - Agentの製品プラグインの__metricListGetメソッド，および__timeSeriesDataGetメソッドの返却値に使用します。

JP1/IM - Managerが階層構成で，統合マネージャーから，下位マネージャーのトレンドデータ管理DBに保存されているトレンドデータを参照する場合，統合マネージャーのメトリック定義ファイルに，参照するトレンドデータのメトリックを追加する必要があります。

文字コード

UTF-8（BOM無し）

改行コード

Windowsの場合：CR+LF

Linuxの場合：LF

定義の反映時期

［統合オペレーション・ビューアー］画面の［トレンド］タブ，または，REST APIで，メトリックの情報を取得したときに反映されます。

記述内容

「Node exporterのメトリック定義ファイル（metrics_node_exporter.conf）」の「記述内容」を参照してください。

モデルファイルの設定内容（初期状態）

Node exporter for AIXのメトリック定義ファイルのモデルファイルに記述されている各メトリックの設定内容（初期状態）を，次に示します。

cpu_used_rate※

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

cpu_used_rate

default

true

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

((avg by(instance,job,jp1_pc_nodelabel,jp1_pc_prome_hostname) (rate(node_cpu{mode=¥"sys¥"}[2m]) and $jp1im_TrendData_labels))+(avg by(instance,job,jp1_pc_nodelabel,jp1_pc_prome_hostname) ((rate(node_cpu{mode=¥"user¥"}[2m]) and $jp1im_TrendData_labels))))*100

resource_en

category

platform_unix

label

CPU used rate

description

CPU usage.It also indicates the average value per processor. [Units: %]

unit

%

resource_ja

category

platform_unix

label

CPU使用率

description

CPU使用率（%）。

プロセッサごとの割合の平均値でもある。

unit

%

注※

JP1/PFM - Agent for Platform（UNIX）のPIレコードのCPU %フィールドと同等です。

マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「3.15.1(f) Node exporter for AIX（AIX性能情報収集機能）」の，「SMTやMicro-Partitioningを使用した環境での注意事項」を参照してください。

memory_unused※

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

memory_unused

default

false

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

(aix_memory_real_avail and $jp1im_TrendData_labels)/1024/1024/1024*4096

resource_en

category

platform_unix

label

Memory unused

description

Size of the physical memory that can actually be used by the application.

unit

GB

resource_ja

category

platform_unix

label

空きメモリ量

description

実際にアプリケーションが使用することができる物理メモリーのサイズ。

unit

ギガバイト

注※

JP1/PFM - Agent for Platform（UNIX）のPIレコードのEffective Free Mem Mbytesフィールドと同等ですが，値に差異があります。Node exporter for AIXのデータソースについては，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「3.15.1(f) Node exporter for AIX（AIX性能情報収集機能）」の，「主な取得項目」を参照してください。

memory_unused_rate※

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

memory_unused_rate

default

false

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

(aix_memory_real_avail and $jp1im_TrendData_labels)/(aix_memory_real_total and $jp1im_TrendData_labels) * 100

resource_en

category

platform_unix

label

Available memory percentage

description

Percentage of physical memory actually available to the application.

unit

%

resource_ja

category

platform_unix

label

空きメモリ率

description

実際にアプリケーションが使用することができる物理メモリーの割合。

unit

%

注※

JP1/PFM - Agent for Platform（UNIX）のPIレコードのEffective Free Mem %フィールドと同等ですが，値に差異があります。Node exporter for AIXのデータソースについては，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「3.15.1(f) Node exporter for AIX（AIX性能情報収集機能）」の，「主な取得項目」を参照してください。

disk_unused※

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

disk_unused

default

false

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

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

resource_en

category

platform_unix

label

Disk unused

description

Size of the unused area of the disk. [Units: GB]

unit

GB

resource_ja

category

platform_unix

label

空きディスク領域

description

ディスクの未使用領域のサイズ。（単位:ギガバイト）

unit

ギガバイト

注※

JP1/PFM - Agent for Platform（UNIX）のPD_FSLレコードのMbytes Freeフィールドと同等です。

disk_unused_rate※

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

disk_unused_rate

default

false

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

(node_filesystem_free_bytes and $jp1im_TrendData_labels) / (node_filesystem_size_bytes and $jp1im_TrendData_labels) * 100

resource_en

category

platform_unix

label

Unused disk space percentage

description

Percentage of unused disk space.

unit

%

resource_ja

category

platform_unix

label

空きディスク率

description

ディスクの未使用領域の割合。

unit

%

注※

JP1/PFM - Agent for Platform（UNIX）のPD_FSLレコードのMbytes Free %フィールドと同等です。

disk_busy_rate※

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

disk_busy_rate

default

false

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

(rate(aix_disk_time[2m]) and $jp1im_TrendData_labels)

resource_en

category

platform_unix

label

Disk busy rate

description

Percentage of time the disk was busy with read and write requests. This value may exceed 100 when processes are continuously executed on a device. [Units: %]

unit

%

resource_ja

category

platform_unix

label

ディスクビジー率

description

ディスクのビジー率（%）。

デバイスに対する処理が連続で行われる場合に「100」を超えることがあります。

unit

%

注※

JP1/PFM - Agent for Platform（UNIX）のPI_DEVDレコードのBusy %フィールドと同等です。

disk_read_latency※¹

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

disk_read_latency

default

false

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）※2

(rate(aix_disk_rserv[2m]) and $jp1im_TrendData_labels) / (rate(aix_disk_xrate[2m]) and $jp1im_TrendData_labels)/1000/1000/1000

resource_en

category

platform_unix

label

Disk read latency

description

Average time (in seconds) taken to perform a single disk read operation.

unit

second

resource_ja

category

platform_unix

label

ディスク読み込みレイテンシー

description

1回あたりのディスク読み込みにかかった平均時間（秒）。

unit

秒

注※1

JP1/PFM - Agent for Platform（UNIX）で同等のフィールドはありません。

注※2

PromQL文のrange vector型で指定している値（大括弧[ ]で指定する値）の範囲内でディスク読み込みが発生していない場合，PromQL文の計算結果が値無しとなります。

disk_write_latency※¹

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

disk_write_latency

default

false

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）※2

(rate(aix_disk_wserv[2m]) and $jp1im_TrendData_labels) / ((rate(aix_disk_xfers[2m]) and $jp1im_TrendData_labels) - (rate(aix_disk_xrate[2m]) and $jp1im_TrendData_labels))/1000/1000/1000

resource_en

category

platform_unix

label

Disk write latency

description

Average time (in seconds) taken to perform a single disk write operation.

unit

second

resource_ja

category

platform_unix

label

ディスク書き込みレイテンシー

description

1回あたりのディスク書き込みにかかった平均時間（秒）。

unit

秒

注※1

JP1/PFM - Agent for Platform（UNIX）で同等のフィールドはありません。

注※2

PromQL文のrange vector型で指定している値（大括弧[ ]で指定する値）の範囲内でディスク書き込みが発生していない場合，PromQL文の計算結果が値無しとなります。

disk_io_latency※¹

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

disk_io_latency

default

false

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）※2

((rate(aix_disk_rserv[2m]) and $jp1im_TrendData_labels) + (rate(aix_disk_wserv[2m]) and $jp1im_TrendData_labels)) / (rate(aix_disk_xfers[2m]) and $jp1im_TrendData_labels)/1000/1000/1000

resource_en

category

platform_unix

label

Disk I/O latency

description

Average time (in seconds) taken to perform a single disk write and read operation.

unit

second

resource_ja

category

platform_unix

label

ディスクIOレイテンシー

description

1回あたりのディスク書き込みとディスク読み込みにかかった平均時間（秒）。

unit

秒

注※1

JP1/PFM - Agent for Platform（UNIX）で同等のフィールドはありません。

注※2

PromQL文のrange vector型で指定している値（大括弧[ ]で指定する値）の範囲内でディスク読み込みと書き込みが発生していない場合，PromQL文の計算結果が値無しとなります。

network_sent※

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

network_sent

default

false

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

(rate(aix_netinterface_opackets[2m]) and $jp1im_TrendData_labels)

resource_en

category

platform_unix

label

Network sent

description

Rate of transmitting network interface packets. [Units: packets/second]

unit

packets/second

resource_ja

category

platform_unix

label

ネットワークの送信速度

description

ネットワークインターフェースで送信されるパケットの割合。（単位:パケット/秒）

unit

パケット/秒

注※

JP1/PFM - Agent for Platform（UNIX）のPI_NINDレコードのPkts Xmitd/secフィールドと同等です。

network_received※

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

network_received

default

false

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

(rate(aix_netinterface_ipackets[2m]) and $jp1im_TrendData_labels)

resource_en

category

platform_unix

label

Network received

description

Rate of receiving network interface packets. [Units: packets/second]

unit

packets/second

resource_ja

category

platform_unix

label

ネットワークの受信速度

description

ネットワークインターフェースで受信されるパケットの割合。（単位:パケット/秒）

unit

パケット/秒

注※

JP1/PFM - Agent for Platform（UNIX）のPI_NINDレコードのPkts Rcvd/secフィールドと同等です。

Blackbox exporterのメトリック定義ファイル（metrics_blackbox_exporter.conf）

形式

[
  {
    "name":"トレンドデータのメトリック名",
    "default":デフォルト選択状態,
    "promql":"PromQL文",
    "resource_en":{
      "category":"メトリックのカテゴリ（英語）",
      "label":"メトリック表示名（英語）",
      "description":"メトリックの説明（英語）",
      "unit":"メトリックの単位（英語）"
    },
    "resource_ja":{
      "category":"メトリックのカテゴリ（日本語）",
      "label":"メトリック表示名（日本語）",
      "description":"メトリックの説明（日本語）",
      "unit":"メトリックの単位（日本語）"
    },
    "module": "モジュール名",
    "drop_legend_labels": ["ラベル名", ･･･]
  }, ･･･
]※

注※

[]内に記述できる要素の数は1〜1,000個です。範囲外の個数の要素を記述した場合は，KAJY24609-Eのエラーメッセージを出力します。

ファイル

metrics_blackbox_exporter.conf

metrics_blackbox_exporter.conf.model（モデルファイル）

格納先ディレクトリ

■統合マネージャーホスト

Windowsの場合

物理ホストのとき

Managerパス¥conf¥imdd¥plugin¥jp1pccs¥

論理ホストのとき

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

Linuxの場合

物理ホストのとき

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

論理ホストのとき

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

説明

［統合オペレーション・ビューアー］画面の［トレンド］タブで表示するBlackbox exporterのメトリック情報を定義するファイルです。

定義内容は，JP1/IM - Agentの製品プラグインの__metricListGetメソッド，および__timeSeriesDataGetメソッドの返却値に使用します。

JP1/IM - Managerが階層構成で，統合マネージャーから，下位マネージャーのトレンドデータ管理DBに保存されているトレンドデータを参照する場合，統合マネージャーのメトリック定義ファイルに，参照するトレンドデータのメトリックを追加する必要があります。

文字コード

UTF-8（BOM無し）

改行コード

Windowsの場合：CR+LF

Linuxの場合：LF

定義の反映時期

［統合オペレーション・ビューアー］画面の［トレンド］タブ，または，REST APIで，メトリックの情報を取得したときに反映されます。

記述内容

moduleメンバーに設定する値を次に示します。それ以外のメンバーに設定する値については，「Node exporterのメトリック定義ファイル（metrics_node_exporter.conf）」の「記述内容」を参照してください。

表2‒96　 メトリック定義ファイルのmoduleメンバーに設定する値

メンバー名

省略可否

型

設定する値

module

可

string

このメトリックを返却するIM管理ノードのmoduleの値に，前方一致する文字列を設定します。

このメンバーは，Blackbox exporterのメトリック定義ファイルの場合だけ，任意で設定します。

1〜255文字で，制御文字（0x00〜0x1F，0x7F〜0x9F）を除く文字を指定します。

指定不可の文字を含む場合，KAJY24604-EまたはKAJY24605-Eのエラーメッセージが出力されます。

指定を省略した場合，Blackbox exporterのすべてのリモートエージェントSIDに対して，このメトリックを返却します。

IM管理ノードのmoduleの値は，Prometheus設定ファイル（jpc_prometheus_server.yml）のスクレイプのジョブのmoduleに指定した値です。また，この値は，Blackbox exporterのリモートエージェントSIDのModuleプロパティに表示されます。

（例1）http

（例2）icmp

モデルファイルの設定内容（初期状態）

Blackbox exporterのメトリック定義ファイルのモデルファイルに記述されている各メトリックの設定内容（初期状態）を，次に示します。

probe_success

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

probe_success

default

false

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

probe_success and $jp1im_TrendData_labels

resource_en

category

probe

label

Probe success or failure

description

Displays whether or not the probe was a success

unit

-

resource_ja

category

probe

label

プローブ成否

description

プローブが成功したかどうかを表示します。

0：失敗

1：成功

unit

-

module

指定しない

probe_duration_seconds

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

probe_duration_seconds

default

true

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

probe_duration_seconds and $jp1im_TrendData_labels

resource_en

category

probe

label

Probe period

description

Returns how long the probe took to complete in seconds

unit

second

resource_ja

category

probe

label

プローブ期間

description

プローブが完了するまでに要した時間を秒単位で返します。

unit

秒

module

指定しない

probe_icmp_duration_seconds

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

probe_icmp_duration_seconds

default

true

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

probe_icmp_duration_seconds and $jp1im_TrendData_labels

resource_en

category

icmp

label

ICMP period

description

Duration of icmp request

unit

second

resource_ja

category

icmp

label

ICMP期間

description

フェーズごとのICMP要求の期間

unit

秒

module

icmp

probe_http_duration_seconds

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

probe_http_duration_seconds

default

true

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

probe_http_duration_seconds and $jp1im_TrendData_labels

resource_en

category

http

label

HTTP request period

description

Duration of http request by phase, summed over all redirects

unit

second

resource_ja

category

icmp

label

HTTPリクエスト期間

description

フェーズごとのHTTPリクエストの期間，すべてのリダイレクトで合計

unit

秒

module

http

probe_http_status_code

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

probe_http_status_code

default

false

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

probe_http_status_code and $jp1im_TrendData_labels

resource_en

category

http

label

HTTP status

description

Response HTTP status code

unit

-

resource_ja

category

http

label

HTTPステータス

description

HTTPレスポンスステータスコード

unit

-

module

http

Yet another cloudwatch exporterのメトリック定義ファイル（metrics_ya_cloudwatch_exporter.conf）

形式

[
  {
    "name":"トレンドデータのメトリック名",
    "default":デフォルト選択状態,
    "promql":"PromQL文",
    "resource_en":{
      "category":"メトリックのカテゴリ（英語）",
      "label":"メトリック表示名（英語）",
      "description":"メトリックの説明（英語）",
      "unit":"メトリックの単位（英語）"
    },
    "resource_ja":{
      "category":"メトリックのカテゴリ（日本語）",
      "label":"メトリック表示名（日本語）",
      "description":"メトリックの説明（日本語）",
      "unit":"メトリックの単位（日本語）"
    },
    "cloud_srv": "AWSサービス名前空間名",
    "drop_legend_labels": ["ラベル名", ･･･]
  }, ･･･
]※

注※

[]内に記述できる要素の数は1〜1,000個です。範囲外の個数の要素を記述した場合は，KAJY24609-Eのエラーメッセージを出力します。

ファイル

metrics_ya_cloudwatch_exporter.conf

metrics_ya_cloudwatch_exporter.conf.model（モデルファイル）

格納先ディレクトリ

■統合マネージャーホスト

Windowsの場合

物理ホストのとき

Managerパス¥conf¥imdd¥plugin¥jp1pccs¥

論理ホストのとき

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

Linuxの場合

物理ホストのとき

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

論理ホストのとき

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

説明

［統合オペレーション・ビューアー］画面の［トレンド］タブで表示するYet another cloudwatch exporterのメトリック情報を定義するファイルです。

定義内容は，JP1/IM - Agentの製品プラグインの__metricListGetメソッド，および__timeSeriesDataGetメソッドの返却値に使用します。

Yet another cloudwatch exporterのIM管理ノードは，Yet another cloudwatch exporterのメトリック定義ファイルに定義されているメトリックのリソースだけに作成します。

JP1/IM - Managerが階層構成で，統合マネージャーから，下位マネージャーのトレンドデータ管理DBに保存されているトレンドデータを参照する場合，統合マネージャーのメトリック定義ファイルに，参照するトレンドデータのメトリックを追加する必要があります。

文字コード

UTF-8（BOM無し）

改行コード

Windowsの場合：CR+LF

Linuxの場合：LF

定義の反映時期

［統合オペレーション・ビューアー］画面の［トレンド］タブ，または，REST APIで，メトリックの情報を取得したときに反映されます。

Yet another cloudwatch exporterのIM管理ノードについては，jddcreatetreeコマンドおよびjddupdatetreeコマンドを実行したときに反映されます。

記述内容

nameメンバーとcloud_srvメンバーに設定する値を次に示します。それ以外のメンバーに設定する値については，「Node exporterのメトリック定義ファイル（metrics_node_exporter.conf）」の「記述内容」を参照してください。

表2‒97　 メトリック定義ファイルのnameメンバーとcloud_srvメンバーに設定する値

メンバー名

省略可否

型

設定する値

name

不可

string

トレンドデータのメトリック名を設定します。

トレンドデータ（時系列データ）のメトリック名は，［統合オペレーション・ビューアー］画面の［トレンド］タブで，トレンドデータの種類を示す文字列として表示されます。

Yet another cloudwatch exporterのメトリック定義ファイルの場合，ここで定義されているメトリックのリソースだけを作成します。また，メトリック名は，Yet another cloudwatch exporterのメトリック名と一致させる必要があります。

1〜255文字で，次に示す文字を指定できます。

半角英数字

-（ハイフン）

_（アンダースコア）

指定不可の文字を含む場合，KAJY24604-EまたはKAJY24605-Eのエラーメッセージが出力されます。

メトリック名は，メトリック定義ファイル内で一意にしてください。一意でない場合，KAJY24608-Eのエラーメッセージが出力されます。

cloud_srv

可

string

AWSサービス名前空間名を設定します。

このメンバーは，Yet another cloudwatch exporterのメトリック定義ファイルの場合だけ，必須で設定します。

Yet another cloudwatch exporter設定ファイル（jpc_ya_cloudwatch_exporter.yml）で指定した次の名前空間の名称を設定します。

<Auto-discovery job>のtypeで指定した名前空間※

（例1）AWS/EC2

（例2）AWS/S3

1〜255文字で，次に示す文字を指定できます。

半角英数字

.（ピリオド）

-（ハイフン）

_（アンダースコア）

/（スラッシュ）

#（ハッシュ）

:（コロン）

指定不可の文字を含む場合，KAJY24604-EまたはKAJY24605-Eのエラーメッセージが出力されます。

注※

Auto-discovery jobのtypeに指定できる名前空間（サービス）については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「3.15.6(1)(k) Yet another cloudwatch exporterのIM管理ノードの作成」の，JP1/IM - AgentのYet another cloudwatch exporterが監視対象としてサポートするAWSの名前空間について説明している個所を参照してください。

モデルファイルの設定内容（初期状態）

Yet another cloudwatch exporterのメトリック定義ファイルのモデルファイルに記述されている各メトリックの設定内容（初期状態）を，次に示します。

aws_ec2_cpuutilization_average

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

aws_ec2_cpuutilization_average

default

false

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

aws_ec2_cpuutilization_average and $jp1im_TrendData_labels

resource_en

category

aws_ec2

label

CPU utilization

description

The percentage of the allocated EC2 compute units that are currently in use on the instance. For details, see the description of the CPUUtilization metric for AWS/EC2.

unit

%

resource_ja

category

aws_ec2

label

CPU使用率

description

割り当てられた EC2 コンピュートユニットのうち，現在インスタンス上で使用されているものの比率。

詳細はAWS/EC2のCPUUtilizationメトリックの説明を参照してください。

unit

%

cloud_srv

AWS/EC2

aws_ec2_disk_read_bytes_sum

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

aws_ec2_disk_read_bytes_sum

default

false

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

(aws_ec2_disk_read_bytes_sum and $jp1im_TrendData_labels) / 1024

resource_en

category

aws_ec2

label

Amount of data read in KB

description

Amount of data in KB read from all instance store volumes available to the instance.

For more information, see the description of the DiskReadBytes metric of AWS EC2.

unit

KB

resource_ja

category

aws_ec2

label

読み取りキロバイト数

description

インスタンスで利用できるすべてのインスタンスストアボリュームから読み取られたキロバイト数。

詳細はAWS/EC2のDiskReadBytesメトリックの説明を参照してください。

unit

キロバイト

cloud_srv

AWS/EC2

aws_ec2_disk_write_bytes_sum

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

aws_ec2_disk_write_bytes_sum

default

false

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

(aws_ec2_disk_write_bytes_sum and $jp1im_TrendData_labels) / 1024

resource_en

category

aws_ec2

label

Amount of data written in KB

description

Amount of data in KB written to all instance store volumes available to the instance.

For more information, see the description of the DiskWriteBytes metric of AWS EC2.

unit

KB

resource_ja

category

aws_ec2

label

書き込みキロバイト数

description

インスタンスで利用できるすべてのインスタンスストアボリュームに書き込まれたキロバイト数。

詳細はAWS/EC2のDiskWriteBytesメトリックの説明を参照してください。

unit

キロバイト

cloud_srv

AWS/EC2

aws_lambda_errors_sum

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

aws_lambda_errors_sum

default

false

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

aws_lambda_errors_sum and $jp1im_TrendData_labels

resource_en

category

aws_lambda

label

Number of invocations

description

The number of invocations that result in a function error. For details, see the description of the Errors metric for AWS/Lambda.

unit

count

resource_ja

category

aws_lambda

label

呼び出し数

description

関数エラーが発生した呼び出しの数。

詳細はAWS/LambdaのErrorsメトリックの説明を参照してください。

unit

個

cloud_srv

AWS/Lambda

aws_lambda_duration_average

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

aws_lambda_duration_average

default

false

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

aws_lambda_duration_average and $jp1im_TrendData_labels

resource_en

category

aws_lambda

label

Event processing time

description

The amount of time that your function code spends processing an event. For details, see the description of the Duration metric for AWS/Lambda.

unit

msec

resource_ja

category

aws_lambda

label

イベント処理時間

description

関数コードがイベントの処理に費やす時間。

詳細はAWS/LambdaのDurationメトリックの説明を参照してください。

unit

ミリ秒

cloud_srv

AWS/Lambda

aws_s3_bucket_size_bytes_sum

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

aws_s3_bucket_size_bytes_sum

default

false

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

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

resource_en

category

aws_s3

label

Amount of data stored

description

The amount of data in GB stored in a bucket in the STANDARD storage class, INTELLIGENT_TIERING storage class, Standard-Infrequent Access (STANDARD_IA) storage class, OneZone-Infrequent Access (ONEZONE_IA), Reduced Redundancy Storage (RRS) class, Deep Archive Storage (S3 Glacier Deep Archive) class or, Glacier (GLACIER) storage class. For details, see the description of the BucketSizeBytes metric for AWS/S3.

unit

GB

resource_ja

category

aws_s3

label

保存データ量

description

STANDARD ストレージクラス，INTELLIGENT_TIERING ストレージクラス，標準低頻度アクセス（STANDARD_IA）ストレージクラス，OneZone 低頻度アクセス（ONEZONE_IA），低冗長化ストレージ (RRS) クラス，ディープアーカイブストレージ（S3 Glacier Deep Archive），または Glacier （GLACIER）ストレージクラスのバケットに保存されているデータの量（ギガバイト単位）。

詳細はAWS/S3のBucketSizeBytesメトリックの説明を参照してください。

unit

ギガバイト

cloud_srv

AWS/S3

aws_s3_5xx_errors_sum

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

aws_s3_5xx_errors_sum

default

false

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

aws_s3_5xx_errors_sum and $jp1im_TrendData_labels

resource_en

category

aws_s3

label

Number of 5xx server errors

description

The number of HTTP 5xx server error status code requests made to an Amazon S3 bucket with a value of either 0 or 1. For details, see the description of the 5xx_errors metric for AWS/S3.

unit

count

resource_ja

category

aws_s3

label

5xxサーバエラー数

description

Amazon S3バケットに対して行われた，値が0または1のHTTP 5xxサーバーエラーステータスコードリクエストの数。

詳細はAWS/S3の5xx_errorsメトリックの説明を参照してください。

unit

個

cloud_srv

AWS/S3

aws_dynamodb_consumed_read_capacity_units_sum

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

aws_dynamodb_consumed_read_capacity_units_sum

default

false

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

aws_dynamodb_consumed_read_capacity_units_sum and $jp1im_TrendData_labels

resource_en

category

aws_dynamo_db

label

Number of read capacity units

description

The total number of read capacity units consumed. For details, see the description of the ConsumedReadCapacityUnits metric for Amazon DynamoDB.

unit

count

resource_ja

category

aws_dynamo_db

label

読み込み容量ユニット数

description

消費された読み込み容量ユニットの合計。

詳細はAmazon DynamoDBのConsumedReadCapacityUnitsメトリックの説明を参照してください。

unit

個

cloud_srv

AWS/DynamoDB

aws_dynamodb_consumed_write_capacity_units_sum

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

aws_dynamodb_consumed_write_capacity_units_sum

default

false

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

aws_dynamodb_consumed_write_capacity_units_sum and $jp1im_TrendData_labels

resource_en

category

aws_dynamo_db

label

Number of write capacity units

description

The total number of write capacity units consumed. For details, see the description of the ConsumedWriteCapacityUnits metric for Amazon DynamoDB.

unit

count

resource_ja

category

aws_dynamo_db

label

書き込み容量ユニット数

description

消費された書き込み容量ユニットの合計。

詳細はAmazon DynamoDBのConsumedWriteCapacityUnitsメトリックの説明を参照してください。

unit

個

cloud_srv

AWS/DynamoDB

aws_states_execution_time_average

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

aws_states_execution_time_average

default

false

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

aws_states_execution_time_average and $jp1im_TrendData_labels

resource_en

category

aws_states

label

Execution time

description

The average of the interval, in milliseconds, from the start to the end of the execution of Step Functions. For details, see the description of the ExecutionTime metric for AWS Step Functions.

unit

msec

resource_ja

category

aws_states

label

実行時間

description

Step Functionsの実行の開始時点から終了時点までの間隔の平均値（ミリ秒単位）。

詳細はAWS Step FunctionsのExecutionTimeメトリックの説明を参照してください。

unit

ミリ秒

cloud_srv

AWS/States

aws_states_executions_failed_sum

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

aws_states_executions_failed_sum

default

false

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

aws_states_executions_failed_sum and $jp1im_TrendData_labels

resource_en

category

aws_states

label

Number of failed executions

description

The total number of failed executions of Step Functions. For details, see the description of the ExecutionsFailed metric for AWS Step Functions.

unit

count

resource_ja

category

aws_states

label

実行失敗数

description

Step Functionsの失敗した実行の合計数。

詳細はAWS Step FunctionsのExecutionsFailedメトリックの説明を参照してください。

unit

個

cloud_srv

AWS/States

aws_sqs_approximate_number_of_messages_delayed_sum

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

aws_sqs_approximate_number_of_messages_delayed_sum

default

false

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

aws_sqs_approximate_number_of_messages_delayed_sum and $jp1im_TrendData_labels

resource_en

category

aws_sqs

label

Number of messages in the delay queue

description

The total number of messages in the queue that are delayed and not available for reading immediately. For details, see the description of the ApproximateNumberOfMessagesDelayed metric for Amazon SQS.

unit

count

resource_ja

category

aws_sqs

label

遅延キューメッセージ数

description

遅延が発生したため，すぐに読み取ることのできない，キューのメッセージの合計数。

詳細はAmazon SQSのApproximateNumberOfMessagesDelayedメトリックの説明を参照してください。

unit

個

cloud_srv

AWS/SQS

aws_sqs_number_of_messages_deleted_sum

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

aws_sqs_number_of_messages_deleted_sum

default

false

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

aws_sqs_number_of_messages_deleted_sum and $jp1im_TrendData_labels

resource_en

category

aws_sqs

label

Number of messages in the deletion queue

description

The total number of messages deleted from the queue. For details, see the description of the NumberOfMessagesDeleted metric for Amazon SQS.

unit

count

resource_ja

category

aws_sqs

label

削除キューメッセージ数

description

キューから削除されたメッセージの合計数。

詳細はAmazon SQSのNumberOfMessagesDeletedメトリックの説明を参照してください。

unit

個

cloud_srv

AWS/SQS

aws_ebs_volume_read_bytes_sum

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

aws_ebs_volume_read_bytes_sum

default

FALSE

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

aws_ebs_volume_read_bytes_sum and $jp1im_TrendData_labels

resource_en

category

aws_ebs

label

Number of bytes read

description

Total number of bytes transferred in read operations over the specified time period. For details, see the description of the VolumeReadBytes metric for AWS/EBS.

unit

byte

resource_ja

category

aws_ebs

label

読み取りバイト数

description

指定された期間の読み取りオペレーションで転送されたバイトの総数。詳細はAWS/EBSのVolumeReadBytesメトリックの説明を参照してください。

unit

byte

cloud_srv

AWS/EBS

aws_ebs_volume_write_bytes_sum

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

aws_ebs_volume_write_bytes_sum

default

FALSE

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

aws_ebs_volume_write_bytes_sum and $jp1im_TrendData_labels

resource_en

category

aws_ebs

label

Number of bytes written

description

Total number of bytes transferred in write operations over the specified time period. For details, see the description of the VolumeWriteBytes metric for AWS/EBS.

unit

byte

resource_ja

category

aws_ebs

label

書き込みバイト数

description

指定された期間の書き込みオペレーションで転送されたバイトの総数。詳細はAWS/EBSのVolumeWriteBytesメトリックの説明を参照してください。

unit

byte

cloud_srv

AWS/EBS

aws_ecs_cpuutilization_average

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

aws_ecs_cpuutilization_average

default

FALSE

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

aws_ecs_cpuutilization_average and $jp1im_TrendData_labels

resource_en

category

aws_ecs

label

CPU utilization

description

Percentage of CPU used by the cluster or service. For details, see the description of the CPUUtilization metric for AWS/ECS.

unit

%

resource_ja

category

aws_ecs

label

CPU使用率

description

クラスターやサービスで使用されているCPUの割合。詳細はAWS/ECSのCPUUtilizationメトリックの説明を参照してください。

unit

%

cloud_srv

AWS/ECS

aws_ecs_memory_utilization_average

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

aws_ecs_memory_utilization_average

default

FALSE

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

aws_ecs_memory_utilization_average and $jp1im_TrendData_labels

resource_en

category

aws_ecs

label

Memory utilization

description

Percentage of memory utilized by the cluster or service. For details, see the description of the MemoryUtilization metric for AWS/ECS.

unit

%

resource_ja

category

aws_ecs

label

メモリ使用率

description

クラスターやサービスで利用されるメモリの割合。詳細はAWS/ECSのMemoryUtilizationメトリックの説明を参照してください。

unit

%

cloud_srv

AWS/ECS

aws_efs_total_iobytes_average

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

aws_efs_total_iobytes_average

default

FALSE

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

aws_efs_total_iobytes_average and $jp1im_TrendData_labels

resource_en

category

aws_efs

label

Total bytes

description

The actual number of bytes for each file system operation, including read data, write data, and metadata operations. For details, see the description of the TotalIOBytes metric for AWS/EFS.

unit

byte

resource_ja

category

aws_efs

label

トータルバイト数

description

読み取りデータ，書き込みデータ，メタデータオペレーションを含む，各ファイルシステムオペレーションの実際のバイト数。詳細はAWS/EFSのTotalIOBytesメトリックの説明を参照してください。

unit

byte

cloud_srv

AWS/EFS

aws_efs_storage_bytes_average

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

aws_efs_storage_bytes_average

default

FALSE

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

aws_efs_storage_bytes_average and $jp1im_TrendData_labels

resource_en

category

aws_efs

label

Storage usage

description

File system size in bytes. For details, see the description of the StorageBytes metric for AWS/EFS.

unit

byte

resource_ja

category

aws_efs

label

使用量

description

ファイルシステムのサイズ（バイト単位）。詳細はAWS/EFSのStorageBytesメトリックの説明を参照してください。

unit

byte

cloud_srv

AWS/EFS

aws_fsx_data_read_bytes_sum

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

aws_fsx_data_read_bytes_sum

default

FALSE

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

aws_fsx_data_read_bytes_sum and $jp1im_TrendData_labels

resource_en

category

aws_fsx

label

Number of bytes read

description

Number of bytes in file system read operations. For details, see the description of the DataReadBytes metric for AWS/FSx.

unit

byte

resource_ja

category

aws_fsx

label

読み取りバイト数

description

ファイルシステムの読み取りオペレーションのバイト数。詳細はAWS/FSxのDataReadBytesメトリックの説明を参照してください。

unit

byte

cloud_srv

AWS/FSx

aws_fsx_data_write_bytes_sum

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

aws_fsx_data_write_bytes_sum

default

FALSE

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

aws_fsx_data_write_bytes_sum and $jp1im_TrendData_labels

resource_en

category

aws_fsx

label

Number of bytes written

description

Number of bytes in file system write operations. For details, see the description of the DataWriteBytes metric for AWS/FSx.

unit

byte

resource_ja

category

aws_fsx

label

書き込みバイト数

description

ファイルシステムの書き込みオペレーションのバイト数。詳細はAWS/FSxのDataWriteBytesメトリックの説明を参照してください。

unit

byte

cloud_srv

AWS/FSx

aws_fsx_free_storage_capacity_average

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

aws_fsx_free_storage_capacity_average

default

FALSE

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

aws_fsx_free_storage_capacity_average and $jp1im_TrendData_labels

resource_en

category

aws_fsx

label

Free space

description

Available storage capacity. For details, see the description of the FreeStorageCapacity metric for AWS/FSx.

unit

byte

resource_ja

category

aws_fsx

label

空き容量

description

使用できるストレージ容量。詳細はAWS/FSxのFreeStorageCapacityメトリックの説明を参照してください。

unit

byte

cloud_srv

AWS/FSx

aws_rds_cpuutilization_average

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

aws_rds_cpuutilization_average

default

FALSE

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

aws_rds_cpuutilization_average and $jp1im_TrendData_labels

resource_en

category

aws_rds

label

CPU utilization

description

CPU utilization. For details, see the description of the CPUUtilization metric for AWS/RDS.

unit

%

resource_ja

category

aws_rds

label

CPU使用率

description

CPU使用率。詳細はAWS/RDSのCPUUtilizationメトリックの説明を参照してください。

unit

%

cloud_srv

AWS/RDS

aws_rds_read_iops_average

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

aws_rds_read_iops_average

default

FALSE

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

aws_rds_read_iops_average and $jp1im_TrendData_labels

resource_en

category

aws_rds

label

Read IOPS

description

Average number of disk read I/O operations per second. For details, see the description of the ReadIOPS metric for AWS/RDS.

unit

count/second

resource_ja

category

aws_rds

label

読み取りIOPS

description

1秒あたりのディスク読み取りI/O操作の平均回数。詳細はAWS/RDSのReadIOPSメトリックの説明を参照してください。

unit

個/秒

cloud_srv

AWS/RDS

aws_rds_write_iops_average

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

aws_rds_write_iops_average

default

FALSE

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

aws_rds_write_iops_average and $jp1im_TrendData_labels

resource_en

category

aws_rds

label

Write IOPS

description

Average number of disk write I/O operations per second. For details, see the description of the WriteIOPS metric for AWS/RDS.

unit

count/second

resource_ja

category

aws_rds

label

書き込みIOPS

description

1秒あたりのディスク書き込みI/O操作の平均回数。詳細はAWS/RDSのWriteIOPSメトリックの説明を参照してください。

unit

個/秒

cloud_srv

AWS/RDS

aws_sns_number_of_notifications_failed_sum

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

aws_sns_number_of_notifications_failed_sum

default

FALSE

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

aws_sns_number_of_notifications_failed_sum and $jp1im_TrendData_labels

resource_en

category

aws_sns

label

Number of failed notifications

description

The number of messages that Amazon SNS failed to deliver. For details, see the description of the NumberOfNotificationsFailed metric for AWS/SNS.

unit

count

resource_ja

category

aws_sns

label

失敗したメッセージ数

description

Amazon SNS が配信に失敗したメッセージの数。詳細はAWS/SNSのNumberOfNotificationsFailedメトリックの説明を参照してください。

unit

個

cloud_srv

AWS/SNS

aws_sns_number_of_notifications_filtered_out_sum

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

aws_sns_number_of_notifications_filtered_out_sum

default

FALSE

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

aws_sns_number_of_notifications_filtered_out_sum and $jp1im_TrendData_labels

resource_en

category

aws_sns

label

Number of filterd out notifications

description

Number of messages rejected by subscription filter policy. For details, see the description of the NumberOfNotificationsFilteredOut metric for AWS/SNS.

unit

count

resource_ja

category

aws_sns

label

拒否されたメッセージ数

description

サブスクリプションフィルターポリシーによって拒否されたメッセージの数。詳細はAWS/SNSのNumberOfNotificationsFilteredOutメトリックの説明を参照してください。

unit

個

cloud_srv

AWS/SNS

Promitorのメトリック定義ファイル（metrics_promitor.conf）

形式

JP1/IM - Agentの「Node exporterのメトリック定義ファイル」と同じです。

ファイル

metrics_promitor.conf

metrics_promitor.conf.model（モデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Managerパス¥conf¥imdd¥plugin¥jp1pccs_azure¥

論理ホストのとき

共有フォルダ¥jp1imm¥conf¥imdd¥plugin¥jp1pccs_azure¥

Linuxの場合

物理ホストのとき

/etc/opt/jp1imm/conf/imdd/plugin/jp1pccs_azure/

論理ホストのとき

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

説明

［統合オペレーション・ビューアー］画面の［トレンド］タブで表示するPromitorのメトリック情報を定義するファイルです。

定義内容は，JP1/IM - Agentの製品プラグインの__metricListGetメソッド，および__timeSeriesDataGetメソッドの返却値に使用します。

PromitorのIM管理ノードは，Promitorのメトリック定義ファイルに定義されているメトリックのリソースだけに作成します。JP1/IM - Managerが階層構成で，統合マネージャーから下位マネージャーのトレンドデータ管理DBに保存されているトレンドデータを参照する場合，統合マネージャーのメトリック定義ファイルに参照するトレンドデータのメトリックを追加する必要があります。

文字コード

UTF-8（BOM無し）

改行コード

Windowsの場合：CR+LF

Linuxの場合：LF

定義の反映時期

［統合オペレーション・ビューアー］画面の［トレンド］タブ，または，REST APIで，メトリックの情報を取得したときに反映されます。

PromitorのIM管理ノードについては，jddcreatetreeコマンドおよびjddupdatetreeコマンドを実行したときに反映されます。

記述内容

JP1/IM - Agentの「Node exporterのメトリック定義ファイル」と同じです。

モデルファイルの設定内容（初期状態）

Promitorのメトリック定義ファイルのモデルファイルに記述されている各メトリックの設定内容（初期状態）を，次に示します。

azure_virtual_machine_disk_read_bytes_total

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

azure_virtual_machine_disk_read_bytes_total

default

false

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

azure_virtual_machine_disk_read_bytes_total and $jp1im_TrendData_labels

resource_en

category

azure_virtual_machine

label

Disk read bytes

description

Bytes read from disk during monitoring period. For details, see the description of the Disk Read Bytes metric for Microsoft.Compute/virtualMachines.

unit

byte

resource_ja

category

azure_virtual_machine

label

ディスク読み取りバイト

description

監視期間中にディスクから読み取られたバイト数。詳細はMicrosoft.Compute/virtualMachinesのDisk Read Bytesメトリックの説明を参照してください。

unit

byte

cloud_srv

Azure/VirtualMachine

azure_virtual_machine_disk_write_bytes_total

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

azure_virtual_machine_disk_write_bytes_total

default

false

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

azure_virtual_machine_disk_write_bytes_total and $jp1im_TrendData_labels

resource_en

category

azure_virtual_machine

label

Disk write bytes

description

Bytes written to disk during monitoring period. For details, see the description of the Disk Write Bytes metric for Microsoft.Compute/virtualMachines.

unit

byte

resource_ja

category

azure_virtual_machine

label

ディスク書き込みバイト

description

監視期間中にディスクに書き込まれたバイト数。詳細はMicrosoft.Compute/virtualMachinesのDisk Write Bytesメトリックの説明を参照してください。

unit

byte

cloud_srv

Azure/VirtualMachine

azure_virtual_machine_percentage_cpu_average

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

azure_virtual_machine_percentage_cpu_average

default

false

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

azure_virtual_machine_percentage_cpu_average and $jp1im_TrendData_labels

resource_en

category

azure_virtual_machine

label

Percentage of allocated compute units

description

The percentage of allocated compute units that are currently in use by the Virtual Machine(s). For details, see the description of the Percentage CPU metric for Microsoft.Compute/virtualMachines.

unit

%

resource_ja

category

azure_virtual_machine

label

割り当てコンピューティングユニットの割合

description

仮想マシンで現在使用されている，割り当てられたコンピューティングユニットの割合。詳細はMicrosoft.Compute/virtualMachinesのPercentage CPUメトリックの説明を参照してください。

unit

%

cloud_srv

Azure/VirtualMachine

azure_blob_storage_availability_average

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

azure_blob_storage_availability_average

default

false

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

azure_blob_storage_availability_average and $jp1im_TrendData_labels

resource_en

category

azure_blob_storage

label

Percentage of availability

description

The percentage of availability for the storage service or the specified API operation. For details, see the description of the Availability metric for Microsoft.Storage/storageAccounts/blobServices.

unit

%

resource_ja

category

azure_blob_storage

label

可用性の割合

description

ストレージサービスまたは指定されたAPI操作の可用性の割合。詳細はMicrosoft.Storage/storageAccounts/blobServicesのAvailabilityメトリックの説明を参照してください。

unit

%

cloud_srv

Azure/BlobStorage

azure_blob_storage_blob_capacity_average

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

azure_blob_storage_blob_capacity_average

default

false

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

azure_blob_storage_blob_capacity_average and $jp1im_TrendData_labels

resource_en

category

azure_blob_storage

label

Amount of storage

description

The amount of storage used by the storage account's Blob service in bytes. For details, see the description of the BlobCapacity metric for Microsoft.Storage/storageAccounts/blobServices.

unit

byte

resource_ja

category

azure_blob_storage

label

ストレージ量

description

ストレージアカウントのBlob serviceによって使われているストレージの量（バイト単位）。詳細はMicrosoft.Storage/storageAccounts/blobServicesのBlobCapacityメトリックの説明を参照してください。

unit

byte

cloud_srv

Azure/BlobStorage

azure_function_app_http5xx_total

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

azure_function_app_http5xx_total

default

false

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

azure_function_app_http5xx_total and $jp1im_TrendData_labels

resource_en

category

azure_function_app

label

Number of 5xx server errors

description

The count of requests resulting in an HTTP status code >= 500 but < 600. For details, see the description of the Http5xx metric for Microsoft.Web/sites.

unit

count

resource_ja

category

azure_function_app

label

5xxサーバエラー数

description

500以上600未満のHTTPステータスコードが返されたリクエストの数。詳細はMicrosoft.Web/sitesのHttp5xxメトリックの説明を参照してください。

unit

個

cloud_srv

Azure/FunctionApp

azure_function_app_http_response_time_average

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

azure_function_app_http_response_time_average

default

false

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

azure_function_app_http_response_time_average and $jp1im_TrendData_labels

resource_en

category

azure_function_app

label

Response time

description

The time taken for the app to serve requests, in seconds. For details, see the description of the HttpResponseTime metric for Microsoft.Web/sites.

unit

sec

resource_ja

category

azure_function_app

label

応答時間

description

アプリがリクエストを処理するのにかかった時間（秒単位）。詳細はMicrosoft.Web/sitesのHttpResponseTimeメトリックの説明を参照してください。

unit

秒

cloud_srv

Azure/FunctionApp

azure_cosmos_db_total_request_units_total

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

azure_cosmos_db_total_request_units_total

default

false

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

azure_cosmos_db_total_request_units_total and $jp1im_TrendData_labels

resource_en

category

azure_cosmos_db

label

Request Units consumed

description

Request Units consumed. For details, see the description of the TotalRequestUnits metric for Microsoft.DocumentDB/DatabaseAccounts.

unit

count

resource_ja

category

azure_cosmos_db

label

消費された要求ユニット

description

消費された要求ユニット。詳細はMicrosoft.DocumentDB/DatabaseAccountsのTotalRequestUnitsメトリックの説明を参照してください。

unit

個

cloud_srv

Azure/CosmosDb

azure_logic_app_runs_failed_total

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

azure_logic_app_runs_failed_total

default

false

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

azure_logic_app_runs_failed_total and $jp1im_TrendData_labels

resource_en

category

azure_logic_app

label

Number of workflow runs failed

description

Number of workflow runs failed. For details, see the description of the RunsFailed metric for Microsoft.Logic/Workflows.

unit

count

resource_ja

category

azure_logic_app

label

ワークフロー実行失敗数

description

失敗したワークフロー実行の数。詳細はMicrosoft.Logic/WorkflowsのRunsFailedメトリックの説明を参照してください。

unit

個

cloud_srv

Azure/LogicApp

azure_container_instance_cpu_usage_average

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

azure_container_instance_cpu_usage_average

default

false

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

azure_container_instance_cpu_usage_average and $jp1im_TrendData_labels

resource_en

category

azure_container_instance

label

CPU usage

description

CPU usage on all cores in millicores. For details, see the description of the CpuUsage metric for Microsoft.ContainerInstance/containerGroups.

unit

count

resource_ja

category

azure_container_instance

label

CPU使用率

description

すべてのコアのCPU使用率（ミリコア単位）。詳細はMicrosoft.ContainerInstance/containerGroupsのCpuUsageメトリックの説明を参照してください。

unit

個

cloud_srv

Azure/ContainerInstance

azure_container_instance_memory_usage_average

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

azure_container_instance_memory_usage_average

default

false

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

azure_container_instance_memory_usage_average and $jp1im_TrendData_labels

resource_en

category

azure_container_instance

label

Total memory usage

description

Total memory usage in byte. For details, see the description of the MemoryUsage metric for Microsoft.ContainerInstance/containerGroups.

unit

byte

resource_ja

category

azure_container_instance

label

合計メモリ使用量

description

合計メモリ使用量（バイト単位）。詳細はMicrosoft.ContainerInstance/containerGroupsのMemoryUsageメトリックの説明を参照してください。

unit

byte

cloud_srv

Azure/ContainerInstance

azure_kubernetes_service_kube_pod_status_phase_average_failed

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

azure_kubernetes_service_kube_pod_status_phase_average_failed

default

false

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

azure_kubernetes_service_kube_pod_status_phase_average_failed and $jp1im_TrendData_labels

resource_en

category

azure_kubernetes_service

label

Number of failed pods

description

Number of failed pods. For details, see the description of the kube_pod_status_phase metric for Microsoft.ContainerService/managedClusters.

unit

count

resource_ja

category

azure_kubernetes_service

label

Failedポッド数

description

Failedフェーズのポッド数。詳細はMicrosoft.ContainerService/managedClustersのkube_pod_status_phaseメトリックの説明を参照してください。

unit

個

cloud_srv

Azure/KubernetesService

azure_kubernetes_service_kube_pod_status_phase_average_pending

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

azure_kubernetes_service_kube_pod_status_phase_average_pending

default

false

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

azure_kubernetes_service_kube_pod_status_phase_average_pending and $jp1im_TrendData_labels

resource_en

category

azure_kubernetes_service

label

Number of pending pods

description

Number of pending pods. For details, see the description of the kube_pod_status_phase metric for Microsoft.ContainerService/managedClusters.

unit

count

resource_ja

category

azure_kubernetes_service

label

Pendingポッド数

description

Pendingフェーズのポッド数。詳細はMicrosoft.ContainerService/managedClustersのkube_pod_status_phaseメトリックの説明を参照してください。

unit

個

cloud_srv

Azure/KubernetesService

azure_kubernetes_service_kube_pod_status_phase_average_unknown

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

azure_kubernetes_service_kube_pod_status_phase_average_unknown

default

false

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

azure_kubernetes_service_kube_pod_status_phase_average_unknown and $jp1im_TrendData_labels

resource_en

category

azure_kubernetes_service

label

Number of unknown pods

description

Number of unknown pods. For details, see the description of the kube_pod_status_phase metric for Microsoft.ContainerService/managedClusters.

unit

count

resource_ja

category

azure_kubernetes_service

label

Unknownポッド数

description

Unknownフェーズのポッド数。詳細はMicrosoft.ContainerService/managedClustersのkube_pod_status_phaseメトリックの説明を参照してください。

unit

個

cloud_srv

Azure/KubernetesService

azure_file_storage_availability_average

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

azure_file_storage_availability_average

default

false

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

azure_file_storage_availability_average and $jp1im_TrendData_labels

resource_en

category

azure_file_storage

label

Percentage of availability

description

The percentage of availability for the storage service or the specified API operation. For details, see the description of the Availability metric for Microsoft.Storage/storageAccounts/fileServices.

unit

%

resource_ja

category

azure_file_storage

label

可用性の割合

description

ストレージサービスまたは指定されたAPI操作の可用性の割合。詳細はMicrosoft.Storage/storageAccounts/fileServicesのAvailabilityメトリックの説明を参照してください。

unit

%

cloud_srv

Azure/FileStorage

azure_file_storage_file_capacity_average

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

azure_file_storage_file_capacity_average

default

false

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

azure_file_storage_file_capacity_average and $jp1im_TrendData_labels

resource_en

category

azure_file_storage

label

Amount of file storage

description

The amount of File storage used by the storage account. For details, see the description of the FileCapacity metric for Microsoft.Storage/storageAccounts/fileServices.

unit

byte

resource_ja

category

azure_file_storage

label

ファイルストレージ量

description

ストレージアカウントによって使用されているファイルストレージの量。詳細はMicrosoft.Storage/storageAccounts/fileServicesのFileCapacityメトリックの説明を参照してください。

unit

byte

cloud_srv

Azure/FileStorage

azure_service_bus_namespace_deadlettered_messages_average

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

azure_service_bus_namespace_deadlettered_messages_average

default

false

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

azure_service_bus_namespace_deadlettered_messages_average and $jp1im_TrendData_labels

resource_en

category

azure_service_bus_namespace

label

Number of dead-lettered messages

description

Count of dead-lettered messages in a Queue/Topic. For details, see the description of the DeadletteredMessages metric for Microsoft.ServiceBus/Namespaces.

unit

count

resource_ja

category

azure_service_bus_namespace

label

配信不能メッセージ数

description

キュー／トピック内の配信不能メッセージの数。詳細はMicrosoft.ServiceBus/NamespacesのDeadletteredMessagesメトリックの説明を参照してください。

unit

個

cloud_srv

Azure/ServiceBusNamespace

azure_sql_database_cpu_percent_average

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

azure_sql_database_cpu_percent_average

default

false

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

azure_sql_database_cpu_percent_average and $jp1im_TrendData_labels

resource_en

category

azure_sql_database

label

CPU percentage

description

CPU percentage. For details, see the description of the cpu_percent metric for Microsoft.Sql/servers/databases.

unit

%

resource_ja

category

azure_sql_database

label

CPU割合

description

CPUの割合。詳細はMicrosoft.Sql/servers/databasesのcpu_percentメトリックの説明を参照してください。

unit

%

cloud_srv

Azure/SqlDatabase

azure_sql_database_dtu_used_average

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

azure_sql_database_dtu_used_average

default

false

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

azure_sql_database_dtu_used_average and $jp1im_TrendData_labels

resource_en

category

azure_sql_database

label

DTU used

description

DTU used. For details, see the description of the dtu_used metric for Microsoft.Sql/servers/databases.

unit

count

resource_ja

category

azure_sql_database

label

使用済みDTU

description

使用されたDTU。詳細はMicrosoft.Sql/servers/databasesのdtu_usedメトリックの説明を参照してください。

unit

個

cloud_srv

Azure/SqlDatabase

azure_sql_database_storage_maximum

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

azure_sql_database_storage_maximum

default

false

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

azure_sql_database_storage_maximum and $jp1im_TrendData_labels

resource_en

category

azure_sql_database

label

Data space used

description

Data space used. For details, see the description of the storage metric for Microsoft.Sql/servers/databases.

unit

byte

resource_ja

category

azure_sql_database

label

使用済みデータ領域

description

使用済みのデータ領域。詳細はMicrosoft.Sql/servers/databasesのstorageメトリックの説明を参照してください。

unit

byte

cloud_srv

Azure/SqlDatabase

azure_sql_elastic_pool_cpu_percent_average

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

azure_sql_elastic_pool_cpu_percent_average

default

false

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

azure_sql_elastic_pool_cpu_percent_average and $jp1im_TrendData_labels

resource_en

category

azure_sql_elastic_pool

label

CPU percentage

description

CPU percentage. For details, see the description of the cpu_percent metric for Microsoft.Sql/servers/elasticpools.

unit

%

resource_ja

category

azure_sql_elastic_pool

label

CPU割合

description

CPUの割合。詳細はMicrosoft.Sql/servers/elasticpoolsのcpu_percentメトリックの説明を参照してください。

unit

%

cloud_srv

Azure/SqlElasticPool

azure_sql_elastic_pool_e_dtu_used_average

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

azure_sql_elastic_pool_e_dtu_used_average

default

false

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

azure_sql_elastic_pool_e_dtu_used_average and $jp1im_TrendData_labels

resource_en

category

azure_sql_elastic_pool

label

eDTU used

description

eDTU used. For details, see the description of the eDTU_used metric for Microsoft.Sql/servers/elasticpools.

unit

count

resource_ja

category

azure_sql_elastic_pool

label

使用済みeDTU

description

使用済みeDTU。詳細はMicrosoft.Sql/servers/elasticpoolsのeDTU_usedメトリックの説明を参照してください。

unit

個

cloud_srv

Azure/SqlElasticPool

azure_sql_elastic_pool_storage_used_average

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

azure_sql_elastic_pool_storage_used_average

default

false

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

azure_sql_elastic_pool_storage_used_average and $jp1im_TrendData_labels

resource_en

category

azure_sql_elastic_pool

label

Data space used

description

Data space used. For details, see the description of the storage_used metric for Microsoft.Sql/servers/elasticpools.

unit

byte

resource_ja

category

azure_sql_elastic_pool

label

使用済みデータ領域

description

使用済みのデータ領域。詳細はMicrosoft.Sql/servers/elasticpoolsのstorage_usedメトリックの説明を参照してください。

unit

byte

cloud_srv

Azure/SqlElasticPool

azure_sql_managed_instance_avg_cpu_percent_average

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

azure_sql_managed_instance_avg_cpu_percent_average

default

false

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

azure_sql_managed_instance_avg_cpu_percent_average and $jp1im_TrendData_labels

resource_en

category

azure_sql_managed_instance

label

Average CPU percentage

description

Average CPU percentage. For details, see the description of the avg_cpu_percent metric for Microsoft.Sql/managedInstances.

unit

%

resource_ja

category

azure_sql_managed_instance

label

平均CPU割合

description

平均CPUの割合。詳細はMicrosoft.Sql/managedInstancesのavg_cpu_percentメトリックの説明を参照してください。

unit

%

cloud_srv

Azure/SqlManagedInstance

azure_sql_managed_instance_io_bytes_read_average

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

azure_sql_managed_instance_io_bytes_read_average

default

false

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

azure_sql_managed_instance_io_bytes_read_average and $jp1im_TrendData_labels

resource_en

category

azure_sql_managed_instance

label

IO bytes read

description

IO bytes read. For details, see the description of the io_bytes_read metric for Microsoft.Sql/managedInstances.

unit

byte

resource_ja

category

azure_sql_managed_instance

label

読み取りIOバイト

description

読み取りIOバイト。詳細はMicrosoft.Sql/managedInstancesのio_bytes_readメトリックの説明を参照してください。

unit

byte

cloud_srv

Azure/SqlManagedInstance

azure_sql_managed_instance_io_bytes_written_average

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

azure_sql_managed_instance_io_bytes_written_average

default

false

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

azure_sql_managed_instance_io_bytes_written_average and $jp1im_TrendData_labels

resource_en

category

azure_sql_managed_instance

label

IO bytes written

description

IO bytes written. For details, see the description of the io_bytes_written metric for Microsoft.Sql/managedInstances.

unit

byte

resource_ja

category

azure_sql_managed_instance

label

書き込みIOバイト

description

書き込みIOバイト。詳細はMicrosoft.Sql/managedInstancesのio_bytes_writtenメトリックの説明を参照してください。

unit

byte

cloud_srv

Azure/SqlManagedInstance

azure_sql_managed_instance_storage_space_used_mb_average

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

azure_sql_managed_instance_storage_space_used_mb_average

default

false

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

azure_sql_managed_instance_storage_space_used_mb_average and $jp1im_TrendData_labels

resource_en

category

azure_sql_managed_instance

label

Storage space used

description

Storage space used. For details, see the description of the storage_space_used_mb metric for Microsoft.Sql/managedInstances.

unit

count

resource_ja

category

azure_sql_managed_instance

label

使用済みストレージスペース

description

使用済みストレージスペース。詳細はMicrosoft.Sql/managedInstancesのstorage_space_used_mbメトリックの説明を参照してください。

unit

個

cloud_srv

Azure/SqlManagedInstance

Script exporterのメトリック定義ファイル（metrics_script_exporter.conf）

形式

JP1/IM - Agentの「Node exporterのメトリック定義ファイル」と同じです。

ファイル

metrics_script_exporter.conf

metrics_script_exporter.conf.model（モデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Managerパス¥conf¥imdd¥plugin¥jp1pccs¥

論理ホストのとき

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

Linuxの場合

物理ホストのとき

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

論理ホストのとき

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

説明

［統合オペレーション・ビューアー］画面の［トレンド］タブで表示するScript exporterのメトリック情報を定義するファイルです。

定義内容は，JP1/IM - Agentの製品プラグインの__metricListGetメソッド，および__timeSeriesDataGetメソッドの返却値に使用します。JP1/IM - Managerが階層構成で，統合マネージャーから下位マネージャーのトレンドデータ管理DBに保存されているトレンドデータを参照する場合，統合マネージャーのメトリック定義ファイルに参照するトレンドデータのメトリックを追加する必要があります。

文字コード

UTF-8（BOM無し）

改行コード

Windowsの場合：CR+LF

Linuxの場合：LF

定義の反映時期

［統合オペレーション・ビューアー］画面の［トレンド］タブ，または，REST APIで，メトリックの情報を取得したときに反映されます。

Script exporterのIM管理ノードについては，jddcreatetreeコマンドおよびjddupdatetreeコマンドを実行したときに反映されます。

記述内容

JP1/IM - Agentの「Node exporterのメトリック定義ファイル（metrics_node_exporter.conf）」（2.　定義ファイル）の「記述内容」を参照してください。

モデルファイルの設定内容（初期状態）

Script exporterのメトリック定義ファイルのモデルファイルに記述されている各メトリックの設定内容（初期状態）を，次に示します。

azure_virtual_machine_disk_read_bytes_total

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

script_success

default

true

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

script_success and $jp1im_TrendData_labels

resource_en

category

script

label

Script success

description

Script exit status (0 = error, 1 = success)

unit

-

resource_ja

category

script

label

スクリプト成否

description

スクリプトの実行成否（失敗:0, 成功:1）

unit

-

script_duration_seconds

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

script_duration_seconds

default

true

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

script_duration_seconds and $jp1im_TrendData_labels

resource_en

category

script

label

Duration

description

Script execution time, in seconds

unit

seconds

resource_ja

category

script

label

実行時間

description

スクリプトの実行時間（秒）

unit

秒

script_exit_code

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

script_exit_code

default

true

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

script_exit_code and $jp1im_TrendData_labels

resource_en

category

script

label

Exit code

description

Script execution time, in seconds

unit

-

resource_ja

category

script

label

終了コード

description

スクリプトの終了コード

unit

-

Fluentdのメトリック定義ファイル（metrics_fluentd.conf）

形式

「Node exporterのメトリック定義ファイル（metrics_node_exporter.conf）」の「形式」を参照してください。

ファイル

metrics_fluentd.conf

metrics_fluentd.conf.model（モデルファイル）

格納先ディレクトリ

■統合マネージャーホスト

Windowsの場合

物理ホストのとき

Managerパス¥conf¥imdd¥plugin¥jp1pccs¥

論理ホストのとき

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

Linuxの場合

物理ホストのとき

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

論理ホストのとき

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

説明

［統合オペレーション・ビューアー］画面の［トレンド］タブで表示するFluentdのメトリック情報を定義するファイルです。

定義内容は，JP1/IM - Agentの製品プラグインの__metricListGetメソッド，および__timeSeriesDataGetメソッドの返却値に使用します。

JP1/IM - Managerが階層構成で，統合マネージャーから，下位マネージャーのトレンドデータ管理DBに保存されているトレンドデータを参照する場合，統合マネージャーのメトリック定義ファイルに，参照するトレンドデータのメトリックを追加する必要があります。

文字コード

UTF-8（BOM無し）

改行コード

Windowsの場合：CR+LF

Linuxの場合：LF

定義の反映時期

［統合オペレーション・ビューアー］画面の［トレンド］タブ，または，REST APIで，メトリックの情報を取得したときに反映されます。

記述内容

「Node exporterのメトリック定義ファイル（metrics_node_exporter.conf）」の「記述内容」を参照してください。

モデルファイルの設定内容（初期状態）

Fluentdのメトリック定義ファイルのモデルファイルに記述されているメトリックの設定内容（初期状態）を，次に示します。

fluentd_logtrap_running

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

fluentd_logtrap_running

default

true

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

fluentd_logtrap_running and $jp1im_TrendData_labels

resource_en

category

fluentd_logtrap

label

Log monitoring status

description

The value is always 1 and indicates that the log is being monitored. If the sample is not displayed, no log monitoring has been performed for that time.

1: monitoring is being done

unit

-

resource_ja

category

fluentd_logtrap

label

ログ監視状況

description

値は常に1で，ログの監視が行われていることを表します。サンプルが表示されない場合，その時間のログ監視は行われていません。

1：監視が行われている

unit

-

OracleDB exporterのメトリック定義ファイル（metrics_oracledb_exporter.conf）

形式

「Node exporterのメトリック定義ファイル（metrics_node_exporter.conf）」の「形式」を参照してください。

ファイル

metrics_oracledb_exporter.conf

metrics_oracledb_exporter.conf.model（モデルファイル）

格納先ディレクトリ

■統合マネージャーホスト

Windowsの場合

物理ホストのとき

Managerパス¥conf¥imdd¥plugin¥jp1pccs¥

論理ホストのとき

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

Linuxの場合

物理ホストのとき

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

論理ホストのとき

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

説明

［統合オペレーション・ビューアー］画面の［トレンド］タブで表示するOracleDB exporterのメトリック情報を定義するファイルです。

定義内容は，JP1/IM - Agentの製品プラグインの__metricListGetメソッド，および__timeSeriesDataGetメソッドの返却値に使用します。

JP1/IM - Managerが階層構成で，統合マネージャーから，下位マネージャーのトレンドデータ管理DBに保存されているトレンドデータを参照する場合，統合マネージャーのメトリック定義ファイルに，参照するトレンドデータのメトリックを追加する必要があります。

文字コード

UTF-8（BOM無し）

改行コード

Windowsの場合：CR+LF

Linuxの場合：LF

定義の反映時期

［統合オペレーション・ビューアー］画面の［トレンド］タブ，または，REST APIで，メトリックの情報を取得したときに反映されます。

記述内容

「Node exporterのメトリック定義ファイル（metrics_node_exporter.conf）」の「記述内容」を参照してください。

モデルファイルの設定内容（初期状態）

OracleDB exporterのメトリック定義ファイルのモデルファイルに記述されている各メトリックの設定内容（初期状態）を，次に示します。

oracledb_up

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

oracledb_up

default

true

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

oracledb_up and $jp1im_TrendData_labels

resource_en

category

database_oracle

label

OracleDB Startup Status

description

Shows the startup status of OracleDB. 1 indicates that it is running, while 0 indicates that it is stopped.

unit

-

resource_ja

category

database_oracle

label

OracleDBの起動状態

description

OracleDBの起動状態を示す。1は起動中，0は停止中を示す。

unit

-

cache_hit_ratio_percent

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

cache_hit_ratio_percent

default

true

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

(1 - (rate(oracledb_activity_physical_reads_cache[2m]) / (rate(oracledb_activity_consistent_gets_from_cache[2m])+rate(oracledb_activity_db_block_gets_from_cache[2m]))))*100 and $jp1im_TrendData_labels

resource_en

category

database_oracle

label

Cache Hit Ratio

description

Shows the cache hit ratio.

unit

%

resource_ja

category

database_oracle

label

キャッシュヒット率

description

キャッシュヒット率を示す。

unit

%

tablespace_used_percent

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

tablespace_used_percent

default

true

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

oracledb_tablespace_used_percent and $jp1im_TrendData_labels

resource_en

category

database_oracle

label

Tablespace Usage

description

Shows the usage of each tablespace. If automatic extension is ON, it is calculated based on the size considering automatic extension.

unit

%

resource_ja

category

database_oracle

label

表領域の使用率

description

表領域ごとの使用率を示す。自動拡張がONの場合，自動拡張を考慮したサイズで計算される。

unit

%

execute_count

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

execute_count

default

true

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

rate(oracledb_activity_execute_count[2m])*60 and $jp1im_TrendData_labels

resource_en

category

database_oracle

label

SQL Statement Execution Count

description

Shows the number of calls to execute SQL statements (user calls and recursive calls).

unit

-

resource_ja

category

database_oracle

label

SQL文の実行回数

description

SQL文を実行するコール数(ユーザー・コールおよび再帰コール)を示す。

unit

回

parse_count

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

parse_count

default

true

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

rate(oracledb_activity_parse_count_total[2m])*60 and $jp1im_TrendData_labels

resource_en

category

database_oracle

label

Parsing Call Execution Count

description

Shows the execution count of parsing calls (hard, soft, and describe).

unit

-

resource_ja

category

database_oracle

label

解析コールの実行回数

description

解析コール(ハード、ソフトおよびdescribe)の実行回数を示す。

unit

回

user_commit_count

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

user_commit_count

default

true

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

rate(oracledb_activity_user_commits[2m])*60 and $jp1im_TrendData_labels

resource_en

category

database_oracle

label

Commit Execution Count

description

Shows the number of user commits.

unit

-

resource_ja

category

database_oracle

label

コミットの実行回数

description

ユーザー・コミットの回数を示す。

unit

回

user_rollback_count

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

user_rollback_count

default

true

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

rate(oracledb_activity_user_rollbacks[2m])*60 and $jp1im_TrendData_labels

resource_en

category

database_oracle

label

Rollback Execution Count

description

Shows the number of times users issued a ROLLBACK statement manually or the number of errors occurred in user transactions.

unit

-

resource_ja

category

database_oracle

label

ロールバックの実行回数

description

ユーザーがROLLBACK文を手動で発行した，または，ユーザーのトランザクション中にエラーが発生した回数を示す。

unit

回

resource_used

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

resource_used

default

false

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

oracledb_resource_current_utilization and $jp1im_TrendData_labels

resource_en

category

database_oracle

label

Resource Usage

description

Shows the resource usage.

unit

-

resource_ja

category

database_oracle

label

リソース使用量

description

リソースの使用量を示す。

unit

-

session_count

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

session_count

default

false

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

oracledb_sessions_value and $jp1im_TrendData_labels

resource_en

category

database_oracle

label

Number of Sessions

description

Shows the number of sessions based on status and type.

unit

-

resource_ja

category

database_oracle

label

セッション数

description

ステータスとタイプ別のセッション数を示す。

unit

個

OracleDB exporterのデフォルトの収集メトリック定義ファイル（default-metrics.toml）

形式

TOML形式のファイルです。

このファイルの形式については，GitHubのサイトを参照してください。

ファイル

default_metrics.toml

default_metrics.toml.model（モデルファイル）

格納先ディレクトリ

■統合エージェントホスト（モデルファイルだけ）

Windowsの場合

物理ホストのとき

Windows版のOracleDB exporterのアーカイブファイル※の展開先¥oracledb_exporter_windows¥conf¥

注※

Agentパス¥options¥oracledb_exporter_windows_VVRRSS.zip

Linuxの場合

物理ホストのとき

Linux版のOracleDB exporterのアーカイブファイル※の展開先/oracledb_exporter_linux/conf/

注※

/opt/jp1ima/options/oracledb_exporter_linux_VVRRSS.tar.gz

説明

OracleDB exporterが取得するメトリックを定義するファイルです。

このファイルは編集できません。

文字コード

UTF-8（BOM無し）

改行コード

Windowsの場合：CR+LF

Linuxの場合：LF

定義の反映時期

OracleDB exporterを起動または再起動したときに反映されます。

記述内容

このファイルの形式については，GitHubのサイトを参照してください。

コンテナ監視のメトリック定義ファイル（metrics_kubernetes.conf）

形式

[
  {
    "name":"トレンドデータのメトリック名",
    "default":デフォルト選択状態,
    "promql":"PromQL文",
    "resource_en":{
      "category":"メトリックのカテゴリ（英語）",
      "label":"メトリック表示名（英語）",
      "description":"メトリックの説明（英語）",
      "unit":"メトリックの単位（英語）"
    },
    "resource_ja":{
      "category":"メトリックのカテゴリ（日本語）",
      "label":"メトリック表示名（日本語）",
      "description":"メトリックの説明（日本語）",
      "unit":"メトリックの単位（日本語）"
    },
    "module": "コンポーネント名”
  }, ・・・
]※

注※

[]内に記述できる要素の数は1〜1,000個です。範囲外の個数の要素を記述した場合は，KAJY24609-Eのエラーメッセージが出力されます。

ファイル

metrics_kubernetes.conf

metrics_ kubernetes.conf.model（モデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Managerパス¥conf¥imdd¥plugin¥jp1pccs_kubernetes¥

論理ホストのとき

共有フォルダ¥jp1imm¥conf¥imdd¥plugin¥jp1pccs_kubernetes¥

Linuxの場合

物理ホストのとき

/etc/opt/jp1imm/conf/imdd/plugin/jp1pccs_kubernetes/

論理ホストのとき

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

説明

［統合オペレーション・ビューアー］画面の［トレンド］タブで表示するコンテナ監視のメトリック情報を定義するファイルです。

定義内容は，JP1/IM - Agentの製品プラグインの__metricListGetメソッド，および__timeSeriesDataGetメソッドの返却値に使用します。JP1/IM - Managerが階層構成で，統合マネージャーから下位マネージャーのトレンドデータ管理DBに保存されているトレンドデータを参照する場合，統合マネージャーのメトリック定義ファイルに参照するトレンドデータのメトリックを追加する必要があります。

文字コード

UTF-8（BOM無し）

改行コード

Windowsの場合：CR+LF

Linuxの場合：LF

定義の反映時期

［統合オペレーション・ビューアー］画面の［トレンド］タブ，または，REST APIで，メトリックの情報を取得したときに反映されます。

記述内容

JP1/IM - Agentの「Node exporterのメトリック定義ファイル（metrics_node_exporter.conf）」（2.　定義ファイル）の「記述内容」を参照してください。ただし，moduleメンバーを必須とし，コンポーネント種別を記載します。ここで指定した値が，オブジェクトルートノード種別として使用されます。

モデルファイルの設定内容（初期状態）

コンテナ監視のメトリック定義ファイルのモデルファイルに記述されている各メトリックの設定内容（初期状態）を，次に示します。

kube_job_status_failed

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

kube_job_status_failed

default

true

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

kube_job_status_failed * on(job_name, namespace) group_left() kube_job_owner{owner_kind=¥"<none>¥", owner_name=¥"<none>¥"} and $jp1im_TrendData_labels

resource_en

category

kubernete_job

label

Number of Failed pods

description

The number of pods which reached Phase Failed and the reason for failure. This number does not include pods run from a CronJob.

unit

count

resource_ja

category

kubernete_job

label

失敗したポッド数

description

実行に失敗したポッドの数。CronJobから実行されたものは含まれない。

unit

個

module

kubernetes/Namespace

kube_pod_status_pending

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

kube_pod_status_pending

default

true

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

sum by (pod, namespace, instance, job, jp1_pc_nodelabel, jp1_pc_prome_hostname) (kube_pod_status_phase{phase=¥"Pending¥"} and $jp1im_TrendData_labels)

resource_en

category

kubernetes_pod

label

Number of Pending pods

description

The number of pods whose Phase is Pending.

unit

count

resource_ja

category

kubernetes_pod

label

Pendingポッド数

description

PhaseがPendingのポッドの数。

unit

個

module

kubernetes/Namespace

kube_pod_status_failed

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

kube_pod_status_failed

default

true

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

sum by (pod, namespace, instance, job, jp1_pc_nodelabel, jp1_pc_prome_hostname) (kube_pod_status_phase{phase=¥"Failed¥"} and $jp1im_TrendData_labels)

resource_en

category

kubernetes_pod

label

Number of Failed pods

description

The number of pods whose Phase is Failed.

unit

count

resource_ja

category

kubernetes_pod

label

Failedポッド数

description

PhaseがFailedのポッドの数。

unit

個

module

kubernetes/Namespace

kube_pod_status_unknown

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

kube_pod_status_unknown

default

true

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

sum by (pod, namespace, instance, job, jp1_pc_nodelabel, jp1_pc_prome_hostname) (kube_pod_status_phase{phase=¥"Unknown¥"} and $jp1im_TrendData_labels)

resource_en

category

kubernetes_pod

label

Number of Unknown pods

description

The number of pods whose Phase is Unknown.

unit

count

resource_ja

category

kubernetes_pod

label

Unknownポッド数

description

PhaseがUnknownのポッドの数。

unit

個

module

kubernetes/Namespace

kube_daemonset_failed_number_scheduled

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

kube_daemonset_failed_number_scheduled

default

true

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

(kube_daemonset_status_desired_number_scheduled - kube_daemonset_status_current_number_scheduled) and $jp1im_TrendData_labels

resource_en

category

kubernetes_daemon_set

label

Number of nodes failed to run

description

The difference between the number of nodes that need to run daemon pods (desired) and the number of nodes that are already running (current).

unit

count

resource_ja

category

kubernetes_daemon_set

label

実行に失敗したノード数

description

デーモン ポッドを実行する必要があるノード(desired)の数と，既に実行されているノード(current)の数の差。

unit

個

module

kubernetes/DaemonSet

kube_deployment_failed_replicas

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

kube_deployment_failed_replicas

default

true

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

(kube_deployment_spec_replicas - kube_deployment_status_replicas_available) and $jp1im_TrendData_labels

resource_en

category

kubernetes_deployment

label

Number of pods failed to run

description

The difference between the number of required pods and the number of available replicas.

unit

count

resource_ja

category

kubernetes_deployment

label

実行に失敗したポッド数

description

必要なポッドの数と使用可能なレプリカの数との差。

unit

個

module

kubernetes/Deployment

kube_replicaset_failed_replicas

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

kube_replicaset_failed_replicas

default

true

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

(kube_replicaset_spec_replicas - kube_replicaset_status_ready_replicas) and $jp1im_TrendData_labels

resource_en

category

kubernetes_replica_set

label

Number of pods failed to run

description

The difference between the number of required pods and the number of ready replicas.

unit

count

resource_ja

category

kubernetes_replica_set

label

実行に失敗したポッド数

description

必要なポッドの数と準備完了なレプリカの数との差。

unit

個

module

kubernetes/ReplicaSet

kube_statefulset_failed_replicas

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

kube_statefulset_failed_replicas

default

true

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

(kube_statefulset_replicas - kube_statefulset_status_replicas_ready) and $jp1im_TrendData_labels

resource_en

category

kubernetes_stateful_set

label

Number of pods failed to run

description

The difference between the number of required pods and the number of ready replicas.

unit

count

resource_ja

category

kubernetes_stateful_set

label

実行に失敗したポッド数

description

必要なポッドの数と準備完了なレプリカの数との差。

unit

個

module

kubernetes/StaetfulSet

kube_cron_job_status_failed

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

kube_cron_job_status_failed

default

true

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

kube_job_status_failed * on(job_name, namespace) group_left(jp1_pc_nodelabel) (kube_job_owner{owner_kind=¥"CronJob¥", owner_name!=¥"<none>¥"} and $jp1im_TrendData_labels)

resource_en

category

kubernetes_cron_job

label

Number of pods failed to run

description

The number of pods that failed to run within a CronJob.

unit

count

resource_ja

category

kubernetes_cron_job

label

失敗したポッド数

description

CronJob内で実行に失敗したポッドの数。

unit

個

module

kubernetes/CronJob

kube_node_status_condition_not_ready

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

kube_node_status_condition_not_ready

default

true

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

sum by (node, instance, job, jp1_pc_nodelabel, jp1_pc_prome_hostname) (kube_node_status_condition{condition=¥"Ready¥",status=~¥"false|unknown¥"} and $jp1im_TrendData_labels)

resource_en

category

kubernetes_node

label

Status

description

Whether the node is in an error state. (1: Not Ready or Unknown, 0: Ready)

unit

count

resource_ja

category

kubernetes_node

label

ノード異常状態

description

ノードが異常状態かどうか。（1：Not ReadyもしくはUnknown，0：Ready）

unit

個

module

kubernetes/Node

kube_node_status_condition_memory_pressure

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

kube_node_status_condition_memory_pressure

default

true

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

sum by (node, instance, job, jp1_pc_nodelabel, jp1_pc_prome_hostname) (kube_node_status_condition{condition=¥"MemoryPressure¥",status=~¥"true|unknown¥"} and $jp1im_TrendData_labels)

resource_en

category

kubernetes_node

label

Memory pressure

description

Whether memory is under pressure. (1: Under Pressure or Unknown, 0: Normal)

unit

count

resource_ja

category

kubernetes_node

label

メモリ圧迫状態

description

メモリが圧迫常状態かどうか。（1：圧迫状態もしくはUnknown，0：正常）

unit

個

module

kubernetes/Node

kube_node_status_condition_disk_pressure

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

kube_node_status_condition_disk_pressure

default

true

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

sum by (node, instance, job, jp1_pc_nodelabel, jp1_pc_prome_hostname) (kube_node_status_condition{condition=¥"DiskPressure¥",status=~¥"true|unknown¥"} and $jp1im_TrendData_labels)

resource_en

category

kubernetes_node

label

Disk pressure

description

Whether disk is under pressure. (1: Under Pressure or Unknown, 0: Normal)

unit

count

resource_ja

category

kubernetes_node

label

ディスク圧迫状態

description

ディスクが圧迫常状態かどうか。（1：圧迫状態もしくはUnknown，0：正常）

unit

個

module

kubernetes/Node

kube_node_status_condition_pid_pressure

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

kube_node_status_condition_pid_pressure

default

true

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

sum by (node, instance, job, jp1_pc_nodelabel, jp1_pc_prome_hostname) (kube_node_status_condition{condition=¥"PIDPressure¥",status=~¥"true|unknown¥"} and $jp1im_TrendData_labels)

resource_en

category

kubernetes_node

label

PID pressure

description

Whether PID is under pressure. (1: Under Pressure or Unknown, 0: Normal)

unit

count

resource_ja

category

kubernetes_node

label

PID割り当て圧迫状態

description

PID割り当てが圧迫常状態かどうか。（1：圧迫状態もしくはUnknown，0：正常）

unit

個

module

kubernetes/Node

kube_pod_cpu_percent_used

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

kube_pod_cpu_percent_used

default

true

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

sum by (pod, namespace, instance, job, jp1_pc_nodelabel, jp1_pc_prome_hostname) (rate(container_cpu_usage_seconds_total{name!=""}[2m]) and $jp1im_TrendData_labels) * 100

resource_en

category

kubernetes_pod

label

CPU usage

description

CPU usage per pod.

unit

%

resource_ja

category

kubernetes_pod

label

CPU使用率

description

ポッド毎のCPU使用率。

unit

%

module

kubernetes/Namespace

kube_pod_fs_reads_bps

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

kube_pod_fs_reads_bps

default

true

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

sum by (pod, namespace, instance, job, jp1_pc_nodelabel, jp1_pc_prome_hostname) (rate(container_fs_reads_bytes_total{name!=""}[2m]) and $jp1im_TrendData_labels)

resource_en

category

kubernetes_pod

label

Disk read bytes

description

Disk read bytes per pod.

unit

Bps

resource_ja

category

kubernetes_pod

label

ディスク読み込み速度

description

ポッド毎のディスク読み込み速度。

unit

Bps

module

kubernetes/Namespace

kube_pod_fs_writes_bps

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

kube_pod_fs_writes_bps

default

true

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

sum by (pod, namespace, instance, job, jp1_pc_nodelabel, jp1_pc_prome_hostname) (rate(container_fs_writes_bytes_total{name!=""}[2m]) and $jp1im_TrendData_labels)

resource_en

category

kubernetes_pod

label

Disk write bytes

description

Disk write bytes per pod.

unit

Bps

resource_ja

category

kubernetes_pod

label

ディスク書き込み速度

description

ポッド毎のディスク書き込み速度。

unit

Bps

module

kubernetes/Namespace

kube_pod_memory_percent_used

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

kube_pod_memory_percent_used

default

true

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

sum by (pod, namespace, instance, job, jp1_pc_nodelabel, jp1_pc_prome_hostname) (container_memory_working_set_bytes and (container_spec_memory_limit_bytes{name!=""} > 0) and $jp1im_TrendData_labels) / sum by (pod, namespace, instance, job, jp1_pc_nodelabel, jp1_pc_prome_hostname) ((container_spec_memory_limit_bytes{name!=""} > 0) and container_memory_working_set_bytes and $jp1im_TrendData_labels) * 100

resource_en

category

kubernetes_pod

label

Memory usage

description

Memory usage per pod.

unit

%

resource_ja

category

kubernetes_pod

label

メモリ使用率

description

ポッド毎のメモリ使用率。

unit

%

module

kubernetes/Namespace

kube_namespace_cpu_percent_used

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

kube_namespace_cpu_percent_used

default

true

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

sum by (namespace, job, jp1_pc_nodelabel, jp1_pc_prome_hostname) (rate(container_cpu_usage_seconds_total{name!=""}[2m]) and $jp1im_TrendData_labels) * 100

resource_en

category

kubernetes_pod

label

CPU usage

description

CPU usage per namespace.

unit

%

resource_ja

category

kubernetes_pod

label

CPU使用率

description

Namespace毎のCPU使用率。

unit

%

module

kubernetes/Cluster

kube_namespace_fs_reads_bps

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

kube_namespace_fs_reads_bps

default

true

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

sum by (namespace, job, jp1_pc_nodelabel, jp1_pc_prome_hostname) (rate(container_fs_reads_bytes_total{name!=""}[2m]) and $jp1im_TrendData_labels)

resource_en

category

kubernetes_pod

label

Disk read bytes

description

Disk read bytes per namespace.

unit

Bps

resource_ja

category

kubernetes_pod

label

ディスク読み込み速度

description

Namespace毎のディスク読み込み速度。

unit

Bps

module

kubernetes/Cluster

kube_namespace_fs_writes_bps

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

kube_namespace_fs_writes_bps

default

true

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

sum by (namespace, job, jp1_pc_nodelabel, jp1_pc_prome_hostname) (rate(container_fs_writes_bytes_total{name!=""}[2m]) and $jp1im_TrendData_labels)

resource_en

category

kubernetes_pod

label

Disk write bytes

description

Disk write bytes per namespace.

unit

Bps

resource_ja

category

kubernetes_pod

label

ディスク書き込み速度

description

Namespace毎のディスク書き込み速度。

unit

Bps

module

kubernetes/Cluster

kube_namespace_memory_percent_used

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

kube_namespace_memory_percent_used

default

true

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

sum by (namespace, job, jp1_pc_nodelabel, jp1_pc_prome_hostname) (container_memory_working_set_bytes and (container_spec_memory_limit_bytes{name!=""} > 0) and $jp1im_TrendData_labels) / sum by (namespace, job, jp1_pc_nodelabel, jp1_pc_prome_hostname) ((container_spec_memory_limit_bytes{name!=""} > 0) and container_memory_working_set_bytes and $jp1im_TrendData_labels) * 100

resource_en

category

kubernetes_pod

label

Memory usage

description

Memory usage per namespace.

unit

%

resource_ja

category

kubernetes_pod

label

メモリ使用率

description

Namespace毎のメモリ使用率。

unit

%

module

kubernetes/Cluster

kube_pod_status_phase

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

kube_pod_status_phase

default

true

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

kube_pod_status_phase and $jp1im_TrendData_labels

resource_en

category

kubernetes_pod

label

Phase

description

The pods current phase

unit

-

resource_ja

category

kubernetes_pod

label

フェーズ

description

現在のPodのPhase。

unit

-

module

kubernetes/Pod

kube_pod_cpu_percent_used_pod

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

kube_pod_cpu_percent_used_pod

default

true

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

sum by (namespace, instance, job, jp1_pc_nodelabel, jp1_pc_prome_hostname) (rate(container_cpu_usage_seconds_total{name!=""}[2m]) and $jp1im_TrendData_labels) * 100

resource_en

category

kubernetes_pod

label

CPU usage

description

CPU usage per pod.

unit

%

resource_ja

category

kubernetes_pod

label

CPU使用率

description

ポッド毎のCPU使用率。

unit

%

module

kubernetes/Pod

kube_pod_fs_reads_bps_pod

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

kube_pod_fs_reads_bps_pod

default

true

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

sum by (namespace, instance, job, jp1_pc_nodelabel, jp1_pc_prome_hostname) (rate(container_fs_reads_bytes_total{name!=""}[2m]) and $jp1im_TrendData_labels)

resource_en

category

kubernetes_pod

label

Disk read bytes

description

Disk read bytes per pod.

unit

Bps

resource_ja

category

kubernetes_pod

label

ディスク読み込み速度

description

ポッド毎のディスク読み込み速度。

unit

Bps

module

kubernetes/Pod

kube_pod_fs_writes_bps_pod

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

kube_pod_fs_writes_bps_pod

default

true

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

sum by (namespace, instance, job, jp1_pc_nodelabel, jp1_pc_prome_hostname) (rate(container_fs_writes_bytes_total{name!=""}[2m]) and $jp1im_TrendData_labels)

resource_en

category

kubernetes_pod

label

Disk write bytes

description

Disk write bytes per pod.

unit

Bps

resource_ja

category

kubernetes_pod

label

ディスク書き込み速度

description

ポッド毎のディスク書き込み速度。

unit

Bps

module

kubernetes/Pod

kube_pod_memory_percent_used

■設定内容（初期状態）

メンバー名

設定内容（初期状態）

name

kube_pod_memory_percent_used_pod

default

true

メトリック定義ファイル用promql（$jp1im_TrendData_labelsを含む）

sum by (namespace, instance, job, jp1_pc_nodelabel, jp1_pc_prome_hostname) (container_memory_working_set_bytes and (container_spec_memory_limit_bytes{name!=""} > 0) and $jp1im_TrendData_labels) / sum by (pod, namespace, instance, job, jp1_pc_nodelabel, jp1_pc_prome_hostname) ((container_spec_memory_limit_bytes{name!=""} > 0) and container_memory_working_set_bytes and $jp1im_TrendData_labels) * 100

resource_en

category

kubernetes_pod

label

Memory usage

description

Memory usage per pod.

unit

%

resource_ja

category

kubernetes_pod

label

メモリ使用率

description

ポッド毎のメモリ使用率。

unit

%

module

kubernetes/Pod

任意のPrometheusトレンド名のメトリック定義ファイル（metrics_任意のPrometheusトレンド名.conf）

形式

「Node exporterのメトリック定義ファイル（metrics_node_exporter.conf）」の「形式」を参照してください。

ファイル

metrics_任意のPrometheusトレンド名.conf

任意のPrometheusトレンド名は，ディスカバリ設定ファイルまたはPrometheus設定ファイルのjp1_pc_trendnameに設定した値としてください。

格納先ディレクトリ

■統合マネージャーホスト

Windowsの場合

物理ホストのとき

Managerパス¥conf¥imdd¥plugin¥jp1pccs¥

論理ホストのとき

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

Linuxの場合

物理ホストのとき

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

論理ホストのとき

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

説明

［統合オペレーション・ビューアー］画面の［トレンド］タブで表示するメトリック情報を定義するファイルです。

定義内容は，JP1/IM - Agentの製品プラグインの__metricListGetメソッド，および__timeSeriesDataGetメソッドの返却値に使用します。

JP1/IM - Managerが階層構成で，統合マネージャーから，下位マネージャーのトレンドデータ管理DBに保存されているトレンドデータを参照する場合，統合マネージャーのメトリック定義ファイルに，参照するトレンドデータのメトリックを追加する必要があります。

文字コード

UTF-8（BOM無し）

改行コード

Windowsの場合：CR+LF

Linuxの場合：LF

定義の反映時期

［統合オペレーション・ビューアー］画面の［トレンド］タブ，または，REST APIで，メトリックの情報を取得したときに反映されます。

記述内容

「Node exporterのメトリック定義ファイル（metrics_node_exporter.conf）」の「記述内容」を参照してください。

ユーザー独自のメトリック定義ファイル（metrics_任意のPrometheusトレンド名.conf）

形式

「Node exporterのメトリック定義ファイル（metrics_node_exporter.conf）」の「形式」を参照してください。

ファイル

metrics_任意のPrometheusトレンド名.conf

任意のPrometheusトレンド名は，ユーザー独自のディスカバリ設定ファイルのjp1_pc_trendnameに設定した値としてください。

格納先ディレクトリ

■統合マネージャーホスト

Windowsの場合

物理ホストのとき

Managerパス¥conf¥imdd¥plugin¥jp1pccs¥user¥

論理ホストのとき

共有フォルダ¥jp1imm¥conf¥imdd¥plugin¥jp1pccs¥user¥

Linuxの場合

物理ホストのとき

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

論理ホストのとき

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

説明

［統合オペレーション・ビューアー］画面の［トレンド］タブで表示するユーザー独自のメトリック情報を定義するファイルです。

定義内容は，JP1/IM - Agentの製品プラグインの__metricListGetメソッド，および__timeSeriesDataGetメソッドの返却値に使用します。

JP1/IM - Managerが階層構成で，統合マネージャーから，下位マネージャーのトレンドデータ管理DBに保存されているトレンドデータを参照する場合，統合マネージャーのメトリック定義ファイルに，参照するトレンドデータのメトリックを追加する必要があります。

文字コード

UTF-8（BOM無し）

改行コード

Windowsの場合：CR+LF

Linuxの場合：LF

定義の反映時期

JP1/IM - Agentの製品プラグインの__metricListGetメソッドおよび__timeSeriesDataGetメソッドを実行したときに反映されます。

記述内容

「Node exporterのメトリック定義ファイル（metrics_node_exporter.conf）」の「記述内容」を参照してください。

ユーザー独自のメトリック定義ファイル（Promitor）（metrics_任意のPrometheusトレンド名.conf）

形式

「Node exporterのメトリック定義ファイル（metrics_node_exporter.conf）」の「形式」を参照してください。

ファイル

metrics_任意のPrometheusトレンド名.conf

任意のPrometheusトレンド名は，ユーザー独自のディスカバリ設定ファイルのjp1_pc_trendnameに設定した値としてください。

格納先ディレクトリ

■統合マネージャーホスト

Windowsの場合

物理ホストのとき

Managerパス¥conf¥imdd¥plugin¥jp1pccs_azure¥user¥

論理ホストのとき

共有フォルダ¥jp1imm¥conf¥imdd¥plugin¥jp1pccs_azure¥user¥

Linuxの場合

物理ホストのとき

/etc/opt/jp1imm/conf/imdd/plugin/jp1pccs_azure/user/

論理ホストのとき

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

説明

［統合オペレーション・ビューアー］画面の［トレンド］タブで表示するユーザー独自のメトリック情報を定義するファイルです。

定義内容は，JP1/IM - Agentの製品プラグインの__metricListGetメソッド，および__timeSeriesDataGetメソッドの返却値に使用します。

JP1/IM - Managerが階層構成で，統合マネージャーから，下位マネージャーのトレンドデータ管理DBに保存されているトレンドデータを参照する場合，統合マネージャーのメトリック定義ファイルに，参照するトレンドデータのメトリックを追加する必要があります。

文字コード

UTF-8（BOM無し）

改行コード

Windowsの場合：CR+LF

Linuxの場合：LF

定義の反映時期

JP1/IM - Agentの製品プラグインの__metricListGetメソッドおよび__timeSeriesDataGetメソッドを実行したときに反映されます。

記述内容

「Node exporterのメトリック定義ファイル（metrics_node_exporter.conf）」の「記述内容」を参照してください。

ユーザー独自のメトリック定義ファイル（コンテナ監視）（metrics_任意のPrometheusトレンド名.conf）

形式

「コンテナ監視のメトリック定義ファイル（metrics_kubernetes.conf）」の「形式」を参照してください。

ファイル

metrics_任意のPrometheusトレンド名.conf

任意のPrometheusトレンド名は，ユーザー独自のディスカバリ設定ファイルのjp1_pc_trendnameに設定した値としてください。

格納先ディレクトリ

■統合マネージャーホスト

Windowsの場合

物理ホストのとき

Managerパス¥conf¥imdd¥plugin¥jp1pccs_kubernetes¥user¥

論理ホストのとき

共有フォルダ¥jp1imm¥conf¥imdd¥plugin¥jp1pccs_kubernetes¥user¥

Linuxの場合

物理ホストのとき

/etc/opt/jp1imm/conf/imdd/plugin/jp1pccs_kubernetes/user/

論理ホストのとき

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

説明

［統合オペレーション・ビューアー］画面の［トレンド］タブで表示するユーザー独自のメトリック情報を定義するファイルです。

定義内容は，JP1/IM - Agentの製品プラグインの__metricListGetメソッド，および__timeSeriesDataGetメソッドの返却値に使用します。

JP1/IM - Managerが階層構成で，統合マネージャーから，下位マネージャーのトレンドデータ管理DBに保存されているトレンドデータを参照する場合，統合マネージャーのメトリック定義ファイルに，参照するトレンドデータのメトリックを追加する必要があります。

文字コード

UTF-8（BOM無し）

改行コード

Windowsの場合：CR+LF

Linuxの場合：LF

定義の反映時期

JP1/IM - Agentの製品プラグインの__metricListGetメソッドおよび__timeSeriesDataGetメソッドを実行したときに反映されます。

記述内容

「コンテナ監視のメトリック定義ファイル（metrics_kubernetes.conf）」の「記述内容」を参照してください。

AWS定義ファイル（aws_settings.conf）

形式

{
  "yace_account_mapping": {
    "AWSアカウントID":"AWSアカウント文字列",
    ・・・
  }
}

ファイル

aws_settings.conf

aws_settings.conf.model（モデルファイル）

格納先ディレクトリ

■統合マネージャーホスト

Windowsの場合

物理ホストのとき

Managerパス¥conf¥imdd¥plugin¥jp1pccs¥

論理ホストのとき

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

Linuxの場合

物理ホストのとき

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

論理ホストのとき

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

説明

AWSやYet another cloudwatch exporterに関する設定ファイルです。

監視モジュール（Cloud）のYet another cloudwatch exporterを使用して監視を行う場合に設定します。

yace_account_mappingには，Yet another cloudwatch exporterで使用するAWSのアカウントIDと，IM管理ノードのプロパティやJP1イベントの拡張属性値に設定するアカウント文字列のマッピングを指定します。Yet another cloudwatch exporterで指定されたアカウントIDに対応する定義が存在しない場合，Yet another cloudwatch exporterのIM管理ノードのプロパティとJP1イベントの拡張属性値のアカウントには，「default」が設定されます。

JP1/IM - Managerが階層構成で，下位マネージャーがYet another cloudwatch exporterを管理する場合，下位マネージャーが管理するYet another cloudwatch exporterのAWSのアカウントIDと，IM管理ノードのプロパティやJP1イベント拡張属性値に設定するアカウント文字列のマッピングを統合マネージャーのAWS定義ファイルに指定する必要があります。

文字コード

UTF-8（BOM無し）

改行コード

Windowsの場合：CR+LF

Linuxの場合：LF

定義の反映時期

jddcreatetreeコマンドおよびjddupdatetreeコマンドを実行したとき，統合オペレーション・ビューアーのツリーの表示内容に反映されます。または，Yet another cloudwatch exporterのパフォーマンスデータを監視するアラートによって，JP1イベントが発行されたときに反映されます。

記述内容

AWSアカウントID

Yet another cloudwatch exporterからCloudWatchに接続するための設定で使用するAWSのアカウントIDを，1〜255文字の制御文字以外の文字で指定します。

CloudWatchに接続するための設定については，マニュアル「JP1/Integrated Management 3 - Manager 構築ガイド」の「2.19.2(8)(b) CloudWatchに接続するための設定を変更する（Linuxの場合）（オプション）」を参照してください。

AWSアカウント文字列

Yet another cloudwatch exporterのSIDとIM管理ノードのプロパティのアカウントに設定するアカウント文字列を，1〜255文字の制御文字以外の文字で指定します。

Alertmanager設定ファイル（jpc_alertmanager.yml）

形式

YAML形式で記述します。

　：
（略）
　：
receivers:
- name: 'JP1IMDD'

  webhook_configs:
  - send_resolved: true
    url: 'http://JP1/IM - Agentのホスト名:20726/ima/api/v1/proxy/service/imdd/im/api_system/v1/events/transform'

ファイル

jpc_alertmanager.yml

jpc_alertmanager.yml.model（モデルファイル）

格納先ディレクトリ

■統合エージェントホスト

Windowsの場合

物理ホストのとき

Agentパス¥conf¥

論理ホストのとき

共有フォルダ¥jp1ima¥conf¥

Linuxの場合

物理ホストのとき

/opt/jp1ima/conf/

論理ホストのとき

共有ディレクトリ/jp1ima/conf/

説明

Alertmanagerの動作を規定する設定ファイルです。

文字コード

UTF-8（BOM無し）

改行コード

Windowsの場合：CR+LF

Linuxの場合：LF

定義の反映時期

Alertmanagerを再起動したとき，および，Alertmanagerにリロードを指示したときに反映されます。

記述内容

下記の表で使用している一般的なプレースホルダーの定義については，「ymlファイルの記述項目で使用している一般的なプレースホルダーの定義について」を参照してください。

項目名

説明

変更可否

JP1/IM - Agentでユーザーが設定する内容

JP1/IM - Agentのデフォルト値

global:

−

△

−

−

route: <route>

アラートのルーティングを設定します。

下記の<route>の説明を参照してください。

○

詳細については，下記の<route>を参照してください。

−

receivers:

アラートの通知先を設定します。

△

−

−

- <receiver> ...

下記の<receiver>の説明を参照してください。

○

詳細については，下記の<receiver>を参照してください。

JP1/IM - Manager（インテリジェント統合管理基盤）に送信するための定義を記載します。

（凡例）

〇：変更可　△：変更不可　−：該当なし

<route>

JP1/IMの統合オペレーション・ビューアーへの送信用に1つだけ設定します。

項目名

説明

変更可否

JP1/IM - Agentでユーザーが設定する内容

JP1/IM - Agentのデフォルト値

[ receiver: <string> ]

receiversに設定したアラート通知先の定義にあるnameの値を指定します。

△

−

receiver: 'JP1IMDD'

[ group_by: '[' <labelname>, ... ']' ]

Prometheus serverから通知される複数のアラートをラベルごとにグルーピングして通知する場合に指定します。['...']を指定するとグルーピングを無効にできます。

△

−

group_by: ['...']

[ continue: <boolean> | default = false ]

アラートのルーティングを継続するかどうかを指定します。

△

−

continue: false

[ group_wait: <duration> | default = 30s ]

アラートをグルーピングするための待ち時間を指定します。

待ち時間の間に到着したアラートをグルーピングします。

△

−

group_wait: 5s

[ group_interval: <duration> | default = 5m ]

通知したアラートのグループに新しいアラートが追加されたときに再通知するまでの間隔を指定します。

△

−

group_interval: 5s

[ repeat_interval: <duration> | default = 4h ]

アラートを通知後に再通知するまでの間隔を指定します。

コマンドラインオプション--data.retentionに指定した期間より大きい値を指定した場合，repeat_intervalに指定した期間より早く再通知されることがあります。

△

−

repeat_interval: 7d

（凡例）

△：変更不可　−：該当なし

<receiver>

項目名

説明

変更可否

JP1/IM - Agentでユーザーが設定する内容

JP1/IM - Agentのデフォルト値

name: <string>

アラート通知先の設定の名前を指定します。

△

−

- name: 'JP1IMDD'

webhook_configs:

−

△

−

−

[ send_resolved: <boolean> | default = true ]

回復アラートを通知するかどうかを指定します。

＜設定例＞receivers.webhook_configs.urlを参照してください。

〇

回復の通知を行わない場合はfalseを指定します。

- send_resolved: true

url: <string>

アラート通知先のエンドポイントを指定します。

＜設定例＞

receivers:

- name: 'JP1IMDD'

webhook_configs:

- send_resolved: true

url: 'http://localhost: 20726/ima/api/v1/proxy/service/imdd/im/api/v1/events/transform'

◎

同一ホスト上のimagentのエンドポイントを指定します。運用環境に合わせてホスト名とポート番号を変更します。

url: 'http://統合エージェントホスト名:20726/ima/api/v1/proxy/service/imdd/im/api/v1/events/transform'

（凡例）

◎：設定必須　〇：変更可　△：変更不可　−：該当なし

Prometheus設定ファイル（jpc_prometheus_server.yml）

形式

YAML形式で記述します。

global:
  scrape_interval:      1m
  scrape_timeout:      10s
  evaluation_interval:  1m
  external_labels:
    jp1_pc_prome_hostname: "監視エージェントのホスト名"
　：
（略）
　：
scrape_configs※:
  - job_name: スクレイプジョブ名

    file_sd_configs:
      - files:
        - ディスカバリ設定ファイル名

    relabel_configs:
      - target_label: jp1_pc_nodelabel
        replacement: Node exporter
      - regex: (jp1_pc_category|jp1_pc_trendname)
        action: labeldrop
　：
（略）
　：
remote_write:
  - url: http://JP1/IM - Agentのホスト名:20727/ima/api/v1/proxy/service/promscale/api/v1/write
    remote_timeout: 30s
    send_exemplars: false
    queue_config:
      capacity: 10000
      max_shards: 200
      min_shards: 4
      max_samples_per_send: 3000
      batch_send_deadline: 10s
      min_backoff: 100ms
      max_backoff: 10s

注※

Script exporterのディスカバリをHTTPベースの「http_sd_config方式」で指定する場合，このファイルのscrape_configsのhttp_sd_configs.urlに直接エンドポイントを指定します。

scrape_configsのhttp_sd_configs.urlに指定するScript exporterのHTTPベースのサービスディスカバリエンドポイントを次に示します。

http://インストールホスト名:Script exporterのポート番号/discovery

file_sd_configsと異なり，http_sd_configsではラベルを独自に追加できないため，relabel_configsでラベルを追加する必要があります。必要なラベルについては，マニュアル「JP1/Integrated Management 3 - Manager 構築ガイド」の「1.21.2(10)(b)Script exporterのスクレイプ定義」を参照してください。

ファイル

jpc_prometheus_server.yml

jpc_prometheus_server.yml.model（モデルファイル）

格納先ディレクトリ

■統合エージェントホスト

Windowsの場合

物理ホストのとき

Agentパス¥conf¥

論理ホストのとき

共有フォルダ¥jp1ima¥conf¥

Linuxの場合

物理ホストのとき

/opt/jp1ima/conf/

論理ホストのとき

共有ディレクトリ/jp1ima/conf/

説明

Prometheus serverの動作を規定する設定ファイルです。

文字コード

UTF-8（BOM無し）

改行コード

Windowsの場合：CR+LF

Linuxの場合：LF

定義の反映時期

Prometheus serverのリロードAPIを実行したとき，または，Prometheus serverを再起動したときに，Prometheus serverの動作に反映されます。

また，jp1_pc_prome_hostnameラベルの値，または，スクレイプ定義（scrape_configsの定義）を変更した場合は，上記の操作を行ったあと，jddcreatetreeコマンドおよびjddupdatetreeコマンドを実行したときに，統合オペレーション・ビューアーのツリーの表示内容に反映されます。

記述内容

下記の表で使用している一般的なプレースホルダーの定義については，「ymlファイルの記述項目で使用している一般的なプレースホルダーの定義について」を参照してください。

項目名

説明

変更可否

JP1/IM - Agentでユーザーが設定する内容

JP1/IM - Agentのデフォルト値

global:

−

△

−

−

[ scrape_interval: <duration> | default = 1m ]

ターゲットへのスクレイプ間隔を15秒から24時間の範囲で指定します。

値は数字と単位で指定します。指定できる単位はs（秒）とm（分）とh（時）です。

＜設定例＞

global:

scrape_interval: 5m

○

スクレイプ間隔を指定します。※

scrape_interval:1m

[ scrape_timeout: <duration> | default = 10s ]

スクレイプ要求のタイムアウト時間を10秒から60分の範囲で指定します。

値は数字と単位で指定します。指定できる単位はs（秒）とm（分）です。

global.scrape_intervalよりも小さい値を指定する必要があります。

＜設定例＞

global:

scrape_timeout: 20s

○

必要に応じて設定します。

scrape_timeout: 10s

[ evaluation_interval: <duration> | default = 1m ]

アラートルールの評価間隔を15秒から48時間の範囲で指定します。

値は数字と単位で指定します。指定できる単位はs（秒）とm（分）とh（時間）です。

＜設定例＞

global:

evaluation_interval: 15s

○

必要に応じて設定します。

evaluation_interval: 1m

external_labels:

リモートライトやAlertmanagerへ通知する際に追加するラベルを指定します。30個まで指定できます。

△

−

−

[ <labelname>: <labelvalue> ... ]

ラベル名とラベルの値を指定します。ラベル名とラベルの値はそれぞれ255バイトまで指定できます。

なお，デフォルトで設定済みのjp1_pc_prome_hostnameラベルは削除しないでください。

＜設定例＞

global:

external_labels:

labelname1: valuename1

labelname2: valuename2

○

監視モジュールのインストールスクリプトで設定されるため，通常は変更不要です。

クラスタ環境の場合は手動で論理ホスト名を設定します。

external_labels:

jp1_pc_prome_hostname: "ホスト名"

rule_files:

アラートルールファイルを指定します。30個まで指定できます。

△

−

−

[ - <filepath_glob> ... ]

ファイル名を指定します。ファイル名は255バイトまで指定できます。

＜設定例＞

rule_files:

- " jpc_alerting_rules.yml"

- "alerting_rules2.yml"

○

ルールファイル名の変更，追加，削除ができます。

通常は変更不要です。

rule_files:

- "jpc_alerting_rules.yml"

scrape_configs:

スクレイプ定義を指定します。30個まで指定できます。

△

−

−

[ - <scrape_config> ... ]

下記の<scrape_config>の説明を参照してください。

○

スクレイプ定義を追加できます。

ユーザー独自のExporterなどがある場合は定義を追加します。

通常は変更不要です。

次に示すExporterの定義があらかじめ設定されています。

node_exporter

windows_exporter

blackbox_exporter(http)

blackbox_exporter(icmp)

yet_another_cloudwatch_exporter

alerting:

Alertmanagerに関する設定を行います。

△

−

−

alert_relabel_configs:

アラート通知の際のリラベリングを設定します。

△

−

−

[ - <relabel_config> ... ]

下記の<relabel_config>の説明を参照してください。

○

アラートのラベルを追加，変更したい場合に指定します。

−

alertmanagers:

アラート通知先のAlertmanagerを設定します。

△

−

−

[ - <alertmanager_config> ... ]

下記の<alertmanager_config>の説明を参照してください。

○

アラート通知先として同居するAlertmanagerを指定します。

−

remote_write:

リモートライトに関する設定を行います。

△

−

−

url: <string>

リモートライトの送信先エンドポイントを指定します。

＜設定例＞

remote_write:

- url: http://統合エージェントホスト名:20727/ima/api/v1/proxy/service/promscale/write

◎

同一ホスト上のimagentのリモートライトエンドポイントを指定します。

利用環境に合わせてホスト名とポート番号を変更します。

url: http://localhost:20727/ima/api/v1/proxy/service/promscale/write

[ remote_timeout: <duration> | default = 30s ]

リモートライトのタイムアウト時間を30秒から60分の範囲で指定します。

値は数字と単位で指定します。指定できる単位はs（秒）とm（分）です。

＜設定例＞

remote_write:

- url: http://localhost:20727/ima/api/v1/proxy/service/promscale/write

remote_timeout: 1m

○

リモートライトがタイムアウトしてしまう場合は値を大きくしてください。

remote_timeout: 30s

write_relabel_configs:

リモートライト時のリラベリングを設定します。

△

−

−

[ - <relabel_config> ... ]

下記の<relabel_config>の説明を参照してください。

＜設定例＞

node_exporterコマンドで取得するnode_boot_time_secondsとnode_context_switches_totalをリモートライトしたくない場合の設定例を，次に示します。

remote_write:

- url: http://localhost:20727/ima/api/v1/proxy/service/promscale/write

write_relabel_configs:

- source_labels: ['__name__']

regex: '(node_boot_time_seconds|node_context_switches_total)'

action: 'drop'

○

特定のメトリックをリモートライトしたくない場合に指定します。

−

[ send_exemplars: <boolean> | default = false ]

Exemplarsをリモートライトする場合に指定します。

△

−

send_exemplars: false

queue_config:

リモートライト用のキューを設定します。

△

−

−

[ capacity: <int> | default = 2500 ]

バッファリングするサンプル数を指定します。

△

−

capacity: 10000

[ min_shards: <int> | default = 1 ]

リモートライトの並列実行数の下限を指定します。

△

−

min_shards: 4

[ max_samples_per_send: <int> | default = 500]

一度にまとめて送信するサンプルの最大数を指定します。

△

−

max_samples_per_send: 3000

[ batch_send_deadline: <duration> | default = 5s ]

キューに残ったサンプルをフラッシュするまでの待ち時間を指定します。

△

−

batch_send_deadline: 10s

[ min_backoff: <duration> | default = 30ms ]

送信リトライの待ち時間の下限を指定します。

△

−

min_backoff: 100ms

[ max_backoff: <duration> | default = 100ms ]

送信リトライの待ち時間の上限を指定します。

△

−

max_backoff: 10s

（凡例）

◎：設定必須　〇：変更可　△：変更不可　−：該当なし

注※

この値を初期値（1m）から変更する場合，メトリック定義ファイルのPromQL文で指定している範囲ベクトルセレクターの値（大括弧{ }で指定する時刻範囲）を見直してください。範囲ベクトルセレクターには，スクレイプ間隔の2倍以上の値を指定してください。2倍未満の値を指定すると，トレンド情報が取得できなかったり，一部の時刻のトレンド情報が取得できなかったりします。

また，Yet another cloudwatch exporterを使用して監視を行うときは，10m以上の値を指定しないでください。指定した場合，jddcreatetreeコマンドを実行したときに構成を取得できないことがあります。

<scrape_config>

scrape_configセクションは，ターゲットとそれらをスクレイピングする方法を説明するパラメーターのセットを指定します。

一般的には，1つのスクレイプ構成で1つのジョブが指定されます。高度な構成では，これは変更される可能性があります。

ターゲットは，static_configsパラメーターを介して静的に構成することも，サポートされているサービス検出メカニズムの1つを使用して動的に検出することもできます。

さらに，relabel_configsを使用すると，スクレイピングする前に，ターゲットとそのラベルを高度に変更できます。

項目名

説明

変更可否

JP1/IM - Agentでユーザーが設定する内容

JP1/IM - Agentのデフォルト値

job_name: <job_name>

スクレイプ定義の名前を指定します。この値はパフォーマンスデータのjobラベルに設定されます。

ジョブ名は255バイト以内で指定します。

ユーザー独自のExporterの場合

「jpc」で始まらないジョブ名を指定します。ただし，JP1/IM - Agentが提供するExporterと同じExporterの場合は，下記の<job_name>を参照して指定します。

コンテナ監視の場合

マニュアル「JP1/Integrated Management 3 - Manager 構築ガイド」の「1.21.2(11)コンテナ監視の設定」を参照して指定します。

＜設定例＞

scrape_configs:

- job_name: 'my_exporter'

○

ユーザー独自のExporterを使用する場合に新しいスクレイプのジョブ名を定義します。

次に示すジョブが設定されています。

jpc_node

jpc_windows

jpc_blackbox_http

jpc_blackbox_icmp

jpc_cloudwatch

[ scrape_interval: <duration> | default = <global_config.scrape_interval> ]

ターゲットへのスクレイプ間隔を15秒から24時間の範囲で指定します。

global.scrape_intervalに指定したスクレイプ間隔と異なる間隔にしたい場合に指定します。

値は数字と単位で指定します。指定できる単位はs（秒）とm（分）とh（時間）です。

＜設定例＞

scrape_configs:

- job_name: 'my_exporter'

scrape_interval: 10m

○

globalとスクレイプ間隔を変更したい場合に指定します。

job_nameの値が「jpc_cloudwatch」の場合は，10m以上の値を指定しないでください。指定した場合，jddcreatetreeコマンドを実行したときに構成を取得できないことがあります。

−

[ scrape_timeout: <duration> | default = <global_config.scrape_timeout> ]

スクレイプ要求のタイムアウト時間を10秒から60分の範囲で指定します。

値は数字と単位で指定します。指定できる単位はs（秒）とm（分）です。

省略時は，scrape_config.scrape_intervalとglobal.scrape_timeoutのうちの小さい値と同じ値になります。

＜設定例＞

scrape_configs:

- job_name: 'my_exporter'

scrape_timeout: 30s

○

globalとスクレイプのタイムアウト時間を変更したい場合に指定します。

−

[ metrics_path: <path> | default = /metrics ]

スクレイプするときのHTTPリソースパスを255バイト以内で指定します。

指定しない場合は，スクレイプ時のURLに「/metrics」が付与されます。

＜設定例＞

scrape_configs:

- job_name: 'my_exporter'

metrics_path: /sample-metrics

○

ユーザー独自のExporterを使用する場合に指定します。

それぞれのジョブに合わせたパスを指定します。

[ scheme: <scheme> | default = http ]

リクエストに使用するプロトコルを指定します。

「http」または「https」を指定できます。

＜設定例＞

scrape_configs:

- job_name: 'my_exporter'

scheme: https

○

Exporterに合わせて，「http」または「https」を指定します。

−

params:

スクレイプ時のHTTP URLパラメーターを指定します。30個まで指定できます。

○

−

−

[ <string>: [<string>, ...] ]

キーと値を指定します。

キーと値はそれぞれ255バイトまで指定できます。

＜設定例＞

scrape_configs:

- job_name: 'my_exporter'

params:

aaa: [bbb, ccc]

xxx: [yyy]

○

Exporterに合わせて，スクレイプ時にExporterに渡すURLパラメーターを指定します。

−

file_sd_configs:

スクレイプ対象を設定するファイルを定義します。

△

−

−

-files:

スクレイプ対象を設定するファイルを指定します。

△

−

−

[ - <filename_pattern> ... ]

ファイル名を255バイト以内で指定します。

＜設定例＞

scrape_configs:

- job_name: 'my_exporter'

file_sd_configs:

- files:

- 'file_sd_config_my_exporter.yml'

○

ユーザー独自のExporterを使用する場合に指定します。

13-00からバージョンアップインストールした環境で，次の機能を使用する場合，ユーザーが手動で設定を変更する必要があります。

Node exporter for AIX

設定変更の詳細については，マニュアル「JP1/Integrated Management 3 - Manager構築ガイド」の「1.23.2(1)(c)JP1/IM - Agentのセットアップ」の「Node exporter for AIXのスクレイプジョブの設定」を参照してください。

それぞれのジョブに合わせて，次に示す定義をしておきます。

- 'jpc_file_sd_config_node.yml'

- 'jpc_file_sd_config_windows.yml'

- 'jpc_file_sd_config_blackbox_http.yml'

- 'jpc_file_sd_config_blackbox_icmp.yml'

- 'jpc_file_sd_config_cloudwatch.yml'

- 'jpc_file_sd_config_node_aix.yml'

[ refresh_interval: <duration> | default = 5m ]

スクレイプ対象を記載したファイルを再読み込みする間隔を5分から24時間の範囲で指定します。

値は数字と単位で指定します。指定できる単位はm（分）とh（時間）です。

＜設定例＞

scrape_configs:

- job_name: 'my_exporter'

file_sd_configs:

- files:

- 'file_sd_config_my_exporter.yml'

refresh_interval: 10m

○

ユーザー独自のExporterを使用する場合にファイルの再読み込みの間隔を変更したい場合に指定します。

通常は変更不要です。

−

relabel_configs:

スクレイプ前のターゲットに対するリラベリングを設定します。

△

−

−

[ - <relabel_config> ... ]

下記の<relabel_config>の説明を参照してください。

○

ユーザー独自のExporterを使用する場合に指定します。

13-00からバージョンアップインストールした環境で，次の機能を使用する場合，ユーザーが手動で設定を変更する必要があります。

Node exporter for AIX

設定変更の詳細については，マニュアル「JP1/Integrated Management 3 - Manager構築ガイド」の「1.23.2(1)(c)JP1/IM - Agentのセットアップ」の「Node exporter for AIXのスクレイプジョブの設定」を参照してください。

それぞれのジョブに合わせて，次に示す定義をしておきます。

jpc_nodeの場合

- target_label: jp1_pc_nodelabel

replacement: Linux metric collector(Node exporter)

jpc_windowsの場合

- target_label: jp1_pc_nodelabel

replacement: Windows metric collector(Windows exporter)

jpc_blackbox_httpの場合

- source_labels: [__address__]

target_label: __param_target

regex: ([^:]+):([^:]+):(.*)

replacement: ${3}

- source_labels: [__address__]

target_label: instance

- source_labels: [__address__]

target_label: jp1_pc_nodelabel

regex: ([^:]+):([^:]+):(.*)

replacement: ${2}

- target_label: __address__

replacement: 統合エージェントホスト名:20715

- source_labels: [__param_module]

target_label: jp1_pc_module

jpc_blackbox_icmpの場合

- source_labels: [__address__]

target_label: __param_target

- target_label: jp1_pc_nodelabel

replacement: Synthetic metric collector(Blackbox exporter(ICMP))

- source_labels: [__address__]

target_label: instance

- target_label: __address__

replacement: 統合エージェントホスト名:20715

- source_labels: [__param_module]

target_label: jp1_pc_module

jpc_cloudwatchの場合

記載は不要です。

jpc_node_aixの場合

- target_label: jp1_pc_nodelabel

replacement: AIX metric collector(Node exporter for AIX)

metric_relabel_configs:

スクレイプ後のメトリックに対するリラベリングを設定します。

設定例については，項目「remote_write:」の「write_relabel_configs:」の説明を参照してください。

△

−

−

[ - <relabel_config> ... ]

下記の<relabel_config>の説明を参照してください。

○

次の場合に指定します。

ユーザー独自のExporterを使用する場合

特定のメトリックを除去したい場合

プロセスの稼動率監視※2などでメトリックのラベルを設定する場合

JP1/IM - Agent 13-00から13-01以降にバージョンアップインストールした環境で，次の機能を使用する場合，ユーザーが手動で設定を変更する必要があります。

サービス監視機能

Node exporter for AIX

設定変更の詳細については，マニュアル「JP1/Integrated Management 3 - Manager 構築ガイド」の「1.21.2(3)(f)サービス監視の設定をする（Windowsの場合）（オプション）」および「2.19.2(3)(f)サービス監視の設定をする（Linuxの場合）（オプション）」，ならびに「1.23.2(1)(c)JP1/IM - Agentのセットアップ」の「Node exporter for AIXのスクレイプジョブの設定」を参照してください。

それぞれのジョブに合わせたExporterのリラベルを指定します。※

（凡例）

〇：変更可　△：変更不可　−：該当なし

注※

jpc_nodeの場合

- source_labels: ['__name__']

regex: 'node_network_receive_bytes_total|node_network_transmit_bytes_total|node_disk_read_time_seconds_total|node_disk_write_time_seconds_total|node_boot_time_seconds|node_context_switches_total|node_cpu_seconds_total|node_disk_io_now|node_disk_io_time_seconds_total|node_disk_read_bytes_total|node_disk_reads_completed_total|node_disk_writes_completed_total|node_disk_written_bytes_total|node_filesystem_avail_bytes|node_filesystem_files|node_filesystem_files_free|node_filesystem_free_bytes|node_filesystem_size_bytes|node_intr_total|node_load1|node_load15|node_load5|node_memory_Active_file_bytes|node_memory_Buffers_bytes|node_memory_Cached_bytes|node_memory_Inactive_file_bytes|node_memory_MemAvailable_bytes|node_memory_MemFree_bytes|node_memory_MemTotal_bytes|node_memory_SReclaimable_bytes|node_memory_SwapFree_bytes|node_memory_SwapTotal_bytes|node_netstat_Icmp6_InMsgs|node_netstat_Icmp_InMsgs|node_netstat_Icmp6_OutMsgs|node_netstat_Icmp_OutMsgs|node_netstat_Tcp_InSegs|node_netstat_Tcp_OutSegs|node_netstat_Udp_InDatagrams|node_netstat_Udp_OutDatagrams|node_network_flags|node_network_iface_link|node_network_mtu_bytes|node_network_receive_errs_total|node_network_receive_packets_total|node_network_transmit_colls_total|node_network_transmit_errs_total|node_network_transmit_packets_total|node_time_seconds|node_uname_info|node_vmstat_pswpin|node_vmstat_pswpout|node_systemd_unit_state'

action: 'keep'

- source_labels: ['__name__']

regex: 'node_systemd_unit_.*'

target_label: 'jp1_pc_trendname'

replacement: 'node_exporter_service'

- source_labels: ['__name__']

regex: 'node_systemd_unit_.*'

target_label: 'jp1_pc_category'

replacement: 'service'

- source_labels: ['__name__','name']

regex: 'node_systemd_unit_.*;(.*)'

target_label: 'jp1_pc_nodelabel'

replacement: ${1}

- regex: jp1_pc_multiple_node

action: labeldrop

jpc_windowsの場合

- source_labels: ['__name__']

regex: 'windows_cs_physical_memory_bytes|windows_cache_copy_read_hits_total|windows_cache_copy_reads_total|windows_cpu_time_total|windows_logical_disk_free_bytes|windows_logical_disk_idle_seconds_total|windows_logical_disk_read_bytes_total|windows_logical_disk_read_latency_seconds_total|windows_logical_disk_read_seconds_total|windows_logical_disk_reads_total|windows_logical_disk_requests_queued|windows_logical_disk_size_bytes|windows_logical_disk_write_bytes_total|windows_logical_disk_write_latency_seconds_total|windows_logical_disk_write_seconds_total|windows_logical_disk_writes_total|windows_memory_available_bytes|windows_memory_cache_bytes|windows_memory_cache_faults_total|windows_memory_page_faults_total|windows_memory_pool_nonpaged_allocs_total|windows_memory_pool_paged_allocs_total|windows_memory_swap_page_operations_total|windows_memory_swap_pages_read_total|windows_memory_swap_pages_written_total|windows_memory_system_cache_resident_bytes|windows_memory_transition_faults_total|windows_net_bytes_received_total|windows_net_bytes_sent_total|windows_net_bytes_total|windows_net_packets_sent_total|windows_net_packets_received_total|windows_system_context_switches_total|windows_system_processor_queue_length|windows_system_system_calls_total|windows_process_start_time|windows_process_cpu_time_total|windows_process_handles|windows_process_io_bytes_total|windows_process_io_operations_total|windows_process_page_faults_total|windows_process_page_file_bytes|windows_process_pool_bytes|windows_process_priority_base|windows_process_private_bytes|windows_process_threads|windows_process_virtual_bytes|windows_process_working_set_private_bytes|windows_process_working_set_peak_bytes|windows_process_working_set_bytes|windows_service_state'

action: 'keep'

- source_labels: ['__name__']

regex: 'windows_process_.*'

target_label: 'jp1_pc_trendname'

replacement: 'windows_exporter_process'

- source_labels: ['__name__','process']

regex: 'windows_process_.*;(.*)'

target_label: 'jp1_pc_nodelabel'

replacement: ${1}

- source_labels: ['__name__']

regex: 'windows_service_.*'

target_label: 'jp1_pc_trendname'

replacement: 'windows_exporter_service'

- source_labels: ['__name__']

regex: 'windows_service_.*'

target_label: 'jp1_pc_category'

replacement: 'service'

- source_labels: ['__name__','name']

regex: 'windows_service_.*;(.*)'

target_label: 'jp1_pc_nodelabel'

replacement: ${1}

- regex: jp1_pc_multiple_node

action: labeldrop

jpc_blackbox_httpの場合

- source_labels: ['__name__']

regex: 'probe_http_duration_seconds|probe_http_content_length|probe_http_uncompressed_body_length|probe_http_redirects|probe_http_ssl|probe_http_status_code|probe_ssl_earliest_cert_expiry|probe_ssl_last_chain_expiry_timestamp_seconds|probe_ssl_last_chain_info|probe_tls_version_info|probe_http_version|probe_failed_due_to_regex|probe_http_last_modified_timestamp_seconds|probe_success|probe_duration_seconds'

action: 'keep'

jpc_blackbox_icmpの場合

- source_labels: ['__name__']

regex: 'probe_icmp_duration_seconds|probe_icmp_reply_hop_limit|probe_success|probe_duration_seconds'

action: 'keep'

jpc_cloudwatchの場合

- regex: 'tag_(jp1_pc_.*)'

replacement: ${1}

action: labelmap

- regex: 'tag_(jp1_pc_.*)'

action: 'labeldrop'

- source_labels: ['__name__','jp1_pc_nodelabel']

regex: '(aws_ec2_cpuutilization_average|aws_ec2_disk_read_bytes_sum|aws_ec2_disk_write_bytes_sum|aws_lambda_errors_sum|aws_lambda_duration_average|aws_s3_bucket_size_bytes_sum|aws_s3_5xx_errors_sum|aws_dynamodb_consumed_read_capacity_units_sum|aws_dynamodb_consumed_write_capacity_units_sum|aws_states_execution_time_average|aws_states_executions_failed_sum|aws_sqs_approximate_number_of_messages_delayed_sum|aws_sqs_number_of_messages_deleted_sum|aws_ebs_volume_read_bytes_sum|aws_ebs_volume_write_bytes_sum|aws_ecs_cpuutilization_average|aws_ecs_memory_utilization_average|aws_efs_total_iobytes_average|aws_efs_storage_bytes_average|aws_fsx_data_read_bytes_sum|aws_fsx_data_write_bytes_sum|aws_fsx_free_storage_capacity_average|aws_rds_cpuutilization_average|aws_rds_read_iops_average|aws_rds_write_iops_average|aws_sns_number_of_notifications_failed_sum|aws_sns_number_of_notifications_filtered_out_sum);.+$'

action: 'keep'

- source_labels: ['__name__','dimension_ClusterName']

target_label: jp1_pc_nodelabel

regex: 'aws_ecs_.+;(.+)'

replacement: ${1}

- source_labels: ['__name__','dimension_ServiceName']

target_label: jp1_pc_nodelabel

regex: 'aws_ecs_.+;(.+)'

replacement: ${1}

jpc_processの場合

- source_labels: [groupname]

regex: ([^;]*?);([^;]*?);(.*)

target_label: program

replacement: ${1}

- source_labels: [groupname]

regex: ([^;]*?);([^;]*?);(.*)

target_label: user

replacement: ${2}

- source_labels: [groupname]

regex: ([^;]*?);([^;]*?);(.*)

target_label: command_line

replacement: ${3}

- source_labels: [program]

target_label: jp1_pc_nodelabel

- source_labels: ['__name__']

regex: 'namedprocess_namegroup_num_procs|namedprocess_namegroup_cpu_seconds_total|namedprocess_namegroup_read_bytes_total|namedprocess_namegroup_write_bytes_total|namedprocess_namegroup_major_page_faults_total|namedprocess_namegroup_minor_page_faults_total|namedprocess_namegroup_context_switches_total|namedprocess_namegroup_memory_bytes|namedprocess_namegroup_open_filedesc|namedprocess_namegroup_worst_fd_ratio|namedprocess_namegroup_oldest_start_time_seconds|namedprocess_namegroup_num_threads|namedprocess_namegroup_states|namedprocess_namegroup_thread_count|namedprocess_namegroup_thread_cpu_seconds_total|namedprocess_namegroup_thread_io_bytes_total|namedprocess_namegroup_thread_major_page_faults_total|namedprocess_namegroup_thread_minor_page_faults_total|namedprocess_namegroup_thread_context_switches_total'

action: 'keep'

- regex: (jp1_pc_multiple_node|jp1_pc_agent_create_flag)

action: labeldrop

jpc_promitorの場合

- source_labels: [resource_uri]

regex: ([^/]+)/([^/]+)/([^/]+)/([^/]+)/([^/]+)/([^/]+)/([^/]+)/(.*)

target_label: jp1_pc_nodelabel

replacement: ${8}

- source_labels: ['__name__']

regex: 'azure_virtual_machine_disk_read_bytes_total|azure_virtual_machine_disk_write_bytes_total|azure_virtual_machine_percentage_cpu_average|azure_blob_storage_availability_average|azure_blob_storage_blob_capacity_average|azure_function_app_http5xx_total|azure_function_app_http_response_time_average|azure_cosmos_db_total_request_units_total|azure_logic_app_runs_failed_total|azure_container_instance_cpu_usage_average|azure_container_instance_memory_usage_average|azure_kubernetes_service_kube_pod_status_phase_average|azure_file_storage_availability_average|azure_file_storage_file_capacity_average|azure_service_bus_namespace_deadlettered_messages_average|azure_sql_database_cpu_percent_average|azure_sql_database_dtu_used_average|azure_sql_database_storage_maximum|azure_sql_elastic_pool_cpu_percent_average|azure_sql_elastic_pool_e_dtu_used_average|azure_sql_elastic_pool_storage_used_average|azure_sql_managed_instance_avg_cpu_percent_average|azure_sql_managed_instance_io_bytes_read_average|azure_sql_managed_instance_io_bytes_written_average|azure_sql_managed_instance_storage_space_used_mb_average'

action: 'keep'

- regex: jp1_pc_rm_agent_create_flag

action: labeldrop

- source_labels: ['__name__','phase']

regex: (azure_kubernetes_service_kube_pod_status_phase_average);Failed

target_label: __name__

replacement: ${1}_failed

- source_labels: ['__name__','phase']

regex: (azure_kubernetes_service_kube_pod_status_phase_average);Pending

target_label: __name__

replacement: ${1}_pending

- source_labels: ['__name__','phase']

regex: (azure_kubernetes_service_kube_pod_status_phase_average);Unknown

target_label: __name__

replacement: ${1}_unknown

jpc_scriptの場合

- source_labels: ['__name__']

regex: 'script_success|script_duration_seconds|script_exit_code'

action: 'keep'

- source_labels: [jp1_pc_script]

target_label: jp1_pc_nodelabel

- regex: (jp1_pc_script|jp1_pc_multiple_node|jp1_pc_agent_create_flag)

action: labeldrop

jpc_node_aixの場合

- source_labels: ['__name__']

regex:

'node_context_switches|node_cpu|aix_diskpath_wblks|aix_diskpath_rblks|aix_disk_rserv|aix_disk_rblks|aix_disk_wserv|aix_disk_wblks|aix_disk_time|aix_disk_xrate|aix_disk_xfers|node_filesystem_avail_bytes|node_filesystem_files|node_filesystem_files_free|node_filesystem_free_bytes|node_filesystem_size_bytes|node_intr|node_load1|node_load5|node_load15|aix_memory_real_avail|aix_memory_real_free|aix_memory_real_inuse|aix_memory_real_total|aix_netinterface_mtu|aix_netinterface_ibytes|aix_netinterface_ierrors|aix_netinterface_ipackets|aix_netinterface_obytes|aix_netinterface_collisions|aix_netinterface_oerrors|aix_netinterface_opackets|aix_memory_pgspins|aix_memory_pgspouts'

action: 'keep'

<job_name>

JP1/IM - Agentが提供するExporterと同じユーザー独自のExporterの場合は，次の表に示すジョブ名（JP1/IM - Agentが提供するPrometheus設定ファイルで指定するスクレイプジョブ名と同じ）を指定します。

Exporter名

指定するジョブ名

Node exporter

jpc_node

Windows exporter

jpc_windows

Node exporter for AIX

jpc_node_aix

Blackbox exporter

jpc_blackbox_httpまたはjpc_blackbox_icmp

Yet another cloudwatch exporter

jpc_cloudwatch

Process exporter

jpc_process

Promitor

jpc_promitor

Script exporter

「jpc_script」で始まるジョブ名

<static_config>

static_configでは，ターゲットのリストとそれらに共通するラベルセットを設定できます。これは，スクレイプ設定で静的ターゲットを指定するための典型的な方法です。

注：JP1/IM - Agentでは，file_sd_configに指定されたファイルに記載します。

項目名

説明

変更可否

JP1/IM - Agentでユーザーが設定する内容

JP1/IM - Agentのデフォルト値

targets:

スクレイプ対象を指定します。100個まで指定できます。

△

−

−

[ - '<host>' ]

スクレイプ対象のホスト名を255バイト以内で指定します。

＜設定例＞

- targets:

- HOST1:1000

- HOST2:2000

○

スクレイプ対象を指定します。

−

labels:

スクレイプ対象から取得したすべてのメトリクスに設定したいラベルを指定します。30個まで指定できます。

△

−

−

[ <labelname>: <labelvalue> ... ]

ラベル名とラベルの値を指定します。ラベル名とラベルの値はそれぞれ255バイトまで指定できます。

○

メトリックにラベルを追加したい場合に指定します。

−

（凡例）

〇：変更可　△：変更不可　−：該当なし

<relabel_config>

relabel_configを設定することで，スクレイプ，リモートライト，アラート通知などの処理を行う前にターゲットのラベルを編集したり，指定したターゲットを除外したりすることができます。

relabel_configの設定は，設定ファイルに記載されている順に，各ターゲットに適用されます。

初期状態では，ターゲットに対して次に示すラベルが設定されます。

ターゲットのjobラベルに対して，それぞれのスクレイプ定義のjob_nameの値が設定されます。

instanceラベルと__address__ラベルには，ディスカバリ設定ファイルのtargetsに指定した文字列が設定されます。

ターゲットに__param_<name>ラベルが存在する場合，スクレイプ時に「<name>=値」形式のURLパラメーターが設定されます。

ターゲットには，ディスカバリ設定ファイルのlabelsに指定したラベルが設定されます。

Prometheus serverは，__address__ラベルに設定された「ホスト名:ポート番号」に対してスクレイプを行うため，targetsに指定した値が，スクレイプ先の「ホスト名:ポート番号」でない場合，スクレイプ定義のrelabel_configによる編集が必要です。

__で始まるラベルは，スクレイプ，リモートライト，アラート通知などの処理を行ったあとのデータからは削除されます。

リラベルステップがラベルの値を一時的に（後続のリラベルステップへの入力として）保存する必要がある場合は，__tmpラベル名プレフィックスを使用してください。このプレフィックスは，Prometheus自身が使用しないことが保証されています。

項目名

説明

変更可否

JP1/IM - Agentでユーザーが設定する内容

JP1/IM - Agentのデフォルト値

[ source_labels: '[' <labelname> [, ...] ']' ]

ソースラベルを，既存のラベルから値を選択します。

その内容は，設定されたセパレータを使って連結され，replace，keep，dropアクションのために設定された正規表現と照合されます。

〇

「説明」欄と同じです。

−

[ separator: <string> | default = ; ]

連結されたソースラベルの値の間に置かれるセパレータを設定します。

〇

「説明」欄と同じです。

−

[ target_label: <labelname> ]

置換アクションで結果の値が書き込まれるラベルを設定します。

置換アクションでは必須です。Regexのキャプチャグループが利用できます。

〇

「説明」欄と同じです。

−

[ regex: <regex> | default = (.*) ]

抽出された値が照合される正規表現を設定します。

詳細については，下記の<regex>の説明を参照してください。

〇

「説明」欄と同じです。

-

[ replacement: <string> | default = $1 ]

正規表現がマッチした場合に，正規表現による置換が実行される置換値を設定します。Regexキャプチャグループが利用できます。

〇

「説明」欄と同じです。

−

[ action: <relabel_action> | default = replace ]

正規表現のマッチングに基づいて実行するアクションを設定します。

詳細については，下記の<relabel_action>の説明を参照してください。

〇

「説明」欄と同じです。

−

（凡例）

〇：変更可　−：該当なし

<regex>

任意の有効なRE2正規表現を設定します。

replace，keep，drop，labeldropの各アクションに必要です。regexは両端がアンカーされています。正規表現のアンカーを解除するには，.*<regex>.*を使用します。

<relabel_action>

再ラベル化のアクションを設定します。

replace:

連結されたsource_labelsに対してregexをマッチさせます。そして，replacementの中のマッチグループ参照（${1}, ${2}, ...）をその値で置き換えて，target_labelをreplacementに設定します。regexがマッチしない場合，replacementは行われません。

keep:

regexが連結されたsource_labelsにマッチしないターゲットを削除します。

drop:

regexが連結されたsource_labelsにマッチするターゲットを削除します。

labeldrop:

regexをすべてのラベル名にマッチさせます。一致したラベルは，ラベルのセットから削除されます。

（設定例）ユーザー独自のスクレイプ定義

ユーザー独自のExporterを使用し，ディスカバリ設定ファイルに複数の監視対象を定義する場合，relabel_configのregexを指定し，jp1_pc_nodelabelに値を設定する必要があります。

スクレイプ定義の設定およびjp1_pc_nodelabelについては，マニュアル「JP1/Integrated Management 3 - Manager 構築ガイド」の「1.21.2(3)(d) ユーザー独自のExporterのスクレイプジョブを追加する（Windowsの場合）（オプション）」を参照してください。

ディスカバリ設定ファイルのtargetsに，次に示す3つの監視対象を設定している例を示します。それぞれのIM管理ノードのラベル名として，jp1_pc_nodelabelに「target1 label」，「target2 label」，「target3 label」を設定します。

- targets:
  - hostA:target1 label:Exporterに渡すクエリパラメーター1
  - hostA:target2 label:Exporterに渡すクエリパラメーター2
  - hostB:target3 label:Exporterに渡すクエリパラメーター3

relabel_configの指定

relabel_configs:
 - source_labels:[__address__]    ┐
   target_label:__param_target    │①
   regex:([^:]+):([^:]+):(.*)     │
   replacement:${3}               ┘
 - source_labels:[__address__]    ┐②
   target_label:instance          ┘
 - source_labels:[__address__]    ┐③
   target_label:jp1_pc_nodelabel  │
   regex:([^:]+):([^:]+):(.*)     │
   replacement:${2}               ┘
 - target_label:__address__       ┐④
   replacement:localhost:20799    ┘

①：__address__に設定された値（hostA:target1 label:Exporterに渡すクエリパラメーター1）を分割し，Exporterに渡すクエリパラメーター1の文字列を__param_targetラベルに設定しています。targetはスクレイプ時のURLパラメーターとなります。

②：__address__に設定された値をinstanceラベルに設定しています。

③：__address__に設定された値を分割し，IM管理ノードのラベル名（targetX label）をjp1_pc_nodelabelラベルに設定しています。

④：__address__にユーザー独自のExporterのスクレイプ先の情報（ホスト名:ポート番号）を設定しています。

<metric_relabel_configs>

Metric relabelingは，インジェストの前の最後のステップとしてサンプルに適用されます。Target relabelingと同じ設定フォーマットとアクションを持ちます。Metric relabelingは，upなどの自動生成された時系列には適用されません。

これは，インジェストするにはコストがかかりすぎる時系列を除外するために使用されます。

<alert_relabel_configs>

Alert relabelingは，Alertmanagerに送信される前のアラートに適用されます。

これはtarget relabelingと同じ設定フォーマットとアクションを持ちます。Alert relabelingは，外部ラベルのあとに適用されます。

この用途としては，異なる外部ラベルを持つPrometheusサーバのHAペアが同一のアラートを送信することを保証することが挙げられます。

<alertmanager_config>

alertmanager_configセクションは，Prometheusサーバがアラートを送信するAlertmanagerインスタンスを指定します。また，これらのAlertmanagerとの通信方法を設定するためのパラメーターも提供しています。

Alertmanagerは，static_configsパラメーターで静的に設定したり，サポートされているサービス発見メカニズムの1つを使って動的に発見したりすることもできます。

項目名

説明

変更可否

JP1/IM - Agentでユーザーが設定する内容

JP1/IM - Agentのデフォルト値

static_configs:

直接指定での設定を行います。

△

−

−

- targets:

アラートの送信先とするAlertmanagerを指定します。

△

−

−

[ - '<host>' ]

ホスト名を255バイト以内で指定します。

＜設定例＞

alerting:

alertmanagers:

- static_configs:

- targets: [統合エージェントホスト名:20714]

◎

ポート番号にはAlertmanagerのポートを指定します。

Alertmanagerのコマンドラインオプションの--web.listen-addressに，ホスト名またはIPアドレスを指定した場合は，localhostを--web.listen-addressに指定したホスト名またはIPアドレスに修正します。

localhost:20714

（凡例）

◎：設定必須　△：変更不可　−：該当なし

アラート設定ファイル（jpc_alerting_rules.yml）

形式

YAML形式で記述します。

groups:
  - name: グループ名
    rules:
    - alert: アラート名
      expr: 条件式
      for: 期間
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/CONFINFO"
        jp1_pc_severity: JP1イベントの重大度
        jp1_pc_eventid: JP1イベントのイベントID
        jp1_pc_metricname: メトリック名
      annotations:
        jp1_pc_firing_description: 発火条件を満たしたときのメッセージ
        jp1_pc_resolved_description: 発火条件を満たさなくなったときのメッセージ

ファイル

jpc_alerting_rules.yml

jpc_alerting_rules.yml.model（モデルファイル）

格納先ディレクトリ

■統合エージェントホスト

Windowsの場合

物理ホストのとき

Agentパス¥conf¥

論理ホストのとき

共有フォルダ¥jp1ima¥conf¥

Linuxの場合

物理ホストのとき

/opt/jp1ima/conf/

論理ホストのとき

共有ディレクトリ/jp1ima/conf/

説明

Prometheus serverが実行するアラート評価のルールを定義するファイルです。

文字コード

UTF-8（BOM無し）

改行コード

Windowsの場合：CR+LF

Linuxの場合：LF

定義の反映時期

Prometheus serverを再起動したとき，およびPrometheus serverにリロードを指示したときに反映されます。

記述内容

下記の表で使用している一般的なプレースホルダーの定義については，「ymlファイルの記述項目で使用している一般的なプレースホルダーの定義について」を参照してください。

項目名

説明

変更可否

JP1/IM - Agentでユーザーが設定する内容

JP1/IM - Agentのデフォルト値

groups:

−

△

−

"groups:"

name: <string>

アラートのグループ名を255バイト以内で指定します。グループ名は，監視エージェントホスト内で一意である必要があり，同じグループ名を指定したnameを重複して指定できません。なお，異なる監視エージェントホスト間では，それぞれに同じグループ名を指定したnameを指定できます。

○

任意のグループ名を指定します。

指定なし

rules:

アラートルールを設定します。100個まで指定できます。

△

−

指定なし

alert: <string>

アラートの名前を指定します。

○

ユーザーが作成したアラートの名前を指定します。

指定なし

expr: <string>

アラートの条件式を255バイト以内で指定します。

PromQL文を指定します。

○

評価するPromQL文を指定します。※

PromQL文に関する注意事項については，「PromQL文に関する注意事項」を参照してください。

指定なし

for: <duration>

アラートが発火状態となるまでにかかる時間を0秒から24時間の範囲で指定します。

値は数字と単位で指定します。指定できる単位はs（秒）とm（分）です。

アラートの条件式に該当しても，forに指定した期間内に該当しなくなった場合は発火と扱われません。

○

アラートが発火状態となるまでにかかる時間を指定します。

指定なしｂｖｇ

labels:

アラートごとに追加または上書きするラベルを設定します。

△

−

指定なし

jp1_pc_product_name: <string>

JP1イベントのプロダクト名に設定する値を指定します。

○

"/HITACHI/JP1/JPCCS2"，または，"/HITACHI/JP1/JPCCS2/xxxx"

xxxxは，ユーザーが指定できます。

指定なし

jp1_pc_component: <string>

JP1イベントのコンポーネント名に設定する値を指定します。

○

JP1イベントを処理する製品プラグインに応じて，次の値を指定します。

jp1pccs_azure.js："/HITACHI/JP1/JPCCS/AZURE/CONFINFO"

jp1pccs_kubernetes.js："/HITACHI/JP1/JPCCS/KUBERNETES/CONFINFO"

jp1pccs.js："/HITACHI/JP1/JPCCS/CONFINFO"

指定なし

jp1_pc_severity: <string>

JP1イベントの重大度に設定する値を指定します。

○

次のどれかを指定します。

Emergency

Alert

Critical

Error

Warning

Notice

Information

Debug

指定なし

jp1_pc_eventid: <string>

JP1イベントのイベントIDに設定する値を指定します。

○

JP1イベントのイベントIDとして指定できる「0〜1FFF，7FFF8000〜7FFFFFFF」の範囲内の任意の値を指定します。

指定を省略した場合，JP1イベントのID属性の値に「00007600」を設定します。

jp1_pc_metricname: <string>

JP1イベントのメトリック名に設定する値を指定します。

Yet another cloudwatch exporterの場合，メトリック名（コンマ区切りで複数指定されている場合は先頭のメトリック名）に対応するAWS名前空間のIM管理ノードに対して，JP1イベントの関連付けを行います。

○

コンマ区切りでメトリック名を指定します。

指定なし

annotations:

各アラートに追加する注釈を設定します。

△

−

指定なし

jp1_pc_firing_description: <string>

アラートの発火条件を満たしたとき，JP1イベントのメッセージに設定する値を指定します。

値の長さが1,024バイト以上の場合，先頭から1,023バイト目までの文字列を設定します。

指定を省略した場合，JP1イベントのメッセージの内容は「The alert is firing.(alert=アラート名)」となります。

○

任意のメッセージを指定します。

指定を省略した場合，JP1イベントのメッセージの内容は「The alert is firing.(alert=アラート名)」となります。

jp1_pc_resolved_description: <string>

アラートの発火条件を満たさなくなったとき，JP1イベントのメッセージに設定する値を指定します。

値の長さが1,024バイト以上の場合，先頭から1,023バイト目までの文字列を設定します。

指定を省略した場合，JP1イベントのメッセージの内容は「The alert is resolved.(alert=アラート名)」となります。

○

任意のメッセージを指定します。

指定を省略した場合，JP1イベントのメッセージの内容は「The alert is resolved.(alert=アラート名)」となります。

（凡例）

〇：変更可　△：変更不可　−：該当なし

注※

次に示すラベルはJP1イベントの属性に設定するため，集計演算子などでラベルが取り除かれないようにしてください。

instance

job

jp1_pc_nodelabel

jp1_pc_exporter

jp1_pc_remote_monitor_instance

account

region

dimension_任意の文字列

なお，accout，region，dimension_任意の文字列のラベルは，Yet another cloudwatch exporterのメトリックを監視する場合にだけ該当します。

定義例

メトリック定義ファイルのモデルファイルに記述されている各メトリックのアラート定義例を，次に示します。

■「Node exporterのメトリック定義ファイル」のメトリックのアラート定義例

cpu_used_rate※

groups:
  - name: node_exporter
    rules:
    - alert: cpu_used_rate(Node exporter)
      expr: 80 < (avg by (instance,job,jp1_pc_nodelabel,jp1_pc_exporter) (rate(node_cpu_seconds_total{mode="system"}[2m])) + avg by (instance,job,jp1_pc_nodelabel,jp1_pc_exporter) (rate(node_cpu_seconds_total{mode="user"}[2m]))) * 100
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0301"
        jp1_pc_metricname: "node_cpu_seconds_total"
      annotations:
        jp1_pc_firing_description: "CPU使用率がしきい値(80%)を上回りました。value={{ $value }}%"
        jp1_pc_resolved_description: "CPU使用率がしきい値(80%)を下回りました。"

memory_unused※

groups:
  - name: node_exporter
    rules:
    - alert: memory_unused(Node exporter)
      expr: 1024 > node_memory_MemAvailable_bytes/1024/1024
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0302"
        jp1_pc_metricname: "node_memory_MemAvailable_bytes"
      annotations:
        jp1_pc_firing_description: "空きメモリ量がしきい値(1024メガバイト)を下回りました。value={{ $value }}メガバイト"
        jp1_pc_resolved_description: "空きメモリ量がしきい値(1024メガバイト)を上回りました。"

memory_unused_rate※

groups:
  - name: node_exporter
    rules:
    - alert: memory_unused_rate(Node exporter)
      expr: node_memory_MemAvailable_bytes  / node_memory_MemTotal_bytes * 100 < 10
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0302"
        jp1_pc_metricname: "node_memory_MemAvailable_bytes,node_memory_MemTotal_bytes"
      annotations:
        jp1_pc_firing_description: "空きメモリ率がしきい値(10%)を下回りました。value={{ $value }}%"
        jp1_pc_resolved_description: "空きメモリ率がしきい値(10%)を上回りました。"

disk_unused※

groups:
  - name: node_exporter
    rules:
    - alert: disk_unused(Node exporter)
      expr: 10 > node_filesystem_free_bytes/(1024*1024*1024)
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0303"
        jp1_pc_metricname: "node_filesystem_free_bytes"
      annotations:
        jp1_pc_firing_description: "空きディスク領域がしきい値(10ギガバイト)を下回りました。value={{ $value }}ギガバイト，mountpoint={{ $labels.mountpoint }}"
        jp1_pc_resolved_description: "空きディスク領域がしきい値(10ギガバイト)を上回りました。mountpoint={{ $labels.mountpoint }}"

注

1つのPrometheusでNode exporterとNode exporter for AIXを両方監視する場合，Node exporterとNode exporter for AIXのメトリックを区別するため，次の下線部分のように，Node exporterのアラート定義のdisk_unusedのexprにjobラベルを指定します。

10 > node_filesystem_free_bytes{job="jpc_node"}/(1024*1024*1024)

disk_unused_rate※

groups:
  - name: node_exporter
    rules:
    - alert: disk_unused_rate(Node exporter)
      expr: node_filesystem_free_bytes / node_filesystem_size_bytes * 100 < 10
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0303"
        jp1_pc_metricname: "node_filesystem_free_bytes,node_filesystem_size_bytes"
      annotations:
        jp1_pc_firing_description: "空きディスク率がしきい値(10%)を下回りました。value={{ $value }}%，mountpoint={{ $labels.mountpoint }}"
        jp1_pc_resolved_description: "空きディスク率がしきい値(10%)を上回りました。mountpoint={{ $labels.mountpoint }}"

注

1つのPrometheusでNode exporterとNode exporter for AIXを両方監視する場合，Node exporterとNode exporter for AIXのメトリックを区別するため，次の下線部分のように，Node exporterのアラート定義のdisk_unused_rateのexprにjobラベルを指定します。

node_filesystem_free_bytes{job="jpc_node"} / node_filesystem_size_bytes{job="jpc_node"} * 100 < 10

disk_busy_rate※

groups:
  - name: node_exporter
    rules:
    - alert: disk_busy_rate(Node exporter)
      expr: 70 < rate(node_disk_io_time_seconds_total[2m])*100
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0304"
        jp1_pc_metricname: "node_disk_io_time_seconds_total"
      annotations:
        jp1_pc_firing_description: "ディスクビジー率がしきい値(70%)を上回りました。value={{ $value }}%，device={{ $labels.device }}"
        jp1_pc_resolved_description: "ディスクビジー率がしきい値(70%)を下回りました。device={{ $labels.device }}"

disk_read_latency※

groups:
  - name: node_exporter
    rules:
    - alert: disk_read_latency(Node exporter)
      expr: rate(node_disk_read_time_seconds_total[2m]) / rate(node_disk_reads_completed_total[2m]) > 0.1 and rate(node_disk_reads_completed_total[2m]) > 0
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0304"
        jp1_pc_metricname: "node_disk_read_time_seconds_total,node_disk_reads_completed_total"
      annotations:
        jp1_pc_firing_description: "ディスク読み込みレイテンシーがしきい値(0.1秒)を上回りました。value={{ $value }}秒，device={{ $labels.device }}"
        jp1_pc_resolved_description: "ディスク読み込みレイテンシーがしきい値(0.1秒)を下回りました。device={{ $labels.device }}"

disk_write_latency※

groups:
  - name: node_exporter
    rules:
    - alert: disk_write_latency(Node exporter)
      expr: rate(node_disk_write_time_seconds_total[2m]) / rate(node_disk_writes_completed_total[2m]) > 0.1 and rate(node_disk_writes_completed_total[2m]) > 0
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0304"
        jp1_pc_metricname: "node_disk_write_time_seconds_total,node_disk_writes_completed_total"
      annotations:
        jp1_pc_firing_description: "ディスク書き込みレイテンシーがしきい値(0.1秒)を上回りました。value={{ $value }}秒，device={{ $labels.device }}"
        jp1_pc_resolved_description: "ディスク書き込みレイテンシーがしきい値(0.1秒)を下回りました。device={{ $labels.device }}"

disk_io_latency※

groups:
  - name: node_exporter
    rules:
    - alert: disk_io_latency(Node exporter)
      expr: (rate(node_disk_read_time_seconds_total[2m]) + rate(node_disk_write_time_seconds_total[2m])) / (rate(node_disk_reads_completed_total[2m]) + rate(node_disk_writes_completed_total[2m])) > 0.1 and (rate(node_disk_writes_completed_total[2m]) > 0 or rate(node_disk_read_completed_total[2m]) > 0)
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0304"
        jp1_pc_metricname: "node_disk_write_time_seconds_total,node_disk_writes_completed_total,node_disk_read_time_seconds_total,node_disk_reads_completed_total"
      annotations:
        jp1_pc_firing_description: "ディスクIOレイテンシーがしきい値(0.1秒)を上回りました。value={{ $value }}秒，device={{ $labels.device }}"
        jp1_pc_resolved_description: "ディスクIOレイテンシーがしきい値(0.1秒)を下回りました。device={{ $labels.device }}"

network_sent※

groups:
  - name: node_exporter
    rules:
    - alert: network_sent(Node exporter)
      expr: 100 < rate(node_network_transmit_packets_total[2m])
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0305"
        jp1_pc_metricname: "node_network_transmit_packets_total"
      annotations:
        jp1_pc_firing_description: "ネットワークの送信速度がしきい値(100パケット/秒)を上回りました。value={{ $value }}パケット/秒，device={{ $labels.device }}"
        jp1_pc_resolved_description: "ネットワークの送信速度がしきい値(100パケット/秒)を下回りました。device={{ $labels.device }}"

network_received※

groups:
  - name: node_exporter
    rules:
    - alert: network_received(Node exporter)
      expr: 100 < rate(node_network_receive_packets_total[2m])
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0306"
        jp1_pc_metricname: "node_network_receive_packets_total"
      annotations:
        jp1_pc_firing_description: "ネットワークの受信速度がしきい値(100パケット/秒)を上回りました。value={{ $value }}パケット/秒，device={{ $labels.device }}"
        jp1_pc_resolved_description: "ネットワークの受信速度がしきい値(100パケット/秒)を下回りました。device={{ $labels.device }}"

注※

複数のアラートを同一の監視エージェントホストで定義する場合，「groups:」を重複して指定したり，同じグループ名を指定したnameを重複して指定したりしないように注意してください。

■「Process exporterのメトリック定義ファイル」のメトリックのアラート定義例

process_pgm_process_count※

groups:
  - name: process_exporter
    rules:
    - alert: process_pgm_process_count(Processs exporter)
      expr: 1 >  sum by (program, instance, job, jp1_pc_nodelabel, jp1_pc_exporter) (namedprocess_namegroup_num_procs)
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "1308"
        jp1_pc_metricname: "namedprocess_namegroup_num_procs"
      annotations:
        jp1_pc_firing_description: "プロセス数がしきい値(1個)を下回りました。value={{ $value }}個"
        jp1_pc_resolved_description: "プロセス数がしきい値(1個)を上回りました。"

注※

しきい値が1の例です。値は監視対象に合わせて変更してください。

複数のアラートを同一の監視エージェントホストで定義する場合，「groups:」を重複して指定したり，同じグループ名を指定したnameを重複して指定したりしないように注意してください。

■「Node exporter（サービス監視）のメトリック定義ファイル」のメトリックのアラート定義例

service_state※

監視対象のユニットの自動起動設定が有効（systemctl enableを実行している）の場合

groups:
  - name: node_exporter
    rules:
    - alert: service_state(Node exporter)
      expr: node_systemd_unit_state{state="active"} == 0
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0320"
        jp1_pc_metricname: "node_systemd_unit_state"
      annotations:
        jp1_pc_firing_description: "サービスの状態が実行中ではありません。"
        jp1_pc_resolved_description: "サービスの状態が実行中になりました。"

監視対象のユニットの自動起動設定が無効の場合

groups:
  - name: node_exporter
    rules:
    - alert: service_state_サービス名(Node exporter)
      expr: absent(node_systemd_unit_state{instance="統合エージェントホスト名:Node exporterのポート番号", job="jpc_node", jp1_pc_exporter="JPC Node exporter", jp1_pc_nodelabel="サービス名", state="active"}) == 1
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0320"
        jp1_pc_metricname: "node_systemd_unit_state"
      annotations:
        jp1_pc_firing_description: "サービスの状態が実行中ではありません。"
        jp1_pc_resolved_description: "サービスの状態が実行中になりました。"

注※

複数のアラートを同一の監視エージェントホストで定義する場合，「groups:」を重複して指定したり，同じグループ名を指定したnameを重複して指定したりしないように注意してください。

■「Windows exporterのメトリック定義ファイル」のメトリックのアラート定義例

cpu_used_rate※

groups:
  - name: windows_exporter
    rules:
    - alert: cpu_used_rate(Windows exporter)
      expr: 80 < 100 - (avg by (instance,job,jp1_pc_nodelabel,jp1_pc_exporter) (rate(windows_cpu_time_total{mode="idle"}[2m])) * 100)
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0401"
        jp1_pc_metricname: "windows_cpu_time_total"
      annotations:
        jp1_pc_firing_description: "CPU使用率がしきい値(80%)を上回りました。value={{ $value }}%"
        jp1_pc_resolved_description: "CPU使用率がしきい値(80%)を下回りました。"

memory_unused※

groups:
  - name: windows_exporter
    rules:
    - alert: memory_unused(Windows exporter)
      expr: 1 > windows_memory_available_bytes/1024/1024/1024
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0402"
        jp1_pc_metricname: "windows_memory_available_bytes"
      annotations:
        jp1_pc_firing_description: "空きメモリ量がしきい値(1ギガバイト)を下回りました。value={{ $value }}ギガバイト"
        jp1_pc_resolved_description: "空きメモリ量がしきい値(1ギガバイト)を上回りました。"

memory_unused_rate※

groups:
  - name: windows_exporter
    rules:
    - alert: memory_unused_rate(Windows exporter)
      expr: windows_memory_available_bytes / windows_cs_physical_memory_bytes * 100 < 10
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0402"
        jp1_pc_metricname: "windows_memory_available_bytes,windows_cs_physical_memory_bytes"
      annotations:
        jp1_pc_firing_description: "空きメモリ率がしきい値(10%)を下回りました。value={{ $value }}%"
        jp1_pc_resolved_description: "空きメモリ率がしきい値(10%)を上回りました。"

disk_unused※

groups:
  - name: windows_exporter
    rules:
    - alert: disk_unused(Windows exporter)
      expr: 10 > windows_logical_disk_free_bytes{volume!~"HarddiskVolume.*"} / (1024*1024*1024)
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0403"
        jp1_pc_metricname: "windows_logical_disk_free_bytes"
      annotations:
        jp1_pc_firing_description: "空きディスク領域がしきい値(10ギガバイト)を下回りました。value={{ $value }}ギガバイト，volume={{ $labels.volume }}"
        jp1_pc_resolved_description: "空きディスク領域がしきい値(10ギガバイト)を上回りました。volume={{ $labels.volume }}"

disk_unused_rate※

groups:
  - name: windows_exporter
    rules:
    - alert: disk_unused_rate(Windows exporter)
      expr: windows_logical_disk_free_bytes{volume!~"HarddiskVolume.*"} / windows_logical_disk_size_bytes * 100 < 10
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0403"
        jp1_pc_metricname: "windows_logical_disk_free_bytes,windows_logical_disk_size_bytes"
      annotations:
        jp1_pc_firing_description: "空きディスク率がしきい値(10%)を下回りました。value={{ $value }}%，volume={{ $labels.volume }}"
        jp1_pc_resolved_description: "空きディスク率がしきい値(10%)を上回りました。volume={{ $labels.volume }}"

disk_busy_rate※

groups:
  - name: windows_exporter
    rules:
    - alert: disk_busy_rate(Windows exporter)
      expr: 70 < 100 - rate(windows_logical_disk_idle_seconds_total{volume!~"HarddiskVolume.*"}[2m])/(rate(windows_logical_disk_write_seconds_total[2m]) + rate(windows_logical_disk_read_seconds_total[2m])+rate(windows_logical_disk_idle_seconds_total[2m])) * 100
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0404"
        jp1_pc_metricname: "windows_logical_disk_idle_seconds_total,windows_logical_disk_write_seconds_total,windows_logical_disk_read_seconds_total"
      annotations:
        jp1_pc_firing_description: "ディスクビジー率がしきい値(70%)を上回りました。value={{ $value }}%，volume={{ $labels.volume }}"
        jp1_pc_resolved_description: "ディスクビジー率がしきい値(70%)を下回りました。volume={{ $labels.volume }}"

disk_read_latency※

groups:
  - name: windows_exporter
    rules:
    - alert: disk_read_latency(Windows exporter)
      expr: rate(windows_logical_disk_read_seconds_total[2m] / rate(windows_logical_disk_reads_total[2m]) > 0.1 and rate(windows_logical_disk_reads_total[2m]) > 0
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0404"
        jp1_pc_metricname: "windows_logical_disk_read_seconds_total,windows_logical_disk_reads_total"
      annotations:
        jp1_pc_firing_description: "ディスク読み込みレイテンシーがしきい値(0.1秒)を上回りました。value={{ $value }}秒，volume={{ $labels.volume }}"
        jp1_pc_resolved_description: "ディスク読み込みレイテンシーがしきい値(0.1秒)を下回りました。volume={{ $labels.volume }}"

disk_write_latency※

groups:
  - name: windows_exporter
    rules:
    - alert: disk_write_latency(Windows exporter)
      expr: rate(windows_logical_disk_write_seconds_total[2m] / rate(windows_logical_disk_writes_total[2m]) > 0.1 and rate(windows_logical_disk_writes_total[2m]) > 0
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0404"
        jp1_pc_metricname: "windows_logical_disk_write_seconds_total,windows_logical_disk_writes_total"
      annotations:
        jp1_pc_firing_description: "ディスク書き込みレイテンシーがしきい値(0.1秒)を上回りました。value={{ $value }}秒，volume={{ $labels.volume }}"
        jp1_pc_resolved_description: "ディスク書き込みレイテンシーがしきい値(0.1秒)を下回りました。volume={{ $labels.volume }}"

disk_io_latency※

groups:
  - name: windows_exporter
    rules:
    - alert: disk_io_latency(Windows exporter)
      expr: (rate(windows_logical_disk_read_seconds_total[2m]) + rate(windows_logical_disk_write_seconds_total[2m])) / (rate(windows_logical_disk_reads_total[2m]) + rate(windows_logical_disk_writes_total[2m])) > 0.1 and (rate(windows_logical_disk_writes_total[2m]) > 0 or rate(windows_logical_disk_reads_total[2m]) > 0)
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0404"
        jp1_pc_metricname: "windows_logical_disk_write_seconds_total,windows_logical_disk_writes_total,windows_logical_disk_read_seconds_total,windows_logical_disk_reads_total"
      annotations:
        jp1_pc_firing_description: "ディスクIOレイテンシーがしきい値(0.1秒)を上回りました。value={{ $value }}秒，volume={{ $labels.volume }}"
        jp1_pc_resolved_description: "ディスクIOレイテンシーがしきい値(0.1秒)を下回りました。volume={{ $labels.volume }}"

network_sent※

groups:
  - name: windows_exporter
    rules:
    - alert: network_sent(Windows exporter)
      expr: 100 < rate(windows_net_packets_sent_total[2m])
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0405"
        jp1_pc_metricname: "windows_net_packets_sent_total"
      annotations:
        jp1_pc_firing_description: "ネットワークの送信速度がしきい値(100パケット/秒)を上回りました。value={{ $value }}パケット/秒，nic={{ $labels.nic }}"
        jp1_pc_resolved_description: "ネットワークの送信速度がしきい値(100パケット/秒)を下回りました。nic={{ $labels.nic }}"

network_received※

groups:
  - name: windows_exporter
    rules:
    - alert: network_received(Windows exporter)
      expr: 100 < rate(windows_net_packets_received_total[2m])
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0406"
        jp1_pc_metricname: "windows_net_packets_received_total"
      annotations:
        jp1_pc_firing_description: "ネットワークの受信速度がしきい値(100パケット/秒)を上回りました。value={{ $value }}パケット/秒，nic={{ $labels.nic }}"
        jp1_pc_resolved_description: "ネットワークの受信速度がしきい値(100パケット/秒)を下回りました。nic={{ $labels.nic }}"

注※

複数のアラートを同一の監視エージェントホストで定義する場合，「groups:」を重複して指定したり，同じグループ名を指定したnameを重複して指定したりしないように注意してください。

■「Windows exporter（プロセス監視）のメトリック定義ファイル」のメトリックのアラート定義例

process_pgm_process_count※

groups:
 - name: windows_exporter
  rules:
   - alert: process_pgm_process_count(Windows exporter)
     expr: absent(windows_process_start_time{instance="統合エージェントホスト名:Windows exporterのポート番号", job="jpc_windows", jp1_pc_exporter="JPC Windows exporter", jp1_pc_nodelabel="監視対象プロセス名",process="監視対象プロセス名"}) == 1
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0414"
        jp1_pc_metricname: "windows_process_start_time"
      annotations:
        jp1_pc_firing_description: "プロセス数がしきい値(1個)を下回りました。"
        jp1_pc_resolved_description: "プロセス数がしきい値(1個)を上回りました。"

注※

しきい値が1の例です。値は監視対象に合わせて変更してください。

複数のアラートを同一の統合エージェントホストで定義する場合，「groups:」を重複して指定したり，同じグループ名を指定したnameを重複して指定したりしないように注意してください。

■「Windows exporter（サービス監視）のメトリック定義ファイル」のメトリックのアラート定義例

service_state※

groups:
  - name: windows_exporter
    rules:
    - alert: service_state(Windows exporter)
      expr: windows_service_state{state="running"} == 0
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0420"
        jp1_pc_metricname: "windows_service_state"
      annotations:
        jp1_pc_firing_description: "サービスの状態が実行中ではありません。"
        jp1_pc_resolved_description: "サービスの状態が実行中になりました。"

注※

複数のアラートを同一の監視エージェントホストで定義する場合，「groups:」を重複して指定したり，同じグループ名を指定したnameを重複して指定したりしないように注意してください。

■「Node exporter for AIXのメトリック定義ファイル」のメトリックのアラート定義例

cpu_used_rate※

groups:
  - name: node_exporter_AIX
    rules:
    - alert: cpu_used_rate(Node exporter for AIX)
      expr: 80 < ((avg by(instance,job,jp1_pc_nodelabel,jp1_pc_exporter) (rate(node_cpu{mode="sys"}[2m])))+(avg by(instance,job,jp1_pc_nodelabel,jp1_pc_exporter) ((rate(node_cpu{mode="user"}[2m])))))*100
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0901"
        jp1_pc_metricname: "node_cpu"
      annotations:
        jp1_pc_firing_description: "CPU使用率がしきい値(80%)を上回りました。value={{ $value }}%"
        jp1_pc_resolved_description: "CPU使用率がしきい値(80%)を下回りました。"

memory_unused※

groups:
  - name: node_exporter_AIX
    rules:
    - alert: memory_unused(Node exporter for AIX)
      expr: 1 > aix_memory_real_avail/1024/1024/1024*4096
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0902"
        jp1_pc_metricname: "aix_memory_real_avail"
      annotations:
        jp1_pc_firing_description: "空きメモリ量がしきい値(1ギガバイト)を下回りました。value={{ $value }}ギガバイト"
        jp1_pc_resolved_description: "空きメモリ量がしきい値(1ギガバイト)を上回りました。"

memory_unused_rate※

groups:
  - name: node_exporter_AIX
    rules:
    - alert: memory_unused_rate(Node exporter for AIX)
      expr: aix_memory_real_avail / aix_memory_real_total * 100 < 10
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0902"
        jp1_pc_metricname: "aix_memory_real_avail,aix_memory_real_total"
      annotations:
        jp1_pc_firing_description: "空きメモリ率がしきい値(10%)を下回りました。value={{ $value }}%"
        jp1_pc_resolved_description: "空きメモリ率がしきい値(10%)を上回りました。"

disk_unused※

groups:
  - name: node_exporter_AIX
    rules:
    - alert: disk_unused(Node exporter for AIX))
      expr: 10 > node_filesystem_free_bytes{job="jpc_node_aix"}/(1024*1024*1024)
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0903"
        jp1_pc_metricname: "node_filesystem_free_bytes"
      annotations:
        jp1_pc_firing_description: "空きディスク領域がしきい値(10ギガバイト)を下回りました。value={{ $value }}ギガバイト，mountpoint={{ $labels.mountpoint }}"
        jp1_pc_resolved_description: "空きディスク領域がしきい値(10ギガバイト)を上回りました。mountpoint={{ $labels.mountpoint }}"

注

1つのPrometheusでNode exporterとNode exporter for AIXを両方監視する場合，Node exporterとNode exporter for AIXのメトリックを区別するため，Node exporterのアラート定義のdisk_unusedのexprにjobラベルを指定します。詳細については，上記の「「Node exporterのメトリック定義ファイル」のメトリックのアラート定義例」の「disk_unused」を参照してください。

disk_unused_rate※

groups:
  - name: node_exporter_AIX
    rules:
    - alert: disk_unused_rate(Node exporter for AIX)
      expr: node_filesystem_free_bytes{job="jpc_node_aix"} / node_filesystem_size_bytes{job="jpc_node_aix"} * 100 < 10
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0903"
        jp1_pc_metricname: "node_filesystem_free_bytes,node_filesystem_size_bytes"
      annotations:
        jp1_pc_firing_description: "空きディスク率がしきい値(10%)を下回りました。value={{ $value }}%，mountpoint={{ $labels.mountpoint }}"
        jp1_pc_resolved_description: "空きディスク率がしきい値(10%)を上回りました。mountpoint={{ $labels.mountpoint }}"

注

1つのPrometheusでNode exporterとNode exporter for AIXを両方監視する場合，Node exporterとNode exporter for AIXのメトリックを区別するため，Node exporterのアラート定義のdisk_unused_rateのexprにjobラベルを指定します。詳細については，上記の「「Node exporterのメトリック定義ファイル」のメトリックのアラート定義例」の「disk_unused_rate」を参照してください。

disk_busy_rate※

groups:
  - name: node_exporter_AIX
    rules:
    - alert: disk_busy_rate(Node exporter for AIX)
      expr: 70 < rate(aix_disk_time[2m])
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0904"
        jp1_pc_metricname: "aix_disk_time"
      annotations:
        jp1_pc_firing_description: "ディスクビジー率がしきい値(70%)を上回りました。value={{ $value }}%，device={{ $labels.device }}"
        jp1_pc_resolved_description: "ディスクビジー率がしきい値(70%)を下回りました。device={{ $labels.device }}"

disk_read_latency※

groups:
  - name: node_exporter_AIX
    rules:
    - alert: disk_read_latency(Node exporter for AIX)
      expr: rate(aix_disk_rserv[2m]) / rate(aix_disk_xrate[2m])/1000/1000/1000 > 0.1 and rate(aix_disk_xrate[2m]) > 0
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0904"
        jp1_pc_metricname: "aix_disk_rserv,aix_disk_xrate"
      annotations:
        jp1_pc_firing_description: "ディスク読み込みレイテンシーがしきい値(0.1秒)を上回りました。value={{ $value }}秒，device={{ $labels.device }}"
        jp1_pc_resolved_description: "ディスク読み込みレイテンシーがしきい値(0.1秒)を下回りました。device={{ $labels.device }}"

disk_write_latency※

groups:
  - name: node_exporter_AIX
    rules:
    - alert: disk_write_latency(Node exporter for AIX)
      expr: rate(aix_disk_wserv[2m]) / (rate(aix_disk_xfers[2m]) - rate(aix_disk_xrate[2m]))/1000/1000/1000 > 0.1 and (rate(aix_disk_xfers[2m]) - rate(aix_disk_xrate[2m])) > 0
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0904"
        jp1_pc_metricname: "aix_disk_wserv,aix_disk_xfers,aix_disk_xrate"
      annotations:
        jp1_pc_firing_description: "ディスク書き込みレイテンシーがしきい値(0.1秒)を上回りました。value={{ $value }}秒，device={{ $labels.device }}"
        jp1_pc_resolved_description: "ディスク書き込みレイテンシーがしきい値(0.1秒)を下回りました。device={{ $labels.device }}"

disk_io_latency※

groups:
  - name: node_exporter_AIX
    rules:
    - alert: disk_io_latency(Node exporter for AIX)
      expr: (rate(aix_disk_rserv[2m]) + rate(aix_disk_wserv[2m])) / rate(aix_disk_xfers[2m])/1000/1000/1000 > 0.1 and (rate(aix_disk_xfers[2m]) > 0)
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0904"
        jp1_pc_metricname: "aix_disk_wserv,aix_disk_rserv,aix_disk_xfers"
      annotations:
        jp1_pc_firing_description: "ディスクIOレイテンシーがしきい値(0.1秒)を上回りました。value={{ $value }}秒，device={{ $labels.device }}"
        jp1_pc_resolved_description: "ディスクIOレイテンシーがしきい値(0.1秒)を下回りました。device={{ $labels.device }}"

network_sent※

groups:
  - name: node_exporter_AIX
    rules:
    - alert: network_sent(Node exporter for AIX)
      expr: 100 < rate(aix_netinterface_opackets[2m])
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0905"
        jp1_pc_metricname: "aix_netinterface_opackets"
      annotations:
        jp1_pc_firing_description: "ネットワークの送信速度がしきい値(100パケット/秒)を上回りました。value={{ $value }}パケット/秒，device={{ $labels.device }}"
        jp1_pc_resolved_description: "ネットワークの送信速度がしきい値(100パケット/秒)を下回りました。device={{ $labels.device }}"

network_received※

groups:
  - name: node_exporter_AIX
    rules:
    - alert: network_received(Node exporter for AIX)
      expr: 100 < rate(aix_netinterface_ipackets[2m])
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0905"
        jp1_pc_metricname: "aix_netinterface_ipackets"
      annotations:
        jp1_pc_firing_description: "ネットワークの受信速度がしきい値(100パケット/秒)を上回りました。value={{ $value }}パケット/秒，device={{ $labels.device }}"
        jp1_pc_resolved_description: "ネットワークの受信速度がしきい値(100パケット/秒)を下回りました。device={{ $labels.device }}"

注※

複数のアラートを同一の監視エージェントホストで定義する場合，「groups:」を重複して指定したり，同じグループ名を指定したnameを重複して指定したりしないように注意してください。

■「Blackbox exporterのメトリック定義ファイル」のメトリックのアラート定義例

probe_success※

groups:
  - name: blackbox_exporter
    rules:
    - alert: probe_success(Blackbox exporter)
      expr: 0 == probe_success
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0501"
        jp1_pc_metricname: "probe_success"
      annotations:
        jp1_pc_firing_description: "通信に失敗しました。value={{ $value }}"
        jp1_pc_resolved_description: "通信に成功しました。"

probe_duration_seconds※

groups:
  - name: blackbox_exporter
    rules:
    - alert: probe_duration_seconds(Blackbox exporter)
      expr: 5 < probe_duration_seconds
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0502"
        jp1_pc_metricname: "probe_duration_seconds"
      annotations:
        jp1_pc_firing_description: "プローブ期間がしきい値(5秒)を上回りました。value={{ $value }}秒"
        jp1_pc_resolved_description: "プローブ期間がしきい値(5秒)を下回りました。"

probe_icmp_duration_seconds※

groups:
  - name: blackbox_exporter
    rules:
    - alert: probe_icmp_duration_seconds(Blackbox exporter)
      expr: 3 < probe_icmp_duration_seconds
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0503"
        jp1_pc_metricname: "probe_icmp_duration_seconds"
      annotations:
        jp1_pc_firing_description: "ICMP期間がしきい値(3秒)を上回りました。value={{ $value }}秒，phase={{ $labels.phase }}"
        jp1_pc_resolved_description: "ICMP期間がしきい値(3秒)を下回りました。"

probe_http_duration_seconds※

groups:
  - name: blackbox_exporter
    rules:
    - alert: probe_http_duration_seconds(Blackbox exporter)
      expr: 3 < probe_http_duration_seconds
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0504"
        jp1_pc_metricname: "probe_http_duration_seconds"
      annotations:
        jp1_pc_firing_description: "HTTPリクエスト期間がしきい値(3秒)を上回りました。value={{ $value }}秒，phase={{ $labels.phase }}"
        jp1_pc_resolved_description: "HTTPリクエスト期間がしきい値(3秒)を下回りました。"

probe_http_status_code※

groups:
  - name: blackbox_exporter
    rules:
    - alert: probe_http_status_code(Blackbox exporter)
      expr: 200 != probe_http_status_code
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0505"
        jp1_pc_metricname: "probe_http_status_code"
      annotations:
        jp1_pc_firing_description: "HTTPステータスが200ではありません。value={{ $value }}"
        jp1_pc_resolved_description: "HTTPステータスが200になりました。"

注※

複数のアラートを同一の監視エージェントホストで定義する場合，「groups:」を重複して指定したり，同じグループ名を指定したnameを重複して指定したりしないように注意してください。

■「Yet another cloudwatch exporterのメトリック定義ファイル」のメトリックのアラート定義例

aws_ec2_cpuutilization_average※

groups:
  - name: yet_another_cloudwatch_exporter
    rules:
    - alert: aws_ec2_cpuutilization_average(Yet another cloudwatch exporter)
      expr: 80 < aws_ec2_cpuutilization_average
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0601"
        jp1_pc_metricname: "aws_ec2_cpuutilization_average"
      annotations:
        jp1_pc_firing_description: "CPU使用率がしきい値(80%)を上回りました。value={{ $value }}%"
        jp1_pc_resolved_description: "CPU使用率がしきい値(80%)を下回りました。"

aws_ec2_disk_read_bytes_sum※

groups:
  - name: yet_another_cloudwatch_exporter
    rules:
    - alert: aws_ec2_disk_read_bytes_sum(Yet another cloudwatch exporter)
      expr: 10240 < aws_ec2_disk_read_bytes_sum / 1024
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0602"
        jp1_pc_metricname: "aws_ec2_disk_read_bytes_sum"
      annotations:
        jp1_pc_firing_description: "インスタンスストアボリュームの読み取りキロバイト数がしきい値(10,240KB)を上回りました。value={{ $value }}KB"
        jp1_pc_resolved_description: "インスタンスストアボリュームの読み取りキロバイト数がしきい値(10,240KB)を下回りました。"

aws_ec2_disk_write_bytes_sum※

groups:
  - name: yet_another_cloudwatch_exporter
    rules:
    - alert: aws_ec2_disk_write_bytes_sum(Yet another cloudwatch exporter)
      expr: 10240 < aws_ec2_disk_write_bytes_sum / 1024
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0603"
        jp1_pc_metricname: "aws_ec2_disk_write_bytes_sum"
      annotations:
        jp1_pc_firing_description: "インスタンスストアボリュームの書き込みキロバイト数がしきい値(10,240KB)を上回りました。value={{ $value }}KB"
        jp1_pc_resolved_description: "インスタンスストアボリュームの書き込みキロバイト数がしきい値(10,240KB)を下回りました。"

aws_lambda_errors_sum※

groups:
  - name: yet_another_cloudwatch_exporter
    rules:
    - alert: aws_lambda_errors_sum(Yet another cloudwatch exporter)
      expr: 0 < aws_lambda_errors_sum{dimension_Resource=""}
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0604"
        jp1_pc_metricname: "aws_lambda_errors_sum"
      annotations:
        jp1_pc_firing_description: "関数エラーが発生した呼び出しの数がしきい値(0個)を上回りました。value={{ $value }}個"
        jp1_pc_resolved_description: "関数エラーが発生した呼び出しの数がしきい値(0個)を下回りました。"

aws_lambda_duration_average※

groups:
  - name: yet_another_cloudwatch_exporter
    rules:
    - alert: aws_lambda_duration_average(Yet another cloudwatch exporter)
      expr: 5000 < aws_lambda_duration_average{dimension_Resource=""}
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0605"
        jp1_pc_metricname: "aws_lambda_duration_average"
      annotations:
        jp1_pc_firing_description: "関数コードがイベントの処理に費やす時間がしきい値(5000ミリ秒)を上回りました。value={{ $value }}ミリ秒"
        jp1_pc_resolved_description: "関数コードがイベントの処理に費やす時間がしきい値(5000ミリ秒)を下回りました。"

aws_s3_bucket_size_bytes_sum※

groups:
  - name: yet_another_cloudwatch_exporter
    rules:
    - alert: aws_s3_bucket_size_bytes_sum(Yet another cloudwatch exporter)
      expr: 1024 < aws_s3_bucket_size_bytes_sum / (1024*1024*1024)
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0606"
        jp1_pc_metricname: "aws_s3_bucket_size_bytes_sum"
      annotations:
        jp1_pc_firing_description: "バケットの保存データ量がしきい値(1024GB)を上回りました。value={{ $value }}GB"
        jp1_pc_resolved_description: "バケットの保存データ量がしきい値(1024GB)を下回りました。"

aws_s3_5xx_errors_sum※

groups:
  - name: yet_another_cloudwatch_exporter
    rules:
    - alert: aws_s3_5xx_errors_sum(Yet another cloudwatch exporter)
      expr: 0 < aws_s3_5xx_errors_sum
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0607"
        jp1_pc_metricname: "aws_s3_5xx_errors_sum"
      annotations:
        jp1_pc_firing_description: "バケットへのリクエストに対して，HTTP 5xx サーバーエラーステータスコードを返却される数が，しきい値(0個)を上回りました。value={{ $value }}個"
        jp1_pc_resolved_description: "バケットへのリクエストに対して，HTTP 5xx サーバーエラーステータスコードを返却される数が，しきい値(0個)を下回りました。"

aws_dynamodb_consumed_read_capacity_units_sum※

groups:
  - name: yet_another_cloudwatch_exporter
    rules:
    - alert: aws_dynamodb_consumed_read_capacity_units_sum(Yet another cloudwatch exporter)
      expr: 600 < aws_dynamodb_consumed_read_capacity_units_sum
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0608"
        jp1_pc_metricname: "aws_dynamodb_consumed_read_capacity_units_sum"
      annotations:
        jp1_pc_firing_description: "消費された読み込み容量ユニットの合計数がしきい値(600個)を上回りました。value={{ $value }}個"
        jp1_pc_resolved_description: "消費された読み込み容量ユニットの合計数がしきい値(600個)を下回りました。"

aws_dynamodb_consumed_write_capacity_units_sum※

groups:
  - name: yet_another_cloudwatch_exporter
    rules:
    - alert: aws_dynamodb_consumed_write_capacity_units_sum(Yet another cloudwatch exporter)
      expr: 600 < aws_dynamodb_consumed_write_capacity_units_sum
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0609"
        jp1_pc_metricname: "aws_dynamodb_consumed_write_capacity_units_sum"
      annotations:
        jp1_pc_firing_description: "消費された書き込み容量ユニットの合計数がしきい値(600個)を上回りました。value={{ $value }}個"
        jp1_pc_resolved_description: "消費された書き込み容量ユニットの合計数がしきい値(600個)を下回りました。"

aws_states_execution_time_average※

groups:
  - name: yet_another_cloudwatch_exporter
    rules:
    - alert: aws_states_execution_time_average(Yet another cloudwatch exporter)
      expr: 5000 < aws_states_execution_time_average
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0610"
        jp1_pc_metricname: "aws_states_execution_time_average"
      annotations:
        jp1_pc_firing_description: "Step Functionsの実行時間がしきい値(5000ミリ秒)を上回りました。value={{ $value }}ミリ秒"
        jp1_pc_resolved_description: "Step Functionsの実行時間がしきい値(5000ミリ秒)を下回りました。"

aws_states_executions_failed_sum※

groups:
  - name: yet_another_cloudwatch_exporter
    rules:
    - alert: aws_states_executions_failed_sum(Yet another cloudwatch exporter)
      expr: 0 < aws_states_executions_failed_sum
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0611"
        jp1_pc_metricname: "aws_states_executions_failed_sum"
      annotations:
        jp1_pc_firing_description: "Step Functionsの実行失敗数がしきい値(0個)を上回りました。value={{ $value }}個"
        jp1_pc_resolved_description: "Step Functionsの実行失敗数がしきい値(0個)を下回りました。"

aws_sqs_approximate_number_of_messages_delayed_sum※

groups:
  - name: yet_another_cloudwatch_exporter
    rules:
    - alert: aws_sqs_approximate_number_of_messages_delayed_sum(Yet another cloudwatch exporter)
      expr: 0 < aws_sqs_approximate_number_of_messages_delayed_sum
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0612"
        jp1_pc_metricname: "aws_sqs_approximate_number_of_messages_delayed_sum"
      annotations:
        jp1_pc_firing_description: "遅延キューメッセージ数がしきい値(0個)を上回りました。value={{ $value }}個"
        jp1_pc_resolved_description: "遅延キューメッセージ数がしきい値(0個)を下回りました。"

aws_sqs_number_of_messages_deleted_sum※

groups:
  - name: yet_another_cloudwatch_exporter
    rules:
    - alert: aws_sqs_number_of_messages_deleted_sum(Yet another cloudwatch exporter)
      expr:  0 < aws_sqs_number_of_messages_deleted_sum
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0613"
        jp1_pc_metricname: "aws_sqs_number_of_messages_deleted_sum"
      annotations:
        jp1_pc_firing_description: "削除キューメッセージ数がしきい値(0個)を上回りました。value={{ $value }}個"
        jp1_pc_resolved_description: "削除キューメッセージ数がしきい値(0個)を下回りました。"

aws_ecs_cpuutilization_average※

groups:
  - name: yet_another_cloudwatch_exporter
    rules:
    - alert: aws_ecs_cpuutilization_average(Yet another cloudwatch exporter)
      expr: 80 < aws_ecs_cpuutilization_average
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0614"
        jp1_pc_metricname: "aws_ecs_cpuutilization_average"
      annotations:
        jp1_pc_firing_description: "CPU使用率がしきい値(80%)を上回りました。value={{ $value }}%"
        jp1_pc_resolved_description: "CPU使用率がしきい値(80%)を下回りました。

aws_ecs_memory_utilization_average※

groups:
  - name: yet_another_cloudwatch_exporter
    rules:
    - alert: aws_ecs_memory_utilization_average(Yet another cloudwatch exporter)
      expr: 80 < aws_ecs_memory_utilization_average
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0615"
        jp1_pc_metricname: "aws_ecs_memory_utilization_average"
      annotations:
        jp1_pc_firing_description: "メモリ使用率がしきい値(80%)を上回りました。value={{ $value }}%"
        jp1_pc_resolved_description: "メモリ使用率がしきい値(80%)を下回りました。"

aws_rds_cpuutilization_average※

groups:
  - name: yet_another_cloudwatch_exporter
    rules:
    - alert: aws_rds_cpuutilization_average(Yet another cloudwatch exporter)
      expr: 80 < aws_rds_cpuutilization_average
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0616"
        jp1_pc_metricname: "aws_rds_cpuutilization_average"
      annotations:
        jp1_pc_firing_description: "CPU使用率がしきい値(80%)を上回りました。value={{ $value }}%"
        jp1_pc_resolved_description: "CPU使用率がしきい値(80%)を下回りました。"

aws_sns_number_of_notifications_failed_sum※

groups:
  - name: yet_another_cloudwatch_exporter
    rules:
    - alert: aws_sns_number_of_notifications_failed_sum(Yet another cloudwatch exporter)
      expr: 0 < aws_sns_number_of_notifications_failed_sum
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0617"
        jp1_pc_metricname: "aws_sns_number_of_notifications_failed_sum"
      annotations:
        jp1_pc_firing_description: "失敗したメッセージ数がしきい値(0個)を上回りました。value={{ $value }}個"
        jp1_pc_resolved_description: "失敗したメッセージ数がしきい値(0個)を下回りました。"

aws_sns_number_of_notifications_filtered_out_sum※

groups:
  - name: yet_another_cloudwatch_exporter
    rules:
    - alert: aws_sns_number_of_notifications_filtered_out_sum(Yet another cloudwatch exporter)
      expr: 0 < aws_sns_number_of_notifications_filtered_out_sum
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0618"
        jp1_pc_metricname: "aws_sns_number_of_notifications_filtered_out_sum"
      annotations:
        jp1_pc_firing_description: "拒否されたメッセージ数がしきい値(0個)を上回りました。value={{ $value }}個"
        jp1_pc_resolved_description: "拒否されたメッセージ数がしきい値(0個)を下回りました。"

注※

複数のアラートを同一の監視エージェントホストで定義する場合，「groups:」を重複して指定したり，同じグループ名を指定したnameを重複して指定したりしないように注意してください。

■「Promitorのメトリック定義ファイル」のメトリックのアラート定義例

azure_virtual_machine_disk_read_bytes_total※

groups:
  - name: promitor
    rules:
    - alert: azure_virtual_machine_disk_read_bytes_total(Promitor)
      expr: 10485760 < azure_virtual_machine_disk_read_bytes_total
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/AZURE/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0901"
        jp1_pc_metricname: "azure_virtual_machine_disk_read_bytes_total"
      annotations:
        jp1_pc_firing_description: "ディスク読み取りバイトがしきい値(10485760byte)を上回りました。value={{ $value }}byte"
        jp1_pc_resolved_description: "ディスク読み取りバイトがしきい値(10485760byte)を下回りました。"

azure_virtual_machine_disk_write_bytes_total※

groups:
  - name: promitor
    rules:
    - alert: azure_virtual_machine_disk_write_bytes_total(Promitor)
      expr: 10485760 < azure_virtual_machine_disk_write_bytes_total
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/AZURE/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0902"
        jp1_pc_metricname: "azure_virtual_machine_disk_write_bytes_total"
      annotations:
        jp1_pc_firing_description: "ディスク書き込みバイトがしきい値(10485760byte)を上回りました。value={{ $value }}byte"
        jp1_pc_resolved_description: "ディスク書き込みバイトがしきい値(10485760byte)を下回りました。"

azure_virtual_machine_percentage_cpu_average※

groups:
  - name: promitor
    rules:
    - alert: azure_virtual_machine_percentage_cpu_average(Promitor)
      expr: 80 < azure_virtual_machine_percentage_cpu_average
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/AZURE/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0903"
        jp1_pc_metricname: "azure_virtual_machine_percentage_cpu_average"
      annotations:
        jp1_pc_firing_description: "割り当てコンピューティングユニットの割合がしきい値(80%)を上回りました。value={{ $value }}%"
        jp1_pc_resolved_description: "割り当てコンピューティングユニットの割合がしきい値(80%)を下回りました。"

azure_blob_storage_availability_average※

groups:
  - name: promitor
    rules:
    - alert: azure_blob_storage_availability_average(Promitor)
      expr: 100 > azure_blob_storage_availability_average
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/AZURE/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0904"
        jp1_pc_metricname: "azure_blob_storage_availability_average"
      annotations:
        jp1_pc_firing_description: "可用性の割合がしきい値(100%)を下回りました。value={{ $value }}%"
        jp1_pc_resolved_description: "可用性の割合がしきい値(100%)を上回りました。"

azure_blob_storage_blob_capacity_average※

groups:
  - name: promitor
    rules:
    - alert: azure_blob_storage_blob_capacity_average(Promitor)
      expr: 1099511627776 < azure_blob_storage_blob_capacity_average
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/AZURE/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0905"
        jp1_pc_metricname: "azure_blob_storage_blob_capacity_average"
      annotations:
        jp1_pc_firing_description: "ストレージ量がしきい値(1099511627776byte)を上回りました。value={{ $value }}byte"
        jp1_pc_resolved_description: "ストレージ量がしきい値(1099511627776byte)を下回りました。"

azure_function_app_http5xx_total※

groups:
  - name: promitor
    rules:
    - alert: azure_function_app_http5xx_total(Promitor)
      expr: 0 < azure_function_app_http5xx_total
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/AZURE/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0906"
        jp1_pc_metricname: "azure_function_app_http5xx_total"
      annotations:
        jp1_pc_firing_description: "5xxサーバエラー数がしきい値(0個)を上回りました。value={{ $value }}個"
        jp1_pc_resolved_description: "5xxサーバエラー数がしきい値(0個)を下回りました。"

azure_function_app_http_response_time_average※

groups:
  - name: promitor
    rules:
    - alert: azure_function_app_http_response_time_average(Promitor)
      expr: 0 < azure_function_app_http_response_time_average
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/AZURE/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0907"
        jp1_pc_metricname: "azure_function_app_http_response_time_average"
      annotations:
        jp1_pc_firing_description: "応答時間がしきい値(5秒)を上回りました。value={{ $value }}秒"
        jp1_pc_resolved_description: "応答時間がしきい値(5秒)を下回りました。"

azure_cosmos_db_total_request_units_total※

groups:
  - name: promitor
    rules:
    - alert: azure_cosmos_db_total_request_units_total(Promitor)
      expr: 600 < azure_cosmos_db_total_request_units_total
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/AZURE/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0908"
        jp1_pc_metricname: "azure_cosmos_db_total_request_units_total"
      annotations:
        jp1_pc_firing_description: "消費された要求ユニットがしきい値(600個)を上回りました。value={{ $value }}個, collectionname={{ $labels.collectionname }}"
        jp1_pc_resolved_description: "消費された要求ユニットがしきい値(600個)を下回りました。collectionname={{ $labels.collectionname }}"

azure_logic_app_runs_failed_total※

groups:
  - name: promitor
    rules:
    - alert: azure_logic_app_runs_failed_total(Promitor)
      expr: 0 < azure_logic_app_runs_failed_total
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/AZURE/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0910"
        jp1_pc_metricname: "azure_logic_app_runs_failed_total"
      annotations:
        jp1_pc_firing_description: "ワークフロー実行失敗数がしきい値(0個)を上回りました。value={{ $value }}個"
        jp1_pc_resolved_description: "ワークフロー実行失敗数がしきい値(0個)を下回りました。"

azure_container_instance_cpu_usage_average※

groups:
  - name: promitor
    rules:
    - alert: azure_container_instance_cpu_usage_average(Promitor)
      expr: 800 < azure_container_instance_cpu_usage_average
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/AZURE/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0911"
        jp1_pc_metricname: "azure_container_instance_cpu_usage_average"
      annotations:
        jp1_pc_firing_description: "CPU使用率(ミリコア)がしきい値(800個)を上回りました。value={{ $value }}個"
        jp1_pc_resolved_description: "CPU使用率(ミリコア)がしきい値(800個)を下回りました。"

azure_kubernetes_service_kube_pod_status_phase_average_failed※

groups:
  - name: promitor
    rules:
    - alert: azure_kubernetes_service_kube_pod_status_phase_average_failed(Promitor)
      expr: 0 < azure_kubernetes_service_kube_pod_status_phase_average_failed
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/AZURE/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0912"
        jp1_pc_metricname: "azure_kubernetes_service_kube_pod_status_phase_average_failed"
      annotations:
        jp1_pc_firing_description: "Failedポッド数がしきい値(0個)を上回りました。value={{ $value }}個"
        jp1_pc_resolved_description: "Failedポッド数がしきい値(0個)を下回りました。"

azure_kubernetes_service_kube_pod_status_phase_average_pending※

groups:
  - name: promitor
    rules:
    - alert: azure_kubernetes_service_kube_pod_status_phase_average_pending(Promitor)
      expr: 0 < azure_kubernetes_service_kube_pod_status_phase_average_pending
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/AZURE/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0913"
        jp1_pc_metricname: "azure_kubernetes_service_kube_pod_status_phase_average_pending"
      annotations:
        jp1_pc_firing_description: "Pendingポッド数がしきい値(0個)を上回りました。value={{ $value }}個"
        jp1_pc_resolved_description: "Pendingポッド数がしきい値(0個)を下回りました。"

azure_kubernetes_service_kube_pod_status_phase_average_unknown※

groups:
  - name: promitor
    rules:
    - alert: azure_kubernetes_service_kube_pod_status_phase_average_unknown(Promitor)
      expr: 0 < azure_kubernetes_service_kube_pod_status_phase_average_unknown
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/AZURE/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0914"
        jp1_pc_metricname: "azure_kubernetes_service_kube_pod_status_phase_average_unknown"
      annotations:
        jp1_pc_firing_description: "Unoknownポッド数がしきい値(0個)を上回りました。value={{ $value }}個"
        jp1_pc_resolved_description: "Unoknownポッド数がしきい値(0個)を下回りました。"

azure_file_storage_availability_average※

groups:
  - name: promitor
    rules:
    - alert: azure_file_storage_availability_average(Promitor)
      expr: 100 > azure_file_storage_availability_average
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/AZURE/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0915"
        jp1_pc_metricname: "azure_file_storage_availability_average"
      annotations:
        jp1_pc_firing_description: "可用性の割合がしきい値(100%)を下回りました。value={{ $value }}%, fileshare={{ $labels.fileshare }}"
        jp1_pc_resolved_description: "可用性の割合がしきい値(100%)を上回りました。fileshare={{ $labels.fileshare }}"

azure_service_bus_namespace_deadlettered_messages_average※

groups:
  - name: promitor
    rules:
    - alert: azure_service_bus_namespace_deadlettered_messages_average(Promitor)
      expr: 0 < azure_service_bus_namespace_deadlettered_messages_average
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/AZURE/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0916"
        jp1_pc_metricname: "azure_service_bus_namespace_deadlettered_messages_average"
      annotations:
        jp1_pc_firing_description: "配信不能メッセージ数がしきい値(0個)を上回りました。value={{ $value }}個, entity_name={{ $labels.entity_name }}"
        jp1_pc_resolved_description: "配信不能メッセージ数がしきい値(0個)を下回りました。entity_name={{ $labels.entity_name }}"

azure_sql_database_cpu_percent_average※

groups:
  - name: promitor
    rules:
    - alert: azure_sql_database_cpu_percent_average(Promitor)
      expr: 80 < azure_sql_database_cpu_percent_average
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/AZURE/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0917"
        jp1_pc_metricname: "azure_sql_database_cpu_percent_average"
      annotations:
        jp1_pc_firing_description: "CPU割合がしきい値(80%)を上回りました。value={{ $value }}%, server={{ $labels.server }}"
        jp1_pc_resolved_description: "CPU割合がしきい値(80%)を下回りました。 server={{ $labels.server }}"

azure_sql_elastic_pool_cpu_percent_average※

groups:
  - name: promitor
    rules:
    - alert: azure_sql_elastic_pool_cpu_percent_average(Promitor)
      expr: 80 < azure_sql_elastic_pool_cpu_percent_average
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/AZURE/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0920"
        jp1_pc_metricname: "azure_sql_elastic_pool_cpu_percent_average"
      annotations:
        jp1_pc_firing_description: "CPU割合がしきい値(80%)を上回りました。value={{ $value }}%, server={{ $labels.server }}"
        jp1_pc_resolved_description: "CPU割合がしきい値(80%)を下回りました。 server={{ $labels.server }}"

azure_sql_managed_instance_avg_cpu_percent_average※

groups:
  - name: promitor
    rules:
    - alert: azure_sql_managed_instance_avg_cpu_percent_average(Promitor)
      expr: 80 < azure_sql_managed_instance_avg_cpu_percent_average
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/AZURE/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0922"
        jp1_pc_metricname: "azure_sql_managed_instance_avg_cpu_percent_average"
      annotations:
        jp1_pc_firing_description: "平均CPU割合がしきい値(80%)を上回りました。value={{ $value }}%"
        jp1_pc_resolved_description: "平均CPU割合がしきい値(80%)を下回りました。"

azure_sql_managed_instance_io_bytes_read_average※

groups:
  - name: promitor
    rules:
    - alert: azure_sql_managed_instance_io_bytes_read_average(Promitor)
      expr: 10485760 < azure_sql_managed_instance_io_bytes_read_average
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/AZURE/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0923"
        jp1_pc_metricname: "azure_sql_managed_instance_io_bytes_read_average"
      annotations:
        jp1_pc_firing_description: "読み取りIOバイトがしきい値(10485760byte)を上回りました。value={{ $value }}byte"
        jp1_pc_resolved_description: "読み取りIOバイトがしきい値(10485760byte)を下回りました。"

azure_sql_managed_instance_io_bytes_written_average※

groups:
  - name: promitor
    rules:
    - alert: azure_sql_managed_instance_io_bytes_written_average(Promitor)
      expr: 10485760 < azure_sql_managed_instance_io_bytes_written_average
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/AZURE/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0924"
        jp1_pc_metricname: "azure_sql_managed_instance_io_bytes_written_average"
      annotations:
        jp1_pc_firing_description: "書き込みIOバイトがしきい値(10485760byte)を上回りました。value={{ $value }}byte"
        jp1_pc_resolved_description: "書き込みIOバイトがしきい値(10485760byte)を下回りました。"

注※

複数のアラートを同一の統合エージェントホストで定義する場合，「groups:」を重複して指定したり，同じグループ名を指定したnameを重複して指定したりしないように注意してください。

■「Script exporterのメトリック定義ファイル」のメトリックのアラート定義例

azure_virtual_machine_disk_read_bytes_total※1

groups:
  - name: script_exporter
    rules:
    - alert: script_success(Script exporter)
      expr: 0 == script_success
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "1401"
        jp1_pc_metricname: "script_success"
      annotations:
        jp1_pc_firing_description: "スクリプトの実行に失敗しました。value={{ $value }}"
        jp1_pc_resolved_description: "スクリプトの実行に成功しました。"

script_duration_seconds※1※2

groups:
  - name: script_exporter
    rules:
    - alert: script_duration_seconds(Script exporter)
      expr: 60 < script_duration_seconds
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "1402"
        jp1_pc_metricname: "script_duration_seconds"
      annotations:
        jp1_pc_firing_description: "スクリプトの実行時間がしきい値(60秒)を上回りました。value={{ $value }}秒"
        jp1_pc_resolved_description: "スクリプトの実行時間がしきい値(60秒)を下回りました。"

script_exit_code※1

groups:
  - name: script_exporter
    rules:
    - alert: script_exit_code(Script exporter)
      expr: 0 != script_exit_code
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "1403"
        jp1_pc_metricname: "script_exit_code"
      annotations:
        jp1_pc_firing_description: "スクリプトの実行に失敗しました。value={{ $value }}"
        jp1_pc_resolved_description: "スクリプトの実行に成功しました。"

注※1

複数のアラートを同一の統合エージェントホストで定義する場合，「groups:」を重複して指定したり，同じグループ名を指定したnameを重複して指定したりしないように注意してください。

注※2

しきい値が60の例です。値は監視対象に合わせて変更してください。

■「OracleDB exporterのメトリック定義ファイル」のメトリックのアラート定義例

oracledb_up※

groups:
  - name: oracledb_exporter
    rules:
    - alert: oracledb_down(OracleDB exporter)
      expr: oracledb_up != 1
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0801"
        jp1_pc_metricname: "oracledb_up"
      annotations:
        jp1_pc_firing_description: "OracleDBが停止しました。instance={{ $labels.instance }}"
        jp1_pc_resolved_description: "OracleDBが起動しました。instance={{ $labels.instance }}"

cache_hit_ratio_percent※

groups:
  - name: oracledb_exporter
    rules:
    - alert: cache_hit_ratio_percentage_under_60(OracleDB exporter)
      expr: (1 - (rate(oracledb_activity_physical_reads_cache[2m]) / (rate(oracledb_activity_consistent_gets_from_cache[2m])+rate(oracledb_activity_db_block_gets_from_cache[2m]))))*100  < 60
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0802"
        jp1_pc_metricname: "oracledb_activity_physical_reads_cache,oracledb_activity_consistent_gets_from_cache,oracledb_activity_db_block_gets_from_cache"
      annotations:
        jp1_pc_firing_description: "OracleDBのキャッシュヒット率が60%を下回りました。instance={{ $labels.instance }}, value={{ $value }}"
        jp1_pc_resolved_description: "OracleDBのキャッシュヒット率が60%以上になりました。instance={{ $labels.instance }}"

tablespace_used_percent※

groups:
  - name: oracledb_exporter
    rules:
    - alert: oracledb_tablespace_used_percent_over_90(OracleDB exporter)
      expr: oracledb_tablespace_used_percent > 90
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0803"
        jp1_pc_metricname: "oracledb_tablespace_used_percent"
      annotations:
        jp1_pc_firing_description: "OracleDBの表領域の使用量が90%を超えました。instance={{ $labels.instance }}, value={{ $value }}"
        jp1_pc_resolved_description: "OracleDBの表領域の使用量が90%以下になりました。instance={{ $labels.instance }}"

execute_count※

groups:
  - name: oracledb_exporter
    rules:
    - alert: oracledb_activity_execute_count_over_1000(OracleDB exporter)
      expr: rate(oracledb_activity_execute_count[2m])*60 > 1000
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "0804"
        jp1_pc_metricname: "oracledb_activity_execute_count"
      annotations:
        jp1_pc_firing_description: "SQL文の実行回数が1000回を超えました。instance={{ $labels.instance }}, value={{ $value }}"
        jp1_pc_resolved_description: "SQL文の実行回数が1000回を下回りました。instance={{ $labels.instance }}"

parse_count※

execute_countを参考に作成してください。

user_commit_count※

execute_countを参考に作成してください。

user_rollback_count※

execute_countを参考に作成してください。

resource_used※

tablespace_used_percentを参考に作成してください。

session_count※

tablespace_used_percentを参考に作成してください。

注※

複数のアラートを同一の監視エージェントホストで定義する場合，「groups:」を重複して指定したり，同じグループ名を指定したnameを重複して指定したりしないように注意してください。

■「コンテナ監視のメトリック定義ファイル」のメトリックのアラート定義例

kube_job_status_failed※

groups:
 - name: kube_state_metrics
  rules:
   - alert: kube_job_status_failed(Kube state metrics)
     expr: 0 < kube_job_status_failed * on(job_name, namespace) group_left() kube_job_owner{owner_kind="<none>", owner_name="<none>"}
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/KUBERNETES/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "1201"
        jp1_pc_metricname: "kube_job_status_failed, kube_job_owner"
        jp1_pc_nodelabel: "{{ $labels.namespace }}"
        jp1_pc_exporter: "JPC Kube state metrics"
        jp1_pc_trendname: "kubernetes"
        job: "jpc_kube_state"
      annotations:
        jp1_pc_firing_description: "失敗したポッド数がしきい値(0個)を上回りました。value={{ $value }}個, job_name={{ $labels.job_name }}"
        jp1_pc_resolved_description: "失敗したポッド数がしきい値(0個)を下回りました。job_name={{ $labels.job_name }}"

kube_pod_status_pending※

groups:
 - name: kube_state_metrics
  rules:
   - alert: kube_pod_status_pending(Kube state metrics)
     expr: 0 < sum by (pod, namespace, instance, job) (kube_pod_status_phase{phase="Pending"})
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/KUBERNETES/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "1202"
        jp1_pc_metricname: "kube_pod_status_pending"
        jp1_pc_nodelabel: "{{ $labels.namespace }}"
        jp1_pc_exporter: "JPC Kube state metrics"
        jp1_pc_trendname: "kubernetes"
        job: "jpc_kube_state"
      annotations:
        jp1_pc_firing_description: "Pendingポッド数がしきい値(0個)を上回りました。value={{ $value }}個, pod={{ $labels.pod }}"
        jp1_pc_resolved_description: "Pendingポッド数がしきい値(0個)を下回りました。pod={{ $labels.pod }}"

kube_pod_status_failed※

groups:
 - name: kube_state_metrics
  rules:
   - alert: kube_pod_status_failed(Kube state metrics)
     expr: 0 < sum by (pod, namespace, instance, job) (kube_pod_status_phase{phase="Failed"}
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/KUBERNETES/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "1203"
        jp1_pc_metricname: "kube_pod_status_phase"
        jp1_pc_nodelabel: "{{ $labels.namespace }}"
        jp1_pc_exporter: "JPC Kube state metrics"
        jp1_pc_trendname: "kubernetes"
        job: "jpc_kube_state"
      annotations:
        jp1_pc_firing_description: "Failedポッド数がしきい値(0個)を上回りました。value={{ $value }}個, pod={{ $labels.pod }}"
        jp1_pc_resolved_description: "Failedポッド数がしきい値(0個)を下回りました。pod={{ $labels.pod }}"

kube_pod_status_unknown※

groups:
 - name: kube_state_metrics
  rules:
   - alert: kube_pod_status_unknown(Kube state metrics)
     expr: 0 < sum by (pod, namespace, instance) (kube_pod_status_phase{phase="Unknown"}
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/KUBERNETES/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "1204"
        jp1_pc_metricname: "kube_pod_status_phase"
        jp1_pc_nodelabel: "{{ $labels.namespace }}"
        jp1_pc_exporter: "JPC Kube state metrics"
        jp1_pc_trendname: "kubernetes"
        job: "jpc_kube_state"
      annotations:
        jp1_pc_firing_description: "Unknownポッド数がしきい値(0個)を上回りました。value={{ $value }}個, pod={{ $labels.pod }}"
        jp1_pc_resolved_description: "Unknownポッド数がしきい値(0個)を下回りました。pod={{ $labels.pod }}"

kube_daemonset_failed_number_scheduled※

groups:
 - name: kube_state_metrics
  rules:
   - alert: kube_daemonset_failed_number_scheduled(Kube state metrics)
     expr: 0 < kube_daemonset_status_desired_number_scheduled - kube_daemonset_status_current_number_scheduled
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/KUBERNETES/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "1205"
        jp1_pc_metricname: "kube_daemonset_status_desired_number_scheduled, kube_daemonset_status_current_number_scheduled"
        jp1_pc_nodelabel: "{{ $labels.daemonset }}"
        jp1_pc_exporter: "JPC Kube state metrics"
        jp1_pc_trendname: "kubernetes"
        job: "jpc_kube_state"
      annotations:
        jp1_pc_firing_description: "実行に失敗したノード数がしきい値(0個)を上回りました。value={{ $value }}個"
        jp1_pc_resolved_description: "実行に失敗したノード数がしきい値(0個)を下回りました。"

kube_deployment_failed_replicas※

groups:
 - name: kube_state_metrics
  rules:
   - alert: kube_deployment_failed_replicas(Kube state metrics)
     expr: 0 < kube_deployment_spec_replicas - kube_deployment_status_replicas_available
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/KUBERNETES/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "1206"
        jp1_pc_metricname: "kube_deployment_spec_replicas, kube_deployment_status_replicas_available"
        jp1_pc_nodelabel: "{{ $labels.deployment }}"
        jp1_pc_exporter: "JPC Kube state metrics"
        jp1_pc_trendname: "kubernetes"
        job: "jpc_kube_state"
      annotations:
        jp1_pc_firing_description: "デプロイ毎の実行に失敗したポッド数がしきい値(0個)を上回りました。value={{ $value }}個"
        jp1_pc_resolved_description: "デプロイ毎の実行に失敗したポッド数がしきい値(0個)を下回りました。"

kube_replicaset_failed_replicas※

groups:
 - name: kube_state_metrics
  rules:
   - alert: kube_replicaset_failed_replicas(Kube state metrics)
     expr: 0 < kube_replicaset_spec_replicas - kube_replicaset_status_ready_replicas
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/KUBERNETES/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "1207"
        jp1_pc_metricname: "kube_replicaset_spec_replicas, kube_replicaset_status_ready_replicas"
        jp1_pc_nodelabel: "{{ $labels.replicaset }}"
        jp1_pc_exporter: "JPC Kube state metrics"
        jp1_pc_trendname: "kubernetes"
        job: "jpc_kube_state"
      annotations:
        jp1_pc_firing_description: "ReplicaSet毎の実行に失敗したポッド数がしきい値(0個)を上回りました。value={{ $value }}個"
        jp1_pc_resolved_description: "ReplicaSet毎の実行に失敗したポッド数がしきい値(0個)を下回りました。"

kube_statefulset_failed_replicas※

groups:
 - name: kube_state_metrics
  rules:
   - alert: kube_statefulset_failed_replicas(Kube state metrics)
     expr: 0 < kube_statefulset_replicas - kube_statefulset_status_replicas_ready
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/KUBERNETES/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "1208"
        jp1_pc_metricname: "kube_statefulset_replicas, kube_statefulset_status_replicas_ready"
        jp1_pc_nodelabel: "{{ $labels.statefulset }}"
        jp1_pc_exporter: "JPC Kube state metrics"
        jp1_pc_trendname: "kubernetes"
        job: "jpc_kube_state"
      annotations:
        jp1_pc_firing_description: "デプロイ毎の実行に失敗したポッド数がしきい値(0個)を上回りました。value={{ $value }}個"
        jp1_pc_resolved_description: "デプロイ毎の実行に失敗したポッド数がしきい値(0個)を下回りました。"

kube_cron_job_status_failed※

groups:
 - name: kube_state_metrics
  rules:
   - alert: kube_cron_job_status_failed(Kube state metrics)
     expr: 0 < kube_job_status_failed * on(job_name, namespace) group_left(owner_name) kube_job_owner{owner_kind="CronJob", owner_name!="<none>"}
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/KUBERNETES/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "1209"
        jp1_pc_metricname: "kube_job_status_failed, kube_job_owner"
        jp1_pc_nodelabel: "{{ $labels.owner_name }}"
        jp1_pc_exporter: "JPC Kube state metrics"
        jp1_pc_trendname: "kubernetes"
        job: "jpc_kube_state"
      annotations:
        jp1_pc_firing_description: "CronJob内で実行に失敗したポッドの数がしきい値(0個)を上回りました。value={{ $value }}%"
        jp1_pc_resolved_description: "CronJob内で実行に失敗したポッドの数がしきい値(0個)を下回りました。"

kube_node_status_condition_not_ready※

groups:
 - name: kube_state_metrics
  rules:
   - alert: kube_node_status_condition_not_ready(Kube state metrics)
     expr: 1 == sum by (node, instance) (kube_node_status_condition{condition="Ready",status=~"false|unknown"})
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/KUBERNETES/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "1210"
        jp1_pc_metricname: "kube_node_status_condition"
        jp1_pc_nodelabel: "{{ $labels.node }}"
        jp1_pc_exporter: "JPC Kube state metrics"
        jp1_pc_trendname: "kubernetes"
        job: "jpc_kube_state"
      annotations:
        jp1_pc_firing_description: "ノードが異常状態です。value={{ $value }}個"
        jp1_pc_resolved_description: "ノードが異常状態でなくなりました。"

kube_node_status_condition_memory_pressure※

groups:
 - name: kube_state_metrics
  rules:
   - alert: kube_node_status_condition_memory_pressure(Kube state metrics)
     expr: 1 == sum by (node, instance) (kube_node_status_condition{condition="MemoryPressure",status~="true|unknown"}})
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/KUBERNETES/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "1211"
        jp1_pc_metricname: "kube_node_status_condition"
        jp1_pc_nodelabel: "{{ $labels.node }}"
        jp1_pc_exporter: "JPC Kube state metrics"
        jp1_pc_trendname: "kubernetes"
        job: "jpc_kube_state"
      annotations:
        jp1_pc_firing_description: "ノードがメモリ圧迫状態です。value={{ $value }}個"
        jp1_pc_resolved_description: "ノードがメモリ圧迫状態でなくなりました。"

kube_node_status_condition_disk_pressure※

groups:
 - name: kube_state_metrics
  rules:
   - alert: kube_node_status_condition_disk_pressure(Kube state metrics)
     expr: 1 == sum by (node, instance) (kube_node_status_condition{condition="DiskPressure",status=~"true|unknown"})
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/KUBERNETES/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "1212"
        jp1_pc_metricname: "kube_node_status_condition"
        jp1_pc_nodelabel: "{{ $labels.node }}"
        jp1_pc_exporter: "JPC Kube state metrics"
        jp1_pc_trendname: "kubernetes"
        job: "jpc_kube_state"
      annotations:
        jp1_pc_firing_description: "ノードがディスク圧迫状態です。value={{ $value }}個"
        jp1_pc_resolved_description: "ノードがディスク圧迫状態でなくなりました。"

kube_node_status_condition_pid_pressure※

groups:
 - name: kube_state_metrics
  rules:
   - alert: kube_node_status_condition_pid_pressure(Kube state metrics)
     expr: 1 == sum by (node, instance) (kube_node_status_condition{condition="PIDPressure",status=~"true|unknown"})
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/KUBERNETES/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "1213"
        jp1_pc_metricname: "kube_node_status_condition"
        jp1_pc_nodelabel: "{{ $labels.node }}"
        jp1_pc_exporter: "JPC Kube state metrics"
        jp1_pc_trendname: "kubernetes"
        job: "jpc_kube_state"
      annotations:
        jp1_pc_firing_description: "ノードがPID割り当て圧迫状態です。value={{ $value }}個"
        jp1_pc_resolved_description: "ノードがPID割り当て圧迫状態でなくなりました。"

kube_namespace_cpu_percent_used※

groups:
 - name: kubelet
  rules:
   - alert: kube_namespace_cpu_percent_used(Kubelet)
     expr: 80 < sum by (namespace, job) (rate(container_cpu_usage_seconds_total{name!=""}[2m])) * 100
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/KUBERNETES/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "1222"
        jp1_pc_metricname: "container_cpu_usage_seconds_total"
        jp1_pc_nodelabel: "{{ $externalLabels.jp1_pc_prome_clustername }}"
        jp1_pc_exporter: "JPC Kubelet"
        jp1_pc_trendname: "kubernetes"
        job: "jpc_kubelet"
        instance: "{{ $externalLabels.jp1_pc_prome_hostname }}"
      annotations:
        jp1_pc_firing_description: "CPU使用率がしきい値(80%)を上回りました。value={{ $value }}%, namespace={{ $labels.namespace }}"
        jp1_pc_resolved_description: "CPU使用率がしきい値(80%)を下回りました。namespace={{ $labels.namespace }}"

kube_namespace_memory_percent_used※

groups:
 - name: kubelet
  rules:
   - alert: kube_namespace_memory_percent_used(Kubelet)
     expr: 80 < sum by (namespace, job) (container_memory_working_set_bytes and (container_spec_memory_limit_bytes{name!=""} > 0)) / sum by (namespace, job) ((container_spec_memory_limit_bytes{name!=""} > 0) and container_memory_working_set_bytes) * 100
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/KUBERNETES/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "1223"
        jp1_pc_metricname: "container_memory_working_set_bytes, container_spec_memory_limit_bytes"
        jp1_pc_nodelabel: "{{ $externalLabels.jp1_pc_prome_clustername }}"
        jp1_pc_exporter: "JPC Kubelet"
        jp1_pc_trendname: "kubernetes"
        job: "jpc_kubelet"
        instance: "{{ $externalLabels.jp1_pc_prome_hostname }}"
      annotations:
        jp1_pc_firing_description: "メモリ使用率がしきい値(80%)を上回りました。value={{ $value }}%, namespace={{ $labels.namespace }}"
        jp1_pc_resolved_description: "メモリ使用率がしきい値(80%)を下回りました。namespace={{ $labels.namespace }}"

kube_pod_cpu_percent_used_pod※

groups:
 - name: kubelet
  rules:
   - alert: kube_pod_cpu_percent_used_pod(Kubelet)
     expr: 80 < sum by (pod, namespace, instance, job) (rate(container_cpu_usage_seconds_total{name!=""}[2m])) * 100
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/KUBERNETES/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "1220"
        jp1_pc_metricname: "container_cpu_usage_seconds_total"
        jp1_pc_nodelabel: "{{ $labels.pod }}"
        jp1_pc_exporter: "JPC Kubelet"
        jp1_pc_trendname: "kubernetes"
        job: "jpc_kubelet"
      annotations:
        jp1_pc_firing_description: "CPU使用率がしきい値(80%)を上回りました。value={{ $value }}%, pod={{ $labels.pod }}"
        jp1_pc_resolved_description: "CPU使用率がしきい値(80%)を下回りました。pod={{ $labels.pod }}"

kube_pod_memory_percent_used※

groups:
 - name: kubelet
  rules:
   - alert: kube_pod_cpu_percent_used_pod(Kubelet)
     expr: 80 < sum by (pod, namespace, instance, job) (container_memory_working_set_bytes and (container_spec_memory_limit_bytes{name!=""} > 0)) / sum by (pod, namespace, instance, job) ((container_spec_memory_limit_bytes{name!=""} > 0) and container_memory_working_set_bytes) * 100
      for: 3m
      labels:
        jp1_pc_product_name: "/HITACHI/JP1/JPCCS2"
        jp1_pc_component: "/HITACHI/JP1/JPCCS/KUBERNETES/CONFINFO"
        jp1_pc_severity: "Error"
        jp1_pc_eventid: "1221"
        jp1_pc_metricname: "container_memory_working_set_bytes, container_spec_memory_limit_bytes"
        jp1_pc_nodelabel: "{{ $labels.pod }}"
        jp1_pc_exporter: "JPC Kubelet"
        jp1_pc_trendname: "kubernetes"
        job: "jpc_kubelet"
      annotations:
        jp1_pc_firing_description: "メモリ使用率がしきい値(80%)を上回りました。value={{ $value }}%, pod={{ $labels.pod }}"
        jp1_pc_resolved_description: "メモリ使用率がしきい値(80%)を下回りました。pod={{ $labels.pod }}"

注※

複数のアラートを同一の統合エージェントホストで定義する場合，「groups:」を重複して指定したり，同じグループ名を指定したnameを重複して指定したりしないように注意してください。アラート定義のalertに指定する値は，次の命名規則に従い指定してください。形式が異なる場合，JP1イベントが作成されません。

alert: メトリック定義名(exporter名)任意の値

Node exporterのディスカバリ設定ファイル（jpc_file_sd_config_node.yml）

形式

YAML形式で記述します。

- targets:
  - 監視対象ホスト名:Node exporterのポート番号
  labels:
    jp1_pc_exporter: JPC Node Exporter
    jp1_pc_category: platform
    jp1_pc_trendname: node_exporter
    jp1_pc_multiple_node: "{__name__=~'node_systemd_unit_.*'}"※

注※

JP1/IM - Agent 13-01以降のインストーラーがモデルファイルに設定する，サービス監視を行うためのパラメーターです。

JP1/IM - Agent 13-00から13-01以降にバージョンアップインストールしてサービス監視機能を使用する場合，手動でjp1_pc_multiple_nodeパラメーターを追加します。詳細については，マニュアル「JP1/Integrated Management 3 - Manager 構築ガイド」の「2.19.2(3)(f)サービス監視の設定をする（Linuxの場合）（オプション）」を参照してください。

ファイル

jpc_file_sd_config_node.yml

jpc_file_sd_config_node.yml.model（モデルファイル）

格納先ディレクトリ

■統合エージェントホスト

Linuxの場合

物理ホストのとき

/opt/jp1ima/conf/

論理ホストのとき

共有ディレクトリ/jp1ima/conf/

説明

Prometheus serverがスクレイプするNode exporterを設定するファイルです。

文字コード

UTF-8（BOM無し）

改行コード

LF

定義の反映時期

Prometheus serverのリロードAPIを実行，または，再起動したとき，Prometheus serverがスクレイプする対象となります。そのあと，jddcreatetreeコマンドおよびjddupdatetreeコマンドを実行したとき，統合オペレーション・ビューアーのツリーの表示内容に反映されます。

記述内容

- 監視対象ホスト名:Node exporterのポート番号

「監視対象ホスト名:Node exporterのポート番号」を，1〜2,595文字の制御文字以外の文字で指定します。

監視対象ホスト名は必須で指定します。指定した監視対象ホスト名は，監視エージェントのインストールスクリプトで設定されます。FQDN形式も指定できます。

Node exporterのポート番号を初期値から変更している場合は，Node exporterのポート番号の値を変更してください。

Process exporterのディスカバリ設定ファイル（jpc_file_sd_config_process.yml）

形式

YAML形式で記述します。

- targets:
  - インストールホスト名:Process exporterのポート番号
  labels:
    jp1_pc_exporter: JPC Process exporter
    jp1_pc_category: platform
    jp1_pc_trendname: process_exporter
    jp1_pc_multiple_node: "{__name__=~'namedprocess_namegroup_.*'}"
    jp1_pc_agent_create_flag: false

ファイル

jpc_file_sd_config_process.yml

jpc_file_sd_config_process.yml.model（モデルファイル）

格納先ディレクトリ

物理ホストのとき

/opt/jp1ima/conf/

論理ホストのとき

共有ディレクトリ/jp1ima/conf/

説明

Prometheus serverがスクレイプするProcess Exporterを設定するファイルです。

文字コード

UTF-8（BOM無し）

改行コード

LF

定義の反映時期

Prometheus serverのリロードAPIを実行，または，再起動したとき，Prometheus serverがスクレイプする対象となります。そのあと，jddcreatetreeコマンドおよびjddupdatetreeコマンドを実行したとき，統合オペレーション・ビューアーのツリーの表示内容に反映されます。

記述内容

- インストールホスト名:Process exporterのポート番号

インストールホスト名は，統合エージェントのインストールスクリプトで設定されます。FQDN形式も指定できます。

Process exporterのポート番号を初期値から変更している場合，「:」（コロン）のあとのProcess exporterのポート番号の値を変更してください。

「インストールホスト名:Process exporterのポート番号」は，1〜2,574文字の制御文字以外の文字で指定します。

Windows exporterのディスカバリ設定ファイル（jpc_file_sd_config_windows.yml）

形式

YAML形式で記述します。

- targets:
  - 監視対象ホスト名:Windows exporterのポート番号
  labels:
    jp1_pc_exporter: JPC Windows Exporter
    jp1_pc_category: platform
    jp1_pc_trendname: windows_exporter
    jp1_pc_multiple_node: "{__name__=~'windows_process_.*|windows_service_.*'}"※

注※

JP1/IM - Agent 13-01以降のインストーラーがモデルファイルに設定する，プロセス監視とサービス監視を行うためのパラメーターです。

JP1/IM - Agent 13-00から13-01以降にバージョンアップインストールしてサービス監視機能を使用する場合，手動でjp1_pc_multiple_nodeパラメーターを追加します。詳細については，マニュアル「JP1/Integrated Management 3 - Manager 構築ガイド」の「1.21.2(3)(f)サービス監視の設定をする（Windowsの場合）（オプション）」を参照してください。

ファイル

jpc_file_sd_config_windows.yml

jpc_file_sd_config_windows.yml.model（モデルファイル）

格納先ディレクトリ

■統合エージェントホスト

Windowsの場合

物理ホストのとき

Agentパス¥conf¥

論理ホストのとき

共有フォルダ/jp1ima/conf/

説明

Prometheus serverがスクレイプするWindows exporterを設定するファイルです。

文字コード

UTF-8（BOM無し）

改行コード

CR+LF

定義の反映時期

Prometheus serverのリロードAPIを実行，または，再起動したとき，Prometheus serverがスクレイプする対象となります。そのあと，jddcreatetreeコマンドおよびjddupdatetreeコマンドを実行したとき，統合オペレーション・ビューアーのツリーの表示内容に反映されます。

記述内容

- 監視対象ホスト名:Windows exporterのポート番号

「監視対象ホスト名:Windows exporterのポート番号」を，1〜2,595文字の制御文字以外の文字で指定します。

監視対象ホスト名は必須で指定します。指定した監視対象ホスト名は，監視エージェントのインストールスクリプトで設定されます。FQDN形式も指定できます。

Windows exporterのポート番号を初期値から変更している場合は，Windows exporterのポート番号の値を変更してください。

Node exporter for AIXのディスカバリ設定ファイル（jpc_file_sd_config_node_aix.yml）

形式

YAML形式で記述します。

- targets:
  - 監視対象ホスト名:Node exporter for AIXのポート番号
  ・・・
  labels:
    jp1_pc_exporter: JPC Node exporter for AIX
    jp1_pc_category: platform
    jp1_pc_trendname: node_exporter_aix

ファイル

jpc_file_sd_config_node_aix.yml

jpc_file_sd_config_node_aix.yml.model（モデルファイル）

格納先ディレクトリ

■統合エージェントホスト

Windowsの場合

物理ホストのとき

Agentパス¥conf¥

論理ホストのとき

共有フォルダ¥jp1ima¥conf¥

Linuxの場合

物理ホストのとき

/opt/jp1ima/conf/

論理ホストのとき

共有ディレクトリ/jp1ima/conf/

説明

Prometheus serverがスクレイプするNode Exporter for AIXを設定するファイルです。

文字コード

UTF-8（BOM無し）

改行コード

Windowsの場合：CR+LF

Linuxの場合：LF

定義の反映時期

Prometheus serverのリロードAPIを実行，または，再起動したとき，Prometheus serverがスクレイプする対象となります。そのあと，jddcreatetreeコマンドおよびjddupdatetreeコマンドを実行したとき，統合オペレーション・ビューアーのツリーの表示内容に反映されます。

記述内容

監視対象ホスト名

監視対象ホスト（AIX）のホスト名を1〜255文字の制御文字以外の文字で指定します。FQDN形式も指定できます。「localhost」は指定できません。

Node exporter for AIXのポート番号

スクレイプ先のNode exporter for AIXのポート番号を指定します。

定義例

- targets:
  - hostA:20730
  - hostB:20730
  labels:
    jp1_pc_exporter: JPC Node exporter for AIX
    jp1_pc_category: platform
    jp1_pc_trendname: node_exporter_aix

Blackbox exporter（HTTP/HTTPS監視）のディスカバリ設定ファイル（jpc_file_sd_config_blackbox_http.yml）

形式

YAML形式で記述します。

- targets:
  - 監視対象ホスト名:IM管理ノードのラベル名:URL
  ・・・
  labels:
    jp1_pc_exporter: JPC Blackbox Exporter
    jp1_pc_category: serviceResponse
    jp1_pc_trendname: blackbox_exporter
    jp1_pc_remote_monitor_instance: インストールホスト名: Synthetic metric collector(Blackbox exporter)

ファイル

jpc_file_sd_config_blackbox_http.yml

jpc_file_sd_config_blackbox_http.yml.model（モデルファイル）

file_sd_config_blackbox_httpで始まるモジュール名.yml（ユーザーが作成）

格納先ディレクトリ

■統合エージェントホスト

Windowsの場合

物理ホストのとき

Agentパス¥conf¥

論理ホストのとき

共有フォルダ¥jp1ima¥conf¥

Linuxの場合

物理ホストのとき

/opt/jp1ima/conf/

論理ホストのとき

共有ディレクトリ/jp1ima/conf/

説明

Prometheus serverがHTTP/HTTPS監視でスクレイプするBlackbox exporterを設定するファイルです。

Blackbox exporter設定ファイル（jpc_blackbox_exporter.yml）に，HTTP/HTTPS監視を行うモジュールを新たに定義した場合は，このディスカバリ設定ファイルのモデルファイルをコピーし，監視対象に応じて，次の名称でディスカバリ設定ファイルを作成します。

file_sd_config_blackbox_モジュール名.yml

Blackbox exporterで監視を行う場合の設定については，マニュアル「JP1/Integrated Management 3 - Manager 構築ガイド」の「1.21.2(6) Blackbox exporterの設定」を参照してください。

文字コード

UTF-8（BOM無し）

改行コード

Windowsの場合：CR+LF

Linuxの場合：LF

定義の反映時期

Prometheus serverのリロードAPIを実行，または，再起動したとき，Prometheus serverがスクレイプする対象となります。そのあと，jddcreatetreeコマンドおよびjddupdatetreeコマンドを実行したとき，統合オペレーション・ビューアーのツリーの表示内容に反映されます。

記述内容

- 監視対象ホスト名:IM管理ノードのラベル名:URL

監視対象ホスト名，IM管理ノードのラベル名，URLは，「:」（コロン）で区切って指定します。

監視対象ホスト名は，1〜255文字の制御文字以外の文字で，監視対象のWebサーバのホスト名を指定します。FQDN形式も指定できます。「localhost」は指定できません。

IM管理ノードのラベル名は，1〜255文字の「:」（コロン）および制御文字を含まない文字で，統合オペレーション・ビューアーのIM管理ノードのラベル名に表示する文字列を指定します。URLをエンコードしたときの文字列が，234バイト以内（すべてマルチバイト文字の場合の上限は26文字）となるようにしてください。

URLは，1〜2,083文字の制御文字以外の文字で，監視するURLを指定します。URLに含まれるホスト名の代わりにIPアドレスを指定することもできますが，IPアドレスを指定した場合，監視対象の証明書の検証を有効にすることはできません（Blackbox exporter設定ファイル（jpc_blackbox_exporter.yml）のtls_configのinsecure_skip_verifyに「false」を設定することはできません）。また，Blackbox exporter設定ファイル（jpc_blackbox_exporter.yml）のtls_configのinsecure_skip_verifyに「true」を設定するため，次に示すメトリックを監視できません。

probe_ssl_last_chain_expiry_timestamp_seconds

定義例

- targets:
  - hostB: Metric forwarder(Prometheus server) healthy:http://hostB:20713/-/healthy
  - hostB: Alert forwarder(Alertmanager) healthy:http://hostB:20714/-/healthy
  labels:
    jp1_pc_exporter: JPC Blackbox Exporter
    jp1_pc_category: serviceResponse
    jp1_pc_trendname: blackbox_exporter
    jp1_pc_remote_monitor_instance: hostA: Synthetic metric collector(Blackbox exporter)

Blackbox exporter（ICMP監視）のディスカバリ設定ファイル（jpc_file_sd_config_blackbox_icmp.yml）

形式

YAML形式で記述します。

- targets:
  - 監視対象ホストのホスト名またはIPアドレス
  ・・・
  labels:
    jp1_pc_exporter: JPC Blackbox Exporter
    jp1_pc_category: platform
    jp1_pc_trendname: blackbox_exporter
    jp1_pc_remote_monitor_instance: インストールホスト名: Synthetic metric collector(Blackbox exporter)

ファイル

jpc_file_sd_config_blackbox_icmp.yml

jpc_file_sd_config_blackbox_icmp.yml.model（モデルファイル）

file_sd_config_blackbox_icmpで始まるモジュール名.yml（ユーザーが作成）

格納先ディレクトリ

■統合エージェントホスト

Windowsの場合

物理ホストのとき

Agentパス¥conf¥

論理ホストのとき

共有フォルダ¥jp1ima¥conf¥

Linuxの場合

物理ホストのとき

/opt/jp1ima/conf/

論理ホストのとき

共有ディレクトリ/jp1ima/conf/

説明

Prometheus serverがICMP監視でスクレイプするBlackbox exporterを設定するファイルです。

Blackbox exporter設定ファイル（jpc_blackbox_exporter.yml）に，ICMP監視を行うモジュールを新たに定義した場合は，このディスカバリ設定ファイルのモデルファイルをコピーし，監視対象に応じて，次の名称でディスカバリ設定ファイルを作成します。

file_sd_config_blackbox_モジュール名.yml

Blackbox exporterで監視を行う場合の設定については，マニュアル「JP1/Integrated Management 3 - Manager 構築ガイド」の「1.21.2(6) Blackbox exporterの設定」を参照してください。

文字コード

UTF-8（BOM無し）

改行コード

Windowsの場合：CR+LF

Linuxの場合：LF

定義の反映時期

Prometheus serverのリロードAPIを実行，または，再起動したとき，Prometheus serverがスクレイプする対象となります。そのあと，jddcreatetreeコマンドおよびjddupdatetreeコマンドを実行したとき，統合オペレーション・ビューアーのツリーの表示内容に反映されます。

記述内容

- 監視対象ホストのホスト名またはIPアドレス

監視対象ホストのホスト名またはIPアドレスを，1〜2,595文字の制御文字以外の文字で指定します。FQDN形式も指定できます。「localhost」は指定できません。

統合オペレーション・ビューアーで表示したとき，監視対象ホストのホスト名またはIPアドレスに指定した文字列が，エージェントホストSIDのIM管理ノードのラベルとして表示されます。監視対象ホストにIPアドレスを指定し，IM管理ノードのラベルにホスト名を表示したい場合は，JP1/IM - Managerのホスト名定義ファイル（imdd_host_name.conf）を設定して，IPアドレスとホスト名のマッピングをしてください。ホスト名定義ファイルの詳細については，「ホスト名定義ファイル（imdd_host_name.conf）」を参照してください。

定義例

- targets:
  - hostB
  - hostC
  labels:
    jp1_pc_exporter: JPC Blackbox Exporter
    jp1_pc_category: platform
    jp1_pc_trendname: blackbox_exporter
    jp1_pc_remote_monitor_instance: hostA: Synthetic metric collector(Blackbox exporter)

Yet another cloudwatch exporterのディスカバリ設定ファイル（jpc_file_sd_config_cloudwatch.yml）

形式

YAML形式で記述します。

- targets:
  - 監視エージェントのホスト名:Yet another cloudwatch exporterのポート番号
  labels:
    jp1_pc_exporter: JPC YA Cloudwatch Exporter
    jp1_pc_trendname: ya_cloudwatch_exporter
    jp1_pc_remote_monitor_instance: 監視エージェントのホスト名: AWS metric collector(Yet another cloudwatch exporter)

ファイル

jpc_file_sd_config_cloudwatch.yml

jpc_file_sd_config_cloudwatch.yml.model（モデルファイル）

格納先ディレクトリ

■統合エージェントホスト

Windowsの場合

物理ホストのとき

Agentパス¥conf¥

論理ホストのとき

共有フォルダ¥jp1ima¥conf¥

Linuxの場合

物理ホストのとき

/opt/jp1ima/conf/

論理ホストのとき

共有ディレクトリ/jp1ima/conf/

説明

Prometheus serverがスクレイプするYet another cloudwatch exporterを設定するファイルです。

文字コード

UTF-8（BOM無し）

改行コード

Windowsの場合：CR+LF

Linuxの場合：LF

定義の反映時期

Prometheus serverのリロードAPIを実行，または，再起動したとき，Prometheus serverがスクレイプする対象となります。そのあと，jddcreatetreeコマンドおよびjddupdatetreeコマンドを実行したとき，統合オペレーション・ビューアーのツリーの表示内容に反映されます。

記述内容

- 監視エージェントのホスト名:Yet another cloudwatch exporterのポート番号

監視エージェントのホスト名には，監視エージェントのインストール時に監視モジュールをインストールしたホスト名を設定します。FQDN形式も指定できます。

Yet another cloudwatch exporterのポート番号を初期値から変更している場合は，Yet another cloudwatch exporterのポート番号の値を変更してください。

Promitorのディスカバリ設定ファイル（jpc_file_sd_config_promitor.yml）

形式

YAML形式で記述します。

- targets:
  - インストールホスト名:Promitor Scraperのポート番号
  labels:
    jp1_pc_exporter: JPC Promitor
    jp1_pc_trendname: promitor
    jp1_pc_remote_monitor_instance: インストールホスト名:Azure metric collector(Promitor)
    jp1_pc_rm_agent_create_flag: false

ファイル

jpc_file_sd_config_promitor.yml

jpc_file_sd_config_promitor.yml.model（モデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Agentパス¥conf¥

論理ホストのとき

共有フォルダ¥jp1ima¥conf¥

Linuxの場合

物理ホストのとき

/opt/jp1ima/conf/

論理ホストのとき

共有ディレクトリ/jp1ima/conf/

説明

Prometheus serverがスクレイプするPromitorを設定するファイルです。

文字コード

UTF-8（BOM無し）

改行コード

Windowsの場合：CR+LF

Linuxの場合：LF

定義の反映時期

Prometheus serverのリロードAPIを実行，または，再起動したとき，Prometheus serverがスクレイプする対象となります。そのあと，jddcreatetreeコマンドおよびjddupdatetreeコマンドを実行したとき，統合オペレーション・ビューアーのツリーの表示内容に反映されます。

記述内容

- インストールホスト名:Promitor Scraperのポート番号

インストールホスト名は，統合エージェントのインストールスクリプトで設定されます。FQDN形式も指定できます。

Promitor Scraperのポート番号を初期値から変更している場合，「:」（コロン）のあとのPromitor Scraperのポート番号の値を変更してください。

OracleDB exporterのディスカバリ設定ファイル（jpc_file_sd_config_oracledb.yml）

形式

YAML形式で記述します。

- targets:
  - Oracle Databaseホスト名:監視対象名:OracleDB exporterのポート番号
  ・・・
  labels:
    jp1_pc_exporter: JPC OracleDB exporter
    jp1_pc_category: database
    jp1_pc_trendname: oracledb_exporter
    jp1_pc_remote_monitor_instance: インストール先のホスト名:OracleDB metric collector(OracleDB exporter)

ファイル

jpc_file_sd_config_oracledb.yml

jpc_file_sd_config_oracledb.yml.model（モデルファイル）

格納先ディレクトリ

■統合エージェントホスト

Windowsの場合

物理ホストのとき

Agentパス¥conf¥

論理ホストのとき

共有フォルダ¥jp1ima¥conf¥

Linuxの場合

物理ホストのとき

/opt/jp1ima/conf/

論理ホストのとき

共有ディレクトリ/jp1ima/conf/

説明

Prometheus serverがスクレイプするOracleDB exporterを設定するファイルです。

文字コード

UTF-8（BOM無し）

改行コード

Windowsの場合：CR+LF

Linuxの場合：LF

定義の反映時期

Prometheus serverのリロードAPIを実行したとき，または，再起動したとき，Prometheus serverがスクレイプする対象となります。そのあと，jddcreatetreeコマンドおよびjddupdatetreeコマンドを実行したとき，統合オペレーション・ビューアーのツリーの表示内容に反映されます。

記述内容

Oracle Databaseホスト名

Oracle Databaseのホスト名を1〜253文字の範囲で指定します。FQDN形式も指定できます。「localhost」は指定できません。

監視対象名

監視対象を区別するための任意の名前を指定します。「:」（コロン）および制御文字を含まない文字で，統合オペレーション・ビューアーのIM管理ノードのラベル名に表示する文字列を指定します。URLをエンコードしたときの文字列が，1〜234バイト（すべてマルチバイト文字の場合の上限は26文字）となるようにしてください。

OracleDB exporterのポート番号

スクレイプ先のOracleDB exporterのポート番号を指定します。

インストール先のホスト名

OracleDB exporterを稼働させるホストのホスト名を指定します。

定義例

- targets:
  - ORAHOST1:経理部DB:30001
  - ORAHOST1:人事部DB:30002
  labels:
    jp1_pc_exporter: OracleDB Exporter
    jp1_pc_category: database
    jp1_pc_trendname: oracledb_exporter
    jp1_pc_remote_monitor_instance: hostA: OracleDB metric collector(OracleDB exporter)

Script exporterのディスカバリ設定ファイル（jpc_file_sd_config_script.yml）

形式

YAML形式で記述します。

- targets:
  - インストールホスト名:Script exporterのポート番号
  labels:
    jpc_pc_exporter: JPC Script exporter
    jpc_pc_trendname: script_exporter
    jp1_pc_multiple_node: "{job='jpc_script.*',jp1_pc_multiple_node=''}"
    jp1_pc_agent_create_flag: false

ファイル

jpc_file_sd_config_script.yml

jpc_file_sd_config_script.yml.model（モデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Agentパス¥conf¥

論理ホストのとき

共有フォルダ¥jp1ima¥conf¥

Linuxの場合

物理ホストのとき

/opt/jp1ima/conf/

論理ホストのとき

共有ディレクトリ/jp1ima/conf/

説明

Prometheus serverがスクレイプするScript exporterを設定するファイルです。

Script exporterのディスカバリをファイルベースの「file_sd_config方式」で指定する場合，Prometheus設定ファイル（jpc_prometheus_server.yml）のscrape_configsのfile_sd_configsにこのファイルを指定します。

文字コード

UTF-8（BOM無し）

改行コード

Windowsの場合：CR+LF

Linuxの場合：LF

定義の反映時期

Prometheus serverのリロードAPIを実行，または，再起動したとき，Prometheus serverがスクレイプする対象となります。そのあと，jddcreatetreeコマンドおよびjddupdatetreeコマンドを実行したとき，統合オペレーション・ビューアーのツリーの表示内容に反映されます。

記述内容

- インストールホスト名:Script exporterのポート番号

インストールホスト名は，統合エージェントのインストールスクリプトで設定されます。FQDN形式も指定できます。

Script exporterのポート番号を初期値から変更している場合，「:」（コロン）のあとのScript exporterのポート番号の値を変更してください。

ユーザー独自のディスカバリ設定ファイル（user_file_sd_config_任意の名前.yml）

形式

YAML形式で記述します。

- targets:
  - 監視対象ホスト名[:任意の文字列]
  ・・・
  labels:
[    jp1_pc_exporter: 「JPC」から始まらない任意のExporter名]
[    jp1_pc_category: IM管理ノードのカテゴリID]
[    jp1_pc_trendname: Prometheusトレンド名]
[    jp1_pc_remote_monitor_instance: インストールホスト名:IM管理ノードのラベルに表示する文字列]
[    jp1_pc_rm_agent_create_flag: リモートエージェントSID作成フラグ]
[    jp1_pc_agent_create_flag: エージェントSID作成フラグ]
[    jp1_pc_multiple_node: 複数IM管理ノード作成のためのラベルセット取得条件]

ファイル

user_file_sd_config_任意の名前.yml

格納先ディレクトリ

任意のディレクトリに格納できます。ただし，監視エージェントのインストール先ディレクトリ配下に格納する場合は，次のディレクトリ以下に格納してください。

■統合エージェントホスト

Windowsの場合

物理ホストのとき

Agentパス¥conf¥

論理ホストのとき

共有フォルダ¥jp1ima¥conf¥

Linuxの場合

物理ホストのとき

/opt/jp1ima/conf/

論理ホストのとき

共有ディレクトリ/jp1ima/conf/

説明

Prometheus serverがスクレイプする対象を設定するファイルです。ユーザーが独自に用意したExporterもスクレイプの対象とすることができます。

文字コード

UTF-8（BOM無し）

改行コード

Windowsの場合：CR+LF

Linuxの場合：LF

定義の反映時期

Prometheus serverのリロードAPIを実行，または，再起動したとき，Prometheus serverがスクレイプする対象となります。そのあと，jddcreatetreeコマンドおよびjddupdatetreeコマンドを実行したとき，統合オペレーション・ビューアーのツリーの表示内容に反映されます。

記述内容

- 監視対象ホスト名［:任意の文字列］

「監視対象ホスト名［:任意の文字列］」を，1〜2,574文字の制御文字以外の文字で指定します。

監視対象ホスト名は，1〜255文字の制御文字以外の文字で，必須で指定します。FQDN形式も指定できます。「localhost」は指定できません。

Exporterの仕様で，ほかに必要な指定があれば，任意の文字列を指定します。

Prometheus設定ファイル（jpc_prometheus_server.yml）のスクレイプ定義でrelabel_configsを設定し，必要な文字列をスクレイプ時の引数として渡します。

2,574文字を超える場合は，Prometheus設定ファイル（jpc_prometheus_server.yml）のrelabel_configsで，instanceラベルの値を，1〜2,574文字の制御文字以外の文字列に置き換えてください。なお，instanceラベルの値は，「監視対象ホスト名:任意の文字列」の形式で指定し，同一監視エージェントホスト内のほかのinstanceラベルの値と重複しないようにしてください。

relabel_configsの設定については，「Prometheus設定ファイル（jpc_prometheus_server.yml）」の「記述内容」について説明している個所を参照してください。

jp1_pc_exporter: 「JPC」から始まらない任意のExporter名

「JPC」から始まらない任意のExporter名には，プロパティ表示で，jp1_pc_exporterのプロパティに表示する文字列を，1〜255文字の制御文字以外の文字で指定します。指定を省略した場合，「Unknown Exporter」と表示されます。

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

IM管理ノードのカテゴリIDには，エージェントSIDのIM管理ノードのカテゴリIDを，1〜255文字の制御文字以外の文字で指定します。

指定を省略した場合，「otherApplications」が指定されたものとします。

jp1_pc_trendname: Prometheusトレンド名

Prometheusトレンド名には，エージェントSIDのIM管理ノードで表示する，メトリック定義ファイルのPrometheusトレンド名を，1〜255文字の制御文字以外の文字で指定します。

指定を省略した場合，jobラベルの値を設定します。

jp1_pc_remote_monitor_instance: インストールホスト名:IM管理ノードのラベルに表示する文字列

リモートで監視するExporterの場合だけ指定します。リモートで監視するExporterとは，Exporterをセットアップしたホストとは別のホストを監視するExporterのことです。

インストールホスト名には，Exporterをインストールしたホスト名を，1〜255文字の制御文字以外の文字で指定します。

IM管理ノードのラベルに表示する文字列には，リモート監視サービスSIDのIM管理ノードのラベルに表示する文字列を制御文字とコロン以外の文字で指定します。コロンは区切り文字のため，指定した場合，最後に指定したコロン以降の文字列がIM管理ノードのラベルに表示する文字列の対象となります。URLをエンコードしたときの文字列が，234バイト以内（すべてマルチバイト文字の場合の上限は26文字）となるようにしてください。

インストールホスト名とIM管理ノードのラベルに表示する文字列の間には，区切り文字のコロンを指定してください。指定しない場合,インストールホスト名とIM管理ノードのラベルに表示する文字列は同一と見なして動作します。

指定を省略した場合，リモート監視サービスSIDを作成しません。

jp1_pc_rm_agent_create_flag: リモートエージェントSID作成フラグ

リモートで監視するExporterの場合だけ指定します。trueまたはfalseを指定します。大文字小文字の区別はありません。jp1_pc_remote_monitor_instanceを指定していない場合，この設定は無効となります。

true

「エージェントホストSID」と「監視対象ホスト名:任意の文字列」の単位で，「リモートエージェントSID」のIM管理ノードを作成する。

false

「エージェントホストSID」と「監視対象ホスト名:任意の文字列」の単位で，「リモートエージェントSID」のIM管理ノードを作成しない。

trueまたはfalse以外の文字を指定した場合，および指定を省略した場合は，trueを指定したものとして動作します。

jp1_pc_agent_create_flag: エージェントSID作成フラグ

Exporterがインストールされているホストを監視しているExporterの場合だけ指定します。trueまたはfalseを指定します。大文字小文字の区別はありません。jp1_pc_remote_monitor_instanceを指定している場合，この設定は無効となります。

true

「監視対象ホスト名:任意の文字列」の単位で，「エージェントSID」のIM管理ノードを作成する。

false

「監視対象ホスト名:任意の文字列」の単位で，「エージェントSID」のIM管理ノードを作成しない。

trueまたはfalse以外の文字を指定した場合，および指定を省略した場合は，trueを指定したものとして動作します。

jp1_pc_multiple_node: 複数IM管理ノード作成のためのラベルセット取得条件

「監視対象ホスト名:任意の文字列」に対して，複数のIM管理ノード（エージェントSIDやリモートエージェントSID）を作成する場合に指定します。IM管理ノードを作成するために必要なラベルセットを，トレンドデータ管理DBから取得する条件を指定します。

条件は1つだけ指定できます。指定できる値については，「4.5.18 jp1TrendDataService.getLabelList」のmatchパラメーターの説明を参照してください。

指定を省略した場合は，「監視対象ホスト名:任意の文字列」に対して，複数のIM管理ノード（エージェントSIDやリモートエージェントSID）を作成しません。

定義例

- targets:
  - hostA:9256
  labels:
    jp1_pc_exporter: Process Exporter
    jp1_pc_category: platform
    jp1_pc_trendname: process

サービス定義ファイル（jpc_プログラム名_service.xml）

形式

<service>
  <id>サービスのID</id>
  <name>サービスの表示名</name>
  <description>説明</description>
  <workingdirectory>作業ディレクトリ</workingdirectory>
  <env name="環境変数名" value="値"></env>
  <executable>"プログラムのパス"</executable>
  <arguments>プログラムの引数</arguments>
  <startmode>スタートアップの種類</startmode>
  <logpath>ログ出力先ディレクトリ</logpath>
  <log mode="roll-by-size">
    <sizeThreshold>ログファイルサイズ</sizeThreshold>
    <keepFiles>ログ面数</keepFiles>
  </log>
  <stoptimeout>終了タイムアウト時間</stoptimeout>
</service>

ファイル

物理ホスト用

jpc_プログラム名_service.xml

jpc_プログラム名_service.xml.model（モデルファイル）

論理ホスト用

jpc_プログラム名_service_論理ホスト名.xml

格納先ディレクトリ

■統合エージェントホスト

物理ホストのとき（モデルファイルの格納先）

Agentパス¥conf¥

物理ホストおよび論理ホストのとき（定義ファイルの格納先）

Agentパス¥bin¥

説明

Windowsサービス化プログラムの定義ファイルです。

文字コード

UTF-8（BOM無し）

改行コード

CR+LF

定義の反映時期

定義ファイルの<startmode>を変更した場合は，サービスの再インストールにより反映されます。サービスの再インストールは，統合エージェント制御基盤またはアドオンプログラムのサービスごとに，次の表に示すコマンドで行います。

アドオンプログラムまたは統合エージェント制御基盤

サービス名

コマンド

Prometheus server

jpc_prometheus_server_service.exe

jpc_prometheus_server_service.exe

Alertmanager

jpc_alertmanager_service.exe

jpc_alertmanager_service.exe

Windows exporter

jpc_windows_exporter_service.exe

jpc_windows_exporter_service.exe

Blackbox exporter

jpc_blackbox_exporter_service.exe

jpc_blackbox_exporter_service.exe

Yet another cloudwatch exporter

jpc_ya_cloudwatch_exporter_service.exe

jpc_ya_cloudwatch_exporter_service.exe

Promitor

jpc_promitor_scraper_service.exe

jpc_promitor_scraper_service.exe

jpc_promitor_resource_discovery_service.exe

jpc_promitor_resource_discovery_service.exe

Script exporter

jpc_script_exporter_service.exe

jpc_script_exporter_service.exe

Fluentd

jpc_fluentd_service.exe

jpc_fluentd_service.exe

imagent

jpc_imagent_service.exe

jpc_imagent_service.exe

imagentproxy

jpc_imagentproxy_service.exe

jpc_imagentproxy_service.exe

imagentaction

jpc_imagentaction_service.exe

jpc_imagentaction_service.exe

定義ファイルの<arguments>または<stoptimeout>を変更した場合は，サービスの再起動により反映されます。

記述内容

項目名

説明

変更可否

JP1/IM - Agentでユーザーが設定する内容

JP1/IM - Agentのデフォルト値

<service>

サービスの設定をします。

−

−

−

<id>

サービスのID（Windowsがサービスを識別するために内部的に使用するID）を指定します（必須）。

このIDは，システムにインストールされているすべてのサービスの中で一意，かつ，すべて英数字で構成されている必要があります。

△

−

Prometheus serverの場合

jpc_prometheus

Alertmanagerの場合

jpc_alertmanager

Windows exporterの場合

jpc_windows_exporter

Blackbox exporterの場合

jpc_blackbox_exporter

統合エージェント制御基盤（imagent）の場合

jpc_imagent

統合エージェント制御基盤（imagentproxy）の場合

jpc_imagentproxy

統合エージェント制御基盤（imagentaction）の場合

jpc_imagentaction

Fluentdの場合

jpc_fluentd

Yet another cloudwatch exporterの場合

jpc_ya_cloudwatch_exporter

Promitor Scraperの場合

jpc_promitor_scraper

Promitor Resource Discoveryの場合

jpc_promitor_resource_discovery

Script exporterの場合

jpc_script_exporter

OracleDB exporterの場合

oracledb_exporter_インスタンス名

<name>

サービスの表示名（サービスの短い表示名）を指定します（任意）。

空白文字やほかの文字を含めることができます。<id>のように長い文字列は指定しないでください。また，特定のシステム内のすべてのサービス間で一意である必要があります。

△

−

Prometheus serverの場合

JP1/IM3-Agent Metric forwarder

Alertmanagerの場合

JP1/IM3-Agent Alert forwarder

Windows exporterの場合

JP1/IM3-Agent Windows metric collector

Blackbox exporterの場合

JP1/IM3-Agent Synthetic metric collector

統合エージェント管理基盤（imbase）の場合

■通常ホストの場合

JP1/IM-Agent Base Server

■クラスタ環境の場合

JP1/IM-Agent Base Server_論理ホスト名

統合エージェント管理基盤（imbaseproxy）の場合

■通常ホストの場合

JP1/IM-Agent Base Proxy Server

■クラスタ環境の場合

JP1/IM-Agent Base Proxy Server_論理ホスト名

統合エージェント制御基盤（imagent）の場合

JP1/IM3-Agent

統合エージェント制御基盤（imagentproxy）の場合

JP1/IM3-Agent proxy

統合エージェント制御基盤（imagentaction）の場合

JP1/IM3-Agent action

Fluentdの場合

JP1/IM3-Agent Log trapper

Yet another cloudwatch exporterの場合

JPC YA Cloudwatch exporter

Promitor Scraperの場合

JPC Promitor Scraper

Promitor Resource Discoveryの場合

JPC Promitor Resource Discovery

Script exporterの場合

JPC Script exporter

OracleDB exporterの場合

OracleDB metric collector インスタンス名

<description>

説明を（長い説明文）を指定します（任意）。

この説明は，サービスが選択されたときに，Windowsサービスコントロールマネージャーに表示されます。

△

−

Prometheus serverの場合

Prometheus server

Alertmanagerの場合

Alertmanager

Windows exporterの場合

windows_exporter

Blackbox exporterの場合

blackbox_exporter

統合エージェント管理基盤（imbase）の場合

JP1 IMA Base Service

統合エージェント管理基盤（imbaseproxy）の場合

JP1 IMA Base Proxy Service

統合エージェント制御基盤（imagent）の場合

JPC IM-Agent Service

統合エージェント制御基盤（imagentproxy）の場合

JPC IM-Agent Proxy Service

統合エージェント制御基盤（imagentaction）の場合

JPC IM-Agent Action Service

Fluentdの場合

Fluentd

Yet another cloudwatch exporterの場合

jpc_ya_cloudwatch_exporter

Promitor Scraperの場合

jpc_promitor_scraper

Promitor Resource Discoveryの場合

jpc_promitor_resource_discovery

Script exporterの場合

jpc_script_exporter

OracleDB exporterの場合

OracleDB exporter

<workingdirectory>

作業ディレクトリ（サービスのカレントディレクトリ）を指定します。

△

−

Prometheus server，Alertmanager，Windows exporter，およびBlackbox exporterの場合

セットアップ時に自動設定します。

統合エージェント管理基盤（imbaseおよびimbaseproxy）の場合

Managerパス¥bin¥imdd¥imagent

統合エージェント制御基盤（imagent，imagentproxy，およびimagentaction）およびFluentdの場合

Agentパス¥bin

<env name="環境変数名" value="値">

環境変数名と値を指定します。

Promitor Scraper，Promitor Resource Discovery，およびOracleDB exporterの場合に指定します。

Promitor ScraperおよびPromitor Resource Discoveryの場合

△

OracleDB exporterの場合

○

−

Promitor Scraperの場合

name="PROMITOR_CONFIG_FOLDER" value="インストール先/jp1ima/conf/promitor/scraper"

Promitor Resource Discoveryの場合

name="PROMITOR_CONFIG_FOLDER" value="インストール先/jp1ima/conf/promitor/resource-discovery"

OracleDB exporterの場合

マニュアル「JP1/Integrated Management 3 - Manager 構築ガイド」の「1.23.1(4)(a) 監視対象を追加する（必須）」の「監視対象を追加するための準備」の手順3と4を参照してください。

<executable>

プログラムのパス（起動する実行ファイルのパス）を指定します（必須）。

絶対パスを指定，または実行ファイル名を指定してPATHから検索させることができます。

ただし，サービスは別のユーザーアカウントで実行されることが多いため，シェルとは異なるPATHを持つ可能性があることに注意してください。

空の文字列を指定してもエラーにならないため，注意してください。

△

−

Prometheus serverの場合

prometheus.exe

Alertmanagerの場合

alertmanager.exe

Windows exporterの場合

windows_exporter.exe

Blackbox exporterの場合

blackbox_exporter.exe

統合エージェント管理基盤（imbase）の場合

imbase

統合エージェント管理基盤（imbaseproxy）の場合

imbaseproxy

統合エージェント制御基盤（imagent）の場合

imagent

統合エージェント制御基盤（imagentproxy）の場合

imagentproxy

統合エージェント制御基盤（imagentaction）の場合

imagentaction

Fluentdの場合

Agentパス¥lib¥ruby¥ruby.exe

Yet another cloudwatch exporterの場合

ya_cloudwatch_exporter.exe

Promitor Scraperの場合

promitor_scraper.exe

Promitor Resource Discoveryの場合

promitor_resource_discovery.exe

Script exporterの場合

script_exporter.exe

OracleDB exporterの場合

配置先¥oracledb_exporter_windows¥jp1ima¥bin¥oracledb_exporter.exe

<arguments>

プログラムの引数（起動する実行ファイルに渡す引数）を指定します。

値を変更する場合は，値を変更したあとで，サービスを再起動してください。

〇

引数を変更したいときに設定を変更します。

Prometheus serverの場合

prometheus.exeの引数については，「prometheusコマンドのオプション」を参照してください。

--config.file="Agentパス/conf/jpc_prometheus_server.yml"

Alertmanagerの場合

alertmanager.exeの引数については，「alertmanager.コマンドのオプション」を参照してください。

Windows exporterの場合

windows_exporter.exeの引数については，「windows_exporterコマンドのオプション」を参照してください。

Blackbox exporterの場合

blackbox_exporter.exeの引数については，「blackbox_exporterコマンドのオプション」を参照してください。

統合エージェント管理基盤（imbaseおよびimbaseproxy）および統合エージェント制御基盤imagent，imagentproxy，およびimagentaction）の場合

■通常ホストの場合

なし

■クラスタ環境の場合

-hostname 論理ホスト名

Fluentdの場合

fluentdコマンドの引数については，「fluentdコマンドのオプション」を参照してください。

Yet another cloudwatch exporterの場合

ya_cloudwatch_exporter.exeの引数については，「ya_cloudwatch_exporterコマンドのオプション」を参照してください。

Promitor Scraperの場合

promitor_scraper.exeの引数については，「promitor_scraperコマンドのオプション」を参照してください。

Promitor Resource Discoveryの場合

promitor_resource_discovery.exeの引数については，「promitor_resource_discoveryコマンドのオプション」を参照してください。

Script exporterの場合

script_exporter.exeの引数については，「script_exporterコマンドのオプション」を参照してください。

OracleDB exporterの場合

oracledb_exporter.exeの引数については，「oracledb_exporterコマンドのオプション」を参照してください。

<startmode>

スタートアップの種類（Windowsサービスの開始モード）を指定します（任意）。

次のどちらかの値を指定します。

Automatic（自動）

Manual（手動）

値を変更する場合は，一度サービスのアンインストールを実行し，値を変更したあとで，サービスの再インストールを実行してください。

〇

Prometheus server，Alertmanager，Windows exporter，Blackbox exporter，統合エージェント制御基盤（imagentおよびimagentproxy），Fluentd，およびOracleDB exporterの場合

クラスタ運用のときはManualを指定します。

Prometheus server，Alertmanager，Windows exporter，Blackbox exporter，Yet another cloudwatch exporter，Promitor Scraper，Promitor Resource Discovery，Script exporter，統合エージェント制御基盤（imagentおよびimagentproxy），およびFluentdの場合

Automatic

統合エージェント管理基盤（imbaseおよびimbaseproxy）の場合

Manual

<logpath>

ログ出力先ディレクトリ（ログファイルが作成されるディレクトリ）を指定します。

指定を省略した場合，設定ファイルが存在するディレクトリがデフォルトとなります。

値を変更する場合は，値を変更したあとで，サービスを再起動してください。

○

−

セットアップ時に自動設定します。

<log mode="roll-by-size">

ログ出力のモードはroll-by-sizeモードです。appendモードと同様に動作しますが，ログファイルサイズに設定した値を超えた場合は，myapp.1.out.log，myapp.2.out.logなどにロールされます。

△

−

−

<sizeThreshold>

ログファイルサイズ（ローテーションのしきい値）を変更するときにKB単位で指定します。

値を変更する場合は，値を変更したあとで，サービスを再起動してください。

△

サポート窓口から値の変更を指示されたときに設定を変更します。

10240

<keepFiles>

ログ面数（保持するロールファイルの数）を変更するときに指定します。

指定した面数＋1面のログが作成されます。

値を変更する場合は，値を変更したあとで，サービスを再起動してください。

設定できる値の範囲は7〜511です。

〇

サポート窓口から値の変更を指示されたときに設定を変更します。

7（Fluentdの場合だけ99）

<stoptimeout>

サービスの停止待ち時間（プログラムに停止要求を出してから，サービスが停止するまでの最大待ち時間）を指定します。

値を変更する場合は，値を変更したあとで，サービスを再起動してください。

〇

停止待ち時間を変更したいときに設定を変更します。

Prometheus serverの場合

110sec

Alertmanager，Windows exporter，Blackbox exporter，Yet another cloudwatch exporter，Promitor Scraper，Promitor Resource Discovery，Script exporter，およびFluentdの場合

60sec

統合エージェント管理基盤（imbase）および統合エージェント制御基盤（imagent）の場合

90sec

統合エージェント管理基盤（imbaseproxy）および統合エージェント制御基盤（imagentproxy）の場合

140sec

OracleDB exporterの場合

60sec

（凡例）

〇：変更可　△：変更不可　−：該当なし

prometheusコマンドのオプション

項目名

説明

変更可否

JP1/IM - Agentでユーザーが設定する内容

JP1/IM - Agentのデフォルト値

--config.file="jpc_prometheus_server.yml"

Prometheusの設定ファイルのパスを指定します。

〇

−

--config.file="Agentパス/conf/jpc_prometheus_server.yml"

--web.listen-address="0.0.0.0:9090"

待ち受けポートを指定します。リッスンするIPアドレスを限定したい場合は，ホスト名またはIPアドレスも記載します。ホスト名を指定する場合は255バイトまで指定できます。

＜設定例＞

すべてのIPアドレスに対する要求を受け付ける場合は，次のように設定します。

--web.listen-address="0.0.0.0:20713"

受け付けるIPアドレスを制限する場合は，次のようにホスト名またはIPアドレスを指定して制限できます。

--web.listen-address="ホスト名またはIPアドレス:20713"

〇

ポートを変更したい場合，または，リッスンするIPアドレスを限定したい場合に指定します。

--web.listen-address="0.0.0.0:20713"

--web.read-timeout=5m

リクエストの読み取りをタイムアウトして，アイドル状態のコネクションを閉じるまでの最大時間を指定します。

△

−

--web.read-timeout=5m

--web.max-connections=512

最大同時接続数を指定します。

△

−

--web.max-connections=10

--web.enable-lifecycle

HTTPリクエストによるシャットダウンとリロードを有効にする場合に指定します。

△

−

--web.enable-lifecycle

--storage.tsdb.path="data/"

パフォーマンスデータの保存先パスを指定します。

△

−

--storage.tsdb.path="data/prometheus_server/"

--storage.tsdb.min-block-duration=2h

ブロックの最小期間を指定します。

△

−

--storage.tsdb.min-block-duration=1h

--storage.tsdb.max-block-chunk-segment-size=512MB

ブロック内の単一のチャンクセグメントの最大サイズを指定します。

△

−

--storage.tsdb.max-block-chunk-segment-size=32MB

--storage.tsdb.retention.time=STORAGE.TSDB.RETENTION.TIME

パフォーマンスデータの保存期間を，1〜48hの範囲で時間単位で指定します。

＜設定例＞

--storage.tsdb.retention.time=24h

○

アラートルールの条件に範囲ベクトルセレクターを使用する場合，その範囲より大きい値を指定します。

--storage.tsdb.retention.time=1h

--storage.remote.flush-deadline=<duration>

リモートライトやアラート送信ができない状態で停止する際の最大待ち時間を指定します。

△

−

--storage.remote.flush-deadline=5s

--rules.alert.for-outage-tolerance=1h

アラートの「pending」状態を復元できるPrometheus serverの最大停止期間を指定します。

△

−

--rules.alert.for-outage-tolerance=1h

--rules.alert.for-grace-period=10m

アラートから復元された場合の「for」状態の最小期間を指定します。

このオプションよりも長い「for」時間が設定されているアラートに対してだけ有効です。

△

−

--rules.alert.for-grace-period=10m

--log.level=info

指定されたレベル以上のメッセージだけをログに出力します。

指定できるレベルは，debug，info，warn，errorのどれかです。

△

サポート窓口から値の変更を指示されたときに設定を変更します。

通常は変更不要です。

--log.level=debug

（凡例）

〇：変更可　△：変更不可　−：該当なし

alertmanagerコマンドのオプション

項目名

説明

変更可否

JP1/IM - Agentでユーザーが設定する内容

JP1/IM - Agentのデフォルト値

--config.file="jpc_alertmanager.yml"

Alertmanagerの設定ファイルのパスを指定します。

〇

−

--config.file="Agentパス/conf/jpc_alertmanager.yml"

--storage.path="data/"

管理用データの保存先パスを指定します。

△

−

--storage.path="data/alertmanager/"

--data.retention=120h

管理用データの保存期間を指定します。

Silenceの情報や発生したアラートの情報が保存されます。

△

−

--data.retention=168h

--alerts.gc-interval=30m

Garbage Collectionのインターバルを指定します。

△

−

--alerts.gc-interval=30m

--web.listen-address=":9093"

待ち受けポートを指定します。リッスンするIPアドレスを限定したい場合は，ホスト名またはIPアドレスも記載します。ホスト名を指定する場合は255バイトまで指定できます。

このオプションに，ホスト名またはIPアドレスを指定する場合は，同じホスト上にあるPrometheus設定ファイル（jpc_prometheus_server.yml）のalerting.alertmanagers.static_configs.targetsに記載されているlocalhostに，このオプションと同じホスト名またはIPアドレスを設定し，Prometheus serverを再起動またはリロードする必要があります。

＜設定例＞

すべてのIPアドレスに対する要求を受け付ける場合は，次のように設定します。

--web.listen-address=":20714"

受け付けるIPアドレスを制限する場合は，次のようにホスト名またはIPアドレスを指定して制限できます。

--web.listen-address="ホスト名またはIPアドレス:20714"

〇

ポートを変更したい場合，または，リッスンするIPアドレスを限定したい場合に指定します。

--web.listen-address=":20714"

--web.get-concurrency=0

同時に処理するGETリクエストの最大数を指定します。

△

−

--web.get-concurrency=0

--web.timeout=0

HTTPリクエストのタイムアウト時間を指定します。

△

−

--web.timeout=0

--cluster.listen-address="0.0.0.0:9094"

AlertmanagerをHAモードで動作させるときにリッスンアドレスを指定します。空の文字列を設定すると，HAモードが無効になります。

△

−

--cluster.listen-address=""

--log.level=info

指定されたレベル以上のメッセージだけをログに出力します。

指定できるレベルは，debug，info，warn，errorのどれかです。

△

サポート窓口から値の変更を指示されたときに設定を変更します。

通常は変更不要です。

--log.level=info

--log.format=logfmt

ログメッセージの出力形式を指定します。

使用できる出力形式はlogfmtまたはjsonです。

△

−

--log.format=logfmt

（凡例）

〇：変更可　△：変更不可　−：該当なし

windows_exporterコマンドのオプション

項目名

説明

変更可否

JP1/IM - Agentでユーザーが設定する内容

JP1/IM - Agentのデフォルト値

--telemetry.addr

待ち受けポートを指定します。リッスンするIPアドレスを限定したい場合は，ホスト名またはIPアドレスも記載します。ホスト名を指定する場合は255バイトまで指定できます。

このオプションに，ホスト名を指定する場合は，同じホスト上にあるWindows exporterのディスカバリ設定ファイル（jpc_file_sd_config_windows.yml）のtargetsに，このオプションと同じホスト名を設定し，Prometheus serverを再起動またはリロードする必要があります。

このオプションに，IPアドレスを指定する場合は，同じホスト上にあるWindows exporterのディスカバリ設定ファイル（jpc_file_sd_config_windows.yml）のtargetsに，このオプションと同じIPアドレスに解決されるホスト名を設定し，Prometheus serverを再起動またはリロードする必要があります。

＜設定例＞

すべてのIPアドレスに対する要求を受け付ける場合は，次のように設定します。

--telemetry.addr=":20717"

受け付けるIPアドレスを制限する場合は，次のようにホスト名またはIPアドレスを指定して制限できます。

--telemetry.addr="ホスト名またはIPアドレス:20717"

〇

ポートを変更したい場合，または，リッスンするIPアドレスを限定したい場合に指定します。

--telemetry.addr=":20717"

--config.file

Windows exporterの設定ファイルのパスを指定します。

このファイルに設定された値は，コマンドラインオプションによって上書きされます。

〇

−

--config.file="Agentパス/conf/jpc_windows_exporter.yml"

--log.level

指定されたレベル以上のメッセージだけをログに出力します。

指定できるレベルは，debug，info，warn，errorのどれかです。

△

−

--log.level=debug

（凡例）

〇：変更可　△：変更不可　−：該当なし

blackbox_exporterコマンドのオプション

項目名

説明

変更可否

JP1/IM - Agentでユーザーが設定する内容

JP1/IM - Agentのデフォルト値

--config.file

Blackbox exporterの設定ファイルのパスを指定します。

〇

−

--config.file="Agentパス/conf/jpc_blackbox_exporter.yml"

--web.listen-address

待ち受けポートを指定します。リッスンするIPアドレスを限定したい場合は，ホスト名またはIPアドレスも記載します。ホスト名を指定する場合は255バイトまで指定できます。

このオプションに，ホスト名またはIPアドレスを指定する場合は，同じホスト上にあるPrometheus設定ファイル（jpc_prometheus_server.yml）のblackbox_exporter用のスクレイプジョブのrelabel_config内に記載されているlocalhost（複数存在します）に，このオプションと同じホスト名またはIPアドレスを設定し，Prometheus serverを再起動またはリロードする必要があります。

＜設定例＞

すべてのIPアドレスに対する要求を受け付ける場合は，次のように設定します。

--web.listen-address=":20715"

受け付けるIPアドレスを制限する場合は，次のようにホスト名またはIPアドレスを指定して制限できます。

--web.listen-address="ホスト名またはIPアドレス:20715"

〇

ポートを変更したい場合，または，リッスンするIPアドレスを限定したい場合に指定します。

--web.listen-address=":20715"

--timeout-offset

Prometheusのscrape_timeoutの値から減算する秒数を指定します。

Prometheusのscrape_timeoutの値からこのオプションに指定された値を減算した秒数でタイムアウトするようになります。

△

タイムアウト時間から差し引くオフセット（秒）

--timeout-offset=0.5

--history.limit

Probe結果の履歴の上限を指定します。

この履歴はblackbox_exporter内部に保存され，古い履歴は削除されていきます。

△

履歴に残すアイテム数の上限

--history.limit=100

--log.level

指定されたレベル以上のメッセージだけをログに出力します。

指定できるレベルは，debug，info，warn，errorのどれかです。

△

サポート窓口から値の変更を指示されたときに設定を変更します。

通常は変更不要です。

--log.level=info

（凡例）

〇：変更可　△：変更不可　−：該当なし

promitor_scraperコマンドのオプション

指定できるオプションはありません。

promitor_resource_discoveryコマンドのオプション

指定できるオプションはありません。

script_exporterコマンドのオプション

項目名

説明

変更可否

JP1/IM - Agentでユーザーが設定する内容

JP1/IM - Agentのデフォルト値

-config.file

Script exporterの設定ファイルのパスを指定します。

○

−

Windowsの場合

インストール先¥jp1ima¥conf¥jpc_script_exporter.yml

Linuxの場合

/opt/jp1ima/conf/jpc_script_exporter.yml

-web.listen-address

待ち受けポートを指定します。リッスンするIPアドレスを限定したい場合は，ホスト名またはIPアドレスも記載します。ホスト名を指定する場合は255バイトまで指定できます。

＜設定例＞

すべてのIPアドレスに対する要求を受け付ける場合は，次のように設定します。

--web.listen-address=":9469"

受け付けるIPアドレスを制限する場合は，次のようにホスト名またはIPアドレスを指定して制限できます。

--web.listen-address="ホスト名またはIPアドレス:9469"

○

ポートを変更したい場合，または，リッスンするIPアドレスを限定したい場合に指定します。

20722

-timeout-offset

Prometheusのscrape_timeoutの値から減算する秒数を指定します。

Prometheusのscrape_timeoutの値からこのオプションに指定された値を減算した秒数でタイムアウトするようになります。

△

タイムアウト時間から差し引くオフセット（秒）

--timeout-offset=0.5

（凡例）

○：変更可　△：変更不可　−：該当なし

fluentdコマンドのオプション

項目名

説明

変更可否

JP1/IM - Agentでユーザーが設定する内容

JP1/IM - Agentのデフォルト値

-c

--config.file PATH

Fluentdの設定ファイルのパスを指定します。

〇

論理ホストの場合は，論理ホストの共有フォルダに配置したログ監視共通定義ファイルのパスに修正する必要があります。

Fluentdのログ監視共通定義ファイルのパス

'-i CONFIG_STRING

--enable-input-metrics

Fluentdの入力プラグインメトリックを有効にします。

△

−

なし

-G

--conf-encoding ENCODING

構成ファイルのエンコーディングを指定します。

△

−

UTF-8

（凡例）

〇：変更可　△：変更不可　−：該当なし

oracledb_exporterコマンドのオプション

項目名

説明

変更可否

JP1/IM - Agentでユーザーが設定する内容

JP1/IM - Agentのデフォルト値

--web.telemetry-path="/metrics"

スクレイプするURLを指定します。

△

−

"/metrics"

--default.metrics="default-metrics.toml"

デフォルトメトリックの定義ファイルを指定します。

△

−

"default_metrics.toml"

--custom.metrics=""

カスタムメトリックの定義ファイルを指定します。

△

−

""

--query.timeout=5

oracledb_exporterからOracle Databaseにアクセスして情報を取得するときのタイムアウト時間を指定します。

時間単位で5から60で指定します。

＜設定例＞

--query.timeout=5

〇

Oracle Databaseから情報を取得するのに時間がかかる場合に指定します。

5

--database.maxIdleConns=0

アイドル状態の接続数の最大値を指定します。

△

−

0

--database.maxOpenConns=10

オープン状態の接続数の最大値を指定します。

△

−

1

--scrape.interval=0s

スクレイプ間隔を指定します。

△

−

0s

--[no-]web.systemd-socket

ソケットベースのアクティベーションを使用する場合に指定します。

△

−

指定しない（使用しない）

--web.listen-address=:9161

待ち受けポートを指定します。

リッスンするIPアドレスを限定したい場合は，ホスト名またはIPアドレスも記載します。ホスト名を指定する場合は255バイトまで指定できます。

このオプションにホスト名またはIPアドレスを指定する場合は，同じホスト上にあるprometheus.ymlのoracledb_exporter用のスクレイプジョブのrelabel_confg内に記載されているlocalhost（複数存在します）に，オプションで指定したホスト名またはIPアドレスを設定し，Prometheus serverを再起動またはリロードする必要があります。

＜設定例＞

全てのIPアドレスに対する要求を受け付ける場合は，次のように設定します。

--web.listen-address=":20729"

受け付けるIPアドレスを制限する場合は，次のようにホスト名またはIPアドレス指定して制限できます。

--web.listen-address="ホスト名またはIPアドレス:20729"

〇

ポートを変更したい場合，または，リッスンするIPアドレスを限定したい場合に指定します。

--web.listen-address="@@port@@"

--log.level=info

指定されたレベル以上のメッセージのみをログに出力します。

指定できるレベルは，debug, info, warn, errorのどれかです。

△

サポート窓口から値の変更を指示されたときに設定を変更します。

通常は変更不要です。

--log.level=info

（凡例）

〇：変更可　△：変更不可　−：該当なし

ユニット定義ファイル（jpc_プログラム名.service）

形式

[Unit]
Description = ユニットの説明
After=local-fs.target remote-fs.target rsyslog.service network.target
[Service]
WorkingDirectory = 作業ディレクトリ
ExecStart = /bin/sh -c 'プログラムの起動コマンドライン |& (trap "" 15 && exec インストール先ディレクトリ/jp1ima/bin/rotatelogs -n 8※1 ログ出力先ディレクトリ※2 10240K)'
Type = simple
Restart=no
User=root
TimeoutStopSec=終了タイムアウト時間
LimitNOFILE=65536※3
Environment=SIGDUMP_PATH=-※3
[Install]
WantedBy=multi-user.target graphical.target

注※1

Fluentdのユニット定義ファイルの場合だけ「100」を指定します。

注※2

初期値として設定されるログ出力先ディレクトリは，プログラムによって異なります。初期値のパスについては，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「付録A.4(4) 統合エージェントホスト（Linux）」の「統合エージェントホスト（Linux）のJP1/IM - Agentでユーザーが参照・編集できるファイル・ディレクトリ一覧」を参照してください。

注※3

Fluentdのユニット定義ファイルの場合だけ記載します。

説明

Linux環境でプログラムをsystemctlに登録するための定義ファイルです。

ファイル

物理ホスト用

jpc_プログラム名.service

jpc_プログラム名.service.model（モデルファイル）

論理ホスト用

jpc_プログラム名_論理ホスト名.service

格納先ディレクトリ

■統合エージェントホスト

物理ホスト（モデルファイルの格納先）

/opt/jp1ima/conf/

物理ホストおよび論理ホスト（定義ファイルの格納先）

/usr/lib/systemd/system/

インストール先のターゲットは次のとおりです。

ターゲット名

説明

multi-user.target

runlevel=3

マルチユーザーモード（テキストログイン）

graphical.target

runlevel=5

マルチユーザーモード（グラフィカルログイン）

文字コード

UTF-8（BOM無し）

改行コード

LF

定義の反映時期

systemctl daemon-reloadコマンドを実行したときに反映されます。

記述内容

Prometheus server，Alertmanager，およびExporterの依存するサービスの起動順序を，次に示します。

Prometheus serverの場合

依存するサービスの起動順序

説明

local-fs.target

ローカルファイルシステム

remote-fs.target

リモートファイルシステム

rsyslog.service

rsyslog

ExporterやAlertmanager，Fluentd，imagent，imagentproxy，imagentactionの場合

依存するサービスの起動順序

説明

local-fs.target

ローカルファイルシステム

remote-fs.target

リモートファイルシステム

rsyslog.service

rsyslog

network.target

ネットワーク

終了タイムアウト時間を，次に示します。

プログラムの種類

終了タイムアウト時間（単位：秒）

Prometheus server

110

Alertmanager

60

Node exporter

Blackbox exporter

Yet another cloudwatch exporter

process_exporter

promitor_scraper

promitor_resource_discovery

script_exporter

Fluentd

OracleDB exporter

imagent

140

imagentproxy

imagentaction

60

ユーザーが変更できる個所を，次に示します。

コマンドラインのオプションを変更したい場合

ExecStart行を編集します。

■Prometheus serverの場合

prometheusコマンドの引数については，「サービス定義ファイル（jpc_プログラム名_service.xml）」の「prometheusコマンドのオプション」の説明を参照してください。

■Alertmanagerの場合

alertmanagerコマンドの引数については，「サービス定義ファイル（jpc_プログラム名_service.xml）」の「alertmanagerコマンドのオプション」の説明を参照してください。

■Node exporterの場合

Node exporterコマンドの引数については，下記の「node_exporterコマンドのオプション」の説明を参照してください。

■Yet another cloudwatch exporterの場合

yet-another-cloudwatch-exporterコマンドの引数については，下記の「yet-another-cloudwatch-exporterコマンドのオプション」の説明を参照してください。

■Process exporterの場合

process_exporterコマンドの引数については，「Process exporter設定ファイル（jpc_process_exporter.yml）」の「process_exporterコマンドのオプション」の説明を参照してください。

■Primitorの場合

promitor_scraperコマンドおよびpromitor_resource_discoveryコマンドには，指定できる引数はありません。

■Script exporterの場合

script_exporterコマンドの引数については，「サービス定義ファイル（jpc_プログラム名_service.xml）」の「script_exporterコマンドのオプション」の説明を参照してください。

■OracleDB exporterの場合

oracledb_exporterコマンドの引数については，「サービス定義ファイル（jpc_プログラム名_service.xml）」の「oracledb_exporterコマンドのオプション」の説明を参照してください。

ログ面数を変更したい場合

ExecStart行の-nオプションの後ろの値を編集します。指定できるログ面数は8〜512です。

ログサイズを変更したい場合

ExecStart行の末尾の値を編集します。

ログの出力先を変更したい場合

rotatelogsの引数で指定するログ出力先ディレクトリを編集します。

プロセスが異常停止したときに自動的にプロセスを再起動する場合，Restartに「always」を指定します。クラスタ構成など，自動的にプロセスを再起動しない場合，Restartに「no」を指定します。

node_exporterコマンドのオプション，およびyet-another-cloudwatch-exporterコマンドのオプションを，次に示します。

node_exporterコマンドのオプション

コレクターに関する項目は，「--collector.コレクター名」フラグで有効化できます。コレクターに関する項目を無効化する場合は，「--no-collector.コレクター名」フラグを指定します。

項目名

説明

変更可否

JP1/IM - Agentでユーザーが設定する内容

JP1/IM - Agentのデフォルト値

--collector.cpu.info

node_cpu_infoメトリックの収集を有効にします。

有効にする場合，--collector.cpu.infoを指定します。

無効にする場合，--no-collector.cpu.infoを指定します。

○

−

--collector.cpu.info

--collector.filesystem.ignored-mount-points

filesystemコレクターで無視するマウントポイントの正規表現を指定します。

○

filesystemコレクターで無視するマウントポイントの正規表現

--collector.filesystem.ignored-mount-points="^/(dev|proc|sys|var/lib/docker/.+)($|/)"

--collector.filesystem.ignored-fs-types

filesystemコレクターで無視するファイルシステムタイプの正規表現を指定します。

○

filesystemコレクターで無視するマウントポイントの正規表現

--collector.filesystem.ignored-fs-types="^/(dev|proc|sys|var/lib/docker/.+)($|/)"

--collector.netstat.fields

netstatコレクターに返すフィールドの正規表現を指定します。

○

netstatコレクターに返すフィールドの正規表現

--collector.netstat.fields="^(.*_(InErrors|InErrs) |Ip_Forwarding|Ip(6|Ext)_(InOctets|OutOctets)|Icmp6?_(InMsgs|OutMsgs)|TcpExt_(Listen.*|Syncookies.*|TCPSynRetrans)|Tcp_(ActiveOpens|InSegs|OutSegs|OutRsts|PassiveOpens|RetransSegs|CurrEstab)|Udp6?_(InDatagrams|OutDatagrams|NoPorts|RcvbufErrors|SndbufErrors))$"

--path.procfs

procfsマウントポイントを指定します。

○

procfsマウントポイント

--path.procfs="/proc"

--path.sysfs

sysfsマウントポイントを指定します。

○

sysfsマウントポイント

--path.sysfs="/sys"

--path.rootfs

rootfsマウントポイントを指定します。

○

rootfsマウントポイント

--path.rootfs="/"

--collector.systemd.unit-include

サービス監視機能で監視するSystemdのユニットファイル名を，正規表現で指定します。

初期設定は空文字で，サービスは1つも監視されません。正規表現が不正な場合，Node exporterのサービスの起動に失敗します。

正規表現の指定のしかたによって，性能情報の収集に時間がかかることがあります。詳細については，マニュアル「JP1/Integrated

Management 3 - Manager 導入・設計ガイド」の「付録G.4 正規表現を使用する際のヒント」を参照してください。

○

ユニットファイル名にマッチする正規表現

--collector.systemd.unit-include=""

--collector.cpu

cpuコレクターを有効にします。

有効にする場合，--collector.cpuを指定します。

無効にする場合，--no-collector.cpuを指定します。

○

−

--collector.cpu

--collector.diskstats

diskstatsコレクターを有効にします。

有効にする場合，--collector.diskstatsを指定します。

無効にする場合，--no-collector.diskstatsを指定します。

○

−

--collector.diskstats

--collector.filesystem

filesystemコレクターを有効にします。

有効にする場合，--collector.filesystemを指定します。

無効にする場合，--no-collector.filesystemを指定します。

○

−

--collector.filesystem

--collector.loadavg

loadavgコレクターを有効にします。

有効にする場合，--collector.loadavgを指定します。

無効にする場合，--no-collector.loadavgを指定します。

○

−

--collector.loadavg

--collector.meminfo

meminfoコレクターを有効にします。

有効にする場合，--collector.meminfoを指定します。

無効にする場合，--no-collector.meminfoを指定します。

○

−

--collector.meminfo

--collector.netclass

netclassコレクターを有効にします。

有効にする場合，--collector.netclassを指定します。

無効にする場合，--no-collector.netclassを指定します。

○

−

--collector.netclass

--collector.netdev

netdevコレクターを有効にします。

有効にする場合，--collector.netdevを指定します。

無効にする場合，--no-collector.netdevを指定します。

○

−

--collector.netdev

--collector.netstat

netstatコレクターを有効にします。

有効にする場合，--collector.netstatを指定します。

無効にする場合，--no-collector.netstatを指定します。

○

−

--collector.netstat

--collector.nfs

nfsコレクターを有効にします。

有効にする場合，--collector.nfsを指定します。

無効にする場合，--no-collector.nfsを指定します。

○

−

--collector.nfs

--collector.nfsd

nfsdコレクターを有効にします。

有効にする場合，--collector.nfsdを指定します。

無効にする場合，--no-collector.nfsdを指定します。

○

−

--collector.nfsd

--collector.stat

statコレクターを有効にします。

有効にする場合，--collector.statを指定します。

無効にする場合，--no-collector.statを指定します。

○

−

--collector.stat

--collector.systemd

systemdコレクターを有効にします。

有効する場合，--collector.systemdを指定します。

無効にする場合，--nocollector.systemdを指定します。

○

−

--collector.systemd

--collector.time

timeコレクターを有効にします。

有効にする場合，--collector.timeを指定します。

無効にする場合，--no-collector.timeを指定します。

○

−

--collector.time

--collector.uname

unameコレクターを有効にします。

有効にする場合，--collector.unameを指定します。

無効にする場合，--no-collector.unameを指定します。

○

−

--collector.uname

--collector.vmstat

vmstatコレクターを有効にします。

有効にする場合，--collector.vmstatを指定します。

無効にする場合，--no-collector.vmstatを指定します。

○

−

--collector.vmstat

--web.listen-address

待ち受けポートを指定します。リッスンするIPアドレスを限定したい場合は，ホスト名またはIPアドレスも記載します。ホスト名を指定する場合は255バイトまで指定できます。

このオプションに，ホスト名を指定する場合は，同じホスト上にあるNode exporterのディスカバリ設定ファイル（jpc_file_sd_config_node.yml）のtargetsに，このオプションと同じホスト名を設定し，Prometheus serverを再起動またはリロードする必要があります。

このオプションに，IPアドレスを指定する場合は，同じホスト上にあるNode exporterのディスカバリ設定ファイル（jpc_file_sd_config_node.yml）のtargetsに，このオプションと同じIPアドレスに解決されるホスト名を設定し，Prometheus serverを再起動またはリロードする必要があります。

＜設定例＞

すべてのIPアドレスに対する要求を受け付ける場合は，次のように設定します。

--web.listen-address=":20716"

受け付けるIPアドレスを制限する場合は，次のようにホスト名またはIPアドレスを指定して制限できます。

--web.listen-address="ホスト名またはIPアドレス:20716"

○

ポートを変更したい場合，または，リッスンするIPアドレスを限定したい場合に指定します。

--web.listen-address=":20716"

--web.max-requests

同時に受け付けるスクレイプ要求の最大数を指定します。

△

−

--web.max-requests=40

--log.level=info

指定されたレベル以上のメッセージだけをログに出力します。

指定できるレベルは，debug，info，warn，errorのどれかです。

△

サポート窓口から値の変更を指示されたときに設定を変更します。

通常は変更不要です。

--log.level=debug

（凡例）

〇：変更可　△：変更不可　−：該当なし

yet-another-cloudwatch-exporterコマンドのオプション

項目名

説明

変更可否

JP1/IM - Agentでユーザーが設定する内容

JP1/IM - Agentのデフォルト値

-cloudwatch-concurrency

Amazon CloudWatch APIへの最大同時リクエスト数を指定します。

○

最大同時リクエスト数

-cloudwatch-concurrency=5

-config.file

Yet another cloudwatch exporterの設定ファイルのパスを指定します。

○

−

-config.file="Agentパス/conf/jpc_ya_cloudwatch_exporter.yml"

-fips

FIPS準拠のAmazon Web Services（AWS）のAPIを使用する場合※に指定します。

注※

セキュリティ要件で，連邦情報処理規格（FIPS（Federal Information Processing Standard） 140-2）に準拠する必要がある場合などに指定してください。

○

有効にする場合は指定します。

指定しない（有効にしない）

-listen-address

待ち受けポートを指定します。リッスンするIPアドレスを限定したい場合は，ホスト名またはIPアドレスも記載します。ホスト名を指定する場合は255バイトまで指定できます。

このオプションに，ホスト名を指定する場合は，同じホスト上にあるYet another cloudwatch exporterのディスカバリ設定ファイル（jpc_file_sd_config_cloudwatch.yml）のtargetsに，このオプションと同じホスト名を設定し，Prometheus serverを再起動またはリロードする必要があります。

このオプションに，IPアドレスを指定する場合は，同じホスト上にあるYet another cloudwatch exporterのディスカバリ設定ファイル（jpc_file_sd_config_cloudwatch.yml）のtargetsに，このオプションと同じIPアドレスに解決されるホスト名を設定し，Prometheus serverを再起動またはリロードする必要があります。

＜設定例＞

すべてのIPアドレスに対する要求を受け付ける場合は，次のように設定します。

-listen-address=":20718"

受け付けるIPアドレスを制限する場合は，次のようにホスト名またはIPアドレスを指定して制限できます。

-listen-address="ホスト名またはIPアドレス:20718"

○

ポートを変更したい場合，または，リッスンするIPアドレスを限定したい場合に指定します。

-listen-address=":20718"

-metrics-per-query

1回のGetMetricsDataリクエストで作成されたメトリックの数を指定します。

○

通常は変更しません。

-metrics-per-query=500

-tag-concurrency

Resource Tagging APIへの最大同時リクエスト数を指定します。

○

通常は変更しません。

-tag-concurrency=5

（凡例）

〇：変更可　−：該当なし

Windows exporter設定ファイル（jpc_windows_exporter.yml）

形式

YAML形式で記述します。

collectors:
  enabled: cache,cpu,logical_disk,memory,net,system,cs,process,service※
collector:
  logical_disk:
    volume-whitelist: ".+"
    volume-blacklist: ""
  net:
    nic-whitelist: ".+"
    nic-blacklist: ""
  process:
    process-whitelist: ""
    process-blacklist: ""
  service:※
    services-where: "Name=''"
scrape:
  timeout-margin: 0.5

注※

JP1/IM - Agent 13-01以降のインストーラーがモデルファイルに設定する，サービス監視を行うためのパラメーターです。

JP1/IM - Agent 13-00から13-01以降にバージョンアップインストールしてサービス監視機能を使用する場合，手動でサービス監視のパラメーターを設定して編集します。詳細については，マニュアル「JP1/Integrated Management 3 - Manager 構築ガイド」の「1.21.2(5)(b)収集するメトリックを変更する（オプション）」のサービス監視の設定を行う手順を参照してください。

ファイル

jpc_windows_exporter.yml

jpc_windows_exporter.yml.model（モデルファイル）

格納先ディレクトリ

■統合エージェントホスト

物理ホストのとき

Agentパス¥conf¥

論理ホストのとき

共有フォルダ¥jp1ima¥conf¥

説明

Windows exporterの動作を規定する設定ファイルです。

文字コード

UTF-8（BOM無し）

改行コード

Windowsの場合：CR+LF

Linuxの場合：LF

定義の反映時期

Windows exporterを再起動したときに反映されます。

記述内容

項目名

説明

変更可否

JP1/IM - Agentでユーザーが設定する内容

JP1/IM - Agentのデフォルト値

collectors

−

−

−

−

enabled

使用するコレクターをコンマ区切りで指定します。

13-00の場合

△

13-01以降の場合

○

−

13-00の場合

collectors:

enabled:cache,cpu,logical_disk,memory,net,system,cs,process

13-01以降の場合

collectors:

enabled:cache,cpu,logical_disk,memory,net,system,cs,process,service

dfsr

−

−

−

−

exchange

−

−

−

−

mssql

−

−

−

−

collector

−

−

−

−

iis

−

−

−

−

logical_disk

−

−

−

−

volume-whitelist

収集対象とするボリュームを正規表現で設定します。

volume-whitelistとvolume-blacklistの両方に該当するボリュームは収集されません（volume-blacklistが優先されます）。

〇

ホワイトリストへのボリュームを正規表現で指定します。

collector:

logical_disk:

volume-whitelist: ".+"

volume-blacklist

収集対象としないボリュームを正規表現で設定します。

volume-whitelistとvolume-blacklistの両方に該当するボリュームは収集されません（volume-blacklistが優先されます）。

〇

ブラックリストへのボリュームを正規表現で指定します。

collector:

logical_disk:

volume-blacklist: ""

msmq

−

−

−

−

net

−

−

−

−

nic-whitelist

収集対象とするNICを正規表現で設定します。

nic-whitelistとnic-blacklistの両方に該当するNICは収集されません（nic-blacklistが優先されます）。

この項目に指定するNICの名称には，次のコマンドで取得した値を指定する必要があります。

wmic path Win32_PerfRawData_Tcpip_NetworkInterface get name

なお，この項目は正規表現として扱われるため，正規表現の特殊文字を指定したい場合は，バックスラッシュでエスケープする必要があります。このとき，YAMLではバックスラッシュが特殊文字として扱われるため，バックスラッシュを2回記述する必要があります。

（記述例）

「Intel[R] Dual Band Wireless-AC 8265」を完全一致で指定したい場合

nic-whitelist: "Intel¥¥[R¥¥] Dual Band Wireless-AC 8265"

〇

ホワイトリストへのNICを正規表現で指定します。

collector:

net:

nic-whitelist: ".+"

nic-blacklist

収集対象としないNICを正規表現で設定します。

nic-whitelistとnic-blacklistの両方に該当するNICは収集されません（nic-blacklistが優先されます）。

この項目の指定方法は，nic-whitelistと同じです。

〇

ブラックリストへのNICを正規表現で指定します。

collector:

net:

nic-blacklist: ""

process

−

−

−

−

whitelist

収集対象とするプロセス名を正規表現で設定します。

whitelistとblacklistの両方に該当するプロセス名は収集されません（blacklistが優先されます）。

指定を省略した場合，「".+"」が仮定されます。

○

−

collector:

process:

whitelist: ""

blacklist

収集対象としないプロセス名を正規表現で設定します。

whitelistとblacklistの両方に該当するプロセス名は収集されません（blacklistが優先されます）。

指定を省略した場合，「""」が仮定されます。

○

−

collector:

process:

blacklist: ""

service

−

−

−

−

services-where

WMIメトリッククエリで使用するWQLの'where'句を指定します。

「Name='サービス名'」の形式で指定します。複数のサービスを監視する場合はORを使用します。

（複数のサービスを監視する場合の指定例）

services-where: "Name='jpc_imagent' OR Name='jpc_imagentproxy' OR Name='jpc_imagentaction'"

注

不正な文字列を指定した場合，サービスの監視が行われません。ログの出力内容については，マニュアル「JP1/Integrated Management 3 - Manager 運用ガイド」の「12.5.1(4)node_exporterのログ」を参照してください。

○

監視するサービス名を指定します。

services-where: "Name=''"

smtp

−

−

−

−

textfile

−

−

−

−

log

−

−

−

−

scrape

−

−

−

−

timeout-margin

Prometheusのscrape_timeoutの値から減算する秒数を指定します（Prometheusのscrape_timeoutの値より小さい値を指定します）。

Prometheusのscrape_timeoutの値からこの項目に指定した値を減算した秒数でタイムアウトするようになります。

Prometheusのscrape_timeoutの値については，「Prometheus設定ファイル（jpc_prometheus_server.yml）」の「記述内容」のscrape_timeoutを参照してください。

〇

オーバーヘッドまたは高負荷を許容する通常は変更不要です。オーバーヘッドまたは高負荷を許容するように調整するときに使用します。

scrape:

timeout-margin: 0.5

（凡例）

〇：変更可　△：変更不可　−：該当なし

Process exporter設定ファイル（jpc_process_exporter.yml）

形式

YAML形式で記述します。

process_names:
  - name: "{{.ExeBase}};{{.Username}};{{.Matches.cmdline}}"
    cmdline:
    - (?P<cmdline>.*)

ファイル

jpc_process_exporter.yml

jpc_process_exporter.yml.model（モデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Agentパス¥conf¥

論理ホストのとき

共有フォルダ¥jp1ima¥conf¥

Linuxの場合

物理ホストのとき

/opt/jp1ima/conf/

論理ホストのとき

共有ディレクトリ/jp1ima/conf/

説明

Process exporterの動作を規定する設定ファイルです。

文字コード

UTF-8（BOM無し）

改行コード

Windowsの場合：CR+LF

Linuxの場合：LF

定義の反映時期

Process exporterを再起動したときです。

記述内容

項目名※

説明

変更可否

JP1/IM - Agentでユーザーが設定する内容

JP1/IM - Agentのデフォルト値

process_names

−

−

−

−

-

[name]

プロセス名を指定します。

デフォルトは「{{.ExeBase}}」です。テンプレートを使用できます。

プロセス名には，次の値を指定できます。

{{.Comm}}

オリジナルの実行ファイルのベースネーム（/proc/pid/statの2番目のフィールド）

{{.ExeBase}}

実行ファイルのベースネーム

{{.ExeFull}}

実行ファイルのフルパス

{{.Username}}

実効ユーザー名

{{.Matches}}

コマンドラインの正規表現のマッチ結果

{{.PID}}

プロセスID

{{.StartTime}}

開始時間

{{.Cgroups}}

サポートされていればプロセスのcgroup（/proc/self/cgroup）

プロセスの所属するコンテナの区別に使用できます。

○

プロセス名をデフォルト（実行ファイル名）以外に変更したい場合に指定します。

{{.ExeBase}};{{.Username}};{{.Matches.cmdline}}

<selector>

セレクタを指定します。

comm，exe，cmdlineを指定できます。

複数指定した場合は，すべてにマッチする必要があります。

◎

監視対象プロセスのセレクタ

cmdline

-

<any>

セレクタの値を指定します。

commの場合

/proc/pid/statの2番目のフィールド（"comm"）の値を指定します。15文字で打ち切られます。exeとは異なり，プログラムから変更できない値です。

＜設定例＞

bash

exeの場合

コマンド名（argv[0]）を指定します。スラッシュを含む場合は，スラッシュも正しく指定してください。

＜設定例＞

/usr/local/bin/prometheus

cmdlineの場合

引数の正規表現を4,096バイト以内で指定します。

process_exporterの引数については，「process_exporterコマンドのオプション」を参照してください。

＜設定例＞

- name: "{{.ExeFull}}:{{.Matches.Cfgfile}}"

exe:

- /usr/local/bin/process-exporter

cmdline:

- -config.path¥s+(?P<Cfgfile>¥S+)

値を複数指定したときは，commおよびexeの場合はOR条件，cmdlineの場合はAND条件となります。

◎

監視対象プロセスのセレクタの値

- (?P<cmdline>.*)

（凡例）

◎：設定必須　〇：変更可　−：該当なし

注※

[]はオプションを意味します。

process_exporterコマンドのオプション

項目名

説明

変更可否

JP1/IM - Agentでユーザーが設定する内容

JP1/IM - Agentのデフォルト値

-web.listen-address

待ち受けポートを指定します。

省略を指定した場合，「:9256」が仮定されます。

○

ポートを変更したい場合，または，リッスンするIPアドレスを限定したい場合に指定します。

20721

-procnames

取得するプロセスをコンマ区切りで指定します。

プロセス名には，/proc//statの"comm"フィールドの値を指定します。15文字で打ち切られます。

○

−

指定なし

-procfs

/procパスを指定します。

指定を省略した場合，「/proc」が仮定されます。

○

−

指定なし

-namemapping

プロセス名のマッピング（命名規則）を指定します。

コンマ区切りで名前と正規表現を指定します。リネームされた名前がprocnamesのリストにない場合は無視されます。

＜設定例＞

-namemapping "python2,([^/]+).py,java,-jar¥s+([^/]+).jar"

○

−

指定なし

-config.path

Process exporterの設定ファイルのパスを指定します。

○

−

インストール先/jp1ima/conf/jpc_process_exporter.yml

（凡例）

〇：変更可　−：該当なし

Blackbox exporter設定ファイル（jpc_blackbox_exporter.yml）

形式

YAML形式で記述します。

modules:
  http:
    prober: http
    http:
      method: GET
      compression: ""
      follow_redirects: true
      fail_if_ssl: false
      fail_if_not_ssl: false
      preferred_ip_protocol: ip4
      ip_protocol_fallback: false
      body: ""
      tls_config:
        insecure_skip_verify: true
  icmp:
    prober: icmp
    icmp:
      preferred_ip_protocol: ip4
      ip_protocol_fallback: false

ファイル

jpc_blackbox_exporter.yml

jpc_blackbox_exporter.yml.model（モデルファイル）

格納先ディレクトリ

■統合エージェントホスト

Windowsの場合

物理ホストのとき

Agentパス¥conf¥

論理ホストのとき

共有フォルダ¥jp1ima¥conf¥

Linuxの場合

物理ホストのとき

/opt/jp1ima/conf/

論理ホストのとき

共有ディレクトリ/jp1ima/conf/

■統合マネージャーホスト（モデルファイルだけ）

/opt/jp1pccspkg/jp1_pc_agent_probe/jp1_pc_agent_probe_windows_JP1/IM - Agentのバージョン番号（VVRRSS形式）/blackbox_exporter/conf/

/opt/jp1pccspkg/jp1_pc_agent_probe/jp1_pc_agent_probe_linux_JP1/IM - Agentのバージョン番号（VVRRSS形式）/blackbox_exporter/conf/

■監視エージェントホスト

Windowsの場合

物理ホストのとき

監視エージェントのインストール先ディレクトリ¥jp1pccs¥conf¥

論理ホストのとき

共有ディレクトリ¥jp1pccs¥conf¥

Linuxの場合

物理ホストのとき

監視エージェントのインストール先ディレクトリ/jp1pccs/conf/

論理ホストのとき

共有ディレクトリ/jp1pccs/conf/

説明

Blackbox exporterの動作を規定する設定ファイルです。

文字コード

UTF-8（BOM無し）

改行コード

Windowsの場合：CR+LF

Linuxの場合：LF

定義の反映時期

Blackbox exporterを再起動したとき，または，Blackbox exporterのリロードAPIを実行したときに反映されます。

記述内容

下記の表で使用している一般的なプレースホルダーの定義については，「ymlファイルの記述項目で使用している一般的なプレースホルダーの定義について」を参照してください。

項目名

説明

変更可否

JP1/IM - Agentでユーザーが設定する内容

JP1/IM - Agentのデフォルト値

Modules

−

〇

−

−

module_name

任意のモジュール名を指定します。

作成済みのモジュールと異なる設定のモジュールを作成したい場合に指定します。モジュールを作成する場合，スクレイプ定義とディスカバリ設定ファイルも作成する必要があります。セットアップ手順については，マニュアル「JP1/Integrated Management 3 - Manager 構築ガイド」で，Windowsの場合は「1.21.2(6)Blackbox exporterの設定」および「1.21.2(3)(c)Blackbox exporterのスクレイプジョブを追加する（Windowsの場合）（オプション）」，Linuxの場合は「2.19.2(7)Blackbox exporterの設定」および「2.19.2(3)(c)Blackbox exporterのスクレイプジョブを追加する（Linuxの場合）（オプション）」を参照してください。

作成済みのモジュールで監視を行う場合は，新たにmodule_nameを定義する必要はなく，作成済みのディスカバリ設定ファイルのtargetsに，監視対象の情報を追加します。

＜設定例＞

modules:

http_2xx:

〇

−

初期設定として定義するモジュールについては，マニュアル「JP1/Integrated Management 3 - Manager 構築ガイド」の「1.21.2(6)Blackbox exporterの設定」および「2.19.2(7)Blackbox exporterの設定」を参照してください。

prober: <prober_string>

プローブを行うプロトコルを指定します。

httpまたはicmpを指定できます。

〇

httpまたはicmpを指定する。

なし

[ http: <http_probe> ]

httpプロトコルの設定を行います。

詳細については，下記の<http_probe>の項目を参照してください。

〇

特定のプロトコルのパラメーターを指定します。

指定なし

[ icmp: <icmp_probe> ]

icmpプロトコルの設定を行います。

詳細については，下記の<icmp_probe>の項目を参照してください。

〇

特定のプロトコルのパラメーターを指定します。

指定なし

<http_probe>

−

−

−

−

[ valid_status_codes: <int>, ... ]

許容するHTTPステータスコードを指定します。

指定を省略した場合や空値を指定した場合は，200番台を許容します。

＜設定例＞

valid_status_codes: [200, 201]

〇

200番台以外のステータスコードを正常と扱う場合に指定します。

指定なし

[ valid_http_versions: <string>, ... ]

許容するHTTPバージョンを指定します。

指定を省略した場合や空を指定した場合は，すべてを許容します。

＜設定例＞

valid_http_versions: ["HTTP/1.1", "HTTP/2"]

〇

許容するHTTPバージョンを限定したい場合に指定します。

指定なし

[ method: <string>]

利用するHTTPメソッドを指定します。

＜設定例＞

method: GET

〇

利用するHTTPメソッドを指定します。

GET

headers: [ <string>: <string> ... ]

HTTPリクエストのヘッダーを指定します。

「Accept-Encoding」ヘッダーを指定している場合は，ompressionの項目も参照してください。

＜設定例＞

headers:

Host: host.example.com

Accept-Language: en-US

〇

HTTPリクエストのヘッダーを指定します。

指定なし

[ compression: <string> ]

レスポンスを解凍するために使用する圧縮アルゴリズムを指定します。

gzip，br，deflate，identityを指定できます。

「Accept-Encoding」ヘッダーを指定する場合は，このオプションで指定した圧縮アルゴリズムが許容される必要があります。

〇

使用する圧縮アルゴリズムを指定します。

""

[ follow_redirects: <boolean>]

HTTPのリダイレクトに従うかどうかを指定します。

trueまたはfalseを指定できます。

〇

有効にする場合trueを指定します。

有効(true)

[ fail_if_ssl: <boolean>]

SSLが提示されたらプローブを失敗させるかどうかを指定します。

trueまたはfalseを指定できます。

〇

有効にする場合trueを指定します。

無効(false)

[ fail_if_not_ssl: <boolean>]

SSLが提示されなかったら失敗させるかどうかを指定します。

trueまたはfalseを指定できます。

〇

有効にする場合trueを指定します。

無効(false)

fail_if_body_matches_regexp:[ - <regex>, ... ]

応答本文にマッチする場合に不正と扱う正規表現を指定します。

応答本文が正規表現にマッチする場合にプローブ失敗となります。

マルチバイト文字は指定できません。

＜設定例＞

fail_if_body_matches_regexp:

- "Could not connect to database"

〇

応答本文の内容によってプローブを失敗させたい場合に指定します。

指定なし

fail_if_body_not_matches_regexp:[ - <regex>, ... ]

応答本文にマッチしない場合に不正と扱う正規表現を指定します。応答本文が正規表現にマッチしない場合にプローブ失敗となります。

マルチバイト文字は指定できません。

＜設定例＞

fail_if_body_not_matches_regexp:

- "Download the latest version here"

〇

応答本文の内容によってプローブを失敗させたい場合に指定します。

指定なし

fail_if_header_matches:[ - <http_header_match_spec>, ... ]

レスポンスヘッダーにマッチする場合に不正と扱う正規表現を指定します。レスポンスヘッダーが正規表現にマッチする場合にプローブ失敗となります。複数の値を持つヘッダーの場合は，少なくとも1つがマッチするときに失敗と扱います。

詳細については，下記の<http_header_match_spec>参照してください。

〇

レスポンスヘッダーの内容によってプローブを失敗させたい場合に指定します。

指定なし

fail_if_header_not_matches:[ - <http_header_match_spec>, ... ]

レスポンスヘッダーにマッチしない場合に不正と扱う正規表現を指定します。レスポンスヘッダーが正規表現にマッチしない場合にプローブ失敗となります。複数の値を持つヘッダーの場合は，すべてにマッチしないときに失敗と扱います。

詳細については，下記の<http_header_match_spec>を参照してください。

〇

レスポンスヘッダーの内容によってプローブを失敗させたい場合に指定します。

指定なし

tls_config:[ <tls_config> ]

HTTPプローブのTLSプロトコルの構成を設定します。

詳細については，下記の<tls_config>を参照してください。

〇

詳細については，<tls_config>の項目を参照してください。

次に示す値を指定します。

insecure_skip_verify: true

basic_auth:

ターゲットのHTTP基本認証の認証情報を設定します。

〇

−

なし

[ username: <string> ]

ターゲットにアクセスするためのユーザー名を指定します。

パスワードは，シークレット管理コマンドを使用して登録する必要があります。

〇

Basic認証の場合に指定します。

なし

[ proxy_url: <string> ]

監視対象への接続に使用するHTTPプロキシサーバを指定します。

形式:

http://ホスト名またはIPアドレス：ポート番号

〇

監視対象に接続するためにプロキシサーバを経由する場合に必要です。

なし

[ skip_resolve_phase_with_proxy: <boolean> ]

HTTPプロキシ（proxy_url）が設定されている場合に，Blackbox exporterが実施するDNS解決とURLの変更をスキップする場合はtrue，スキップしない場合はfalseを指定します。

例えば監視対象がhttps://www.example.com:1234でプロキシを経由する場合に，Blackbox exporterがDNS解決とURLの変更によりhttps://123.45.67.8:1234を使用してプロキシを通過しようとし，プロキシがhttps://www.example.com:1234しか許可しておらず監視対象に接続できない場合，trueを設定することで監視対象に接続できます。

指定がない場合はfalseになります。

【13-00-01以降】○

HTTPプロキシ（proxy_url）が設定されている場合に，DNS解決とURLの変更をスキップする場合はtrue，スキップしない場合はfalseを指定します。

なし

[ proxy_user: <string> ]

監視対象への接続に使用するHTTPプロキシサーバがBasic認証を必要とする場合に，ユーザー名を指定します。

ユーザー名は，URLエンコードしないユーザー名を指定してください。

パスワードは，シークレット管理コマンドを使用して登録する必要があります。

〇

監視対象に接続するために認証ありのプロキシサーバを経由する場合に必要です。

なし

[ preferred_ip_protocol: <string>]

優先するプロトコルを指定します。

ip4だけが指定できます。

◎

ip4を指定します。

なし

[ ip_protocol_fallback: <boolean> ]

優先プロトコルが選べない場合は後退するかどうかを指定します。

falseだけが指定できます。

◎

falseを指定します。

なし

body: [ <string> ]

プローブで使用されるHTTPリクエストの本文を指定します。

◎

プローブで使用されるHTTPリクエストの本文を指定します。

""

<http_header_match_spec>

−

−

−

−

header: <string>,

ヘッダーフィールド名を指定します。

＜設定例＞

fail_if_header_matches: # Verifies that no cookies are set

- header: Set-Cookie

allow_missing: true

regexp: '.*'

◎

ヘッダーフィールド名を指定します。

なし

regexp: <regex>,

比較文字列（正規表現）を指定します。

マルチバイト文字は指定できません。

◎

比較文字列（正規表現）を指定します。

なし

[ allow_missing: <boolean> ]

ヘッダーフィールドがない場合を許容するかどうかを指定します。

〇

有効にする場合trueを指定します。

false

<icmp_probe>

−

−

−

−

[ preferred_ip_protocol: <string>]

優先するプロトコルを指定します。

ip4だけが指定できます。

◎

ip4を指定します。

−

[ ip_protocol_fallback: <boolean> ]

優先プロトコルが選べない場合は後退するかどうかを指定します。

falseだけが指定できます。

◎

falseを指定します。

−

[ source_ip_address: <string> ]

送信元IPアドレスを指定します。

〇

送信元IPアドレスを固定する場合に指定します。

指定なし

[ dont_fragment: <boolean> ]

IPヘッダーのDFビットを指定します。

trueまたはfalseを指定できます。

ip4だけで動作します。

〇

フラグメントさせない場合に指定します。

指定なし

<tls_config>

−

−

−

−

[ insecure_skip_verify: <boolean> ]

ターゲットの証明書の検証を無効にするかどうかを指定します。

trueまたはfalseを指定できます。

次に示すメトリックを監視する場合，falseを指定し，証明書を配置して，証明書ファイルのパスを該当するパラメーターに指定する必要があります。また，trueを指定すると，次に示すメトリックの値は正しい値となりません。

probe_ssl_last_chain_expiry_timestamp_seconds

なお，Blackbox exporter（HTTP/HTTPS監視）のディスカバリ設定ファイル（jpc_file_sd_config_blackbox_http.yml）のtargetsのURLに，ホスト名ではなくIPアドレスを指定している場合，falseを指定することはできません。

〇

検証を無効にする場合はtrue，有効にする場合はfalseを指定します。

httpモジュールの場合

true

上記以外の場合

指定なし

[ ca_file: <filename> ]

ターゲットに使用するCA証明書を指定します。

です。

Insecure_skip_verifyパラメーターをfalseにしている場合は必須で指定します。

次に示すディレクトリ下にファイルを配置してファイルのパスを指定します。

Linuxの場合

インストール先ディレクトリ/jp1ima/conf/user/cert/

Windowsの場合

インストール先ディレクトリ¥jp1ima¥conf¥user¥cert¥

詳細については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「付録A.4 JP1/IM - Agent」で，統合エージェントホストのJP1/IM - Agentでユーザーが参照・編集できるファイルおよびディレクトリの説明を参照してください。

〇

CA証明書ファイルを指定します。

指定なし

[ cert_file: <filename> ]

ターゲットのクライアント証明書ファイルを指定します。

監視対象がクライアント認証を必要とする場合は必須で指定します。

次に示すディレクトリ下にファイルを配置してファイルのパスを指定します。

Linuxの場合

インストール先ディレクトリ/jp1ima/conf/user/cert/

Windowsの場合

インストール先ディレクトリ¥jp1ima¥conf¥user¥cert¥

詳細については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「付録A.4 JP1/IM - Agent」で，統合エージェントホストのJP1/IM - Agentでユーザーが参照・編集できるファイルおよびディレクトリの説明を参照してください。

〇

クライアント証明書ファイルを指定します。

−

[ key_file: <filename> ]

ターゲットのクライアント証明書キーファイルを指定します。

監視対象がクライアント認証を必要とする場合は必須で指定します。

次に示すディレクトリ下にファイルを配置してファイルのパスを指定します。

Linuxの場合

インストール先ディレクトリ/jp1ima/conf/user/secret/

Windowsの場合

インストール先ディレクトリ¥jp1ima¥conf¥user¥secret¥

詳細については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「付録A.4 JP1/IM - Agent」で，統合エージェントホストのJP1/IM - Agentでユーザーが参照・編集できるファイルおよびディレクトリの説明を参照してください。

〇

クライアント証明書キーファイルを指定します。

−

[ server_name: <string> ]

ターゲットのホスト名を確認するために使用するサーバ名を指定します。

〇

サーバ名を指定します。

ターゲットホストのホスト名

（凡例）

◎：設定必須　〇：変更可　−：該当なし

Yet another cloudwatch exporter設定ファイル（jpc_ya_cloudwatch_exporter.yml）

形式

YAML形式で記述します。

discovery:
  exportedTagsOnMetrics:
    AWS/EC2:
      - jp1_pc_nodelabel
    AWS/Lambda:
      - jp1_pc_nodelabel
    AWS/S3:
      - jp1_pc_nodelabel
    AWS/DynamoDB:
      - jp1_pc_nodelabel
    AWS/States:
      - jp1_pc_nodelabel
    AWS/SQS:
      - jp1_pc_nodelabel
    AWS/ESC:
      - jp1_pc_nodelabel
    AWS/EBS:
      - jp1_pc_nodelabel
    AWS/EFS:
      - jp1_pc_nodelabel
    AWS/FSx:
      - jp1_pc_nodelabel
    AWS/SNS:
      - jp1_pc_nodelabel
    AWS/RDS:
      - jp1_pc_nodelabel
  jobs:
  - type: AWS/EC2
    regions:
      - ap-northeast-1
    period: 0
    length: 600
    delay: 120
    metrics:
      - name: CPUUtilization
        statistics:
        - Average
      - name: DiskReadBytes
        statistics:
        - Sum
      - name: DiskWriteBytes
        statistics:
        - Sum

ファイル名

jpc_ya_cloudwatch_exporter.yml

jpc_ya_cloudwatch_exporter.yml.model（モデルファイル）

格納先ディレクトリ

■統合エージェントホスト

Windowsの場合

物理ホストのとき

Agentパス¥conf¥

論理ホストのとき

共有フォルダ¥jp1ima¥conf¥

Linuxの場合

物理ホストのとき

/opt/jp1ima/conf/

論理ホストのとき

共有ディレクトリ/jp1ima/conf/

■統合マネージャーホスト（モデルファイルだけ）

/opt/jp1pccspkg/jp1_pc_agent_cloud/jp1_pc_agent_cloud_linux_JP1/IM - Agentのバージョン番号（VVRRSS形式）/ya_cloudwatch_exporter/conf/

■監視エージェントホスト

物理ホストの場合

監視エージェントのインストール先ディレクトリ/jp1pccs/conf/

論理ホストの場合

共有ディレクトリ/jp1pccs/conf/

説明

Yet another cloudwatch exporterの動作を規定する設定ファイルです。

文字コード

UTF-8（BOM無し）

改行コード

Windowsの場合：CR+LF

Linuxの場合：LF

定義の反映時期

Yet another cloudwatch exporterを再起動したときに，Yet another cloudwatch exporterの動作に反映されます。

また，上記の操作を行ったあと，jddcreatetreeコマンドおよびjddupdatetreeコマンドを実行したときに，統合オペレーション・ビューアーのツリーの表示内容に反映されます。

記述内容

最上位のパラメーター

次の表に示すdiscoveryを記載します。

項目名

説明

変更可否

JP1/IM - Agentでユーザーが設定する内容

JP1/IM - Agentのデフォルト値

discovery

Auto-discoveryを設定します。

詳細については，下記の<Auto-discovery configuration>を参照してください。

〇

<Auto-discovery configuration>を参照してください。

なし

（凡例）

〇：変更可

<Auto-discovery configuration>

項目名

説明

変更可否

JP1/IM - Agentでユーザーが設定する内容

JP1/IM - Agentのデフォルト値

<Auto-discovery configuration>

−

−

−

−

exportedTagsOnMetrics

すべてのメトリックにエクスポートするサービスごとのタグのリストを指定します。

jp1_pc_nodelabelタグは必ず指定してください。

＜リストの例＞

exportedTagsOnMetrics:

AWS/EC2:

- jp1_pc_nodelabel

- type

注意事項

タグ付けされたAWSリソースだけが検出されます。

〇

すべてのメトリックにエクスポートするサービスごとのタグのリスト

exportedTagsOnMetrics:

AWS/EC2:

- jp1_pc_nodelabel

AWS/Lambda:

- jp1_pc_nodelabel

AWS/S3:

- jp1_pc_nodelabel

AWS/DynamoDB:

- jp1_pc_nodelabel

AWS/States:

- jp1_pc_nodelabel

AWS/SQS:

- jp1_pc_nodelabel

AWS/EBS:

- jp1_pc_nodelabel

AWS/ECS:

- jp1_pc_nodelabel

AWS/EFS:

- jp1_pc_nodelabel

AWS/FSx:

- jp1_pc_nodelabel

AWS/RDS:

- jp1_pc_nodelabel

AWS/SNS:

- jp1_pc_nodelabel

ECS/ContainerInsights:

- jp1_pc_nodelabel

jobs

Auto-discovery jobのリストを設定します。

下記の<Auto-discovery job>を参照してください。

◎

<Auto-discovery job>を参照してください。

−

（凡例）

◎：設定必須　〇：変更可　−：該当なし

<Auto-discovery job>

項目名

説明

変更可否

JP1/IM - Agentでユーザーが設定する内容

JP1/IM - Agentのデフォルト値

<Auto-discovery job>

−

−

−

−

regions

AWSリージョンのリストを指定します。

◎

AWSリージョンのリスト

ap-northeast-1

type

名前空間名（"AWS / EC2"， "AWS / S3"など）を指定します。

指定できる名前空間（サービス）については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「3.15.6(1)(k)Yet another cloudwatch exporterのIM管理ノードの作成」の，JP1/IM - AgentのYet another cloudwatch exporterが監視対象としてサポートするAWSの名前空間について説明している個所を参照してください。

◎

名前空間名

AWS/EC2

AWS/Lambda

AWS/S3

AWS/DynamoDB

AWS/States

AWS/SQS

AWS/EBS

AWS/ECS

AWS/EFS

AWS/FSx

AWS/RDS

AWS/SNS

ECS/ContainerInsights

length

CloudWatchからデータを取得する期間を秒数で指定します。

取得開始時刻は「現在時刻−（length＋delay）」となります。

〇

データを要求するまでの時間（秒単位）

AWS/S3以外の設定

length: 600

AWS/S3の設定

length: 172800

delay

現在時刻に対して何秒前までのデータを要求するかを指定します。

取得終了時刻は「現在時刻−delay」となります。

〇

−

delay: 120

roles

引き受けるIAMロールを指定します。

ロールは2つまで記述できます。

＜設定例＞

roles:

- roleArn: "arn:aws:iam::1111111111111:role/cross_access_role"

- roleArn: "arn:aws:iam::2222222222222:role/cross_access_role"

〇

引き受けるIAMロールのリスト

指定なし

searchTags

特定のタグを持つデータだけを収集する場合に，使用するキーと値のペアのリスト（すべて一致する必要があります）を指定します。

値は正規表現にできます。

なお，デフォルトで設定されているエントリーは削除しないでください。

＜設定例＞

searchTags:

- key: env

value: production

〇

キーと値のペアのリスト

searchTags:

- key: jp1_pc_nodelabel

value: .*

period

CloudWatchから取得するデータの粒度を秒単位で指定します。

〇

秒単位の統計期間

0

customTags

キーと値のペアのリストとして追加するカスタムタグを指定します。

＜設定例＞

customTags:

- key: CustomTag

value: CustomValue

〇

カスタムタグ

指定なし

metrics

メトリック定義のリストを設定します。

詳細については，下記の<metric definitions>を参照してください。

◎

メトリクス定義のリスト

メトリック定義ファイルの初期値で定義されているメトリックを設定します。

メトリック定義ファイルの初期値については，「Yet another cloudwatch exporterのメトリック定義ファイル（metrics_ya_cloudwatch_exporter.conf）」の「モデルファイルの設定内容（初期状態）」について説明している個所を参照してください。

（凡例）

◎：設定必須　〇：変更可　−：該当なし

<metric definitions>

項目名

説明

変更可否

JP1/IM - Agentでユーザーが設定する内容

JP1/IM - Agentのデフォルト値

<metric definitions>

−

−

−

−

name

CloudWatchメトリック名を指定します。

◎

CloudWatchメトリック名

なし

statistics

統計タイプをリスト形式で指定します。

「Minimum」，「Maximum」などを指定します。

＜設定例＞

statistics:

- Average

◎

統計タイプ

なし

period

CloudWatchから取得するデータの粒度を秒単位で指定します。

この定義はジョブレベル設定を上書きします。

〇

秒単位の統計期間

<Auto-discovery job>のperiodが0の場合

300

<Auto-discovery job>のperiodが0以外の場合

<Auto-discovery job>のperiodの設定値

nilToZero

CloudWatchから情報を取得できなかったときに0と扱う場合はTrueを指定します。

デフォルトはFalseです。

〇

有効にする場合はTrueを指定します。

指定なし

（凡例）

◎：設定必須　〇：変更可　−：該当なし

Promitor Scraper設定ファイル（metrics-declaration.yaml）

形式

YAML形式で記述します。

verion: v1
azureMetadata:
  tenantId: テナントID
  subscriptionId: サブスクリプションID
  resourceGroupName: リソースグループ名
metricDefaults:
  aggregation:
    interval: 00:05:00
  scraping:
  schedule: "0 * * ? * *"
metrics:
  - name: azure_virtual_machine_disk_read_bytes_total
    description: "Bytes read from disk during monitoring period."
    scraping:
      schedule: "0 * * ? * *"
    azureMetricConfiguration:
      metricName: Disk Read Bytes
      aggregation:
        type: Total
    resourceDiscoveryGroups:
    - name: virtual-machine-group

ファイル

metrics-declaration.yaml

metrics-declaration.yaml.model（モデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Agentパス¥conf¥promitor¥scraper¥

論理ホストのとき

共有フォルダ¥jp1ima¥conf¥promitor¥scraper¥

Linuxの場合

物理ホストのとき

/opt/jp1ima/conf/promitor/scraper/

論理ホストのとき

共有ディレクトリ/jp1ima/conf/promitor/scraper/

説明

Promitor Scraperの取得するメトリクスを定義する設定ファイルです。

文字コード

UTF-8（BOM無し）

改行コード

Windowsの場合：CR+LF

Linuxの場合：LF

定義の反映時期

Promitor Scraperを再起動したとき，Promitor Scraperの動作に反映されます。

また，上記の操作を行ったあと，jddcreatetreeコマンドおよびjddupdatetreeコマンドを実行したとき，統合オペレーション・ビューアーのツリーの表示内容に反映されます。

記述内容

項目名※

説明

変更可否

JP1/IM - Agentでユーザーが設定する内容

JP1/IM - Agentのデフォルト値

version

バージョンとして固定値「v1」を指定します。

△

−

v1

azureMetadata:

接続先Azureの情報を設定します。

−

−

−

tenantId:

テナントIDを指定します。

◎

テナントID

指定なし

subscriptionId:

デフォルトのサブスクリプションIDを指定します。

◎

サブスクリプションID

指定なし

resourceGroupName:

デフォルトのリソースグループ名を指定します。

◎

リソースグループ名

指定なし

[cloud:]

Azureクラウドの名前を指定します。

Global，China，UsGoy，Germanyを指定できます。

指定を省略した場合，「Global」が仮定されます。

○

−

指定なし

metricDefaults:

メトリックのデフォルトを設定します。

−

−

−

aggregation:

集約の設定をします。

○

−

−

[interval]:

メトリクスの測定値を集計するインターバルの値を指定します。

○

−

00:05:00

[limit]:

ディメンションやフィルタを指定したときの最大のリソース数を指定します。

指定を省略した場合，「10000」が仮定されます。

○

−

指定なし

labels:

すべてのメトリクスに付与するラベルを設定します。

−

−

−

<key>: <value>

キーとバリューの値をそれぞれ1〜255文字の文字列で指定します。

キーは，正規表現[a-z _:][a-z0-9_:]*と一致する文字で指定する必要があります。

バリューは，マルチバイト文字は使用できません。

○

−

指定なし

scraping:

スクレイピングを設定します。

−

−

−

schedule:

Azureからメトリクスを取得するスケジュール（毎分，毎時など）をAzureのCRON式で指定します。

＜設定例＞

スケジュールを毎分とする場合

0 * * ? * *

○

−

"0 * * ? * *"

Promitorの設定例，および，JP1/IM - Agentが提供するPrometheusとAzure Monitorの収集間隔のデフォルトは1分です。

metrics:

メトリクスを設定します。

−

−

−

-

name:

Prometheusで表示されるメトリクス名を1〜255文字の文字列で指定します。

正規表現[a-zA-Z_:][a-zA-Z0-9_:]*と一致する文字で指定する必要があります。

○

−

metricに応じて異なります。

description:

メトリクスの説明を，1〜255文字の制御文字以外の文字で指定します

○

−

metricに応じて異なります。

resourceType:

リソース種別を指定します。

指定できる値を次に示します。

VirtualMachine

FunctionApp

ContainerInstance

KubernetesService

FileStorage

BlobStorage

ServiceBusNamespace

CosmosDb

SqlDatabase

SqlManagedInstane

SqlElasticPool

LogicApp

○

−

metricに応じて異なります。

[labels:]

メトリクスに付与するラベルを設定します。

−

−

−

<key>: <value>

キーとバリューの値をそれぞれ1〜255文字の文字列で指定します。

キーは，正規表現[a-z _:][a-z0-9_:]*と一致する文字で指定する必要があります。

バリューは，マルチバイト文字は使用できません。

○

−

指定なし

[scraping:]

スクレイピングを設定します。

−

−

−

schedule:

Azureからメトリクスを取得するスケジュール（毎分，毎時など）をAzureのCRON式で指定します。

＜設定例＞

スケジュールを毎分とする場合

0 * * ? * *

○

−

指定なし

azureMetricConfiguration:

Azureのメトリクス定義を設定します。

−

−

−

metricName:

Azureでのメトリクス名を指定します。

指定できる値については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「3.15.1(1)(h)Promitor（Azure Monitor性能情報収集機能）」の「収集できるメトリック」を参照してください。

○

−

metricに応じて異なります。

[limit:]

ディメンションやフィルタを指定したときの最大のリソース数を指定します。

指定を省略した場合，metricDefault.limitの値が仮定されます。

○

−

指定なし

[dimension:]

マルチディメンションのメトリクスの場合に取得するディメンションを設定します。

−

−

−

name:

ディメンション名を指定します。

○

−

metricに応じて異なります。

aggregation:

集約を設定します。

−

−

−

type:

集約タイプを指定します。

○

−

metricに応じて異なります。

[interval:]

メトリクスの測定値を集計するインターバルの値を指定します。

○

−

指定なし

[resources:]

リソースを設定します。

リソースディスカバリを使用しないときに指定します。

−

−

−

-

<property>

リソース名などを指定します。指定方法はリソース種別に応じて異なります。

指定する値を次に示します。

リソース種別がVirtualMachineの場合

virtualMachineName

リソース種別がFunctionAppの場合

functionAppName, slotName（任意）

リソース種別がContainerInstanceの場合

containerGroup

リソース種別がKubernetesServiceの場合

clusterName

リソース種別がFileStorageの場合

accountName

リソース種別がBlobStorageの場合

accountName

リソース種別がServiceBusNamespaceの場合

namespace, queueName（任意）, topicName（任意）

リソース種別がCosmosDbの場合

dbName

リソース種別がSqlDatabaseの場合

serverName, databaseName

リソース種別がSqlServerの場合

serverName

リソース種別がSqlManagedInstanceの場合

instanceName

リソース種別がSqlElasticPoolの場合

serverName, poolName

リソース種別がLogicAppの場合

workflowName

○

−

metricに応じて異なります。

[resourceGroupName:]

リソースグループ名（デフォルトと異なるとき）を指定します。

○

−

指定なし

[subscriptionId:]

サブスクリプションID（デフォルトと異なるとき）を指定します。

○

−

指定なし

[resourceDiscoveryGroups:]

ディスカバリグループの設定をします。リソースディスカバリを使用するときに指定します。

−

−

−

-

name:

ディスカバリグループ名を指定します。

○

−

metricに応じて異なります。

（凡例）

◎：設定必須　〇：変更可　△：変更不可　−：該当なし

注※

[]はオプションを意味します。

Promitor Scraper runtime設定ファイル（runtime.yaml）

形式

YAML形式で記述します。

authentication:
  mode: ServicePrincipal
  identityId:  クライアントID
server:
  httpPort:  20719
metricSinks:
  prometheusScrapingEndpoint:
    enableMetricTimestamps:true
    baseUriPath: /metrics
metricsConfiguration:
  absolutePath:  インストールディレクトリ/jp1pccs/conf/promitor/scraper/metrics-declaration.yaml
resourceDiscovery:
  host: インストールホスト名
  enabled: true
  port: 20720

ファイル

runtime.yaml

runtime.yaml.model（モデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Agentパス¥conf¥promitor¥scraper¥

論理ホストのとき

共有フォルダ¥jp1ima¥conf¥promitor¥scraper¥

Linuxの場合

物理ホストのとき

/opt/jp1ima/conf/promitor/scraper/

論理ホストのとき

共有ディレクトリ/jp1ima/conf/promitor/scraper/

説明

Promitor Scraperの認証情報やスクレイプ用ポートなどを定義する設定ファイルです。

文字コード

UTF-8（BOM無し）

改行コード

Windowsの場合：CR+LF

Linuxの場合：LF

定義の反映時期

Promitor Scraperを再起動したとき，Promitor Scraperの動作に反映されます。

また，上記の操作を行ったあと，jddcreatetreeコマンドおよびjddupdatetreeコマンドを実行したとき，統合オペレーション・ビューアーのツリーの表示内容に反映されます。

記述内容

項目名※

説明

変更可否

JP1/IM - Agentでユーザーが設定する内容

JP1/IM - Agentのデフォルト値

authentication:

Azureの認証情報を設定します。

−

−

−

[mode:]

認証方法を指定します。

指定できる値を次に示します。

ServicePrincipal

SystemAssignedManagedIdentity

UserAssignedManagedIdentity

PromitorがAzure上にあるときは，SystemAssignedManagedIdentityまたはUserAssignedManagedIdentityを指定することを推奨します。

PromitorがAzure上にないときは，ServicePrincipalを指定します。

◎

−

ServicePrincipal

[identityId:]

IDを指定します。

modeがServicePrincipalの場合は，クライアントIDを指定します。

modeがSystemAssignedManagedIdentityまたはUserAssignedManagedIdentityの場合は，指定不要です。

◎

−

指定なし

[server:]

サーバの情報を設定します。

−

−

−

[httpPort:]

ポートを指定します。

指定を省略した場合，「80」が仮定されます。

○

−

20719

[metricSinks:]

メトリクスの情報を設定します。

−

−

−

[prometheusScrapingEndpoint:]

Prometheusの情報を設定します。

−

−

−

[enableMetricTimestamps:]

タイムスタンプを有効にするかを指定します。

△

−

true

baseUriPath:

スクレイプするパスを指定します。

△

−

/metrics

[metricsConfiguration:]

メトリクスの情報を設定します。

−

−

−

[absolutePath:]

メトリクス設定ファイルのパスを，1〜255文字の文字列で指定します。

指定を省略した場合，「/config/metrics-declaration.yaml」が仮定されます。

○

−

インストール先/jp1ima/conf/promitor/scraper/metrics-declaration.yaml

[resourceDiscovery:]

Promitor Resource Discovery Agentの情報を設定します。

−

−

−

host:

Promitor Resource Discovery Agentのホスト名を指定します。

○

−

インストール時にホスト名が設定されます。

[enabled:]

Promitor Resource Discovery Agentを使用するかを指定します。

trueまたはfalseを指定できます。

○

−

true

port:

Promitor Resource Discovery Agentのポートを指定します。

○

−

20720

（凡例）

◎：設定必須　〇：変更可　△：変更不可　−：該当なし

注※

[]はオプションを意味します。

Promitor Resource Discovery設定ファイル（resource-discovery-declaration.yaml）

形式

YAML形式で記述します。

verion: v1
azureLandscape:
  tenantId: テナントID
  subscriptions:
  - サブスクリプションID
resourceDiscoveryGroups:
  - name: virtual-machine-group
    type: VirtualMachine
  - name: function-app-group
    type: FunctionApp

ファイル

resource-discovery-declaration.yaml

resource-discovery-declaration.yaml.model（モデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Agentパス¥conf¥promitor¥resource-discovery¥

論理ホストのとき

共有フォルダ¥jp1ima¥conf¥promitor¥resource-discovery¥

Linuxの場合

物理ホストのとき

/opt/jp1ima/conf/promitor/resource-discovery/

論理ホストのとき

共有ディレクトリ/jp1ima/conf/promitor/resource-discovery/

説明

Promitor Resource Discoveryの取得するリソースグループを定義する設定ファイルです。

文字コード

UTF-8（BOM無し）

改行コード

Windowsの場合：CR+LF

Linuxの場合：LF

定義の反映時期

Promitor Resource Discoveryを再起動したとき，Promitor Resource Discoveryの動作に反映されます。

また，上記の操作を行ったあと，jddcreatetreeコマンドおよびjddupdatetreeコマンドを実行したとき，統合オペレーション・ビューアーのツリーの表示内容に反映されます。

記述内容

項目名※

説明

変更可否

JP1/IM - Agentでユーザーが設定する内容

JP1/IM - Agentのデフォルト値

version

バージョンとして固定値の「v1」を指定します。

△

−

v1

azureLandscape:

接続先Azureの情報を設定します。

−

−

−

tenantId:

テナントIDを指定します。

◎

テナントID

指定なし

subscriptions:

サブスクリプションの情報を設定します。

−

−

−

-

<subscriptionId>

サブスクリプションIDを指定します。

◎

サブスクリプションID

指定なし

resourceDiscoveryGroups:

ディスカバリグループを設定します。

−

−

−

-

name:

Scraperで指定するディスカバリーグループ名を256バイト以内で指定します。

○

−

resourceDiscoveryGroupに応じて異なります。

type:

Azureのリソース種別を指定します。

指定できる値を次に示します。

VirtualMachine

FunctionApp

ContainerInstance

KubernetesService

FileStorage

BlobStorage

ServiceBusNamespace

CosmosDb

SqlDatabase

SqlManagedInstane

SqlElasticPool

LogicApp

○

−

resourceDiscoveryGroupに応じて異なります。

[criteria:]

取得対象とする条件を設定します。取得対象をフィルタしたい場合に指定します。

−

−

−

include:

取得対象に含める条件を指定します。

−

−

指定なし

[subscriptions:]

サブスクリプションのリストを指定します。

−

−

指定なし

-

<subscriptionId>

サブスクリプションIDを指定します。

○

−

指定なし

[resourceGroups:]

リソースグループのリストを指定します。

−

−

指定なし

-

<resourceGroupName>

リソースグループ名を指定します。

○

−

指定なし

[tags:]

Azureタグのリストを指定します。

−

−

指定なし

<key>: <value>

Azureタグの値を指定します。

正規表現で指定できます。

○

−

指定なし

[regions:]

リージョンのリストを指定します。

−

−

指定なし

-

<region>

リージョンを指定します。

○

−

指定なし

（凡例）

◎：設定必須　〇：変更可　△：変更不可　−：該当なし

注※

[]はオプションを意味します。

Promitor Resource Discovery runtime設定ファイル（runtime.yaml）

形式

YAML形式で記述します。

authentication:
  mode: ServicePrincipal
  identityId:  クライアントID
server:
  httpPort:  20720

ファイル

runtime.yaml

runtime.yaml.model（モデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Agentパス¥conf¥promitor¥resource-discovery¥

論理ホストのとき

共有フォルダ¥jp1ima¥conf¥promitor¥resource-discovery¥

Linuxの場合

物理ホストのとき

/opt/jp1ima/conf/promitor/resource-discovery/

論理ホストのとき

共有ディレクトリ/jp1ima/conf/promitor/resource-discovery/

説明

Promitor Resource Discoveryの認証情報やスクレイプ用ポートなどを定義する設定ファイルです。

文字コード

UTF-8（BOM無し）

改行コード

Windowsの場合：CR+LF

Linuxの場合：LF

定義の反映時期

Promitor Resource Discoveryを再起動したとき，Promitor Resource Discoveryの動作に反映されます。

また，上記の操作を行ったあと，jddcreatetreeコマンドおよびjddupdatetreeコマンドを実行したとき，統合オペレーション・ビューアーのツリーの表示内容に反映されます。

記述内容

項目名※

説明

変更可否

JP1/IM - Agentでユーザーが設定する内容

JP1/IM - Agentのデフォルト値

authentication:

Azureの認証に関する情報を設定します。

−

−

−

[mode:]

認証方法を指定します。

指定できる値を次に示します。

ServicePrincipal

SystemAssignedManagedIdentity

UserAssignedManagedIdentity

PromitorがAzure上にあるときは，SystemAssignedManagedIdentityまたはUserAssignedManagedIdentityを指定することを推奨します。

PromitorがAzure上にないときは，ServicePrincipalを指定します。

◎

−

ServicePrincipal

[identityId:]

IDを指定します。

modeがServicePrincipalの場合は，クライアントIDを指定します。

modeがSystemAssignedManagedIdentityまたはUserAssignedManagedIdentityの場合は，指定不要です。

◎

−

指定なし

[server:]

サーバの情報を設定します。

−

−

−

[httpPort:]

ポートを指定します。

指定を省略した場合，「80」が仮定されます。

○

−

20720

（凡例）

◎：設定必須　〇：変更可　−：該当なし

注※

[]はオプションを意味します。

Script exporter設定ファイル（jpc_script_exporter.yml）

形式

YAML形式で記述します。

scripts:
  - name: run_scriptA
    command: ./examples/scriptA.sh
    timeout:
      max_timeout: 120
  - name: run_scriptB
    command: ./examples/scriptB.sh
    args:
      - arg1
      - arg2

ファイル

jpc_script_exporter.yml

jpc_script_exporter.yml.model（モデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Agentパス¥conf¥

論理ホストのとき

共有フォルダ¥jp1ima¥conf¥

Linuxの場合

物理ホストのとき

/opt/jp1ima/conf/

論理ホストのとき

共有ディレクトリ/jp1ima/conf/

説明

Script exporterの動作を規定する設定ファイルです。

文字コード

UTF-8（BOM無し）

改行コード

Windowsの場合：CR+LF

Linuxの場合：LF

定義の反映時期

Script exporterを再起動したときです。

記述内容

項目名※

説明

変更可否

JP1/IM - Agentでユーザーが設定する内容

JP1/IM - Agentのデフォルト値

scripts:

スクリプトに関する情報を設定します。

−

−

指定なし

-

name:

Prometheusで表示するスクリプト名を，1〜255文字以内の文字列で指定します。

Prometheusでラベルの値に使用できる文字列（Unicodeの文字）を指定する必要があります。

◎

監視対象スクリプト名（任意の名前）

指定なし

command:

実行するスクリプトを指定します。

スクリプトの出力形式については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「3.15.1 JP1/IM - Agentによる性能監視機能」で，PrometheusのText-based formatを説明している個所を参照してください。

＜設定例＞

"/bin/foo"

＜出力例＞

# HELP metric_name description

# TYPE metric_name gauge

metric_name {label1="labelvalue1"} 12345

metric_name {label1="labelvalue2"} 67890

◎

監視対象のスクリプト

指定なし

args:

スクリプトの引数を指定します。

＜設定例＞

- "--output"

- "/dev/null"

◎

スクリプトの引数（引数がない場合は指定不要）

指定なし

timeout:

タイムアウトに関する情報を設定します。

○

−

指定なし

max_timeout:

タイムアウトの値を秒数で指定します。

指定を省略した場合，Prometheusで設定したタイムアウトの値が仮定されます。

○

タイムアウトにする秒数

指定なし

enforced:

タイムアウトになったときにスクリプトを強制終了するかを指定します。

trueまたはfalseを指定できます。

指定を省略した場合，「false」が仮定されます。

○

タイムアウトになったときにスクリプトを強制終了するか

指定なし

（凡例）

◎：設定必須　〇：変更可　−：該当なし

注※

[]はオプションを意味します。

SAPシステム監視のScript exporter設定ファイルのサンプルファイル（jpc_script_exporter_sap.yml）

形式

次に示す条件で，SAPシステムを監視する場合の定義例をサンプルとして提供します。

■条件

＜SAPシステムのログ抽出コマンド共通＞

マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「3.15.5 SAPシステム監視機能」の前提条件に記載している条件が満たされている。

Script exporterのサービス定義ファイルに指定されている作業フォルダからの相対パスで，下記のフォルダに環境パラメーター設定ファイルが格納されている。

../conf/user/

IM管理ノードのカテゴリ

Enterprise

max_timeoutの値には，Prometheus serverのスクレイプ間隔よりも小さい値を指定してください。max_timeoutの値には30を設定しているため，Prometheus serverのスクレイプ間隔が30以下である場合，max_timeoutの値を変更してください。

＜jr3slgetコマンド＞

SAPインスタンス「o246bci_SD5_00」のシステムログ情報を出力する。

コマンドを実行してシステムログ情報を抽出する場合の環境パラメーター設定ファイル（jr3slget.ini）で，次の情報を指定済みである。

RFC接続情報

ターゲット情報

システムログ情報の出力先のログファイル

コマンドの作業ディレクトリ

環境パラメーター設定ファイルに指定されている作業フォルダ以下のjr3slgetフォルダにタイムスタンプファイルが格納されている。

IM管理ノードのラベル名：SAP Syslog extractor(jr3slget)

＜jr3algetコマンド＞

モニターセット名に「SAP CCMS Monitor Templates」，モニター名を「Entire System」を指定してCCMSアラート情報を出力する。

コマンドを実行してCCMSアラート情報を抽出する場合の環境パラメーター設定ファイル（jr3alget.ini）で，次の情報を指定済みである。

RFC接続情報

ターゲット情報

CCMSアラート情報の出力先のログファイル

コマンドの作業ディレクトリ

環境パラメーター設定ファイルに指定されている作業フォルダ以下のjr3algetフォルダにタイムスタンプファイルが格納されている。

IM管理ノードのラベル名：SAP CCMS Alert extractor(jr3alget)

■定義例

scripts:
  - name: SAP Syslog extractor(jr3slget)
    command: jr3slgetコマンドのパス
    args:
      - "-lasttime"
      - "sltimestamp.txt"
      - "-x2"
      - "-cnf"
      - "../conf/user/jr3slget.ini"
    timeout:
      max_timeout: 30
      enforced: true

  - name: SAP CCMS Alert extractor(jr3alget)
    command: jr3algetコマンドのパス
    args:
      - "-lasttime"
      - "altimestamp.txt"
      - "-x2"
      - "-cnf"
      - "../conf/user/jr3alget.ini"
    timeout:
      max_timeout: 30
      enforced: true

ファイル

jpc_script_exporter_sap.yml

格納先ディレクトリ

■統合エージェントホスト

Windowsの場合

物理ホストのとき

Agentパス¥conf¥sample¥

Linuxの場合

物理ホストのとき

/opt/jp1ima/conf/sample/

説明

SAPシステム監視のScript exporterの動作を規定する設定ファイルです。

サンプルファイル（jpc_script_exporter_sap.yml）をコピーし，コピー先のファイル名を「jpc_script_exporter.yml」に変更して，Script exporter設定ファイル（jpc_script_exporter.yml）の配置先に配置して使用します。ファイルの配置先については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「付録A.4(3)統合エージェントホスト（Windows）」および「付録A.4(4)統合エージェントホスト（Linux）」を参照してください。

文字コード

「Script exporter設定ファイル（jpc_script_exporter.yml）」の「文字コード」の説明を参照してください。

改行コード

「Script exporter設定ファイル（jpc_script_exporter.yml）」の「改行コード」の説明を参照してください。

定義の反映時期

「Script exporter設定ファイル（jpc_script_exporter.yml）」の「定義の反映時期」の説明を参照してください。

記述内容

「Script exporter設定ファイル（jpc_script_exporter.yml）」の「記述内容」の説明を参照してください。

Script exporter設定ファイルにSAPシステムのログ抽出コマンドを実行するスクリプトを定義する場合，script.nameには実行するSAPシステムのログ抽出コマンド名（jr3slget，またはjr3alget）を含める必要があります。含めない場合，SAPシステム監視のメトリック送信機能のIM管理ノードがOther Applicationsカテゴリ配下に作成されます。

複数のRFC接続先を定義する場合（マルチインスタンス）など，パラメーターの設定内容が異なる環境パラメーター設定ファイルを複数作成したときは，次に示す定義例のように複数のスクリプトを定義します。

scripts:
  - name: SAP Syslog extractor(jr3slget)_A
    command: C:/Program Files (x86)/Hitachi/jp1pc/agtm/evtrap/jr3slget.exe
    args:
      - "-lasttime"
      - "sltimestamp_A.txt"
      - "-x2"
      - "-cnf"
      - "../conf/user/jr3slget_A.ini"
    timeout:
      max_timeout: 30
      enforced: true

  - name: SAP CCMS Alert extractor(jr3alget)_A
    command: C:/Program Files (x86)/Hitachi/jp1pc/agtm/evtrap/jr3alget.exe
    args:
      - "-lasttime"
      - "altimestamp_A.txt"
      - "-x2"
      - "-cnf"
      - "../conf/user/jr3alget_A.ini"
    timeout:
      max_timeout: 30
      enforced: true

  - name:  SAP Syslog extractor(jr3slget)_B
    command: C:/Program Files (x86)/Hitachi/jp1pc/agtm/evtrap/jr3slget.exe
    args:
      - "-lasttime"
      - "sltimestamp_B.txt"
      - "-x2"
      - "-cnf"
      - "../conf/user/jr3slget_B.ini"
    timeout:
      max_timeout: 30
      enforced: true

  - name:  SAP CCMS Alert extractor(jr3alget)_B
    command: C:/Program Files (x86)/Hitachi/jp1pc/agtm/evtrap/jr3alget.exe
    args:
      - "-lasttime"
      - "altimestamp_B.txt"
      - "-x2"
      - "-cnf"
      - "../conf/user/jr3alget_B.ini"
    timeout:
      max_timeout: 30
      enforced: true

ログ監視共通定義ファイル（jpc_fluentd_common.conf）

形式

@include jpc_fluentd_common_wevt_rendered.conf（Windowsの場合のみ）
@include jpc_fluentd_common_list.conf

## [System Settings]
<system>
  log_level ログレベル
  format text
  time_format %Y-%m-%d %H:%M:%S %z
  workers workerの数
</system>

<worker 0>
## [Remote Write Settings]
  <filter jpc_ima_metrics.**>
    @type record_transformer
    enable_ruby true
    auto_typecast true
    renew_record true

    <record>
      labels ${record}
      samples ${[[time.utc.to_i*1000,1]]}
    </record>
  </filter>

  <match jpc_ima_metrics.**>
    @type http
    headers {"accept":"application/json"}
    content_type application/json
    json_array false
    endpoint 統合エージェント制御基盤のトレンドデータ書き込みAPI
    <buffer>
      flush_interval 60s
      disable_chunk_backup true
    </buffer>
  </match>
</worker>

<worker 1-workerのid>
## [Output Settings]
  <match {tail.*.jp1event,wevt.*.jp1event}>
    @type copy
    copy_mode no_copy
    <store>
      @type http
      endpoint 統合エージェント制御基盤のJP1イベント変換API
      headers {"accept":"application/json"}
      content_type application/json
      json_array true
      open_timeout 60
      read_timeout 60
      error_response_as_unrecoverable true
      retryable_response_codes [503]
      <buffer tag>
        @type file
        flush_interval フラッシュ間隔
        overflow_action バッファキューが一杯になった時のoutputプラグインの動作
        retry_wait リトライ間隔
        path ../data/fluentd/buffer
        timekey_wait 600
        timekey_use_utc false
        timekey_zone local timezone
        chunk_limit_size 32MB
        total_limit_size バッファサイズの上限
        chunk_full_threshold 0.95
        queued_chunks_limit_size 1
        compress text
        flush_at_shutdown false
        flush_mode default
        flush_thread_count 1
        flush_thread_interval 1.0
        flush_thread_burst_interval 1.0
        delayed_commit_timeout 60
        retry_forever true
        retry_type periodic
        retry_wait 10s
        disable_chunk_backup false
      </buffer>
    </store>
    <store>
      @type relabel
      @label @STDOUT
    </store>
  </match>

## [Private Settings]
  <match {tail.*.outputlog,wevt.*.outputlog}>
    @type relabel
    @label @STDOUT
  </match>

  <label @STDOUT>
    <match {tail.**,wevt.**}>
      @type stdout
      <format>
        @type out_file
        time_type string
        time_format %Y-%m-%d %H:%M:%S %z
        localtime true
        utc false
      </format>
    </match>
  </label>
</worker>

ファイル

jpc_fluentd_common.conf

jpc_fluentd_common.conf.model（モデルファイル）

格納先ディレクトリ

■統合エージェントホスト

Windowsの場合

物理ホストのとき

Agentパス¥conf¥

論理ホストのとき

共有フォルダ¥jp1ima¥conf¥

Linuxの場合

物理ホストのとき

/opt/jp1ima/conf/

論理ホストのとき

共有ディレクトリ/jp1ima/conf/

説明

HTTP POSTリクエスト機能やログ出力機能など，ログ監視機能で共通の動作を定義するためのファイルです。

先頭の文字が「#」である行は，コメントとして扱い，プログラムの動作には影響しません。

文字コード

UTF-8（BOM無し）

改行コード

Windowsの場合：CR+LF

Linuxの場合：LF

定義の反映時期

Fluentdのサービスを再起動したときに，Fluentdの動作に反映します。

記述内容

<worker>ディレクティブ

Fluentdが起動するworkerのidを引数に指定することで，指定したidのworkerでのみ，ディレクティブ内で指定したプラグインが動作します。

workerのid（オプション）

Fluentdが起動するworkerのidを指定します。<worker N-M>ディレクティブの引数として機能します。Nは常に1を指定します。Mに指定する値は，workerの数に指定した整数から1を引いた数を指定します。

[System Settings]セクション

ログ監視機能全体の動作に影響する設定を行います。

ログレベル（オプション）

Fluentdのログレベルを指定します。

説明

変更可否

JP1/IM - Agentでユーザーが設定する内容

JP1/IM - Agentの初期値

指定できるログレベルを冗長性の昇順で次に示します。

fatal

error

warn

info

debug

trace

デフォルトは「info」です。Fluentdは，デフォルトでinfo，warn，error，およびfatalのログを出力します。

変更可

確認したいログのレベルに合わせて設定します。

info

workerの数（オプション）

説明

変更可否

JP1/IM - Agentでユーザーが設定する内容

JP1/IM - Agentの初期値

Fluentdが起動するworkerの数を指定します。指定できる値は，1から31の整数です。

変更可

ログ監視共通定義ファイル，テキスト形式のログファイルの監視定義ファイル，Windowsイベントログの監視定義ファイル，ログメトリクス定義ファイルの合計数を指定します。

10

[Output Settings]セクション

ログ監視機能で監視したログデータを出力するための設定を行います。

統合エージェント制御基盤のJP1イベント変換API（オプション）

説明

変更可否

JP1/IM - Agentでユーザーが設定する内容

JP1/IM - Agentの初期値

HTTPリクエストのエンドポイントを512バイト以内で指定します。HTTPSを使用する場合は，httpsプレフィックスを使用します。

＜設定例＞

# Use HTTP

endpoint http://example.com/api

# Use HTTPS. You can set additional HTTPS parameters like tls_xxx

endpoint https://example.com/api

このパラメーターは，プレースホルダーをサポートしているため，時間，タグ，およびレコードフィールドを埋め込むことができます。プレースホルダーが機能するには，<buffer>セクションも必要です。

＜設定例＞

endpoint http://example.com/api/${tag}-${key}

<buffer tag,key>

# buffer parameters

</buffer>

endpointには，メトリックとログデータの送信先を指定します。詳細については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「3.15.3 JP1/IM - Agentによるログ監視機能」の「(9)HTTP POSTリクエスト機能（httpプラグイン）」を参照してください。

endpointに指定したURLが誤っている場合は，警告メッセージが出力され，メトリックやログデータが送信されません。そのため，ユーザーはFluentdの起動後，メトリックとログデータのPOST時のログに，警告が出ていないことを確認する必要があります。

設定必須

JP1イベントを発行するため，統合エージェント制御基盤のJP1イベント変換APIのURLを指定します。統合エージェント制御基盤のポート番号を変更している場合，設定変更が必要です。

http://統合エージェントホスト名:20726/ima/api/v1/proxy/service/imdd/im/api_system/v1/events/transform

フラッシュ間隔（オプション）

説明

変更可否

JP1/IM - Agentでユーザーが設定する内容

JP1/IM - Agentの初期値

buffer内に保管したログデータを，統合エージェント制御基盤に送信する間隔を指定します。

指定できる値は，1s〜86,400sです。単位（s）は必須です。

指定なしも動作します。

可

送信間隔を変更します。

60s

バッファキューが一杯になった時のoutputプラグインの動作（オプション）

説明

変更可否

JP1/IM - Agentでユーザーが設定する内容

JP1/IM - Agentの初期値

bufferキューが一杯になったときのoutputプラグインの動作を指定します。指定できる値を次に示します。

throw_exception

Fluentdのログにエラーを出力します。監視対象のログファイルに新しくログが出力されてもバッファに追加しません。送信が成功するようになると，ログファイルに出力されているログはトラップされますが，ラップして消えてしまっている場合はロストします。

drop_oldest_chunk

最も古いチャンクを削除して，新しく入ってきたチャンクを受け入れます。

可

bufferキューが一杯になったときのoutputプラグインの動作を指定します。

throw_exception

リトライ間隔（オプション）

説明

変更可否

JP1/IM - Agentでユーザーが設定する内容

JP1/IM - Agentの初期値

送信失敗したチャンクのリトライ間隔を指定します。

指定できる値は，1s〜600sです。単位（s）は必須です。

このパラメーターに空白，または，不正な形式で値を指定した場合，リトライ間隔は，Winsows環境では2秒程度，Linux環境では0.02秒程度になります。

可

リトライ間隔を指定します。

10s

バッファサイズの上限（オプション）

説明

変更可否

JP1/IM - Agentでユーザーが設定する内容

JP1/IM - Agentの初期値

bufferプラグインのインスタンスのサイズ制限を指定します。

指定できる値は32MB〜65536MBです。

保存されたバッファの合計サイズがこのしきい値に達すると，すべての追加操作はエラーで失敗し，データは失われます。

バッファは，JP1/IM - Agentをセットアップした環境のディスクの容量を使用します。バッファの合計サイズは，次の計算式で見積もりを行います。

「0.015MB × バッファリングするJP1イベントの件数」

可

bufferプラグインのインスタンスのサイズ制限を指定します。

4096MB

[Remote Write Settings]セクション

FluentdがJP1/IM - Managerのトレンドデータ管理DBにサンプルを送信するための設定を行います。

統合エージェント制御基盤のトレンドデータ書き込みAPI（オプション）

説明

変更可否

JP1/IM - Agentでユーザーが設定する内容

JP1/IM - Agentの初期値

HTTPリクエストのエンドポイントを512バイト以内で指定します。HTTPSを使用する場合は，httpsプレフィックスを使用します。

＜設定例＞

# Use HTTP

endpoint http://example.com/api

# Use HTTPS. You can set additional HTTPS parameters like tls_xxx

endpoint https://example.com/api

このパラメーターは，プレースホルダーをサポートしているため，時間，タグ，およびレコードフィールドを埋め込むことができます。プレースホルダーが機能するには，<buffer>セクションも必要です。

＜設定例＞

endpoint http://example.com/api/${tag}-${key}

<buffer tag,key>

# buffer parameters

</buffer>

endpointには，メトリックとログデータの送信先を指定します。詳細については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「3.15.3 JP1/IM - Agentによるログ監視機能」の「(9)HTTP POSTリクエスト機能（httpプラグイン）」を参照してください。

endpointに指定したURLが誤っている場合は，警告メッセージが出力され，メトリックやログデータが送信されません。そのため，ユーザーはFluentdの起動後，メトリックとログデータのPOST時のログに，警告が出ていないことを確認する必要があります。

設定必須

メトリックをJP1/IM - Managerに送信するため，統合エージェント制御基盤のトレンドデータ書き込みAPIのURLを指定します。統合エージェント制御基盤のポート番号を変更している場合，設定変更が必要です。

http://統合エージェントホスト名:20727/ima/api/v1/proxy/service/promscale/write

[Private Settings]セクション

編集不可です。

定義例

## [System Settings]
<system>
  log_level info
  format text
  time_format %Y-%m-%d %H:%M:%S %z
  workers 10
</system>

<worker 0>
## [Remote Write Settings]
  <filter jpc_ima_metrics.**>
    @type record_transformer
    enable_ruby true
    auto_typecast true
    renew_record true

    <record>
      labels ${record}
      samples ${[[time.utc.to_i*1000,1]]}
    </record>
  </filter>
  <match jpc_ima_metrics.**>
    @type http
    headers {"accept":"application/json"}
    content_type application/json
    json_array false
    endpoint http://統合エージェントホスト名:20727/ima/api/v1/proxy/service/promscale/write
    <buffer>
      flush_interval 60s
      disable_chunk_backup true
    </buffer>
  </match>
</worker>

<worker 1-9>
## [Output Settings]
  <match {tail.*.jp1event,wevt.*.jp1event}>
    @type copy
    copy_mode no_copy
    <store>
      @type http
      endpoint http://統合エージェントホスト名:20726/ima/api/v1/proxy/service/imdd/im/api_system/v1/events/transform
      headers {"accept":"application/json"}
      content_type application/json
      json_array true
      open_timeout 60
      read_timeout 60
      error_response_as_unrecoverable true
      retryable_response_codes [503]
      <buffer tag>
        @type file
        flush_interval 5s
        overflow_action throw_exception
        retry_wait 10s
        path ../data/fluentd/buffer
        timekey_wait 600
        timekey_use_utc false
        timekey_zone local timezone
        chunk_limit_size 32MB
        total_limit_size 4096MB
        chunk_full_threshold 0.95
        queued_chunks_limit_size 1
        compress text
        flush_at_shutdown false
        flush_mode default
        flush_thread_count 1
        flush_thread_interval 1.0
        flush_thread_burst_interval 1.0
        delayed_commit_timeout 60
        retry_forever true
        retry_type periodic
        retry_wait 10s
        disable_chunk_backup false
      </buffer>
    </store>
    <store>
      @type relabel
      @label @STDOUT
    </store>
  </match>

## [Private Settings]
  <match {tail.*.outputlog,wevt.*.outputlog}>
    @type relabel
    @label @STDOUT
  </match>

  <label @STDOUT>
    <match {tail.**,wevt.**}>
      @type stdout
      <format>
        @type out_file
        time_type string
        time_format %Y-%m-%d %H:%M:%S %z
        localtime true
        utc false
      </format>
    </match>
  </label>
</worker>

ログ監視対象定義ファイル（jpc_fluentd_common_list.conf）

形式

## [Target Settings]
@include 監視定義ファイル名
・・・

ファイル

jpc_fluentd_common_list.conf

jpc_fluentd_common_list.conf.model（モデルファイル）

格納先ディレクトリ

■統合エージェントホスト

Windowsの場合

物理ホストのとき

Agentパス¥conf¥

論理ホストのとき

共有フォルダ¥jp1ima¥conf¥

Linuxの場合

物理ホストのとき

/opt/jp1ima/conf/

論理ホストのとき

共有ディレクトリ/jp1ima/conf/

説明

ログ監視の対象を指定する定義ファイルです。指定する対象として，テキスト形式のログファイルの監視定義ファイル，または，Windowsイベントログの監視定義ファイルのファイル名を指定します。指定した監視定義ファイルのログ監視が有効となります。

初期設定では，次に示すように定義されていて，conf/userディレクトリ以下にあるすべての「テキスト形式のログファイルの監視定義ファイル」と「Windowsイベントログの監視定義ファイル」のログ監視が有効となります。

・初期設定

## [Target Settings]
@include user/fluentd_*_tail.conf
@include user/fluentd_*_wevt.conf（Windowsの場合のみ）

先頭の文字が「#」である行は，コメントとして扱い，プログラムの動作には影響しません。一時的に一部の監視定義ファイルのログ監視を止める運用を行いたい場合は，監視定義ファイルを列挙しておき，ログ監視を行わない監視定義ファイルの行をコメントアウトします。

文字コード

UTF-8（BOM無し）

改行コード

Windowsの場合：CR+LF

Linuxの場合：LF

定義の反映時期

Fluentdのサービスを再起動したときに，Fluentdの動作に反映します。

記述内容

[Target Settings]セクション

ログ監視機能で使用する監視定義ファイル名を設定します。

監視定義ファイル名（オプション）

テキスト形式のログファイルの監視定義ファイル，または，Windowsイベントログの監視定義ファイルのファイル名を指定することで，指定した監視定義ファイルのログ監視が有効となります。監視定義ファイル名に含まれる「*」はワイルドカード（任意の文字列）を表します。指定できるワイルドカードは「*」だけです。

指定を省略した場合，ログ監視は行われません。

Windows環境の場合は，アルファベットの大文字・小文字を区別しません。Linux環境の場合は，アルファベットの大文字・小文字を区別します。

監視定義ファイル名に指定できるファイル数は，Windows環境の場合は最大1,016個，Linux環境の場合は最大508個です。

定義例

次に示す定義例では，「fluentd_abcd_tail.conf」と「fluentd_abcd_wevt.conf」の監視定義ファイルの設定が有効となり，「fluentd_efgh_tail.conf」の監視定義ファイルの設定は無効となります。

## [Target Settings]
@include fluentd_abcd_tail.conf
#@include fluentd_efgh_tail.conf
@include fluentd_abcd_wevt.conf

テキスト形式のログファイルの監視定義ファイル（fluentd_@@trapname@@_tail.conf.template）

形式

<worker 0>
## [Metric Settings]
<source>
  @type exec
  command "echo {}"
  <parse>
    @type json
  </parse>
  run_interval 60s
  tag jpc_ima_metrics.tail.ログ監視名
</source>

<filter jpc_ima_metrics.tail.ログ監視名>
  @type record_transformer
  enable_ruby true
  auto_typecast false
  <record>
    __name__ fluentd_logtrap_running
    instance ホスト名
    jp1_pc_nodelabel IM管理ノードのラベル名
    jp1_pc_category カテゴリID
    jp1_pc_logtrap_defname ログ監視名_tail
    jp1_pc_trendname fluentd
    job jpc_fluentd
    jp1_pc_nodelabel_fluentd Log trapper(Fluentd)
    jp1_pc_addon_program JPC Fluentd
  </record>
</filter>
</worker>
<worker workerのid>
## [Input Settings]
<source>
  @type tail
  tag tail.ログ監視名
  path 監視対象のパス
  follow_inodes true
  refresh_interval 60
  skip_refresh_on_startup false
  read_from_head Fluentd初回起動時に監視するログを先頭から読み込む
#  encoding "Fluentdの文字コード"
#  from_encoding "監視するログの文字コード"
  read_lines_limit 1000
  read_bytes_limit_per_second -1
  pos_file ../data/fluentd/tail/ログ監視名.pos
  path_key tailed_path
  rotate_wait 5s
  enable_watch_timer 追加のウォッチタイマーを有効にする
  複数行ログ読み込み時のフラッシュ間隔
  enable_stat_watcher true
  open_on_every_update false
  emit_unmatched_lines false
  ignore_repeated_permission_error false
  <parse>
    @type ログのフォーマット
    ログのフォーマットに応じた設定
  </parse>
</source>

## [Attributes Settings]
<filter tail.ログ監視名>
  @type record_transformer
  enable_ruby true
  auto_typecast false
  renew_record true

  <record>
    ID イベントID
    MESSAGE ${record["message"]}
    JP1_SOURCEHOST ホスト名
    JPC_LOG_TIME ${time.utc.to_i}
    PRODUCT_NAME /HITACHI/JP1/JPCCS2/LOGTRAP/IM管理ノードのラベル名
    PPNAME /HITACHI/JP1/JPCCS2
    SEVERITY 重大度
    PLATFORM ${ if RUBY_PLATFORM.downcase =~ /mswin(?!ce)|mingw|cygwin|bccwin/; 'NT'; else 'UNIX'; end }
    OBJECT_TYPE LOGFILE
    OBJECT_NAME ${record['tailed_path']}
    ROOT_OBJECT_TYPE LOGFILE
    ROOT_OBJECT_NAME ${record['tailed_path']}
    JP1_TRAP_NAME ${tag_parts[1]}
    JPC_NODELABEL IM管理ノードのラベル名
    任意の属性名 任意の値
  </record>
</filter>

## [Inclusion Settings]
#<filter tail.ログ監視名>
#  @type grep
#  <regexp>
#    key JP1イベントの属性名
#    pattern /監視するログの正規表現/
#  </regexp>
#</filter>

## [Exclusion Settings]
#<filter tail.ログ監視名>
#  @type grep
#  <exclude>
#    key JP1イベントの属性名
#    pattern /監視しないログの正規表現/
#  </exclude>
#</filter>

## [Forward Settings]
<match tail.ログ監視名>
  @type rewrite_tag_filter
  <rule>
    key JP1イベントの属性名
    pattern /JP1イベントを発行するログの正規表現/
    tag ${tag}.jp1event
  </rule>
  <rule>
    key SEVERITY
    pattern /.*/
    tag ${tag}.outputlog
  </rule>
</match>

<filter /tail¥.ログ監視名¥.(jp1event|outputlog)/>
  @type record_transformer
  enable_ruby true
  auto_typecast true
  renew_record true
  <record>
    eventId ${record['ID']}
    xsystem true
    message ${record['MESSAGE']}
    attrs ${record}
  </record>
  remove_keys $.attrs.ID
  remove_keys $.attrs.MESSAGE
</filter>
</worker>

ファイル

fluentd_@@trapname@@_tail.conf.template

fluentd_@@trapname@@_tail.conf.template.model（モデルファイル）

格納先ディレクトリ

■統合エージェントホスト

Windowsの場合

物理ホストのとき

Agentパス¥conf¥

論理ホストのとき

共有フォルダ¥jp1ima¥conf¥

Linuxの場合

物理ホストのとき

/opt/jp1ima/conf/

論理ホストのとき

共有ディレクトリ/jp1ima/conf/

説明

テキスト形式のログファイルを監視するための定義ファイルです。

テンプレート（fluentd_@@trapname@@_tail.conf.template）をコピーし，コピー先のファイル名を「fluentd_ログ監視名_tail.conf」に変更して使用します。「fluentd_ログ監視名_tail.conf」の配置先については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「付録A.4(3)統合エージェントホスト（Windows）」および「付録A.4(4)統合エージェントホスト（Linux）」を参照してください。ファイル名は，統合エージェントホスト内で重複しない名前としてください。ログ監視名は，1〜30文字の文字列で指定します。使用できる文字は，半角英数字，「-」（ハイフン），および「_」（アンダースコア）です。

監視対象の，ラップアラウンドするログファイル群ごと（ラップアラウンドしないログファイルの場合はログファイルごと）に監視定義ファイルを作成します。JP1/IM - Agentは，監視定義ファイルのIM管理ノードのラベル名に設定されている値に応じて，ログ監視対象のSIDのIM管理ノードを作成します。別の監視定義ファイルであっても，IM管理ノードのラベル名が同一であれば，作成するIM管理ノードは1つです。

テキスト形式のログファイルの監視機能は，この定義ファイルを読み込み，アプリケーションがテキスト形式のログファイルに出力したログの情報を解析します。解析した情報に対して条件を指定し，条件を満たす場合，情報をJP1イベントに変換したり，Fluentdのログファイルに出力したりするように設定できます。発行するJP1イベントについては，「3.2.3(2) テキスト形式のログファイルを監視して発行するJP1イベント」を参照してください。

「#」で始まる行はコメント扱いとなり，プログラムの動作には影響しません。

[Forward Settings]セクションの初期設定は，SEVERITYの値がWarning以上の場合にJP1 イベントに変換しJP1/IM - Managerに転送するよう設定されています。

ログデータをJP1イベントに変換しJP1/IM - Managerに転送する場合，重大度がWarning以上の値となるようSEVERITYを設定してください。

文字コード

UTF-8（BOM無し）

改行コード

Windowsの場合：CR+LF

Linuxの場合：LF

定義の反映時期

Fluentdのサービスを再起動したときに，Fluentdの動作に反映します。

定義ファイルの追加もしくは削除，または[Metric Settings]セクションの値を変更した場合，統合オペレーション・ビューアーのツリー表示に，変更内容を反映します。

反映方法については，マニュアル「JP1/Integrated Management 3 - Manager 構築ガイド」の「1.21.2(16)IM管理ノードのツリー情報の作成と反映（Windows）（必須）」を参照してください。

記述内容

<worker>ディレクティブ

「ログ監視共通定義ファイル（jpc_fluentd_common.conf）」の<worker>ディレクティブの説明を参照してください。

workerのid（オプション）

説明

変更可否

JP1/IM - Agentでユーザーが設定する内容

JP1/IM - Agentの初期値

Fluentdが起動するworkerの数を指定します。<worker N>ディレクティブの引数として機能します。指定できる値は，1から128の整数です。

変更可

既存のテキスト形式のログファイルの監視定義ファイル，またはWindowsイベントログの監視定義ファイルで指定したworkerのidと重複しないように指定する必要があります。

1

[Metric Settings]セクション

JP1/IM - Managerのトレンドデータ管理DBに送信するサンプルの，ラベルの値を設定します。

ログ監視名（必須）

コピー先のファイル名に指定したログ監視名を，1〜30文字の文字列で指定します。使用できる文字は，半角英数字，「-」（ハイフン），および「_」（アンダースコア）です。初期値は「@@trapname@@」です。

定義ファイル内の複数個所に設定する必要があるため，OSコマンドやエディターの機能を使用して，「@@trapname@@」の個所を，指定するログ監視名に置き換えてください。

指定を省略した場合，Fluentdの起動時にエラーとなります。

なお，ログ監視名は，次のように設定する必要があります。

同一ファイル内のログ監視名は，すべて同一する

「テキスト形式のログファイルの監視定義ファイル」と「Windowsイベントログの監視定義ファイル」の各定義ファイルで，ログ監視名は一意にする

ホスト名（オプション）

監視対象のホスト名を，1〜255文字の制御文字以外の文字で指定します。初期値は統合エージェントのインストーラにより設定されます。

指定を省略した場合，IM管理ノードは作成されません。

また，次のように設定することで，システムの標準のホスト名を動的に設定できます。

    instance ${Socket.gethostname}

IM管理ノードのラベル名（オプション）

統合オペレーション・ビューアーでIM管理ノードのラベルに表示する文字列を，制御文字以外の文字で指定します。URLをエンコードしたときの文字列が，1〜234バイト（すべてマルチバイト文字の場合の上限は26文字）となるようにしてください。初期値は「Application」です。

指定した内容が不正，または指定を省略した場合，IM管理ノードは作成されません。

異なる監視定義ファイルで，同じIM管理ノードのラベル名を指定できます。その場合，IM管理ノードは1つだけ作成され，どちらの監視定義ファイルで発行されたJP1イベントも，1つのIM管理ノードに登録されます。

カテゴリID（オプション）

ログ監視対象のSIDに対応するIM管理ノードのカテゴリIDを，1〜255文字の制御文字以外の文字で指定します。指定を省略した場合，「otherApplications」が仮定されます。

[Input Settings]セクション

監視するテキスト形式のログファイルのパスや，ログメッセージを解析する正規表現を設定します。

ログ監視名（必須）

[Metric Settings]セクションの説明と同様です。

監視対象のパス（必須）

説明

変更可否

JP1/IM - Agentでユーザーが設定する内容

JP1/IM - Agentの初期値

読み込むパスを指定します。コンマ区切りで複数のパスを指定できます。

監視対象のログファイルの追加・削除を動的に行うために，*やstrftimeの形式を含めることができます。監視対象ログファイルの一覧は，refresh_intervalの間隔で更新されます。

指定例については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「3.15.3 JP1/IM - Agentによるログ監視機能」の「(3)テキスト形式のログファイルの監視機能（tailプラグイン）」を参照してください。

誤ったパスを指定した場合，監視対象ログファイルのログは読み込まれません。

記述規則を次に示します。

絶対パスで指定する

ネットワークドライブ上のディレクトリおよびファイルは指定できない（Windowsの場合）

パスの区切り文字は「¥」ではなく「/」を指定する（Windowsの場合）

複数のパスが指定できる。

「*」（ワイルドカード）を指定できる。

256バイト以内で指定する。

次のようなパス名は指定できない。

・先頭が「-」（ハイフン）のファイル名

・環境依存文字を含むフォルダ名，ディレクトリ名，またはファイル名

・スペースをディレクトリ名（Linuxの場合）

設置必須

監視対象ログファイルのパスを指定します。

該当なし

Fluentd初回起動時に監視するログを先頭から読み込む（オプション）

説明

変更可否

JP1/IM - Agentでユーザーが設定する内容

JP1/IM - Agentの初期値

ログを，末尾ではなく，先頭，または，pos_fileに記録されている最後の読み込み位置から読み始めるかを指定します。

trueまたはfalseを指定できます。

変更可

起動時にすでに追加されているログを読み込む場合，trueに変更します。

false

Fluentdの文字コード（オプション）

監視するログの文字コードがUTF-8，C（コメント扱い）の場合は，初期設定（コメント扱い）を指定します。監視するログの文字コードがUTF-8，C（コメント扱い）以外の場合は，UTF-8を指定します。初期設定では，「#」が行の先頭に指定されていてコメント扱いとなっているため，「#」を削除します。

説明

変更可否

JP1/IM - Agentでユーザーが設定する内容

JP1/IM - Agentの初期値

行を読み込むときのエンコーディングを指定します。

JP1/IM - Agentでは，デフォルトでは，in_tailはASCII-8BITエンコーディングで文字列値を出力します。

次のオプションで変更できます。

encodingを指定すると，文字列をencodingに変更します。

encodingとfrom_encodingの両方が指定された場合，in_tailはfrom_encodingの文字列をencodingに変換しようとします。

変更可

JP1/IM - Agentでは，次の値を指定できます。

UTF-8

指定なし（コメントアウト）

# encoding "UTF-8"

監視するログの文字コード（オプション）

監視するログの文字コードがUTF-8，Cの場合は，初期設定（コメント扱い）を指定します。監視するログの文字コードがUTF-8，C以外の場合は，その文字コードを指定します。初期設定では，「#」が行の先頭に指定されていてコメント扱いとなっているため，「#」を削除します。

説明

変更可否

JP1/IM - Agentでユーザーが設定する内容

JP1/IM - Agentの初期値

Fluentdの文字コード（オプション）の表の説明を参照してください。

変更可

監視対象ログファイルの文字コードを指定します。

JP1/IM - Agentでは，次の値を指定できます。

UTF-16LE

UTF-16BE

Shift_JIS

Windows-31J

GB18030

指定なし（コメントアウト）

# encoding "Shift_JIS"

追加のウォッチタイマーを有効にする

説明

変更可否

JP1/IM - Agentでユーザーが設定する内容

JP1/IM - Agentの初期値

trueまたはfalseを指定します。

このパラメーターにfalseを指定した場合，複数行のログを読み込む際に最新のログが監視されません。そのため，parseプラグインのtypeにmultilineを指定した場合はtrueを指定します。

このパラメーターにfalseを指定すると，inotifyをサポートするシステムで多数のファイルをテーリングするときにCPUとI/Oの消費量が大幅に削減されます。

変更可

parseプラグインのtypeにmultilineを指定した場合にだけtrueを指定します。

false

複数行ログ読み込み時のフラッシュ間隔

項目名

説明

変更可否

JP1/IM - Agentでユーザーが設定する内容

JP1/IM - Agentの初期値

multiline_flush_interval

multiline_flush_intervalパラメータを指定して，複数行のログを読み込む際のフラッシュ間隔を指定します。

このパラメーターを指定しない場合，複数行のログを読み込む際に最新のログが監視されません。

そのため，parseプラグインのtypeにmultilineを指定した場合は次のように指定します。

multiline_flush_interval 5s

変更可

parseプラグインのtypeにmultilineを指定した場合にだけ5sを指定します。

5s

ログのフォーマット

読み込んだログを解析するためのフォーマットを指定します。

指定できるフォーマットを次に示します。

type

説明

none（デフォルト）

解析，構造化をせずに1行のログをそのまま読み込みます。

regexp

正規表現で指定したパターンに合致した1行のログを読み込みます。

multiline

正規表現で指定したパターンに合致した複数行のログを読み込みます。

syslog

syslogが出力したログを読み込みます。

csv

CSV形式（コンマ区切り）のログを読み込みます。

tsv

TSV形式（タブ区切り）のログを読み込みます。

ltsv

LTSV形式（ラベル付きタブ区切り）のログを読み込みます。

各フォーマットのログを解析する際の指定例については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「3.15.3(3)(g)ログのパース機能（parseプラグイン）」を参照してください。

ログのフォーマットに応じた設定

ログのフォーマットに応じた項目を指定します。

noneの場合

  <parse>
    @type none
    message_key message
    time_key time
    null_empty_string false
    estimate_current_event true
    keep_time_key false
  </parse>

regexpの場合

  <parse>
    @type regexp
    expression ログを解析する正規表現
    time_key time
    null_empty_string false
    estimate_current_event true
    keep_time_key false
    ログの時刻を解析する項目
  </parse>

ログを解析する正規表現（必須）

名前付きキャプチャの機能を使用して文字列を切り出す場合，切り出す名前の中の1つは「message」である必要があります。messageを切り出さない場合，JP1イベントのMESSAGE 属性の値には空文字が設定されます。

正規表現を指定し，ログ1行の内容を解析します。名前付きキャプチャの機能を使用し，「message」という名前で，JP1イベントのメッセージに設定する文字列を切り出します。初期値には，行全体を「message」で切り出す正規表現が指定されています。ほかの名前で切り出し，JP1イベントの任意の属性に設定することもできます。

ログの時刻を解析する項目

「time」という名前でログメッセージ中の日時を切り出した場合，その日時がJP1イベントのJPC_LOG_TIME属性の値として設定されます。ログを「time」の名前で切り出すときには，ログの時刻を解析する項目を指定する必要があります。timeを切り出さない場合，またログの時刻を解析する項目を指定しない場合，JPC_LOG_TIME属性の値には，Fluentdがそのログメッセージを監視した日時が設定されます。

項目名

説明

変更可否

JP1/IM - Agentでユーザーが設定する内容

JP1/IM - Agentの初期値

expression

一致するログの正規表現を指定します。

正規表現は「/」（デリミタ）で挟む必要があります。デリミタを使用しない場合，エラーが出力されます。正規表現には，少なくとも1つの名前付きキャプチャ（?<名前>切り出すログの正規表現）の指定が必須です。

正規表現には，iおよびmサフィックスを指定できます。

i（ignorecase）

マッチングの大文字と小文字を無視します。

m（マルチライン）

マルチラインモードとして正規表現を作成します。"."は改行と一致します。

both

iとmの両方を指定します。

読み取ったログが正規表現に一致しなかった場合，Fluentdのログに，次に示すような警告メッセージが出力され，ログが監視されません。

2022-01-23 12:34:56 +0900 [warn]: #0 pattern not matched: "エラーメッセージ"

変更可

監視対象ログファイルのログのフォーマットに合わせて設定します。

expression /^(?<message>.*)$/

time_type

解析するログの時刻形式を指定します。

変更可

監視対象ログファイルの時刻形式に合わせて，次の2種類のどちらかを指定します。

unixtime

1970年1月1日午前0時0分0秒からの経過秒数

string

time_formatで指定されたフォーマットを使用します。

−

time_format

時刻のフォーマットを256バイト以内で指定します。指定されたフォーマットに従って値を処理します。time_typeがstringの場合だけ使用できます。

サポートするフォーマットを次に示します。

%b

月の省略名（Jan，Feb，・・・）

%d

日（01〜31）

%H

24時間制の時（00〜23）

%M

分（00〜59）

%m

月を表す数字（01〜12）

%S

秒（00〜60（60はうるう秒を示します））

%Y

西暦を表す数

%N

秒の小数点以下

誤った値を指定した場合，Fluentdのログに次に示すような警告メッセージが出力され，ログが監視されないことがあります。

2022-09-08 17:15:10 +0900 [warn] : #0 invalid line found file="C:/fluentd/install/log/app1/20220906_log1_utf8.txt" line="2022/12/3 12:34:56 jpcagt0 00004864 00008904 agent.cpp 572 KAVL99999-E ¥xE3¥x82¥xA8¥xE3¥x83¥xA9¥xE3¥x83¥xBC¥xE3¥x83¥xA1¥xE3¥x83¥x83¥xE3¥x82¥xBB¥xE3¥x83¥xBC¥xE3¥x82¥xB8(2022/09/08 17:15:09.24) " error="invalid time format: value = 2022/12/3 12:34:56, error_class = ArgumentError, error = string doesn't match"

このパラメーターを省略した場合，JPC_LOG_TIMEに設定する時刻は，Fluentdがログメッセージを検知した時刻となります。typeにsyslogを指定して，このパラメーターを指定しない場合，エラーメッセージや警告メッセージは出力されず，監視対象ログは誤ったフォーマットで解析されます。

そのため，Fluentdの起動およびログの追加後に，JP1イベントが正常なフォーマットで発行されているか確認する必要があります。

変更可

監視対象ログファイルの時刻形式に合わせて，時刻のフォーマットを指定します。

−

localtime

ローカルタイムを使用するためtrueを指定します。

変更不可

true

true

utc

ローカルタイムを使用するためfalseを指定します。

変更不可

false

false

timezone

指定されたタイムゾーンで時刻の値を解析します。

変更可

監視対象ログファイルの時刻形式に合わせて，次の形式のどちらかでタイムゾーンを指定します。

[+-]HH:MM

例："+09:00"

[+-]HHMM

例："+0900"

timezoneを指定する場合は，time_formatを指定する必要があります。

−

（凡例）−：該当なし

multilineの場合

  <parse>
    @type multiline
    format_firstline 先頭行のログを解析する正規表現
    formatN ログを解析する正規表現
    time_key time
    null_empty_string false
    estimate_current_event true
    keep_time_key false
    ログの時刻を解析する項目
  </parse>

先頭行のログを解析する正規表現（必須）

正規表現を指定し，ログ１行の内容を解析します。指定した正規表現がログの内容と一致した場合，一致したログの行を複数行で構成されるログの先頭行として読み込みます。

ログを解析する正規表現（必須）

「regexpの場合」の説明と同様です。Nには1から20の整数を指定でき，指定した正規表現を使用して，複数行で構成されたログの内容をN行目として解析します。

ログの時刻を解析する項目

「regexpの場合」の説明と同様です。

項目名

説明

変更可否

JP1/IM - Agentでユーザーが設定する内容

JP1/IM - Agentの初期値

format_firstline

ログの先頭行を正規表現で指定します。

multilineパースプラグインは，複数行のログを解析します。パースプラグインのtypeにmultilineを指定した場合，formatNとformat_firstlineを指定する必要があります。

正規表現に指定できるバイト数の上限は1023バイト（デリミタを除く）です。正規表現は「/」（デリミタ）で挟む必要があります。デリミタを使用しない場合，エラーが出力されます。

変更可

監視対象ログファイルの形式に合わせて，ログの先頭行を正規表現で指定します。

−

formatN

ログの各行を正規表現で指定します。

複数行のログのフォーマットを指定します。Nは1から20の整数で，正規表現のフォーマットのリストを作成します。

正規表現に指定できるバイト数の上限は1023バイト（デリミタを除く）です。正規表現は「/」（デリミタ）で挟む必要があります。デリミタを使用しない場合，エラーが出力されます。

このパラメーターを指定しない場合，Fluentdを起動するとエラーが出力されます。

変更可

監視対象ログファイルの形式に合わせて，ログの各行を正規表現で指定します。

−

time_type

解析するログの時刻形式を指定します。

変更可

監視対象ログファイルの時刻形式に合わせて，次の2種類のどちらかを指定します。

unixtime:1970年1月1日午前0時0分0秒からの経過秒数

string: time_format で指定されたフォーマットを使用します。

−

time_format

時刻のフォーマットを256バイト以内で指定します。指定されたフォーマットに従って値を処理します。time_typeがstringの場合だけ使用できます。

サポートするフォーマットを次に示します。

%b：月の省略名（Jan，Feb，・・・）

%d：日（01〜31）

%H：24時間制の時（00〜23）

%M：分（00〜59）

%m：月を表す数字（01〜12）

%S：秒（00〜60（60はうるう秒を示します））

%Y：西暦を表す数

%N：秒の小数点以下

誤った値を指定した場合，Fluentdのログに次に示すような警告メッセージが出力され，ログが監視されないことがあります。

2022-09-08 17:15:10 +0900 [warn] : #0 invalid line found file="C:/fluentd/install/log/app1/20220906_log1_utf8.txt" line="2022/12/3 12:34:56 jpcagt0 00004864 00008904 agent.cpp 572

KAVL99999-E ¥xE3¥x82¥xA8¥xE3¥x83¥xA9¥xE3¥x83¥xBC¥xE3¥x83¥xA1¥xE3¥x83¥x83¥xE3¥x82¥xBB¥xE3¥x83¥xBC¥xE3¥x82¥xB8(2022/09/08 17:15:09.24) "

error="invalid time format: value = 2022/12/3 12:34:56,error_class = ArgumentError, error = string doesn't match"

このパラメーターを省略した場合，JPC_LOG_TIMEに設定する時刻は，Fluentdがログメッセージを検知した時刻となります。typeにsyslogを指定して，このパラメーターを指定しない場合，エラーメッセージや警告メッセージは出力されず，監視対象ログは誤ったフォーマットで解析されます。

そのため，Fluentdの起動およびログの追加後に，JP1 イベントが正常なフォーマットで発行されているか確認する必要があります。

変更可

監視対象ログファイルの時刻形式に合わせて，時刻のフォーマットを指定します。

−

localtime

ローカルタイムを使用するためtrueを指定します。

変更不可

true

true

utc

ローカルタイムを使用するためfalseを指定します。

変更不可

false

false

timezone

指定されたタイムゾーンで時刻の値を解析します。

変更可

監視対象ログファイルの時刻形式に合わせて，次の形式のどちらかでタイムゾーンを指定します。

1. [+-]HH:MM (例: "+09:00")

2. [+-]HHMM (例: "+0900")

timezoneを指定する場合は，time_formatを指定する必要があります。

−

（凡例）−：該当なし

syslogの場合

  <parse>
    @type syslog
    time_type string
    time_format 日時の形式
    rfc5424_time_format RFC-5424フォーマットのsyslogの日時の形式
    message_format syslogの種類
    with_priority 優先度（priority）プレフィクスの有無
    parser_type string
    support_colonless_ident identフィールドの有無
    time_key time
    null_empty_string false
    estimate_current_event true
    keep_time_key false
    localtime true
    utc false
  </parse>

日時の形式（必須）

「regexpの場合」の説明と同様です。正規表現を指定し，ログメッセージ中の日時を解析します。syslogの種類にautoを指定した場合，RFC-3164フォーマットのsyslogの日時の形式を指定します。

RFC-3164フォーマットのsyslogの日時の形式（オプション）

正規表現を指定し，RFC-5424フォーマットのsyslogの日時を解析します。このパラメーターは，syslogの種類をautoに指定した場合だけ使用します。

syslogの種類（必須）

解析するsyslogの種類を，rfc3164（RFC-3164フォーマット），rfc5424（RFC-5424フォーマット），またはauto（両方）の中から選択して指定します

優先度（priority）プレフィクスの有無（必須）

RFC-3164フォーマットのsyslogに優先度（priority）プレフィクスが含まれているかどうかをtrueまたはfalseで指定します。syslogの種類にrfc3164を指定した場合だけfalseを指定でき，それ以外の場合はtrueに指定する必要があります。

identフィールドの有無（必須）

RFC-3164フォーマットのsyslogに，identフィールドが含まれているかどうかをtrueまたはfalseで指定します。syslogの種類にrfc3164を指定した場合だけ falseを指定でき，それ以外の場合はtrueに指定する必要があります。

項目名

説明

変更可否

JP1/IM - Agentでユーザーが設定する内容

JP1/IM - Agentの初期値

time_format

「regexpの場合」の説明と同様です。

typeにsyslogを指定して，message_formatにautoを指定した場合は，RFC-3164プロトコルの時刻フォーマットを指定します。この場合，RFC-5424プロトコルの時刻フォーマットはrfc5424_time_formatで指定します。RFC-3164プロトコルの時刻フォーマットは，"%b %d %H:%M:%S"です。秒以下のタイムスタンプで出力される場合，"%b %d %H:%M:%S.%N"に変更します。

変更可

監視対象ログファイルの時刻形式に合わせて，時刻のフォーマットを正規表現で指定します。

−

rfc5424_time_format

RFC-5424プロトコルの時刻フォーマットを256バイト以内で指定します。

サポートするフォーマットを次に示します。

%b：月の省略名（Jan，Feb，・・・）

%d：日（01〜31）

%H：24時間制の時（00〜23）

%M：分（00〜59）

%m：月を表す数字（01〜12）

%S：秒（00〜60（60はうるう秒を示します））

%Y：西暦を表す数

%N：秒の小数点以下

誤った値を指定した場合，Fluentdのログに次に示すような警告メッセージが出力され，ログが監視されないことがあります。

2023-03-24 13:18:27 +0900 [warn]: #0 invalid line found file="/home/ec2-user/fluentd_test/input_log/20230315_log1.txt" line="<16>1 2023-03-24T13:18:27.31+0900 192.168.0.1 fluentd 11111 ID24224 [exampleSDID@20224 iut=¥"3¥" eventSource=¥"Application¥" eventID=¥"11211¥"] Hi, from Fluentd!" error="invalid time format: value = 2023-03-24T13:18:27.31+0900, error_class = ArgumentError, error = string doesn't match"

このパラメーターは，message_formatをautoに指定した場合だけ使用します。指定しない場合，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「3.15.3(3)(g)ログのパース機能（parseプラグイン）」に記載する正規表現の時刻フォーマットに従って時刻が解析・切り出されます。

変更可

監視対象ログファイルの形式に合わせて，時刻のフォーマットを指定します。

−

message_format

syslogのプロトコルの形式を指定します。rfc3164，rfc5424，またはautoのどれかを指定できます。デフォルトはrfc3164です。

監視対象のsyslogがrfc5424で出力される場合は，rfc5424を指定します。また，監視対象のsyslogがrfc3164とrfc5424の両方のプロトコルでログ出力する場合，autoを指定します。

autoを指定した場合，syslogパースプラグインは，メッセージのプレフィクスを使用してフォーマットを検出します。

このパラメーターを指定しない場合，または，誤った値を指定した場合，Fluentdを起動するとエラーが出力されます。

変更可

監視対象ログファイルの形式に合わせて，ログの形式を指定します。

−

with_priority

RFC-3164フォーマットのsyslogに優先度（priority）プレフィクスが含まれているかどうかをtrueまたはfalseで指定します。

監視対象のログが，<9>のような優先度（priority）プレフィクスを持つ場合はtrueを指定します。

このパラメーターを指定しない場合，Fluentdのログに次に示すような警告メッセージが出力され，ログが監視されないことがあります。

2023-03-24 14:15:01 +0900 [warn]: #0 pattern not matched: "Mar 24 14:15:01 192.168.0.1 fluentd[11111]: [error] Syslog test"

trueまたはfalse以外の値を指定した場合，Fluentdを起動するとエラーが出力されます。

変更可

監視対象ログファイルの形式に合わせて指定します。

−

support_colonless_ident

RFC-3164フォーマットのsyslogにidentフィールドが含まれているかどうかをtrueまたはfalseで指定します。RFC3164フォーマットのログを監視する場合に使用します。監視対象のログがメッセージ内にidentフィールドを含まない場合，falseを指定します。

このパラメーターを指定しない場合，エラーメッセージや警告メッセージは出力されず，監視対象ログは誤ったフォーマットで解析されることがあります。そのため，Fluentdの起動およびログの追加後にJP1イベントが正常なフォーマットで発行されているか確認する必要があります。

trueまたはfalse以外の値を指定した場合，Fluentdを起動するとエラーが出力されます。

変更可

監視対象ログファイルの形式に合わせて指定します。

−

（凡例）−：該当なし

csvの場合

  <parse>
    @type csv
    keys レコードの項目名の配列
    delimiter ,
    parser_type 内部パーサーの種類
    time_key time
    null_empty_string false
    estimate_current_event true
    keep_time_key false
    ログの時刻を解析する項目
  </parse>

レコードの項目名の配列（必須）

レコードの項目名を配列の形式で指定します。項目名の配列にはJP1イベントのメッセージに設定する文字列として「message」を含む必要があります。

messageを含まない場合，JP1イベントのMESSAGE 属性の値には空文字が設定されます。

内部パーサーの種類（必須）

csv形式のログをパースする内部パーサーの種類を指定します。

項目名

説明

変更可否

JP1/IM - Agentでユーザーが設定する内容

JP1/IM - Agentの初期値

keys

レコードの項目名の配列を256バイト以内で指定します。

このパラメーターを指定しない場合，または，誤った値を指定した場合，エラーメッセージや警告メッセージは出力されず，監視対象ログは誤ったフォーマットで解析されます。そのため，Fluentdの起動およびログの追加後に，JP1イベントが正常なフォーマットで発行されているか確認する必要があります。

変更可

監視対象ログファイルの形式に合わせて指定します。

−

parser_type

ログの行をパースする際の内部パーサーの種類をnormalまたはfastのどちらかで指定します。

normalを指定した場合，RubyのCSV.parse_lineメソッドを使用します。

fastを指定した場合，Fluentd独自の軽量な実装を使用します。使用するパーサーは通常の数倍高速ですが，典型的なパターンだけをサポートします。サポートするフォーマットを次に示します。

# non-quoted

value1,value2,value3,value4,value5

# quoted

"value1","val,ue2","va,lu,e3","val ue4",""

# escaped

"message","mes""sage","""message""",,""""""

# mixed

message,"mes,sage","me,ssa,ge",mess age,""

このパラメータを指定しない場合，または，誤った値を指定した場合，Fluentdを起動するとエラーが出力されます。

変更可

監視対象ログファイルの形式が次のフォーマットである場合，fastを指定します。

# non-quoted

value1,value2,value3,value4,value5

# quoted

"value1","val,ue2","va,lu,e3","val ue4",""

# escaped

"message","mes""sage","""message""",,""""""

# mixed

message,"mes,sage","me,ssa,ge",mess age,""

監視対象ログファイルの形式が上記のフォーマットに合致しない場合，normalを指定します。

−

（凡例）−：該当なし

ログの時刻を解析する項目

「regexpの場合」の説明と同様です。レコードの項目名の配列に「time」が含まれる場合に設定します。

tsvの場合

  <parse>
    @type tsv
    keys レコードの項目名の配列
    delimiter "¥t"
    time_key time
    null_empty_string false
    estimate_current_event true
    keep_time_key false
    ログの時刻を解析する項目
  </parse>

レコードの項目名の配列（必須）

レコードの項目名を配列の形式で指定します。

項目名

説明

変更可否

JP1/IM - Agentでユーザーが設定する内容

JP1/IM - Agentの初期値

keys

レコードの項目名の配列を256バイト以内で指定します。

このパラメーターを指定しない場合，または，誤った値を指定した場合，エラーメッセージや警告メッセージは出力されず，監視対象ログは誤ったフォーマットで解析されます。そのため，Fluentdの起動およびログの追加後に，JP1イベントが正常なフォーマットで発行されているか確認する必要があります。

変更可

監視対象ログファイルの形式に合わせて指定します。

−

（凡例）−：該当なし

ログの時刻を解析する項目

「regexpの場合」の説明と同様です。レコードの項目名の配列に「time」が含まれる場合に設定します。

ltsvの場合

  <parse>
    @type ltsv
    項目間の区切り文字 項目間の区切り文字のパターン
    label_delimiter ラベルと値の間の区切り文字
    time_key time
    null_empty_string false
    estimate_current_event true
    keep_time_key false
    ログの時刻を解析する項目
  </parse>

項目間の区切り文字 項目間の区切り文字のパターン（必須）

項目間の区切り文字を指定します。次のどちらかを指定します。

・項目間の区切りがタブの場合

    delimiter "¥t"

・項目間の区切りが1つ以上の空白の場合

    delimiter_pattern /¥s+/

ラベルと値の間の区切り文字（必須）

ラベルと値の間の区切り文字を指定します。

項目名

説明

変更可否

JP1/IM - Agentでユーザーが設定する内容

JP1/IM - Agentの初期値

delimiter

項目間の区切り文字を指定します。指定できる区切り文字は「"¥t"」だけです。

このパラメーターとdelimiter_patternのどちらかを指定しない場合，または，誤った値を指定した場合，エラーメッセージや警告メッセージは出力されず，監視対象ログは誤ったフォーマットで解析されます。そのため，Fluentdの起動およびログの追加後に，JP1イベントが正常なフォーマットで発行されているか確認する必要があります。

変更可

監視対象ログファイルの形式に合わせて指定します。

−

delimiter_pattern

LTSV形式のファイルで，項目間の区切りが1つ以上の空白である場合に指定します。指定できる区切り文字は「/¥s+/」だけです。

このパラメーターとdelimiterのどちらかを指定しない場合，または，誤った値を指定した場合，エラーメッセージや警告メッセージは出力されず，監視対象ログは誤ったフォーマットで解析されまする。そのため，Fluentdの起動およびログの追加後に，JP1イベントが正常なフォーマットで発行されているか確認する必要があります。

変更可

監視対象ログファイルの形式に合わせて指定します。

−

label_delimiter

ラベルと値の間の区切り文字を256バイト以内で指定します。

このパラメーターを指定しない場合，または，誤った値を指定した場合，エラーメッセージや警告メッセージは出力されず，監視対象ログは誤ったフォーマットで解析されます。そのため，Fluentdの起動およびログの追加後に，JP1イベントが正常なフォーマットで発行されているか確認する必要があります。

変更可

監視対象ログファイルの形式に合わせて指定します。

−

（凡例）−：該当なし

ログの時刻を解析する項目

「regexpの場合」の説明と同様です。レコードの項目名の配列に「time」が含まれる場合に設定します。

[Attributes Settings]セクション

発行するJP1イベントの属性と属性値の設定を行います。

ログ監視名（必須）

[Metric Settings]セクションの説明と同様です。

イベントID（オプション）

JP1イベントのB.ID属性に設定する値を指定します。指定できる値については，マニュアル「JP1/Base 運用ガイド」を参照してください。初期値は「00007601」（テキスト形式のログファイルの監視定義ファイルで使用するイベントID）です。

指定を省略した場合，JP1イベントは発行されません。

「 ID イベントID」の指定の代わりに，次のように指定することで，message属性の値に応じたイベントIDを設定できます。

    ID "${
         if record['message'].match(/正規表現1/)
           'イベントID1'
         elsif record['message'].match(/正規表現2/)
           'イベントID2'
         elsif record['message'].match(/正規表現3/)
           'イベントID3'
・・・
         else
           'イベントID4'
         end}"

Rubyの条件分岐でmessage属性の値を判定し，イベントIDを設定します。上記の場合，正規表現1に一致した場合，イベントID1に指定した値をイベントIDに設定します。一致しなかった場合，正規表現2と比較して一致した場合，イベントID2を設定します。elsifで指定した数だけ比較してどれにも一致しなかった場合，else構文内のイベントID4に指定した値をイベントIDに設定します。指定できるif文とelsif文の合計数の上限は100個です。

ホスト名（オプション）

[Metric Settings]セクションの説明と同様です。

指定を省略した場合，JP1_SOURCEHOSTの属性値が設定されず，JP1イベントが正しいIM管理ノードに登録されません。

また，次のように設定することで，システムの標準のホスト名を動的に設定できます。

    JP1_SOURCEHOST ${Socket.gethostname}

重大度（オプション）

JP1イベントのE.SEVERITY属性に設定する値を指定します。指定できる値については，マニュアル「JP1/Base 運用ガイド」を参照してください。初期値は「Notice」です。

指定を省略した場合，JP1イベントは発行されません。

「 SEVERITY 重大度」の指定の代わりに，次のように指定することで，message属性の値に応じた重大度を設定できます。

    SEVERITY "${
         if record['message'].match(/正規表現１/)
           'Critical'
         elsif record['message'].match(/正規表現２/)
           'Error'
         elsif record['message'].match(/正規表現３/)
           'Warning'
・・・
         else
           'Notice'
         end}"

Rubyの条件分岐でmessage属性の値を判定し，重大度を設定します。上記の場合，正規表現1に一致した場合，重大度に「Critical」を設定します。マッチしなかった場合，正規表現2と比較して一致した場合，「Error」を設定します。elsifで指定した数だけ比較してどれにも一致しなかった場合，else構文内の「Notice」を重大度に設定します。指定できるif文とelsif文の合計数の上限は100個です。

IM管理ノードのラベル名（オプション）

[Metric Settings]セクションの説明と同様です。

指定を省略した場合，JP1イベントは発行されません。

任意の属性名 任意の値（オプション）

JP1イベントに任意の属性を追加したい場合に指定します。指定できる属性名については，マニュアル「JP1/Base 運用ガイド」を参照してください。

値には，[Input Settings]セクションの，ログを解析する正規表現で，キャプチャした名前を指定できます。

例えば，「NUMBER」という名前でキャプチャし，EXIT_CODEという属性に設定する場合，次のように指定します。

EXIT_CODE ${record['NUMBER']}

複数の拡張属性を追加できますが，JP1イベントの拡張属性に設定する値のサイズの合計が上限を超える場合，JP1イベントは発行されません。

拡張属性の上限については，「4.4.4(5)__transformEventメソッド」を参照してください。

[Inclusion Settings]セクション

監視するログの条件を正規表現で指定します。指定しない場合，すべてのログが監視対象となります。監視しないログが出力された場合，そのログはJP1イベントに変換されず，Fluentdのログにも出力されません。

初期設定では，「#」が行の先頭に指定されていてコメント扱いとなっているため，指定する場合は「#」を削除します。

ログ監視名（必須）

[Metric Settings]セクションの説明と同様です。

JP1イベントの属性名（オプション）

「MESSAGE」など，JP1イベントの属性名を指定します。指定を省略した場合，Fluentdの起動時にエラーとなります。

監視するログの正規表現（オプション）

JP1イベントの属性名で指定した属性の値に対して，正規表現を指定します。一致する値を含む場合，監視を行います。

指定を省略した場合，Fluentdの起動時にエラーとなります。

複数の正規表現パターンの論理積または論理和の条件を指定することもできます。指定の方法については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「3.15.3(7)ログデータの抽出機能（grepプラグイン）」を参照してください。

[Exclusion Settings]セクション

監視しないログの条件を正規表現で指定します。指定しない場合，すべてのログが監視対象となります。初期設定では，「#」が行の先頭に指定されていてコメント扱いとなっているため，指定する場合は「#」を削除します。

ログ監視名（必須）

[Metric Settings]セクションの説明と同様です。

JP1イベントの属性名（オプション）

「MESSAGE」など，JP1イベントの属性名を指定します。

指定を省略した場合，Fluentdの起動時にエラーとなります。

監視するログの正規表現（オプション）

JP1イベントの属性名で指定した属性の値に対して，正規表現を指定します。一致する値を含む場合，監視を行いません。

指定を省略した場合，Fluentdの起動時にエラーとなります。

複数の正規表現パターンの論理積または論理和の条件を指定することもできます。指定の方法については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「3.15.3(7)ログデータの抽出機能（grepプラグイン）」を参照してください。

[Forward Settings]セクション

JP1イベントに変換するログデータの正規表現を設定します。

ログ監視名（必須）

[Metric Settings]セクションの説明と同様です。

JP1イベントの属性名（オプション）

JP1イベントの属性名を指定します。初期値は「SEVERITY」です。

指定を省略した場合，Fluentdの起動時にエラーとなります。

JP1イベントを発行するログの正規表現（オプション）

JP1イベントの属性名で指定した属性の値に対して，JP1イベントを発行する正規表現の条件を指定します。

初期値は，「Warning|Error|Critical|Alert|Emergency」で，SEVERITYの値がWarning以上の場合にマッチします。

属性の値が，条件に一致する値を含む場合，監視したログの内容がJP1イベントに変換され，統合マネージャーホストのJP1/Baseに登録されます。また，監視したログの内容がFluentdのログにも出力されます。条件に一致しない場合，JP1イベントは発行されず，Fluentdのログだけに出力されます。

指定を省略した場合，Fluentdの起動時にエラーとなります。

なお，[Attributes Settings]セクション内では，SEVERITYの初期値として「Notice」が指定されています。そのため，ログ監視結果はJP1イベントとして出力されず，Fluentdのログにだけ出力されます。

SEVERITYの値が「Notice」であるログをJP1イベントとして発行する場合は，次の下線部分のように定義を変更します。

    pattern /Notice|Warning|Error|Critical|Alert|Emergency/

定義例

テキスト形式のログファイルを監視する条件と定義の例を，次に示します。

■条件

監視対象のログファイルのパス

C:¥Program Files (x86)¥Hitachi¥HNTRLib2¥spool¥*

ログメッセージ

6027 2022/08/25 17:45:50.219     jbssessionmgr    000018EC 00000FCC KAVA1497-I            jp1adminユーザーがログインしました

監視するログメッセージ

メッセージIDがKAVAで始まるログメッセージを監視します。

MESSAGEに設定する値

ログメッセージの，メッセージID以降の文字列を設定します。

SEVERITYに設定する値

メッセージIDの重大度に応じた値を設定します。

任意の属性名に設定する値

ログメッセージに含まれるプロセス名（jbssessionmgr）を，属性名PROCESS_NAMEに設定します。

■定義

<worker 0>
## [Metric Settings]
<source>
  @type exec
  command "echo {}"
  <parse>
    @type json
  </parse>
  run_interval 60s
  tag jpc_ima_metrics.tail.user_app_log
</source>

<filter jpc_ima_metrics.tail.user_app_log>
  @type record_transformer
  enable_ruby true
  <record>
    __name__ fluentd_logtrap_running
    instance hostA
    jp1_pc_nodelabel ユーザーアプリケーション
    jp1_pc_category applicationServer
    jp1_pc_logtrap_defname user_app_log_tail
    jp1_pc_trendname fluentd
    job jpc_fluentd
    jp1_pc_nodelabel_fluentd Log trapper(Fluentd)
    jp1_pc_addon_program JPC Fluentd
  </record>
</filter>
</worker>
<worker 1>
## [Input Settings]
<source>
  @type tail
  tag tail.user_app_log
  path C:/Program Files (x86)/Hitachi/HNTRLib2/spool/*
  follow_inodes true
  refresh_interval 60
  skip_refresh_on_startup false
  read_from_head false
  encoding "UTF-8"
  from_encoding "Shift_JIS"
  read_lines_limit 1000
  read_bytes_limit_per_second -1
  pos_file ../data/fluentd/tail/user_app_log.pos
  path_key tailed_path
  rotate_wait 5s
  enable_watch_timer false
  enable_stat_watcher true
  open_on_every_update false
  emit_unmatched_lines false
  ignore_repeated_permission_error false
  <parse>
    @type regexp
    expression /^([^ ]* +(?<time>[^ ]* [^ ]*) +(?<PROCESS>[^ ]*) +[^ ]* +[^ ]* +(?<message>.*))$/
    time_key time
    null_empty_string false
    estimate_current_event true
    keep_time_key false
    localtime true
    utc false
  </parse>
</source>

## [Attributes Settings]
<filter tail.user_app_log>
  @type record_transformer
  enable_ruby true
  auto_typecast true
  renew_record true

  <record>
    ID 00007601
    MESSAGE ${record["message"]}
    JP1_SOURCEHOST hostA
    JPC_LOG_TIME ${time.utc.to_i}
    PRODUCT_NAME /HITACHI/JP1/JPCCS2/LOGTRAP/ユーザーアプリケーション
    PPNAME /HITACHI/JP1/JPCCS2/LOGTRAP
    SEVERITY "${
         if record['message'].match(/^KAVA[1-9]*-E/)
           'Error'
         elsif record['message'].match(/^KAVA[1-9]*-W/)
           'Warning'
         elsif record['message'].match(/^KAVA[1-9]*-I/)
           'Information'
         else
           'Notice'
         end}"
    PLATFORM ${ if RUBY_PLATFORM.downcase =~ /mswin(?!ce)|mingw|cygwin|bccwin/; 'NT'; else 'UNIX'; end }
    OBJECT_TYPE LOGFILE
    OBJECT_NAME ${record['tailed_path']}
    ROOT_OBJECT_TYPE LOGFILE
    ROOT_OBJECT_NAME ${record['tailed_path']}
    JP1_TRAP_NAME ${tag_parts[1]}
    JPC_NODELABEL ユーザーアプリケーション
    PROCESS_NAME ${record['PROCESS']}
  </record>
</filter>

## [Inclusion Settings]
<filter tail.user_app_log>
  @type grep
  <regexp>
    key MESSAGE
    pattern /^KAVA[1-9]*-(I|W|E)/
  </regexp>
</filter>

## [Exclusion Settings]
#<filter tail.user_app_log>
#  @type grep
#  <exclude>
#    key
#    pattern //
#  </exclude>
#</filter>

## [Forward Settings]
<match tail.user_app_log>
  @type rewrite_tag_filter
  <rule>
    key SEVERITY
    pattern /Warning|Error|Critical|Alert|Emergency/
    tag ${tag}.jp1event
  </rule>
  <rule>
    key SEVERITY
    pattern /.*/
    tag ${tag}.outputlog
  </rule>
</match>

<filter /tail¥.user_app_log¥.(jp1event|outputlog)/>
  @type record_transformer
  enable_ruby true
  auto_typecast true
  renew_record true
  <record>
    eventId ${record['ID']}
    xsystem true
    message ${record['MESSAGE']}
    attrs ${record}
  </record>
  remove_keys $.attrs.ID
  remove_keys $.attrs.MESSAGE
</filter>
</worker>

Windowsイベントログの監視定義ファイル（fluentd_@@trapname@@_wevt.conf.template）

形式

<worker 0>
## [Metric Settings]
<source>
  @type exec
  command "echo {}"
  <parse>
    @type json
  </parse>
  run_interval 60s
  tag jpc_ima_metrics.wevt.ログ監視名
</source>

<filter jpc_ima_metrics.wevt.ログ監視名>
  @type record_transformer
  enable_ruby true
  auto_typecast false

  <record>
    __name__ fluentd_logtrap_running
    instance ホスト名
    jp1_pc_nodelabel IM管理ノードのラベル名
    jp1_pc_category カテゴリID
    jp1_pc_logtrap_defname ログ監視名_wevt
    jp1_pc_trendname fluentd
    job jpc_fluentd
    jp1_pc_nodelabel_fluentd Log trapper(Fluentd)
    jp1_pc_addon_program JPC Fluentd
  </record>
</filter>
</worker>
<worker workerのid>
## [Input Settings]
<source>
  @type windows_eventlog2
  tag wevt.ログ監視名
  channels ログの種別
  read_interval 2s
  <storage>
    @type local
    path ../data/fluentd/wevt/ログ監視名
    mode 0600
    dir_mode 0700
    pretty_print false
  </storage>
  read_existing_events false
  render_as_xml false
  rate_limit -1
  preserve_qualifiers_on_hash true
  read_all_channels false
  event_query *
</source>

## [Attributes Settings]
<filter wevt.ログ監視名>
  @type record_transformer
  enable_ruby true
  auto_typecast false
  renew_record false
  <record>
    ID イベントID
    JP1_SOURCEHOST ホスト名
    JPC_NODELABEL IM管理ノードのラベル名
    JP1_TRAP_NAME ログ監視名
#    OS_VERSION OSバージョン
  </record>
</filter>

## [Inclusion Settings]
#<filter wevt.ログ監視名>
#  @type grep
#  <regexp>
#    key JP1イベントの属性名
#    pattern /監視するログの正規表現/
#  </regexp>
#</filter>

## [Exclusion Settings]
#<filter wevt.ログ監視名>
#  @type grep
#  <exclude>
#    key JP1イベントの属性名
#    pattern /監視しないログの正規表現/
#  </exclude>
#</filter>

## [Forward Settings]
<match wevt.ログ監視名>
  @type rewrite_tag_filter
  <rule>
    key JP1イベントの属性名
    pattern /JP1イベントを発行するログの正規表現/
    tag ${tag}.jp1event
  </rule>
  <rule>
    key MESSAGE
    pattern /.+/
    tag ${tag}.outputlog
  </rule>
</match>

<filter /wevt¥.ログ監視名¥.(jp1event|outputlog)/>
  @type record_transformer
  enable_ruby true
  auto_typecast true
  renew_record true
  <record>
    eventId ${record['ID']}
    xsystem true
    message ${record['MESSAGE']}
    attrs ${record}
  </record>

  remove_keys $.attrs.ID
  remove_keys $.attrs.MESSAGE
</filter>
</worker>

ファイル

fluentd_@@trapname@@_wevt.conf.template

fluentd_@@trapname@@_wevt.conf.template.model（モデルファイル）

格納先ディレクトリ

■統合エージェントホスト

物理ホストのとき（定義ファイルおよびモデルファイル）

Agentパス¥conf¥

論理ホストのとき（定義ファイル）

共有フォルダ¥jp1ima¥conf¥

説明

Windowsイベントログを監視するための定義ファイルです。

テンプレート（fluentd_@@trapname@@_wevt.conf.template）をコピーし，コピー先のファイル名を「fluentd_ログ監視名_wevt.conf」に変更して使用します。「fluentd_ログ監視名_wevt.conf」の配置先については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「付録A.4(3)統合エージェントホスト（Windows）」および「付録A.4(4)統合エージェントホスト（Linux）」を参照してください。ファイル名は，監視エージェントホスト内で重複しない名前とします。ログ監視名に使用できる文字は半角英数字，ハイフン，アンダースコアで，文字列長は1〜30文字とします。監視対象のアプリケーションごとにこの定義ファイルを作成します。

JP1/IM - Agentは，監視定義ファイルのIM管理ノードのラベル名に設定されている値に応じて，ログ監視対象のSIDのIM管理ノードを作成します。別の監視定義ファイルであってもIM管理ノードのラベル名が同一であれば，作成するIM管理ノードは１つです。

Windowsイベントログの監視機能でこの定義ファイルを読み込み，アプリケーションがWindowsイベントログに出力したログの情報を解析します。解析した情報に対して条件を指定し，条件を満たす場合，情報をJP1イベントに変換したり，Fluentdのログファイルに出力したりするよう設定することができます。発行するJP1イベントについては，「3.2.3(3)Windowsイベントログを監視して発行するJP1イベント」を参照してください。

先頭の文字が「#」である行は，コメントとして扱い，プログラムの動作には影響しません。

文字コード

UTF-8（BOM無し）

改行コード

Windowsの場合：CR+LF

定義の反映時期

Fluentdのサービスを再起動したときに，Fluentdの動作に反映します。

定義ファイルの追加，削除，または，[Metric Settings]セクションの値を変更した場合，変更内容を統合オペレーション・ビューアーのツリーに反映します。

反映方法については，マニュアル「JP1/Integrated Management 3 - Manager 構築ガイド」の「1.21.2(16)IM管理ノードのツリー情報の作成と反映（Windows）（必須）」を参照してください。

記述内容

<worker>ディレクティブ

「テキスト形式のログファイルの監視定義ファイル（fluentd_@@trapname@@_tail.conf.template）」の<worker>ディレクティブと同じです。

workerのid（オプション）

説明

変更可否

JP1/IM - Agentでユーザーが設定する内容

JP1/IM - Agentの初期値

「テキスト形式のログファイルの監視定義ファイル（fluentd_@@trapname@@_tail.conf.template）」のworkerのidと同じです。

変更可

「テキスト形式のログファイルの監視定義ファイル（fluentd_@@trapname@@_tail.conf.template）」のworkerのidと同じです。

2

[Metric Settings]セクション

「テキスト形式のログファイルの監視定義ファイル（fluentd_@@trapname@@_tail.conf.template）」の[Metric Settings]セクションの説明を参照してください。

[Input Settings]セクション

監視するイベントログの種別を指定します。

ログ監視名（必須）

「テキスト形式のログファイルの監視定義ファイル（fluentd_@@trapname@@_tail.conf.template）」の[Metric Settings]セクションのログ監視名と同じです。

ログの種別（必須）

監視するイベントログの種別を，コンマ区切りの256バイト以内の文字列で指定します。JP1/IM - Agentの初期値は「application, system」です。

指定できるログの種別については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「3.15.3(4)(a)監視できるログの種別」を参照してください。

[Attributes Settings]セクション

発行するJP1イベントの属性と属性値の設定を行います。

ログ監視名（必須）

「テキスト形式のログファイルの監視定義ファイル（fluentd_@@trapname@@_tail.conf.template）」の[Metric Settings]セクションのログ監視名と同じです。

イベントID（オプション）

「テキスト形式のログファイルの監視定義ファイル（fluentd_@@trapname@@_tail.conf.template）」の[Attributes Settings]セクションのイベントIDと同じです。

ホスト名（オプション）

「テキスト形式のログファイルの監視定義ファイル（fluentd_@@trapname@@_tail.conf.template）」の[Attributes Settings]セクションのホスト名と同じです。

IM管理ノードのラベル名（オプション）

「テキスト形式のログファイルの監視定義ファイル（fluentd_@@trapname@@_tail.conf.template）」の[Attributes Settings]セクションのIM管理ノードのラベル名と同じです。

OSバージョン（オプション）

JP1イベントにOS_VERSIONの属性を追加する場合，Windowsのメジャーバージョンの番号を指定します。初期設定では「#」が行の先頭に指定されていてコメント扱いとなっているため，指定する場合は「#」を削除します。

[Inclusion Settings]セクション

「テキスト形式のログファイルの監視定義ファイル（fluentd_@@trapname@@_tail.conf.template）」の[Inclusion Settings]セクションの説明を参照してください。

[Exclusion Settings]セクション

「テキスト形式のログファイルの監視定義ファイル（fluentd_@@trapname@@_tail.conf.template）」の[Exclusion Settings]セクションの説明を参照してください。

[Forward Settings]セクション

「テキスト形式のログファイルの監視定義ファイル（fluentd_@@trapname@@_tail.conf.template）」の[Forward Settings]セクションの説明を参照してください。

定義例

次に示す定義例では，ログの種類が「application」，ソースが「JP1/IM-Manager」の場合に監視を行い，重大度が「警告」以上のときJP1イベントを発行します。

<worker 0>
## [Metric Settings]
<source>
  @type exec
  command "echo {}"
  <parse>
    @type json
  </parse>
  run_interval 60s
  tag jpc_ima_metrics.wevt.user_app_log
</source>

<filter jpc_ima_metrics.wevt.user_app_log>
  @type record_transformer
  enable_ruby true

  <record>
    __name__ fluentd_logtrap_running
    instance hostA
    jp1_pc_nodelabel ユーザーアプリケーション
    jp1_pc_category applicationServer
    jp1_pc_logtrap_defname user_app_log_wevt
    jp1_pc_trendname fluentd
    job jpc_fluentd
    jp1_pc_nodelabel_fluentd Log trapper(Fluentd)
    jp1_pc_addon_program JPC Fluentd
  </record>
</filter>
</worker>
<worker 2>

## [Input Settings]
<source>
  @type windows_eventlog2
  tag wevt.user_app_log
  channels application
  read_interval 2
  preserve_qualifiers_on_hash true
  <storage>
    @type local
    path ../data/jp1ima/data/fluentd/wevt/user_app_log
  </storage>
  read_from_head false
  render_as_xml false
  rate_limit -1
  preserve_qualifiers_on_hash true
  event_query *
</source>

## [Attributes Settings]
<filter wevt.user_app_log>
  @type record_transformer
  enable_ruby true
  renew_record false
  <record>
    ID 00007602
    JP1_SOURCEHOST hostA
    JPC_NODELABEL ユーザーアプリケーション
    OS_VERSION 10
  </record>
</filter>

## [Inclusion Settings]
<filter wevt.user_app_log>
  @type grep
  <regexp>
    key PRODUCT_NAME
    pattern /JP1¥/IM-M$/
  </regexp>
</filter>

## [Exclusion Settings]
#<filter wevt.user_app_log>
#  @type grep
#  <exclude>
#    key
#    pattern //
#  </exclude>
#</filter>

## [Forward Settings]
<match wevt.user_app_log>
  @type rewrite_tag_filter
  <rule>
    key SEVERITY
    pattern /Warning|Error|Critical|Alert|Emergency/
    tag ${tag}.jp1event
  </rule>
  <rule>
    key SEVERITY
    pattern /.*/
    tag ${tag}.outputlog
  </rule>
</match>

<filter /wevt¥.user_app_log¥.(jp1event|outputlog)/>
  @type record_transformer
  enable_ruby true
  auto_typecast true
  renew_record true
  <record>
    eventId ${record['ID']}
    xsystem true
    message ${record['MESSAGE']}
    attrs ${record}
  </record>

  remove_keys $.attrs.ID
  remove_keys $.attrs.MESSAGE
</filter>
</worker>

SAPシステムのシステムログ情報監視定義ファイルのサンプルファイル（fluentd_sap_syslog_tail.conf）

形式

「テキスト形式のログファイルの監視定義ファイル（fluentd_@@trapname@@_tail.conf.template）」の形式と同様です。

次に示す条件でテキスト形式のログファイルの監視機能を使用して，SAPシステムのシステムログ情報を監視する場合の定義例を，サンプルファイルとして提供します。

■条件

監視対象のログファイル

SAPシステムのシステムログ情報を抽出するコマンドのログファイルを監視します。

コマンド実行環境の言語設定は日本語で，文字コードはSJISです。監視対象のログファイルの文字コードがSJISでない場合，[Input Settings]のfrom_encodingで指定する文字コードを変更してください（Linux環境で動作させる場合，指定する文字コードをUTF-8に変更する必要があります）。

監視名

「sap_syslog」とします。

ログメッセージの例

システムログのメッセージレコードにデフォルトのレイアウトで出力されたログを監視します。

デフォルトのレイアウトは次のとおりです。コマンドの抽出可能なフィールドと仕様については，「jr3slget」を参照してください。

<TIME><INSTANCE><USER><PROGRAM><MSGNO><MSGTEXT>

出力されるログメッセージの例は次のとおりです。

13:58:04o246bci_SD5_00      SAPSYS      SAPMSSY1D01トランザクション取消済 00 152 ( )  （中略）

注　<MSGTEXT>の長さは255バイトです。

上記のログメッセージをフィールドごとに構造化すると，次のようになります。

フィールドID

フィールド

値

<TIME>

メッセージ記録時刻

13:58:04

<INSTANCE>

メッセージを記録したサーバ

o246bci_SD5_00

<USER>

メッセージを記録したユーザー

SAPSYS

<PROGRAM>

メッセージを記録したプログラム

SAPMSSY1

<MSGNO>

メッセージ番号

D01

<MSGTEXT>

メッセージテキスト

トランザクション取消済 00 152 ( )

監視するログメッセージ

すべてのログを監視します。システムログのメッセージレコードをフィールドごとに切り出し，それぞれをJP1イベントの属性として設定します。各フィールドと正規表現の名前付きキャプチャ機能で切り出す際の名前，およびJP1イベントの拡張属性の対応関係は，次のとおりです。

フィールドID

正規表現で

切り出す際の名前

JP1イベントの属性

設定する内容

<TIME>

sap_time

指定しません。

−

<INSTANCE>

instance

<USER>

user

<PROGRAM>

program

<MSGNO>

msgno

<MSGTEXT>

message

MESSAGE

フィールドの値をそのまま格納します。

（凡例）−：該当なし

SEVERITYに設定する値

「Notice」を設定します。

JP1イベントに変換するログデータ

SEVERITYの値が「Warning」以上の場合にマッチします。SEVERITYに「Notice」を指定しているため，JP1イベントは発行されず，Fluentdのログにだけ出力されます。

IM管理ノードのラベル名

SAP Syslog

■定義例

<worker 0>
## [Metric Settings]
  <source>
    @type exec
    command "echo {}"
    <parse>
      @type json
    </parse>
    run_interval 60s
    tag jpc_ima_metrics.tail.sap_syslog
  </source>

  <filter jpc_ima_metrics.tail.sap_syslog>
    @type record_transformer
    enable_ruby true
    auto_typecast false
    <record>
      __name__ fluentd_logtrap_running
      instance @@sap_instancename@@
      jp1_pc_nodelabel SAP Syslog
      jp1_pc_category enterprise
      jp1_pc_logtrap_defname sap_syslog_tail
      jp1_pc_trendname fluentd
      job jpc_fluentd
      jp1_pc_nodelabel_fluentd Log trapper(Fluentd)
      jp1_pc_addon_program JPC Fluentd
    </record>
  </filter>
</worker>

<worker 3>
## [Input Settings]
  <source>
    @type tail
    tag tail.sap_syslog
    path @@sap_logpath@@
    follow_inodes true
    refresh_interval 60
    skip_refresh_on_startup false
    read_from_head false
    encoding "UTF-8"
    from_encoding "Shift_JIS"
    read_lines_limit 1000
    read_bytes_limit_per_second -1
    pos_file ../data/fluentd/tail/sap_syslog.pos
    path_key tailed_path
    rotate_wait 5s
    enable_watch_timer false
    enable_stat_watcher true
    open_on_every_update false
    emit_unmatched_lines false
    ignore_repeated_permission_error false
    <parse>
      @type regexp
      expression /^(?<sap_time>.{8})(?<instance>.{20})(?<user>.{12})(?<program>.{8})(?<msgno>.{3})(?<message>.*)$/
      time_key time
      null_empty_string false
      estimate_current_event true
      keep_time_key false
      localtime true
      utc false
    </parse>
  </source>

## [Attributes Settings]
  <filter tail.sap_syslog>
    @type record_transformer
    enable_ruby true
    auto_typecast false
    renew_record true

    <record>
      ID 00007601
      MESSAGE ${record["message"]}
      JP1_SOURCEHOST @@sap_instancename@@
      JPC_LOG_TIME ${time.utc.to_i}
      PRODUCT_NAME /HITACHI/JP1/JPCCS2/LOGTRAP/SAP Syslog
      PPNAME /HITACHI/JP1/JPCCS2
      SEVERITY Notice
      PLATFORM ${ if RUBY_PLATFORM.downcase =~ /mswin(?!ce)|mingw|cygwin|bccwin/; 'NT'; else 'UNIX'; end }
      OBJECT_TYPE LOGFILE
      OBJECT_NAME ${record['tailed_path']}
      ROOT_OBJECT_TYPE LOGFILE
      ROOT_OBJECT_NAME ${record['tailed_path']}
      JP1_TRAP_NAME ${tag_parts[1]}
      JPC_NODELABEL SAP Syslog
    </record>
  </filter>

## [Inclusion Settings]
#<filter tail.sap_syslog>
#    @type grep
#    <regexp>
#      key nil
#      pattern nil
#    </regexp>
#  </filter>

## [Exclusion Settings]
#  <filter tail.sap_syslog>
#    @type grep
#    <exclude>
#      key nil
#      pattern nil
#    </exclude>
#  </filter>

## [Forward Settings]
  <match tail.sap_syslog>
    @type rewrite_tag_filter
    <rule>
      key SEVERITY
      pattern /Warning|Error|Critical|Alert|Emergency/
      tag ${tag}.jp1event
    </rule>
    <rule>
      key SEVERITY
      pattern /.*/
      tag ${tag}.outputlog
    </rule>
  </match>

  <filter /tail¥.sap_syslog¥.(jp1event|outputlog)/>
    @type record_transformer
    enable_ruby true
    auto_typecast true
    renew_record true
    <record>
      eventId ${record['ID']}
      xsystem true
      message ${record['MESSAGE']}
      attrs ${record}
    </record>
    remove_keys $.attrs.ID
    remove_keys $.attrs.MESSAGE
  </filter>
</worker>

ファイル

fluentd_sap_syslog_tail.conf

格納先ディレクトリ

■統合エージェントホスト

Windowsの場合

物理ホストのとき

Agentパス¥conf¥sample¥

Linuxの場合

物理ホストのとき

/opt/jp1ima/conf/sample/

説明

SAPシステムのシステムログ情報を監視するための定義ファイルのサンプルファイルです。

サンプルファイル（fluentd_sap_syslog_tail.conf）をコピーし，必要に応じてコピー先のファイル名を「fluentd_ログ監視名_tail.conf」に変更して使用します。ファイルの配置先については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「付録A.4(3)統合エージェントホスト（Windows）」および「付録A.4(4)統合エージェントホスト（Linux）」を参照してください。Script exporter設定ファイル（jpc_script_exporter.yml）で指定したスクリプトごとにこの定義ファイルを作成します。

先頭の文字が「#」である行は，コメントとして扱い，プログラムの動作には影響しません。

文字コード

UTF-8（BOM無し）

改行コード

Windowsの場合：CR+LF

Linuxの場合：LF

定義の反映時期

Fluentdのサービスを再起動したときに，Fluentdの動作に反映します。

定義ファイルを追加もしくは削除，または，[Metric Settings]セクションの値を変更した場合，統合オペレーション・ビューアーのツリー表示に，変更内容を反映します。

反映方法については，マニュアル「JP1/Integrated Management 3 - Manager 構築ガイド」の「1.21.2(16)IM管理ノードのツリー情報の作成と反映（Windows）（必須）」を参照してください。

記述内容

「テキスト形式のログファイルの監視定義ファイル（fluentd_@@trapname@@_tail.conf.template）」の「記述内容」の説明を参照してください。

このサンプルファイルをユーザーが使用する場合は，次に示す設定項目を，ユーザー環境に合わせて変更する必要があります。

設定項目

初期値

設定内容

監視対象のログファイルのパス

@@sap_logpath@@

環境パラメーター設定ファイルでユーザーが指定した，SAPシステムのシステムログ情報の抽出結果を出力するテキストファイルのパスを指定します。

システムログ情報を抽出するSAPインスタンス名

@@sap_instancename@@

SAPシステムのシステムログ情報の抽出結果を出力するSAPインスタンス名を指定します。

また，SEVERITYの値が「Warning」以上の場合にマッチするときにJP1イベントが発行される設定となっています。このサンプルではSEVERITYは常に「Notice」が設定されるため，JP1イベントは発行されず，Fluentdのログにだけ出力されます。ログ監視結果をJP1イベントとして出力する場合には，次の下線部分のように定義を変更します。

## [Forward Settings]
<match tail.sap_syslog>
  @type rewrite_tag_filter
  <rule>
    key SEVERITY
    pattern /Notice|Warning|Error|Critical|Alert|Emergency/
    tag ${tag}.jp1event
  </rule>
  <rule>
    key SEVERITY
    pattern /.*/
    tag ${tag}.outputlog
  </rule>
</match>

SAPシステムのCCMSアラート情報監視定義ファイルのサンプルファイル（fluentd_sap_alertlog_tail.conf）

形式

「テキスト形式のログファイルの監視定義ファイル（fluentd_@@trapname@@_tail.conf.template）」の形式と同様です。

次に示す条件でテキスト形式のログファイルの監視機能を使用して，SAPシステムのCCMSアラート情報を監視する場合の定義例を，サンプルファイルとして提供します。

■条件

監視対象のログファイル

SAPシステムのCCMSアラート情報を抽出するコマンドのログファイルを監視します。

コマンド実行環境の言語設定は日本語で，文字コードはSJISです。監視対象のログファイルの文字コードがSJISでない場合，[Input Settings]のfrom_encodingで指定する文字コードを変更してください（Linux環境で動作させる場合，指定する文字コードをUTF-8に変更する必要があります）。

監視名

「sap_alertlog」とします。

ログメッセージの例

CCMSアラートレコードにデフォルトのレイアウトで出力されたログを監視します。

デフォルトのレイアウトは次のとおりです。コマンドの抽出可能なフィールドと仕様については，「jr3alget」を参照してください。

<ALERT_DATE><ALERT_TIME><MTSYSID><MTMCNAME><OBJECTNAME><FIELDNAME><VALUE><SEVERITY><MSG>

出力されるログメッセージの例を，次に示します。

20231219041721NWE     Background                              BackgroundService                       SystemWideFreeBPWP                      3          50         0 WPs > 2 WPs 現在値がしきい値を超過しています  （中略）

注　<MSG>の長さは255バイトです。

上記のログメッセージをフィールドごとに構造化すると，次のようになります。

フィールドID

フィールド

値

<ALERT_DATE>

アラート発生日付 (YYYYMMDD)

20231219

<ALERT_TIME>

アラート発生時刻 (HHMMSS)

041721

<MTSYSID>

SAPシステムの名称

NWE

<MTMCNAME>

監視コンテキスト名

Background

<OBJECTNAME>

監視オブジェクト名

BackgroundService

<FIELDNAME>

MTE略称

SystemWideFreeBPWP

<VALUE>

警告値

3

<SEVERITY>

重大度

50

<MSG>

翻訳済みメッセージ

0 WPs > 2 WPs 現在値がしきい値を超過しています

監視するログメッセージ

すべてのログを監視します。システムログのメッセージレコードをフィールドごとに切り出し，そのうち翻訳済みメッセージと警告値を，それぞれをJP1イベントメッセージと重大度として設定します。各フィールドと正規表現の名前付きキャプチャ機能で切り出す際の名前，およびJP1イベントの拡張属性の対応関係は，次のとおりです。

フィールドID

正規表現で

切り出す際の名前

JP1イベントの属性

設定する内容

<ALERT_DATE>

alertdate

指定しません。

−

<ALERT_TIME>

alerttime

<MTSYSID>

mtsysid

<MTMCNAME>

mtmcname

<OBJECTNAME>

objectname

<FIELDNAME>

fieldname

<VALUE>

value

SEVERITY

<VALUE>の値に合わせて，重要度を格納します。

値が0の場合: Debug

値が1の場合: Information

値が2の場合: Warning

値が3の場合: Error

上記以外の場合：Notice

<SEVERITY>

severity

指定しません。

−

<MSG>

message

MESSAGE

フィールドの値をそのまま格納します。

（凡例）−：該当なし

JP1イベントに変換するログデータ

SEVERITYの値が「Warning」以上の場合にマッチします。SEVERITYに「Debug」，「Information」，または「Notice」が指定されている場合は，JP1イベントは発行されず，Fluentdのログにだけ出力されます。

IM管理ノードのラベル名

SAP CCMS Alert

■定義例

<worker 0>
## [Metric Settings]
  <source>
    @type exec
    command "echo {}"
    <parse>
      @type json
    </parse>
    run_interval 60s
    tag jpc_ima_metrics.tail.sap_alertlog
  </source>

  <filter jpc_ima_metrics.tail.sap_alertlog>
    @type record_transformer
    enable_ruby true
    auto_typecast false
    <record>
      __name__ fluentd_logtrap_running
      instance @@sap_instancename@@
      jp1_pc_nodelabel SAP CCMS Alert
      jp1_pc_category enterprise
      jp1_pc_logtrap_defname sap_alertlog_tail
      jp1_pc_trendname fluentd
      job jpc_fluentd
      jp1_pc_nodelabel_fluentd Log trapper(Fluentd)
      jp1_pc_addon_program JPC Fluentd
    </record>
  </filter>
</worker>

<worker 4>
## [Input Settings]
  <source>
    @type tail
    tag tail.sap_alertlog
    path @@sap_logpath@@
    follow_inodes true
    refresh_interval 60
    skip_refresh_on_startup false
    read_from_head false
    encoding "UTF-8"
    from_encoding "Shift_JIS"
    read_lines_limit 1000
    read_bytes_limit_per_second -1
    pos_file ../data/fluentd/tail/sap_alertlog.pos
    path_key tailed_path
    rotate_wait 5s
    enable_watch_timer false
    enable_stat_watcher true
    open_on_every_update false
    emit_unmatched_lines false
    ignore_repeated_permission_error false
    <parse>
      @type regexp
      expression /^(?<alert_date>.{8})(?<alert_time>.{6})(?<mtsysid>.{8})(?<mtmcname>.{40})(?<objectname>.{40})(?<fieldname>.{40})(?<value>.{11})(?<severity>.{11})(?<message>.*)$/
      time_key time
      null_empty_string false
      estimate_current_event true
      keep_time_key false
      localtime true
      utc false
    </parse>
  </source>

## [Attributes Settings]
  <filter tail.sap_alertlog>
    @type record_transformer
    enable_ruby true
    auto_typecast false
    renew_record true

    <record>
      ID 00007601
      MESSAGE ${record["message"]}
      JP1_SOURCEHOST @@sap_instancename@@
      JPC_LOG_TIME ${time.utc.to_i}
      PRODUCT_NAME /HITACHI/JP1/JPCCS2/LOGTRAP/SAP CCMS Alert
      PPNAME /HITACHI/JP1/JPCCS2
#      SEVERITY Notice
      SEVERITY "${
           if record['value'].match(/3/)
             'Error'
           elsif record['value'].match(/2/)
             'Warning'
           elsif record['value'].match(/1/)
             'Information'
           elsif record['value'].match(/0/)
             'Debug'
           else
             'Notice'
           end}"
      PLATFORM ${ if RUBY_PLATFORM.downcase =~ /mswin(?!ce)|mingw|cygwin|bccwin/; 'NT'; else 'UNIX'; end }
      OBJECT_TYPE LOGFILE
      OBJECT_NAME ${record['tailed_path']}
      ROOT_OBJECT_TYPE LOGFILE
      ROOT_OBJECT_NAME ${record['tailed_path']}
      JP1_TRAP_NAME ${tag_parts[1]}
      JPC_NODELABEL SAP CCMS Alert
    </record>
  </filter>

## [Inclusion Settings]
#<filter tail.sap_alertlog>
#    @type grep
#    <regexp>
#      key nil
#      pattern nil
#    </regexp>
#  </filter>

## [Exclusion Settings]
#  <filter tail.sap_alertlog>
#    @type grep
#    <exclude>
#      key nil
#      pattern nil
#    </exclude>
#  </filter>

## [Forward Settings]
  <match tail.sap_alertlog>
    @type rewrite_tag_filter
    <rule>
      key SEVERITY
      pattern /Warning|Error|Critical|Alert|Emergency/
      tag ${tag}.jp1event
    </rule>
    <rule>
      key SEVERITY
      pattern /.*/
      tag ${tag}.outputlog
    </rule>
  </match>

  <filter /tail¥.sap_alertlog¥.(jp1event|outputlog)/>
    @type record_transformer
    enable_ruby true
    auto_typecast true
    renew_record true
    <record>
      eventId ${record['ID']}
      xsystem true
      message ${record['MESSAGE']}
      attrs ${record}
    </record>
    remove_keys $.attrs.ID
    remove_keys $.attrs.MESSAGE
  </filter>
</worker>

ファイル

fluentd_sap_alertlog_tail.conf

格納先ディレクトリ

■統合エージェントホスト

Windowsの場合

物理ホストのとき

Agentパス¥conf¥sample¥

Linuxの場合

物理ホストのとき

/opt/jp1ima/conf/sample/

説明

SAPシステムのCCMSアラート情報を監視するための定義ファイルのサンプルファイルです。

サンプルファイル（fluentd_sap_alertlog_tail.conf）をコピーし，必要に応じてコピー先のファイル名を「fluentd_ログ監視名_tail.conf」に変更して使用します。ファイルの配置先については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「付録A.4(3)統合エージェントホスト（Windows）」および「付録A.4(4)統合エージェントホスト（Linux）」を参照してください。Script exporter設定ファイル（jpc_script_exporter.yml）で指定したスクリプトごとにこの定義ファイルを作成します。

先頭の文字が「#」である行は，コメントとして扱い，プログラムの動作には影響しません。

文字コード

UTF-8（BOM無し）

改行コード

Windowsの場合：CR+LF

Linuxの場合：LF

定義の反映時期

Fluentdのサービスを再起動したときに，Fluentdの動作に反映します。

定義ファイルを追加もしくは削除，または，[Metric Settings]セクションの値を変更した場合，統合オペレーション・ビューアーのツリー表示に，変更内容を反映します。

反映方法については，マニュアル「JP1/Integrated Management 3 - Manager 構築ガイド」の「1.21.2(16)IM管理ノードのツリー情報の作成と反映（Windows）（必須）」を参照してください。

記述内容

「テキスト形式のログファイルの監視定義ファイル（fluentd_@@trapname@@_tail.conf.template）」の「記述内容」の説明を参照してください。

このサンプルファイルをユーザーが使用する場合は，次に示す設定項目を，ユーザー環境に合わせて変更する必要があります。

設定項目

初期値

設定内容

監視対象のログファイルのパス

@@sap_logpath@@

環境パラメーター設定ファイルでユーザーが指定した，SAPシステムのCCMSアラート情報の抽出結果を出力するテキストファイルのパスを指定します。

CCMSアラート情報を抽出するSAPインスタンス名

@@sap_instancename@@

SAPシステムのCCMSアラート情報の抽出結果を出力するSAPインスタンス名を指定します。

また，SEVERITYの値が「Warning」以上の場合にマッチするときにJP1イベントが発行される設定となっています。SEVERITYに「Notice」，「Debug」，または「Information」が指定されている場合，JP1イベントは発行されず，Fluentdのログにだけ出力されます。SEVERITYが「Notice」，「Debug」，または「Information」であるログ監視結果をJP1イベントとして出力する場合には，次の下線部分のように定義を変更します。

## [Forward Settings]
<match tail.sap_alertlog>
  @type rewrite_tag_filter
  <rule>
    key SEVERITY
    pattern /Notice|Debug|Information|Warning|Error|Critical|Alert|Emergency/
    tag ${tag}.jp1event
  </rule>
  <rule>
    key SEVERITY
    pattern /.*/
    tag ${tag}.outputlog
  </rule>
</match>

jr3slgetコマンドの環境パラメーター設定ファイル（jr3slget.ini）

jr3slgetコマンド実行時に，引数として環境パラメーター設定ファイルを指定すると，ファイルの設定内容を基に，SAPシステムのシステムログ情報が抽出されます。

この環境パラメーター設定ファイルは，テキストファイルとしてユーザーが作成します。

設定手順

環境パラメーター設定ファイルの設定手順を次に示します。

環境パラメーター設定ファイルを編集する前に，jr3slgetコマンドが実行されていないことを確認する。

環境パラメーター設定ファイルを新規に作成する場合は，環境パラメーター設定ファイルのサンプルファイルを「jr3slget.ini」の名前でコピーする。

この「jr3slget.ini」が，デフォルトの環境パラメーター設定ファイルとなります。環境パラメーター設定ファイルのサンプルファイルを次に示します。

■統合エージェントホスト

Windowsの場合

・物理ホストのとき

Windows版のSAPシステム監視のアーカイブファイル※の展開先¥sap_windows¥command¥agtm¥evtrap¥jr3slget.ini.sample

注※　Agentパス¥options¥sap_windows_VVRRSS.zip

Linuxの場合

・物理ホストのとき

Linux版のSAPシステム監視のアーカイブファイル※の展開先/sap_linux/command/agtm/evtrap/jr3slget.ini.sample

注※　/opt/jp1ima/options/sap_linux_VVRRSS.tar.gz

jr3slget.iniを開く。

設定内容を編集する。

デフォルトの環境パラメーター設定ファイルの設定内容を次に示します。設定内容については，「設定内容」を参照してください。

コメント行を表す「;」が行頭にある項目は，デフォルトでは設定が有効になっていません。設定を有効にするには，コメント行を表す「;」を外してください。

環境パラメーター設定ファイルを保存する。

jr3slgetコマンド実行時に-cnfオプションを指定することで，環境パラメーター設定ファイルの内容を基にSAPシステムのシステムログ情報が抽出されます。

設定内容

環境パラメーター設定ファイルは，次の形式で記述します。

[セクション]
ラベル=値
ラベル=値
：
：
[セクション]
ラベル=値
ラベル=値

注意

行頭および「=」の前後に，空白文字などの余計な文字を設定しないでください。

セクションおよびラベルでは，指定した値の大文字・小文字は区別されません。

行の先頭に「;」を指定すると，その行はコメントとして扱われます。

次に，環境パラメーター設定ファイルの各セクションで設定する内容を表形式で説明します。表の「引数」列は，jr3slgetコマンドでも指定できる設定値の場合，コマンドで指定する際の引数を示します。「−」は，コマンドでは指定できない項目を示します。

CONNECTセクション

CONNECTセクションでは，コマンド実行時に，SAPシステムとのRFC接続を確立するための情報を指定します。

表2‒98　CONNECTセクションに指定できる値

ラベル

意味

指定できる値

デフォルト値

引数

ASHOST

接続先のアプリケーションサーバのホスト名（トランザクションコードSM51で確認できるホスト名）。

1〜100バイトの半角英数字。次の形式で指定できる。

hostsファイルに指定されたホスト名

IPアドレス

SAPルーターアドレス

localhost

-h

SYSNR

接続先のアプリケーションサーバホストで識別するためのシステム番号。

0〜99

00

-s

CLIENT

接続に利用するユーザーのクライアント名。

0〜999

000

-c

USER

接続に利用するユーザー名。※1

1〜12バイトの半角英数字。

CPIC

-u

PASSWD

接続に利用するユーザーのパスワード。※2

1〜8バイトの半角文字列。※3

ADMIN

-p

PASSWD2

接続に利用するユーザーの拡張パスワード。※2

1〜40バイトの半角文字列。※3

ADMIN

-p2

LANG

接続に利用するユーザーの言語。

日本語と英語が使用できる。 次に示すSAPシステムで使用されている2バイトのISO IDまたは1バイトの言語キーを指定する。

日本語の場合：JAまたはJ

英語の場合：ENまたはE

なし

-l

CODEPAGE

接続先のUnicode版SAPシステムで文字コードを変換する時に使用するコードページ。

LANGラベルの言語と組み合わせて指定する。※4

なし

-codepage

注※1

このラベルで指定するユーザーには，次の権限を付与しておく必要があります。

表2‒99　ユーザーが汎用モジュールにRFC接続するための権限（S_RFC）

権限項目

説明

値

RFC_TYPE

保護されるRFCオブジェクトのタイプ

FUGR（汎用グループ）

RFC_NAME

保護されるRFC名

*

ACTVT

アクティビティ

16（実行）

表2‒100　外部管理インターフェースを使用するための権限（S_XMI_PROD）

権限項目

説明

値

EXTCOMPANY

外部管理ツールの会社名

HITACHI

EXTPRODUCT

外部管理ツールのプログラム名

JP1

INTERFACE

インターフェースID

XAL

また，このラベルで指定するユーザーには，次のタイプのユーザーが使用できます。

ダイアログ（Dialog）

システム（System）

通信（Communication）

サービス（Service）

注※2

PASSWDラベルは，SAPシステム側で従来型のパスワードルールが適用されている場合に指定します。PASSWD2ラベルは，SAPシステム側で拡張パスワードルールが適用されている場合に指定します。PASSWDラベルとPASSWD2ラベルは同時に指定できません。

注※3

接続に利用するユーザーのパスワード，および拡張パスワードは，半角数字（0〜9），半角英字（a〜z，A〜Z），および次の半角記号で定義してください。

! @ $ % & / ( ) = ? ' ` * + ~ # - _ . : { [ ] } < > |

注※4

LANGラベルとCODEPAGEラベルは，次の組み合わせで設定してください。次の組み合わせ以外の言語とコードページを指定した場合，SAPシステムから取得した情報が文字化けする可能性があります。

表2‒101　言語とコードページの指定内容の組み合わせ

接続先SAPシステム

接続言語

言語（LANG）

コードページ（CODEPAGE）

Unicode版

日本語

JA

8000

英語

EN

指定する必要はありません。指定する場合は，1100を指定してください。

非Unicode版

日本語

JA

指定する必要はありません。指定する場合は，8000を指定してください。

英語

EN

指定する必要はありません。指定する場合は，1100を指定してください。

LANGラベルの指定を省略した場合，接続先システムで定義されているユーザーの言語が仮定されます。

CODEPAGEラベルの指定を省略した場合，接続先システムのデフォルトコードページが仮定されます。

COMMANDセクション

COMMANDセクションでは，jr3slgetコマンドの作業ディレクトリの情報を指定します。

表2‒102　COMMANDセクションに指定できる値

ラベル

意味

指定できる値

デフォルト値

引数

WORKDIR

コマンドの作業ディレクトリ。

1〜255バイトの半角英数字。相対パスを指定した場合，カレントディレクトリからの相対パスとなる。

カレントディレクトリ

−

TRACEセクション

TRACEセクションでは，jr3slgetコマンドの実行履歴が保存されるメッセージログおよびデータログの情報を指定します。

表2‒103　TRACEセクションに指定できる値

ラベル

意味

指定できる値

デフォルト値

引数

MSGLOG_LEVEL

アプリケーションのトレース情報を保存するメッセージログの取得レベル。

0：採取しない

1：エラーだけ採取

2：標準

3：詳細

4：デバッグ

0〜4

2

−

MSGLOG_SIZE

メッセージログを取得するファイル容量。

0：2GB（32ビットの符号付き整数で示せる最大値（0x7FFFFFFF））

1〜65535：指定サイズ（単位：キロバイト）内でラップアラウンド

0〜65535

512

−

MSGLOG_DIR

メッセージログファイル（jr3slget.log）の取得先ディレクトリ。

1〜255バイトの半角英数字。ファイル名部分のjr3slget.logまでを含めて255バイト以内で指定する必要がある。相対パスを指定した場合，コマンドの作業ディレクトリからの相対パスとなる。

コマンドの作業ディレクトリ（COMMANDセクションのWORKDIRラベルで変更していないときは，カレントディレクトリ）

−

DATALOG_LEVEL

アプリケーションの各種データ情報を保存するデータログの取得レベル。

0：採取しない

1：エラーだけ採取

2：標準

3：詳細

4：デバッグ

0〜4

2

−

DATALOG_SIZE

データログを取得するファイル容量。

0：2GB（32ビットの符号付き整数で示せる最大値（0x7FFFFFFF））

1〜65535：指定サイズ（単位：キロバイト）内でラップアラウンド

0〜65535

512

−

DATALOG_DIR

データログファイル（jr3slget.dat）の取得先ディレクトリ。

1〜255バイトの半角英数字。ファイル名部分のjr3slget.datまでを含めて255バイト以内で指定する必要がある。相対パスを指定した場合，コマンドの作業ディレクトリからの相対パスとなる。

コマンドの作業ディレクトリ（COMMANDセクションのWORKDIRラベルで変更していないときは，カレントディレクトリ）

−

TARGETセクション

TARGETセクションでは，抽出対象のシステムログ情報を特定するための情報を指定します。

表2‒104　TARGETセクションに指定できる値

ラベル

意味

指定できる値

デフォルト値

引数

SERVER

SAPインスタンス名（トランザクションコードSM51で確認できる，ダイアログサービスを持つSAPインスタンス名）。

1〜20バイトの半角英数字。

なし

-server

FORMATセクション

FORMATセクションでは，出力されるシステムログ情報の出力形式を指定します。

表2‒105　FORMATセクションに指定できる値

ラベル

意味

指定できる値

デフォルト値

引数

COLUMN

出力されるシステムログ情報の出力形式。

フィールドID。フィールドIDについては，「jr3slget」（1.コマンド）の「出力形式および内容」を参照のこと。

列1：<TIME>

列2：<INSTANCE>

列3：<USER>

列4：<PROGRAM>

列5：<MSGNO>

列6：<MSGTEXT>

−

EXTRACTFILEセクション

EXTRACTFILEセクションでは，システムログ情報の出力ファイルの情報を指定します。

表2‒106　EXTRACTFILEセクションに指定できる値

ラベル

意味

指定できる値

デフォルト値

TYPE

システムログ情報を格納するファイルの形式。

WRAP1

システムログ情報が一定の容量に達すると，ラップアラウンドして再び先頭からデータを上書きする形式のファイルです。

WRAP2

NUMラベルで設定した複数のファイルを持つ形式です。1つ目のファイルが一定の容量に達すると，ラップアラウンドして2つ目のファイルに書き込みます。このとき，2つ目のファイルのデータを削除し，先頭からデータを書き込みます。

複数のファイルすべてで一定の容量に達すると，1つ目のファイルに戻ってデータを削除し，先頭からデータを書き込みます。

JP1/IM - Agentの環境を新規で構築する場合は，WRAP2を指定することを推奨します。

運用の開始後，格納ファイルの形式を変更する場合は，事前に格納ファイルを監視している製品を停止し，格納ファイルとその管理ファイル※1を削除してください。

WRAP1またはWRAP2

WRAP1

SIZE

1ファイル当たりの格納ファイル容量。

0：

2GB（32ビットの符号付き整数で示せる最大値（0x7FFFFFFF））

1〜65535：

指定サイズ内でラップアラウンド（キロバイト）。

0〜65535

10240

X2PATH

TYPEラベルでWRAP1を設定している場合

-x2オプションで，格納ファイル出力を指定したときに適用される格納ファイルのパスを指定する。※1※2

TYPEラベルでWRAP2を設定している場合

-x2オプションで，格納ファイル出力を指定したときに適用される格納ファイルを指定する。※2※3

TYPEラベルでWRAP1を設定している場合

1〜251バイトの半角英数字。※4

TYPEラベルでWRAP2を設定している場合

1〜254バイトの半角英数字。※4

−

NUM

WRAP2形式で格納するときのファイル数。

TYPEラベルでWRAP2を設定している場合だけ有効です。

2〜9

5

注※1

WRAP1形式の場合，格納ファイルと同じディレクトリに，格納ファイル名.ofsという名称で管理ファイルが作成されます。

例：

格納ファイル名としてSYSLOGを指定したときSYSLOGファイルとは別にSYSLOG.ofsファイルが管理ファイルとして作成されます。

格納ファイルを削除する場合は，この管理ファイルも合わせて削除してください。

注※2

デフォルトの格納先から変更した場合，格納ファイルと管理ファイルをjpcrasコマンドで採取することができません。このため，トラブルが発生した場合，手動で格納ファイルと管理ファイルを採取していただく必要があります。

注※3

この値にNUMラベルに指定した範囲（デフォルトは1〜5）の値が付与されたファイル名が格納されます。

注※4

相対パスを指定した場合，コマンドの作業ディレクトリ（COMMANDセクションのWORKDIRラベルに指定したディレクトリ）が相対パスのカレントディレクトリとなります。なお，作業ディレクトリが指定されていない場合，次のディレクトリからの相対パスのカレントディレクトリとなります。

Optionセクション

Optionセクションでは，システムログの抽出の基点を決めるための情報を指定します。

SAPシステムのタイムゾーンは，システムログ情報抽出機能で参照する環境パラメーター設定ファイルのOptionセクションのSAPTIMEZONEOFFSETに設定します。SAPTIMEZONEOFFSETを設定することで，JP1/IM - Agentの稼働ホストとSAPシステムでタイムゾーンが異なる環境でも，システムログ情報を正しく抽出できます。ラベルが未設定の場合，デフォルト値を使用します。

なお，リモート監視における収集基点時間の推奨値については，「収集基点時間の注意事項」を参照してください。また，SAPシステムのタイムゾーンを設定する場合は，「SAPシステムのタイムゾーンの注意事項」を参照してください。

表2‒107　Optionセクションに指定できる値

ラベル

意味

指定できる値

デフォルト値

SHIFTEXTRACTTIME※1

システムログ情報の抽出の基点を決める収集基点時間（単位：秒）。

収集時刻に対して，抽出対象のシステムログ情報の時刻の範囲をずらす時間を指定してください。

0〜600

5

SAPTIMEZONEOFFSET※2

JP1/IM - Agentの稼働ホストとSAPシステムでタイムゾーン（夏時間の適用有無を含む）が異なる場合に，SAPシステムのタイムゾーンをUTCとの時刻差（単位：分）で設定してください。

-1440〜+1440※3

JP1/IM - Agentの稼働ホストのタイムゾーン

例えば，JP1/IM - Agentの稼働ホストのタイムゾーンがJST（UTC+9）である場合，+540となります。

注※1

0以上の数値を指定する場合，符号（+）を省略できます。

注※2

SAPシステムの処理遅延によって，発生時刻通りにシステムログ情報が保存されない場合，このラベルの設定値をデフォルトよりも大きな値に変更してください。

注※3

リモート監視機能を使用する環境でJP1/IM - Agentが稼働するホストと監視対象のSAPシステムが稼働するホストのタイムゾーンが異なる場合だけ設定してください。

収集基点時間およびタイムゾーンの設定例を次に示します。

収集基点時間を10秒とする場合

[Option]
SHIFTEXTRACTTIME=10

SAPシステムのタイムゾーンがUTC（UTC+0），かつ標準時間である場合

[Option]
SAPTIMEZONEOFFSET=0

SAPシステムのタイムゾーンがEST（UTC-5），かつ夏時間（+1時間）である場合

[Option]
SAPTIMEZONEOFFSET=-240

注意事項

SAPシステムのタイムゾーンの設定を変更した場合（標準時間と夏時間の切り替えに伴う変更を除く），設定変更前のタイムゾーンに基づくタイムスタンプが記録された，タイムスタンプファイルは削除する必要があります。jr3slgetコマンドの-lasttimeオプションに指定したタイムスタンプファイルが存在する場合には，コマンド実行を再開する前にタイムスタンプファイルを削除してください。

収集基点時間の注意事項

収集基点時間を設定する場合は，次の点に注意してください。

環境パラメーター設定ファイルを作成するまたは更新するときにOptionセクションとSHIFTEXTRACTTIMEラベルを追加してください。

リモート監視における収集基点時間の推奨値は，次の考え方に沿って変更してください。

収集基点時間の考え方

SAPシステムの処理遅延によって，発生時刻通りにシステムログ情報/CCMSアラート情報が保存されていない場合があります。この場合，監視対象がローカルホストであったとしても，SAPシステムの時刻遅延（ホスト間の時刻差）が収集基点時間を超えた場合と同様に，システムログ/CCMSアラート情報の抽出漏れが発生します。この問題を回避するために，収集基点時間のデフォルト値は5秒としています。リモートホストを監視対象とする場合には，さらにSAPシステムの時刻遅延の影響が加わるため，前提条件のホスト間の時刻ずれが1秒未満の環境に対して余裕を持たせた値（5秒）を加えた10秒を推奨設定値としています。

SAPシステムのタイムゾーンの注意事項

SAPシステムのタイムゾーンを設定する場合は，次の点に注意してください。

環境パラメーター設定ファイルのサンプルファイルには，OptionセクションやSAPTIMEZONEOFFSETラベルはありません。環境パラメーター設定ファイルを作成するときに追加してください。

SAPシステム上で発生したシステムログ情報/CCMSアラート情報は，SHIFTEXTRACTTIMEに設定した時間経過した以降の収集により，初めてJP1側で参照できるようになります。SHIFTEXTRACTTIMEの設定値を推奨値から変更する場合は，収集タイミングが遅れることを考慮のうえ変更してください。SHIFTEXTRACTTIMEの設定値が，システムログ情報/CCMSアラート情報の抽出に与える影響を次の図に示します。

図2‒12　SHIFTEXTRACTTIMEの情報抽出範囲への影響

jr3slgetコマンドの環境パラメーター設定ファイルのサンプルファイル（jr3slget.ini.sample）

形式

[CONNECT]
ASHOST=localhost
SYSNR=00
CLIENT=000
USER=CPIC
PASSWD=ADMIN
;PASSWD2=ADMIN
;LANG=JA
;CODEPAGE=8000

[COMMAND]
WORKDIR=../data/sap/command/jr3slget

[TRACE]
MSGLOG_LEVEL=2
MSGLOG_SIZE=512
MSGLOG_DIR=.
DATALOG_LEVEL=2
DATALOG_SIZE=512
DATALOG_DIR=.

[TARGET]
;SERVER=

[FORMAT]
;COLUMN=<TIME>
;COLUMN=<INSTANCE>
;COLUMN=<USER>
;COLUMN=<PROGRAM>
;COLUMN=<MSGNO>
;COLUMN=<MSGTEXT>

[EXTRACTFILE]
TYPE=WRAP2
NUM=5
SIZE=10240
X2PATH=SYSLOG

ファイル

jr3slget.ini.sample

格納先ディレクトリ

■統合エージェントホスト

Windowsの場合

物理ホストのとき

Windows版のSAPシステム監視のアーカイブファイル※の展開先¥sap_windows¥command¥agtm¥evtrap¥

注※

Agentパス¥options¥sap_windows_VVRRSS.zip

Linuxの場合

物理ホストのとき

Linux版のSAPシステム監視のアーカイブファイル※の展開先/sap_linux/command/agtm/evtrap/

注※

/opt/jp1ima/options/sap_linux_VVRRSS.tar.gz

説明

SAPシステム監視で使用するjr3slgetコマンドの入力ファイルです。各種環境パラメーターを事前定義するため，ユーザーが作成する必要があります。ユーザーは，サンプルファイル（jr3slget.ini.sample）をコピーし，コピー先のファイル名を「任意の名前.ini」に変更して使用します。

ファイルの配置先については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「付録A.4(3)統合エージェントホスト（Windows）」および「付録A.4(3)統合エージェントホスト（Linux）」を参照してください。

なお，デフォルト環境パラメーター設定ファイル（-cnfオプションで指定しないときにシステムが検索するファイル）の位置は，コマンド実行時のカレントディレクトリ下のコマンド名.iniとなります。

文字コード

ASCIIコード

改行コード

Windowsの場合：CR+LF

Linuxの場合：LF

定義の反映時期

Script exporterを使用してコマンド実行する場合，Script exporterの再起動時に反映されます。そのほかの方法でコマンド実行する場合，ファイル保存時に反映されます。

記述内容

「jr3slgetコマンドの環境パラメーター設定ファイル（jr3slget.ini）」を参照してください。

■COMMANDセクション

WORKDIRラベル

WORKDIRラベルは，コマンドの作業ディレクトリをデフォルトから変更する場合に設定します。ユーザーは，WORKDIRラベルに設定したパスのディレクトリを作成しておく必要があります。

SAPシステムのログ抽出コマンドを使用して，マルチインスタンスのSAPシステムを監視する場合など，環境パラメーター設定ファイルを複数作成する場合には，WORKDIRラベルにそれぞれ異なるパスを設定する必要があります。

Script exporterを使用してSAPのログ抽出コマンドを実行する場合で，次の値を設定したときは，Script exporterのサービス定義ファイルに指定されている作業ディレクトリからの相対パスで，下記ディレクトリに，SAPシステムのログ抽出コマンドのログファイル，SAPシステムのログ抽出コマンドのトレースファイル，RFCライブラリが出力するトレースファイルが出力されます。

../data/sap/command/jr3slget

■EXTRACTFILEセクション

TYPEラベル

スクリプト実行結果監視機能（Fluentd）を使用して出力されたテキストファイルを監視する場合は，出力形式をWRAP2に指定する必要があります。スクリプト実行結果監視機能（JP1/Base）を使用して監視する場合も，WRAP2の指定を推奨します。

jr3algetコマンドの環境パラメーター設定ファイル（jr3alget.ini）

jr3algetコマンド実行時に，引数として環境パラメーター設定ファイルを指定すると，ファイルの設定内容を基に，SAPシステムのCCMSアラート情報が抽出されます。

この環境パラメーター設定ファイルは，テキストファイルとしてユーザーが作成します。

設定手順

環境パラメーター設定ファイルの設定手順を次に示します。

環境パラメーター設定ファイルを編集する前に，jr3algetコマンドが実行されていないことを確認する。

環境パラメーター設定ファイルを新規に作成する場合は，環境パラメーター設定ファイルのサンプルファイルを「jr3alget.ini」の名前でコピーする。

この「jr3alget.ini」が，デフォルトの環境パラメーター設定ファイルとなります。環境パラメーター設定ファイルのサンプルファイルを次に示します。

■統合エージェントホスト

Windowsの場合

・物理ホストのとき

Windows版のSAPシステム監視のアーカイブファイル※の展開先¥sap_windows¥command¥agtm¥evtrap¥jr3alget.ini.sample

注※　Agentパス¥options¥sap_windows_VVRRSS.zip

Linuxの場合

・物理ホストのとき

Linux版のSAPシステム監視のアーカイブファイル※の展開先/sap_linux/command/agtm/evtrap/jr3alget.ini.sample

注※　/opt/jp1ima/options/sap_linux_VVRRSS.tar.gz

jr3alget.iniを開く。

設定内容を編集する。

デフォルトの環境パラメーター設定ファイルの設定内容を次に示します。設定内容については，「設定内容」を参照してください。

コメント行を表す「;」が行頭にある項目は，デフォルトでは設定が有効になっていません。設定を有効にするには，コメント行を表す「;」を外してください。

環境パラメーター設定ファイルを保存する。

jr3algetコマンド実行時に-cnfオプションを指定することで，環境パラメーター設定ファイルの内容を基にSAPシステムのCCMSアラート情報が抽出されます。

設定内容

環境パラメーター設定ファイルは，次の形式で記述します。

[セクション]
ラベル=値
ラベル=値
：
：
[セクション]
ラベル=値
ラベル=値

注意

行頭および「=」の前後に，空白文字などの余計な文字を設定しないでください。

セクションおよびラベルでは，指定した値の大文字・小文字は区別されません。

行の先頭に「;」を指定すると，その行はコメントとして扱われます。

次に，環境パラメーター設定ファイルの各セクションで設定する内容を表形式で説明します。表の「引数」列は，jr3algetコマンドでも指定できる設定値の場合，コマンドで指定する際の引数を示します。「−」は，コマンドでは指定できない項目を示します。

CONNECTセクション

CONNECTセクションでは，コマンド実行時に，SAPシステムとのRFC接続を確立するための情報を指定します。

表2‒108　CONNECTセクションに指定できる値

ラベル

意味

指定できる値

デフォルト値

引数

ASHOST

接続先のアプリケーションサーバのホスト名（トランザクションコードSM51で確認できるホスト名）。

1〜100バイトの半角英数字。次の形式で指定できる。

hostsファイルに指定されたホスト名

IPアドレス

SAPルーターアドレス

localhost

-h

SYSNR

接続先のアプリケーションサーバホストで識別するためのシステム番号。

0〜99

00

-s

CLIENT

接続に利用するユーザーのクライアント名。

0〜999

000

-c

USER

接続に利用するユーザー名。※1

1〜12バイトの半角英数字。

CPIC

-u

PASSWD

接続に利用するユーザーのパスワード。※2

1〜8バイトの半角文字列。※3

ADMIN

-p

PASSWD2

接続に利用するユーザーの拡張パスワード。※2

1〜40バイトの半角文字列。※3

ADMIN

-p2

LANG

接続に利用するユーザーの言語。

日本語と英語が使用できる。 次に示すSAPシステムで使用されている2バイトのISO IDまたは1バイトの言語キーを指定する。

日本語の場合：JAまたはJ

英語の場合：ENまたはE

なし

-l

CODEPAGE

接続先のUnicode版SAPシステムで文字コードを変換するときに使用するコードページ。

LANGラベルの言語と組み合わせて指定する。※4

なし

-codepage

注※1

このラベルで指定するユーザーには，次の権限を付与しておく必要があります。

表2‒109　ユーザーが汎用モジュールにRFC接続するための権限（S_RFC）

権限項目

説明

値

RFC_TYPE

保護されるRFCオブジェクトのタイプ

FUGR（汎用グループ）

RFC_NAME

保護されるRFC名

*

ACTVT

アクティビティ

16（実行）

表2‒110　外部管理インターフェースを使用するための権限（S_XMI_PROD）

権限項目

説明

値

EXTCOMPANY

外部管理ツールの会社名

HITACHI

EXTPRODUCT

外部管理ツールのプログラム名

JP1

INTERFACE

インターフェースID

XAL

また，このラベルで指定するユーザーには，次のタイプのユーザーが使用できます。

ダイアログ（Dialog）

システム（System）

通信（Communication）

サービス（Service）

注※2

PASSWDラベルは，SAPシステム側で従来型のパスワードルールが適用されている場合に指定します。PASSWD2ラベルは，SAPシステム側で拡張パスワードルールが適用されている場合に指定します。PASSWDラベルとPASSWD2ラベルは同時に指定できません。

注※3

接続に利用するユーザーのパスワード，および拡張パスワードは，半角数字（0〜9），半角英字（a〜z，A〜Z），および次の半角記号で定義してください。

! @ $ % & / ( ) = ? ' ` * + ~ # - _ . : { [ ] } < > |

注※4

LANGラベルとCODEPAGEラベルは，次の組み合わせで設定してください。次の組み合わせ以外の言語とコードページを指定した場合，SAPシステムから取得した情報が文字化けする可能性があります。

表2‒111　言語とコードページの指定内容の組み合わせ

接続先

SAPシステム

接続言語

言語

（LANG）

コードページ（CODEPAGE）

Unicode版

日本語

JA

8000

英語

EN

指定する必要はありません。指定する場合は，1100を指定してください。

非Unicode版

日本語

JA

指定する必要はありません。指定する場合は，8000を指定してください。

英語

EN

指定する必要はありません。指定する場合は，1100を指定してください。

LANGラベルの指定を省略した場合，接続先システムで定義されているユーザーの言語が仮定されます。

CODEPAGEラベルの指定を省略した場合，接続先システムのデフォルトコードページが仮定されます。

COMMANDセクション

COMMANDセクションでは，jr3algetコマンドの作業ディレクトリの情報を指定します。

表2‒112　COMMANDセクションに指定できる値

ラベル

意味

指定できる値

デフォルト値

引数

WORKDIR

コマンドの作業ディレクトリ。

1〜255バイトの半角英数字。相対パスを指定した場合，カレントディレクトリからの相対パスとなる。

カレントディレクトリ

−

TRACEセクション

TRACEセクションでは，jr3algetコマンドの実行履歴が保存されるメッセージログおよびデータログの情報を指定します。

表2‒113　TRACEセクションに指定できる値

ラベル

意味

指定できる値

デフォルト値

引数

MSGLOG_LEVEL

アプリケーションのトレース情報を保存するメッセージログの取得レベル。

0：採取しない

1：エラーだけ採取

2：標準

3：詳細

4：デバッグ

0〜4

2

−

MSGLOG_SIZE

メッセージログを取得するファイル容量。

0：2GB（32ビットの符号付き整数で示せる最大値（0x7FFFFFFF））

1〜65535：指定サイズ（単位：キロバイト）内でラップアラウンド

0〜65535

512

−

MSGLOG_DIR

メッセージログファイル（jr3alget.log）の取得先ディレクトリ。

1〜255バイトの半角英数字。ファイル名部分のjr3alget.logまでを含めて255バイト以内で指定する必要がある。相対パスを指定した場合，コマンドの作業ディレクトリからの相対パスとなる。

コマンドの作業ディレクトリ（COMMANDセクションのWORKDIRラベルで変更していないときは，カレントディレクトリ）

−

DATALOG_LEVEL

アプリケーションの各種データ情報を保存するデータログの取得レベル。

0：採取しない

1：エラーだけ採取

2：標準

3：詳細

4：デバッグ

0〜4

2

−

DATALOG_SIZE

データログを取得するファイル容量。

0：2GB（32ビットの符号付き整数で示せる最大値（0x7FFFFFFF））

1〜65535：指定サイズ（単位：キロバイト）内でラップアラウンド

0〜65535

512

−

DATALOG_DIR

データログファイル（jr3alget.dat）の取得先ディレクトリ。

1〜255バイトの半角英数字。ファイル名部分のjr3alget.datまでを含めて255バイト以内で指定する必要がある。相対パスを指定した場合，コマンドの作業ディレクトリからの相対パスとなる。

コマンドの作業ディレクトリ（COMMANDセクションのWORKDIRラベルで変更していないときは，カレントディレクトリ）

−

TARGETセクション

TARGETセクションでは，抽出対象のCCMSアラート情報を特定するための情報を指定します。

表2‒114　TARGETセクションに指定できる値

ラベル

意味

指定できる値

デフォルト値

引数

MONITOR_SET

モニターセット名（詳細は-msオプションを参照）。

1〜60バイトの半角英数字。

SAP CCMS Technical Expert Monitors

-ms

MONITOR

モニター名（詳細は-mnオプションを参照）。

1〜60バイトの半角英数字。

All Monitoring Contexts

-mn

FORMATセクション

FORMATセクションでは，出力されるCCMSアラート情報の出力形式を指定します。

表2‒115　FORMATセクションに指定できる値

ラベル

意味

指定できる値

デフォルト値

引数

COLUMN

出力されるCCMSアラート情報の出力形式。

フィールドID。フィールドIDについては，「jr3alget」（1.　コマンド）の「出力形式および内容」を参照してください。

列1：<ALERTDATE>

列2：<ALERTTIME>

列3：<MTSYSID>

列4：<MTMCNAME>

列5：<OBJECTNAME>

列6：<FIELDNAME>

列7：<VALUE>

列8：<SEVERITY>

列9：<MSG>

−

TIMEZONE

フィールドID<ALERTDATE>，<ALERTTIME>，<STATCHGDAT>，<STATCHGTIM>で指定された時刻情報に関するタイムゾーン指定。

UTC

UTC（世界標準時）で出力する。

LOCAL

コマンドを実行したユーザーのローカルタイムで出力する。

UTC

TIMEZONE

EXTRACTFILEセクション

EXTRACTFILEセクションでは，CCMSアラート情報の出力ファイルの情報を指定します。

表2‒116　EXTRACTFILEセクションに指定できる値

ラベル

意味

指定できる値

デフォルト値

TYPE

CCMSアラート情報を格納するファイルの形式。

WRAP1

CCMSアラート情報が一定の容量に達すると，ラップアラウンドして再び先頭からデータを上書きする形式のファイルです。

WRAP2

NUMラベルで設定した複数のファイルを持つ形式です。1つ目のファイルが一定の容量に達すると，ラップアラウンドして2つ目のファイルに書き込みます。このとき，2つ目のファイルのデータを削除し，先頭からデータを書き込みます。

複数のファイルすべてで一定の容量に達すると，1つ目のファイルに戻ってデータを削除し，先頭からデータを書き込みます。

JP1/IM - Agentの環境を新規で構築する場合は，WRAP2を指定することを推奨します。

運用の開始後，格納ファイルの形式を変更する場合は，事前に格納ファイルを監視している製品を停止し，格納ファイルとその管理ファイル※1を削除してください。

WRAP1またはWRAP2

WRAP1

SIZE

1ファイル当たりの格納ファイル容量。

0：

2GB（32ビットの符号付き整数で示せる最大値（0x7FFFFFFF））

1〜65535：

指定サイズ内でラップアラウンド（キロバイト）。

0〜65535

10240

X2PATH

TYPEラベルでWRAP1を設定している場合

-x2オプションで，格納ファイル出力を指定したときに適用される格納ファイルのパスを指定する。※1※2

TYPEラベルでWRAP2を設定している場合

-x2オプションで，格納ファイル出力を指定したときに適用される格納ファイルを指定する。※3※4

TYPEラベルでWRAP1を設定している場合

1〜251バイトの半角英数字。※4

TYPEラベルでWRAP2を設定している場合

1〜254バイトの半角英数字。※4

−

NUM

WRAP2形式で格納するときのファイル数。

TYPEラベルでWRAP2を設定している場合だけ有効です。

2〜9

5

（凡例）

−：該当なし

注※1

WRAP1形式の場合，格納ファイルと同じディレクトリに，格納ファイル名.ofsという名称で管理ファイルが作成されます。

例：

格納ファイル名としてALERTを指定したとき，ALERTファイルとは別にALERT.ofsファイルが管理ファイルとして作成されます。

格納ファイルを削除する場合は，この管理ファイルも合わせて削除してください。

注※2

デフォルトの格納先から変更した場合，jpcrasコマンドで格納ファイルと管理ファイルを採取することができません。このため，トラブルが発生した場合，手動で格納ファイルと管理ファイルを採取していただく必要があります。

注※3

この値にNUMラベルに指定した範囲（デフォルトは1〜5）の値が付与されたファイル名が格納されます。

注※4

相対パスを指定した場合，コマンドの作業ディレクトリ（COMMANDセクションのWORKDIRラベルに指定したディレクトリ）が相対パスのカレントディレクトリとなります。なお，作業ディレクトリが指定されていない場合，次のディレクトリからの相対パスのカレントディレクトリとなります。

Optionセクション

Optionセクションでは，CCMSアラート情報の抽出の基点を決めるための情報を指定します。ラベルが未設定の場合，デフォルト値を使用します。

なお，リモート監視における収集基点時間の推奨値については，「収集基点時間の注意事項」を参照してください。

表2‒117　Optionセクションに指定できる値

ラベル

意味

指定できる値

デフォルト値

SHIFTEXTRACTTIME※

CCMSアラート情報の抽出の基点を決める収集基点時間（単位：秒）。

収集時刻に対して，CCMSアラート情報の時刻の範囲をずらす時間を指定してください。

0〜600

5

注※

SAPシステムの処理遅延によって，発生時刻通りにCCMSアラート情報が保存されない場合，このラベルの設定値をデフォルトよりも大きな値に変更してください。

収集基点時間の設定例を次に示します。

収集基点時間を10秒とする場合

[Option]
SHIFTEXTRACTTIME=10

収集基点時間の注意事項

収集基点時間を設定する場合は，次の点に注意してください。

環境パラメーター設定ファイルを作成するまたは更新するときにOptionセクションとSHIFTEXTRACTTIMEラベルを追加してください。

リモート監視における収集基点時間の推奨値は，次の考え方に沿って変更してください。

収集基点時間の考え方

SAPシステムの処理遅延によって，発生時刻通りにシステムログ情報/CCMSアラート情報が保存されていない場合があります。この場合，監視対象がローカルホストであったとしても，SAPシステムの時刻遅延（ホスト間の時刻差）が収集基点時間を超えた場合と同様に，システムログ/CCMSアラート情報の抽出漏れが発生します。この問題を回避するために，収集基点時間のデフォルト値は5秒としています。リモートホストを監視対象とする場合には，さらにSAPシステムの時刻遅延の影響が加わるため，前提条件のホスト間の時刻ずれが1秒未満の環境に対して余裕を持たせた値（5秒）を加えた10秒を推奨設定値としています。

jr3algetコマンドの環境パラメーター設定ファイルのサンプルファイル（jr3alget.ini.sample）

形式

[CONNECT]
ASHOST=localhost
SYSNR=00
CLIENT=000
USER=CPIC
PASSWD=ADMIN
;PASSWD2=ADMIN
;LANG=JA
;CODEPAGE=8000

[COMMAND]
WORKDIR=../data/sap/command/jr3alget

[TRACE]
MSGLOG_LEVEL=2
MSGLOG_SIZE=512
MSGLOG_DIR=.
DATALOG_LEVEL=2
DATALOG_SIZE=512
DATALOG_DIR=.

[TARGET]
;MONITOR_SET=SAP CCMS Technical Expert Monitors
;MONITOR=All Monitoring Contexts

[FORMAT]
;COLUMN=<ALERTDATE>
;COLUMN=<ALERTTIME>
;COLUMN=<MTSYSID>
;COLUMN=<MTMCNAME>
;COLUMN=<OBJECTNAME>
;COLUMN=<FIELDNAME>
;COLUMN=<VALUE>
;COLUMN=<SEVERITY>
;COLUMN=<MSG>

[EXTRACTFILE]
TYPE=WRAP2
NUM=5
SIZE=10240
X2PATH=ALERT

ファイル

jr3alget.ini.sample

格納先ディレクトリ

■統合エージェントホスト

Windowsの場合

物理ホストのとき

Windows版のSAPシステム監視のアーカイブファイル※の展開先¥sap_windows¥command¥agtm¥evtrap¥

注※

Agentパス¥options¥sap_windows_VVRRSS.zip

Linuxの場合

物理ホストのとき

Linux版のSAPシステム監視のアーカイブファイル※の展開先/sap_linux/command/agtm/evtrap/

注※

/opt/jp1ima/options/sap_linux_VVRRSS.tar.gz

説明

SAPシステム監視で使用するjr3algetコマンドの入力ファイルです。各種環境パラメーターを事前定義するため，ユーザーが作成する必要があります。ユーザーは，サンプルファイル（jr3alget.ini.sample）をコピーし，コピー先のファイル名を「任意の名前.ini」に変更して使用します。

ファイルの配置先については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「付録A.4(3)統合エージェントホスト（Windows）」および「付録A.4(3)統合エージェントホスト（Linux）」を参照してください。

なお，デフォルト環境パラメーター設定ファイル（-cnfオプションで指定しないときにシステムが検索するファイル）の位置は，コマンド実行時のカレントディレクトリ下のコマンド名.iniとなります。

文字コード

ASCIIコード

改行コード

Windowsの場合：CR+LF

Linuxの場合：LF

定義の反映時期

Script exporterを使用してコマンド実行する場合，Script exporterの再起動時に反映されます。そのほかの方法でコマンド実行する場合，ファイル保存時に反映されます。

記述内容

「jr3algetコマンドの環境パラメーター設定ファイル（jr3alget.ini）」を参照してください。

■COMMANDセクション

WORKDIRラベル

WORKDIRラベルは，コマンドの作業ディレクトリをデフォルトから変更する場合に設定します。ユーザーは，WORKDIRラベルに設定したパスのディレクトリを作成しておく必要があります。

SAPシステムのログ抽出コマンドを使用して，マルチインスタンスのSAPシステムを監視する場合など，環境パラメーター設定ファイルを複数作成する場合には，WORKDIRラベルにそれぞれ異なるパスを設定する必要があります。

Script exporterを使用してSAPのログ抽出コマンドを実行する場合で，次の値を設定したときは，Script exporterのサービス定義ファイルに指定されている作業ディレクトリからの相対パスで，下記ディレクトリに，SAPシステムのログ抽出コマンドのログファイル，SAPシステムのログ抽出コマンドのトレースファイル，RFCライブラリが出力するトレースファイルが出力されます。

../data/sap/command/jr3alget

■EXTRACTFILEセクション

TYPEラベル

スクリプト実行結果監視機能（Fluentd）を使用して出力されたテキストファイルを監視する場合は，出力形式をWRAP2に指定する必要があります。スクリプト実行結果監視機能（JP1/Base）を使用して監視する場合も，WRAP2の指定を推奨します。

ログメトリクス定義ファイル（fluentd_任意の名前_logmetrics.conf）

形式

## Input
<worker ログメトリクス機能で使用するworkerのid>
  <source>
    @type prometheus
    bind バインド番号
    port リッスンポート番号
    metrics_path メトリクスパス
  </source>
</worker>

<worker workerのid>
  <source>
    @type tail
    path ログメトリクス機能の監視対象ログファイルの絶対パス
    tag 任意のタグの値
    pos_file ../data/fluentd/tail/任意のタグの値.pos
[
    <parse>
      @type 正規表現タイプ
      expression ログメッセージの正規表現
      time_key expressionで設定した時間の変数名
      time_format time_keyのフォーマット
      types expression内で設定した変数名:型
    </parse>
]
  </source>

## Output
  <match このmatchの適用対象とするtag>
    @type prometheus
    <metric>
      name 任意のログメトリクス名
      type ログメトリクスタイプ
      desc ログメトリクスの説明
      key ログからログメトリクスへの変換対象を判定するkey
      buckets histogramのbucket
      <labels>
      ラベルのキー ラベルの値
      </labels>
    </metric>
  </match>
</worker>

ファイル

fluentd_任意の名前_logmetrics.conf

任意の名前には，半角英数字，ハイフン，アンダースコアが使用できます。指定できる文字数は1〜30文字です。

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Agentパス¥jp1ima¥conf¥user¥

論理ホストのとき

共有フォルダ¥jp1ima¥conf¥user¥

Linuxの場合

物理ホストのとき

/opt/jp1ima/conf/user/

論理ホストのとき

共有ディレクトリ/jp1ima/conf/user/

説明

監視対象のアプリケーションが出力するログを読み込み，ログメトリクスに変換するためのFluentdのメトリック定義ファイルです。ログメトリクス機能を使用する場合，このファイルを作成して配置します。

また，このファイルを読み込むためには，ログ監視対象定義ファイル（jpc_fluentd_common_list.conf）に「include」の設定を追加して，このファイルの名称を指定します。

文字コード

UTF-8（BOM無し）

改行コード

Windowsの場合：CR+LF

Linuxの場合：LF

定義の反映時期

Fluentdのサービスを再起動したときに，Fluentdの動作に反映します。

記述内容

・インプットプラグイン機能の定義

インプットプラグイン機能については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「3.15.2(1)インプットプラグイン機能」を参照してください。

■Prometheusのスクレイプで利用する設定

「形式」に示す「## Input」の1つ目の<source>で設定します。

@typeにはprometheusを指定します。

バインド番号（オプション）

Prometheusがこのプラグインのメトリクスをスクレイプする際にバインドするインターフェースを指定します。この項目が存在しない場合，デフォルトは「0.0.0.0」です。

リッスンポート番号（必須）

Prometheusがこのプラグインのメトリクスをスクレイプする際に利用するリッスンポート番号「24820」を指定します。リッスンポート番号を変更したい場合は，別の値を指定します。

メトリクスパス（オプション）

Prometheusがこのプラグインのメトリクスをスクレイプする際に利用するHTTPエンドポイントを指定します。この項目が存在しない場合，デフォルトは「/metrics」です。

指定できる文字数は1〜255文字です（先頭の「/」を含めない文字数）。

ログメトリクス機能で使用するworkerのid（必須）

「■ログメトリクス機能の監視対象ログファイルの設定」で利用するworkerのworkerのidを指定します。

1つのworkerを指定する場合は<worker workerのid>とし，複数のworkerをまとめて範囲指定する場合は，<worker workerのid（最小の値）-workerのid（最大の値）>のように指定します。

■ログメトリクス機能の監視対象ログファイルの設定

「形式」に示す「## Input」の2つ目の<source>で設定します。

最初の@typeにはtail，<parse>の@typeにはログ監視機能のサポート範囲（regexp，syslog，csv，tsv，ltsv，multiline，noneのどれか）を指定します。

tailおよび<parse>の設定については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」で，「3.15.3 JP1/IM - Agentによるログ監視機能」の「3.15.3(2)インプットプラグイン機能（Input Plugins）」を参照してください。

任意のタグの値（必須）

ドット「.」で区切られた文字列（例：myapp.access）を指定します。

使用できる文字は，小文字のアルファベット，数字，アンダースコアが使用できます。指定できる文字数は1〜30文字です。

正規表現タイプ（必須）

ログメトリクス機能の対象となるログファイルに関して，Fluentdに読み込む際のフォーマットを指定します。指定できるタイプを次に示します。

regexp

syslog

csv

tsv

ltsv

multiline

none

ログメッセージの正規表現（必須またはオプション）

「正規表現タイプ」に「regexp」を指定した場合だけ，この設定項目を記述します。ここでは，ログメトリクス機能の対象として読み込みたいログメッセージの正規表現を指定します。正規表現の仕様は，Rubyの正規表現に準じます。

expression内で設定した変数名（オプション）

「ログメッセージの正規表現」で抽出した数値データに関して，型を指定するために利用する変数名を指定します。

型（オプション）

「expression内で設定した変数名」で指定した変数名の型を指定します。指定できる型を，次に示します。

integer

float

workerのid（必須）

「■Prometheusのスクレイプで利用する設定」で指定したログメトリクス機能で使用するworkerのidの中から，この<source>セクションにおいて，ログファイルの監視に利用するworkerのidを指定します。

・アウトプットプラグイン機能の定義

アウトプットプラグイン機能については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「3.15.2(2)アウトプットプラグイン機能」を参照してください。

「形式」に示す「## Output」で設定します。

<match このmatchの適用対象とするtag>〜</match>（オプション）

matchセクションでは，tagを指定すると，指定したtagが付与されたfluentdイベントに対してだけ，matchを適用できます。tagを指定しなかった場合は，すべてのfluentdイベントがmatchの適用対象となります。

半角英数字，ハイフン，アンダースコアが使用できます。指定できる文字数は1〜30文字です。

<metric>〜</metric>

metricセクションでは，ログメトリクスの具体的な設定を行います。1つのmatchセクションに対して，複数のmetricセクションが定義可能です。

任意のログメトリクス名（必須）

Prometheusのメトリクスデータ名を指定します。

正規表現[a-zA-Z_:][a-zA-Z0-9_:]*に一致する必要があります。指定できる文字数は1〜255文字です。

ログメトリクスタイプ（必須）

ログメトリクスのPrometheusでのメトリクスタイプ（counterまたはgauge）を指定します。

counter

単調に増加する値を持つメトリクスを表します。処理された要求の数，完了したタスク，エラーの数などを表すのに適しています。

Fluentdの再起動時にだけ，累積した値をリセットできます。

定義内のkeyが空の場合は，レコードの内容に関係なく，レコードの数だけ，メトリクスの値が1ずつ増加します。

値が減少する可能性のあるメトリクスの場合はgaugeを指定してください。

gauge

任意に上下できる値を持つメトリクスを表します。温度，現在のメモリ使用量，同時リクエスト数などを表すのに適しています。

ログメトリクスの説明（必須）

ユーザー独自のメトリック定義のdescriptionで指定したログメトリクスの説明を記入します。

半角英数字，ハイフン，アンダースコアが使用できます。指定できる文字数は1〜255文字です。

ログからログメトリクスへの変換対象を判定するkey（必須またはオプション）

ログメトリクスに変換する対象を判定するkeyを指定します。ログメトリクスタイプがcounterの場合はオプション，gaugeの場合は必須で指定します。

指定できる文字数は1〜255文字です。

ラベルのキー（オプション）

Prometheusのメトリクスデータに付与するラベルのkeyを指定できます。

正規表現[a-zA-Z_:][a-zA-Z0-9_:]*に一致する必要があります。「__」で始めることはできません。指定できる文字数は1〜255文字です。

ラベルの値（オプション）

ラベルのkeyに対する値を指定できます。

制御文字以外の任意のUnicode文字を指定できます。指定できる文字数は1〜255文字です。

文字列を指定した場合は，その文字列がそのままラベルの値となります。

ラベルのキーまたはラベルの値のどちらかが欠けている場合は，そのラベルは表示されません。

<labels>〜</labels>で示されるlabelsセクションは，metricセクションの内部または外部でそれぞれ定義できます。また，ラベル（ラベルのキーとラベルの値の1組）は複数設定できます。ラベルの詳細については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「3.15.2 JP1/IM - Agentによるログメトリクス機能」の「3.15.2(3)(b)prometheus outputプラグイン」で，「ラベル」を説明している個所，および，「上位のラベルセクションとメトリクスセクション内のラベルセクション」を説明している個所を参照してください。

定義例

## Input
<source>
  @type prometheus
  bind '0.0.0.0'
  port 20723
  metrics_path /metrics
</source>

##対象ログメッセージ1の抽出
<source>
  @type tail
  @id logmetrics_counter
  path /usr/lib/WebAppA/ControllerLog/ControllerLog.log
  tag WebAppA.Controller
  pos_file /posfile/WebAppA/ControllerLog.log.pos
  <parse>
    @type regexp
    expression /^(?<logtime>[^¥[]*) ¥[(?<loglebel>[^¥]]*)¥] (?<class>[^¥[]*) : endpoint "¥/register" started. Target record: (?<record_num>¥d[^¥[]*).$/
    time_key logtime
    time_format %Y-%m-%d %H:%M:%S
    types record_num:integer
  </parse>
</source>

##対象ログメッセージ2の抽出
<source>
  @type tail
  @id logmeetrics_gauge
  path /usr/lib/WebAppA/GeneralLog/GeneralLog.log
  tag WebAppA.GeneralLog
  pos_file /posfile/WebAppA/GeneralLog.log.pos
  <parse>
    @type regexp
    expression /^(?<logtime>[^¥[]*) ¥[(?<Status>[^¥]]*)¥] CPU Usage is (?<cpuvalue>¥d[^%]*)%.$/
    time_key logtime
    time_format %Y-%m-%d %H:%M:%S
    types cpuvalue:float
  </parse>
</source>

## Output
##ログメトリクス1とログメトリクス2の定義
<match WebAppA.ControllerLog>
  @type prometheus
  <metric>
    name logmetrics_request_endpoint_register
    type counter
    desc The request number of endpoint register
  </metric>
  <metric>
    name logmetrics_num_of_registeredrecord
    type counter
    desc The number of registered record
    key record_num
    <labels>
    loggroup ${tag_parts[0]}
    log ${tag_parts[1]}
    </labels>
  </metric>
</match>

##ログメトリクス3の定義
<match WebAppA.GeneralLog>
  @type prometheus
  <metric>
    name logmetrics_cpu_usage
    type gauge
    desc the CPU Usage of WebAppA.
    key cpuvalue
    <labels>
    loggroup ${tag_parts[0]}
    log ${tag_parts[1]}
    </labels>
  </metric>
</match>

プロパティ表示文字列定義ファイル（property_labels.conf）

形式

{
  "置き換え前の文字列":"置き換え後の文字列",
    ・・・
  },
}

ファイル

property_labels.conf

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Managerパス¥conf¥imdd¥plugin¥jp1pccs_azure¥

論理ホストのとき

共有フォルダ¥jp1imm¥conf¥imdd¥plugin¥jp1pccs_azure¥

Linuxの場合

物理ホストのとき

/etc/opt/jp1imm/conf/imdd/plugin/jp1pccs_azure/

論理ホストのとき

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

説明

任意のIM管理ノードのプロパティの値を，別の値に置き換える設定を行うファイルです。Azure監視でテナントIDをテナント名に置き換える場合などに設定します。JP1イベントの拡張属性値にも適用されます。各監視機能のセットアップの説明個所で，該当する記載がある場合は，このファイルを使用して値の置き換えができます。

文字コード

UTF-8（BOM無し）

改行コード

Windowsの場合：CR+LF

Linuxの場合：LF

定義の反映時期

jddcreatetreeコマンドおよびjddupdatetreeコマンドを実行したとき，統合オペレーション・ビューアーのツリーの表示内容に反映されます。または，Promitorのパフォーマンスデータを監視するアラートによりJP1イベントが発行されたときに反映されます。

記述内容

置き換え前の文字列

置き換え対象としたいプロパティの値を，1〜255文字の制御文字以外の文字で指定します。

記載する内容の例：サブスクリプションID

置き換え後の文字列

置き換えたい値を，1〜255文字の制御文字以外の文字で指定します。

記載する内容の例：サブスクリプション名

imbase共通設定ファイル（jpc_imbasecommon.json）

形式

{
    "tls_config": {
        "cert_file": "サーバ証明書ファイルパス",
        "key_file": "サーバ証明書キーファイルパス",
        "min_version": "最小TLSプロトコルバージョン"
    }
    "http": {
        "max_content_length": 最大リクエストボディーサイズ,
        "client_timeout": クライアントタイムアウト
    }
}

ファイル

jpc_imbasecommon.json

jpc_imbasecommon.json.model（モデルファイル）

格納先ディレクトリ

■統合マネージャーホスト

Windowsの場合

Managerパス¥conf¥imdd¥imagent¥

Linuxの場合

/etc/opt/jp1imm/conf/imdd/imagent/

説明

統合エージェント管理基盤の共通動作を規定する設定ファイルです。

文字コード

UTF-8（BOM無し）

改行コード

Windowsの場合：CR+LF

Linuxの場合：LF

定義の反映時期

imbaseとimbaseproxyのサービスを再起動したときに反映します。

記述内容

メンバー名

省略可否

型

設定する値

tls_config

可

object

TLSサーバ設定

省略した場合は，クライアントとの通信は平文で行います。

初期値は，メンバー名を「//tls_config」としていて省略扱いになります。

TLSサーバ設定を有効にする場合，メンバー名を「tls_config」に変更してください。

cert_file

不可

string

サーバ証明書ファイルパス

下記ディレクトリ以下のファイルパスをフルパスで指定します。

Windowsの場合

Managerパス¥conf¥imdd¥imagent¥cert¥

Liunxの場合

/etc/opt/jp1imm/conf/imdd/imagent/cert/

詳細については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「付録A.4 JP1/IM - Agent」で，統合マネージャホストのJP1/IM - Agentでユーザーが参照・編集できるファイルおよびディレクトリの説明を参照してください。

key_file

不可

string

サーバ証明書キーファイルパス

下記ディレクトリ以下のファイルパスをフルパスで指定します。

Windowsの場合

Managerパス¥conf¥imdd¥imagent¥secret¥

Liunxの場合

/etc/opt/jp1imm/conf/imdd/imagent/secret/

詳細については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「付録A.4 JP1/IM - Agent」で，統合マネージャホストのJP1/IM - Agentでユーザーが参照・編集できるファイルおよびディレクトリの説明を参照してください。

min_version

可

string

TLSネゴシエーション（ハンドシェイク）時に使用する最小TLSプロトコルバージョン

次のどちらかを指定します。

TLSv1_2：TLS1.2以上

TLSv1_3：TLS1.3

省略した場合，または指定できない文字列値を指定した場合はTLSv1_2が仮定されます。

http

可

object

http設定

省略した場合は，下位項目にデフォルト値を適用します。

max_content_length

可

number

REST APIのリクエストボディーの最大サイズ

1〜10（単位：MB）の範囲で指定します。

省略した場合，または指定できない数値を指定した場合は10が仮定されます。

client_timeout

可

number

REST APIを呼び出したときのタイムアウト時間

1〜600（単位：秒）の範囲で指定します。

省略した場合，または指定できない数値を指定した場合は30が仮定されます。

注意事項

物理ホスト環境で，このファイルにアクセスできない場合は，全項目が省略されたときのデフォルト値を適用します。

論理ホスト環境で，このファイルにアクセスできない場合は，imbaseやimbaseproxyを異常停止します。

JSON形式の指定が不正な場合，または型と不一致な指定がある場合は，imbaseやimbaseproxyを異常停止します。

imbase設定ファイル（jpc_imbase.json）

形式

{
  "port": リッスンポート,
  "file_operation_timeout":"ファイル操作処理のタイムアウト時間"
  "log": {
    "message": {
      "num": ログ面数
      "size": 最大ファイルサイズ
    },
    "internal": {
      "level": "ログレベル"
      "num": ログ面数
      "size": 最大ファイルサイズ
    },
    "access": {
      "num": ログ面数
      "size": 最大ファイルサイズ
    }
  },
  "action": {
    "startup_action_check_timeout": 統合エージェント管理基盤が起動した時に実行中のままになっているアクションを終了状態に遷移させるタイムアウト時間
  }
}

ファイル

jpc_imbase.json

jpc_imbase.json.model（モデルファイル）

格納先ディレクトリ

■統合マネージャーホスト

Windowsの場合

Managerパス¥conf¥imdd¥imagent¥

Linuxの場合

/etc/opt/jp1imm/conf/imdd/imagent/

説明

統合エージェント管理基盤のimbaseプロセスの動作を規定する設定ファイルです。

文字コード

UTF-8（BOM無し）

改行コード

Windowsの場合：CR+LF

Linuxの場合：LF

定義の反映時期

imbaseのサービスを再起動したときに，imbaseの動作に反映します。

記述内容

メンバー名

省略可否

型

設定する値

port

可

number

統合エージェント管理基盤（imbase）のリッスンポート

5001〜65535の範囲で指定します。

省略した場合，または指定できない数値を指定した場合は20724が仮定されます。

file_operation_timeout

可

number

ファイル操作機能で処理を打ち切る時間

1〜60（単位：分）の範囲で指定します。デフォルトは3です。

省略した場合，または指定できない数値を指定した場合，デフォルトの値が仮定されます。

log

可

object

ログ設定

省略した場合は，下位項目にデフォルト値を適用します。

message

可

object

公開ログ

マニュアル「JP1/Integrated Management 3 - Manager運用ガイド」の「12.2.1(6)JP1/IM - Agent（統合エージェント管理基盤）のログ」の「(a)公開ログ」を参照してください。

省略した場合は，下位項目にデフォルト値を適用します。

num

可

number

ファイル面数

2〜99の範囲で指定します。

省略した場合，または指定できない数値を指定した場合，8が仮定されます。

size

可

number

最大ファイルサイズ

1〜100（単位：MB）の範囲で指定します。

省略した場合，または指定できない数値を指定した場合は10が仮定されます。

internal

可

object

内部ログ

参照する必要のないログです。

省略した場合は，下位項目にデフォルト値を適用します。

level

可

string

ログレベル※

次のどれかを指定します。

trace：debugログと関数トレース

debug：infoログとデバッグログ

info：warnのログと情報ログ

warn：errorのログと警告ログ

error：エラーログ

省略した場合，または指定できない文字列値を指定した場合，infoが仮定されます。

num

可

number

ファイル面数

2〜99の範囲で指定します。

省略した場合，または指定できない数値を指定した場合，8が仮定されます。

size

可

number

最大ファイルサイズ

1〜100（単位：MB）の範囲で指定します。

省略した場合，または指定できない数値を指定した場合は10が仮定されます。

access

可

object

アクセスログ

参照する必要のないログです。

省略した場合は，下位項目にデフォルト値を適用します。

num

可

number

ファイル面数

2〜99の範囲で指定します。

省略した場合，または指定できない数値を指定した場合，8が仮定されます。

size

可

number

最大ファイルサイズ

1〜100（単位：MB）の範囲で指定します。

省略した場合，または指定できない数値を指定した場合は10が仮定されます。

action

可

object

統合エージェントアクション実行機能の設定

省略した場合は，下位項目にデフォルト値を適用します。

startup_action_check_timeout

可

number

統合エージェント管理基盤を起動してからこのメンバーに指定したタイムアウト時間を経過すると，統合エージェント管理基盤が起動したときに実行中のままになっているアクションに関して，アクションの動作を確認できない場合，アクションを終了状態に遷移させます。

120〜3600（単位：秒）の範囲で指定します。デフォルトは120です。

省略した場合，または指定できない数値を指定した場合，デフォルトの値が仮定されます。

注意事項

物理ホスト環境で，このファイルにアクセスできない場合は，全項目が省略されたときのデフォルト値を適用します。

論理ホスト環境で，このファイルにアクセスできない場合は，imbaseやimbaseproxyを異常停止します。

JSON形式の指定が不正な場合，または型と不一致な指定がある場合は，imbaseやimbaseproxyを異常停止します。

注※

ログレベルの応じて出力するログの種類を，次に示します。

出力ログ

ログレベル

trace

debug

info

warn

error

関数トレース

○

−

−

−

−

デバッグ情報

○

○

−

−

−

情報

○

○

○

−

−

警告

○

○

○

○

−

エラー

○

○

○

○

○

導入ライブラリの出力メッセージなどで分類ができないもの

○

○

○

○

○

（凡例）

○：出力する　−：出力しない

imbaseproxy設定ファイル（jpc_imbaseproxy.json）

形式

{
  "port": リッスンポート,
  "log": {
    "message": {
      "num": ログ面数
      "size": 最大ファイルサイズ
    },
    "internal": {
      "level": "ログレベル"
      "num": ログ面数
      "size": 最大ファイルサイズ
    },
    "access": {
      "num": ログ面数
      "size": 最大ファイルサイズ
    }
  }
}

ファイル

jpc_imbaseproxy.json

jpc_imbaseproxy.json.model（モデルファイル）

格納先ディレクトリ

■統合マネージャーホスト

Windowsの場合

Managerパス¥conf¥imdd¥imagent¥

Linuxの場合

/etc/opt/jp1imm/conf/imdd/imagent/

説明

統合エージェント管理基盤のimbaseproxyプロセスの動作を規定する設定ファイルです。

文字コード

UTF-8（BOM無し）

改行コード

Windowsの場合：CR+LF

Linuxの場合：LF

定義の反映時期

imbaseproxyのサービスを再起動したときに反映します。

記述内容

メンバー名

省略可否

型

設定する値

port

可

number

統合エージェント管理基盤（imbaseproxy）のリッスンポート

5001〜65535の範囲で指定します。

省略した場合，または指定できない数値を指定した場合は20725が仮定されます。

log

可

object

ログ設定

マニュアル「JP1/Integrated Management 3 - Manager運用ガイド」の「12.2.1(6)JP1/IM - Agent（統合エージェント管理基盤）のログ」の「(a)公開ログ」を参照してください。

設定項目については，「imbase設定ファイル（jpc_imbase.json）」のlogの説明を参照してください。

注意事項

物理ホスト環境で，このファイルにアクセスできない場合は，全項目が省略されたときのデフォルト値を適用します。

論理ホスト環境で，このファイルにアクセスできない場合は，imbaseやimbaseproxyを異常停止します。

JSON形式の指定が不正な場合，または型と不一致な指定がある場合は，imbaseやimbaseproxyを異常停止します。

imagent共通設定ファイル（jpc_imagentcommon.json）

形式

{
  "JP1_BIND_ADDR": バインド方式,
  "COM_LISTEN_ALL_ADDR": 複数のIPアドレスでサービスを待ち受けるかどうか,
  "COM_MAX_LISTEN_NUM": サービスが待ち受けるIPアドレスの個数,
  "JP1_CLIENT_BIND_ADDR": バインド方式,
  "http": {
    "max_content_length": 最大リクエストボディーサイズ,
    "client_timeout": クライアントタイムアウト
  },
  "immgr": {
    "host": "マネージャーホスト名",
    "proxy_url": "HTTPプロキシサーバURL",
    "proxy_user": "HTTPプロキシサーバ認証ユーザー名",
    "tls_config": {
      "ca_file": "CA証明書ファイルパス",
      "insecure_skip_verify": サーバ証明書検証スキップ,
      "min_version": "最小TLSプロトコルバージョン"
    },
    "imbase": {
      "port": 統合エージェント管理基盤（imbase）の接続ポート
    },
    "imbaseproxy": {
      "port": 統合エージェント管理基盤（imbaseproxy）の接続ポート
    }
  }
}

ファイル

jpc_imagentcommon.json

jpc_imagentcommon.json.model（モデルファイル）

格納先ディレクトリ

■統合エージェントホスト

Windowsの場合

物理ホストのとき

Agentパス¥conf¥

論理ホストのとき

共有フォルダ¥jp1ima¥conf¥

Linuxの場合

物理ホストのとき

/opt/jp1ima/conf/

論理ホストのとき

共有ディレクトリ/jp1ima/conf/

■統合エージェントホスト

Windowsの場合

物理ホストのとき

Agentパス¥conf¥

論理ホストのとき

共有フォルダ¥jp1ima¥conf¥

Linuxの場合

物理ホストのとき

/opt/jp1ima/conf/

論理ホストのとき

共有ディレクトリ/jp1ima/conf/

説明

統合エージェント制御基盤の共通動作を規定する設定ファイルです。

文字コード

UTF-8（BOM無し）

改行コード

Windowsの場合：CR+LF

Linuxの場合：LF

定義の反映時期

imagentサービス，imagentactionサービス，およびimagentproxyサービスを再起動したときに反映します。

記述内容

メンバー名

省略可否

型

設定する値

JP1_BIND_ADDR

可

string

サーバのバインド方式

次のどちらかを指定できます。

ANY：バインドしない（すべてのIPアドレスを受け付ける）

IP：ホスト名の名前解決で取得したIPアドレスに対してバインドする

COM_LISTEN_ALL_ADDRとCOM_MAX_LISTEN_NUMを指定することで複数のIPアドレスに対して受け付けることができます。

省略した場合，または指定できない文字列値を指定した場合はANYが仮定されます。

COM_LISTEN_ALL_ADDR

可

number

複数のIPアドレスでサービスが待ち受けるかどうか

0：最優先のIPアドレスでバインド

1：複数のIPアドレスでバインド

省略した場合，または指定できない数値を指定した場合は0が仮定されます。

COM_MAX_LISTEN_NUM

可

number

サービスが待ち受けるIPアドレスの個数

COM_LISTEN_ALL_ADDRに「1」を指定した場合に，サービスが待ち受けるIPアドレスの個数を1〜16の範囲で指定します。

省略した場合，または指定できない数値を指定した場合は4が仮定されます。

JP1_CLIENT_BIND_ADDR

可

string

リクエスト送信時の送信元IPアドレスのバインド方式

次のどちらかを指定できます。

ANY：すべてのIPアドレスでバインド

IP：ホスト名の名前解決で取得したIPアドレスでバインド

省略した場合，または指定できない文字列値を指定した場合はANYが仮定されます。

http

可

object

「imbase設定ファイル（jpc_imbase.json）」のhttpの説明を参照してください。

immgr

不可

object

JP1/IMのマネージャーホストへの接続設定

host

不可

string

マネージャーホスト名

proxy_url

可

string

HTTPプロキシサーバのURL

次の形式で指定します。

http://ホスト名またはIPv4アドレス:ポート番号（1024〜65535の範囲）

省略した場合，または指定できない文字列値を指定した場合はHTTPプロキシサーバを使用しません。

proxy_user

可

string

HTTPプロキシのHTTP認証で使用するユーザー名

制御コード（スペース・タブを除く）と「:」を含まないASCII文字を指定できます。

文字種のチェックは行われません。

省略した場合，または指定できない文字列値を指定した場合はHTTPプロキシサーバに対して認証情報を送信しません。

tls_config

可

object

TLSクライアント設定

省略した場合はimbaseやimbaseproxyとの通信を暗号化しません。

初期値は，メンバー名を「//tls_config」としていて省略扱いになります。

TLSクライアント設定を有効にする場合，メンバー名を「tls_config」に変更してください。

ca_file

可

string

imbaseやimbaseproxyのサーバ証明書を発行した認証局のCA証明書ファイル

サーバ証明書の検証に使用するCA証明書を指定します。

ファイルは下記ディレクトリ以下のファイルパスをフルパスで指定します。

■非クラスタ構成の場合

Windowsのとき

Agentパス¥conf¥user¥cert¥

Linuxのとき

/opt/jp1ima/conf/user/cert/

■クラスタ構成の場合

Windowsのとき

共有フォルダ¥jp1ima¥conf¥user¥cert¥

Linuxのとき

共有ディレクトリ/jp1ima/conf/user/cert/

詳細については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「付録A.4 JP1/IM - Agent」で，統合エージェントホストのJP1/IM - Agentでユーザーが参照・編集できるファイルおよびディレクトリの説明を参照してください。

insecure_skip_verify

可

boolean

imbaseやimbaseproxyのサーバ証明書を検証しない場合はtrue，検証する場合はfalseを指定します。

省略時はfalseが仮定されます。

min_version

可

string

「imbase設定ファイル（jpc_imbase.json）」のmin_versionの説明を参照してください。

imbase

不可

object

接続先imbaseの設定

port

不可

number

統合エージェント管理基盤（imbase）のリッスンポート

5001〜65535の範囲で指定します。

省略した場合，または指定できない数値を指定した場合は20724が仮定されます。

imbaseproxy

不可

object

接続先imbaseproxyの設定

port

不可

number

統合エージェント管理基盤（imbaseproxy）のリッスンポート

5001〜65535の範囲で指定します。

省略した場合，または指定できない数値を指定した場合は20725が仮定されます。

注意事項

このファイルにアクセスできない場合は，imagentproxyを異常停止します。

JSON形式の指定が不正な場合，または型と不一致な指定がある場合は，サービスを異常停止します。

imagent設定ファイル（jpc_imagent.json）

形式

{
  "port": リッスンポート,
  "log": {
    "message": {
      "num": ログ面数
      "size": 最大ファイルサイズ
    },
    "internal": {
      "level": "ログレベル"
      "num": ログ面数
      "size": 最大ファイルサイズ
    },
    "access": {
      "num": ログ面数
      "size": 最大ファイルサイズ
    }
  },
  "action": {
    "auto_action_concurrency": "対処アクションの自動実行の同時実行可否",
    "max_concurrent_response_actions": アクション最大同時実行数1,
    "max_concurrent_file_operation_actions": アクション最大同時実行数2,
    "auto_action_execution_result_limit": コマンド実行結果の上限1,
    "manual_action_execution_result_limit": コマンド実行結果の上限2,
    "username": "ユーザー名",
    "domainname": "ドメイン名",
    "shell": "シェルコマンド"
    "service_startup_wait_time": サービス起動待機時間
  }
}

ファイル

jpc_imagent.json

jpc_imagent.json.model（モデルファイル）

格納先ディレクトリ

■統合エージェントホスト

Windowsの場合

物理ホストのとき

Agentパス¥conf¥

論理ホストのとき

共有フォルダ¥jp1ima¥conf¥

Linuxの場合

物理ホストのとき

/opt/jp1ima/conf/

論理ホストのとき

共有ディレクトリ/jp1ima/conf/

説明

統合エージェント制御基盤のimagentの動作を規定する設定ファイルです。

文字コード

UTF-8（BOM無し）

改行コード

Windowsの場合：CR+LF

Linuxの場合：LF

定義の反映時期

imagentサービスおよびimagentactionサービスを再起動したときに反映します。

記述内容

メンバー名

省略可否

型

設定する値

port

可

number

統合エージェント制御基盤（imagent）へのアクセスを受け付けるためのポート

5001〜65535の範囲で指定します。

省略時は20726が仮定されます。

log

可

object

ログ設定

マニュアル「JP1/Integrated Management 3 - Manager運用ガイド」の「12.2.2(7)統合エージェント制御基盤のログ」の「(a)公開ログ」を参照してください。

設定項目については，「imbase設定ファイル（jpc_imbase.json）」のlogの説明を参照してください。

action

可

object

統合エージェントアクション実行機能の設定

省略した場合は，下位項目にデフォルト値を適用します。

auto_action_concurrency

可

string

JP1/IM - Managerの対処アクションの自動実行機能から実行されたアクションの同時実行可否（デフォルト：no）を指定します。

次のどちらかを指定できます。

yes：同時実行可

no：同時実行不可

このメンバーを省略した場合，デフォルトの値が仮定されます。

詳細については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「3.15.7(3)(a) 対処アクションの自動実行機能」を参照してください。

max_concurrent_response_actions

可

number

JP1/IM - Managerの対処アクションの自動実行機能または手動実行機能から実行されたアクションのアクション最大同時実行数を1〜48（デフォルト：10）の範囲で指定します。

このメンバーを省略した場合，デフォルトの値が仮定されます。

max_concurrent_response_actionsとmax_concurrent_file_operation_actionsの総和が48を超える場合はエラーとなります。

詳細については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「3.15.7(3)(e) アクション最大同時実行数」を参照してください。

max_concurrent_file_operation_actions

可

number

JP1/IM - Managerの定義ファイル操作機能から実行されたアクションのアクション最大同時実行数を2〜48（デフォルト：5）の範囲で指定します。

このメンバーを省略した場合，デフォルトの値が仮定されます。

max_concurrent_deal_actionsとmax_concurrent_file_operation_actionsの総和が48を超える場合はエラーとなります。

詳細については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「3.15.7(3)(e) アクション最大同時実行数」を参照してください。

auto_action_execution_result_limit

可

number

JP1/IM - Managerの対処アクションの自動実行機能から実行されたコマンドのコマンド実行結果（コマンドの標準出力または標準エラー出力）の上限を0〜196,600行（デフォルト：1000行）の範囲で指定します。

このメンバーを省略した場合，デフォルトの値が仮定されます。

詳細については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「3.15.7(1)(e)コマンド実行機能」を参照してください。

manual_action_execution_result_limit

可

number

JP1/IM - Managerの対処アクションの手動実行機能から実行されたコマンドのコマンド実行結果（コマンドの標準出力または標準エラー出力）の上限を0〜196,600行（デフォルト：1000行）で指定します。

このメンバーを省略した場合，デフォルトの値が仮定されます。

詳細ついては，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「3.15.7(1)(e)コマンド実行機能」を参照してください。

username

可

string

アクション実行でコマンドを実行するときの実行ユーザー

20バイトまでで指定します。

省略した場合は"jp1imaction"で動作します。

マルチバイト文字のユーザー名は指定できません。

ログイン可能でホームディレクトリが存在するユーザーを指定する必要があります。

Windowsの場合，次の注意事項があります。

ローカルセキュリティポリシーの［ローカル ログオンの許可］の権限を持つユーザーである必要があります。

WindowsのLogonUser関数でユーザーのトークンが取得できる必要があります。

jimasecretコマンドでパスワードを設定する必要があります。

domainname

可

string

usernameに指定したユーザーが所属するドメイン

Windowsの場合のみ有効です。

255バイトまでで指定します。

省略した場合は"."で動作します。

マルチバイト文字のドメイン名は指定できません。

usernameに指定したユーザーがローカルユーザーの場合は"."を指定してください。

shell

可

string

アクション実行でコマンドを実行するためのシェル

アクション実行では，このオプションに指定したシェルに-cオプションを付けて指定したコマンドを実行します。

省略した場合は"/bin/sh"で動作します。

service_startup_wait_time

可

number

定義ファイルの更新処理におけるサービス起動待機時間

定義ファイルの反映処理が正しく行われたかを確認するための待機時間を，5〜120（秒）の範囲で指定します。

省略した場合は15（秒）で動作します。

注意事項

このファイルにアクセスできない場合は，imagentproxyを異常停止します。

JSON形式の指定が不正な場合，または型と不一致な指定がある場合は，サービスを異常停止します。

imagentproxy設定ファイル（jpc_imagentproxy.json）

形式

{
  "port": リッスンポート,
  "log": {
    "message": {
      "num": ログ面数
      "size": 最大ファイルサイズ
    },
    "internal": {
      "level": "ログレベル"
      "num": ログ面数
      "size": 最大ファイルサイズ
    },
    "access": {
      "num": ログ面数
      "size": 最大ファイルサイズ
    }
  }
}

ファイル

jpc_imagentproxy.json

jpc_imagentproxy.json.model（モデルファイル）

格納先ディレクトリ

■統合エージェントホスト

Windowsの場合

物理ホストのとき

Agentパス¥conf¥

論理ホストのとき

共有フォルダ¥jp1ima¥conf¥

Linuxの場合

物理ホストのとき

/opt/jp1ima/conf/

論理ホストのとき

共有ディレクトリ/jp1ima/conf/

説明

統合エージェント制御基盤のimagentproxyの動作を規定する設定ファイルです。

文字コード

UTF-8（BOM無し）

改行コード

Windowsの場合：CR+LF

Linuxの場合：LF

定義の反映時期

imagentproxyサービスを再起動したときに反映します。

記述内容

メンバー名

省略可否

型

設定する値

port

可

number

統合エージェント制御基盤（imagentproxy）へのアクセスを受け付けるためのポート

5001〜65535の範囲で指定します。

省略時は20727が仮定されます。

log

可

object

ログ設定

マニュアル「JP1/Integrated Management 3 - Manager運用ガイド」の「12.2.2(7)統合エージェント制御基盤のログ」の「(a)公開ログ」を参照してください。

設定項目については，「imbase設定ファイル（jpc_imbase.json）」のlogの説明を参照してください。

注意事項

このファイルにアクセスできない場合は，imagentproxyを異常停止します。

JSON形式の指定が不正な場合，または型と不一致な指定がある場合は，サービスを異常停止します。

imagentaction設定ファイル（jpc_imagentaction.json）

形式

  "port": リッスンポート,
  "log": {
    "message": {
      "num": ログ面数
      "size": 最大ファイルサイズ
    },
    "internal": {
      "level": "ログレベル"
      "num": ログ面数
      "size": 最大ファイルサイズ
    },
    "access": {
      "num": ログ面数
      "size": 最大ファイルサイズ
    }
  }
}

ファイル

jpc_imagentaction.json

jpc_imagentaction.json.model（モデルファイル）

格納先ディレクトリ

■統合エージェントホスト

Windowsの場合

物理ホストのとき

Agentパス¥conf¥

論理ホストのとき

共有フォルダ¥jp1ima¥conf¥

Linuxの場合

物理ホストのとき

/opt/jp1ima/conf/

論理ホストのとき

共有ディレクトリ/jp1ima/conf/

説明

統合エージェント制御基盤のimagentactionの動作を規定する設定ファイルです。

文字コード

UTF-8（BOM無し）

改行コード

Windowsの場合：CR+LF

Linuxの場合：LF

定義の反映時期

imagentサービスおよびimagentactionサービスを再起動したときに反映します。

記述内容

メンバー名

省略可否

型

設定する値

port

可

number

統合エージェント制御基盤（imagentaction）へのアクセスを受け付けるためのポート

5001〜65535の範囲で指定します。

省略時は20728が仮定されます。

log

可

object

ログ設定

マニュアル「JP1/Integrated Management 3 - Manager運用ガイド」の「12.2.2(7)統合エージェント制御基盤のログ」の「(a)公開ログ」を参照してください。

設定項目については，「imbase設定ファイル（jpc_imbase.json）」のlogの説明を参照してください。

注意事項

このファイルにアクセスできない場合は，imagentproxyを異常停止します。

JSON形式の指定が不正な場合，または型と不一致な指定がある場合は，サービスを異常停止します。

ユーザー作成定義ファイルリスト定義ファイル（jpc_user_deffile_list.json）

形式

定義ファイルの形式

{
  "filelist":[
    {
      "filename": "ファイル名",
      "filepath": "ファイルの絶対パス",
      "filecategoryID": "ファイルのカテゴリーID",
      "filecategoryName": "ファイルのカテゴリー名",
      "updateaction": "定義反映のための操作"
    }, ・・・
  ]
}

モデルファイルの形式

{
  "filelist":[
    {
      "filename": "",
      "filepath": "",
      "filecategoryID": "",
      "filecategoryName": "",
      "updateaction": ""
    }
  ]
}

ファイル

jpc_user_deffile_list.json

jpc_user_deffile_list.json.model（モデルファイル）

格納先ディレクトリ

■統合エージェントホスト

Windowsの場合

物理ホストのとき

Agentパス¥conf¥

論理ホストのとき

共有フォルダ¥jp1ima¥conf¥

Linuxの場合

物理ホストのとき

/opt/jp1ima/conf/

論理ホストのとき

共有ディレクトリ/jp1ima/conf/

説明

ユーザーが作成する定義ファイルのうち，JP1/IM - Managerが提供するREST APIで更新，削除ができるファイルを定義するファイルです。

文字コード

UTF-8（BOM無し）

改行コード

Windowsの場合：CR+LF

Linuxの場合：LF

定義の反映時期

定義ファイルの更新機能，削除機能，一覧取得機能が動作したときに定義を読み込みます。

記述内容

項目名

省略可否

説明

filename

不可

ファイル名を記載します。

filepath

可

ファイルの配置先を絶対パスで記載します。

ファイルパス（ファイル名を含めた絶対パス）が，200文字を超えた場合はエラーとなります。

filepathに「jp1ima¥conf¥user」が含まれていない場合は，不正なファイルパスとみなされます。

指定したファイルパスにfilenameで指定した名称のファイルが存在しない場合は，不正な定義とみなされます。

この設定項目を省略した場合，「Agentパス/conf/user」が仮定されます（論理環境の場合は「Agentパス」を「共有ディレクトリ/jp1ima」に読み替えてください）。

filecategoryID

可

複数のファイルをグルーピングしたい場合に指定するカテゴリーIDを記載します。

同一のカテゴリーIDを指定したファイルは，同じカテゴリー名に属すると判断されます。

指定できる文字は，半角英数字と「-」（ハイフン）と「_」（アンダースコア）です。最大32文字まで指定できます。「jp1_」から始まるカテゴリーIDは指定できません。

filecategoryName

可

カテゴリーIDに対するカテゴリー名を指定します。

制御文字以外の文字で指定します。最大32文字まで指定できます。

filecategoryIDの指定がない場合，この設定項目は無視されます。filecategoryIDの指定がある場合，この設定項目の指定がないときは，filecategoryIDの値が設定されます。

updateaction

可

Windowsの場合，ファイルの配置先ディレクトリを<インストールディレクトリ>の一階層上からの相対パスで定義ファイルを更新した場合に実行すべき操作（コマンドライン）を記載します。

Linuxの場合，/opt/からの相対パスで定義ファイルを更新した場合に実行すべき操作（コマンドライン）を記載します。

詳細については，「■updateactionの記載について」を参照してください。

■updateactionの記載について

定義ファイルの更新後に実行するコマンドを記載できます。記載できるコマンドラインの長さは4,096バイトまでです。

実行先ホストが64ビット版のWindowsで，%WINDIR%¥System32フォルダ以下に配置されているコマンドを指定する場合は，WOW64のリダイレクト機能に留意してください。

実行できるコマンドの種類を次に示します。

コマンドを実行するホストがWindowsの場合

実行形式ファイル（.com，.exe）

バッチファイル（.bat）

JP1/Scriptのスクリプトファイル（.spt）（ただし，.sptファイルが実行できるよう関連づけが設定されていること）

コマンドを実行するホストがLinuxの場合

Linuxのコマンド

シェルスクリプト

なお，次のようなコマンドは実行できません。

対話操作を必要とするコマンド

画面を表示するコマンド

エスケープシーケンスや制御コードを伴うコマンド

デーモンなどの，終了しないコマンド

Windows メッセージ機構やDDEなど，デスクトップとの対話が必要なコマンド（Windowsの場合）

shutdownやhaltなど，OSをシャットダウンするコマンド

■ユーザー作成定義ファイルリスト定義ファイルに指定できる定義ファイルについて

指定できる定義ファイル

定義ファイルを更新した場合に実行すべき操作

GUI上の表示カテゴリ

コマンド実行

コマンドライン

Blackbox exporterの監視対象（ユーザー定義）のディスカバリ設定ファイル

（file_sd_config_blackbox_任意の名前.yml）

Prometheus serverのリロード

■Windowsの場合

物理ホストのとき

cmd.exe /c Agentパス¥addon_management¥prometheus¥addon_jpc_service_reload.bat

論理ホストのとき

cmd.exe /c Agentパス¥addon_management¥prometheus¥addon_jpc_service_reload.bat -h論理ホスト

■Linuxの場合

物理ホストのとき

/bin/sh -c /opt/jp1ima/addon_management/prometheus/addon_jpc_service_reload

論理ホストのとき

/bin/sh -c /opt/jp1ima/addon_management/prometheus/addon_jpc_service_reload -h 論理ホスト

jp1_imexporter

ユーザー独自のディスカバリ設定ファイル（user_file_sd_config_任意の名前.yml）

Fluentdのテキスト形式のログファイルの監視定義ファイル（fluentd_トラップ名_tail.conf）※

Fluentdのサービスの再起動

■Windowsの場合

物理ホストのとき

cmd.exe /c Agentパス¥addon_management¥fluentd¥addon_jpc_service_reload.bat

論理ホストのとき

cmd.exe /c Agentパス¥addon_management¥fluentd¥addon_jpc_service_reload.bat -h 論理ホスト

■Linuxの場合

物理ホストのとき

/bin/sh -c /opt/jp1ima/addon_management/fluentd/addon_jpc_service_reload

論理ホストのとき

/bin/sh -c /opt/jp1ima/addon_management/fluentd/addon_jpc_service_reload -h 論理ホスト

jp1_imfluenntd

FluentdのWindowsイベントログの監視定義ファイル（fluentd_トラップ名_wevt.conf）※

CA証明書ファイル（Blackbox exporter用）※

Blackbox exporterのリロード

Blackbox exporter設定ファイル（jpc_blackbox_exporter.yml）と同じです。

jp1_certificate

クライアント証明書ファイル（Blackbox exporter用）※

クライアント証明書キーファイル（Blackbox exporter用）※

パスワードファイル（Blackbox exporter用）※

環境変数ファイル（任意のファイル名）※

不要（環境変数ファイルは，コマンド実行を開始するときに参照されます）

−

−

ログメトリクス定義ファイル（fluentd_任意の名前_logmetrics.conf）

Fluentdのサービスの再起動

■Windowsの場合

物理ホストのとき

cmd.exe /c Agentパス¥addon_management¥fluentd¥addon_jpc_service_reload.bat

論理ホストのとき

cmd.exe /c Agentパス¥addon_management¥fluentd¥addon_jpc_service_reload.bat -h 論理ホスト

■Linuxの場合

物理ホストのとき

/bin/sh -c /opt/jp1ima/addon_management/fluentd/addon_jpc_service_reload

論理ホストのとき

/bin/sh -c /opt/jp1ima/addon_management/fluentd/addon_jpc_service_reload -h 論理ホスト

jp1_imfluentd

（凡例）

−：該当なし

注※

定義ファイルを追加または削除する場合にも指定できます。

定義ファイルプロパティファイル（jpc_file_properties.json）

形式

{
  "filelist":[
    {
      "filename": "ファイル名",
      "filepath": "ファイルの絶対パス",
      "updateaction": "定義反映のための操作",
      "message": "メッセージ"
    }, ・・・
  ]
}

ファイル

jpc_file_properties.json

格納先ディレクトリ

定義ファイルの取得機能または更新機能で操作する定義ファイルを，圧縮したzipファイルの中に配置します。

説明

定義ファイルの取得機能または更新機能で操作する定義ファイルのファイル名，ファイルパス，定義ファイル反映のための操作を記載したファイルです。

文字コード

UTF-8（BOM無し）

改行コード

Windowsの場合：CR+LF

Linuxの場合：LF

定義の反映時期

定義ファイルの取得機能または更新機能が動作したときに定義を読み込みます。

記述内容

項目名

説明

filename

ファイル名を記載します。

filepath

ファイルの配置先を絶対パスで記載します。

ファイルパス（ファイル名含めた絶対パス）が，200文字を超えた場合はエラーとなります。

updateaction

定義ファイルを更新した場合に実行すべき操作（コマンドライン）を記載します。

詳細については，「ユーザー作成定義ファイルリスト定義ファイル（jpc_user_deffile_list.json）」の「■updateactionの記載について」を参照してください。

message

エラーメッセージIDとそのメッセージ本文を返却します。成功した場合は省略します。

環境変数ファイル（任意のファイル名）

形式

環境変数名1=変数値1
[環境変数名2=変数値2]
   ：

ファイル

ファイル名は任意です。

格納先ディレクトリ

■統合エージェントホスト

Windowsの場合

コマンドを実行する統合エージェントホストの任意のフォルダ※

Linuxの場合

コマンドを実行する統合エージェントホストの任意のディレクトリ※

注※

環境変数ファイルの格納先ディレクトリは任意ですが，環境変数ファイルをJP1/IM用のディレクトリには格納しないでください。格納した場合，資料採取やバックアップの対象になってしまいます。

なお，定義ファイル操作機能で環境変数ファイルを操作するときは，次に示すディレクトリ※に，環境変数ファイルを格納します。

Windowsの場合

物理ホストのとき

Agentパス¥conf¥user¥

論理ホストのとき

共有フォルダ¥jp1ima¥conf¥user¥

Linuxの場合

物理ホストのとき

/opt/jp1ima/conf/user/

論理ホストのとき

共有ディレクトリ/jp1ima/conf/user/

注※

定義ファイル操作機能で環境変数ファイルを操作するときは，所定の格納先ディレクトリに環境変数ファイルを格納します。このディレクトリは，資料採取やバックアップの対象外です。

説明

JP1/IMの管理対象ホストでコマンドを実行するときの環境変数を定義するファイルです。

JP1/IM - Managerの対処アクションの自動実行機能，または，対処アクションの手動実行機能の操作で，JP1/IMの管理対象ホストでコマンドを実行するときは，そのコマンドの実行環境として環境変数を指定できます。環境変数は，ここで説明している形式で記述された環境変数ファイルにより指定できます。

複数の環境変数ファイル（ファイル名は任意）を用意することで，実行するコマンドごとに任意の環境変数を指定できます。

また，Windows環境で環境変数ファイルを指定しない場合は，システムの環境変数でコマンドが実行されます。

定義の反映時期

環境変数ファイルは，コマンド実行を開始するときに参照されます。

文字コード

環境変数ファイルのエンコーディングは，コマンドを実行する管理対象ホストの文字コードとなります。文字コードについては，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「3.15.7(1)(e)コマンド実行機能」の文字コードの説明を参照してください。

改行コード

Windowsの場合：CR+LF

Linuxの場合：LF

記述内容

1行に指定できる文字列の長さは，最大1,023バイトです。各行の最後には必ず改行を入れてください。

環境変数名

環境変数の名称を指定します。

改行文字を含む環境変数は指定できません。

変数値

環境変数の値を指定します。

ここにシステム環境変数名を指定することでシステム環境変数の値を引き継げます。

システム環境変数を指定する場合は，システム環境変数名を「<-」と「->」で囲み，「<-variable->」のように指定してください。

重要

「環境変数名=変数値」の形式以外の文字列は指定しないでください。指定した場合，コマンドを実行するホスト側のOSによってはコマンドが異常終了することがあります。

環境変数としてプロキシ設定などを記載した場合，設定値は暗号化や難読化がされないことに注意してください。

ymlファイルの記述項目で使用している一般的なプレースホルダーの定義について

ymlファイルの記述項目で使用している一般的なプレースホルダーの定義について，次に示します。

プレースホルダー

定義

<boolean>

「true」または「false」のどちらかの値を使用できるブール値を示します。

<duration>

次の正規表現に一致する期間を示します。((([0-9]+)y)?(([0-9]+)w)?(([0-9]+)d)?(([0-9]+)h)?(([0-9]+)m)?(([0-9]+)s)?(([0-9]+)ms)?|0)

<filename>

現在の作業ディレクトリ内の有効なパスを示します。

<host>

ホスト名またはIPアドレス，およびオプションのポート番号で構成される有効な文字列を示します。

<int>

整数値を示します。

<labelname>

次の正規表現に一致する文字列を示します。

[a-zA-Z_] [a-zA-Z0-9_]*

<labelvalue>

Unicodeの文字列を示します。

<path>

有効なURLのパスを示します。

<scheme>

「http」または「https」のどちらかの値を使用できる文字列を示します。

<secret>

パスワードなどの秘密にする必要がある通常の文字列を示します。

<string>

通常の文字列を示します。

PromQL文に関する注意事項

メトリック定義ファイルやアラート設定ファイルに記述するPromQL文で取得するパフォーマンスデータには，構成情報のSIDの種類ごと（EC2以外のCloudWatchSIDについては，AWS名前空間ごと）に，次に示すラベルが設定されている必要があります。

構成情報のSIDの種類については，マニュアル「JP1/Integrated Management 3 - Manager導入・設計ガイド」の「3.15.6(1)(a)ターゲットとなる構成情報のSIDの種類と使用できる機能」を参照してください。

表2‒118　 PromQL文で取得したパフォーマンスデータに設定されている必要があるラベル

構成情報のSIDの種類

AWS名前空間名

トレンドデータ（メトリック定義ファイルのpromqlに指定するPromQLで取得）に設定されている必要のあるラベル

アラート（アラート設定ファイルのexprに指定するPromQLで取得）に設定されている必要があるラベル

エージェントSID

−

instance

job

jp1_pc_nodelabel

jp1_pc_prome_hostname

instance

job

jp1_pc_nodelabel

jp1_pc_exporter

リモートエージェントSID

instance

job

jp1_pc_nodelabel

jp1_pc_exporter

jp1_pc_remote_monitor_instance

EC2のCloudWatchSID

AWS/EC2

CloudWatchSID共通のラベル※に加えて，次のラベルが必要です。

dimension_InstanceId

EC2以外のCloudWatchSID

AWS/DynamoDB

CloudWatchSID共通のラベル※に加えて，次のラベルが必要です。

dimension_TableName

AWS/Lambda

CloudWatchSID共通のラベル※に加えて，次のラベルが必要です。

dimension_FunctionName

AWS/S3

CloudWatchSID共通のラベル※に加えて，次のラベルが必要です。

dimension_BucketName

dimension_StorageType

AWS/SQS

CloudWatchSID共通のラベル※に加えて，次のラベルが必要です。

dimension_QueueName

AWS/States

CloudWatchSID共通のラベル※に加えて，次のラベルが必要です。

dimension_APIName

ログ監視対象のSID

−

instance

jp1_pc_nodelabel

−

（凡例）

−：該当なし

注※

CloudWatchSID共通のラベルは，次のラベルを示します。

instance

job

jp1_pc_nodelabel

jp1_pc_exporter

account_id

region

jp1_pc_remote_monitor_instance

PromQL文にwithout句，by句などを使用してパフォーマンスデータの絞り込みを行う場合，「表2-5 PromQL文で取得したパフォーマンスデータに設定されている必要があるラベル」に記載しているラベルが削除されないように絞り込みを行ってください。

メトリック定義ファイルのpromqlに不正なPromQL文が設定されている場合，トレンドデータの返却機能で正しいトレンドデータが返却されません。

アラート設定ファイルのexprに不正なPromQL文が設定されている場合，JP1イベントが発行されない，拡張属性の値が空欄となる，または，JP1イベントが正しいIM管理ノードに関連付かないことがあります。

3　JP1イベント

この章では，JP1/IMが出力するJP1イベントの種類とその属性について説明します。

3.1　JP1イベントの属性

JP1イベントの属性を説明します。JP1イベントの属性には基本属性と拡張属性があります。ここではそれぞれの属性の詳細を説明します。

3.1.1　基本属性

イベントの基本属性とは，すべてのJP1イベントが持っている属性です。ここでは，JP1イベントの基本属性の詳細を説明します。

JP1イベントの基本属性の詳細

なお，基本属性の属性名にはB.IDのように先頭に「B.」を付けて区別する場合があります。設定する際に「B.」を付ける必要がある場合は，マニュアル内でそのつど説明しています。

表3‒1　JP1イベントの基本属性

項目

属性名

内容

イベントDB内通し番号

SEQNO

発行元によらないでこのイベントサーバに到達した順番。

イベントID

ID

発行アプリケーションプログラムや事象の内容を表す8バイトの値。

拡張イベントID

IDEXT

イベントIDの拡張部分を表す8桁の16進数文字列。

種別

TYPE

イベントの種別。

登録要因

REASON

JP1イベントがこのイベントサーバに登録された要因。

発行元プロセスID

PROCESSID

発行元アプリケーションプログラムのプロセスID。

登録時刻

TIME

発行元イベントサーバでの登録時刻。

到着時刻

ARRIVEDTIME

自イベントサーバでの登録時刻。

発行元ユーザーID

USERID

発行元プロセスのユーザーID。Windowsからのイベントの場合は-1となる。

発行元グループID

GROUPID

発行元プロセスのグループID。Windowsからのイベントの場合は-1となる。

発行元ユーザー名

USERNAME

発行元プロセスのユーザー名。

発行元グループ名

GROUPNAME

発行元プロセスのグループ名。Windowsからのイベントの場合は空白となる。

発行元イベントサーバ名

SOURCESERVER

発行元のイベントサーバ名。イベントが，JP1/Base(エージェント)→JP1/IM - Manager（拠点マネージャー）→ JP1/IM - Manager（統合マネージャー）のように転送された場合でも，最初のJP1/Baseのイベントサーバ名が入る。

送信先イベントサーバ名

DESTSERVER

発行元APが他イベントサーバへの転送を明示して指定した場合に，他イベントサーバの名称が入る。

発行元IPアドレス

SOURCEIPADDR

発行元イベントサーバに対応するIPアドレス（NAT（ネットワークアドレス変換）やプロキシを経由した場合および環境設定で転送したJP1イベントについては正確な値ではない）。

送信先IPアドレス

DESTIPADDR

送信先イベントサーバに対応するIPアドレス（NAT（ネットワークアドレス変換）やプロキシを経由した場合および環境設定で転送したJP1イベントについては正確な値ではない）。

発行元イベントDB内通し番号

SOURCESEQNO

発行元ホストでのイベントDB内通し番号（転送によって値は変化しない）。

コードセット

CODESET

メッセージ・詳細情報・拡張属性が記述されている文字コードセット名。

メッセージ

MESSAGE

イベントの内容を表した文字列。

詳細情報

−

任意のデータ。

基本属性の詳細情報は，主にバージョン5以前のJP1/SES互換のイベントを発行する製品が，詳細情報を記録する場合などに使われます。

バージョン6以降の製品の多くは，JP1イベント拡張属性を使って詳細な情報を記録します。

（凡例）

−：なし

3.1.2　拡張属性

イベントの拡張属性とは，イベント発行元プログラムが任意に指定できる属性です。拡張属性には共通情報と固有情報があります。共通情報はJP1プログラムで統一されている情報です。固有情報は共通情報以外の拡張属性です。ここでは，共通情報の詳細を説明します。

共通情報の詳細

拡張属性の属性名にはE.SEVERITYのように先頭に「E.」を付けて区別する場合があります。設定する際に「E.」を付ける必要がある場合は，マニュアル内でそのつど説明しています。

共通情報の一覧を次の表に示します。

表3‒2　共通情報の一覧

項目

属性名

内容

重大度

SEVERITY

JP1イベントの緊急性を表す。緊急性の高い順に，次の値がある。

Emergency（緊急）

Alert（警戒）

Critical（致命的）

Error（エラー）

Warning（警告）

Notice（通知）

Information（情報）

Debug（デバッグ）

ユーザー名

USER_NAME

業務を実行しているユーザー名。

プロダクト名

PRODUCT_NAME

JP1イベントを発行したプログラム名。次に示すプログラム名などがある。

/HITACHI/JP1/AJS

/HITACHI/JP1/FTP

/HITACHI/JP1/NETMDM

/HITACHI/JP1/NPS

/HITACHI/JP1/NT_LOGTRAP

/HITACHI/JP1/PAM

/HITACHI/JP1/IM/SCOPE

オブジェクトタイプ

OBJECT_TYPE

イベント発行の契機となったオブジェクトの種類を表す名称。次に示す値などがある。

JOB，JOBNET，BATCHJOB，ACTION，LIST

オブジェクト名

OBJECT_NAME

イベント発行の契機となったオブジェクト（ジョブ，ジョブネットなど）の名称。

登録名タイプ

ROOT_OBJECT_TYPE

オブジェクトの種別。通常はオブジェクトタイプと同じだが，ジョブネットなど階層のあるオブジェクトの場合，最上層のオブジェクトの種別となる。値の範囲はオブジェクトタイプと同じ。

登録名

ROOT_OBJECT_NAME

ユーザーの操作時に実行を指示する単位になる名称。通常はオブジェクト名と同じだが，ジョブネットなど階層のあるオブジェクトの場合，最上層のオブジェクトの名称になる。

オブジェクトID

OBJECT_ID

オブジェクトID。

PRODUCT_NAMEとの組み合わせによってオブジェクトのインスタンスを統合システム内で一意に意識できる文字列（形式は他製品に依存する。この情報はJP1/IM - Viewの［統合機能メニュー］画面から各製品のモニターを呼び出すときに使用する）。

事象種別

OCCURRENCE

オブジェクト名に示したオブジェクトに対して起こった事象。次に示す事象種別などがある。

START（実行開始）

END（実行終了）

PAUSE（実行の一時停止）

RELEASE（一時停止の解除）

RESTART（再実行の開始）

CREATE（定義の作成）

DESTROY（定義の削除）

開始時刻

START_TIME

実行開始または再実行開始の時刻(UTC 1970-01-01 00:00:00からの秒数)。この項目は設定されない場合もある。

終了時刻

END_TIME

実行終了の時刻(UTC 1970-01-01 00:00:00からの秒数)。この項目は設定されない場合もある。

終了コード

RESULT_CODE

10進数文字列の終了コード。この項目は設定されない場合もある。

発生元ホスト名

JP1_SOURCEHOST

発生元となったホスト名。

3.2　JP1/IMが出力するJP1イベント

JP1/IMが出力するイベントについて説明します。

3.2.1　JP1/IM - Managerが出力するJP1イベント一覧

イベントID

発行契機

メッセージ

発行元機能

00002010

アクション遅延の監視中に，アクション実行時間が監視時間を超過した場合

KAVB4400-E イベント(EVENT_ID=イベントID, SEQNO=イベントDB内通し番号)に対するアクション(実行ホスト=アクション実行ホスト, アクション通し番号=アクション通し番号)の実行時間がアクション遅延監視時間を超過しました。以降アクション遅延監視への通知機能の抑止を解除するまで，遅延監視の通知を実行しません

アクション実行サービス

00002011

アクション状態の監視中に，アクション状態が「実行不可」または「実行失敗」になった場合

KAVB4402-E イベント(EVENT_ID=イベントID，SEQNO=イベントDB内通し番号)に対するアクション(実行ホスト=アクション実行ホスト，アクション通し番号=アクション通し番号)の状態が異常状態になりました。以降アクション状態監視への通知機能の抑止を解除するまで，状態監視の通知を実行しません

アクション実行サービス

00002012

ヘルスチェック機能が異常を検知した場合

KAVB8060-E 機能名 の異常を検知しました (ホスト名=ホスト名, プロセス名=プロセス名, プロセスID=プロセスID) ： 保守情報

イベントコンソールサービス

イベント基盤サービス

00002013※1

ヘルスチェック機能が異常を検知した場合

KAVB8062-E 機能名 の異常を検知しました (ホスト名=ホスト名, プロセス名=プロセス名) ： 保守情報

イベントコンソールサービス

00002014※2

ヘルスチェック機能が異常回復を検知した場合

KAVB8061-I 機能名 が回復しました (ホスト名=ホスト名, プロセス名=プロセス名, プロセスID=プロセスID) ：保守情報

イベントコンソールサービス

イベント基盤サービス

00002015

アクション遅延監視への通知抑止が解除された場合

KAVB4401-I アクション遅延監視への通知機能の抑止を解除しました。以降アクション遅延監視時間を超過したアクションが発生した場合，通知機能を実行します

アクション実行サービス

00002016

アクション状態監視への通知抑止が解除された場合

KAVB4403-I アクション状態監視への通知機能の抑止を解除しました。以降アクション状態監視時間を超過したアクションが発生した場合，通知機能を実行します

アクション実行サービス

00002020

アクション遅延の監視中に，遅延状態となったアクションがアクション情報ファイルからラップした場合

KAVB4404-E アクション(アクション通し番号=アクション通し番号)の実行時間がアクション遅延監視時間を超過しましたが，アクション情報ファイルにアクションの情報が存在しないためアクション遅延通知イベントを発行できませんでした。以降アクション遅延監視への通知機能の抑止を解除するまで，遅延監視の通知を実行しません

アクション実行サービス

00002021

アクション状態の監視中に，異常状態となったアクションがアクション情報ファイルからラップした場合

KAVB4405-E アクションの状態が異常状態になりましたが，アクション情報ファイルにアクションの情報が存在しないためアクション異常状態通知イベントを発行できませんでした。以降アクション状態監視への通知機能の抑止を解除するまで，監視の通知を実行しません：保守情報

アクション実行サービス

000020A0

続行できない問題が発生したため，自動アクション処理が異常終了した場合

KAVB4054-E 自動アクション処理が異常終了しました (ホスト名 : ホスト名)

アクション実行サービス

000020A1

jco_start (.model)コマンドによって，自動アクションが起動した場合。デフォルトでは発行しない。

KAVB4050-I 自動アクション処理を開始します

アクション実行サービス

000020A2

jco_stop (.model)コマンドによって，自動アクションが停止した場合。デフォルトでは発行しない。

KAVB4051-I 自動アクション処理を終了します

アクション実行サービス

000020A3

jcachangeコマンドまたは画面からの操作によって，自動アクション機能が稼働状態になった場合

KAVB4055-I アクション定義ファイルを読み込み，自動アクション機能を稼働状態にしました。次に受信したイベントから，読み込んだ定義で処理されます (定義数：有効な定義数/ファイル内の全定義数，最後に受信したイベント：到着時刻=最後に処理したイベントの到着時刻 (YYYY/MM/DD hh:mm:ss), イベントDB内通し番号=最後に処理したイベントのイベントDB内通し番号)

イベント基盤サービス

000020A4

自動アクション機能が稼働状態から休止状態になった場合

KAVB4056-I 自動アクションを休止しました。次に受信したイベントから，自動アクションが実行されません (最後に受信したイベント：到着時刻=最後に処理したイベントの到着時刻 (YYYY/MM/DD hh:mm:ss), イベントDB内通し番号=最後に処理したイベントのイベントDB内通し番号)

イベント基盤サービス

000020A5

アクション実行サービスがロケール情報の設定に失敗した場合

KAVB4909-E ロケール情報の設定に失敗しました

アクション実行サービス

000020A6

イベント基盤サービスプロセスがロケール情報の設定に失敗した場合

KAVB4909-E ロケール情報の設定に失敗しました

イベント基盤サービス

000020E0

アクションの実行を開始した場合

KAVB4430-I イベント (EVENT_ID=イベントID, SEQNO=イベントDB内通し番号) に対するアクションの実行を要求しました

アクション実行サービス

000020E1

アクションが終了した場合

KAVB4431-I イベント (EVENT_ID=イベントID, SEQNO=イベントDB内通し番号) に対するアクションの実行が終了しました (終了コード=終了コード)

アクション実行サービス

000020E2

アクションが自動アクションまたはコマンド制御内部で異常状態になった場合

KAVB4432-E イベント (EVENT_ID=イベントID, SEQNO=イベントDB内通し番号) に対するアクションが自動アクションまたはコマンド制御で異常終了しました

アクション実行サービス

000020E3※3

アクション状態通知イベントに対するアクションの実行要求を登録した場合

KAVB4433-I アクション状態通知イベント (EVENT_ID=イベントID, SEQNO=イベントDB内通し番号) に対するアクションの実行を要求しました

アクション実行サービス

000020E4※3

アクション状態通知イベントに対するアクションが終了した場合

KAVB4434-I アクション状態通知イベント (EVENT_ID=イベントID, SEQNO=イベントDB内通し番号) に対するアクションの実行が終了しました (終了コード=終了コード)

アクション実行サービス

000020E5※3

アクション状態通知イベントに対するアクションが自動アクションまたはコマンド制御内部で異常状態になった場合

KAVB4435-E アクション状態通知イベント (EVENT_ID=イベントID, SEQNO=イベントDB内通し番号) に対するアクションが自動アクションまたはコマンド制御内部で異常終了しました

アクション実行サービス

000020E6※3

jcocmddefコマンドで実行要求を通知する設定が有効になっている場合。アクション情報ファイルがラップしており，実行要求に対するアクション状態通知イベント（000020E0，000020E3）が発行できなかった場合に発行する（重大度：Warning）。

KAVB4436-W アクションの実行を要求しましたが，アクション情報ファイルにアクションの情報が存在しないためアクション状態通知イベントが発行できません

アクション実行サービス

000020E7※3

jcocmddefコマンドで実行終了を通知する設定が有効になっている場合。アクション情報ファイルがラップしており，実行終了に対するアクション状態通知イベント（000020E1，000020E4）が発行できなかった場合に発行する（重大度：Warning）。

KAVB4437-W アクションの実行が終了しましたが，アクション情報ファイルにアクションの情報が存在しないためアクション状態通知イベントが発行できません

アクション実行サービス

000020E8※3

jcocmddefコマンドで異常終了を通知する設定が有効になっている場合。アクション情報ファイルがラップしており，異常終了に対するアクション状態通知イベント（000020E2，000020E5）が発行できなかった場合に発行する（重大度：Error）。

KAVB4438-E アクションが自動アクションまたはコマンド制御において異常終了しましたが，アクション情報ファイルにアクションの情報が存在しないためアクション状態通知イベントが発行できません

アクション実行サービス

00003F01※1

接続ホスト上のイベントバッファーに取得できるイベントがなく，イベントを表示できなかった場合

KAVB1513-W 表示できなかったイベントがあります。

表示できなかったイベントを確認するには，［イベント検索条件設定］画面を表示し，以下の検索条件を指定し検索してください。

（１） 検索ホスト名として，接続中のホスト名を指定する

（２） 登録時刻として，このイベントの前または後に表示されているイベントの登録時刻を指定する

このイベントが頻繁に表示される場合は，次の条件に該当していないか確認し，必要があれば設定値を見直してください。

（１）［ユーザー環境設定］画面で設定されている，「表示内容の自動更新」の「更新間隔」の設定値が長い

（２）［ユーザー環境設定］画面で設定されている，「更新時のイベント取得件数」の設定値が小さい

（３）［システム環境設定］画面で設定されている，マネージャーの「イベントバッファー」の設定値が小さい

イベントコンソールサービス

00003F02※1

取得しようとしたイベントが，既に接続ホストのイベントバッファーになく，［イベント監視］ページ，または［重要イベント］ページのどちらかにだけ，イベントを表示できなかった場合に，その該当ページに表示する。

［重要イベント］ページに表示する場合は，強制的に重要イベントとする。

KAVB1540-W 表示できなかったイベントがあります。(ページ:ページ)

表示できなかったイベントを確認するには，［イベント検索条件設定］画面を表示し，以下の検索条件を指定してください。

（１）検索ホスト名として，接続中のホスト名を指定する

（２）登録時刻として，このイベントの前または後に表示されているイベントの登録時刻を指定する

このイベントが頻繁に表示される場合は，以下の条件に該当していないか確認し，必要があれば設定値を見直してください。

（１）［ユーザー環境設定］画面で設定されている，「表示内容の自動更新」の「更新間隔」の設定値が長い

（２）［ユーザー環境設定］画面で設定されている，「更新時のイベント取得件数」の設定値が小さい

（３）［システム環境設定］画面で設定されている，マネージャーの「イベントバッファー」の設定値が小さい

イベントコンソールサービス

00003F03※1

イベントサービスからイベントを取得するときにエラーが発生した場合

KAVB1516-W イベントサービスからイベントを取得するときにエラーが発生しました。

システムプロファイルに指定された回数リトライしましたが，回復しません。このため，以降のイベントは表示されません。

イベントサービスが起動しているか確認してください。起動していない場合は，イベントサービス起動後，マネージャーを再起動して，回復してください

イベントコンソールサービス

00003F04※1

バージョン06-00のJP1/Baseのイベントサービスに対して，サポートしていない条件（「を含む」，「を含まない」，「正規表現」の指定，または対処状況の複数指定）でイベントを検索した場合

バージョン06-51のJP1/Baseのイベントサービスに対して，サポートしていない条件（「正規表現」の指定）でイベントを検索した場合

KAVB1527-E 検索ホストで受け付けられない条件が含まれています

イベントコンソールサービス

00003F05※1

イベント検索実行時，フィルター長がイベントサービスのフィルターの最大長を超える場合

KAVB0246-E フィルター条件の最大長（最大長）を超えて指定しています

イベントコンソールサービス

00003F06※1

イベント検索実行時，指定した正規表現が間違っている場合

KAVB0248-E 正規表現の指定が正しくありません

イベントコンソールサービス

00003F07※1

イベント基盤サービスとイベントサービス間で接続が切れた場合

KAVB4764-W イベントサービスからイベントを取得するときにエラーが発生しました。

イベントサービスが起動しているか確認してください。起動していない場合はイベントサービスを起動してください。

イベント基盤サービス

00003F08※1

除外条件を指定してイベント検索を実行した時，検索ホストのJP1/Baseのバージョンが08-11以前だった場合

KAVB0251-E 検索ホストのJP1/Baseが除外条件に対応していないため，指定された条件では検索できません

イベントコンソールサービス

00003F11

次に示す画面での操作，またはコマンドによってJP1イベントの対処状況が変更になった場合

［イベントコンソール］画面

［関連イベント一覧］画面

jcochstatコマンド

応答待ちイベントに応答し，応答待ちイベントが「対処済」になった場合

応答待ちイベントがBJEXまたはJP1/ASからキャンセルされ，応答待ちイベントが「対処済」になった場合

KAVB1577-I 対処状況の操作が行われました(操作ユーザー:JP1ユーザー,イベントID:イベントID,対処前状況:対処前状況,対処後状況:対処後状況)

イベントコンソールサービス

00003F13※4

［システム環境設定］画面，［イベント取得条件一覧］画面，またはjcochfilterコマンドによって，JP1/IM - Managerのイベント取得フィルター条件が変更されたことを通知する場合

KAVB4014-I イベント取得条件定義を読み込みました。次に受信したイベントから読み込んだ定義で処理されます。(フィルター名：フィルター名 ，最後に受信したイベント：到着時刻=到着時刻，イベントDB内通し番号=イベントDB内通し番号)

イベント基盤サービス

相関イベント発行定義ファイルのSUCCESS_EVENTパラメーターに指定されたイベントID

設定した相関イベント発行条件が相関イベント発行処理で成立した場合

相関イベント発行定義ファイルのSUCCESS_EVENTパラメーターに指定されたメッセージ

相関イベント発行機能

相関イベント発行定義ファイルのFAIL_EVENTパラメーターに指定されたイベントID

設定した相関イベント発行条件が相関イベント発行処理で不成立になった場合

相関イベント発行定義ファイルのFAIL_EVENTパラメーターに指定されたメッセージ

相関イベント発行機能

00003F15

統合監視DBが有効な場合に，［重要イベント定義］画面からJP1/IM - Manager（セントラルコンソール）の重要イベント定義が変更された事を通知する場合に発行される。

KAVB1669-I 重要イベント定義ファイルを読み込みました。次に取得したイベントから読み込んだ定義で処理されます（最後に取得したイベント：到着時刻=最後に取得したイベントの到着時刻，イベントDB内通し番号=最後に取得したイベントのイベントDB内通し番号）。

イベント基盤サービス

00003F16※1

統合監視DBからイベントを取得するときにエラーが発生した場合

KAVB1671-W 統合監視DBからイベントを取得するときにエラーが発生しました。

システムプロファイルに指定された回数リトライしましたが，回復しません。

このため，以降のイベントは表示されません

イベントコンソールサービス

00003F17※4

JP1/IM - Viewから追加共通除外条件が登録されたことを通知する

KAVB1150-I 追加共通除外条件群を登録しました。(共通除外群ID:共通除外条件群ID, 共通除外群名:共通除外条件群名, 登録ユーザー:ユーザー名)

イベント基盤サービス

00003F20※4

［システム環境設定］画面，［イベント取得条件一覧］画面，またはjcochfilterコマンドによって，JP1/IM - Manager（相関イベント発行サービス）のイベント取得フィルター条件が変更されたことを通知する場合

KAJV2179-I イベント取得条件定義を読み込みました。次に受信したイベントから読み込んだ定義で処理されます。（フィルター名:フィルター名，最後に受信したイベント:到着時刻=到着時刻, イベントDB内通し番号=イベントDB内通し番号）

相関イベント発行サービス

00003F21

jcoegschangeコマンドによって，相関イベント発行定義が更新されたことを通知する場合

KAJV2242-I 相関イベント発行定義ファイル（ファイル名）を読み込み，相関イベント発行機能に反映しました

相関イベント発行サービス

00003F22

JP1/IM - Manager起動時にJP1/Baseで使用する正規表現の設定が拡張正規表現でない場合かつJP1/IM - Managerの共通除外条件群の動作モードが拡張モードに設定されている場合

KAVB4712-W JP1/Baseで使用する正規表現を拡張していないためイベント基盤サービスは共通除外条件群(拡張)を使用できません。共通除外条件群(拡張)が設定されていない状態で起動します

イベントコンソールサービス

00003F23

JP1/IM - Manager起動時にJP1/Baseで使用する正規表現の設定が拡張正規表現でない場合かつJP1/IM - Managerの共通除外条件群の動作モードが拡張モードに設定されている場合

KAJV2502-W JP1/Baseで使用する正規表現を拡張していないため相関イベント発行サービスは共通除外条件群(拡張)を使用できません。共通除外条件群(拡張)が設定されていない状態で起動します

イベント相関機能

00003F25

jcoegsstartコマンドによって，相関イベント発行処理を再開したことを通知する場合

KAJV2243-I 相関イベント発行機能を再開しました

相関イベント発行サービス

00003F26

jcoegsstopコマンドによって，相関イベント発行サービスを停止せずに相関イベント発行処理を停止したことを通知する場合

KAJV2234-I 相関イベント発行機能を停止しました

相関イベント発行サービス

00003F28

相関イベント発行サービスが発行処理しているJP1イベントの組数が上限値の20,000組に達した場合

KAJV2322-W 相関中のJP1イベントの組が上限(20000組)に達しているためJP1イベント（イベントID=イベントID，イベントDB内通し番号=イベントDB内通し番号）を相関できませんでした

相関イベント発行サービス

00003F31※4

JP1/IM - Viewから追加共通除外条件が登録されたことを通知する

KAJV2188-I 追加共通除外条件群を登録しました。(共通除外群ID:共通除外条件群ID, 共通除外群名:共通除外条件群名, 登録ユーザー:ユーザー名)

相関イベント発行サービス

00003F41

滞留できる上限を超えて応答待ちイベントが発生した場合

KAVB0551-E マネージャーで滞留している応答待ちイベントが上限2000件を超えました

イベントコンソールサービス

00003F42

応答待ちイベント滞留ファイルの応答待ちイベントデータの読み込みに失敗した場合

KAVB1816-W 表示できなかった応答待ちイベントがあります。

表示できなかった応答待ちイベントを確認するには，［イベント検索条件設定］画面を表示し，次の検索条件を指定してください。

（１）検索ホスト名として，接続中のホスト名を指定する。

（２）応答待ちイベントとして，対象を指定する。

（３）到着時刻として，このJP1イベントの前又は後に表示されているイベントの到着時刻を指定する。

イベントコンソールサービス

00003F51

統合監視DBからイベントが削除された場合

KAVB1841-I 削除対象始点日から削除対象終点日のイベントを統合監視DBから削除しました

統合監視DB

00003F52

保存出力していないイベントが削除警告位置を超えた場合

KAVB1842-W 保存出力していないイベントが削除警告位置（削除警告位置%）を超えました

保存出力機能

00003F53※1

統合監視DBへのイベント登録処理でエラーが発生した場合

KAVB1832-E 統合監視DBへのイベント登録処理でエラーが発生しました。統合監視DBへのイベント登録をリトライします（詳細情報：詳細情報）

イベント基盤サービス

00003F54

統合監視DBへのイベント登録処理で発生していたエラーが回復した場合

KAVB1833-I 統合監視DBへのイベント登録処理で発生していたエラーが回復しました。イベント基盤サービスはイベント取得を再開しています

イベント基盤サービス

00003F56※4

追加繰り返しイベント条件を登録（追加）した場合

KAVB4673-I 繰り返しイベント条件を登録しました。(繰り返しイベント条件名:繰り返しイベント条件名, 登録ユーザー:ユーザー名)

繰り返しイベントの監視抑止機能

00003F57※4

［繰り返しイベント条件一覧］画面の［適用］ボタンをクリックした場合

KAVB4674-I 繰り返しイベント条件を更新しました。次に受信したイベントから読み込んだ定義で処理されます。(最後に受信したイベント：到着時刻=到着時刻, イベントDB内通し番号=イベントDB内通し番号)

繰り返しイベントの監視抑止機能

00003F58

繰り返しイベントの監視抑止で抑止が開始した場合

KAVB4676-I 繰り返しイベント条件(繰り返しイベント条件名)に一致するイベントの抑止を開始しました。(抑止を開始したイベント：到着時刻=到着時刻, イベントDB内通し番号=イベントDB内通し番号)

繰り返しイベントの監視抑止機能

00003F59

繰り返しイベントの監視抑止で抑止が終了した場合

KAVB4677-I 繰り返しイベント条件(繰り返しイベント条件名)に一致するイベントの抑止を終了しました。(抑止したイベント：到着時刻=抑止を開始したイベントの到着時刻 - 最後に抑止したイベントの到着時刻, イベントDB内通し番号=抑止を開始したイベントのイベントDB内通し番号 - 最後に抑止したイベントのイベントDB内通し番号)

繰り返しイベントの監視抑止機能

00003F60

繰り返しイベントの監視抑止を打ち切った場合

KAVB4678-I 繰り返しイベント条件(繰り返しイベント条件名)に一致するイベントの抑止を打ち切り，再度抑止を開始しました。(抑止したイベント：到着時刻=抑止を開始したイベントの到着時刻 - 最後に抑止したイベントの到着時刻, イベントDB内通し番号=抑止を開始したイベントのイベントDB内通し番号 - 最後に抑止したイベントのイベントDB内通し番号)

繰り返しイベントの監視抑止機能

00003F61

重大度変更定義を反映した場合jco_spmd_reloadを実行した場合

KAVB4600-I 重大度変更定義を読み込みました。次に受信したイベントから読み込んだ定義で処理されます。（最後に受信したイベント：到着時刻=到着時刻, イベントDB内通し番号=イベントDB内通し番号）

イベント基盤サービス

00003F63

発生元ホストマッピング定義を反映した場合

jco_spmd_reloadを実行した場合

KAVB4650-I 発生元ホストマッピング定義ファイルを読み込みました。次に受信したイベントから読み込んだ定義で処理されます。(最後に受信したイベント:到着時刻=到着時刻, イベントDB内通し番号=イベントDB内通し番号)

発生元ホストマッピング機能

00003F64

業務グループを反映した場合

KAVB8453-I 業務グループを反映しました。次に受信したイベントから処理されます。(最後に受信したイベント:到着時刻=到着時刻, イベントDB内通し番号=イベントDB内通し番号)

業務グループの参照・操作制限

00003F65

繰り返しイベントの監視の抑止が継続していると見なされた場合

KAVB4679-I 繰り返しイベント条件(繰り返しイベント条件名)に一致するイベントの抑止が継続しています。(抑止したイベント：到着時刻=抑止を開始したイベントの到着時刻 - 最後に抑止したイベントの到着時刻, イベントDB内通し番号=抑止を開始したイベントのイベントDB内通し番号 - 最後に抑止したイベントのイベントDB内通し番号)

繰り返しイベントの監視抑止機能

00003F68

業務グループを反映した場合

KAVB8454-W 業務グループを反映できませんでした。(要因:要因)

業務グループの参照・操作制限

00003F69

業務グループを反映した場合

KAVB8456-E 業務グループを反映できませんでした。(要因:要因)

業務グループの参照・操作制限

00003F6A

表示メッセージ変更定義を反映した場合

jco_spmd_reloadコマンドを実行した場合

KAVB4623-I 表示メッセージ変更定義ファイルを読み込みました。次に受信したイベントから，読み込んだ定義に従って処理されます。(最後に受信したイベント：到着時刻=到着時刻, イベントDB内通し番号=イベントDB内通し番号)

表示メッセージ変更機能

00003F71

追加重大度変更定義を登録した場合

KAVB4802-I 重大度変更定義を登録しました。(重大度変更定義名:重大度変更定義名, 登録ユーザー:ユーザー名)

イベントの重大度変更機能

00003F76

追加表示メッセージ変更定義を登録した場合

KAVB4803-I 表示メッセージ変更定義を登録しました。(表示メッセージ変更定義名:表示メッセージ変更定義名, 登録ユーザー:ユーザー名)

表示メッセージ変更機能

00003F77

イベント拡張属性定義ファイルをリロードした場合

KAVB5800-I イベント拡張属性定義ファイルをJP1/IM - Managerに読み込みました

固有の拡張属性表示・指定機能

00003F78

イベント拡張属性定義ファイルのリロードをしたが，一部の定義ファイルのリロードに失敗した場合

KAVB5804-E イベント拡張属性定義ファイルを読み込もうとしましたが，一部のイベント拡張属性定義ファイルの読み込みに失敗しました

固有の拡張属性表示・指定機能

00003F7C

モニター画面呼び出し定義ファイルをリロードした場合

KAVB1981-I モニター画面呼び出し定義ファイルをJP1/IM - Managerに反映しました

連携製品のモニター起動

00003FA0※5

コマンド実行制御が［コマンド実行］画面からコマンド実行要求を受け取った場合

KAVB2100-I [ホスト名 : JP1ユーザー名] コマンド実行を開始しました。

JP1/Baseのコマンド実行

00003FA1※5

［コマンド実行］画面から実行要求されたコマンドが実行完了した場合

KAVB2101-I [ホスト名 : JP1ユーザー名] コマンド実行が終了しました。

JP1/Baseのコマンド実行

00003FA2※5

［コマンド実行］画面から実行要求されたコマンドが，何らかの原因で実行されなかった場合

KAVB2102-E [ホスト名 : JP1ユーザー名] コマンド実行が異常終了しました。

JP1/Baseのコマンド実行

00003FA3※5

jcocmddefコマンドで経過時間イベント発行間隔を指定している場合。

［コマンド実行］画面および自動アクションから実行要求されたコマンドが，経過時間イベント発行間隔を超えて実行している場合。

KAVB2402-W [ホスト名] コマンド実行の実行時間が数値秒を超えました

JP1/Baseのコマンド実行

00003FA5※5

jcocmddefコマンドでコマンド先行入力数のしきい値が設定されている場合。自動アクションの先行入力数がしきい値に達した場合。

KAVB2071-W 実行先ホスト名で実行元ホスト名から要求されたコマンドの先行入力数が閾値[xx件]を超えました。

JP1/Baseのコマンド実行

00003FA6※5

jcocmddefコマンドでコマンド先行入力数のしきい値が設定されている場合。自動アクションの先行入力数が0になった場合。

KAVB2072-I実行先ホスト名で実行元ホスト名から要求されたコマンドの先行入力数が0件になりました。

JP1/Baseのコマンド実行

00003FB0

監視ノードの状態が変更された場合

KAVB7900-I 監視ノード名の状態が状態から状態に変わりました。

セントラルスコープサービス

00003FB1

監視ノードの状態変更イベントが表示数の上限に達した場合

KAVB7901-W 監視ノード（監視ノードID）の状態変更イベントの件数が上限を超えました

セントラルスコープサービス

00003FC0

リモート監視のログファイルトラップがログファイルの監視を開始できない場合

KNAN26102-E リモートログファイルトラップを開始出来ません。(詳細コード: エラー番号，監視対象ホスト名: 監視対象ホスト名，監視名: 監視名)

リモート監視機能

00003FC1

リモート監視のログファイルトラップの読み込みリトライ回数がしきい値をオーバーし，該当ログファイルの監視を停止した場合

KNAN26094-E 指定された回数リトライ処理を行いましたが，該当ログファイルの読み込みが出来ないため監視を停止します。(詳細コード:エラー番号，監視対象ホスト名:監視対象ホスト名, 監視名:監視名, ログファイル名:ログファイル名)

リモート監視機能

00003FC2

リモート監視のログファイルトラップのログファイルの状態が異常となった場合

KNAN26095-E 該当ログファイルを正しく監視することが出来ない状態になりました。(詳細コード:エラー番号，監視対象ホスト名:監視対象ホスト名, 監視名:監視名, ログファイル名:ログファイル名)

リモート監視機能

00003FC3

リモート監視のログファイルトラップが異常終了した場合

KNAN26057-E 続行できないエラーが発生したため，リモートログファイルトラップを停止します。(詳細コード: エラー番号，監視対象ホスト名: 監視対象ホスト名，監視名: 監視名)

リモート監視機能

00003FC5

リモート監視のログファイルトラップで収集したログファイルの差分データが，ログの取得上限を超えている場合

KNAN26140-W リモートログファイルトラップにおいて，監視対象のログファイルから収集したデータのサイズが制限値を超えました。前回収集日時から今回収集日時までに出力されているログは，JP1イベントとして出力されません。(監視対象ホスト名: 監視対象ホスト名，監視名: 監視名，ログファイル名: ログファイル名，前回収集日時: 前回収集日時，今回収集日時: 今回収集日時)

リモート監視機能

00003FC6

リモート監視が稼働中の監視対象ホストに対して，ホスト情報収集を実行した結果，リモート監視ログファイルトラップが停止する場合

KNAN26351-E 監視対象ホスト監視対象ホスト名のすべてのリモートログファイルトラップを停止します。(要因: 要因)

リモート監視機能

00003FC7

リネームされたログファイル（退避ファイル）が見つからない（SEQ2形式で監視対象ホストがUNIXの場合だけ）

KNAN26350-W 監視対象のログファイルの退避ファイルが見つかりません。前回収集日時から今回収集日時までに退避ファイルに出力されているログは，JP1イベントとして出力されません。(監視対象ホスト名: 監視対象ホスト名，監視名: 監視名，監視対象ログファイル名: 監視対象ログファイル名，前回収集日時: yyyy/MM/dd hh:mm:ss，今回収集日時: yyyy/MM/dd hh:mm:ss，ユーザー: ユーザー，実行したコマンドライン: 実行したコマンドライン)

リモート監視機能

00003FC8

リネームされたログファイル（退避ファイル）が見つからない（SEQ2形式で監視対象ホストがWindowsの場合だけ）

KNAN26352-W 監視対象のログファイルの退避ファイルが見つかりません。前回収集日時から今回収集日時までに退避ファイルに出力されているログは，JP1イベントとして出力されません。(監視対象ホスト名: 監視対象ホスト名，監視名: 監視名，監視対象ログファイル名: 監視対象ログファイル名，前回収集日時: yyyy/MM/dd hh:mm:ss，今回収集日時: yyyy/MM/dd hh:mm:ss，ユーザー: ユーザー)

リモート監視機能

00003FC9

リモート監視が稼働中の監視対象ホストに対して，ホスト情報収集を実行した結果，リモート監視イベントログトラップが停止する場合

KNAN26353-E 監視対象ホスト監視対象ホスト名のリモートイベントログトラップを停止します。(要因: 要因)

リモート監視機能

00003FD0

リモート監視のイベントログトラップがWindowsイベントの監視を開始できない場合

KNAN26107-E リモートイベントログトラップを開始出来ません。(詳細コード: エラー番号，監視対象ホスト名: 監視対象ホスト名)

リモート監視機能

00003FD1

リモート監視のイベントログトラップの読み込みリトライ回数がしきい値をオーバーし，該当Windowsイベントの監視を停止した場合

KNAN26028-E 指定された回数リトライ処理を行いましたが，イベントログの読み込みが出来ないためリモート監視を停止します。(詳細コード:エラー番号，監視対象ホスト名:監視対象ホスト名)

リモート監視機能

00003FD2

イベントログの収集をリトライした場合

KNAN26027-I イベントログの読み込みをリトライします。(詳細コード: エラー番号，監視対象ホスト名: 監視対象ホスト名)

リモート監視機能

00003FD3

リモート監視のイベントログトラップが異常終了した場合

KNAN26002-E 続行できないエラーが発生したため，リモートイベントログトラップを停止します。(詳細コード:エラー番号，監視対象ホスト名:監視対象ホスト名)

リモート監視機能

00003FD4

イベントログの収集リトライにより，イベントログの収集に成功した場合

KNAN26026-I イベントログの監視が可能になりました。(監視対象ホスト名: 監視対象ホスト名)

リモート監視機能

00003FD5

リモート監視のイベントログトラップで収集したイベントログの差分データが，ログの取得上限を超えている場合

KNAN26142-W リモートイベントログトラップにおいて，監視対象ホストから収集したイベントログのサイズが制限値を超えました。前回収集日時から今回収集日時までに出力されているイベントログは，JP1イベントとして出力されません。(監視対象ホスト名: 監視対象ホスト名，前回収集日時: 前回収集日時，今回収集日時: 今回収集日時)

リモート監視機能

00003FD6

リモート監視ログファイルトラップでリモート監視状態保持ファイルの書き込みに失敗した場合

KNAN26339-W ログ収集時にリモートログファイルトラップの状態の保存に失敗しました。(監視対象ホスト名: 監視対象ホスト名，監視名: 監視名)

リモート監視機能

00003FD7

リモート監視イベントログトラップでリモート監視状態保持ファイルの書き込みに失敗した場合

KNAN26340-W ログ収集時にリモートイベントログトラップの状態の保存に失敗しました。(監視対象ホスト名: 監視対象ホスト名)

リモート監視機能

00003FD8

リモート監視ログファイルトラップでリモート監視状態保持ファイルの読み込みに失敗した場合

KNAN26341-W 前回停止時のリモートログファイルトラップの状態を復元することができませんでした。(監視対象ホスト名: 監視対象ホスト名，監視名: 監視名)

リモート監視機能

00003FD9

リモート監視イベントログトラップでリモート監視状態保持ファイルの読み込みに失敗した場合

KNAN26342-W 前回停止時のリモートイベントログトラップの状態を復元することができませんでした。(監視対象ホスト名: 監視対象ホスト名)

リモート監視機能

00003FDA

リモート監視ログファイルトラップで監視対象のログが変更されたことによって，リモート監視の起動（warmスタート）でリモート監視の停止中に出力されたログを収集できなかった場合

KNAN26343-W 前回停止時のリモートログファイルトラップの状態を復元して監視できない状態のため，前回停止時のリモートログファイルトラップの状態を復元しませんでした。(詳細情報: 詳細情報，監視対象ホスト名: 監視対象ホスト名，監視名: 監視名)

リモート監視機能

00003FDB

リモート監視ログファイルトラップでリモート監視状態保持ファイルの書き込みの失敗から回復した場合

KNAN26345-I ログ収集時に発生していたリモートログファイルトラップの状態の保存のエラーが回復しました。(監視対象ホスト名: 監視対象ホスト名，監視名: 監視名)

リモート監視機能

00003FDC

リモート監視イベントログトラップでリモート監視状態保持ファイルの書き込みの失敗から回復した場合

KNAN26346-I ログ収集時に発生していたリモートイベントログトラップの状態の保存のエラーが回復しました。(監視対象ホスト名: 監視対象ホスト名)

リモート監視機能

ACTDEFパラメーターに指定されている値※6

APのログファイルのレコードを検知した場合

ログファイルの1行分のデータの内容

リモート監視機能

00003A71またはリモート監視イベントログトラップ動作定義ファイルのfilterブロックに指定されたイベントIDの詳細※7

Windowsイベントのログメッセージを検知した場合

イベントログのメッセージ

リモート監視機能

00003F90※8

プロセスが異常終了した場合

KAVB3737-E コンポーネント名 の管理対象プロセス名は異常終了しました

JP1/IM - Managerのプロセス管理

00003F91※8

プロセス起動時にタイムアウトした場合

KAVB3613-W コンポーネント名 の管理対象プロセス名の起動がタイムアウトしました. 処理を継続します

JP1/IM - Managerのプロセス管理

00003F92※8

異常終了したプロセスが再起動完了した場合

KAVB3616-I コンポーネント名 の管理対象プロセス名の再起動が完了しました

JP1/IM - Managerのプロセス管理

00006400※9

表示メッセージ変更後のイベントを発行した場合

表示メッセージ変更機能によりメッセージ変更した場合，変更後のメッセージを設定する。

メッセージを変更していない場合，オリジナルイベントのメッセージテキストを設定する。

表示メッセージ変更後のイベントを発行する

00003FE0

対処アクションを開始した場合

KAJY22023-I 対処アクションを開始します。(提案ID : 提案ID, JP1ユーザー名 : JP1ユーザー名, IM管理ノード : ツリーのSID, アクション情報 : アクション情報)

JP1/IM - Manager（インテリジェント統合管理基盤）の提案機能

00003FE1

対処アクションを終了した場合

KAJY22024-I 対処アクションが完了しました。(提案ID : 提案ID, JP1ユーザー名 : JP1ユーザー名, IM管理ノード : ツリーのSID, アクション情報 : アクション情報)

JP1/IM - Manager（インテリジェント統合管理基盤）の提案機能

00003FE2

対処アクションの実行に失敗した場合

KAJY22025-E 対処アクションの実行に失敗しました。(提案ID : 提案ID, JP1ユーザー名 : JP1ユーザー名, 要因 : 要因, IM管理ノード : ツリーのSID, アクション情報 : アクション情報)

JP1/IM - Manager（インテリジェント統合管理基盤）の提案機能

00003FF0

自動対処アクションの状態が「実行制御送信中」になった場合

KAJY63025-I イベント (統合監視DB内通し番号=統合監視DB内通し番号) に対する対処アクションを対処アクション実行先を管理するJP1/IM-Managerに送信しました

対処アクションの自動実行機能

00003FF1

自動対処アクションの状態が「キューイング」になった場合

KAJY63026-I イベント (統合監視DB内通し番号=統合監視DB内通し番号) に対する対処アクションを統合エージェント管理基盤に要求しました。

対処アクションの自動実行機能

00003FF2

自動対処アクションの状態が「終了」になった場合

KAJY63027-I イベント (統合監視DB内通し番号=統合監視DB内通し番号) に対する対処アクションの実行が終了しました。(終了コード=終了コード)

対処アクションの自動実行機能

00003FF3

自動対処アクションの状態が「実行不可」，「通信失敗」，または「実行失敗」になった場合

KAJY63028-E イベント(統合監視DB内通し番号=統合監視DB内通し番号)に対する対処アクションが異常終了しました。

対処アクションの自動実行機能

00003FF4

対処アクション通知イベントに対する自動対処アクションの状態が「実行制御送信中」になった場合

KAJY63029-I 対処アクション状態通知イベント (統合監視DB内通し番号=統合監視DB内通し番号) に対する対処アクションを対処アクション実行先を管理するJP1/IM-Managerに送信しました

対処アクションの自動実行機能

00003FF5

対処アクション通知イベントに対する自動対処アクションの状態が「キューイング」になった場合

KAJY63030-I 対処アクション状態通知イベント (統合監視DB内通し番号=統合監視DB内通し番号) に対する対処アクションを統合エージェント管理基盤に要求しました。

対処アクションの自動実行機能

00003FF6

対処アクション通知イベントに対する自動対処アクションの状態が「終了」になった場合

KAJY63031-I 対処アクション状態通知イベント (統合監視DB内通し番号=統合監視DB内通し番号) に対する対処アクションの実行が終了しました。(終了コード=終了コード)

対処アクションの自動実行機能

00003FF7

対処アクション通知イベントに対する自動対処アクションの状態が「実行不可」，「通信失敗」，または「実行失敗」になった場合

KAJY63032-E 対処アクション状態通知イベント(統合監視DB内通し番号=統合監視DB内通し番号)に対する対処アクションが異常終了しました。

対処アクションの自動実行機能

00003FF8

対処アクション通知イベントの発行失敗（キューイング）

KAJY63033-W 対処アクションの実行を要求しましたが，対処アクション結果管理DBに対処アクションの情報が存在しないため対処アクション状態通知イベントが発行できません。(詳細情報 : 詳細情報)

対処アクションの自動実行機能

00003FF9

対処アクション通知イベントの発行失敗（実行終了）

KAJY63034-W 対処アクションの実行が終了しましたが，対処アクション結果管理DBにアクションの情報が存在しないため対処アクション状態通知イベントが発行できません。(詳細情報 : 詳細情報)

対処アクションの自動実行機能

00003FFA

対処アクション通知イベントの発行失敗（実行失敗）

KAJY63035-E 対処アクションが異常終了しましたが，対処アクション結果管理DBにアクションの情報が存在しないためアクション状態通知イベントが発行できません。(詳細情報 : 詳細情報)

対処アクションの自動実行機能

00003FFB

自動対処アクション定義を読み込み，対処アクションの自動実行機能が稼働状態になった場合

KAJY63023-I 自動対処アクション定義を読み込み対処アクション自動実行機能を稼働状態にしました。次に受信したイベントから読み込んだ定義で処理されます。（定義数：有効な定義数 / 定義内の全定義数, 最後に受信したイベント：到着時刻=最後に処理したイベントの到着時刻 (YYYY/MM/DD HH:MM:SS), 統合監視DB内通し番号=最後に処理したイベントの統合監視DB内通し番号）

対処アクションの自動実行機能

3F80

IM管理ノード関連情報の生成を終了した場合

KAJY02073-I IM管理ノード関連情報の生成が正常終了しました

IM管理ノード関連情報の生成

3F81

IM管理ノード関連情報の生成に失敗した場合

KAJY02074-E IM管理ノード関連情報の生成に失敗しました (戻り値 : 戻り値, 詳細 : 詳細)

IM管理ノード関連情報の生成

3F82

IM管理ノード関連情報の反映を終了した場合

KAJY02075-I IM管理ノード関連情報の反映が正常終了しました

IM管理ノード関連情報の反映

3F83

IM管理ノード関連情報の反映に失敗した場合

KAJY02076-E IM管理ノード関連情報の反映に失敗しました (戻り値 : 戻り値, 詳細 : 詳細)

IM管理ノード関連情報の反映

注※1　これらのイベントはダミーイベントです。次の制限事項があります。

［イベントコンソール］画面のイベント検索で検索できません。

［統合オペレーション・ビューアー］画面では表示できません。

イベント検索REST APIでは検索できません。

イベントの詳細を表示した場合，JP1イベントの基本属性および拡張属性は表示されません。

このイベントに自動アクションを設定しても，アクションは実行されません。

このイベントにイベント情報マッピングを定義しても，マッピングされません。

このイベントは，モニター起動の対象外です。

このイベントは，イベント取得フィルターのフィルター対象外です。

このイベントは，相関イベントの発行処理の対象外です。

このイベントは，イベントDBに登録されません。そのため，JP1/IM - Managerを再起動すると［イベントコンソール］画面に表示されなくなります。

このイベントの対処状況を変更しても，ほかのJP1/IM - Viewに反映されません。

注※2　JP1/Baseのイベントサービス（jevservice）の回復を検知した場合のメッセージは，KAVB8063-Iです。

注※3　これらのイベントには，次の制限事項があります。

このイベントに自動アクションを設定しても，アクションは実行されません。

注※4　これらのイベントには，次の制限事項があります。

このイベントは，イベント取得フィルターのフィルター対象外です。

注※5　JP1/Baseのコマンド実行が発行するJP1イベントです。JP1イベントの詳細については，マニュアル「JP1/Base 運用ガイド」のJP1イベントを説明している章を参照してください。

注※6　リモート監視機能ではなく，JP1/Baseのログファイルトラップが発行するJP1イベントについては，マニュアル「JP1/Base 運用ガイド」のJP1イベントを説明している章を参照してください。

注※7　リモート監視機能ではなく，JP1/Baseのイベントログトラップが発行するJP1イベントについては，マニュアル「JP1/Base 運用ガイド」のJP1イベントを説明している章を参照してください。

注※8　プロセスの異常時にJP1イベントを発行させる設定をした場合にだけ発行されます。JP1イベントを発行させたい場合は，IMパラメーター定義ファイルを編集したあと，jbssetcnfコマンドを実行してください。定義ファイルの詳細については「IMパラメーター定義ファイル（jp1co_param_V7.conf）」（2.　定義ファイル）を，設定手順についてはマニュアル「JP1/Integrated Management 3 - Manager 構築ガイド」の「1.19.6　JP1/IM - Managerの障害に備えた設定（Windowsの場合）」，「2.18.10　JP1/IM - Managerの障害に備えた設定（UNIXの場合）」を参照してください。

注※9　「オリジナルイベント」とは，JP1/IM - ManagerがJP1/Baseから取得したイベントを指します。

3.2.2　JP1/IM - Managerが出力するJP1イベントの詳細

JP1イベントの詳細について説明します。

(1)　イベントID：00002010の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

アクション実行サービスのプロセスID

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元グループID

GROUPID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

Windowsの場合

空白

UNIXの場合

root

発行元イベントサーバ名

SOURCESERVER

発行元イベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB4400-E イベント(EVENT_ID=イベントID，SEQNO=イベントDB内通し番号)に対するアクション(実行ホスト=アクション実行ホスト，アクション通し番号=アクション通し番号)の実行時間がアクション遅延監視時間を超過しました。以降アクション遅延監視への通知機能の抑止を解除するまで，遅延監視の通知を実行しません

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/JCAMAIN

オブジェクトタイプ

OBJECT_TYPE

ACTION

オブジェクト名

OBJECT_NAME

JCAMAIN

オブジェクトID

OBJECT_ID

アクションの契機となったイベントのイベントDB内通し番号

ユーザー名

USER_NAME

アクションを実行するJP1ユーザー

事象種別

OCCURRENCE

NOTICE

固有情報

アクション実行ホスト

EXECHOST

アクション実行ホスト名

アクション状態

ACTION_STATUS

アクションの状態

実行コマンド

EXECCMD

実行要求したコマンド

環境変数ファイル

EXECENV

実行時に使用する環境変数ファイル名

アクション通し番号

ACTION_SEQNO

アクション通し番号

アクション契機イベントID

SRC_EVENT_ID

アクションの契機となったイベントのイベントID

投入時刻

SEND_TIME

アクションの実行要求を送信した時刻

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(2)　イベントID：00002011の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

アクション実行サービスのプロセスID

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元グループID

GROUPID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

Windowsの場合

空白

UNIXの場合

root

発行元イベントサーバ名

SOURCESERVER

発行元イベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB4402-E イベント(EVENT_ID=イベントID，SEQNO=イベントDB内通し番号)に対するアクション(実行ホスト=アクション実行ホスト，アクション通し番号=アクション通し番号)の状態が異常状態になりました。以降アクション状態監視への通知機能の抑止を解除するまで，状態監視の通知を実行しません

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/JCAMAIN

オブジェクトタイプ

OBJECT_TYPE

ACTION

オブジェクト名

OBJECT_NAME

JCAMAIN

オブジェクトID

OBJECT_ID

アクションの契機となったイベントのイベントDB内通し番号

ユーザー名

USER_NAME

アクションを実行するJP1ユーザー

終了時刻

END_TIME

アクションが異常終了した時刻

事象種別

OCCURRENCE

NOTICE

固有情報

アクション実行ホスト

EXECHOST

アクション実行ホスト名

アクション状態

ACTION_STATUS

アクションの状態

実行コマンド

EXECCMD

実行要求したコマンド

環境変数ファイル

EXECENV

実行時に使用する環境変数ファイル名

アクション通し番号

ACTION_SEQNO

アクション通し番号

アクション契機イベントID

SRC_EVENT_ID

アクションの契機となったイベントのイベントID

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(3)　イベントID：00002012の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

発行元イベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB8060-E 機能名 の異常を検知しました(ホスト名=ホスト名，プロセス名=プロセス名，プロセスID=プロセスID)：保守情報

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/HEALTHCHECK

オブジェクトタイプ

OBJECT_TYPE

JCOHC

オブジェクト名

OBJECT_NAME

異常が検知された機能名

事象種別

OCCURRENCE

NOTICE

固有情報

ホスト名

HOST_NAME

ホスト名

プロセス名

PROCESS_NAME

プロセス名

プロセスID

PROCESS_ID

プロセスID

（凡例）

−：なし

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(4)　イベントID：00002013の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

発行元イベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB8062-E 機能名 の異常を検知しました(ホスト名=ホスト名，プロセス名=プロセス名)：保守情報

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/HEALTHCHECK

オブジェクトタイプ

OBJECT_TYPE

JCOHC

オブジェクト名

OBJECT_NAME

異常が検知された機能名

事象種別

OCCURRENCE

NOTICE

固有情報

ホスト名

HOST_NAME

ホスト名

プロセス名

PROCESS_NAME

プロセス名

プロセスID

PROCESS_ID

プロセスID

（凡例）

−：なし

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(5)　イベントID：00002014の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※1

発行元グループID

GROUPID

-1〜65,535※1

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

発行元イベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB8061-I 機能名 が回復しました(ホスト名=ホスト名，プロセス名=プロセス名，プロセスID=プロセスID)：保守情報※2

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/HEALTHCHECK

オブジェクトタイプ

OBJECT_TYPE

JCOHC

オブジェクト名

OBJECT_NAME

回復された機能名

事象種別

OCCURRENCE

NOTICE

固有情報

ホスト名

HOST_NAME

ホスト名

プロセス名

PROCESS_NAME

プロセス名

プロセスID

PROCESS_ID

プロセスID

（凡例）

−：なし

注※1　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

注※2　JP1/Baseのイベントサービス（jevservice）の回復を検知した場合のメッセージは，KAVB8063-Iです。

(6)　イベントID：00002015の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

発行元イベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB4401-I アクション遅延監視への通知機能の抑止を解除しました

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/JCAMAIN

オブジェクトタイプ

OBJECT_TYPE

ACTION

オブジェクト名

OBJECT_NAME

JCAMAIN

事象種別

OCCURRENCE

NOTICE

（凡例）

−：なし

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(7)　イベントID：00002016の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

発行元イベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB4403-I アクション状態監視への通知機能の抑止を解除しました

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/JCAMAIN

オブジェクトタイプ

OBJECT_TYPE

ACTION

オブジェクト名

OBJECT_NAME

JCAMAIN

事象種別

OCCURRENCE

NOTICE

（凡例）

−：なし

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(8)　イベントID：00002020の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

アクション実行サービスのプロセスID

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元グループID

GROUPID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

Windowsの場合

空白

UNIXの場合

root

発行元イベントサーバ名

SOURCESERVER

発行元イベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB4404-E アクション(アクション通し番号=アクション通し番号)の実行時間がアクション遅延監視時間を超過しましたが，アクション情報ファイルにアクションの情報が存在しないためアクション遅延通知イベントを発行できませんでした。以降アクション遅延監視への通知機能の抑止を解除するまで，遅延監視の通知を実行しません

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/JCAMAIN

オブジェクトタイプ

OBJECT_TYPE

ACTION

オブジェクト名

OBJECT_NAME

JCAMAIN

事象種別

OCCURRENCE

NOTICE

固有情報

アクション通し番号

ACTION_SEQNO

アクション通し番号

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(9)　イベントID：00002021の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

アクション実行サービスのプロセスID

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元グループID

GROUPID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

Windowsの場合

空白

UNIXの場合

root

発行元イベントサーバ名

SOURCESERVER

発行元イベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB4405-E アクションの状態が異常状態になりましたが，アクション情報ファイルにアクションの情報が存在しないためアクション異常状態通知イベントを発行できませんでした。以降アクション状態監視への通知機能の抑止を解除するまで，状態監視の通知を実行しません：保守情報

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/JCAMAIN

オブジェクトタイプ

OBJECT_TYPE

ACTION

オブジェクト名

OBJECT_NAME

JCAMAIN

ユーザー名

USER_NAME

アクションを実行するJP1ユーザー

終了時刻

END_TIME

アクションが異常終了した時刻

事象種別

OCCURRENCE

NOTICE

固有情報

アクション実行ホスト

EXECHOST

アクション通し番号

アクション状態

ACTION_STATUS

アクションの状態

実行コマンド

EXECCMD

実行要求したコマンド

環境変数ファイル名

EXECENV

実行時に使用する環境変数ファイル名

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(10)　イベントID：000020A0の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

アクション実行サービスのプロセスID

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元グループID

GROUPID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

Windowsの場合

空白

UNIXの場合

root

発行元イベントサーバ名

SOURCESERVER

発行元イベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB4054-E 自動アクション処理が異常終了しました (ホスト名 : ホスト名)

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/JCAMAIN

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

JCAMAIN

事象種別

OCCURRENCE

TERMINATE

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(11)　イベントID：000020A1の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

アクション実行サービスのプロセスID

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元グループID

GROUPID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

Windowsの場合

空白

UNIXの場合

root

発行元イベントサーバ名

SOURCESERVER

自動アクションが起動した論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB4050-I 自動アクション処理を開始します

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/JCAMAIN

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

JCAMAIN

事象種別

OCCURRENCE

START

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(12)　イベントID：000020A2の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

アクション実行サービスのプロセスID

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元グループID

GROUPID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

Windowsの場合

空白

UNIXの場合

root

発行元イベントサーバ名

SOURCESERVER

自動アクションが動作していた論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB4051-I 自動アクション処理を終了します

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/JCAMAIN

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

JCAMAIN

事象種別

OCCURRENCE

TERMINATE

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(13)　イベントID：000020A3の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※1

発行元グループID

GROUPID

-1〜65,535※1

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

自動アクションが動作している論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB4055-I アクション定義ファイルを読み込み，自動アクション機能を稼働状態にしました。次に受信したイベントから，読み込んだ定義で処理されます (定義数：有効な定義数/全定義数，最後に受信したイベント：到着時刻=最後に処理したイベントの到着時刻 (YYYY/MM/DD hh:mm:ss), イベントDB内通し番号=最後に処理したイベントのイベントDB内通し番号)※2

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVFLOW

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EVFLOW

事象種別

OCCURRENCE

RUN

注※1　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

注※2　自動アクションがイベントを受信していない場合は，「YYYY/MM/DD hh:mm:ss」および「最後に処理したイベントのイベントDB内通し番号」には「--」が表示されます。

(14)　イベントID：000020A4の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※1

発行元グループID

GROUPID

-1〜65,535※1

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

自動アクションが動作している論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB4056-I 自動アクションを休止しました。次に受信したイベントから，自動アクションが実行されません (最後に受信したイベント：到着時刻=最後に処理したイベントの到着時刻 (YYYY/MM/DD hh:mm:ss), イベントDB内通し番号=最後に処理したイベントのイベントDB内通し番号)※2

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVFLOW

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EVFLOW

事象種別

OCCURRENCE

STANDBY

注※1　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

注※2　自動アクションがイベントを受信していない場合は，「YYYY/MM/DD hh:mm:ss」および「最後に処理したイベントのイベントDB内通し番号」には「--」が表示されます。

(15)　イベントID：000020A5の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

アクション実行サービスのプロセスID

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元グループID

GROUPID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

Windowsの場合

空白

UNIXの場合

root

発行元イベントサーバ名

SOURCESERVER

問題のあった自動アクションプロセスが動作していた論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB4909-E ロケール情報の設定に失敗しました

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/JCAMAIN

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

JCAMAIN

事象種別

OCCURRENCE

ERROR

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(16)　イベントID：000020A6の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

イベント基盤サービスのプロセスID

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元グループID

GROUPID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

Windowsの場合

空白

UNIXの場合

root

発行元イベントサーバ名

SOURCESERVER

問題のあったイベント基盤サービスプロセスが動作していた論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB4909-E ロケール情報の設定に失敗しました

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVFLOW

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EVFLOW

事象種別

OCCURRENCE

ERROR

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(17)　イベントID：000020E0の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

アクション実行サービスのプロセスID

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元グループID

GROUPID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

Windowsの場合

空白

UNIXの場合

root

発行元イベントサーバ名

SOURCESERVER

自動アクションが動作している論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB4430-I イベント (EVENT_ID=イベントID, SEQNO=イベントDB内通し番号) に対するアクションの実行を要求しました

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/JCAMAIN

オブジェクトタイプ

OBJECT_TYPE

ACTION

オブジェクト名

OBJECT_NAME

JCAMAIN

オブジェクトID

OBJECT_ID

アクションの契機となったイベントのイベントDB内通し番号

ユーザー名

USER_NAME

アクションを実行するJP1ユーザー

開始時刻

START_TIME

アクションの実行要求が完了した時刻

事象種別

OCCURRENCE

NOTICE

固有情報

アクション実行ホスト

EXECHOST

アクション実行ホスト名

アクション状態

ACTION_STATUS

アクションの状態「RUNNING」

実行コマンド

EXECCMD

実行要求したコマンド

環境変数ファイル名

EXECENV

実行時に使用する環境変数ファイル名

（凡例）

−：なし

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(18)　イベントID：000020E1の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

アクション実行サービスのプロセスID

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元グループID

GROUPID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

Windowsの場合

空白

UNIXの場合

root

発行元イベントサーバ名

SOURCESERVER

自動アクションが動作している論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB4431-I イベント (EVENT_ID=イベントID, SEQNO=イベントDB内通し番号) に対するアクションの実行が終了しました (終了コード=終了コード)

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/JCAMAIN

オブジェクトタイプ

OBJECT_TYPE

ACTION

オブジェクト名

OBJECT_NAME

JCAMAIN

オブジェクトID

OBJECT_ID

アクションの契機となったイベントのイベントDB内通し番号

ユーザー名

USER_NAME

アクションを実行するJP1ユーザー

終了時刻

END_TIME

アクションの実行要求が完了した時刻

終了コード

RESULT_CODE

アクションの終了コード

事象種別

OCCURRENCE

NOTICE

固有情報

アクション実行ホスト

EXECHOST

アクション実行ホスト名

アクション状態

ACTION_STATUS

アクションの状態「ENDED」

実行コマンド

EXECCMD

実行要求したコマンド

環境変数ファイル名

EXECENV

実行時に使用する環境変数ファイル名

（凡例）

−：なし

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(19)　イベントID：000020E2の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

アクション実行サービスのプロセスID

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元グループID

GROUPID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

Windowsの場合

空白

UNIXの場合

root

発行元イベントサーバ名

SOURCESERVER

自動アクションが動作している論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB4432-E イベント (EVENT_ID=イベントID, SEQNO=イベントDB内通し番号) に対するアクションが自動アクションまたはコマンド制御で異常終了しました

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/JCAMAIN

オブジェクトタイプ

OBJECT_TYPE

ACTION

オブジェクト名

OBJECT_NAME

JCAMAIN

オブジェクトID

OBJECT_ID

アクションの契機となったイベントのイベントDB内通し番号

ユーザー名

USER_NAME

アクションを実行するJP1ユーザー

終了時刻

END_TIME

アクションが異常終了した時刻

事象種別

OCCURRENCE

NOTICE

固有情報

アクション実行ホスト

EXECHOST

アクション実行ホスト名

アクション状態

ACTION_STATUS

アクションの状態「ERROR」または「FAIL」

異常終了詳細情報

ERROR_INFO

異常の内容を示すメッセージ

実行コマンド

EXECCMD

実行要求したコマンド

環境変数ファイル名

EXECENV

実行時に使用する環境変数ファイル名

エラー要因

EXECERR

異常時の保守情報

（凡例）

−：なし

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(20)　イベントID：000020E3の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

アクション実行サービスのプロセスID

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元グループID

GROUPID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

Windowsの場合

空白

UNIXの場合

root

発行元イベントサーバ名

SOURCESERVER

自動アクションが動作している論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB4433-I アクション状態通知イベント (EVENT_ID=イベントID, SEQNO=イベントDB内通し番号) に対するアクションの実行を要求しました

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/JCAMAIN

オブジェクトタイプ

OBJECT_TYPE

ACTION

オブジェクト名

OBJECT_NAME

JCAMAIN

オブジェクトID

OBJECT_ID

アクションの契機となったイベントのイベントDB内通し番号

ユーザー名

USER_NAME

アクションを実行するJP1ユーザー

開始時刻

START_TIME

アクションの実行要求が完了した時刻

事象種別

OCCURRENCE

NOTICE

固有情報

アクション実行ホスト

EXECHOST

アクション実行ホスト名

アクション状態

ACTION_STATUS

アクションの状態「RUNNING」

実行コマンド

EXECCMD

実行要求したコマンド

環境変数ファイル名

EXECENV

実行時に使用する環境変数ファイル名

（凡例）

−：なし

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(21)　イベントID：000020E4の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

アクション実行サービスのプロセスID

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元グループID

GROUPID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

Windowsの場合

空白

UNIXの場合

root

発行元イベントサーバ名

SOURCESERVER

自動アクションが動作している論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB4434-I アクション状態通知イベント (EVENT_ID=イベントID, SEQNO=イベントDB内通し番号) に対するアクションの実行が終了しました (終了コード=終了コード)

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/JCAMAIN

オブジェクトタイプ

OBJECT_TYPE

ACTION

オブジェクト名

OBJECT_NAME

JCAMAIN

オブジェクトID

OBJECT_ID

アクションの契機となったイベントのイベントDB内通し番号

ユーザー名

USER_NAME

アクションを実行するJP1ユーザー

終了時刻

END_TIME

アクションの実行要求が完了した時刻

終了コード

RESULT_CODE

アクションの終了コード

事象種別

OCCURRENCE

NOTICE

固有情報

アクション実行ホスト

EXECHOST

アクション実行ホスト名

アクション状態

ACTION_STATUS

アクションの状態「ENDED」

実行コマンド

EXECCMD

実行要求したコマンド

環境変数ファイル名

EXECENV

実行時に使用する環境変数ファイル名

（凡例）

−：なし

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(22)　イベントID：000020E5の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

アクション実行サービスのプロセスID

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元グループID

GROUPID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

Windowsの場合

空白

UNIXの場合

root

発行元イベントサーバ名

SOURCESERVER

自動アクションが動作している論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB4435-E アクション状態通知イベント (EVENT_ID=イベントID, SEQNO=イベントDB内通し番号) に対するアクションが自動アクションまたはコマンド制御内部において異常終了しました

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/JCAMAIN

オブジェクトタイプ

OBJECT_TYPE

ACTION

オブジェクト名

OBJECT_NAME

JCAMAIN

オブジェクトID

OBJECT_ID

アクションの契機となったイベントのイベントDB内通し番号

ユーザー名

USER_NAME

アクションを実行するJP1ユーザー

終了時刻

END_TIME

アクションが異常終了した時刻

事象種別

OCCURRENCE

NOTICE

固有情報

アクション実行ホスト

EXECHOST

アクション実行ホスト名

アクション状態

ACTION_STATUS

アクションの状態「ERROR」または「FAIL」

異常終了詳細情報

ERROR_INFO

異常の内容を示すメッセージ

実行コマンド

EXECCMD

実行要求したコマンド

環境変数ファイル名

EXECENV

実行時に使用する環境変数ファイル名

エラー要因

EXECERR

異常時の保守情報

（凡例）

−：なし

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(23)　イベントID：000020E6の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

アクション実行サービスのプロセスID

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元グループID

GROUPID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

Windowsの場合

空白

UNIXの場合

root

発行元イベントサーバ名

SOURCESERVER

自動アクションが動作している論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB4436-W アクションの実行を要求しましたが，アクション情報ファイルにアクションの情報が存在しないためアクション状態通知イベントが発行できません:保守情報

拡張属性

共通情報

重大度

SEVERITY

Warning

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/JCAMAIN

オブジェクトタイプ

OBJECT_TYPE

ACTION

オブジェクト名

OBJECT_NAME

JCAMAIN

ユーザー名

USER_NAME

アクションを実行するJP1ユーザー

開始時刻

START_TIME

アクションの実行要求が完了した時刻

事象種別

OCCURRENCE

NOTICE

固有情報

アクション実行ホスト

EXECHOST

アクション実行ホスト名

アクション状態

ACTION_STATUS

アクションの状態「RUNNING」

実行コマンド

EXECCMD

実行要求したコマンド

環境変数ファイル名

EXECENV

実行時に使用する環境変数ファイル名

（凡例）

−：なし

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(24)　イベントID：000020E7の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

アクション実行サービスのプロセスID

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元グループID

GROUPID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

Windowsの場合

空白

UNIXの場合

root

発行元イベントサーバ名

SOURCESERVER

自動アクションが動作している論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB4437-W アクションの実行が終了しましたが，アクション情報ファイルにアクションの情報が存在しないためアクション状態通知イベントが発行できません:保守情報

拡張属性

共通情報

重大度

SEVERITY

Warning

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/JCAMAIN

オブジェクトタイプ

OBJECT_TYPE

ACTION

オブジェクト名

OBJECT_NAME

JCAMAIN

終了時刻

END_TIME

アクションが実行終了した時刻

事象種別

OCCURRENCE

NOTICE

固有情報

アクション実行ホスト

EXECHOST

アクション実行ホスト名

アクション状態

ACTION_STATUS

アクションの状態「ENDED」

実行コマンド

EXECCMD

実行要求したコマンド

（凡例）

−：なし

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(25)　イベントID：000020E8の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

アクション実行サービスのプロセスID

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元グループID

GROUPID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

Windowsの場合

空白

UNIXの場合

root

発行元イベントサーバ名

SOURCESERVER

自動アクションが動作している論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB4438-E アクションが自動アクションまたはコマンド制御において異常終了しましたが，アクション情報ファイルにアクションの情報が存在しないためアクション状態通知イベントが発行できません：保守情報

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/JCAMAIN

オブジェクトタイプ

OBJECT_TYPE

ACTION

オブジェクト名

OBJECT_NAME

JCAMAIN

終了時刻

END_TIME

アクションが異常終了した時刻

事象種別

OCCURRENCE

NOTICE

固有情報

アクション実行ホスト

EXECHOST

アクション実行ホスト名

アクション状態

ACTION_STATUS

アクションの状態「ERROR」または「FAIL」

異常終了詳細情報

ERROR_INFO

異常の内容を示すメッセージ

実行コマンド

EXECCMD

実行要求したコマンド

（凡例）

−：なし

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(26)　イベントID：00003F01の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

-1

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

取得できるイベントの到着時刻

発行元ユーザーID

USERID

0

発行元グループID

GROUPID

0

発行元ユーザー名

USERNAME

空白

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

イベントが発行されたイベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

0

メッセージ

MESSAGE

KAVB1513-W 表示できなかったイベントがあります。

表示できなかったイベントを確認するには，［イベント検索条件設定］画面を表示し，次の検索条件を指定し検索してください。

（１） 検索ホスト名として，接続中のホスト名を指定する

（２） 登録時刻として，このイベントの前または後に表示されているイベントの登録時刻を指定する

このイベントが頻繁に表示される場合は，次の条件に該当していないか確認し，必要があれば設定値を見直してください。

（１）［ユーザー環境設定］画面で設定されている，「表示内容の自動更新」の「更新間隔」の設定値が長い

（２）［ユーザー環境設定］画面で設定されている，「更新時のイベント取得件数」の設定値が小さい

（３）［システム環境設定］画面で設定されている，マネージャーの「イベントバッファー」の設定値が小さい

拡張属性

共通情報

重大度

SEVERITY

Warning

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVENTCONSOLE

オブジェクトタイプ

OBJECT_TYPE

EVENT

オブジェクト名

OBJECT_NAME

¥SYSTEM¥ALL

事象種別

OCCURRENCE

LOST

(27)　イベントID：00003F02の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

-1

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

取得できるイベントの到着時刻

発行元ユーザーID

USERID

0

発行元グループID

GROUPID

0

発行元ユーザー名

USERNAME

空白

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

イベントが発行されたイベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

0

メッセージ

MESSAGE

KAVB1540-W 表示できなかったイベントがあります。(ページ:ページ)

表示できなかったイベントを確認するには，［イベント検索条件設定］画面を表示し，以下の検索条件を指定してください。

（１）検索ホスト名として，接続中のホスト名を指定する

（２）登録時刻として，このイベントの前または後に表示されているイベントの登録時刻を指定する

このイベントが頻繁に表示される場合は，以下の条件に該当していないか確認し，必要があれば設定値を見直してください。

（１）［ユーザー環境設定］画面で設定されている，「表示内容の自動更新」の「更新間隔」の設定値が長い

（２）［ユーザー環境設定］画面で設定されている，「更新時のイベント取得件数」の設定値が小さい

（３）［システム環境設定］画面で設定されている，マネージャーの「イベントバッファー」の設定値が小さい

拡張属性

共通情報

重大度

SEVERITY

Warning

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVENTCONSOLE

オブジェクトタイプ

OBJECT_TYPE

EVENT

オブジェクト名

OBJECT_NAME

¥SYSTEM¥ALL

事象種別

OCCURRENCE

LOST

(28)　イベントID：00003F03の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

-1

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

エラーの発生時刻

発行元ユーザーID

USERID

0

発行元グループID

GROUPID

0

発行元ユーザー名

USERNAME

空白

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

イベントが発行されたイベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

0

メッセージ

MESSAGE

KAVB1516-W イベントサービスからイベントを取得するときにエラーが発生しました。

システムプロファイルに指定された回数リトライしましたが，回復しません。このため，以降のイベントは表示されません。

イベントサービスが起動しているか確認してください。起動していない場合は，イベントサービス起動後，マネージャーを再起動して，回復してください

拡張属性

共通情報

重大度

SEVERITY

Warning

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVENTCONSOLE

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

イベントサービス

事象種別

OCCURRENCE

DISCONNECT

(29)　イベントID：00003F04の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

-1

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

エラーの発生時刻

発行元ユーザーID

USERID

0

発行元グループID

GROUPID

0

発行元ユーザー名

USERNAME

空白

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

イベントが発行されたイベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

0

メッセージ

MESSAGE

KAVB1527-E 検索ホストで受け付けられない条件が含まれています

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVENTCONSOLE

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

イベントサービス

事象種別

OCCURRENCE

PARAM_ERROR

(30)　イベントID：00003F05の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

-1

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

エラーの発生時刻

発行元ユーザーID

USERID

0

発行元グループID

GROUPID

0

発行元ユーザー名

USERNAME

空白

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

イベントが発行されたイベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

0

メッセージ

MESSAGE

KAVB0246-E フィルター条件の最大長（最大長）を超えて指定しています

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVENTCONSOLE

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

イベントサービス

事象種別

OCCURRENCE

OVER_LENGTH

(31)　イベントID：00003F06の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

-1

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

エラーの発生時刻

発行元ユーザーID

USERID

0

発行元グループID

GROUPID

0

発行元ユーザー名

USERNAME

空白

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

イベントが発行されたイベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

0

メッセージ

MESSAGE

KAVB0248-E 正規表現の指定が正しくありません

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVENTCONSOLE

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

イベントサービスまたはIMデータベース

事象種別

OCCURRENCE

REGEXP_ERROR

(32)　イベントID：00003F07の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

-1

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

エラーの発生時刻

発行元ユーザーID

USERID

0

発行元グループID

GROUPID

0

発行元ユーザー名

USERNAME

空白

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

イベントが発行されたイベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

0

発行元イベントサーバ名

SOURCESERVER

イベントが発行されたイベントサーバ名

メッセージ

MESSAGE

KAVB4764-W イベントサービスからイベントを取得するときにエラーが発生しました。

イベントサービスが起動しているか確認してください。起動していない場合はイベントサービスを起動してください。

拡張属性

共通情報

重大度

SEVERITY

Warning

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVFLOW

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

イベントサービス

事象種別

OCCURRENCE

DISCONNECT

(33)　イベントID：00003F08の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

-1

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

エラーの発生時刻

発行元ユーザーID

USERID

0

発行元グループID

GROUPID

0

発行元ユーザー名

USERNAME

空白

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

イベントが発行されたイベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

0

メッセージ

MESSAGE

KAVB0251-E 検索ホストのJP1/Baseが除外条件に対応していないため，指定された条件では検索できません

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVENTCONSOLE

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

イベントサービス

事象種別

OCCURRENCE

EXCLUDE_ERROR

(34)　イベントID：00003F11の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

発生時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※1

発行元グループID

GROUPID

-1〜65,535※1

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

イベントが発行されたイベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB1577-I 対処状況の操作が行われました(操作ユーザー:JP1ユーザー※2,イベントID:イベントID,対処前状況:対処前状況※3,対処後状況:対処後状況※3)

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVENTCONSOLE

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EVTCON

事象種別

OCCURRENCE

PROCESS

固有情報

対処イベントのイベントDB内通し番号

PROCESSUPDATE_SEQNO

イベントDB内通し番号（対処状況を変更したJP1イベントのイベントDB内通し番号：10進数）

対処イベントの発行元イベントDB内通し番号

PROCESSUPDATE_ORIGINALSEQNO

発行元イベントDB内通し番号（対処状況を変更したJP1イベントの発行元イベントDB内通し番号：10進数）

対処イベントの重大度

PROCESSUPDATE_SEVERITY

重大度（対処状況を変更したJP1イベント重大度：Emergency，Alert，Critical，Error，Warning，Notice，Information，Debugのどれか）

対処イベントの発行元イベントサーバ名

PROCESSUPDATE_SOURCESERVER

発行元イベントサーバ名（対処状況を変更したJP1イベントが発行されたイベントサーバ名）

対処イベントのメッセージ

PROCESSUPDATE_MESSAGE

メッセージ（対処状況を変更したJP1イベントのメッセージ）

対処イベントの登録時刻

PROCESSUPDATE_TIME

登録時刻（対処状況を変更したJP1イベントの登録時刻：MM/DD hh:mm:ssの形式でイベント詳細画面へ表示）

注※1　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

注※2　JP1ユーザーは，状況に応じて次のように表示が変わります。

07-51以降のJP1/IM - Viewから対処状況を変更した場合：対処状況を変更したJP1ユーザー

07-50以前のJP1/IM - Viewから対処状況を変更した場合：-

jcochstatコマンドによって対処状況を変更した場合：jcochstat

応答待ちイベントに応答したことで対処状況が変更された場合：system

応答待ちイベントがキャンセルされたことで対処状況が変更された場合：system

注※3　対処前状況，対処後状況は，対処操作によって，次のように表示が変わります。

対処済：PROCESSED

未対処：UNPROCESSED

処理中：PROCESSING

保留：HELD

対処済→削除：PROCESSED+DELETE

未対処→削除：UNPROCESSED+DELETE

処理中→削除：PROCESSING+DELETE

保留→削除：HELD+DELETE

(35)　イベントID：00003F13の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

発生時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

イベント基盤サービスが動作している論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB4014-I イベント取得条件定義を読み込みました。次に受信したイベントから読み込んだ定義で処理されます。(フィルター名：フィルター名 ，最後に受信したイベント：到着時刻=到着時刻，イベントDB内通し番号=イベントDB内通し番号)

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVFLOW

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EVFLOW

事象種別

OCCURRENCE

RUN

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(36)　相関イベント発行定義ファイルのSUCCESS_EVENTパラメーターに指定されたイベントIDの詳細

属性種別

項目

属性名

内容

基本属性

イベントID

IDBASE

ユーザーが定義したイベントID

（0〜1FFFおよび7FFF8000〜7FFFFFFFで任意に設定可能）

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

発行元イベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

ユーザーが定義したメッセージ

拡張属性

共通情報

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/GENERATE_EVENT

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EGS

事象種別

OCCURRENCE

SUCCESS

固有情報

関連イベントDB内通し番号

JP1_GENERATE_SOURCE_SEQNO

関連イベントのイベントDB内通し番号を半角スペース（△）で区切って，次のように設定する。

イベントDB内通し番号1△イベントDB内通し番号2△...△イベントDB内通し番号n（nは１〜100の値）

相関イベント発行条件名

JP1_GENERATE_NAME

成立した相関イベント発行条件名

注　相関イベントの属性には，この表に記載されていない属性も定義できます。詳細については，「相関イベント発行定義ファイル」（2.　定義ファイル）を参照してください。

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(37)　相関イベント発行定義ファイルのFAIL_EVENTパラメーターに指定されたイベントIDの詳細

属性種別

項目

属性名

内容

基本属性

イベントID

IDBASE

ユーザーが定義したイベントID

（0〜1FFFおよび7FFF8000〜7FFFFFFFで任意に設定可能）

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

発行元イベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

拡張属性

共通情報

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/GENERATE_EVENT

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EGS

事象種別

OCCURRENCE

FAIL

固有情報

関連イベントDB内通し番号

JP1_GENERATE_SOURCE_SEQNO

関連イベントのイベントDB内通し番号を半角スペース（△）で区切って，次のように設定する。

イベントDB内通し番号1△イベントDB内通し番号2△...△イベントDB内通し番号n（nは１〜100の値）

相関イベント発行条件名

JP1_GENERATE_NAME

不成立になった相関イベント発行条件名

注　相関イベントの属性には，この表に記載されていない属性も定義できます。詳細については，「相関イベント発行定義ファイル」（2.　定義ファイル）を参照してください。

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(38)　イベントID：00003F15の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

ID

3F15

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

アクション実行サービスのプロセスID

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

Windowsの場合

-1〜65,535※1

UNIXの場合

0

発行元グループID

GROUPID

Windowsの場合

-1〜65,535※1

UNIXの場合

0

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

Windowsの場合

空白

UNIXの場合

root

発行元イベントサーバ名

SOURCESERVER

イベント基盤サービスが動作している論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB1669-I 重要イベント定義ファイルを読み込みました。次に取得したイベントから読み込んだ定義で処理されます（最後に取得したイベント：到着時刻=最後に取得したイベントの到着時刻，イベントDB内通し番号=最後に取得したイベントのイベントDB内通し番号）※2

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVFLOW

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EVFLOW

事象種別

OCCURRENCE

RUN

注※1　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

注※2　イベント基盤サービスがイベントを受信していない場合は，「最後に取得したイベントの到着時刻」および「最後に取得したイベントのイベントDB内通し番号」には「--」が表示されます。

(39)　イベントID：00003F16の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

-1

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

エラーの発生時刻

発行元ユーザーID

USERID

0

発行元グループID

GROUPID

0

発行元ユーザー名

USERNAME

空白

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

イベントが発行されたイベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

0

メッセージ

MESSAGE

KAVB1671-W 統合監視DBからイベントを取得するときにエラーが発生しました。

システムプロファイルに指定された回数リトライしましたが，回復しません。

このため，以降のイベントは表示されません

拡張属性

共通情報

重大度

SEVERITY

Warning

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVENTCONSOLE

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

IM Database

事象種別

OCCURRENCE

DISCONNECT

(40)　イベントID：00003F17の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

イベント基盤サービスが動作している論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB1150-I 追加共通除外条件群を登録しました。(共通除外群ID:共通除外条件群ID, 共通除外群名:共通除外条件群名, 登録ユーザー:ユーザー名)

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVFLOW

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EVFLOW

事象種別

OCCURRENCE

RUN

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(41)　イベントID：00003F20の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

相関イベント発行サービスが動作している論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAJV2179-I イベント取得条件定義を読み込みました。次に受信したイベントから読み込んだ定義で処理されます。（フィルター名:フィルター名，最後に受信したイベント:到着時刻=到着時刻, イベントDB内通し番号=イベントDB内通し番号）

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EGS

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EGS

事象種別

OCCURRENCE

RUN

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(42)　イベントID：00003F21の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

相関イベント発行サービスが動作している論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAJV2242-I 相関イベント発行定義ファイル（ファイル名）を読み込み，相関イベント発行機能に反映しました

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EGS

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EGS

事象種別

OCCURRENCE

RUN

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(43)　イベントID：00003F22の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

イベント基盤サービスが動作している論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB4712-W JP1/Baseで使用する正規表現を拡張していないためイベント基盤サービスは共通除外条件群(拡張)を使用できません。共通除外条件群(拡張)が設定されていない状態で起動します

拡張属性

共通情報

重大度

SEVERITY

Notice

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVFLOW

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EVFLOW

事象種別

OCCURRENCE

Notice

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(44)　イベントID：00003F23の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

イベント基盤サービスが動作している論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAJV2502-W JP1/Baseで使用する正規表現を拡張していないため相関イベント発行サービスは共通除外条件群(拡張)を使用できません。共通除外条件群(拡張)が設定されていない状態で起動します

拡張属性

共通情報

重大度

SEVERITY

Notice

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EGS

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EGS

事象種別

OCCURRENCE

Notice

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(45)　イベントID：00003F25の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

相関イベント発行サービスが動作している論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAJV2243-I 相関イベント発行機能を再開しました

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EGS

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EGS

事象種別

OCCURRENCE

START

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(46)　イベントID：00003F26の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

相関イベント発行サービスが動作している論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAJV2234-I 相関イベント発行機能を停止しました

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EGS

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EGS

事象種別

OCCURRENCE

STOP

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(47)　イベントID：00003F28の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

イベントが発行されたイベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAJV2322-W 相関中のJP1イベントの組が上限(20000組)に達しているためJP1イベント（イベントID=イベントID，イベントDB内通し番号=イベントDB内通し番号）を相関できませんでした

拡張属性

共通情報

重大度

SEVERITY

Warning

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EGS

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EGS

事象種別

OCCURRENCE

RUN

注　00003F28は，JP1イベントの組数が上限に達した時点で1度出力されます。そのあと，JP1イベントの組数が16,000組以下になるまでは，組数が上限に達しても出力されません。

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(48)　イベントID：00003F31の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

相関イベント発行サービスが動作している論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAJV2188-I 追加共通除外条件群を登録しました。(共通除外群ID:共通除外条件群ID, 共通除外群名:共通除外条件群名, 登録ユーザー:ユーザー名)

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EGS

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EGS

事象種別

OCCURRENCE

RUN

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(49)　イベントID：00003F41の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

発生時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

イベントが発行されたイベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB0551-E マネージャーで滞留している応答待ちイベントが上限2000件を超えました

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVENTCONSOLE

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EVTCON

事象種別

OCCURRENCE

NOTICE

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(50)　イベントID：00003F42の詳細

属性種別

項目

属性名

内容

基本属性

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

発生時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

イベントが発行されたイベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB1816-W 表示できなかった応答待ちイベントがあります。

表示できなかった応答待ちイベントを確認するには，［イベント検索条件設定］画面を表示し，次の検索条件を指定してください。

（１） 検索ホスト名として，接続中のホスト名を指定する。

（２） 応答待ちイベントとして，対象を指定する。

（３） 到着時刻として，このJP1イベントの前又は後に表示されているイベントの到着時刻を指定する。

拡張属性

共通情報

重大度

SEVERITY

Warning

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVENTCONSOLE

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EVTCON

事象種別

OCCURRENCE

PROCESS

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(51)　イベントID：00003F51の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

ID

00003F51

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※1

発行元グループID

GROUPID

-1〜65,535※1

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

イベントが発行されたイベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB1841-I 削除対象始点日から削除対象終点日のイベントを統合監視DBから削除しました※2

拡張属性

共通情報

重大度

SEVERITY

Notice

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVFLOW

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EVFLOW

事象種別

OCCURRENCE

NOTICE

固有情報

削除対象始点日

DEL_STARTDAY

削除対象始点日の通算秒（MM/DD hh:mm:ssの形式でイベント詳細画面へ表示する）

削除対象終点日

DEL_ENDDAY

削除対象終点日の通算秒（MM/DD hh:mm:ssの形式でイベント詳細画面へ表示する）

注※1　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

注※2　KAVB1841-Iメッセージの削除対象始点日，削除対象終点日は，YYYY/MM/DD hh:mm:ss形式で置き換えます。

(52)　イベントID：00003F52の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

ID

00003F52

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

イベントが発行されたイベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB1842-W 保存出力していないイベントが削除警告位置（削除警告位置%）を超えました

拡張属性

共通情報

重大度

SEVERITY

Warning

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVFLOW

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EVFLOW

事象種別

OCCURRENCE

NOTICE

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(53)　イベントID：00003F53の詳細

属性種別

項目

属性名

内容

基本属性

登録ホスト名

SOURCESERVER

イベントが発行されたイベントサーバ名

メッセージ

MESSAGE

KAVB1832-E 統合監視DBへのイベント登録処理でエラーが発生しました。統合監視DBへのイベント登録をリトライします（詳細情報：詳細情報）

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVFLOW

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EVFLOW

事象種別

OCCURRENCE

NOTICE

(54)　イベントID：00003F54の詳細

属性種別

項目

属性名

内容

基本属性

登録ホスト名

SOURCESERVER

イベントが発行されたイベントサーバ名

メッセージ

MESSAGE

KAVB1833-I 統合監視DBへのイベント登録処理で発生していたエラーが回復しました。イベント基盤サービスはイベント取得を再開しています

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVFLOW

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EVFLOW

事象種別

OCCURRENCE

NOTICE

(55)　イベントID：00003F56の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

ID

00003F56

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

イベント基盤サービスが動作している論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB4673-I 繰り返しイベント条件を登録しました。(繰り返しイベント条件名:繰り返しイベント条件名, 登録ユーザー:ユーザー名)

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVFLOW

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EVFLOW

事象種別

OCCURRENCE

RUN

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(56)　イベントID：00003F57の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

ID

00003F57

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

イベント基盤サービスが動作しているホスト名または論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB4674-I 繰り返しイベント条件を更新しました。次に受信したイベントから読み込んだ定義で処理されます。(最後に受信したイベント：到着時刻=到着時刻, イベントDB内通し番号=イベントDB内通し番号)

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVFLOW

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EVFLOW

事象種別

OCCURRENCE

RUN

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(57)　イベントID：00003F58の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

ID

00003F58

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

イベント基盤サービスが動作しているホスト名または論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB4676-I 繰り返しイベント条件(繰り返しイベント条件名)に一致するイベントの抑止を開始しました。(抑止を開始したイベント：到着時刻=到着時刻, イベントDB内通し番号=イベントDB内通し番号)

拡張属性

共通情報

重大度

SEVERITY

Notice

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVFLOW

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EVFLOW

事象種別

OCCURRENCE

NOTICE

固有情報

同一属性値情報1

SAMEATTR1

同一属性値条件に指定した一番目（リストのいちばん上）の属性名とその属性値を「属性名=属性値」の形式で格納する。同一属性値条件が指定されていない場合は，空白が格納される。

属性値は1,024バイトまでである。1,024バイトを超える場合は，マルチバイト文字が壊れないように切断する。

同一属性値情報2

SAMEATTR2

同一属性値条件に指定した二番目の属性名とその属性値を「属性名=属性値」の形式で格納する。同一属性値条件が2件未満の場合は，空白が格納される。

属性値は1,024バイトまでである。1,024バイトを超える場合は，マルチバイト文字が壊れないように切断する。

同一属性値情報3

SAMEATTR3

同一属性値条件に指定した三番目の属性名とその属性値を「属性名=属性値」の形式で格納する。同一属性値条件が3件未満の場合は，空白が格納される。

属性値は1,024バイトまでである。1,024バイトを超える場合は，マルチバイト文字が壊れないように切断する。

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(58)　イベントID：00003F59の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

ID

00003F59

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

イベント基盤サービスが動作しているホスト名または論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB4677-I 繰り返しイベント条件(繰り返しイベント条件名)に一致するイベントの抑止を終了しました。(抑止したイベント：到着時刻=抑止を開始したイベントの到着時刻 - 最後に抑止したイベントの到着時刻, イベントDB内通し番号=抑止を開始したイベントのイベントDB内通し番号 - 最後に抑止したイベントのイベントDB内通し番号)

拡張属性

共通情報

重大度

SEVERITY

Notice

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVFLOW

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EVFLOW

事象種別

OCCURRENCE

NOTICE

固有情報

同一属性値情報1

SAMEATTR1

同一属性値条件に指定した一番目（リストのいちばん上）の属性名とその属性値を「属性名=属性値」の形式で格納する。同一属性値条件が指定されていない場合は，空白が格納される。

属性値は1,024バイトまでである。1,024バイトを超える場合は，マルチバイト文字が壊れないように切断する。

同一属性値情報2

SAMEATTR2

同一属性値条件に指定した二番目の属性名とその属性値を「属性名=属性値」の形式で格納する。同一属性値条件が2件未満の場合は，空白が格納される。

属性値は1,024バイトまでである。1,024バイトを超える場合は，マルチバイト文字が壊れないように切断する。

同一属性値情報3

SAMEATTR3

同一属性値条件に指定した三番目の属性名とその属性値を「属性名=属性値」の形式で格納する。同一属性値条件が3件未満の場合は，空白が格納される。

属性値は1,024バイトまでである。1,024バイトを超える場合は，マルチバイト文字が壊れないように切断する。

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(59)　イベントID：00003F60の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

ID

00003F60

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

イベント基盤サービスが動作しているホスト名，または論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB4678-I 繰り返しイベント条件(繰り返しイベント条件名)に一致するイベントの抑止を打ち切り，再度抑止を開始しました。(抑止したイベント：到着時刻=抑止を開始したイベントの到着時刻 - 最後に抑止したイベントの到着時刻, イベントDB内通し番号=抑止を開始したイベントのイベントDB内通し番号 - 最後に抑止したイベントのイベントDB内通し番号)

拡張属性

共通情報

重大度

SEVERITY

Notice

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVFLOW

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EVFLOW

事象種別

OCCURRENCE

NOTICE

固有情報

同一属性値情報1

SAMEATTR1

同一属性値条件に指定した一番目（リストのいちばん上）の属性名とその属性値を「属性名=属性値」の形式で格納する。同一属性値条件が指定されていない場合は，空白が格納される。

属性値は1,024バイトまでである。1,024バイトを超える場合は，マルチバイト文字が壊れないように切断する。

同一属性値情報2

SAMEATTR2

同一属性値条件に指定した二番目の属性名とその属性値を「属性名=属性値」の形式で格納する。同一属性値条件が2件未満の場合は，空白が格納される。

属性値は1,024バイトまでである。1,024バイトを超える場合は，マルチバイト文字が壊れないように切断する。

同一属性値情報3

SAMEATTR3

同一属性値条件に指定した三番目の属性名とその属性値を「属性名=属性値」の形式で格納する。同一属性値条件が3件未満の場合は，空白が格納される。

属性値は1,024バイトまでである。1,024バイトを超える場合は，マルチバイト文字が壊れないように切断する。

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(60)　イベントID：00003F61の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

ID

00003F61

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※1

発行元グループID

GROUPID

-1〜65,535※1

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

イベント基盤サービスが動作しているサーバ名，または論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB4600-I 重大度変更定義を読み込みました。次に受信したイベントから読み込んだ定義で処理されます。(最後に受信したイベント：到着時刻=到着時刻, イベントDB内通し番号=イベントDB内通し番号)※2

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVFLOW

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EVFLOW

事象種別

OCCURRENCE

RUN

注※1　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

注※2　KAVB4600-Iメッセージの到着時刻は，YYYY/MM/DD hh:mm:ss形式で置き換えます。到着時刻には，JP1/IM - Managerが動作しているマシンで設定されているタイムゾーンに従った時刻が設定されます。

(61)　イベントID：00003F63の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

ID

00003F63

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※1

発行元グループID

GROUPID

-1〜65,535※1

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

イベント基盤サービスが動作しているサーバ名，または論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB4650-I 発生元ホストマッピング定義ファイルを読み込みました。次に受信したイベントから読み込んだ定義で処理されます。(最後に受信したイベント:到着時刻=到着時刻, イベントDB内通し番号=イベントDB内通し番号)※2

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVFLOW

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EVFLOW

事象種別

OCCURRENCE

RUN

注※1　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

注※2　KAVB4650-Iメッセージの到着時刻は，YYYY/MM/DD hh:mm:ss形式で置き換えます。到着時刻には，JP1/IM - Managerが動作しているマシンで設定されているタイムゾーンに従った時刻が設定されます。

(62)　イベントID：00003F64の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

ID

00003F64

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※1

発行元グループID

GROUPID

-1〜65,535※1

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

イベント基盤サービスが動作しているホスト名，または論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB8453-I 業務グループを反映しました。次に受信したイベントから処理されます。(最後に受信したイベント:到着時刻=到着時刻, イベントDB内通し番号=イベントDB内通し番号)※2

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVFLOW

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EVFLOW

事象種別

OCCURRENCE

RUN

注※1　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

注※2　KAVB8453-Iメッセージの到着時刻は，YYYY/MM/DD hh:mm:ss形式で置き換えます。到着時刻には，JP1/IM - Managerが動作しているマシンで設定されているタイムゾーンに従った時刻が設定されます。

(63)　イベントID：00003F65の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

ID

00003F65

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

イベント基盤サービスが動作しているホスト名，または論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB4679-I 繰り返しイベント条件(繰り返しイベント条件名)に一致するイベントの抑止が継続しています。(抑止したイベント：到着時刻=抑止を開始したイベントの到着時刻 - 最後に抑止したイベントの到着時刻, イベントDB内通し番号=抑止を開始したイベントのイベントDB内通し番号 - 最後に抑止したイベントのイベントDB内通し番号)

拡張属性

共通情報

重大度

SEVERITY

Notice

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVFLOW

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EVFLOW

事象種別

OCCURRENCE

NOTICE

固有情報

同一属性値情報1

SAMEATTR1

同一属性値条件に指定した一番目（リストのいちばん上）の属性名とその属性値を「属性名=属性値」の形式で格納する。同一属性値条件が指定されていない場合は，空白が格納される。

属性値は1,024バイトまでである。1,024バイトを超える場合は，マルチバイト文字が壊れないように切断する。

同一属性値情報2

SAMEATTR2

同一属性値条件に指定した二番目の属性名とその属性値を「属性名=属性値」の形式で格納する。同一属性値条件が2件未満の場合は，空白が格納される。

属性値は1,024バイトまでである。1,024バイトを超える場合は，マルチバイト文字が壊れないように切断する。

同一属性値情報3

SAMEATTR3

同一属性値条件に指定した三番目の属性名とその属性値を「属性名=属性値」の形式で格納する。同一属性値条件が3件未満の場合は，空白が格納される。

属性値は1,024バイトまでである。1,024バイトを超える場合は，マルチバイト文字が壊れないように切断する。

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(64)　イベントID：00003F68の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

ID

00003F68

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

イベント基盤サービスが動作しているサーバ名，または論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB8454-W 業務グループを反映できませんでした。(要因:要因)

拡張属性

共通情報

重大度

SEVERITY

Warning

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVENTCONSOLE

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EVTCON

事象種別

OCCURRENCE

RUN

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(65)　イベントID：00003F69の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

ID

00003F69

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

イベント基盤サービスが動作しているサーバ名，または論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB8456-E 業務グループを反映できませんでした。(要因:要因)

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVENTCONSOLE

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EVTCON

事象種別

OCCURRENCE

RUN

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(66)　イベントID：00003F6Aの詳細

属性種別

項目

属性名

内容

基本属性

イベントID

ID

00003F6A

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※1

発行元グループID

GROUPID

-1〜65,535※1

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

イベント基盤サービスが動作しているサーバ名，または論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB4623-I 表示メッセージ変更定義ファイルを読み込みました。次に受信したイベントから，読み込んだ定義に従って処理されます。(最後に受信したイベント：到着時刻=到着時刻, イベントDB内通し番号=イベントDB内通し番号)※2

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVFLOW

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EVFLOW

事象種別

OCCURRENCE

RUN

注※1　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

注※2　KAVB4623-Iメッセージの到着時刻は，YYYY/MM/DD hh:mm:ss形式で置き換えます。到着時刻には，JP1/IM - Managerが動作しているマシンで設定されているタイムゾーンに従った時刻が設定されます。

(67)　イベントID：00003F71の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

ID

00003F71

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

イベント基盤サービスが動作しているサーバ名，または論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB4802-I 重大度変更定義を登録しました。(重大度変更定義名:重大度変更定義名, 登録ユーザー:ユーザー名)

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVFLOW

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EVTCON

事象種別

OCCURRENCE

RUN

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(68)　イベントID：00003F76の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

ID

00003F76

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

イベント基盤サービスが動作しているサーバ名，または論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB4803-I 表示メッセージ変更定義を登録しました。(表示メッセージ変更定義名:表示メッセージ変更定義名, 登録ユーザー:ユーザー名)

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVFLOW

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EVFLOW

事象種別

OCCURRENCE

RUN

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(69)　イベントID：00003F77の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

ID

00003F77

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

イベントコンソールサービスが動作しているホスト名または論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB5800-I イベント拡張属性定義ファイルをJP1/IM - Managerに読み込みました

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVENTCONSOLE

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EVTCON

事象種別

OCCURRENCE

RUN

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(70)　イベントID：00003F78の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

ID

00003F78

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

イベントコンソールサービスが動作しているホスト名または論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB5804-E イベント拡張属性定義ファイルを読み込もうとしましたが，一部のイベント拡張属性定義ファイルの読み込みに失敗しました

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVENTCONSOLE

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EVTCON

事象種別

OCCURRENCE

RUN

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(71)　イベントID：00003F7Cの詳細

属性種別

項目

属性名

内容

基本属性

イベントID

ID

00003F7C

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

空白

発行元イベントサーバ名

SOURCESERVER

イベントコンソールサービスが動作しているホスト名または論理ホスト名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB1981-I モニター画面呼び出し定義ファイルをJP1/IM - Managerに反映しました

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/EVENTCONSOLE

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

EVTCON

事象種別

OCCURRENCE

RUN

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(72)　イベントID：00003FB0の詳細

属性種別

項目

属性名

内容

基本属性

発行元イベントサーバ名

SOURCESERVER

イベントが発行されたイベントサーバ名

メッセージ

MESSAGE

KAVB7900-I 監視ノード名の状態が状態から状態に変わりました。

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/SCOPE

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

IM_CS

事象種別

OCCURRENCE

STATUS_CHANGE

固有情報

監視ノードID

MON_NODE_ID

監視ノードのID

監視ノード名

MON_NODE_NAME

監視ノードの名称

監視ノードの状態※1

MON_NODE_STATUS

監視ノードのStatusID

状態変更の元となったJP1イベントの情報※2

属性名

属性値(基本属性にはJCS_B_が，拡張属性にはJCS_E_の接頭字が付加される)。

注※1　「監視ノードの状態（E.MON_NODE_STATUS）」には，JP1イベントを発行した監視ノードの状態が，StatusIDと呼ぶ次の数値に格納されます。

StatusID（監視ノードの状態）の値

緊急：800，警戒：700，致命的：600，エラー：500，警告：400，正常：300，デバッグ：200，初期状態：100

例えば，監視ノードの状態が緊急に変化した時に発行されたJP1イベントは，監視ノードの状態（E.MON_NODE_STATUS）=800になります。

注※2　「状態変更の元となったJP1イベントの情報」は，JP1/IM - Viewで確認できません。なお，「状態変更の元となったJP1イベントの情報」には，状態変更の契機となったJP1イベントの情報が属性名-属性値の組み合わせですべて格納されます。この結果，00003FB0がJP1イベントの最大値（10,000バイト）を超えた場合，最大値を超えない分だけ，状態変更の契機となったJP1イベントの情報を格納します。また，拡張属性が100個を超える場合も，100個以内に収まる範囲内でJP1イベントの情報を格納します。「状態変更の元となったJP1イベント」の情報のうち，「状態変更の元となったJP1イベントの登録時刻（E.JCS_B_TIME）」および「状態変更の元となったJP1イベントの到着時刻（E.JCS_B_ARRIVEDTIME）」は，GMTでYYYY/MM/DD hh:mm:ssの形式で格納されます。

(73)　イベントID：00003FB1の詳細

属性種別

項目

属性名

内容

基本属性

発行元イベントサーバ名

SOURCESERVER

イベントが発行されたイベントサーバ名

イベントID

−

00003FB1

メッセージ

MESSAGE

KAVB7901-W 監視ノード（監視ノードID※）の状態変更イベントの件数が上限を超えました。

拡張属性

共通情報

重大度

SEVERITY

WARNING

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/SCOPE

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

IM_CS

事象種別

OCCURRENCE

NOTICE

固有情報

監視ノードID

MON_NODE_ID

監視ノードのID

状態変更イベントの件数

EVHIST_NUMBER

状態変更イベントの件数

（凡例）

−：なし

注※　1件のJP1イベントを契機にして，複数の監視オブジェクトの状態変更イベントが100件を超えた場合でも，このときに発行されるJP1イベント（イベントID＝00003FB1）は1件だけです。メッセージ情報の監視ノードIDの部分に監視オブジェクトのIDが最大10件，コンマ区切りで列挙されます。10件を超えた場合は，IDの後ろに（...）が付加されます。

(74)　イベントID：00003FC0の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00003FC0

メッセージ

MESSAGE

KNAN26102-E リモートログファイルトラップを開始出来ません。(詳細コード: エラー番号，監視対象ホスト名: 監視対象ホスト名，監視名: 監視名)

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

Windowsの場合：

jcfallogstartコマンドの-pオプションを指定した場合

/HITACHI/JP1/IM/REMOTE_NT_LOGTRAP/プログラム名

プログラム名はjevlogstartコマンドの-pオプションで指定したログデータ出力元プログラム名。

jcfallogstartコマンドの-pオプションを指定していない場合

/HITACHI/JP1/IM/REMOTE_NT_LOGTRAP

UNIXの場合：

jcfallogstartコマンドの-pオプションを指定した場合

/HITACHI/JP1/IM/REMOTE_UX_LOGTRAP/プログラム名

プログラム名はjevlogstartコマンドの-pオプションで指定したログデータ出力元プログラム名。

jcfallogstartコマンドの-pオプションを指定していない場合

/HITACHI/JP1/IM/REMOTE_UX_LOGTRAP

オブジェクトタイプ

OBJECT_TYPE

LOGFILE

オブジェクト名

OBJECT_NAME

監視名

登録名タイプ

ROOT_OBJECT_TYPE

LOGFILE

登録名

ROOT_OBJECT_NAME

監視名

事象種別

OCCURRENCE

NOTICE

固有情報

監視停止時刻

WATCH_STOP_TIME

ログファイル監視を停止した時刻（UTC 1970-01-01 00:00:00からの秒数）

監視対象ホスト名

JP1_SOURCEHOST

監視対象ホスト名

（凡例）

−：なし

(75)　イベントID：00003FC1の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00003FC1

メッセージ

MESSAGE

KNAN26094-E 指定された回数リトライ処理を行いましたが，該当ログファイルの読み込みが出来ないため監視を停止します。(詳細コード:エラー番号，監視対象ホスト名:監視対象ホスト名, 監視名:監視名, ログファイル名:ログファイル名)

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

Windowsの場合：

jcfallogstartコマンドの-pオプションを指定した場合

/HITACHI/JP1/IM/REMOTE_NT_LOGTRAP/プログラム名

プログラム名はjevlogstartコマンドの-pオプションで指定したログデータ出力元プログラム名。

jcfallogstartコマンドの-pオプションを指定していない場合

/HITACHI/JP1/IM/REMOTE_NT_LOGTRAP

UNIXの場合：

jcfallogstartコマンドの-pオプションを指定した場合

/HITACHI/JP1/IM/REMOTE_UX_LOGTRAP/プログラム名

プログラム名はjevlogstartコマンドの-pオプションで指定したログデータ出力元プログラム名。

jcfallogstartコマンドの-pオプションを指定していない場合

/HITACHI/JP1/IM/REMOTE_UX_LOGTRAP

オブジェクトタイプ

OBJECT_TYPE

LOGFILE

オブジェクト名

OBJECT_NAME

監視名

登録名タイプ

ROOT_OBJECT_TYPE

LOGFILE

登録名

ROOT_OBJECT_NAME

監視名

事象種別

OCCURRENCE

NOTICE

固有情報

監視停止時刻

WATCH_STOP_TIME

ログファイル監視を停止した時刻（UTC 1970-01-01 00:00:00からの秒数）

監視対象ホスト名

JP1_SOURCEHOST

監視対象ホスト名

（凡例）

−：なし

(76)　イベントID：00003FC2の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00003FC2

メッセージ

MESSAGE

KNAN26095-E 該当ログファイルを正しく監視することが出来ない状態になりました。(詳細コード:エラー番号，監視対象ホスト名:監視対象ホスト名, 監視名:監視名, ログファイル名:ログファイル名)

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

Windowsの場合：

jcfallogstartコマンドの-pオプションを指定した場合

/HITACHI/JP1/IM/REMOTE_NT_LOGTRAP/プログラム名

プログラム名はjevlogstartコマンドの-pオプションで指定したログデータ出力元プログラム名。

jcfallogstartコマンドの-pオプションを指定していない場合

/HITACHI/JP1/IM/REMOTE_NT_LOGTRAP

UNIXの場合：

jcfallogstartコマンドの-pオプションを指定した場合

/HITACHI/JP1/IM/REMOTE_UX_LOGTRAP/プログラム名

プログラム名はjevlogstartコマンドの-pオプションで指定したログデータ出力元プログラム名。

jcfallogstartコマンドの-pオプションを指定していない場合

/HITACHI/JP1/IM/REMOTE_UX_LOGTRAP

オブジェクトタイプ

OBJECT_TYPE

LOGFILE

オブジェクト名

OBJECT_NAME

監視名

登録名タイプ

ROOT_OBJECT_TYPE

LOGFILE

登録名

ROOT_OBJECT_NAME

監視名

事象種別

OCCURRENCE

NOTICE

固有情報

異常検知時刻

WATCH_CHECK_TIME

ログファイルの異常を検知した時刻（UTC 1970-01-01 00:00:00からの秒数）

監視対象ホスト名

JP1_SOURCEHOST

監視対象ホスト名

（凡例）

−：なし

(77)　イベントID：00003FC3の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00003FC3

メッセージ

MESSAGE

KNAN26057-E 続行できないエラーが発生したため，リモートログファイルトラップを停止します。(詳細コード: エラー番号，監視対象ホスト名: 監視対象ホスト名，監視名: 監視名)

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

Windowsの場合：

jcfallogstartコマンドの-pオプションを指定した場合

/HITACHI/JP1/IM/REMOTE_NT_LOGTRAP/プログラム名

プログラム名はjevlogstartコマンドの-pオプションで指定したログデータ出力元プログラム名。

jcfallogstartコマンドの-pオプションを指定していない場合

/HITACHI/JP1/IM/REMOTE_NT_LOGTRAP

UNIXの場合：

jcfallogstartコマンドの-pオプションを指定した場合

/HITACHI/JP1/IM/REMOTE_UX_LOGTRAP/プログラム名

プログラム名はjevlogstartコマンドの-pオプションで指定したログデータ出力元プログラム名。

jcfallogstartコマンドの-pオプションを指定していない場合

/HITACHI/JP1/IM/REMOTE_UX_LOGTRAP

オブジェクトタイプ

OBJECT_TYPE

LOGFILE

オブジェクト名

OBJECT_NAME

監視名

登録名タイプ

ROOT_OBJECT_TYPE

LOGFILE

登録名

ROOT_OBJECT_NAME

監視名

事象種別

OCCURRENCE

NOTICE

固有情報

異常検知時刻

WATCH_CHECK_TIME

ログファイルの異常を検知した時刻（UTC 1970-01-01 00:00:00からの秒数）

監視対象ホスト名

JP1_SOURCEHOST

監視対象ホスト名

（凡例）

−：なし

(78)　イベントID：00003FC5の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00003FC5

メッセージ

MESSAGE

KNAN26140-W リモートログファイルトラップにおいて，監視対象のログファイルから収集したデータのサイズが制限値を超えました。前回収集日時から今回収集日時までに出力されているログは，JP1イベントとして出力されません。(監視対象ホスト名: 監視対象ホスト名，監視名: 監視名，ログファイル名: ログファイル名，前回収集日時: 前回収集日時，今回収集日時: 今回収集日時)

拡張属性

共通情報

重大度

SEVERITY

Warning

プロダクト名

PRODUCT_NAME

Windowsの場合：

jcfallogstartコマンドの-pオプションを指定した場合

/HITACHI/JP1/IM/REMOTE_NT_LOGTRAP/プログラム名

プログラム名はjevlogstartコマンドの-pオプションで指定したログデータ出力元プログラム名。

jcfallogstartコマンドの-pオプションを指定していない場合

/HITACHI/JP1/IM/REMOTE_NT_LOGTRAP

UNIXの場合：

jcfallogstartコマンドの-pオプションを指定した場合

/HITACHI/JP1/IM/REMOTE_UX_LOGTRAP/プログラム名

プログラム名はjevlogstartコマンドの-pオプションで指定したログデータ出力元プログラム名。

jcfallogstartコマンドの-pオプションを指定していない場合

/HITACHI/JP1/IM/REMOTE_UX_LOGTRAP

オブジェクトタイプ

OBJECT_TYPE

LOGFILE

オブジェクト名

OBJECT_NAME

監視名

登録名タイプ

ROOT_OBJECT_TYPE

LOGFILE

登録名

ROOT_OBJECT_NAME

監視名

事象種別

OCCURRENCE

NOTICE

固有情報

監視対象ホスト名

JP1_SOURCEHOST

監視対象ホスト名

（凡例）

−：なし

(79)　イベントID：00003FC6の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00003FC6

メッセージ

MESSAGE

KNAN26351-E 監視対象ホスト監視対象ホスト名のすべてのリモートログファイルトラップを停止します。(要因: 要因)

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

Windowsの場合：

/HITACHI/JP1/IM/REMOTE_NT_LOGTRAP

UNIXの場合：

/HITACHI/JP1/IM/REMOTE_UX_LOGTRAP

オブジェクトタイプ

OBJECT_TYPE

LOGFILE

オブジェクト名

OBJECT_NAME

監視対象ホスト名

登録名タイプ

ROOT_OBJECT_TYPE

LOGFILE

登録名

ROOT_OBJECT_NAME

監視対象ホスト名

事象種別

OCCURRENCE

NOTICE

固有情報

監視停止時刻

WATCH_STOP_TIME

ログファイル監視を停止した時刻（UTC 1970-01-01 00:00:00からの秒数）

監視対象ホスト名

JP1_SOURCEHOST

監視対象ホスト名

（凡例）

−：なし

(80)　イベントID：00003FC7の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00003FC7

メッセージ

MESSAGE

KNAN26350-W 監視対象のログファイルの退避ファイルが見つかりません。前回収集日時から今回収集日時までに退避ファイルに出力されているログは，JP1イベントとして出力されません。(監視対象ホスト名: 監視対象ホスト名，監視名: 監視名，監視対象ログファイル名: 監視対象ログファイル名，前回収集日時: 前回収集日時，今回収集日時: 今回収集日時，ユーザー: ユーザー，実行したコマンドライン: 実行したコマンドライン)

拡張属性

共通情報

重大度

SEVERITY

Warning

プロダクト名

PRODUCT_NAME

Windowsの場合：

jcfallogstartコマンドの-pオプションを指定した場合

/HITACHI/JP1/IM/REMOTE_NT_LOGTRAP/プログラム名

プログラム名はjevlogstartコマンドの-pオプションで指定したログデータ出力元プログラム名。

jcfallogstartコマンドの-pオプションを指定していない場合

/HITACHI/JP1/IM/REMOTE_NT_LOGTRAP

UNIXの場合：

jcfallogstartコマンドの-pオプションを指定した場合

/HITACHI/JP1/IM/REMOTE_UX_LOGTRAP/プログラム名

プログラム名はjevlogstartコマンドの-pオプションで指定したログデータ出力元プログラム名。

jcfallogstartコマンドの-pオプションを指定していない場合

/HITACHI/JP1/IM/REMOTE_UX_LOGTRAP

オブジェクトタイプ

OBJECT_TYPE

LOGFILE

オブジェクト名

OBJECT_NAME

監視名

登録名タイプ

ROOT_OBJECT_TYPE

LOGFILE

登録名

ROOT_OBJECT_NAME

監視対象ホスト名

事象種別

OCCURRENCE

NOTICE

固有情報

監視対象ホスト名

JP1_SOURCEHOST

監視対象ホスト名

（凡例）

−：なし

(81)　イベントID：00003FC8の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00003FC8

メッセージ

MESSAGE

KNAN26352-W 監視対象のログファイルの退避ファイルが見つかりません。前回収集日時から今回収集日時までに退避ファイルに出力されているログは，JP1イベントとして出力されません。(監視対象ホスト名: 監視対象ホスト名，監視名: 監視名，監視対象ログファイル名: 監視対象ログファイル名，前回収集日時: 前回収集日時，今回収集日時: 今回収集日時，ユーザー: ユーザー)

拡張属性

共通情報

重大度

SEVERITY

Warning

プロダクト名

PRODUCT_NAME

Windowsの場合：

jcfallogstartコマンドの-pオプションを指定した場合

/HITACHI/JP1/IM/REMOTE_NT_LOGTRAP/プログラム名

プログラム名はjevlogstartコマンドの-pオプションで指定したログデータ出力元プログラム名。

jcfallogstartコマンドの-pオプションを指定していない場合

/HITACHI/JP1/IM/REMOTE_NT_LOGTRAP

UNIXの場合：

jcfallogstartコマンドの-pオプションを指定した場合

/HITACHI/JP1/IM/REMOTE_UX_LOGTRAP/プログラム名

プログラム名はjevlogstartコマンドの-pオプションで指定したログデータ出力元プログラム名。

jcfallogstartコマンドの-pオプションを指定していない場合

/HITACHI/JP1/IM/REMOTE_UX_LOGTRAP

オブジェクトタイプ

OBJECT_TYPE

LOGFILE

オブジェクト名

OBJECT_NAME

監視名

登録名タイプ

ROOT_OBJECT_TYPE

LOGFILE

登録名

ROOT_OBJECT_NAME

監視対象ホスト名

事象種別

OCCURRENCE

NOTICE

固有情報

監視対象ホスト名

JP1_SOURCEHOST

監視対象ホスト名

（凡例）

−：なし

(82)　イベントID：00003FC9の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00003FC9

メッセージ

MESSAGE

KNAN26353-E 監視対象ホスト監視対象ホスト名のリモートイベントログトラップを停止します。(要因: 要因)

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/REMOTE_NTEVENT_LOGTRAP

オブジェクトタイプ

OBJECT_TYPE

LOGFILE

オブジェクト名

OBJECT_NAME

監視対象ホスト名

登録名タイプ

ROOT_OBJECT_TYPE

LOGFILE

登録名

ROOT_OBJECT_NAME

監視対象ホスト名

事象種別

OCCURRENCE

NOTICE

固有情報

監視停止時刻

WATCH_STOP_TIME

ログファイル監視を停止した時刻（UTC 1970-01-01 00:00:00からの秒数）

監視対象ホスト名

JP1_SOURCEHOST

監視対象ホスト名

（凡例）

−：なし

(83)　イベントID：00003FD0の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00003FD0

メッセージ

MESSAGE

KNAN26107-E リモートイベントログトラップを開始出来ません。(詳細コード: エラー番号，監視対象ホスト名: 監視対象ホスト名)

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/REMOTE_NTEVENT_LOGTRAP

オブジェクトタイプ

OBJECT_TYPE

LOGFILE

オブジェクト名

OBJECT_NAME

監視対象ホスト名

登録名タイプ

ROOT_OBJECT_TYPE

LOGFILE

登録名

ROOT_OBJECT_NAME

監視対象ホスト名

事象種別

OCCURRENCE

NOTICE

固有情報

エラー検知時刻

ERROR_TIME

エラーの発生した時刻（UTC 1970-01-01 00:00:00からの秒数）

エラー発生API名

ERROR_FUNCTION

エラーの発生したWindowsのAPI名

エラー要因

ERROR_CAUSE_ID

エラー要因コード

監視対象ホスト名

JP1_SOURCEHOST

監視対象ホスト名

（凡例）

−：なし

(84)　イベントID：00003FD1の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00003FD1

メッセージ

MESSAGE

KNAN26028-E 指定された回数リトライ処理を行いましたが，イベントログの読み込みが出来ないためリモート監視を停止します。(詳細コード:エラー番号，監視対象ホスト名:監視対象ホスト名)

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/REMOTE_NTEVENT_LOGTRAP

オブジェクトタイプ

OBJECT_TYPE

LOGFILE

オブジェクト名

OBJECT_NAME

監視対象ホスト名

登録名タイプ

ROOT_OBJECT_TYPE

LOGFILE

登録名

ROOT_OBJECT_NAME

監視対象ホスト名

事象種別

OCCURRENCE

NOTICE

固有情報

エラー検知時刻

ERROR_TIME

エラーの発生した時刻（UTC 1970-01-01 00:00:00からの秒数）

エラー発生API名

ERROR_FUNCTION

エラーの発生したWindowsのAPI名

エラー要因

ERROR_CAUSE_ID

エラー要因コード

監視対象ホスト名

JP1_SOURCEHOST

監視対象ホスト名

（凡例）

−：なし

(85)　イベントID：00003FD2の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00003FD2

メッセージ

MESSAGE

KNAN26027-I イベントログの読み込みをリトライします。(詳細コード: エラー番号，監視対象ホスト名: 監視対象ホスト名)

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/REMOTE_NTEVENT_LOGTRAP

オブジェクトタイプ

OBJECT_TYPE

LOGFILE

オブジェクト名

OBJECT_NAME

監視対象ホスト名

登録名タイプ

ROOT_OBJECT_TYPE

LOGFILE

登録名

ROOT_OBJECT_NAME

監視対象ホスト名

事象種別

OCCURRENCE

NOTICE

固有情報

エラー検知時刻

ERROR_TIME

エラーの発生した時刻（UTC 1970-01-01 00:00:00からの秒数）

エラー発生API名

ERROR_FUNCTION

エラーの発生したWindowsのAPI名

エラー要因

ERROR_CAUSE_ID

エラー要因コード

監視対象ホスト名

JP1_SOURCEHOST

監視対象ホスト名

（凡例）

−：なし

(86)　イベントID：00003FD3の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00003FD3

メッセージ

MESSAGE

KNAN26002-E 続行できないエラーが発生したため，リモートイベントログトラップを停止します。(詳細コード:エラー番号，監視対象ホスト名:監視対象ホスト名)

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/REMOTE_NTEVENT_LOGTRAP

オブジェクトタイプ

OBJECT_TYPE

LOGFILE

オブジェクト名

OBJECT_NAME

監視対象ホスト名

登録名タイプ

ROOT_OBJECT_TYPE

LOGFILE

登録名

ROOT_OBJECT_NAME

監視対象ホスト名

事象種別

OCCURRENCE

NOTICE

固有情報

エラー検知時刻

ERROR_TIME

エラーの発生した時刻（UTC 1970-01-01 00:00:00からの秒数）

エラー要因

ERROR_CAUSE_ID

エラー要因コード

監視対象ホスト名

JP1_SOURCEHOST

監視対象ホスト名

（凡例）

−：なし

(87)　イベントID：00003FD4の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00003FD4

メッセージ

MESSAGE

KNAN26026-I イベントログの監視が可能になりました。(監視対象ホスト名: 監視対象ホスト名)

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/REMOTE_NTEVENT_LOGTRAP

オブジェクトタイプ

OBJECT_TYPE

LOGFILE

オブジェクト名

OBJECT_NAME

監視対象ホスト名

登録名タイプ

ROOT_OBJECT_TYPE

LOGFILE

登録名

ROOT_OBJECT_NAME

監視対象ホスト名

事象種別

OCCURRENCE

NOTICE

固有情報

エラー検知時刻

ERROR_TIME

エラーの発生した時刻（UTC 1970-01-01 00:00:00からの秒数）

回復時刻

RECOVER_TIME

エラーから回復した時刻（UTC 1970-01-01 00:00:00からの秒数）

エラー要因

ERROR_CAUSE_ID

エラー要因コード

監視対象ホスト名

JP1_SOURCEHOST

監視対象ホスト名

（凡例）

−：なし

(88)　イベントID：00003FD5の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00003FD5

メッセージ

MESSAGE

KNAN26142-W リモートイベントログトラップにおいて，監視対象ホストから収集したイベントログのサイズが制限値を超えました。前回収集日時から今回収集日時までに出力されているイベントログは，JP1イベントとして出力されません。(監視対象ホスト名: 監視対象ホスト名，前回収集日時: 前回収集日時，今回収集日時: 今回収集日時)

拡張属性

共通情報

重大度

SEVERITY

Warning

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/REMOTE_NTEVENT_LOGTRAP

オブジェクトタイプ

OBJECT_TYPE

LOGFILE

オブジェクト名

OBJECT_NAME

監視対象ホスト名

登録名タイプ

ROOT_OBJECT_TYPE

LOGFILE

登録名

ROOT_OBJECT_NAME

監視対象ホスト名

事象種別

OCCURRENCE

NOTICE

固有情報

監視対象ホスト名

JP1_SOURCEHOST

監視対象ホスト名

（凡例）

−：なし

(89)　イベントID：00003FD6の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00003FD6

メッセージ

MESSAGE

KNAN26339-W ログ収集時にリモートログファイルトラップの状態の保存に失敗しました。(監視対象ホスト名: 監視対象ホスト名，監視名: 監視名)

拡張属性

共通情報

重大度

SEVERITY

Warning

プロダクト名

PRODUCT_NAME

Windowsの場合：

jcfallogstartコマンドの-pオプションを指定した場合

/HITACHI/JP1/IM/REMOTE_NT_LOGTRAP/プログラム名

プログラム名はjevlogstartコマンドの-pオプションで指定したログデータ出力元プログラム名。

jcfallogstartコマンドの-pオプションを指定していない場合

/HITACHI/JP1/IM/REMOTE_NT_LOGTRAP

UNIXの場合：

jcfallogstartコマンドの-pオプションを指定した場合

/HITACHI/JP1/IM/REMOTE_UX_LOGTRAP/プログラム名

プログラム名はjevlogstartコマンドの-pオプションで指定したログデータ出力元プログラム名。

jcfallogstartコマンドの-pオプションを指定していない場合

/HITACHI/JP1/IM/REMOTE_UX_LOGTRAP

オブジェクトタイプ

OBJECT_TYPE

LOGFILE

オブジェクト名

OBJECT_NAME

監視名

登録名タイプ

ROOT_OBJECT_TYPE

LOGFILE

登録名

ROOT_OBJECT_NAME

監視名

事象種別

OCCURRENCE

NOTICE

固有情報

監視対象ホスト名

JP1_SOURCEHOST

監視対象ホスト名

（凡例）

−：なし

(90)　イベントID：00003FD7の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00003FD7

メッセージ

MESSAGE

KNAN26340-W ログ収集時にリモートイベントログトラップの状態の保存に失敗しました。(監視対象ホスト名: 監視対象ホスト名)

拡張属性

共通情報

重大度

SEVERITY

Warning

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/REMOTE_NTEVENT_LOGTRAP

オブジェクトタイプ

OBJECT_TYPE

LOGFILE

オブジェクト名

OBJECT_NAME

監視対象ホスト名

登録名タイプ

ROOT_OBJECT_TYPE

LOGFILE

登録名

ROOT_OBJECT_NAME

監視対象ホスト名

事象種別

OCCURRENCE

NOTICE

固有情報

監視対象ホスト名

JP1_SOURCEHOST

監視対象ホスト名

（凡例）

−：なし

(91)　イベントID：00003FD8の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00003FD8

メッセージ

MESSAGE

KNAN26341-W 前回停止時のリモートログファイルトラップの状態を復元することができませんでした。(監視対象ホスト名: 監視対象ホスト名，監視名: 監視名)

拡張属性

共通情報

重大度

SEVERITY

Warning

プロダクト名

PRODUCT_NAME

Windowsの場合：

jcfallogstartコマンドの-pオプションを指定した場合

/HITACHI/JP1/IM/REMOTE_NT_LOGTRAP/プログラム名

プログラム名はjevlogstartコマンドの-pオプションで指定したログデータ出力元プログラム名。

jcfallogstartコマンドの-pオプションを指定していない場合

/HITACHI/JP1/IM/REMOTE_NT_LOGTRAP

UNIXの場合：

jcfallogstartコマンドの-pオプションを指定した場合

/HITACHI/JP1/IM/REMOTE_UX_LOGTRAP/プログラム名

プログラム名はjevlogstartコマンドの-pオプションで指定したログデータ出力元プログラム名。

jcfallogstartコマンドの-pオプションを指定していない場合

/HITACHI/JP1/IM/REMOTE_UX_LOGTRAP

オブジェクトタイプ

OBJECT_TYPE

LOGFILE

オブジェクト名

OBJECT_NAME

監視名

登録名タイプ

ROOT_OBJECT_TYPE

LOGFILE

登録名

ROOT_OBJECT_NAME

監視名

事象種別

OCCURRENCE

NOTICE

固有情報

監視対象ホスト名

JP1_SOURCEHOST

監視対象ホスト名

（凡例）

−：なし

(92)　イベントID：00003FD9の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00003FD9

メッセージ

MESSAGE

KNAN26342-W 前回停止時のリモートイベントログトラップの状態を復元することができませんでした。(監視対象ホスト名: 監視対象ホスト名)

拡張属性

共通情報

重大度

SEVERITY

Warning

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/REMOTE_NTEVENT_LOGTRAP

オブジェクトタイプ

OBJECT_TYPE

LOGFILE

オブジェクト名

OBJECT_NAME

監視対象ホスト名

登録名タイプ

ROOT_OBJECT_TYPE

LOGFILE

登録名

ROOT_OBJECT_NAME

監視対象ホスト名

事象種別

OCCURRENCE

NOTICE

固有情報

監視対象ホスト名

JP1_SOURCEHOST

監視対象ホスト名

（凡例）

−：なし

(93)　イベントID：00003FDAの詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00003FDA

メッセージ

MESSAGE

KNAN26343-W 前回停止時のリモートログファイルトラップの状態を復元して監視できない状態のため，前回停止時のリモートログファイルトラップの状態を復元しませんでした。(詳細情報: 詳細情報，監視対象ホスト名: 監視対象ホスト名，監視名: 監視名)

拡張属性

共通情報

重大度

SEVERITY

Warning

プロダクト名

PRODUCT_NAME

Windowsの場合：

jcfallogstartコマンドの-pオプションを指定した場合

/HITACHI/JP1/IM/REMOTE_NT_LOGTRAP/プログラム名

プログラム名はjevlogstartコマンドの-pオプションで指定したログデータ出力元プログラム名。

jcfallogstartコマンドの-pオプションを指定していない場合

/HITACHI/JP1/IM/REMOTE_NT_LOGTRAP

UNIXの場合：

jcfallogstartコマンドの-pオプションを指定した場合

/HITACHI/JP1/IM/REMOTE_UX_LOGTRAP/プログラム名

プログラム名はjevlogstartコマンドの-pオプションで指定したログデータ出力元プログラム名。

jcfallogstartコマンドの-pオプションを指定していない場合

/HITACHI/JP1/IM/REMOTE_UX_LOGTRAP

オブジェクトタイプ

OBJECT_TYPE

LOGFILE

オブジェクト名

OBJECT_NAME

監視名

登録名タイプ

ROOT_OBJECT_TYPE

LOGFILE

登録名

ROOT_OBJECT_NAME

監視名

事象種別

OCCURRENCE

NOTICE

固有情報

監視対象ホスト名

JP1_SOURCEHOST

監視対象ホスト名

（凡例）

−：なし

(94)　イベントID：00003FDBの詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00003FDB

メッセージ

MESSAGE

KNAN26345-I ログ収集時に発生していたリモートログファイルトラップの状態の保存のエラーが回復しました。(監視対象ホスト名: 監視対象ホスト名，監視名: 監視名)

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

Windowsの場合：

jcfallogstartコマンドの-pオプションを指定した場合

/HITACHI/JP1/IM/REMOTE_NT_LOGTRAP/プログラム名

プログラム名はjevlogstartコマンドの-pオプションで指定したログデータ出力元プログラム名。

jcfallogstartコマンドの-pオプションを指定していない場合

/HITACHI/JP1/IM/REMOTE_NT_LOGTRAP

UNIXの場合：

jcfallogstartコマンドの-pオプションを指定した場合

/HITACHI/JP1/IM/REMOTE_UX_LOGTRAP/プログラム名

プログラム名はjevlogstartコマンドの-pオプションで指定したログデータ出力元プログラム名。

jcfallogstartコマンドの-pオプションを指定していない場合

/HITACHI/JP1/IM/REMOTE_UX_LOGTRAP

オブジェクトタイプ

OBJECT_TYPE

LOGFILE

オブジェクト名

OBJECT_NAME

監視名

登録名タイプ

ROOT_OBJECT_TYPE

LOGFILE

登録名

ROOT_OBJECT_NAME

監視名

事象種別

OCCURRENCE

NOTICE

固有情報

監視対象ホスト名

JP1_SOURCEHOST

監視対象ホスト名

（凡例）

−：なし

(95)　イベントID：00003FDCの詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00003FDC

メッセージ

MESSAGE

KNAN26346-I ログ収集時に発生していたリモートイベントログトラップの状態の保存のエラーが回復しました。(監視対象ホスト名: 監視対象ホスト名)

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/REMOTE_NTEVENT_LOGTRAP

オブジェクトタイプ

OBJECT_TYPE

LOGFILE

オブジェクト名

OBJECT_NAME

監視対象ホスト名

登録名タイプ

ROOT_OBJECT_TYPE

LOGFILE

登録名

ROOT_OBJECT_NAME

監視対象ホスト名

事象種別

OCCURRENCE

NOTICE

固有情報

監視対象ホスト名

JP1_SOURCEHOST

監視対象ホスト名

（凡例）

−：なし

(96)　イベントID：リモート監視ログファイルトラップ動作定義ファイルのACTDEFパラメーターに指定されている値

属性種別

項目

属性名

内容

基本属性

イベントID

−

ACTDEFパラメーターに指定されている値

メッセージ

MESSAGE

ログファイル1行分のログデータの内容

イベント発行時刻

−

イベントを発行した時刻

拡張属性

共通情報

重大度

SEVERITY

動作定義ファイルのACTDEFパラメーターで指定された重大度

プロダクト名

PRODUCT_NAME

Windowsの場合：

jcfallogdefコマンド，jcfallogstartコマンド，リモート監視の起動オプションに-pオプションを指定した場合

/HITACHI/JP1/NT_LOGTRAP/プログラム名

プログラム名は-pオプションで指定したログデータ出力元プログラム名

jcfallogdefコマンド，jcfallogstartコマンド，リモート監視の起動オプションに-pオプションを指定していない場合

/HITACHI/JP1/NT_LOGTRAP

UNIXの場合：

jcfallogdefコマンド，jcfallogstartコマンド，リモート監視の起動オプションに-pオプションを指定した場合

/HITACHI/JP1/UX_LOGTRAP/プログラム名

プログラム名は-pオプションで指定したログデータ出力元プログラム名

jcfallogdefコマンド，jcfallogstartコマンド，リモート監視の起動オプションに-pオプションを指定していない場合

/HITACHI/JP1/UX_LOGTRAP

オブジェクトタイプ

OBJECT_TYPE

LOGFILE

オブジェクト名

OBJECT_NAME

監視対象のログファイル名

登録名タイプ

ROOT_OBJECT_TYPE

LOGFILE

登録名

ROOT_OBJECT_NAME

監視対象のログファイル名

固有情報

プラットフォーム

PLATFORM

Windowsの場合：NT

UNIXの場合：UNIX

PP名

PPNAME

/HITACHI/JP1/IM/REMOTE_MONITORING/LOGTRAP

ホスト名

JP1_SOURCEHOST

イベント発生元ホスト名（監視対象ホスト名）

監視ID

E.JP1_TRAP_ID※

ログファイルトラップのID番号

監視名

E.JP1_TRAP_NAME※

監視名

（凡例）

−：なし

注※1　マネージャーのJP1/Baseが10-50以降の場合に存在する属性です。

(97)　イベントID：00003A71またはリモート監視イベントログトラップ動作定義ファイルのfilterブロックに指定されたイベントIDの詳細

属性種別

項目

属性名

（WMIの属性名）

内容

基本属性

イベントID

B.ID

リモート監視イベントログトラップ動作定義ファイルのfilterブロックに指定されたイベントID。

イベントIDを指定していない場合は00003A71固定となる。

メッセージ

B.MESSAGE

（MessageまたはInsertionStrings）

イベントログのメッセージ※1

最大1,023バイト。超えた分は切り捨て。

イベント発行時刻

−

イベントを発行した時刻

拡張属性

共通情報

重大度

E.SEVERITY

（EventType）

イベントログの種別に応じて登録する。

Error：エラー

Warning：警告

Information：情報，詳細，その他

Notice：監査成功，監査失敗

発行元プロダクト名

E.PRODUCT_NAME

（SourceName）

/HITACHI/JP1/NTEVENT_LOGTRAP/ソース

オブジェクト種別

E.OBJECT_TYPE

E.ROOT_OBJECT_TYPE

LOGFILE

オブジェクト名

E.OBJECT_NAME

E.ROOT_OBJECT_NAME

NTEVENTLOG

固有情報

イベントログ登録日時

E.A0

（TimeGenerated）

time_t型（UTC 1970-01-01 00:00:00からの秒数）

コンピュータ名

E.A1

（ComputerName）

コンピュータ名の値

hostnameコマンドを実行した際に表示されるホスト名.ドメイン名

種別

E.A2

（Logfile）

イベントログの種別の値

種類

E.A3

（Type）

イベントログのレベルに対応する値

分類

E.A4

（CategoryStringまたはCategory）

イベントログのタスクのカテゴリーの値

イベントID

E.A5

（EventCode）

イベントログのイベントIDの値

ユーザー名

E.A6

（User）

イベントログのユーザー名の値

プラットフォーム

E.PLATFORM

NT

PP名

E.PPNAME

/HITACHI/JP1/IM/AGENTLESS/EVENTLOGTRAP

発生元ホスト名

E.JP1_SOURCEHOST※2

監視対象ホスト名

監視名

E.JP1_TRAP_NAME

イベントログトラップ動作定義ファイルに指定された監視名。指定していない場合は出力しない（属性が存在しない）。

（凡例）

−：なし

注※1　イベントログの説明文を記載したメッセージDLLが正しく設定されていない場合は，挿入句や詳細コードをダブルクォーテーションマーク（"）で囲んでJP1イベントのメッセージに登録します。

注※2　共通定義ATTR_EVENT_LOGTRAP_SOURCEHOSTが1の場合だけ存在する属性です。

(98)　イベントID：00003F90の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00003F90

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

jco_spmdのプロセスID

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元グループID

GROUPID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

Windowsの場合

空白

UNIXの場合

root

発行元イベントサーバ名

SOURCESERVER

発行元イベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB3737-E コンポーネント名 の管理対象プロセス名 は異常終了しました

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/SPMD

オブジェクトタイプ

OBJECT_TYPE

SPMD

オブジェクト名

OBJECT_NAME

異常終了したプロセス名

事象種別

OCCURRENCE

NOTICE

（凡例）

−：なし

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(99)　イベントID：00003F91の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00003F91

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

jco_spmdのプロセスID

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元グループID

GROUPID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

Windowsの場合

空白

UNIXの場合

root

発行元イベントサーバ名

SOURCESERVER

発行元イベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB3613-W コンポーネント名 のプロセス名 の起動がタイムアウトしました. 処理を継続します

拡張属性

共通情報

重大度

SEVERITY

Warning

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/SPMD

オブジェクトタイプ

OBJECT_TYPE

SPMD

オブジェクト名

OBJECT_NAME

起動タイムアウトしたプロセス名

事象種別

OCCURRENCE

NOTICE

（凡例）

−：なし

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(100)　イベントID：00003F92の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00003F92

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

jco_spmdのプロセスID

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元グループID

GROUPID

Windowsの場合

-1〜65,535※

UNIXの場合

0

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

Windowsの場合

空白

UNIXの場合

root

発行元イベントサーバ名

SOURCESERVER

発行元イベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

MESSAGE

KAVB3616-I コンポーネント名 の管理対象プロセス名 の再起動が完了しました

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/SPMD

オブジェクトタイプ

OBJECT_TYPE

SPMD

オブジェクト名

OBJECT_NAME

再起動したプロセス名

事象種別

OCCURRENCE

NOTICE

（凡例）

−：なし

注※　JP1/Baseのイベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定していない場合，-1が設定されます。

(101)　イベントID：00006400の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

ID

00006400

イベントDB内通し番号

SEQNO

イベントDB内通し番号※

登録要因

REASON

1〜4の値※

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻※

到着時刻

ARRIVEDTIME

到着時刻※

発行元ユーザーID

USERID

Windowsの場合※

-1〜65,535

UNIXの場合※

0

発行元グループID

GROUPID

Windowsの場合※

-1〜65,535※

UNIXの場合※

0

発行元ユーザー名

USERNAME

Windowsの場合※

SYSTEM

UNIXの場合※

root

発行元グループ名

GROUPNAME

Windowsの場合※

空白

UNIXの場合※

root

発行元イベントサーバ名

SOURCESERVER

発行元イベントサーバ名※

発行先イベントサーバ名

DESTSERVER

発行先イベントサーバ名※

発行元IPアドレス

EVIPADDR

イベント発行元IPアドレス※

IPv4の場合：aaa.bbb.ccc.ddd形式（前にゼロを付けない10進数で，1〜3桁）

IPv6の場合：aaaa:bbbb:cccc:dddd:eeee:ffff:gggg:hhhh形式（前にゼロを付けない16進数で，1〜4桁）

送信先IPアドレス

−

イベント送信先IPアドレス※

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号※

コードセット

−

JP1/IM - Managerが動作している言語コード※

メッセージ

MESSAGE

表示メッセージ変更機能によりメッセージ変更した場合，変更後のメッセージを設定する。

メッセージを変更していない場合，オリジナルイベントのメッセージテキストを設定する。

詳細情報

−

設定しない。

拡張属性

共通情報

重大度

SEVERITY

オリジナルイベントを重大度変更機能により重大度変更している場合，変更後の重大度を設定する。

重大度を変更していない場合，オリジナルイベントの重大度を設定する。

ユーザー名

USER_NAME

オリジナルイベントのUSER_NAME

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/MO

オブジェクトタイプ

OBJECT_TYPE

オリジナルイベントのOBJECT_TYPE

オブジェクト名

OBJECT_NAME

オリジナルイベントのOBJECT_NAME

登録名タイプ

ROOT_OBJECT_TYPE

オリジナルイベントのROOT_OBJECT_TYPE

登録名

ROOT_OBJECT_NAME

オリジナルイベントのROOT_OBJECT_NAME

オブジェクトID

OBJECT_ID

オリジナルイベントのOBJECT_ID

事象種別

OCCURRENCE

オリジナルイベントのOCCURRENCE

開始時刻

START_TIME

オリジナルイベントのSTART_TIME

終了時刻

END_TIME

オリジナルイベントのEND_TIME

終了コード

RESULT_CODE

オリジナルイベントのRESULT_CODE

オリジナルイベントの基本属性

イベントDB内通し番号

B_SEQNO

オリジナルイベントのイベントDB内通し番号

イベントID

B_ID

オリジナルイベントのイベントID。

「基本コード：拡張コード」の形式。基本コード，拡張コード共に8桁以内の16進数。前にゼロは付けない。

登録要因

B_REASON

オリジナルイベントの登録要因

発行元プロセスID

B_PID

オリジナルイベントの発行元プロセスID

登録時刻

B_DATE

オリジナルイベントの登録時刻の日付部分を「YYYY/MM/DD」の形式で設定。サーバのタイムゾーンで変換した文字列となる。

B_TIME

オリジナルイベントの登録時刻の時刻部分を「hh:mm:ss」の形式で設定。サーバのタイムゾーンで変換した文字列となる。

到着時刻

B_ARVDATE

オリジナルイベントの到着時刻の日付部分を「YYYY/MM/DD」の形式で設定。サーバのタイムゾーンで変換した文字列となる。

B_ARVTIME

オリジナルイベントの到着時刻の時刻部分を「hh:mm:ss」の形式で設定。サーバのタイムゾーンで変換した文字列となる。

発行元ユーザーID

B_USRID

オリジナルイベントの発行元ユーザーID

発行元グループID

B_GRPID

オリジナルイベントの発行元グループID

発行元ユーザー名

B_USR

オリジナルイベントの発行元ユーザー名

発行元グループ名

B_GRP

オリジナルイベントの発行元グループ名

発行元イベントサーバ名

B_HOST

オリジナルイベントの発行元イベントサーバ名

送信先イベントサーバ名

B_DESTSERVER

オリジナルイベントの送信先イベントサーバ名

発行元IPアドレス

B_IPADDR

オリジナルイベントの発行元IPアドレス

送信先IPアドレス

B_DESTIPADDR

オリジナルイベントの送信先IPアドレス

発行元別通し番号

B_SRCNO

オリジナルイベントの発行元別通し番号

コードセット

B_CODESET

オリジナルイベントのコードセット

メッセージ

B_MSG

オリジナルイベントのメッセージ

詳細情報

B_DETAIL

オリジナルイベントの詳細情報

詳細情報が文字列の場合：詳細情報の文字列をそのまま設定

詳細情報がバイナリー形式の場合：空白を設定

オリジナルイベントの拡張属性：共通情報

重大度

E_SEVERITY

オリジナルイベントのSEVERITY

（重大度変更機能で重大度を変更している場合，変更後の重大度を設定）

プロダクト名

E_PRODUCT_NAME

オリジナルイベントのPRODUCT_NAME

オリジナルイベントの拡張属性：固有情報

オリジナルイベントが持つ拡張属性：固有情報

E_*

オリジナルイベントの拡張属性固有情報を設定。

オリジナルイベントの属性名の先頭にE_を付加したもの。

例えば，オリジナルイベントの拡張属性の属性名がPLATFORMで内容がNTの場合，変換後のイベントの属性名がE_PLATFORMになり，内容はそのままNTとなる。

ただし，オリジナルイベントの拡張属性名が31バイト以上の場合，変換後のイベント属性名中の「E_」は省略される。

JP1/IM - M固有情報

イベント発行元情報

EVTSRC_INFO

JP1/IM - Managerでホストマッピングの機能が有効な場合

発生元ホスト（E.JP1_SOURCEHOST）

JP1/IM - Managerでホストマッピングの機能が無効な場合

発行元イベントサーバ名（B.SOURCESERVER）

JP1/IM - MOバージョン

MO_VERSION

「1100」

イベント発行元名

EVTSRC_NAME

オリジナルイベントにE.JP1ADD_EVTSRC_NAMEがある場合

E.JP1ADD_EVTSRC_NAME

オリジナルイベントにE.JP1ADD_EVTSRC_NAMEがない場合

発行元イベントサーバ名（B.SOURCESERVER）

適用先システム名

SYSTEM_NAME

オリジナルイベントにE.JP1ADD_SYSTEM_NAMEがある場合

E.JP1ADD_SYSTEM_NAME

オリジナルイベントにE.JP1ADD_SYSTEM_NAMEがない場合

日本語環境では，「全てのシステム」を設定する。日本語環境以外では「ALLSYSTEM」を設定する

拡張属性格納結果

ADDEXTATTR_RESULT

拡張属性の格納結果を設定する。

次の値の和を2バイトの16進数で設定する。

0：すべての拡張属性の値を格納できた

1：拡張属性の個数の上限（100個）に達し，格納できなかった属性がある

2：拡張属性の合計サイズの上限（10キロバイト）に達し，格納できなかった属性がある

4：拡張属性名の最大長を超えるため"E_"を付けないで格納した属性がある

8：他の拡張属性名と重複するため，属性を格納できなかった

（凡例）

−：なし

注※　JP1/Baseが設定します。

注　「オリジナルイベント」とは，JP1/IM - ManagerがJP1/Baseから取得したイベントを指します。

(102)　イベントID：00003FE0の詳細

属性種別

項目

属性名

属性値

基本属性

イベントID

−

00003FE0

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※1

発行元グループID

GROUPID

-1〜65,535※1

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

Windowsの場合

空白

UNIXの場合

root

発行元イベントサーバ名

SOURCESERVER

発行元イベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

−

KAJY22023-I 対処アクションを開始します。(提案ID :提案ID, JP1ユーザー名: JP1ユーザー名, IM管理ノード:ツリーのSID, アクション情報:アクション情報)※2

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/DD

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

SUGGESTION

事象種別

OCCURRENCE

START

固有情報

提案ID

SUGGESTION_ID

対処アクションの提案ID

ツリーSID

TREE_SID

対処アクションのツリーSID※3

（凡例）

−：なし

注※1　イベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定しない場合-1が設定されます。

注※2　メッセージが1,024バイトを超える場合，1,023バイトまでの文字列が設定されます。1,023バイト目がマルチバイト文字の途中の場合は，その文字は切り捨てて設定されます。

注※3　拡張属性の合計サイズが10,000バイトを超える場合は，全体のサイズが10,000バイトになるまでこの属性の値を切り捨てし，末尾の3バイトを「...」に変換します。

(103)　イベントID：00003FE1の詳細

属性種別

項目

属性名

属性値

基本属性

イベントID

−

00003FE1

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※1

発行元グループID

GROUPID

-1〜65,535※1

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

Windowsの場合

空白

UNIXの場合

root

発行元イベントサーバ名

SOURCESERVER

発行元イベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

−

KAJY22024-I 対処アクションが完了しました。(提案ID : 提案ID, JP1ユーザー名 : JP1ユーザー名, IM管理ノード : ツリーのSID, アクション情報 : アクション情報)※2

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/DD

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

SUGGESTION

事象種別

OCCURRENCE

END

固有情報

提案ID

SUGGESTION_ID

対処アクションの提案ID

ツリーSID

TREE_SID

対処アクションのツリーSID※3

（凡例）

−：なし

注※1　イベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定しない場合-1が設定されます。

注※2　メッセージが1,024バイトを超える場合，1,023バイトまでの文字列が設定されます。1,023バイト目がマルチバイト文字の途中の場合は，その文字は切り捨てて設定されます。

注※3　拡張属性の合計サイズが10,000バイトを超える場合は，全体のサイズが10,000バイトになるまでこの属性の値を切り捨てし，末尾の3バイトを「...」に変換します。

(104)　イベントID：00003FF0の詳細

属性種別

項目

属性名

属性値

基本属性

イベントID

−

00003FF0

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

Windowsの場合

ヌル文字列

UNIXの場合

root

発行元イベントサーバ名

SOURCESERVER

発行元イベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

−

KAJY63025-I イベント (統合監視DB内通し番号=統合監視DB内通し番号) に対する対処アクションを対処アクション実行先を管理するJP1/IM-Managerに送信しました

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/DD

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

RESPONSEACTION

オブジェクトID

OBJECT_ID

アクションの契機となったイベントのイベントDB内通し番号

開始時刻

START_TIME

対処アクション実行先を管理するJP1/IM - Managerに送信した時刻

事象種別

OCCURRENCE

NOTICE

固有情報

アクション実行ホスト

EXECHOST

対処アクション実行先ホスト名

アクション状態

ACTION_STATUS

アクションの状態「SENDED」

アクション内容

EXECCMD

restapiの場合

RESTAPIのURL

cmdの場合

実行要求したコマンド

実行先SID

EXECSID

対処アクションを実行するシステム（統合エージェント制御基盤またはJP1/IM - Manager）の構成情報のSID

（凡例）

−：なし

注※　イベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定しない場合-1が設定されます。

(105)　イベントID：00003FF1の詳細

属性種別

項目

属性名

属性値

基本属性

イベントID

−

00003FF1

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

Windowsの場合

ヌル文字列

UNIXの場合

root

発行元イベントサーバ名

SOURCESERVER

発行元イベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

−

KAJY63026-I イベント (統合監視DB内通し番号=統合監視DB内通し番号) に対する対処アクションを統合エージェント管理基盤に要求しました。

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/DD

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

RESPONSEACTION

オブジェクトID

OBJECT_ID

アクションの契機となったイベントのイベントDB内通し番号

開始時刻

START_TIME

統合エージェント管理基盤に送信した時刻

事象種別

OCCURRENCE

NOTICE

固有情報

アクション実行ホスト

EXECHOST

対処アクション実行先ホスト名

アクション状態

ACTION_STATUS

アクションの状態「RUNNING」

アクション内容

EXECCMD

restapiの場合

RESTAPIのURL

cmdの場合

実行要求したコマンド

実行先SID

EXECSID

対処アクションを実行するシステム（統合エージェント制御基盤またはJP1/IM - Manager）の構成情報のSID

（凡例）

−：なし

注※　イベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定しない場合-1が設定されます。

(106)　イベントID：00003FF2の詳細

属性種別

項目

属性名

属性値

基本属性

イベントID

−

00003FF2

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

Windowsの場合

ヌル文字列

UNIXの場合

root

発行元イベントサーバ名

SOURCESERVER

発行元イベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

−

KAJY63027-Iイベント (統合監視DB内通し番号=統合監視DB内通し番号) に対する対処アクションの実行が終了しました。(終了コード=終了コード)

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/DD

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

RESPONSEACTION

オブジェクトID

OBJECT_ID

アクションの契機となったイベントのイベントDB内通し番号

終了時刻

END_TIME

対処アクションが終了した時刻

事象種別

OCCURRENCE

NOTICE

固有情報

アクション実行ホスト

EXECHOST

対処アクション実行先ホスト名

アクション状態

ACTION_STATUS

アクションの状態「ENDED」

アクション内容

EXECCMD

restapiの場合

RESTAPIのURL

cmdの場合

実行要求したコマンド

実行先SID

EXECSID

対処アクションを実行するシステム（統合エージェント制御基盤またはJP1/IM - Manager）の構成情報のSID

（凡例）

−：なし

注※　イベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定しない場合-1が設定されます。

(107)　イベントID：00003FF3の詳細

属性種別

項目

属性名

属性値

基本属性

イベントID

−

00003FF3

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

Windowsの場合

ヌル文字列

UNIXの場合

root

発行元イベントサーバ名

SOURCESERVER

発行元イベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

−

KAJY63028-E イベント(統合監視DB内通し番号=統合監視DB内通し番号)に対する対処アクションが異常終了しました。

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/DD

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

RESPONSEACTION

オブジェクトID

OBJECT_ID

アクションの契機となったイベントのイベントDB内通し番号

終了時刻

END_TIME

対処アクションが終了した時刻

事象種別

OCCURRENCE

NOTICE

固有情報

アクション実行ホスト

EXECHOST

対処アクション実行先ホスト名

アクション状態

ACTION_STATUS

アクションの状態「ERROR」（実行不可の場合）または「FAIL」（通信失敗または実行失敗の場合）

アクション内容

EXECCMD

restapiの場合

RESTAPIのURL

cmdの場合

実行要求したコマンド

実行先SID

EXECSID

対処アクションを実行するシステム（統合エージェント制御基盤またはJP1/IM - Manager）の構成情報のSID

（凡例）

−：なし

注※　イベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定しない場合-1が設定されます。

(108)　イベントID：00003FF4の詳細

属性種別

項目

属性名

属性値

基本属性

イベントID

−

00003FF4

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

Windowsの場合

ヌル文字列

UNIXの場合

root

発行元イベントサーバ名

SOURCESERVER

発行元イベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

−

KAJY63029-I 対処アクション状態通知イベント (統合監視DB内通し番号=統合監視DB内通し番号) に対する対処アクションを対処アクション実行先を管理するJP1/IM - Managerに送信しました

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/DD

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

RESPONSEACTION

オブジェクトID

OBJECT_ID

アクションの契機となったイベントのイベントDB内通し番号

開始時刻

START_TIME

対処アクション実行先を管理するJP1/IM - Managerに送信した時刻

事象種別

OCCURRENCE

NOTICE

固有情報

アクション実行ホスト

EXECHOST

対処アクション実行先ホスト名

アクション状態

ACTION_STATUS

アクションの状態「SENDED」

アクション内容

EXECCMD

restapiの場合

RESTAPIのURL

cmdの場合

実行要求したコマンド

実行先SID

EXECSID

対処アクションを実行するシステム（統合エージェント制御基盤またはJP1/IM - Manager）の構成情報のSID

（凡例）

−：なし

注※　イベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定しない場合-1が設定されます。

(109)　イベントID：00003FF5の詳細

属性種別

項目

属性名

属性値

基本属性

イベントID

−

00003FF5

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

Windowsの場合

ヌル文字列

UNIXの場合

root

発行元イベントサーバ名

SOURCESERVER

発行元イベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

−

KAJY63030-I 対処アクション状態通知イベント (統合監視DB内通し番号=統合監視DB内通し番号) に対する対処アクションを統合エージェント管理基盤に要求しました。

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/DD

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

RESPONSEACTION

オブジェクトID

OBJECT_ID

アクションの契機となったイベントのイベントDB内通し番号

開始時刻

START_TIME

統合エージェント管理基盤に送信した時刻

事象種別

OCCURRENCE

NOTICE

固有情報

アクション実行ホスト

EXECHOST

対処アクション実行先ホスト名

アクション状態

ACTION_STATUS

アクションの状態「RUNNING」

アクション内容

EXECCMD

restapiの場合

RESTAPIのURL

cmdの場合

実行要求したコマンド

実行先SID

EXECSID

対処アクションを実行するシステム（統合エージェント制御基盤またはJP1/IM - Manager）の構成情報のSID

（凡例）

−：なし

注※　イベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定しない場合-1が設定されます。

(110)　イベントID：00003FF6の詳細

属性種別

項目

属性名

属性値

基本属性

イベントID

−

00003FF6

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

Windowsの場合

ヌル文字列

UNIXの場合

root

発行元イベントサーバ名

SOURCESERVER

発行元イベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

−

KAJY63031-I 対処アクション状態通知イベント (統合監視DB内通し番号=統合監視DB内通し番号) に対する対処アクションの実行が終了しました。(終了コード=終了コード)

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/DD

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

RESPONSEACTION

オブジェクトID

OBJECT_ID

アクションの契機となったイベントのイベントDB内通し番号

終了時刻

END_TIME

対処アクションが終了した時刻

事象種別

OCCURRENCE

NOTICE

固有情報

アクション実行ホスト

EXECHOST

対処アクション実行先ホスト名

アクション状態

ACTION_STATUS

アクションの状態「ENDED」

アクション内容

EXECCMD

restapiの場合

RESTAPIのURL

cmdの場合

実行要求したコマンド

実行先SID

EXECSID

対処アクションを実行するシステム（統合エージェント制御基盤またはJP1/IM - Manager）の構成情報のSID

（凡例）

−：なし

注※　イベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定しない場合-1が設定されます。

(111)　イベントID：00003FF7の詳細

属性種別

項目

属性名

属性値

基本属性

イベントID

−

00003FF7

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

Windowsの場合

ヌル文字列

UNIXの場合

root

発行元イベントサーバ名

SOURCESERVER

発行元イベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

−

KAJY63032-E 対処アクション状態通知イベント(統合監視DB内通し番号=統合監視DB内通し番号)に対する対処アクションが異常終了しました。

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/DD

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

RESPONSEACTION

オブジェクトID

OBJECT_ID

アクションの契機となったイベントのイベントDB内通し番号

終了時刻

END_TIME

対処アクションが終了した時刻

事象種別

OCCURRENCE

NOTICE

固有情報

アクション実行ホスト

EXECHOST

対処アクション実行先ホスト名

アクション状態

ACTION_STATUS

アクションの状態「ERROR」（実行不可の場合）または「FAIL」（通信失敗または実行失敗の場合）

アクション内容

EXECCMD

restapiの場合

RESTAPIのURL

cmdの場合

実行要求したコマンド

実行先SID

EXECSID

対処アクションを実行するシステム（統合エージェント制御基盤またはJP1/IM - Manager）の構成情報のSID

（凡例）

−：なし

注※　イベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定しない場合-1が設定されます。

(112)　イベントID：00003FF8の詳細

属性種別

項目

属性名

属性値

基本属性

イベントID

−

00003FF8

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

Windowsの場合

ヌル文字列

UNIXの場合

root

発行元イベントサーバ名

SOURCESERVER

発行元イベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

−

KAJY63033-W 対処アクションの実行を要求しましたが，対処アクション結果管理DBに対処アクションの情報が存在しないため対処アクション状態通知イベントが発行できません。(詳細情報 : 詳細情報)

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/DD

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

RESPONSEACTION

オブジェクトID

OBJECT_ID

アクションの契機となったイベントのイベントDB内通し番号

開始時刻

START_TIME

統合エージェント管理基盤に送信した時刻

事象種別

OCCURRENCE

NOTICE

固有情報

アクション実行ホスト

EXECHOST

対処アクション実行先ホスト名

アクション状態

ACTION_STATUS

アクションの状態「RUNNING」

アクション内容

EXECCMD

restapiの場合

RESTAPIのURL

cmdの場合

実行要求したコマンド

実行先SID

EXECSID

対処アクションを実行するシステム（統合エージェント制御基盤またはJP1/IM - Manager）の構成情報のSID

（凡例）

−：なし

注※　イベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定しない場合-1が設定されます。

(113)　イベントID：00003FF9の詳細

属性種別

項目

属性名

属性値

基本属性

イベントID

−

00003FF9

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

Windowsの場合

ヌル文字列

UNIXの場合

root

発行元イベントサーバ名

SOURCESERVER

発行元イベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

−

KAJY63034-W 対処アクションの実行が終了しましたが，対処アクション結果管理DBにアクションの情報が存在しないため対処アクション状態通知イベントが発行できません。(詳細情報 : 詳細情報)

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/DD

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

RESPONSEACTION

オブジェクトID

OBJECT_ID

アクションの契機となったイベントのイベントDB内通し番号

終了時刻

END_TIME

対処アクションが終了した時刻

事象種別

OCCURRENCE

NOTICE

固有情報

アクション実行ホスト

EXECHOST

対処アクション実行先ホスト名

アクション状態

ACTION_STATUS

アクションの状態「ENDED」

アクション内容

EXECCMD

restapiの場合

RESTAPIのURL

cmdの場合

実行要求したコマンド

実行先SID

EXECSID

対処アクションを実行するシステム（統合エージェント制御基盤またはJP1/IM - Manager）の構成情報のSID

（凡例）

−：なし

注※　イベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定しない場合-1が設定されます。

(114)　イベントID：00003FFAの詳細

属性種別

項目

属性名

属性値

基本属性

イベントID

−

00003FFA

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

Windowsの場合

ヌル文字列

UNIXの場合

root

発行元イベントサーバ名

SOURCESERVER

発行元イベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

−

KAJY63035-E 対処アクションが異常終了しましたが，対処アクション結果管理DBにアクションの情報が存在しないためアクション状態通知イベントが発行できません。(詳細情報 : 詳細情報)

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/DD

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

RESPONSEACTION

オブジェクトID

OBJECT_ID

アクションの契機となったイベントのイベントDB内通し番号

終了時刻

END_TIME

対処アクションが終了した時刻

事象種別

OCCURRENCE

NOTICE

固有情報

アクション実行ホスト

EXECHOST

対処アクション実行先ホスト名

アクション状態

ACTION_STATUS

アクションの状態「ERROR」（実行不可の場合）または「FAIL」（通信失敗または実行失敗の場合）

アクション内容

EXECCMD

restapiの場合

RESTAPIのURL

cmdの場合

実行要求したコマンド

実行先SID

EXECSID

対処アクションを実行するシステム（統合エージェント制御基盤またはJP1/IM - Manager）の構成情報のSID

（凡例）

−：なし

注※　イベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定しない場合-1が設定されます。

(115)　イベントID：00003FFBの詳細

属性種別

項目

属性名

属性値

基本属性

イベントID

−

00003FFB

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

Windowsの場合

ヌル文字列

UNIXの場合

root

発行元イベントサーバ名

SOURCESERVER

発行元イベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

−

KAJY63023-I自動対処アクション定義を読み込み対処アクション自動実行機能を稼働状態にしました。次に受信したイベントから読み込んだ定義で処理されます。（定義数：有効な定義数 / 定義内の全定義数, 最後に受信したイベント：到着時刻=最後に処理したイベントの到着時刻 (YYYY/MM/DD HH:MM:SS), 統合監視DB内通し番号=最後に処理したイベントの統合監視DB内通し番号）

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/DD

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

RESPONSEACTION

事象種別

OCCURRENCE

RUN

（凡例）

−：なし

注※　イベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定しない場合-1が設定されます。

(116)　イベントID：00003F80の詳細

属性種別

項目

属性名

属性値

基本属性

イベントID

−

00003F80

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

Windowsの場合

ヌル文字列

UNIXの場合

root

発行元イベントサーバ名

SOURCESERVER

発行元イベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

−

KAJY02073-I IM管理ノード関連情報の生成が正常終了しました

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/DD

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

NODE

事象種別

OCCURRENCE

END

（凡例）

−：なし

注※　イベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定しない場合-1が設定されます。

(117)　イベントID：00003F81の詳細

属性種別

項目

属性名

属性値

基本属性

イベントID

−

00003F81

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※1

発行元グループID

GROUPID

-1〜65,535※1

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

Windowsの場合

ヌル文字列

UNIXの場合

root

発行元イベントサーバ名

SOURCESERVER

発行元イベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

−

KAJY02074-E IM管理ノード関連情報の生成に失敗しました (戻り値 : 戻り値, 詳細 : 詳細)※2

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/DD

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

NODE

事象種別

OCCURRENCE

ERROR

（凡例）

−：なし

注※1　イベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定しない場合-1が設定されます。

注※2　メッセージが1,024バイト以上の場合，1,023バイト以下まで切り捨てた文字列が設定されます。1,023バイト目がマルチバイト文字の途中だった場合は，その文字も切り捨てます。

(118)　イベントID：00003F82の詳細

属性種別

項目

属性名

属性値

基本属性

イベントID

−

00003F82

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

Windowsの場合

ヌル文字列

UNIXの場合

root

発行元イベントサーバ名

SOURCESERVER

発行元イベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

−

KAJY02075-I IM管理ノード関連情報の反映が正常終了しました

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/DD

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

NODE

事象種別

OCCURRENCE

END

（凡例）

−：なし

注※　イベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定しない場合-1が設定されます。

(119)　イベントID：00003F83の詳細

属性種別

項目

属性名

属性値

基本属性

イベントID

−

00003F83

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※1

発行元グループID

GROUPID

-1〜65,535※1

発行元ユーザー名

USERNAME

Windowsの場合

SYSTEM

UNIXの場合

root

発行元グループ名

GROUPNAME

Windowsの場合

ヌル文字列

UNIXの場合

root

発行元イベントサーバ名

SOURCESERVER

発行元イベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

−

KAJY02076-E IM管理ノード関連情報の反映に失敗しました (戻り値 : 戻り値, 詳細 : 詳細)※2

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/DD

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

NODE

事象種別

OCCURRENCE

ERROR

（凡例）

−：なし

注※1　イベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定しない場合-1が設定されます。

注※2　メッセージが1,024バイト以上の場合，1,023バイト以下まで切り捨てた文字列が設定されます。1,023バイト目がマルチバイト文字の途中だった場合は，その文字も切り捨てます。

3.2.3　JP1/IM - Agentが発行するJP1イベント一覧

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

パフォーマンスデータを監視して発行するJP1イベントの属性一覧を，次に示します。

表3‒3　 パフォーマンスデータを監視して発行するJP1イベントの属性一覧

分類

項目名

属性名

説明

基本属性

イベントID

ID

アラート設定ファイル（jpc_alerting_rules.yml）の項目「jp1_pc_eventid」に設定した値※

注※　jp1_pc_eventidを設定していない場合は「00007600」が設定されます。

メッセージ

MESSAGE

アラートの発火条件を満たしたとき

アラート設定ファイル（jpc_alerting_rules.yml）の項目「jp1_pc_firing_description」に設定した値から生成した文字列※

注※　jp1_pc_firing_descriptionを設定していない場合は「The alert is firing.(alert=アラート名)」が設定されます。

アラートの発火条件を満たさなくなったとき

アラート設定ファイル（jpc_alerting_rules.yml）の項目「jp1_pc_resolved_description」に設定した値から生成した文字列※

注※　jp1_pc_resolved_descriptionを設定していない場合は「The alert is resolved.(alert=アラート名)」が設定されます。

拡張属性（共通情報）

重大度

SEVERITY

アラートの発火条件を満たしたとき

アラート設定ファイル（jpc_alerting_rules.yml）の項目「jp1_pc_severity」に設定した値※

注※　jp1_pc_severityを設定していない場合は空文字を設定します。

アラートの発火条件を満たさなくなったとき

Information

プロダクト名

PRODUCT_NAME

「/HITACHI/JP1/JPCCS2」または「/HITACHI/JP1/JPCCS2/xxxx」

xxxxはユーザー任意の値。

オブジェクトタイプ

OBJECT_TYPE

ALARM

オブジェクト名

OBJECT_NAME

アラート名※

注※

アラート設定ファイル（jpc_alerting_rules.yml）の項目「alert」に設定した値

事象種別

OCCURRENCE

NOTICE

発生元ホスト名

JP1_SOURCEHOST

Yet another cloudwatch exporterのパフォーマンスデータを判定したアラートかどうかによって，設定値が異なります。

Yet another cloudwatch exporterの場合

EC2のメトリックのパフォーマンスデータである場合，AWSのjp1_pc_nodelabelタグに設定されている値を発生元ホスト名として設定します。jp1_pc_nodelabelを設定していない場合は空文字を設定します。

EC2以外のメトリックである場合，Yet another cloudwatch exporterのディスカバリ設定ファイルの項目「targets」に設定されている統合エージェントのホスト名を，発生元ホスト名として設定します。targetsを設定していない場合は空文字を設定します。

Yet another cloudwatch exporter以外の場合

ディスカバリ設定ファイルの項目「targets」に設定されている監視対象ホスト名を，発生元ホストとして設定します。targetsを設定していない場合は空文字を設定します。

なお，Blackbox exporter（ICMP監視）のディスカバリ設定ファイルの項目「targets」にIPアドレスを設定している場合は，発生元ホスト名としてIPアドレスを設定します。

拡張属性（固有情報）

PP名

PPNAME

/HITACHI/JP1/JPCCS2

アラートの発火日時

JPC_TIME

アラートの発火日時をUTC 1970-01-01 00:00:00からの秒数で格納します。

JP1/IM - Managerに同梱するイベント拡張属性定義ファイルで，attrステートメントに「type="elapsed_time/date_format:CLIENT"」を指定します。

回復アラートの場合，発火アラートの時刻と同じになります。

詳細については，マニュアル「JP1/Integrated Management 3 - Manager コマンド・定義ファイル・APIリファレンス」の「イベント拡張属性定義ファイル（会社名_製品名_attr_xx.conf）」（2.　定義ファイル）の「type="elapsed_time/date_format:CLIENT"」を説明している個所を参照してください。

統合エージェントのホスト名

JPC_PROMETHEUS

Prometheus設定ファイル（jpc_prometheus_server.yml）の項目「jp1_pc_prome_hostname」に設定した値※

注※　jp1_pc_prome_hostnameを設定していない場合は空文字を設定します。

スクレイプジョブ

JPC_JOB

Prometheus設定ファイル（jpc_prometheus_server.yml）のscrape_configsで，job_nameに設定した値

jp1_pc_nodelabel

JPC_NODELABEL

Prometheus設定ファイル（jpc_prometheus_server.yml）のscrape_configsで，項目「jp1_pc_nodelabel」に設定した値※

注※　jp1_pc_nodelabelを設定していない場合は空文字を設定します。

Exporter名

JPC_EXPORTER

ディスカバリ設定ファイルの項目「jp1_pc_exporter」に設定した値※

注※

指定していない場合は，「Unknown Exporter」となります。

メトリック名

JPC_METRICNAME

アラート設定ファイル（jpc_alerting_rules.yml）の項目「jp1_pc_metricname」に設定した値※

注※　jp1_pc_metricnameを設定していない場合は空文字を設定します。

jp1_pc_remote_monitor_instance

JPC_REMOTE_

MONITOR_INSTANCE

ディスカバリ設定ファイルの項目「jp1_pc_remote_monitor_instance」に設定した値※

注※

指定していない場合は，属性を設定しません。

AWS サービス名

JPC_AWS_SERVICE

AWSのサービス名

Yet another cloudwatch exporterのパフォーマンスデータの場合だけ設定します。

アラート設定ファイル（jpc_alerting_rules.yml）の項目「jp1_pc_metricname」に設定したメトリック名に対応するサービス名を，メトリック定義ファイルから探索して設定します。jp1_pc_metricnameを設定していない場合は空文字を設定します。

AWS アカウント

JPC_AWS_ACCOUNT

AWSのアカウント文字列

Yet another cloudwatch exporterのパフォーマンスデータの場合だけ設定します。

AWS定義ファイル（aws_settings.conf）に記述したAWSアカウントIDに対応する文字列です。定義が存在しない場合は「default」を設定します。

AWS リージョン名

JPC_AWS_REGION

Yet another cloudwatch exporterで監視しているAWSのリージョン名

Yet another cloudwatch exporterのパフォーマンスデータの場合だけ設定します。

注※　dimension_InstanceIdラベルが存在しない場合は空文字を設定します。

AWS InstanceId

JPC_AWS_DIM_INSTANCEID

AWS/EC2のディメンション名

Yet another cloudwatch exporterのパフォーマンスデータでdimension_InstanceIdラベルが存在する場合だけ設定します。

AWS FunctionName

JPC_AWS_DIM_FUNCTIONNAME

AWS/Lambdaのディメンション名

Yet another cloudwatch exporterのパフォーマンスデータでdimension_FunctionNameラベルが存在する場合だけ設定します。

AWS Resource

JPC_AWS_DIM_RESOURCE

AWS/Lambdaのディメンション名

Yet another cloudwatch exporterのパフォーマンスデータでdimension_Resourceラベルが存在する場合だけ設定します。

AWS BucketName

JPC_AWS_DIM_BUCKETNAME

AWS/S3のディメンション名

Yet another cloudwatch exporterのパフォーマンスデータでdimension_BucketNameラベルが存在する場合だけ設定します。

AWS StorageType

JPC_AWS_DIM_STORAGETYPE

AWS/S3のディメンション名

Yet another cloudwatch exporterのパフォーマンスデータでdimension_StorageTypeラベルが存在する場合だけ設定します。

AWS FilterId

JPC_AWS_DIM_FILTERID

AWS/S3のディメンション名

Yet another cloudwatch exporterのパフォーマンスデータでdimension_FilterIdラベルが存在する場合だけ設定します。

AWS TableName

JPC_AWS_DIM_TABLENAME

AWS/DynamoDBのディメンション名

Yet another cloudwatch exporterのパフォーマンスデータでdimension_TableNameラベルが存在する場合だけ設定します。

AWS StateMachineArn

JPC_AWS_DIM_STATEMACHINEARN

AWS/Statesのディメンション名

Yet another cloudwatch exporterのパフォーマンスデータでdimension_StateMachineArnラベルが存在する場合だけ設定します。

AWS QueueName

JPC_AWS_DIM_QUEUENAME

AWS/SQSのディメンション名

Yet another cloudwatch exporterのパフォーマンスデータでdimension_QueueNameラベルが存在する場合だけ設定します。

コンポーネント名

JPC_COMPONENT

コンポーネント名

JP1/IM - Agentのどの製品プラグインに関連するJP1イベントかを設定します。

jp1pccs_azure.jsの場合

/HITACHI/JP1/JPCCS/AZURE/CONFINFO

jp1pccs_kubernetes.jsの場合

/HITACHI/JP1/JPCCS/KUBERNETES/CONFINFO

jp1pccs.jsの場合

「/HITACHI/JP1/JPCCS/CONFINFO」または空文字

(2)　テキスト形式のログファイルを監視して発行するJP1イベント

ログ監視機能によりテキスト形式のログファイルを監視し，ユーザーが指定した条件に一致するログが出力されたときに発行するJP1イベントです。ログ監視機能については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「3.15.3 JP1/IM - Agentによるログ監視機能」を参照してください。

表3‒4　テキスト形式のログファイルを監視して発行するJP1イベントの属性一覧

分類

項目名

属性名

説明

基本属性

イベントID

ID

テキスト形式のログファイルの監視定義ファイルの，JP1イベントIDに指定した値です。

初期値は「00007601」を設定します。

メッセージ

MESSAGE

テキスト形式のログファイルの監視定義ファイルの，ログを解析する正規表現で，「MESSAGE」という名前でキャプチャした値です。

拡張属性（共通情報）

重大度

SEVERITY

テキスト形式のログファイルの監視定義ファイルの，重大度に指定した値です。

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/JPCCS2/LOGTRAP/IM管理ノードのラベル名

オブジェクトタイプ

OBJECT_TYPE

LOGFILE

オブジェクト名

OBJECT_NAME

ログを出力したファイルのファイル名です。

登録名タイプ

ROOT_OBJECT_TYPE

LOGFILE

登録名

ROOT_OBJECT_NAME

ログを出力したファイルのファイル名です。

拡張属性（固有情報）

プラットフォーム

PLATFORM

Windowsの場合：NT

Linuxの場合：UNIX

PP名

PPNAME

/HITACHI/JP1/JPCCS2

発生元ホスト名

JP1_SOURCEHOST

ログを出力したホストのホスト名です。論理ホスト環境の場合は，論理ホスト名です。

監視名

JP1_TRAP_NAME

テキスト形式のログファイルの監視定義ファイルの，監視名に指定した値です。

ログ登録日時

JPC_LOG_TIME

テキスト形式のログファイルの監視定義ファイルの，ログを解析する正規表現で，「time」という名前でキャプチャした値です。キャプチャしていない場合，Fluentdがログを監視した日時です。

time_t型（UTC 1970-01-01 00:00:00からの秒数）

jp1_pc_nodelabel

JPC_NODELABEL

テキスト形式のログファイルの監視定義ファイルの，IM管理ノードのラベル名に指定した値です。

任意の項目

任意の属性名

任意の値です。

ユーザーは，ログのメッセージをキャプチャし，任意の値を任意の属性名の値として設定することができます。設定方法については，マニュアル「JP1/Integrated Management 3 - Manager コマンド・定義ファイル・APIリファレンス」の「テキスト形式のログファイルの監視定義ファイル（fluentd_@@trapname@@_tail.conf.template）」（2.　定義ファイル）の[Attributes Settings]セクションの記載を参照してください。

(3)　Windowsイベントログを監視して発行するJP1イベント

ログ監視機能によりWindowsイベントログを監視し，ユーザーが指定した条件に一致するログが出力されたときに発行するJP1イベントです。ログ監視機能については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「3.15.3 JP1/IM - Agentによるログ監視機能」を参照してください。

表3‒5　Windowsイベントログを監視して発行するJP1イベントの属性一覧

分類

項目名

属性名

説明

基本属性

イベントID

ID

Windowsイベントログの監視定義ファイルの，JP1イベントIDに指定した値です。初期値は「00007602」を設定します。

メッセージ

MESSAGE

Windowsイベントログのメッセージです。

最大1,023バイトです。超えた分は切り捨てて表示します。

拡張属性（共通情報）

重大度

SEVERITY

Windowsのイベントビューアーの"レベル"または"キーワード"に表示される内容に応じて登録します。

重大度の値と表示される内容を次に示します。

Critical：重大

Error：エラー

Warning：警告

Information：情報，詳細，その他

Notice：成功の監査，失敗の監査

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/JPCCS2/LOGTRAP/ソース

ソースはWindowsのイベントビューアーの"ソース"に表示される内容（レンダリング情報のProviderの文字列（変換できない場合はProviderNameの値））を示します。

オブジェクトタイプ

OBJECT_TYPE

LOGFILE

オブジェクト名

OBJECT_NAME

NTEVENTLOG

登録名タイプ

ROOT_OBJECT_

TYPE

LOGFILE

登録名

ROOT_OBJECT_NAME

NTEVENTLOG

拡張属性（固有情報）

Windowsログ登録日時

A0

Windowsのイベントビューアーの"ログの日付"に表示される日時です。

time_t型（UTC 1970-01-01 00:00:00からの秒数）

コンピュータ名

A1

Windowsのイベントビューアーの"コンピューター"に表示される内容です。

NT ログ種別

A2

System/Security/Application/Setup/

Directory Service/DNS Server/File

Replication Service/Internet Explorer/Key

Management Service/HardwareEvents

その他，Windowsのイベントビューアーの"ログの名前"に表示される内容です。

NT ログ種類

A3

Critical/Error/Warning/Information/

Verbose/Audit_Success/Audit_Failure

（level，keywordの値により決定します※）

NTログ分類

A4

Windowsのイベントビューアーの"タスクのカテゴリ"に表示される内容です。（Taskをレンダリングした文字列）

レンダリング文字列に変換できない場合：（Taskの値）

分類できなかった場合：None

NTイベントID

A5

Windowsのイベントビューアーの"イベントID"に表示される内容です。

NTユーザー名

A6

Windowsのイベントビューアーの"ユーザー"に表示される内容です。

NTログレベル

A7

Windowsのイベントビューアーの"レベル"に表示される内容です。

NTログキーワード

A8

Windowsのイベントビューアーの"キーワード"に表示される内容です。

NTログオペコード

A9

Windowsのイベントビューアーの"オペコード"に表示される内容です。

プラットフォーム

PLATFORM

NT

PP名

PPNAME

/HITACHI/JP1/JPCCS2

発生元ホスト名

JP1_SOURCEHOST

ログを出力したホストのホスト名。論理ホスト環境の場合は，論理ホスト名です。

監視名

JP1_TRAP_NAME

Windowsイベントログの監視定義ファイルの，ログ監視名に指定した値です。

jp1_pc_nodelabel

JPC_NODELABEL

Windowsイベントログの監視定義ファイルの，IM管理ノードのラベル名に指定した値です。

注※

NT ログ種類の設定文字列を次に示します。

NT ログ種別がSecurityの場合

keywordの値を元に，「keywordの値:設定文字列」の形式で，次に示すNT ログ種類の値を設定します。

0x10000000000000:Audit_Success, 0x20000000000000:Audit_Failure

値のビット論理積が0でない場合，設定文字列は属性値です。どちらも0である場合，「-」を値として設定します。

NT ログ種別がSecurityでない場合

levelの値を元に，「levelの値:設定文字列」の形式で，次に示すNT ログ種類の値を設定します。

1:Critical，2:Error, 3:Warning, 4:Information, 5:Verbose, その他:Information

(4)　統合エージェント制御基盤が切断されたときに発行するJP1イベント

統合エージェント制御基盤のポーリング監視機能により，統合エージェント制御基盤から統合エージェント管理基盤へ一定期間接続がない場合に発行するJP1イベントです。統合エージェント制御基盤のポーリング監視機能については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「3.15.8 統合エージェント制御基盤のポーリング監視」を参照してください。

表3‒6　統合エージェント制御基盤が切断されたときに発行するJP1イベントの属性一覧

分類

項目名

属性名

説明

基本属性

イベントID

ID

00007620

メッセージ

MESSAGE

KNBC20043-E

拡張属性（共通情報）

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/JPCCS2

オブジェクトタイプ

OBJECT_TYPE

IMAGTHC

オブジェクト名

OBJECT_NAME

IMAGENT

事象種別

OCCURRENCE

NOTICE

拡張属性（固有情報）

発生元ホスト名

JP1_SOURCEHOST

統合エージェント管理基盤に一定期間接続がなかった統合エージェント制御基盤をインストールしている統合エージェントホスト名です。

(5)　統合エージェント制御基盤が接続されたときに発行するJP1イベント

統合エージェント制御基盤のポーリング監視機能により，統合エージェント制御基盤が統合エージェント管理基盤に接続したときに発行するJP1イベントです。統合エージェント制御基盤のポーリング監視機能については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「3.15.8 統合エージェント制御基盤のポーリング監視」を参照してください。

表3‒7　統合エージェント制御基盤が接続されたときに発行するJP1イベントの属性一覧

分類

項目名

属性名

説明

基本属性

イベントID

ID

00007621

メッセージ

MESSAGE

KNBC20044-I

拡張属性（共通情報）

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/JPCCS2

オブジェクトタイプ

OBJECT_TYPE

IMAGTHC

オブジェクト名

OBJECT_NAME

IMAGENT

事象種別

OCCURRENCE

NOTICE

拡張属性（固有情報）

発生元ホスト名

JP1_SOURCEHOST

統合エージェント管理基盤に接続した統合エージェント制御基盤をインストールしている統合エージェントホスト名です。

(6)　統合エージェント制御基盤が正常に停止するときに発行するJP1イベント

統合エージェント制御基盤のポーリング監視機能により，統合エージェント制御基盤が正常に停止するときに発行するJP1イベントです。統合エージェント制御基盤のポーリング監視機能については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「3.15.8 統合エージェント制御基盤のポーリング監視」を参照してください。

表3‒8　統合エージェント制御基盤が正常に停止するときに発行するJP1イベントの属性一覧

分類

項目名

属性名

説明

基本属性

イベントID

ID

00007622

メッセージ

MESSAGE

KNBC20045-I

拡張属性（共通情報）

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/JPCCS2

オブジェクトタイプ

OBJECT_TYPE

IMAGTHC

オブジェクト名

OBJECT_NAME

IMAGENT

事象種別

OCCURRENCE

NOTICE

拡張属性（固有情報）

発生元ホスト名

JP1_SOURCEHOST

停止する統合エージェント制御基盤をインストールしている統合エージェントホスト名です。

(7)　エージェントの追加を検知したときに発行するJP1イベント

表3‒9　エージェントの追加を検知したときに発行するJP1イベントの属性一覧

分類

項目名

属性名

説明

基本属性

イベントID

−

初期値は「00007630」※1を設定します。

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※2

発行元グループID

GROUPID

-1〜65,535※2

発行元ユーザー名

USERNAME

Windowsの場合：SYSTEM

UNIXの場合：root

発行元グループ名

GROUPNAME

Windowsの場合：ヌル文字列

UNIXの場合：root

発行元イベントサーバ名

SOURCESERVER

発行元イベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

−

KNBC00030-I

拡張属性（共通情報）

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/JPCCS2

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

IMBASE

事象種別

OCCURRENCE

NOTICE

（凡例）−：なし

注※1

このJP1イベントはマネージャーノードに紐づけられます。マネージャーが複数ある構成の場合は，直接繋がっているマネージャーノードにのみ紐づけられます。

注※2

イベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定しなかった場合は，-1が設定されます。

(8)　エージェントの削除を検知したときに発行するJP1イベント

表3‒10　エージェントの削除を検知したときに発行するJP1イベントの属性一覧

分類

項目名

属性名

説明

基本属性

イベントID

−

初期値は「00007631」※1を設定します。

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※2

発行元グループID

GROUPID

-1〜65,535※2

発行元ユーザー名

USERNAME

Windowsの場合：SYSTEM

UNIXの場合：root

発行元グループ名

GROUPNAME

Windowsの場合：ヌル文字列

UNIXの場合：root

発行元イベントサーバ名

SOURCESERVER

発行元イベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

−

KNBC00031-I

拡張属性（共通情報）

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/JPCCS2

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

IMBASE

事象種別

OCCURRENCE

NOTICE

（凡例）−：なし

注※1

このJP1イベントはマネージャーノードに紐づけられます。マネージャーが複数ある構成の場合は，直接繋がっているマネージャーノードにのみ紐づけられます。

注※2

イベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定しなかった場合は，-1が設定されます。

(9)　エージェント情報の更新を検知したときに発行するJP1イベント

表3‒11　エージェント情報の更新を検知したときに発行するJP1イベントの属性一覧

分類

項目名

属性名

説明

基本属性

イベントID

−

初期値は「00007632」※1を設定します。

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※2

発行元グループID

GROUPID

-1〜65,535※2

発行元ユーザー名

USERNAME

Windowsの場合：SYSTEM

UNIXの場合：root

発行元グループ名

GROUPNAME

Windowsの場合：ヌル文字列

UNIXの場合：root

発行元イベントサーバ名

SOURCESERVER

発行元イベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

−

KNBC00032-I

拡張属性（共通情報）

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/JPCCS2

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

IMBASE

事象種別

OCCURRENCE

NOTICE

（凡例）−：なし

注※1

このJP1イベントはマネージャーノードに紐づけられます。マネージャーが複数ある構成の場合は，直接繋がっているマネージャーノードにのみ紐づけられます。

注※2

イベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定しなかった場合は，-1が設定されます。

(10)　定義ファイルの削除に成功したときに発行するJP1イベント

表3‒12　定義ファイルの削除に成功したときに発行するJP1イベントの属性一覧

分類

項目名

属性名

説明

基本属性

イベントID

−

初期値は「00007640」を設定します。

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合：SYSTEM

UNIXの場合：root

発行元グループ名

GROUPNAME

Windowsの場合：ヌル文字列

UNIXの場合：root

発行元イベントサーバ名

SOURCESERVER

発行元イベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

−

次のどれかを設定します。

KNBC20015-W

KNBC20016-W

KNBC20017-W

KNBC20018-W

KNBC00018-I

拡張属性（共通情報）

重大度

SEVERITY

Infomation

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/JPCCS2

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

JP1/IM - Managerの定義ファイルを操作した場合

FILEOPERATION_MANAGER

統合エージェントの定義ファイルを操作した場合

FILEOPERATION_AGENT

事象種別

OCCURRENCE

NOTICE

（凡例）−：なし

注※

イベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定しなかった場合-1が設定されます。

(11)　定義ファイルの削除に失敗したときに発行するJP1イベント

表3‒13　定義ファイルの削除に失敗したときに発行するJP1イベントの属性一覧

分類

項目名

属性名

説明

基本属性

イベントID

−

初期値は「00007641」を設定します。

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合：SYSTEM

UNIXの場合：root

発行元グループ名

GROUPNAME

Windowsの場合：ヌル文字列

UNIXの場合：root

発行元イベントサーバ名

SOURCESERVER

発行元イベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

−

次のどれかを設定します。

KNBC00012-E

KNBC00013-E

KNBC00015-E

KNBC00017-E

KNBC00010-E

KNBC00014-E

KNBC20009-E

KNBC20012-E

KNBC20014-E

KNBC20023-E

拡張属性（共通情報）

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/JPCCS2

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

JP1/IM - Managerの定義ファイルを操作した場合

FILEOPERATION_MANAGER

統合エージェントの定義ファイルを操作した場合

FILEOPERATION_AGENT

事象種別

OCCURRENCE

NOTICE

（凡例）−：なし

注※

イベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定しなかった場合-1が設定されます。

(12)　定義ファイルの更新に成功したときに発行するJP1イベント

表3‒14　定義ファイルの更新に成功したときに発行するJP1イベントの属性一覧

分類

項目名

属性名

説明

基本属性

イベントID

−

初期値は「00007642」を設定します。

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合：SYSTEM

UNIXの場合：root

発行元グループ名

GROUPNAME

Windowsの場合：ヌル文字列

UNIXの場合：root

発行元イベントサーバ名

SOURCESERVER

発行元イベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

−

次のどれかを設定します。

KNBC20020-W

KNBC20021-W

KNBC20016-W

KNBC20017-W

KNBC20019-E

拡張属性（共通情報）

重大度

SEVERITY

Infomation

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/JPCCS2

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

JP1/IM - Managerの定義ファイルを操作した場合

FILEOPERATION_MANAGER

統合エージェントの定義ファイルを操作した場合

FILEOPERATION_AGENT

事象種別

OCCURRENCE

NOTICE

（凡例）−：なし

注※

イベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定しなかった場合-1が設定されます。

(13)　定義ファイルの更新に失敗したときに発行するJP1イベント

表3‒15　定義ファイルの更新に失敗したときに発行するJP1イベントの属性一覧

分類

項目名

属性名

説明

基本属性

イベントID

−

初期値は「00007643」を設定します。

イベントDB内通し番号

SEQNO

イベントDB内通し番号

発行元プロセスID

PROCESSID

0

登録時刻

TIME

登録時刻

到着時刻

ARRIVEDTIME

到着時刻

発行元ユーザーID

USERID

-1〜65,535※

発行元グループID

GROUPID

-1〜65,535※

発行元ユーザー名

USERNAME

Windowsの場合：SYSTEM

UNIXの場合：root

発行元グループ名

GROUPNAME

Windowsの場合：ヌル文字列

UNIXの場合：root

発行元イベントサーバ名

SOURCESERVER

発行元イベントサーバ名

発行元イベントDB内通し番号

SOURCESEQNO

発行元イベントDB内通し番号

メッセージ

−

次のどれかを設定します。

KNBC20009-E

KNBC20012-E

KNBC20014-E

KNBC20022-E

KNBC20023-E

KNBC00012-E

KNBC00013-E

KNBC00015-E

KNBC00016-E

KNBC00010-E

KNBC00014-E

拡張属性（共通情報）

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/JPCCS2

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

JP1/IM - Managerの定義ファイルを操作した場合

FILEOPERATION_MANAGER

統合エージェントの定義ファイルを操作した場合

FILEOPERATION_AGENT

事象種別

OCCURRENCE

NOTICE

（凡例）−：なし

注※

イベントサーバ設定ファイルに指定した代用ユーザーIDおよび代用グループIDが設定されます。指定しなかった場合-1が設定されます。

4　ユーザー作成プラグイン

JP1/IM - Manager（インテリジェント統合管理基盤）では，ユーザーが作成したプラグインで処理を行うこともできます。ユーザー作成プラグインについて説明します。

4.1　ユーザー作成プラグインによって実現できること

ユーザーはプラグインを作成して，連携製品の管理ツールから情報を取得し，インテリジェント統合管理基盤で管理できます。ユーザー作成プラグインで提供する処理を次の図に示します。

図4‒1　ユーザー作成プラグインで提供する処理

図中の番号に従って説明します（図中の丸付き番号は，次に示す番号にそれぞれ対応しています）。

管理ツールAの管理対象にIDを付与し，収集します。

DとGの関連情報を収集・設定します。

IM管理ノードのツリーのSIDを取得します。

管理対象の情報を取得します。

JP1イベントと管理対象を紐付することで，管理対象のステータスを管理※します。

JP1イベントの情報から連携製品のURLを取得し，連携製品の画面を表示します。

注※　ステータスの管理は，管理対象からJP1イベントが発行されることが前提となります。

4.1.1　ユーザー作成プラグインの形式

ユーザー作成プラグインはjavascriptで作成し，CommonJS modulesの形式でプラグインの機能を提供します。ユーザー作成プラグインの記述形式と構成情報取得が起きた場合に呼び出されるメソッドの記述例を，次に示します。

記述形式

module.exports = {
          ユーザー作成プラグインの処理
};

記述例

module.exports = {
          // Operations performed when configuration information is retrieved
          __configurationGet : function(args) {
                 // Determine if the configuration collection should be processed with args.component
                 if (args.component !== "/HITACHI/JP1/PP/CONFINFO") {
                         return;
                 }

// If yes:
                 // When args.data contains configuration information in JSON format, pass it as it is
args.setResult(args.data);
          },
};

ユーザー作成プラグインの記述規則を次に示します。

プラグインファイル名：「製品名.js」

例：jp1pfm.js，jp1ajs.jsなど

エンコード：ASCII

言語：英語

コメントも英語で記述します。

サポートする改行コード

「CR」，「LF」，「CR+LF」

重要

ユーザーが新しくメソッドを作成する場合，アンダースコアで始まるメソッド名は付けないでください。

4.2　管理対象の設定と検討

JP1/IM - Manager（インテリジェント統合管理基盤）で管理する対象を新たに追加する場合は，管理対象に関する設定と検討が必要です。

4.2.1　ホストを追加する

管理対象を管理対象のホストとして追加する場合，次に示す定義ファイルにホストを追加する設定が必要です。

システムノード定義ファイル（imdd_systemnode.conf）

構成取得対象ホスト定義ファイル（imdd_target_host.conf）

定義ファイルの詳細については，「システムノード定義ファイル（imdd_systemnode.conf）」（2.　定義ファイル）および「構成取得対象ホスト定義ファイル（imdd_target_host.conf）」（2.　定義ファイル）を参照してください。

4.2.2　SIDの検討

追加する管理対象には，その管理対象を表すSIDを設定する必要があります。SIDの詳細については「7.1　SID」を参照してください。

ここでは，次のホストを管理対象に追加する場合を例にして，説明します。

管理ツールAが動作するホストA

管理ツールAが管理するエージェントホストB

次の内容で設定します。

管理ツールAに関わるSIDを表すためのSIDの種別：「_ToolA-M_」

ホストを表すSIDの種別：予約語の「_HOST_」を使用する

管理ツールAが動作するホストのSID：「_ToolA-M_hostA/_HOST_hostA」

ホストAが管理するエージェントホストのSIDの種別：「_ToolA-A_」

ホストBを表すSID：「_ToolA-M_hostA/_ToolA-A_hostB/_HOST_hostB」

重要

SIDの種別は「_」から始まり「_」で終わる任意の文字列で定義します。また，「_JP1」，または「_HITACHI」から始まる文字列，「_ROOT_」，「_SYSTEM_」，「_CATEGORY_」，「_SUBCATEGORY_」，「_OBJECT_」から始まる文字列は使用できません。なお．大文字・小文字は区別しません。

JP1イベントで監視対象のステータスを管理する場合，JP1イベントの情報から管理ノードのSIDを作成する必要があります。JP1イベントの内容からSIDが作成できるかどうか確認した上で，SIDについて検討してください。

4.2.3　SIDのvalue値の検討

設定したSIDには付加情報としてvalue値を設定できます。JP1/IM - Manager（インテリジェント統合管理基盤）では，次の表に示す変数を用意しています。

表4‒1　変数名と指定内容

項番

変数名

指定内容

1

component

管理対象の管理元である製品名やそのコンポーネント名を指定します。「SYSTEM」，「DEFAULT」，または「HITACHIから始まる文字列」は予約語のため指定できません。

指定できる文字は，ASCII文字の数字，大文字の英字，「/」です。240バイト以内で指定します。

指定例

/VENDOR/TOOLA

2

category※

各構成要素に対応するカテゴリ情報（categoryId）を指定します。

3

subCategory

製品名称など，カテゴリ内の分類を指定します。

指定できる文字は，制御文字を除く文字です。255文字以内で指定します。

4

label

ツリーに表示する構成要素の表示名称を変更する場合に，変更後の名称を指定します。

5

methods

当該構成要素に対して，プラグイン処理実行REST APIにより実行可能なプラグイン関数の名称を，配列の形式で指定します。

注※

IM管理ノードカテゴリ名称定義ファイル（imdd_category_name.conf）に定義されているcategoryIdを，255文字以内の半角英数字で指定します。

標準提供のカテゴリ以外を指定する場合は，IM管理ノードカテゴリ名称定義ファイルに定義を追加します。定義ファイルの詳細については，「IM管理ノードカテゴリ名称定義ファイル（imdd_category_name.conf）」（2.　定義ファイル）を参照してください。

category変数に指定できるカテゴリIDを次に示します。

表4‒2　category変数に指定できるカテゴリID

項番

表示カテゴリ名称

指定カテゴリID

1

Job

job

2

Service Response

serviceResponse

3

Enterprise

enterprise

4

Transaction Processing

transactionProcessing

5

Application Server

applicationServer

6

Database

database

7

Platform

platform

8

Service

service

9

Virtual Machine

virtualMachine

10

Management Applications

managementApplications

11

Other Applications

otherApplications

12

任意の表示カテゴリ

任意のカテゴリ

categoryIdとして「up」，categoryNameとして「User Program」を追加した場合の例を次に示します。

{
"meta":{
    "version":"1"
    },
    "categoryData":[
       {"categoryId":"job","categoryName":"Job"},
       {"categoryId":"serviceResponse","categoryName":"Service Response"},
       {"categoryId":"enterprise","categoryName":"Enterprise"},
       {"categoryId":"transactionProcessing","categoryName":"Transaction Processin"},
       {"categoryId":"applicationServer","categoryName":"Application Server"},
       {"categoryId":"database","categoryName":"Database"},
       {"categoryId":"platform","categoryName":"OS"},
       {"categoryId":"service","categoryName":"Service"},
       {"categoryId":"virtualMachine","categoryName":"仮想マシン"},
       {"categoryId":"otherApplications","categoryName":"Other Applications"},
       {"categoryId":"up","categoryName":"User Program"}
    ]
}

4.3　管理対象からの情報取得

管理対象からは，次のどちらかの方法で情報を取得できます。

アダプタコマンド

REST API

アダプタコマンドは1度だけ実行されます。

アダプタコマンドは必ず作成する必要があります。

4.3.1　アダプタコマンドでの情報取得

JP1/IM - Manager（インテリジェント統合管理基盤）でユーザー作成プラグインを作成して管理対象から情報を取得する場合は，ユーザー作成プラグインとともにアダプタコマンドが必要となります。アダプタコマンドの実行は一度だけです。複数回実行して情報を取得することはできません。また，アダプタコマンドとユーザー作成プラグインは1対1の関係です。

アダプタコマンドは，インテリジェント統合管理基盤と標準入出力を使用して通信を行い，インテリジェント統合管理基盤から起動されると，インテリジェント統合管理基盤に対する応答を，標準出力で出力します。

(1)　戻り値

アダプタコマンドは，処理結果の概要を戻り値で返却します。

表4‒3　アダプタコマンドの戻り値

項番

戻り値

機能

1

0

正常終了

2

1〜49

ワーニング発生時のエラーに割り当てる。（一部の情報だけ取得失敗など。）

3

50〜99

リトライ可能な一時的なエラーに割り当てる。

4

100〜149

環境不正（バージョンが異なるなど）

5

150〜199

プログラム不正

戻り値の範囲内で，アダプタコマンド独自の戻り値を追加することもできます。アダプタコマンド実行時のエラーに関する詳細情報は，別途標準エラー出力で返却する必要があります。

(2)　実行ディレクトリ

アダプタコマンドが配置されているディレクトリに設定されます。

(3)　入出力

アダプタコマンドとインテリジェント統合管理基盤とのデータ通信には，引数，標準入力，標準出力および標準エラー出力が使用されます。

アダプタコマンドの標準入力，標準出力は，「共通ヘッダー」と「データ本体」から構成されます。「データ本体」にアダプタコマンドからインテリジェント統合管理基盤に渡す情報を記入します。

形式を次に示します。

共通ヘッダー<改行コード(<CR><LF> or <LF>)>データ本体

ヘッダーの構成を次に示します。ヘッダーはCSV形式で表示されます。

プロトコル名称,プロトコルバージョン,文字コード,プログラムプロダクト名称

ヘッダーの詳細を次に示します。

項番

名称

形式

設定値

1

プロトコル名称

文字列

JBSPGCMD

2

プロトコルバージョン

「アダプタコマンド設定ファイルのバージョン」※と同じバージョンを設定してください。

例

12000000

3

文字コード

アダプタコマンドの実行環境に合わせて，次の文字コードを設定してください。

8859_1

SJIS

MS932

EUCJIS

UTF-8

GB18030

4

製品名称

「コンポーネント識別子」※と同じ値を設定してください。

注※

詳細については「7.3.2　アダプタコマンド設定ファイル」を参照してください。

アダプタコマンド実行時にエラーが発生した場合は，標準エラー出力で詳細を出力します。その際の出力内容は，ASCII文字の範囲で設定してください。

(4)　注意事項

次のコマンドはアダプタコマンドとして使用できません。

サブ入力コマンド（対話操作）を必要とするコマンド

エスケープシーケンスや制御コードを伴うコマンド

コマンド実行先でウインドウを作成するコマンド

デーモンなどの，終了しないコマンド

アダプタコマンドは多重起動される可能性があります。多重起動が不可能なアダプタコマンドの場合は独自に排他処理を行い，多重起動された場合はビジーとして返却するようにしてください。

標準入出力による送受信は，同時に実行できません。標準入力によって要求を受信するアダプタコマンドの場合は，要求データをすべて受信したあとに応答データの送信を開始してください。

アダプタコマンドは，次の権限で実行されます。

Windowsの場合：SYSTEM

UNIXの場合：root

アダプタコマンドにはタイムアウト時間があります。このため，タイムアウトする前に応答の返却が終わる必要があります。タイムアウト時間は60分です。

(5)　アダプタコマンド設定ファイル

アダプタコマンド設定ファイルで，アダプタコマンドのファイル名を設定します。命名規則を次に示します。

Adapter_SIDに指定するコンポーネント名.conf

指定例

「Adapter_SIDに指定するコンポーネント名」が「/VENDOR/TOOLA」の場合

Adapter_VENDOR_TOOLA.conf

アダプタコマンド設定ファイルの格納先を次に示します。

Windowsの場合

JP1/Baseインストールフォルダ¥plugin¥conf

UNIXの場合

/opt/jp1base/plugin/conf

アダプタコマンド設定ファイルの設定項目を次に示します。ラベルと値を，タブまたはスペース区切りで記載してください。

表4‒4　アダプタコマンド設定ファイルの設定項目

項番

項目名

ラベル

設定値

1

アダプタコマンド設定ファイルのバージョン

fileversion

12000000

2

アダプタコマンドのパス

cmdpath

アダプタコマンドのコマンド名を含めたパスを，フルパス形式で指定します。ダブルクォートなどでパスを囲む必要はありません。

3

アダプタコマンドと連携する製品

upperpp

/HITACHI/JP1/IM/DD

4

アダプタコマンド種別

componenttype

JDD_CONFINFO

アダプタコマンド設定ファイルの設定例を次に示します。

fileversion     12000000
cmdpath         C:¥Program Files (x86)¥Hitachi¥jp1pc¥bin¥jp1getconfinfo.exe
upperpp         /HITACHI/JP1/IM/DD
componenttype   JDD_CONFINFO

重要

1行に記述できるのは，4,096文字までです。

同じラベル名が複数存在した場合は，エラーとなります。

必須のラベルが指定されていなかった場合はエラーとなります。

ファイル中に1つでもエラーが存在した場合は，そのファイルは無効となります。

ファイルの終端は改行となります。

ファイルに記載できるのはASCII文字だけです。

ラベルを指定する場合，行頭に空白，タブの指定はできません。

空白，タブだけの行は無視されます。

4.3.2　REST APIでの情報取得

ユーザー作成プラグインの__configurationGetメソッドでjp1Imdd.callRestメソッドを利用すると，任意のREST APIを実行できます。jp1Imdd.callRestメソッドについては「4.5.1　jp1Imdd.callRest」を参照してください。

4.4　実装可能なメソッド

ユーザー作成プラグインではパラメーターの情報を参照し，自身が処理可能なものだけを処理するように実装します。また，処理できない場合は，即時returnするようにしてください。処理できない場合にsetErrorメソッドなどのメソッドを呼び出ししないでください。

4.4.1　実装可能なメソッド形式

ユーザー作成プラグインで実装できるメソッドの形式を次に示します。

表4‒5　提供するメソッドの形式

項番

項目

名前

説明

1

メソッド名

−

各メソッド名

2

パラメーター

args

各メソッドを参照してください。

3

戻り値

なし

4

例外

なし

例外の代わりにargs.setErrorメソッドによって，エラー通知します。詳細は「4.4.4(1)　__configurationGetメソッド」を参照してください。

4.4.2　ユーザー作成プラグインの実装規約

ユーザー作成プラグインの実装規約を次に示します。

ユーザーまたはREST APIを使用するシステムからJP1/IMに要求があった場合，JP1/IMはその要求に対応するメソッドを，プラグインを意識せずに一律で呼び出します。

プラグインはメソッドのパラメーターの情報を参照し，プラグインが処理可能なものだけを処理します。処理できない場合はsetErrorメソッド呼び出しやログ出力などの処理はせずに，即時returnしてください。

これは，即時returnせずにsetErrorメソッド呼び出しをした場合，次のプラグインが呼び出されず，呼び出し処理が終了してしまうためです。

プラグインが処理可能かどうかは，基本的にパラメーターのsidの値で判断されます。sid以外の情報で判断する必要があるものについては，各メソッドを参照してください。

4.4.3　ユーザー作成プラグインの言語規約

ユーザー作成プラグインのメソッドにlang（言語情報）を渡す場合，JP1/IMの画面からメソッドを実行する際はWWWブラウザーの言語設定が渡され，REST APIからメソッドを実行する際はHTTPリクエストのAccept-Languageヘッダーに指定された値が渡されます。

ユーザー作成プラグインは，「ja」または「ja-JP」が指定された場合は日本語として，「en」が指定された場合は英語として，動作するようにしてください。

その他の値が指定された場合の動作は，各ユーザー作成ラグインで規定してください。langが省略された，または規定していない値が指定された場合は，「en」が指定されたと仮定して動作するようにしてください。

4.4.4　メソッド一覧

ユーザー作成プラグインで実装するメソッド一覧を次に示します。

なお，すべてのメソッドを実装する必要はありません。各製品で実装が必要なものだけを選択して実装してください。各製品のプラグインメソッドについては，各製品のマニュアルを参照してください。

表4‒6　ユーザー作成プラグインで実装するメソッド一覧

項番

カテゴリ

メソッド名

説明

4.1の番号※2

1

構成情報取得

__configurationGet

構成情報を取得するメソッドです。

1

2

__configurationGetAdapterless

構成情報を取得するメソッドです（アダプタコマンドが未セットアップの場合）

3

__createTreeNode

ツリー情報を取得するメソッドです。

4

イベント

__eventGet

JP1イベントを処理するメソッドです。

5

5

__transformEvent

（外部システムで発生した）イベント情報をJP1イベントに変換するメソッドです。

6

関連情報取得

__createLink

取得した構成間の関連を生成する処理を行うメソッドです。

2

7

__linkValueGet

リンク情報の詳細情報を取得するメソッドです。

8

__simtLoad

IM管理ノードがローディングされたときに必要な関連情報を収集するメソッドです。

9

トレンド情報取得

__metricListGet

取得可能な時系列データのメトリックの一覧を取得するメソッドです。

3

10

__timeSeriesDataGet

時系列データを取得するメソッドです。

11

url情報取得

__urlGet

モニター起動用のURLを取得するメソッドです。

6

12

ユーザー作成の任意のメソッド※1

ユーザー作成の任意のメソッド※1

ユーザーが作成する任意のメソッドです。

「_」アンダースコアから始まるメソッド名は付けないでください。

3

注※1

ユーザー作成の任意のメソッドは，プラグイン処理実行API（im_api_v1_actions）経由で実行されます。プラグイン処理実行API（im_api_v1_actions）については「5.7.1　プラグイン処理実行」を参照してください。

注※2

「4.1　ユーザー作成プラグインによって実現できること」で説明した番号と対応しています。

(1)　__configurationGetメソッド

機能

各製品の構成情報をJSON形式で返却するメソッドです。構成取得対象ホスト定義ファイル（imdd_target_host.conf）にホスト名を記述した場合に，インテリジェント統合管理基盤では，アダプタコマンドを実行したあとアダプタコマンドの戻り値を確認し，戻り値が0のときだけこのメソッドを呼び出します。

構成情報の取得が正常に終了した場合

__configurationGetメソッド内でargs.setResult（JSON形式の構成情報）メソッドを呼び出します。

構成情報の取得に失敗した場合

args.setResultメソッドではなくargs.setError（エラーメッセージ）メソッドを呼び出します。

__configurationGetメソッド内では，自身が処理可能なコンポーネントの場合，args.setResultメソッドかargs.setErrorメソッドのどちらかのメソッドを必ず呼び出してください。

__configurationGetメソッドは，インテリジェント統合管理基盤のシステム管理ツリーを作成するjddcreatetreeコマンドの中で呼び出されます。

各ユーザー作成プラグインではargs.componentの値を参照し，自身が処理可能かどうかを判定してください。

パラメーター

__configurationGetメソッドのパラメーターを次に示します。

表4‒7　__configurationGetメソッドのパラメーター

項番

メンバー

説明

備考

1

hostname

構成情報の取得元ホスト名

なし

2

component

構成情報の管理元コンポーネント名

"/HITACHI/JP1/PFM/CONFINFO"

3

data

アダプタコマンドの実行結果

ヘッダー情報に記載されている文字コードに基づき，UTF-8形式に変換された文字列です。

ヘッダー情報は含まれません。

なし

4

jp1UserName

JP1ユーザー名

各製品の管理者権限を持つユーザー

5

jp1Token

jp1UserNameのJP1トークン

JP1トークンはBASE64エンコード済み

6

protocolName

プロトコル名称

アダプタコマンドの実行結果に含まれていたヘッダー情報

7

protocolVersion

プロトコルバージョン

アダプタコマンドの実行結果に含まれていたヘッダー情報

8

codeset

文字コード

アダプタコマンドの実行結果に含まれていたヘッダー情報

9

productName

製品名称

アダプタコマンドの実行結果に含まれていたヘッダー情報

10

setResult(String json)

JSON形式の構成情報をセットするメソッド

なし

11

setError(String message)

エラー通知用のメソッド

エラーメッセージをセットします。

12

stderr

アダプタコマンドが標準エラー出力に出力した値を格納する

注意

setResultに設定する構成情報は，構成要素ごとにvalue情報を付加したSIDを付与する必要があります。SIDの詳細については「7.1　SID」を参照してください。

返却する構成情報一覧

__configurationGetメソッドが返却する構成情報の一覧について説明します。

取得形式

{
  "meta":{
    "timestamp":"作成時刻(ISO8601形式 UTC時刻)",
    "objectRoot":[
        {
           "type":"オブジェクトルートノード種別",
           "defaultSystem":
           {
             "name":"デフォルトシステムノードの構造化IDの名称",
             "label":"デフォルトシステムノードの表示名"
           }
        },…
                 ]
         },
  "simtData":[
    {"sid":"<SID>","value":{付与情報}},
    …
             ]
}

記述内容

取得したインフラ一覧の記述内容を次に示します。

表4‒8　取得したインフラ一覧の記述内容

項番

項目名

データ型

説明

1

meta

Object

ファイルの情報を格納するオブジェクト

2

timestamp

string

ファイル作成の年月日，日時をISO8601形式のUTC時刻で返却する

この属性は省略できません。

時間はJP1/IM - Managerのサーバ時間です。

3

objectRoot

配列

オブジェクトルートノード種別とデフォルトのシステムノード情報を格納する配列

この属性は省略できます。

4

type

string

ツリーのルートノードおよびシステムノード配下に配置するオブジェクトルートノード種別（ネットワーク機器(NETWORKDEVICE)やストレージ(STORAGE)など）を表す

ホスト(HOST)の指定は不要です。必ずツリーのルートノードおよびシステムノード配下に配置してください。

この属性は省略できます。省略した場合は，ホストだけをツリーのルートノードおよびシステムノード配下に配置します。

5

defaultSystem

Object

オブジェクトルートノードが親ノードとなるデフォルトのシステムノードを作成する場合に指定する

この属性を省略した場合，typeで指定したオブジェクトルートノードのデフォルトのツリーノードは，AllSystems直下に配置されます。

6

name

string

デフォルトのシステムノードの構成情報のSIDの名称を指定する

この属性を省略した場合，オブジェクトルートノード種別を構成情報のSIDの名称とします。

7

label

string

デフォルトのシステムノードのlabelを指定する

この属性を省略した場合，デフォルトのシステムノードの付与情報にlabel属性は設定されません。

8

simtData

配列

構成情報の配列

9

sid

string

構成情報のSIDを表す

10

value

Object

付与情報を表す

取得例

__configurationGetメソッドが各製品から取得する情報については，「7.1.4　各製品から取得する情報」を参照してください。

setResultでセットした構成情報による影響

setResultでセットした構成情報によって，影響を受ける機能と影響内容について，次の表に示します。

表4‒9　影響する機能一覧

項番

機能名

影響内容

1

システムのステータス監視

IM管理ノードの取得機能が，セットした構成情報をIM管理ノードファイルとして出力します。

IM管理ノードツリー生成機能※が構成情報を元にツリーを生成し，IM管理ノードツリーファイルとして出力します。

__eventGetメソッドが構成情報のSIDを使用します。__eventGetによって，JP1イベントとIM管理ノードをマッピングします。

2

IM管理ノードによるシステムの統合監視

__createLink，またはIM管理ノードリンク定義ファイル（imdd_nodeLink_def.conf）で，構成情報のSIDを使用します。

typeがrootJobnetExecutionOrder（ルートジョブネット実行順序）のIM管理ノードリンクに従い，業務フローを表示します。

3

カスタムUI表示

構成情報のSIDに従い，カスタムUIの画面を表示します。

4

関連ノード表示

__createLink，またはIM管理ノードリンク定義ファイル（imdd_nodeLink_def.conf）で，構成情報のSIDを使用します。IM管理ノードリンクに従い，関連ノードを表示します。

5

IM管理ノードのプロパティ表示

構成情報の付与情報(value)のpropertyに設定した情報を表示します。

6

連携製品画面の起動

構成情報の付与情報(value)のmethodsに__urlGetが設定されているIM管理ノードについて，連携製品元の画面を起動します。

7

トレンド情報表示

構成情報の付与情報(value)のmethodsに__metricListGetおよび__timeSeriesDataGetが設定されているIM管理ノードについて，指定したメトリックのトレンド情報を表示します。

8

IM管理ノードごとのトレンドデータ管理

構成情報の付与情報（value）のjp1im_TrendData_labelsを参照し，jp1TrendDataService.getTrendDataメソッドの引数promQLQueryで，PromQL文内に指定した置き換え文字列「$jp1im_TrendData_labels」の値を設定します。

構成情報の付与情報のjp1im_TrendData_labelsが設定されていない場合，該当する管理ノードに関連するトレンドデータの取得はできません。

jp1TrendDataService.getTrendDataメソッドの詳細については，「4.5.17 jp1TrendDataService.getTrendData」を参照してください。

注※

IM管理ノードツリー生成機能については「7.4　IM管理ノードツリー生成機能」を参照してください。

(2)　__configurationGetAdapterlessメソッド

機能

__configurationGetAdapterlessメソッドと同様に，各製品の構成情報をJSON形式で返却するメソッドです。SaaSの監視など，アダプタコマンドを実装できない場合にこのメソッドを実装して使用します。構成取得対象ホスト定義ファイル（imdd_target_host.conf）に，ホスト名を記述しない（製品だけを記述）場合に，インテリジェント統合管理基盤がこのメソッドを呼び出します。

各ユーザー作成プラグインでこのメソッドを実装する場合は，args.componentの値を参照し，自身が処理可能か否かを判定してください。

なお，このメソッドを実装する上で必要な固有の環境情報（例えば，SaaSを監視する際の認証関連の情報など）は，ユーザー作成プラグインの定義ファイルに記述します。詳細については，「4.6.1 ユーザー作成プラグインで使用する定義ファイル」を参照してください。

パラメーター

__configurationGetAdapterlessメソッドのパラメーターを次に示します。

表4‒10　__configurationGetAdapterlessメソッドのパラメーター

項番

メンバー

説明

備考

1

component

構成情報の管理元コンポーネント名

"/HITACHI/JP1/PFM/"+構成取得対象定義ファイル（imm_target_host.conf）のproductに指定した製品名

2

jp1UserName

JP1ユーザー名

各製品の管理者権限を持つユーザー

3

jp1Token

jp1UserNameのJP1トークン

JP1トークンはBASE64エンコード済み

4

setResult(String json)

JSON形式の構成情報をセットするメソッド

なし

5

setError(String message)

エラー通知用のメソッド

エラーメッセージをセットします。

注意

setResultに設定する構成情報は，構成要素ごとにvalue情報を付加したSIDを付与する必要があります。SIDの詳細については「7.1　SID」を参照してください。

構成情報の取得が正常に終了した場合

__configurationGetAdapterlessメソッド内でargs.setResult（JSON形式の構成情報）メソッドを呼び出します。

構成情報の取得に失敗した場合

args.setResultメソッドではなくargs.setError（エラーメッセージ）メソッドを呼び出します。

__configurationGetAdapterlessメソッド内では，自身が処理可能なコンポーネントの場合，args.setResultメソッドかargs.setErrorメソッドのどちらかのメソッドを必ず呼び出してください。

__configurationGetAdapterlessメソッドは，インテリジェント統合管理基盤のシステム管理ツリーを作成するjddcreatetreeコマンドの中で呼び出されます。

返却する構成情報一覧

__configurationGetAdapterlessメソッドが返却する構成情報の一覧の取得形式，記述内容，およびsetResultでセットした構成情報による影響は，__configurationGetメソッドと同じです。

__configurationGetメソッドとの使い分けについて

__configurationGetメソッドと__configurationGetAdapterlessメソッドの主な違いを下記の表に示します。

表4‒11　__configurationGetメソッドと__configurationGetAdapterlessメソッドの比較

メソッド名

構成取得対象定義

ファイルの記述

固有の環境情報の取得方法

備考

__configurationGet

製品とホスト名

アダプタコマンドまたはユーザー作成プラグインの定義ファイル

JP1/Baseが必要

__configurationGetAdapterless

製品だけ

ユーザー作成プラグインの定義ファイル

なし

そのため，__configurationGetメソッドと__configurationGetAdapterlessメソッドを使い分けについては，下記の表の通りになります。

表4‒12　__configurationGetメソッドと__configurationGetAdapterlessメソッドの使い分け

利用メソッド名

利用ケース

__configurationGet

（セキュリティなどの理由で）製品プラグインの定義ファイルに環境情報を記述したくない場合

__configurationGetAdapterless

JP1/Baseをインストールできない場合

アダプタコマンドを実装するのが手間な場合（アダプタコマンドを使う必要がない場合）

(3)　__createTreeNodeメソッド

機能

入力情報のsimtDataに対応するツリーのSIDおよび付与情報を取得し，JSON形式で返却するメソッドです。

ユーザー作成プラグインに__createTreeNodeメソッドを実装すると，JP1/IMのデフォルトツリーをカスタマイズできます。デフォルトツリーの詳細については「7.4.2　ノード生成機能」を参照してください。

ユーザー作成プラグインは，simtDataのツリーのSIDがカスタマイズ対象ツリーノードのターゲットの場合にツリーノードオブジェクトを生成し，それをsetResultします。ターゲットのオブジェクトタイプと名前がどちらも同じsimtDataの場合は，ツリー上で同一ノードにします。このため，オブジェクトタイプと名前がどちらも同じsimtDataは，同じツリーのSIDを返却するように設定してください。

カスタマイズ対象のツリーノードの親ノードをカスタマイズしない場合は，treeNodeCreatorオブジェクトを使用して親ノード部分のツリーのSID取得し，ツリーのSIDの一部として使用してください。

ツリーのSIDおよび付与情報の取得が正常に終了した場合

__createTreeNodeメソッド内でargs.setResult（JSON形式のツリーのSID）メソッドを呼び出します。

ツリーのSIDおよび付与情報の取得に失敗した場合

args.setResultメソッドではなくargs.setError（エラーメッセージ）メソッドを呼び出します。

__createTreeNodeメソッド内では，自身が処理可能なSimtDataの場合，args.setResultメソッドかargs.setErrorメソッドのどちらかのメソッドを必ず呼び出してください。

__createTreeNodeメソッドは，インテリジェント統合管理基盤のシステム管理ツリーを作成するjddcreatetreeコマンドの中で呼び出されます。

パラメーター

__createTreeNodeメソッドのパラメーターを次に示します。

表4‒13　__createTreeNodeメソッドのパラメーター

項番

メンバー

説明

備考

1

jp1UserName

JP1ユーザー名

なし

2

jp1Token

jp1UserNameに対応するJP1認証トークン

3

simtData

ツリーのSIDを取得したいSimtData

4

treeNodeCreator

作成済みのノード情報の管理およびデフォルトのツリー作成機能を提供するオブジェクト

詳細は「4.4.4(3)(a)　treeNodeCreatorオブジェクト」を参照してください。

5

setResult (String json)

JSON形式の取得したツリーのSIDおよび付与情報をセットするメソッド

6

setError (String message)

エラー通知用のメソッド

エラーメッセージをセットします。

返却するツリーのSIDおよび付与情報の形式

__createTreeNodeメソッドが返却するツリーのSIDおよび付与情報の形式について説明します。

取得形式

{
    "meta":{
        "componentName":"ツリー情報の取得対象コンポーネント名"
    },
    "simtData":[
        {"sid":"ツリーのSID","value":{付与情報}},
        ・・・
   ]
}

記述内容

取得したツリーのSIDおよび付与情報の記述内容を次に示します。

表4‒14　取得したツリーのSIDおよび付与情報の記述内容

項番

項目名

データ型

説明

1

meta

Object

メタ情報を表す

2

componentName

string

ツリー情報の取得対象コンポーネント名を表す

3

simtData

Object

simtDataを表す

4

sid

string

ツリーのSIDを表す

5

value

Object

付与情報を表す

取得例

__createTreeNodeメソッドの取得例を次に示します。

{
    "meta":{
        "componentName":"/HITACbHI/JP1/OA/CONFINFO"
    },
    "simtData":[
        {
           "sid":"_ROOT_AllSystems/_HOST_host1/_CATEGORY_job
           /_SUBCATEGORY_JP1%2FAJS3%20-%20Manager/_OBJECT_AJSROOT1",
           "value":
             {
                "target":["_JP1AJS-M_host1/_HOST_host1/_JP1SCHE_AJSROOT1"],
                "label":"AJSROOT1"}}
             }
        }
    ]
}

setResultでセットしたIM管理ノードツリー情報による影響

setResultでセットしたIM管理ノードツリー情報によって，影響を受ける機能と影響内容について，次の表に示します。

表4‒15　影響する機能一覧

項番

機能名

影響内容

1

システムのステータス監視

IM管理ノードツリー生成機能※が生成したツリー情報に，IM管理ノードツリー情報をマージして，IM管理ノードツリーファイルとして出力します。

注※

IM管理ノードツリー生成機能については「7.4　IM管理ノードツリー生成機能」を参照してください。

(a)　treeNodeCreatorオブジェクト

treeNodeCreatorオブジェクトは，getObjectRootTreeSIDメソッド，getHostNameDefメソッドおよびgetCategoryNameメソッドを提供します。

(b)　getObjectRootTreeSIDメソッド

getObjectRootTreeSIDメソッドは，パラメーターで指定したtarget（SID）に対応するツリーのSIDを返却するメソッドです。オブジェクトノードの親ノードをカスタマイズしない場合に使用し，オブジェクトノードのツリーのSIDの一部として使用します。

パラメーター

getObjectRootTreeSIDメソッドのパラメーターを次に示します。

表4‒16　 getObjectRootTreeSIDメソッドのパラメーター

項番

項目名

データ型

説明

1

target

string

カスタマイズするツリーノードの親ノードに当たるオブジェクトルートノードの構成情報のSID

2

objectRoot

Object[]

オブジェクトルートノードの情報

次の形式で指定します。

[{"type":"オブジェクトルートノード種別"},,,},※…]

注※

オブジェクト内の指定形式は，__configurationGetメソッドで取得する構成情報のmeta.objectRootと同じです。詳細については「4.4.4(1)　__configurationGetメソッド」を参照してください。

戻り値

targetに対応したツリーのSIDを返却します。戻り値は，getObjectRootTreeSIDメソッドを呼び出すタイミングのツリーノードの生成状況に応じて異なります。

表4‒17　getObjectRootTreeSIDメソッドの戻り値

項番

生成状況

戻り値

1

ツリーノードが生成済みの場合

targetに対応した生成済みのツリーのSIDを返却する

2

ツリーノードが生成されていない場合

targetの内容を解析して，システムノード定義ファイル（imdd_systemnode.conf），ホスト名定義ファイル（imdd_host_name.conf）の定義内容に基づいたツリーのSIDを生成する

システムノード定義ファイル（imdd_systemnode.conf）の定義内容に一致しない場合は，デフォルトのツリーのSIDを返却します。

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

(c)　getHostNameDefメソッド

getHostNameDefメソッドは，ホスト名定義ファイル（imdd_host_name.conf）に従って，パラメーターで指定したhostNameに対応するホスト名定義を返却するメソッドです。HOSTノードのツリーをカスタマイズする場合はこのメソッドを使用し，HOSTノードのツリーのSIDの名称とラベルとして使用します。

パラメーター

getHostNameDefメソッドのパラメーターを次に示します。

表4‒18　 getHostNameDefメソッドのパラメーター

項番

項目名

データ型

説明

1

hostName

string

ホスト名（エイリアス名）を指定する

戻り値

getHostNameDefメソッドは，ホスト名定義ファイル（imdd_host_name.conf）の定義内容に従って，次の値を返却します。

{"hostName":"定義ファイルの値","label":"定義ファイルの値"}

対応するホスト名定義が無い場合は，nullを返却します。

ホスト名定義ファイル（imdd_host_name.conf）については，「ホスト名定義ファイル（imdd_host_name.conf）」（2.　定義ファイル）を参照してください。

(d)　getCategoryNameメソッド

getCategoryNameメソッドは，パラメーターで指定したcategory（ID）に対応するカテゴリ名を返却するメソッドです。カスタマイズするツリーにCATEGORYノードを含む場合はこのメソッドを使用し，ツリーのSIDのラベルとして使用します。

パラメーター

getCategoryNameメソッドのパラメーターを次に示します。

表4‒19　 getCategoryNameメソッドのパラメーター

項番

項目名

データ型

説明

1

category

string

categoryのID

戻り値

getCategoryNameメソッドは，IM管理ノードカテゴリ名称定義ファイル（imdd_category_name.conf）の定義内容に従って，categoryに対応するカテゴリ名を返却します。

対応するカテゴリ名の定義が無い場合は，nullを返却します。

IM管理ノードカテゴリ名称定義ファイル（imdd_category_name.conf）については，「IM管理ノードカテゴリ名称定義ファイル（imdd_category_name.conf）」（2.　定義ファイル）を参照してください。

(4)　__eventGetメソッド

機能

各製品から発行されるすべてのJP1イベントに対応する構成情報のSIDを返却するメソッドです。各ユーザー作成プラグインでは，各製品が発行するすべてのJP1イベントに対して，構成情報のSIDを返却する必要があります。各ユーザー作成プラグインでは，args.productNameなどの値を参照し，自身が処理可能なイベントかどうかを判定します。

発行されたJP1イベントに対応する構成情報のSIDの生成が正常に終了した場合

__eventGetメソッド内でargs.setTargetSid（構成情報のSID）メソッドを呼び出します。

発行されたJP1イベントの情報に不足があり，そのJP1イベントに対応する構成情報のSIDの生成に失敗した場合

args.setError（エラーメッセージ）メソッドは呼び出さず，returnして処理を終了します。

__eventGetメソッドは，インテリジェント統合管理基盤がJP1イベントを取得したタイミングで呼び出されます。

パラメーター

__eventGetメソッドのパラメーターを次に示します。

表4‒20　__eventGetメソッドのパラメーター

項番

メンバー

説明

備考

1

productName

プロダクト名

なし

2

idBase

イベントID

10進数の数値

3

event

JP1イベントの情報

event.sid：JP1イベントのSID

event.value：JP1イベントのvalue値※

4

setTargetSid(String sid)

JP1イベントに対応する構成情報のSIDをセットするメソッド

なし

5

setError(String message)

エラー通知用のメソッド

エラー通知をセットします。

注※

value値には，イベントの各種属性名と属性値が格納されています。次の形式で，属性名に対応する属性値が取得できます。

value['属性名']

基本属性の場合は「B.」を拡張属性の場合は「E.」を，属性名の前に記載してください。

指定例：value['E.JPC_MGR']

setTargetSidをセットしたSID情報による影響

setTargetSidをセットしたSID情報によって，影響を受ける機能と影響内容について，次の表に示します。

表4‒21　影響を受ける機能一覧

項番

機能名

影響内容

1

システムのステータス監視

構成情報のSIDがtargetとなっているIM管理ノードとJP1イベントをマッピングします。

jddupdatetreeコマンドを構成変更モードで実行した場合，このメソッドで返却した構成情報のSIDのホスト名情報が，構成から削除された構成情報のSIDのJP1イベントの再マッピング先のホストを決定するために使用されます。

(5)　__transformEventメソッド

機能

入力となるJSON形式のデータを，JP1イベントに変換するメソッドです。

ユーザー作成プラグイン，または製品プラグインに実装する__transformEventメソッドでは，JP1イベント変換のAPIで受信した，外部システムで発生したイベント情報を，JP1イベントに変換できます。

パラメーター

__ transformEventメソッドのパラメーターを次に示します。

表4‒22　__transformEventメソッドのパラメーター

項番

メンバー

説明

1

eventData

連携製品から受信したイベント情報（JSON形式）

2

jp1eventmax

発行できるJP1イベント数の最大値

3

setResult(String json)

連携製品から受信したイベント情報を変換したJP1イベント（JSON形式）を設定するメソッド

4

setError(String message)

エラー通知用のメソッド

エラーコードとメッセージをセットします。

プラグインで，__transformEventメソッドを使用する場合は，入力となるイベント情報のデータが，自プラグインで処理すべきデータかどうかを，__transformEventメソッド内で判定するように実装する必要があります。

また，判定結果に応じて，自プラグインで処理すべきデータのときだけ，返却するJP1イベントをsetResultに設定するように実装する必要があります。自プラグインで処理すべきデータでないときは，何も設定せずにreturnしてください。

__transformEventメソッドが返却するsetResultに設定するJP1イベントは，次に示す形式で設定します。

返却されたJP1イベントの形式は，呼び出し元のJP1イベント変換のAPIでチェックします。不正な形式の場合，JP1イベント変換のAPIは，レスポンスボディーにKAJY67000-Wメッセージを出力します。

また，100件を超えるJP1イベントの件数は発行できません。setResultに100件を超える件数のJP1イベントが設定されている場合，JP1/IM - Manager側では，JP1イベントの配列の先頭から100件までの件数のイベントを発行し，それ以降のイベントを発行しません。プラグイン内では，発行されなかったイベントの詳細を，ログに出力するなどして判別できるようにしてください。

なお，__transformEventメソッドでは，作成対象のJP1イベントに対する属性の値が不正かどうかのチェックを行いません。属性の値が不正な場合，JP1/IM - ManagerのJP1イベント変換のAPIでエラーとなり，エラーとなったJP1イベントを発行しません。

返却するJP1イベントの形式

記述形式

{
  "pluginName":プラグイン名,
  "exceedJp1eventMaxDetected":変換されたJP1イベント数の上限超過検知有無
  "events":[
    {
      “eventId”:イベントID,
      “message”:メッセージ,
      “attrs”:{拡張属性名:拡張属性値, ...}
    },
    ...
  ]
}

記述内容

項番

項目名

データ型

説明

1

pluginName

文字列

プラグインを表す文字列を設定します。

JP1イベント変換のAPI※で，エラーメッセージを生成する場合に使用します。

この項目は省略できません。

2

exceedJp1eventMaxDetected

boolean

変換したJP1イベントの件数が上限を超えたことの検知有無を設定します。

上限を超えた場合：true

それ以外の場合：false

この項目は省略できません。

この項目が「true」の場合，JP1イベント変換のAPI※は，レスポンスボディーにKAJY67003-Wを設定します。

3

events

配列

発行するJP1イベントを配列で設定します。

設定できるイベントの件数の上限は100件です。

上限を超えたかどうかは，このメソッドを使用するプラグイン側で判定し，上限を超えた場合は，項目「exceedJp1eventMaxDetected」に「true」を設定して呼び出し元に返却してください。

4

eventId

文字列

発行する基本部イベントIDを，次に示す範囲で設定します。

0〜1FFFF

7FFF8000〜7FFFFFFF

この項目は省略できません。

範囲外の値を指定した場合，JP1イベント変換API※がレスポンスボディーにKAJY67000-Wを設定し，要因に「eventIdの指定が範囲外です。指定する値は0〜1FFF，7FFF8000〜7FFFFFFFの範囲内の値を設定してください。」を設定します。

5

message

文字列

JP1イベントの内容を表すメッセージテキストを設定します。

この項目は省略できません。

登録するメッセージの文字コードは，JP1/IM - Managerが配置されているOS環境の文字コードに依存します。

1,023バイト以内の文字列で設定します。1,024バイト以上の文字列を指定した場合，1,023バイトまでの文字列をJP1イベントのメッセージに設定します。

6

attrs

配列

拡張属性名を配列で指定します。

この項目は省略できます。

同一の拡張属性名を複数指定した場合，最後に指定した拡張属性の値で上書きします。

拡張属性名は，先頭が英大文字で，英大文字，数字，およびアンダースコア（_）ラインから構成される32バイトまでの名称を指定できます。

構成する文字列が不正の場合，JP1イベント変換API※のレスポンスボディーにKAJY67000-Wを設定し，要因に「attrsの拡張属性名が不正です。英字は大文字，先頭は英字を指定してください」を設定します。

32バイトを超える文字列を指定した場合，JP1イベント変換のAPI※がレスポンスボディーにKAJY67000-Wを設定し，要因に「attrsの拡張属性名は32バイト以下の文字列を指定してください。」を設定します。

また，拡張属性名には接頭辞「E.」を指定しないでください。「E.」を指定した場合，JP1イベント変換のAPI※がレスポンスボディーにKAJY67000-Wを設定し，要因に「attrsの拡張属性名が不正です。英字は大文字，先頭は英字を指定してください」を設定します。

すべての拡張属性値の合計の長さは，10,000バイトまで指定できます。

合計の長さの制限を超えた場合，JP1イベント変換のAPI※がレスポンスボディーにKAJY67000-Wを設定し，要因に「attrsの拡張属性値の上限は10000バイトです。10000バイト以下の文字列を指定してください。」を設定します。

JP1イベントの属性の詳細については，「3.1　JP1イベントの属性」を参照してください。

注※

JP1イベント変換のAPIの詳細については，「5.6.5　JP1イベント変換」を参照してください。

記述例

{
  "pluginName":"PFMCS",
  "exceedJp1eventMaxDetected":false
  "events":[
    {
    "eventId":"2FFF",
    "message":"xxxxx",
    "attrs":{"SEVERITY":"Error","JP1_SOURCEHOST":"HOSTB"}
    },
    ...
  ]
}

(6)　__createLinkメソッド

機能

取得した構成間の関連を生成し，JSON形式で返却するメソッドです。

取得した構成間の関連の生成が正常に終了した場合

__createLinkメソッド内でaddResult（JSON形式の取得した構成間の関連情報）メソッドを呼び出します。

構成情報の取得の失敗した場合

addResultメソッドではなく，args.setError（エラーメッセージ）メソッドを呼び出します。

addResultメソッドまたはargs.setErrorメソッドのどちらかのメソッドを，必ず呼び出してください。

__createLinkメソッドは，インテリジェント統合管理基盤のシステム管理ツリーを作成するjddcreatetreeコマンドの中で呼び出されます。

パラメーター

__createLinkメソッドのパラメーターを次に示します。

表4‒23　__createLinkメソッドのパラメーター

項番

メンバー

説明

備考

1

jp1UserName

JP1ユーザー名

なし

2

jp1Token

jp1UserNameに対応するJP1認証トークン

3

simtFileList

構成情報の全リストデータ

IM管理ノードオブジェクトが複数あるデータ構造

4

addResult(String json)

JSON形式の取得した構成間の関連情報をセットするメソッド

なし

5

setError(String message)

エラー通知用のメソッド

エラーコードとメッセージをセットします。

返却する関連情報の形式

__createLinkメソッドが返却する取得した構成間の関連情報の形式について説明します。

取得形式

setResultに設定する構成情報の形式を次に示します。

{
  "meta":{
      "format":"ファイル種別",
      "componentName":"関連情報の取得対象コンポーネント名",
      "timestamp":"関連情報生成時刻"
      },
      "links":[
          {
          "from":"先行ノードのSID",
          "to":"後続ノードのSID",
          "type":"処理対象種別",
          "value":付与情報
      }, ...
  ],
}

記述内容

取得した構成間の関連情報の記述内容を次に示します。

表4‒24　取得した構成間の関連情報の記述内容

項番

項目名

データ型

説明

1

meta

配列

ファイルの情報を格納する配列

2

format

string

ファイルの種別

固定値として「conf」を指定します。

この属性は省略できません。

3

componentName

string

関連情報の取得対象コンポーネント名

この属性は省略できません。

4

timestamp

string

ファイル作成の年月日，日時をISO8601形式のUTC時刻で返却する

この属性は省略できません。

時間は関連情報を生成したJP1/IM - Managerのサーバ時間です。

5

links

配列

構成間の関連情報の配列

配列順序に意味はありません。

from，to，typeが同じ関連情報が複数存在した場合は，jddcreatetreeコマンドでそれぞれ出力されますが，jddupdatetreeコマンドでシステムに反映する際は，最後に出現した関連情報が反映されます。

ただし，JP1/AJSのプラグインからの構成情報(componentNameが「/HITACHI/JP1/AJS3/CONFINFO」)の場合で，typeがrootJobnetExecutionOrder（ルートジョブネット実行順序）でfrom，toが同じときは，基盤がvalue.unit配列に格納されているオブジェクトをマージして単一のlinkオブジェクトとしてIM管理ノードリンクファイルに出力します。

6

from

string

先行ノード

先行ノードのSIDを指定します。

指定例

_ToolA-M_hostA/_HOST_hostA

to属性が指定されている場合，この属性を省略できます。制御文字は指定できません。

7

to

string

後続ノード

後続ノードのSIDを指定します。

指定例

_ToolA-M_hostA/_ToolA-A_hostB/_HOST_hostB

from属性が指定されている場合，この属性を省略できます。制御文字は指定できません。

8

type

string

関連情報の種別を指定する。

「_」アンダースコアから始まる文字列，制御文字は指定できません。255バイト以内の半角英数字で指定します。

typeは同じ意味を持つ関連同士をグループ化する情報です。［統合オペレーション・ビューアー］画面の［関連ノード］タブでは，typeごとに関連をフィルタリングして表示することができます。

JP1/IMの製品内や他製品との連携では次の種別を使用します。

rootJobnetExecutionOrder：ルートジョブネット実行順序の関連

rootJobnetAgent：ルートジョブネットとAJSエージェントの関連

managerAgent：JP1製品のマネージャーとエージェントの関連

sameNode：名称が同一のノードの関連

L2Connection：JP1/NNMiで管理するレイヤー2接続線の関連

Infrastructure：JP1/OAで管理するインフラリソースの関連

monitoringConfiguration：監視製品の構成における製品と監視対象の関連

これらの種別以外に，ユーザーが任意の種別を指定することもできます。

9

value

Object

構成間の関連情報の付与情報を指定する。

種別がrootJobnetAgentの場合に，標準でサポートされているパラメーターを以下に示します。

precedingJob：連携ジョブの先行ジョブを完全名で指定する

succeedingJob：連携ジョブの後続ジョブを完全名で指定する

この属性は省略できます。

取得例

__createLinkメソッドの取得例を次に示します。

{
  "meta":{
      "format":"conf"
      "componentName":"/HITACHI/JP1/AJS3/CONFINFO"
      "timestamp":"2018-11-11T00:00:00Z"
  },
  "links":[
      {
          "from":"JP1AJS-M_AJSM1/_HOST_AJShost1/_JP1SCHE_S1/_JP1JOBG_JG1/_JP1ROOTJOBNET_root1",
          "to":"JP1AJS-M_AJSM2/_HOST_AJShost2/_JP1SCHE_S2/_JP1JOBG_JG2/_JP1ROOTJOBNET_root2",
          "type":"rootJobnetExecutionOrder",
          "value":
             {
                       "precedingJob":"root1/job1",
                       "succeedingJob":"root2/job2",
             }
      }, ...
  ],
}

addResultでセットした関連情報による影響

addResultでセットした関連情報によって，影響を受ける機能と影響内容について，次の表に示します。

表4‒25　影響する機能一覧

項番

機能名

影響内容

1

システムのステータス監視

IM管理ノードの取得機能が，IM管理ノードリンクオブジェクトをIM管理ノードリンクファイルとして出力します。

2

IM管理ノードによるシステムの統合監視

typeがrootJobnetExecutionOrder（ルートジョブネット実行順序）のIM管理ノードリンクに従って，［業務フロー］タブに関連を表示します。

3

関連ノード表示

IM管理ノードリンクに従って，［関連ノード］タブに関連を表示します。

4

連携ユニット表示

typeがrootJobnetExecutionOrder（ルートジョブネット実行順序）のIM管理ノードリンクについて，その付与情報（value）のunitに設定されたユニット情報（__linkValueGetの結果を含む）を表示します。

5

後続ルートジョブネットへの影響表示

typeがrootJobnetExecutionOrder（ルートジョブネット実行順序）のIM管理ノードリンクについて，その付与情報（value）のunitに設定されたユニット（最新世代）が，後続ユニットに及ぼす影響（__linkValueGetの結果）を表示します。

(7)　__linkValueGetメソッド

機能

与えられたJSON形式のリンク情報の配列について，valueパラメーターに動的な付与情報を追加して返却するメソッドです。

プラグインで処理できないリンク情報が含まれる場合，そのリンク情報はそのまま返却されます。

パラメーター

__linkValueGetメソッドのパラメーターを次に示します。

表4‒26　__linkValueGetメソッドのパラメーター

項番

メンバー

説明

備考

1

jp1UserName

JP1ユーザー名

なし

2

jp1Token

jp1UserNameに対応するJP1認証トークン

3

linksData

リンク情報オブジェクトの配列のオブジェクト

4

links

リンク情報オブジェクトの配列

省略されません。空の配列は指定されません。

5

from

先行ノードのSID

なし

6

to

後続ノードのSID

7

type

処理対象種別

8

value

付与情報

9

select

取得するvalueのパラメーターの配列

オブジェクトやオブジェクトの配列のメンバーをさらに指定したい場合は，<オブジェクト名>.<メンバー名>と指定します。

以下の例で"impact"だけを指定したい場合はselectに"unit.impact"と指定します。

"value":{
    "unit": [
        {
           "precedingJob":"job1",
           "succeedingJob":"job2"
           "impact":true
        }
    ]
 }

省略できます。

省略した場合はすべてのパラメーターを取得します。

10

setResult(String json)

JSON形式のリンク情報をセットするメソッド

なし

11

setError(String message)

エラー通知用のメソッド

エラーコードとメッセージをセットします。

返却するリンク情報の形式

__linkValueGetメソッドが返却するリンク情報の形式について説明します。

取得形式

{
   "links": [
      {
          "from":"先行ノードのSID",
          "to":"後続ノードのSID",
          "type":"処理対象種別",
          "value":付与情報
       },  ・・・
  ]
}

記述内容

取得したリンク情報の記述内容を次に示します。

表4‒27　取得したリンク情報の記述内容

項番

項目名

データ型

説明

1

links

配列

リンク情報の配列

2

from

string

先行ノードのSID

3

to

string

後続ノードのSID

4

type

string

処理対象種別

5

value

Object

構成間の関連情報の付与情報を指定する

取得例

__linkValueGetメソッドの取得例を次に示します。

{
   "links": [
      {
         "from":"_JP1AJS-M_HOST1/_HOST_HOST1/_JP1SCHE_schedulerserv/
               _JP1JOBG_jobgroup/_JP1ROOTJOBNET_jobnet1",
         "to":"_JP1AJS-M_HOST1/_HOST_HOST1/_JP1SCHE_schedulerserv/
               _JP1JOBG_jobgroup/_JP1ROOTJOBNET_jobnet2",
         "type":"rootJobnetExecutionOrder",
         "value":{
              "unit": [
                   {
                     "precedingJob":"job1",
                     "succeedingJob":"job2"
                     "succeedingJobStartTime":"2019−05−14T00:00:00Z",
                     "precedingJobURL":"http://10.220.196.82:22252/ajs/…",
                     "succeedingJobURL":"http://10.220.196.82:22252/ajs/…",
                     "impact":"error"
                   }   ・・・
               ],
               "msg":"KAJY04254-E The collecting information process could not be generated."
           }
      }, ・・・
  ]
}

setResultでセットしたリンクの付与情報(value)による影響

setResultでセットしたリンクの付与情報(value)によって，影響を受ける機能と影響内容について，次の表に示します。

表4‒28　影響する機能一覧

項番

機能名

影響内容

1

連携ユニット表示

typeがrootJobnetExecutionOrder（ルートジョブネット実行順序）のIM管理ノードリンクについて，その付与情報（value）のunitに設定された情報を表示します。

また，URLパラメーターは，そのURLを指定したWWWブラウザーを起動します。

2

後続ルートジョブネットへの影響表示

typeがrootJobnetExecutionOrder（ルートジョブネット実行順序）のIM管理ノードリンクについて，その付与情報（value）のunitに設定されたユニット（最新世代）が，後続ユニットに及ぼす影響を表示します。

(8)　__simtLoadメソッド

機能

IM管理ノードがローディングされたときに，必要な関連情報を収集するために呼び出されるメソッドです。次の動作で管理ノードが更新されたときに，simtサービスから呼び出されます。

サービス起動時のsimtDataの読み込み完了時

jddupdatetreeコマンド実行時のsimtDataの読み込み完了時

収集した情報は，グローバル変数に設定するなどで，ほかのメソッドに提供できます。例えば，__simtLoadメソッドで，AJSマネージャーホスト名とAJSエージェントホスト名を収集し，グローバル変数に設定しておくと，ほかのメソッド（__eventGetメソッド）でその情報を参照できます。

関連情報の取得が正常に終了した場合

グローバル変数に設定するなどで，ほかのメソッドへ情報を提供できます。

関連情報の取得に失敗した場合

args.setError（エラーメッセージ）メソッドを呼び出すようにしてください。

パラメーター

__simtLoadメソッドのパラメーターを次に示します。

項番

メンバー

説明

備考

1

simtDataList

構成情報のsimtDataの全リストデータ

管理ノードのマスタ情報にある全simtData情報

2

setError(String message)

エラー通知用のメソッド

エラーコードとメッセージをセットします。

なし

(9)　__metricListGetメソッド

機能

時系列データで表示可能なメトリックの一覧を取得し，JSON形式で返却するメソッドです。

パラメーター

__metricListGetメソッドのパラメーターを次に示します。

表4‒29　__metricListGetメソッドのパラメーター

項番

メンバー

説明

備考

1

jp1UserName

JP1ユーザー名

なし

2

jp1Token

jp1UserNameに対応するJP1認証トークン

3

sid

メトリクス一覧を取得したい構成情報のsid

4

lang

取得するメトリック一覧の言語

5

setResult(String json)

JSON形式の取得したメトリック一覧をセットするメソッド

6

setError(String message)

エラー通知用のメソッド

エラーコードとメッセージをセットします。

返却するメトリック一覧の形式

__metricListGetメソッドが返却するメトリック一覧を次に示します。

取得形式

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

記述内容

取得したメトリック一覧の記述内容を次に示します。

表4‒30　取得したメトリック一覧の記述内容

項番

項目名

データ型

説明

1

metrics

配列

メトリック情報の配列

指定できる要素数は100です。空の配列は指定できません。この項目は省略できません。

2

name

string

メトリック名

半角英数字と以下の記号で指定できます。

-（ハイフン），_（アンダースコア）

1〜255文字以内で指定します。

空文字は指定できません。この項目は省略できません。

3

label

string

メトリック表示名

1〜255文字の制御文字以外の文字で指定します。空文字は指定できません。この項目は省略できます。

4

category

string

メトリックのカテゴリ

1〜255文字の制御文字以外の文字で指定します。空文字は指定できません。この項目は省略できます。

5

description

string

メトリックの説明

1〜1,023文字の制御文字以外の文字で指定します。空文字は指定できません。この項目は省略できます。

JP1/IM - Manager（インテリジェント統合管理基盤）の［オペレーション・ビューアー］画面を使用する場合，長い文字列を指定すると，［トレンド］タブのメトリック表示名のツールチップで表示する文字列が．WWWブラウザーの制限（title属性で表示可能な文字数）によって途中で打ち切られる場合があります。

6

default

boolean

デフォルトのメトリックかどうかを指定する

true：デフォルトのメトリック

false：デフォルトのメトリックでない

デフォルトに指定できるメトリックの数は10までです。この項目は省略できません。

取得例

__metricListGetメソッドの取得例を次に示します。

{
    "metrics":[
      {
        "name":"CPU Usage",
        "label":"CPU使用率",
        "category":"CPU",
        "description":"CPUの使用率をコアごとに表示。（単位%）",
        "default":true
      }
     …
    ]
}

setResultでセットしたメトリック一覧による影響

setResultでセットしたメトリック一覧によって，影響を受ける機能と影響内容について，次の表に示します。

表4‒31　影響する機能一覧

項番

機能名

影響内容

1

トレンド情報表示

［トレンド］タブの［トレンドグラフ設定］領域に，グラフ表示するメトリックの選択候補として一覧表示します。

(10)　__timeSeriesDataGetメソッド

機能

時系列データを取得し，JSON形式で返却するメソッドです。

取得した時系列データのデータ数とインスタンス数がcountPerInstance，instanceCount指定した上限を超える場合は，レスポンスのexceedCountDetectedオブジェクトの該当メンバーをtrueに設定し，データ数をcountPerInstance，instanceCountの範囲に収まるように選定して返却します。

パラメーター

__timeSeriesDataGetメソッドのパラメーターを次に示します。

表4‒32　__timeSeriesDataGetメソッドのパラメーター

項番

メンバー

説明

備考

1

jp1UserName

JP1ユーザー名

なし

2

jp1Token

jp1UserNameに対応するJP1認証トークン

3

sid

時系列データを取得したい構成情報のsid

4

lang

取得する時系列データの言語

5

metric

メトリック名

1〜255文字以内で指定します。

空の配列は指定できません。この項目は省略できません。

6

startTime

時系列データの開始日時をISO 8601形式のUTC時刻で指定する。小数点以下の秒数は指定しない。

7

endTime

時系列データの終了日時をISO 8601形式のUTC時刻で指定する。小数点以下の秒数は指定しない。

8

countPerInstance

取得する1インスタンスあたりのデータ数の上限

countPerInstanceの値とinstanceCountの値を掛けた値が30,000以下であることを保証する。

9

instanceCount

インスタンス数の上限

10

setResult(String json)

JSON形式の時系列データをセットするメソッド

なし

11

setError(String message)

エラー通知用のメソッド

エラーメッセージをセットします。

返却する時系列データの形式

__timeSeriesDataGetメソッドが返却する時系列データを次に示します。

取得形式

{
    "metric":"メトリック",
    "timeSeriesData":[
            {
               "instance":"インスタンス名"
               "unit":"単位",
               "data":[
               {"time":"時刻","value":値},
                   ・・・
            ]
          },
          ・・・
    ],
    "exceedCountDetected": {
        countPerInstance:1インスタンスごとのデータ数上限超過検知有無,
        instanceCount: インスタンス数の上限超過検知有無
    }
}

記述内容

取得した時系列データの記述内容を次に示します。

表4‒33　取得した時系列データの記述内容

項番

項目名

データ型

説明

1

timeSeriesData

配列

時系列データの配列

空の配列は指定できません。この項目は省略できません。

2

metric

string

メトリック名

半角英数字と以下の記号で指定できます。

-（ハイフン），_（アンダースコア）

1〜255文字以内で指定します。

空文字は指定できません。この項目は省略できません。

3

instance

string

インスタンス名

1〜255文字の制御文字以外の文字で指定します。空文字は指定できません。この項目は省略できます。

4

unit

string

メトリックの単位

1〜255文字の制御文字以外の文字で指定します。空文字は指定できません。この項目は省略できません。

5

data

配列

時刻，値の二次元データの配列

指定された期間に時系列データが存在しない場合は，空の配列を指定します。

この項目は省略できません。

6

time

string

データの時刻

ISO 8601形式のUTC時刻です。小数点以下の秒数は指定できません。

dataが空の場合：省略できます。

dataが空以外の場合：省略できません。空文字の指定はできません。

7

value

number

データの値

javascriptのnumberの精度に合わせます。

dataが空の場合：省略できます。

dataが空以外の場合：省略できません。

8

exceedCountDetected

Object

上限検知オブジェクト

この項目は省略できません。

9

countPerInstance

boolean

1インスタンスあたりのデータ数が上限を超えたことの検知有無

上限を超えた場合：true

それ以外の場合：false

この項目は省略できません。

10

instanceCount

boolean

インスタンス数が上限を超えたことの検知有無

上限を超えた場合：true

それ以外の場合：false

この項目は省略できません。

取得例

__timeSeriesDataGetメソッドの取得例を次に示します。

{
    "metric":"CPU Usage",
    "timeSeriesData":[
            {
              "instance":"CPU_1"
              "unit":"%",
              "data":[
                  {"time":"2019-05-22T00:00:00Z","value":14.04},
                                 ・・・
              ]
          },
            {
              "instance":"CPU_2"
              "unit":"%",
              "data":[
                {"time":"2019-05-22T00:00:00Z","value":09.24},
                                 ・・・
            ]
          },
       ・・・
    ],
    "exceedCountDetected": {
        "countPerInstance":true,
        "instanceCount":false
    }

}

指定したメトリック，期間でデータが存在しない場合

{
    "metric":"CPU Usage",
    "timeSeriesData":[
            {
              "unit":"%",
              "data":[
              ]
          }
    ],
    "exceedCountDetected": {
        "countPerInstance": false,
        "instanceCount": false
    }

}

setResultでセットした時系列データによる影響

setResultでセットした時系列データによって，影響を受ける機能と影響内容について，次の表に示します。

表4‒34　影響する機能一覧

項番

機能名

影響内容

1

トレンド情報表示

時系列データをトレンド表示します。

(11)　__urlGetメソッド

機能

指定したSIDに関連するモニター起動用のURLを取得し，JSON形式で返却するメソッドです。

パラメーター

__urlGetメソッドのパラメーターを次に示します。

表4‒35　__urlGetメソッドのパラメーター

項番

メンバー

説明

備考

1

jp1UserName

JP1ユーザー名

なし

2

jp1Token

jp1UserNameに対応するJP1認証トークン

3

sid

関連するモニター起動用のURLを取得したい構成情報のSID

4

setResult(String json)

JSON形式のURL情報をセットするメソッド

5

setError(String message)

エラー通知用のメソッド

エラーメッセージをセットします。

返却するモニター起動用URLの形式

__urlGetメソッドが返却するモニター起動用のURLを次に示します。

取得形式

{
    urlList:[
       {
            "url":"モニター起動用URL",
            "name":"URLの名称"
       },
       …
    ]
}

記述内容

取得したモニター起動用のURLの記述内容を次の表に示します。

表4‒36　取得したモニター起動用のURL情報の記述内容

項番

項目名

データ型

説明

1

urlList

配列

URL情報オブジェクトの配列

2

url

string

URLの文字列

3

name

string

URLの名称

取得例

__urlGetメソッドの取得例を次に示します。

{
    urlList:[
       {
            "url":"http://10.220.196.82:22252/ajs/login.html?manager=10.220.196.82&type=monitor…",
            "name":"rootJobNet1のモニター起動画面"
       }
    ]
}

setResultでセットしたURL情報による影響

setResultでセットしたモニター起動用のURL情報によって，影響を受ける機能と影響内容について，次の表に示します。

表4‒37　影響する機能一覧

項番

機能名

影響内容

1

連携製品画面起動

構成情報の付与情報(value)のmethodsに，__urlGetが設定されているIM管理ノードについて，連携製品元の画面を起動します。

4.4.5　例外発生時の処理

ユーザー作成プラグインの各メソッド内で発生した例外は，ユーザー作成プラグインのメソッド内でキャッチ（catch）して処理してください。プラグインのメソッドで例外が発生した場合，その例外に対応したエラーとメッセージをエラーメッセージメソッド（args.setError）の引数に設定して呼び出してください。設定するエラーメッセージの言語は，英語としてください。

なお，エラーメッセージメソッド（args.setError）をコールするとプラグインに制御は戻りません。

統合トレースログ，または画面に次のメッセージを出力します。

KAJY02028-W JP1/IM - Managerが管理するシステム構成情報の取得に失敗しました。(ホスト名:ホスト名,コンポーネント名:コンポーネント名,詳細:詳細)

ホスト名

情報の取得に失敗したホスト名

コンポーネント名

情報の取得に失敗したコンポーネント名

詳細

setErrorメソッドで指定されたメッセージ内容

エラーメッセージメソッド（args.setError）の詳細は「4.4.4(1)　__configurationGetメソッド」を参照してください。

メッセージの詳細については，マニュアル「JP1/Integrated Management 3 - Manager メッセージ」を参照してください。

4.5　ユーザー作成プラグイン内で使用できるメソッド

ユーザー作成プラグインの各メソッドで使用できる共通メソッドの一覧を，次に示します。

表4‒38　ユーザー作成プラグインの各メソッドで使用できる共通メソッド一覧

項番

メソッド名※

説明

1

jp1Imdd.callRest

REST APIを呼び出すメソッド

2

jp1Imdd.readFile

ファイルを読み込み，読み込んだ内容を文字列で返却するメソッド

3

jp1Imdd.encodeBase64

文字列をBase64形式に変換して返却するメソッド

4

jp1SimtService.get

構成情報のSIDとvalue値の情報を返却するメソッド

5

jp1SimtService.join

構造化IDを結合し生成した構成情報のSIDを返却するメソッド

6

jp1SimtService.pack

構造化IDの名称にホスト名以外を指定する種別と名称を結合し，生成した構造化IDを返却するメソッド

7

jp1SimtService.packHost

構造化IDの名称にホスト名を指定する種別と名称を結合し，生成した構造化IDを返却するメソッド

8

jp1SimtService.parse

構成情報のSIDを構造化IDに分割し，分割した構造化IDを「_」（アンダースコア）を除外した種別とURLデコードした名称に分け，その内容を返却するメソッド

9

jp1Logger.trace

ログを出力するメソッド

10

jp1Imdd.execCmd

リモートでコマンドを実行するメソッド

11

jp1Imdd.getPluginConfDirPath

プラグインの定義ファイルが格納されているディレクトリの親ディレクトリの絶対パスを返却するメソッド

12

jp1Imdd.getVersion

JP1/IMのバージョンを返却するメソッド

13

jp1EmService.getEvent

IM 管理ノードに関連するイベントを，統合監視DBから取得するメソッド

14

jp1SimtService.getLink

リンク情報を取得するメソッド

15

jp1EmService.changeEventStatus

イベントの対処状況を変更するメソッド

16

jp1SimtService.getTreeSid

指定した構成情報のSIDに対応するツリーSIDを取得するメソッド

17

jp1TrendDataService.getTrendData

トレンドデータ管理DBからトレンドデータ（時系列データ）を取得するメソッド

18

jp1TrendDataService.getLabelList

トレンドデータ管理DBから，パラメーターで指定した条件に一致するラベルセットの時系列の一覧を取得するメソッド

注※

各メソッド名の「jp1Imdd」，「jp1SimtService」，「jp1Logger」はグローバルオブジェクトのため，同名のグローバルオブジェクトを定義しないでください。また，jp1，またはhitachiから始まる名称のグローバルオブジェクトも定義しないでください。

4.5.1　jp1Imdd.callRest

REST APIを呼び出すメソッドです。jp1Imdd.callRestメソッドの詳細を次に示します。

メソッド名

Object jp1Imdd.callRest(String method, String url, Object headers, String body)

パラメーター

method

REST APIのメソッド

url

REST APIのURL

ホスト名を含むURLを指定する場合，ホスト名はhostsファイルやDNSに登録し，JP1/IM - ManagerホストのOS上で名前解決できるようにしてください。

jp1hostsファイルおよびjp1hosts2ファイルの設定は参照されません。

_headers

REST APIのリクエストヘッダー

body

REST APIのリクエストのボディー

メソッドがGETで，ボディーが不要の場合は，bodyにnull，または空文字を設定します。

戻り値

REST APIのレスポンスを格納したオブジェクトを返却します。

オブジェクトに格納されているキーと値を次に示します。

項番

説明

キー

値

1

REST APIが正常に完了した場合

"response"

レスポンスオブジェクト

レスポンスオブジェクトに格納されているキーと値

"status"

HTTPステータスコード

"headers"

レスポンスヘッダー

"body"

レスポンスボディー

2

URIの解析に失敗した場合

"error"

エラーオブジェクト

エラーオブジェクトに格納されているキーと値

"status"

0

"body"

解析エラーの文字列

3

HTTPステータスコードが4xx系または5xx系，未知のステータスコードが返却された時

"error"

エラーオブジェクト

エラーオブジェクトに格納されているキーと値

"status"

HTTPステータスコード

"headers"

レスポンスヘッダー

"body"

レスポンスボディー

例外

RestClientException

I/Oエラーが発生した場合

呼び出し例

module.exports = function(args) {
    var baseUrl = args.baseUrl;
    var manager = args.manager;
    var jp1token = args.jp1token;

    var method = 'POST';
    var apiPath = '/v1/authorization/token';
    var url = baseUrl + apiPath;
    var headers = {
        'Accept': 'application/json',
        'Content-Type': 'application/json',
        'X-AJS-Authorization-Token': jp1token,
    };
    var body = {
        parameters: {
            manager: manager,
            serviceName: 'AJSROOT1',
        }
    };
    return jp1Imdd.callRest(method, url, headers, JSON.stringify(body));
}

4.5.2　jp1Imdd.readFile

パラメーターに指定されたパスにあるファイルを読み込み，その内容をStringで返却するメソッドです。読み込めるファイルの文字コードはUTF-8です。jp1Imdd.readFileメソッドの詳細を次に示します。

メソッド名

String jp1Imdd.readFile(String pathname)

パラメーター

pathname

読み込むファイルの絶対パス

パスの区切りは「/（スラッシュ）」または「¥」で指定します。

戻り値

読み込んだファイル内容の文字列

ファイルにBOMが設定されている場合は，BOMを削除した文字列を返却します。

例外

FileNotFoundException

ファイルが存在しない場合

通常ファイルではなくディレクトリの場合，またはなんらかの理由で開くことができない場合

IOEXception

I/Oエラーが発生した場合

4.5.3　jp1Imdd.encodeBase64

パラメーターに指定された文字列をBase64でエンコードしたものを，String形式で返却するメソッドです。jp1Imdd.encodeBase64メソッドの詳細を次に示します。

メソッド名

String jp1Imdd.encodeBase64(String str)

パラメーター

srt

Base64でエンコードする文字列

戻り値

Base64でエンコードされた文字列

例外

なし

4.5.4　jp1SimtService.get

パラメーターに指定された構成情報のSIDから，そのSIDとvalue値の情報をまとめたSimtDataオブジェクトを返却するメソッドです。jp1SimtService.getメソッドの詳細を次に示します。

メソッド名

SimtData jp1SimtService.get(String sid)

パラメーター

sid

構成情報のSIDを表す文字列

戻り値

構成情報のSIDとvalue値の情報をまとめたSimtDataオブジェクト

パラメーターに指定した構成情報のSIDが存在しない場合はnullを返却します。

SimtDataオブジェクトのフィールドには，次の項目が存在します。

String sid

Map<String, Object> value

例外

なし

4.5.5　jp1SimtService.join

パラメーターに指定された構造化IDを「/（スラッシュ）」で結合し生成した構成情報のSIDを，String形式で返却するメソッドです。jp1SimtService.joinメソッドの詳細を次に示します。

メソッド名

String jp1SimtService.join(String... sid)

パラメーター

sid

「/（スラッシュ）」で結合する構造化ID

戻り値

パラメーターに指定された複数の文字列である構造化IDを「/（スラッシュ）」で結合した構成情報のSIDの文字列

例外

なし

4.5.6　jp1SimtService.pack

第1パラメーターに指定された構造化IDの種別（アンダースコア以外）を「_」（アンダースコア）で括り，第2パラメーターに指定された名称のうち「.」「~」「-」「:」以外の記号，英数字以外をURLエンコードしたあとに，種別，名称の順で結合し生成した構造化IDの内容を，String形式で返却するメソッドです。jp1SimtService.packメソッドの詳細を次に示します。

メソッド名

String jp1SimtService.pack(String key, String value)

パラメーター

key

「_」（アンダースコア）で括る構造化IDの種別

名称にホスト名以外を指定する種別です。

value

URLエンコードを行う構造化IDの名称

戻り値

「_」（アンダースコア）で括った文字列である種別とURLエンコードを行った文字列である名称を結合した構造化IDの文字列

例外

なし

4.5.7　jp1SimtService.packHost

第1パラメーターに指定された構造化IDの名称にホスト名を指定する種別（アンダースコア以外）を「_」（アンダースコア）で括り，第2パラメーターに指定されたホスト名を大文字変換，および「.」「~」「-」「:」以外の記号，英数字以外をURLエンコードしたあとに，種別，名称の順で結合し生成した構造化IDの内容を，String形式で返却するメソッドです。名称がホスト名以外の構造化IDを作成する場合は，jp1S imtService.packメソッドを使用してください。jp1SimtService.packHostメソッドの詳細を次に示します。

メソッド名

String jp1SimtService.pack(String key, String value)

パラメーター

key

「_」（アンダースコア）で括る構造化IDの種別

名称にホスト名以外を指定する種別です。

value

大文字変換およびURLエンコードを行うホスト名

戻り値

「_」（アンダースコア）で括った文字列である種別とURLエンコードを行った文字列である名称を結合した構造化IDの文字列

例外

なし

4.5.8　jp1SimtService.parse

パラメーターに指定されたSIDを構造化IDに分割し，分割した構造化IDを「_」（アンダースコア）を除外した種別とURLデコードした名称に分けます。それらの情報をSimtIdUnitオブジェクトとして格納し，SimtIdUnitオブジェクトを格納したListを返却するメソッドです。SIDを分割して得られた構造化IDが構造化IDの形式となっていなかった場合は，名称の値としてSimtIdUnitオブジェクトに格納します。jp1SimtService.parseメソッドの詳細を次に示します。

メソッド名

List<SimtIdUnit> jp1SimtService.parse(String sid)

パラメーター

sid

SIDを表す文字列

戻り値

SIDを構造化IDに分割し，「_」（アンダースコア）を除外した種別とURLデコードした名称に分けたSimtIdUnitオブジェクトを格納するListオブジェクト

SimtIdUnitオブジェクトのフィールドには，次の項目が存在します。

String key：アンダースコアを除外した種別

String value：名称

例外

なし

4.5.9　jp1Logger.trace

第1パラメーターに指定された文字列のファイルに対して，第2パラメーターの文字列をログとして出力するメソッドです。jp1Logger.traceメソッドの詳細を次に示します。

メソッド名

void jp1Logger.trace(String jsName, String message)

パラメーター

jsName

ログを出力するファイルの名称

ファイル名称には，ユーザー作成プラグインのファイル名を指定してください。ログの出力先は，ユーザー作成プラグインの配置場所となります。

1行に出力できるサイズは，4,096バイトまでです。上限を超えた部分のログは，出力されません。

message

出力するメッセージ

戻り値

なし

例外

なし

4.5.10　jp1Imdd.execCmd

パラメーターに指定されたコマンドを実行するメソッドです。jp1Imdd.execCmdメソッドの詳細を次に示します。

メソッド名

Object jp1Imdd.execCmd(String host, String cmd, Object env, String envFile, String jp1user)

パラメーター

envに指定した環境変数がenvFileで指定したファイルにも記載されている場合，envで指定した値が優先されます。

host

コマンドの実行先ホスト名を，1〜254バイトの範囲で指定します。

cmd

実行コマンドと引数を，1〜4,095バイトの範囲で指定します。コマンド名に空白を含む場合は「"（ダブルクォーテーション）」で囲みます。

env

実行先ホストでコマンドを実行する際の環境変数をオブジェクトのキーに，環境変数の値をオブジェクトの値に指定します。

最大30個まで指定できます。不要な場合はnullを指定します。オブジェクトのキーと値は，全体で1〜7,107バイトの範囲で指定します。

envFile

環境変数ファイル名です。実行先ホストのファイルを，1〜255バイトの範囲の絶対パスで指定します。不要な場合はnullまたは空文字を指定します。

jp1user

JP1ユーザー名を1〜31バイトの範囲で指定します。値が指定された場合，指定されたJP1ユーザーのプライマリーユーザーでコマンドを実行します。不要な場合はnullまたは空文字を指定します。

戻り値

コマンドの実行結果を格納したオブジェクトを返却します。オブジェクトに格納されているキーと値を次に示します。

項番

説明

キー

値

1

リモートコマンド実行に成功した場合（実行コマンドの起動に成功した場合）※

"response"

レスポンスオブジェクト

レスポンスオブジェクトに格納されているキーと値

"rc"

実行コマンドの戻り値

"stdOut"

コマンドの標準出力をUTF-8に変換した文字列

"stdError"

コマンドの標準エラー出力をUTF-8に変換した文字列

2

リモートコマンド実行に失敗した場合（実行コマンドの起動に失敗した場合）

"error"

エラーオブジェクト

エラーオブジェクトに格納されているキーと値

"rc"

エラーコード

注※

cmdに指定した実行コマンドが存在しない場合でも，実行先ホストへの接続に成功しcmd.exeまたは/bin/shが起動できたときは，戻り値，標準出力，標準エラー出力を返却します。なお，返却される戻り値，標準出力，標準エラー出力は，実行先ホストのcmd.exeまたは/bin/shに依存します。

例外

IOEXception

I/Oエラーが発生した場合

前提条件

このメソッドを使用するためには，実行先ホストにJP1/Base 12-10以降がインストールされていて，IMの構成管理に追加されている必要があります。

実行可能なコマンド

jp1Imdd.execCmdメソッドで実行できるコマンドの種類を以下に示します。

コマンドを実行するホストがWindowsの場合

実行形式ファイル(.com，.exe)

バッチファイル(.bat)

コマンドを実行するホストがUNIXの場合

UNIXのコマンド

シェルスクリプト

重要

実行するコマンドは，JP1/Baseが実行している言語設定と同じと仮定して動作します。環境変数LANGを使用した文字の変更はしないでください。

次に示すコマンドは実行できません

対話操作を必要とするコマンド

画面を表示するコマンド

エスケープシーケンスや制御コードを伴うコマンド

デーモンなどの，終了しないコマンド

Windowsメッセージ機構やDDEなど，デスクトップとの対話が必要なコマンド（Windowsの場合）

shutdownやhaltなど，OSをシャットダウンするコマンド

JP1/Baseを停止するコマンド

jbs_spmd_reloadコマンド

コマンドの実行方法

リモートコマンド実行機能は，次の処理によりコマンドを実行します。

Windowsの場合

cmd.exe /c 指定コマンド

UNIXの場合

OSユーザーのログインシェルを使用します。設定されていない場合は，「/bin/sh」を使用します。

/bin/sh -c 指定コマンド

実行ユーザー

引数jp1Userに指定されたJP1ユーザーのプライマリーユーザーで実行されます。jp1Userにnullまたは空文字を指定した場合は，実行先ホストの次の権限で実行されます。

Windowsの場合：SYSTEM

UNIXの場合：root

重要

実行先ホストでUACが有効な場合は，引数jp1Userに指定したJP1ユーザーのプライマリーユーザーは，ビルトインAdministratorである必要があります。

制限値

jp1Imdd.execCmdメソッドの制限値を次に示します。

表4‒39　 jp1Imdd.execCmdメソッドの制限値

項番

項目

設定値

1

タイムアウト(秒)

3600

2

標準出力および標準エラー出力のサイズ(MB)

20

エラーコード

実行先コマンドの起動に失敗した場合のエラーコードを次に示します。

表4‒40　実行先コマンドの起動に失敗した場合のエラーコード

項番

エラーケース

エラーコード

対処

1

指定したパラメーターが不正

1

パラメーターの指定を見直し再実行する。

2

実行先ホストへの接続に失敗

2

実行先ホストのJP1/Baseのサービスが起動しているか確認する。

3

タイムアウトが発生※

3

実行先ホスト，またはネットワークの負荷が高い状態のため，タイムアウトが発生した。しばらく待ってから再実行する。

4

受信するデータが上限を超えた

4

実行コマンドの標準出力，標準エラー出力のサイズが上限を超過した。実行コマンドの出力を見直しする。

5

環境変数ファイルが読み込めない

5

引数envFileに指定したファイルが実行先ホストに存在するかを確認する。

6

JP1ユーザーが不正

6

引数jp1Userに指定したJP1ユーザーについて以下を確認する。

実行先ホストのOSユーザーとのマッピングをしているか

ユーザーマッピングのサーバホストにJP1/IMのホストが含まれているか。

7

内部エラー

255

資料採取ツールで資料を採取し，システム管理者に連絡する。

注※

タイムアウトが発生した場合は，実行中のコマンドのプロセスは終了されます。

注意事項

実行先ホストでUACが有効な場合，jp1Userに指定したJP1ユーザーのプライマリーユーザーは，必ずビルトインAdministratorとしてください。

4.5.11　jp1Imdd.getPluginConfDirPath

プラグインの定義ファイルが格納されているディレクトリの親ディレクトリの絶対パスをStringで返却するメソッドです。jp1Imdd.getPluginConfDirPathメソッドの詳細を次に示します。

メソッド名

String jp1Imdd.getPluginConfDirPath (pluginName)

パラメーター

pluginName

プラグイン名を表す文字列

（指定例）jp1pfm

戻り値

プラグインの定義ファイルが格納されているディレクトリの絶対パスの文字列を返却します。

パラメーターの値がnullの場合や内部エラーの場合は，nullを返却します。

（指定例）Windowsの物理ホストの場合

Managerパス¥conf¥imdd¥plugin¥jp1pfm

例外

なし

4.5.12　jp1Imdd.getVersion

JP1/IMのバージョンをStringで返却するメソッドです。jp1Imdd.getVersionメソッドの詳細を次に示します。

メソッド名

String jp1Imdd.getVersion ()

パラメーター

なし

戻り値

製品バージョンを「VV-RR」または「VV-RR-SS」形式で返却します。

例えば，製品バージョンが「12-00」の場合は「SS」を省略して「12-00」，製品バージョンが「12-00-02」の場合は「12-00-02」を返却します。

バージョン情報取得APIの「productVersion」と同様の値を返却します。「5.12.1　バージョン情報取得」を参照してください。

例外

なし

指定例

ユーザー作成プラグインに下位互換を持たせる場合は，次のようにJP1/IMのバージョンを判定して，処理を分岐させます。

var im2Version = null;

if(typeof jp1Imdd.getVersion == "function") {
    im2Version = jp1Imdd.getVersion();
} else {
    im2Version = "12-00";
}

switch(im2Version) {
    case "12-00":
        // 12-00の処理
        break;
    case "12-10":
       // 12-10の処理
        break;
}

4.5.13　jp1EmService.getEvent

IM管理ノードに関連するイベントを，統合監視DBから取得するメソッドです。パラメーターで指定した条件に合致するイベントの一覧を取得します。

このメソッドを指定したJP1ユーザーに参照権限が無いイベントは，取得できません。また，その際，エラーメッセージは出力されません。

取得できるイベントの範囲は，JP1資源グループの設定，およびJP1/IM - Managerのユーザーフィルターの設定に従います。参照できるイベントの条件については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「3.5.1　IM管理ノードの構造」のIM管理ノードを選択した際に，イベントビューに表示できるイベントの説明を参照してください。

なお，このメソッドは製品プラグインの__eventGetメソッド，および__eventGetメソッドの呼び出し先のメソッドからは，呼び出しできません。

jp1EmService.getEventメソッドの詳細を次に示します。

メソッド名

Object jp1EmService.getEvent(String sid, Object filter, String direction, String since, int count, String[] attrs, int[] statusFilter, boolean consolidateEvent, int searchCount, String lang, String jp1User, String jp1Token)

パラメーター

sid

IM管理ノードのツリーSIDを指定します。指定したIM管理ノードが発生元となるイベントの一覧を取得します。

nullまたは空文字を指定した場合は，オールシステム（_ROOT_AllSystems）を指定したものと仮定されます。なお，IM管理ノードがセットアップされていない状態でnullまたは空文字を指定した場合は，空のイベント一覧が返却されます。

filter

イベント検索条件オブジェクトを指定します。

指定したイベント検索条件に従い，統合監視DBからイベントを検索します。イベント検索オブジェクトについては，「7.2.1(3)　イベント検索条件オブジェクト」を参照してください。ただし，各属性の値に半角スペースを指定した場合は「%20」を指定したものとみなされます。

sidで指定したイベントを，filterで指定したイベント検索条件で絞り込みます。絞り込みが不要な場合は，nullを指定します。

通過条件群にkeyがB.TIME（登録時刻）でopeがTRANGE（日時指定）のイベント条件を指定していない，かつkeyがB.ARRIVEDTIME（到着時刻）でopeがTRANGE（日時指定）のイベント条件を指定していない場合※は，通過条件群の一つとして以下を指定したものと仮定されます。

{"key":"B.TIME","ope":"TRANGE","val":["現在時刻の1日前","現在時刻"]}

注※　filterにnullを指定した場合も含まれます。

なお，keyにB.ID（イベントID）を指定したイベント条件のvalの指定値の桁数は，自動でゼロ埋めされます。

direction

イベントの検索方向を指定します。

過去方向は「past」，未来方向は「future」を指定します。nullまたは空文字を指定した場合は「past」を指定したものと仮定されます。

since

イベントの検索開始位置をJP1イベントのSIDで指定します。指定したJP1イベントのSIDより未来または過去のイベントを検索します。ただし，指定したJP1イベントのSIDのイベントは検索対象に含みません。nullまたは空文字を指定した場合は，directionの指定に従って，統合監視DBの先頭または末尾から検索を開始します。JP1イベントのSIDの詳細については「7.2.1(1)　イベント情報オブジェクト」を参照してください。

count

イベントの最大取得件数を1〜2,000件の範囲で指定します。

attrs

取得したいイベント属性の項目を配列で指定します。

（指定例）

“attrs”:[”B.ID”,”B.MESSAGE”,…]

attrsに指定した属性をユーザーが指定した並び順で取得します。nullを指定した場合は，指定したJP1イベントによって次のようになります。

集約開始イベントの場合

イベントレポート出力機能の属性値の出力項目を，すべて取得します。そのあと，「7.2.1(1)　イベント情報オブジェクト」の「集約開始イベントのイベント属性」の表に示す属性を取得します。

その他のイベントの場合

イベントレポート出力機能の属性値の出力項目を，すべて取得します。指定できるイベント属性は，イベントレポート出力機能で出力できるすべての属性，および「7.2.1(1)　イベント情報オブジェクト」の「集約開始イベントのイベント属性」の表に示す属性です。

イベントレポート出力機能の詳細については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「4.15.2　統合監視DBのイベント情報を保管（イベントレポート出力）」を参照してください。

statusFilter

ノードのステータスに該当するイベントだけを絞り込む場合は，intの配列でステータス値を指定します。

（指定例）ノードのステータスが30と40のイベントだけを取得したい場合

"statusFilter":[30,40]

ノードのステータスコードについては，「5.8.5　IM管理ノードステータス取得」を参照してください。絞り込みが不要な場合は，nullを指定します。

consolidateEvent

インテリジェント統合管理基盤で繰り返しイベントが集約されている場合に，集約された繰り返しイベントを返却するかどうかを指定します。繰り返しイベントの返却を抑止する場合は，「true」を指定します。

true

インテリジェント統合管理基盤で繰り返しイベントの表示が抑止されている場合，集約開始イベントだけを返却します。集約開始イベントよりあとの繰り返しイベントは返却しません。

false

インテリジェント統合管理基盤で繰り返しイベントの表示が抑止されているかどうかに関わらず，繰り返しイベントを返却します。

searchCount

イベントの検索回数の上限を0〜120,000の範囲で指定します。

sidパラメーターで指定したIM管理ノードにマッピングされているイベントを，sinceパラメーターの検索開始位置からdirectionパラメーターの検索方向に向かって，100件分検索します。

ユーザーフィルターなどによって，countパラメーターで指定した件数のイベントが取得できない場合は，次のイベント100件を対象として繰り返し検索します。この繰り返し行うイベント検索回数の上限値を指定します。

検索回数が上限値に達した場合は検索を中断し，中断までに取得できたイベントの一覧，およびKAJY32010-Wのメッセージを出力します。指定を省略した場合，値に「0」を指定した場合は，検索回数は制限されません。

lang

メッセージの言語を指定します。「ja」，「ja-JP」または「en」を指定できます。その他の値を指定した場合は「en」を指定したものと仮定されます。詳細は「4.4　実装可能なメソッド」の「ユーザー作成プラグインの言語規約」を参照してください。

jp1User

次のJP1権限レベルが設定されたJP1ユーザー名を，1〜31バイトの範囲で指定します。指定されたJP1ユーザーに参照権限があるイベントが取得されます。

JP1_Console_Admin

JP1_Console_Operator

JP1_Console_User

jp1Token

jp1Userで指定したJP1ユーザーに対応するJP1認証トークンを指定します。

戻り値

イベント取得に成功した場合は，イベントの情報を格納したオブジェクトが返却されます。イベント取得に成功した場合にオブジェクトに格納されるキーと値を，次に示します。

項番

キー

値

1

eventData

取得したイベントの一覧をイベント情報オブジェクトの配列として返却します。イベント情報オブジェクトについては「7.2.1(1)　イベント情報オブジェクト」を参照してください。イベントが一つも存在しない場合は，要素数0の配列を返却します。

2

messageId

イベント検索の途中で発生した一時的なエラーのメッセージIDを返却します。KAJY32005-WまたはKAJY32010-Wが返却されます。通知すべきメッセージがない場合はnullを指定します。メッセージの詳細については，マニュアル「JP1/Integrated Management 3 - Manager メッセージ」を参照してください。

3

message

イベント検索の途中で発生した一時的なエラーメッセージのメッセージ本文を返却します。通知すべきメッセージがない場合はnullを指定します。

4

beginSid

sinceパラメーターで指定したイベントの検索開始位置の次のJP1イベントのSIDを返却します。sinceパラメーターからイベント取得方向に向かって，一つ先のJP1イベントのSIDです。検索対象となるJP1イベントが一つも存在しない場合は省略されます。

5

endSid

イベントの検索終了位置のJP1イベントのSIDを返却します。イベント検索の中断が発生した場合は，中断位置のJP1イベントのSIDが返却されます。検索対象となるイベントが一つも存在しない場合は省略されます。

イベント取得に失敗した場合にオブジェクトに格納されるキーと値を，次に示します。

項番

キー

値

1

errorMessage

エラーメッセージです。引数が不正な場合はKAJY22043-Eのエラーメッセージが設定されます。JP1/IM3-Managerサービス停止中にこのメソッドを実行した場合はKAJY32000-Eのメッセージが設定されます。その他の場合に設定されるエラーメッセージについては，「5.6.1　イベント検索」のステータスコードを参照してください。

2

errorMessageId

エラーメッセージのidを返却します。

このメソッドを呼び出す製品プラグインのメソッドは，キーerrorMessageIdの値に応じて，プラグインの仕様に基づいたエラーメッセージやエラー処理を検討してください。

キーerrorMessageは製品プラグインの内部ログに出力し，製品プラグインの障害調査に活用してください。

例外

なし

4.5.14　jp1SimtService.getLink

リンクの情報を取得するメソッドです。

なお，このメソッドは製品プラグインの__eventGetメソッド，および__eventGetメソッドの呼び出し先のメソッドからは，呼び出しできません。

jp1SimtService.getLinkメソッドの詳細を次に示します。

メソッド名

Object jp1SimtService.getLink(String type, String sid, int fromLayerCount, int toLayerCount, int countPerLayer, int linkCount, String lang, String jp1User, String jp1Token)

パラメーター

type

システムに適用されているリンク情報の種別のうち，取得したいリンク情報の種別を指定します。nullまたは空文字列を指定した場合，リンク情報の種別に関わらず，該当するリンク情報を返却します。

typeは同じ意味を持つ関連同士をグループ化する情報です。［統合オペレーション・ビューアー］画面の［関連ノード］タブでは，typeごとに関連をフィルタリングして表示することができます。

JP1/IMの製品内や他製品との連携では次の種別を使用します。これらの種別以外に，ユーザーが任意の種別を指定することもできます。

rootJobnetExecutionOrder：ルートジョブネット実行順序の関連

managerAgent：JP1製品のマネージャーとエージェントの関連

rootJobnetAgent：ルートジョブネットとAJSエージェントの関連

sameNode：名称が同一のノードの関連

L2Connection：JP1/NNMiで管理するレイヤー2接続線の関連

Infrastructure：JP1/OAで管理するインフラリソースの関連

monitoringConfiguration：監視製品の構成における製品と監視対象の関連

sid

処理対象とするノードのSIDを指定します。指定した部位の先行・後続ノード情報が返却されます。nullまたは空文字を指定した場合は，すべてのノードのリンク情報を取得します。

fromLayerCount

取得する先行ノード階層数の上限値を，0〜2147483647の範囲で指定します。sidにnullまたは空文字を指定した場合，fromLayerCountパラメーターの指定は無視されます。

toLayerCount

取得する後続ノード階層数の上限値を0〜2147483647の範囲で指定します。sidにnullまたは空文字を指定した場合，toLayerCountパラメーターの指定は無視されます。

countPerLayer

取得するノード数のノード階層当たりの上限値を，1〜2147483647の範囲で指定します。sidにnullまたは空文字を指定した場合，この引数の値は使用されません。

linkCount

取得するリンク数の上限値を1〜2147483647の範囲で指定します。sidにnullまたは空文字を指定した場合，linkCountパラメーターの指定は無視されます。

lang

メッセージの言語を指定します。「ja」，「ja-JP」または「en」を指定できます。その他の値を指定した場合は「en」を指定したものと仮定されます。詳細は「4.4　実装可能なメソッド」の「ユーザー作成プラグインの言語規約」を参照してください。

jp1User

次のJP1権限レベルが設定されたJP1ユーザー名を，1〜31バイトの範囲で指定します。

JP1_Console_Admin

JP1_Console_Operator

JP1_Console_User

jp1Token

jp1Userで指定したJP1ユーザーに対応するJP1認証トークンを指定します。

戻り値

リンク情報の取得に成功した場合は，リンク情報を格納したオブジェクトが返却されます。オブジェクトに格納されるキーと値を，次に示します。

項番

キー

値

1

links

取得したリンク情報の配列を返却します。リンク情報の配列については「IM管理ノードリンク定義ファイル（imdd_nodeLink_def.conf）」（2. 定義ファイル）を参照してください。

2

exceedCountDetected

パラメーターの指定値が上限を超えたことの検知有無を示します。

3

countPerLayer

1階層あたりのノード数の上限を超えたことの検知有無を示すオブジェクトです。

4

layer整数

sidに指定された階層を階層0として，後続の階層は順に+1，先行の階層は順に-1し，階層に番号を付け整数の部分に埋め込みます。返却対象となる全階層に対し，階層あたりのノード数が上限を超えたことの検知有無を示します。

true

検知した

false

検知していない

5

linkCount

リンク数が上限を超えたことの検知有無を示します。

true

検知した

false

検知していない

6

messageId

メッセージIDです。通知すべきメッセージが存在しない場合はnullが指定されます。

7

message

メッセージ本文です。通知すべきメッセージが存在しない場合はnullが指定されます。

リンク情報の取得に失敗した場合にオブジェクトに格納されるキーと値を，次に示します。

項番

キー

値

1

errorMessage

エラーメッセージです。引数が不正な場合はKAJY22043-Eのエラーメッセージが出力されます。

その他の場合に出力されるエラーメッセージについては，「5.6.1　イベント検索」のステータスコードを参照してください。

2

errorMessageId

エラーメッセージのidを返却します。

このメソッドを呼び出す製品プラグインのメソッドは，キーerrorMessageIdの値に応じて，プラグインの仕様に基づいたエラーメッセージやエラー処理を検討してください。

キーerrorMessageは製品プラグインの内部ログに出力し，製品プラグインの障害調査に活用してください。

例外

なし

4.5.15　jp1EmService.changeEventStatus

イベントの対処状況を変更するメソッドです。指定したJP1ユーザーに参照権限が無いイベントを指定した場合は，エラーとなります。また，操作権限のないイベントを指定した場合は，操作されません。参照できるイベントの条件については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「3.5.1　IM管理ノードの構造」のIM管理ノードを選択した際に，イベントビューに表示できるイベントの説明を参照してください。

なお，このメソッドは製品プラグインの__eventGetメソッド，および__eventGetメソッドの呼び出し先のメソッドからは，呼び出しできません。

jp1EmService.changeEventStatusメソッドの詳細を次に示します。

メソッド名

Object jp1EmService.changeEventStatus(int dealt, String[] sid, String lang, String jp1User, String jp1Token)

パラメーター

dealt

変更後の対処状況を，次の値で指定します。

0（未対処）

1（対処済）

2（処理中）

3（保留）

sid

対処状況を取得したいJP1イベントのSIDを配列で指定します。JP1イベントのSIDについては「7.2.1(1)　イベント情報オブジェクト」を参照してください。JP1イベントのSIDは2,000個まで指定できます。

lang

メッセージの言語を指定します。「ja」，「ja-JP」または「en」を指定できます。その他の値を指定した場合は「en」を指定したものと仮定されます。詳細は「4.4　実装可能なメソッド」の「ユーザー作成プラグインの言語規約」を参照してください。

jp1User

次のJP1権限レベルが設定されたJP1ユーザー名を，1〜31バイトの範囲で指定します。

JP1_Console_Admin

JP1_Console_Operator

jp1Token

jp1Userで指定したJP1ユーザーに対応するJP1認証トークンを指定します。

戻り値

対処状況の変更に成功した場合は，イベントの情報を格納したオブジェクトが返却されます。オブジェクトに格納されるキーと値を，次に示します。

項番

キー

値

1

eventData

対処状況を変更したイベントの一覧をイベント情報オブジェクトの配列として返却します。イベント情報オブジェクトについては「7.2.1(1)　イベント情報オブジェクト」を参照してください。権限不足で一部のイベントを操作できなかった場合，操作に成功したイベントだけを返却します。

2

messageId

イベント検索の途中で発生した一時的なエラーのメッセージIDを返却します。通知すべきメッセージがない場合はnullを指定します。

対処状況の変更に失敗した場合にオブジェクトに格納されるキーと値を，次に示します。

項番

キー

値

1

errorMessage

エラーメッセージです。引数が不正な場合はKAJY22043-Eのエラーメッセージが設定されます。JP1/IM3-Managerサービス停止中にこのメソッドを実行した場合はKAJY32100-Eのメッセージが設定されます。

その他の場合に設定されるエラーメッセージについては，「5.6.1　イベント検索」のステータスコードを参照してください。

2

errorMessageId

エラーメッセージのidを返却します。

このメソッドを呼び出す製品プラグインのメソッドは，キーerrorMessageIdの値に応じて，プラグインの仕様に基づいたエラーメッセージやエラー処理を検討してください。

キーerrorMessageは製品プラグインの内部ログに出力し，製品プラグインの障害調査に活用してください。

例外

なし

4.5.16　jp1SimtService.getTreeSid

指定した構成情報のSIDに対応するツリーSIDを取得するメソッドです。

なお，このメソッドは製品プラグインの__eventGetメソッド，および__eventGetメソッドの呼び出し先のメソッドからは，呼び出しできません。

jp1SimtService.getTreeSidメソッドの詳細を次に示します。

メソッド名

String jp1SimtService.getTreeSid(String sid)

パラメーター

sid

構成情報のSIDを指定します。

戻り値

ツリーSIDが返却されます。

sidにnullが指定されている場合，指定した構成情報のSIDに対応するツリーSIDが存在しない場合は，nullが返却されます。

例外

なし

4.5.17　jp1TrendDataService.getTrendData

トレンドデータ管理DBからトレンドデータ（時系列データ）を取得するメソッドです。jp1TrendDataService.getTrendDataメソッドの詳細を次に示します。

メソッド名

Object jp1TrendDataService.getTrendData(String jp1user, String sid, String promQLQuery, String starttime, String endtime, String step)

パラメーター

jp1user

JP1ユーザー名を1〜31バイトの範囲で指定します。

引数sidで指定するSIDに，引数jp1userで指定したJP1ユーザーに参照権限がないSIDを指定した場合※，0件のデータを返却します。

注※　JP1ユーザーに設定されているJP1資源グループのうち，次のどれかのJP1権限レベルを持つJP1資源グループが，引数sidに指定したSIDに設定されていない場合が該当します。

JP1_Console_Admin

JP1_Console_Operator

JP1_Console_User

sid

構成情報のSIDを指定します。

引数promQLQueryで指定するPromQL文内に，置き換え文字列「$jp1im_TrendData_labels」が含まれる場合，引数sidで指定した構成情報のSIDに設定されているjp1im_TrendData_labelsの値に置き換えて，トレンドデータ管理サービスに渡します。

promQLQuery

トレンドデータの絞り込み条件をPromQL文で指定します。

指定できるPromQL文については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「2.7.4(4)PromQLについて」を参照してください。

starttime

トレンドデータを取得する開始時刻を，UTC 1970年1月1日00:00:00（UNIXエポック）からの経過秒数で指定します。1970年1月1日午前0時0分0秒以前の時刻（マイナス値）は指定できません。

endtime

トレンドデータを取得する終了時刻を，UTC 1970年1月1日00:00:00（UNIXエポック）からの経過秒数で指定します。1970年1月1日午前0時0分0秒以前の時刻（マイナス値）は指定できません。

step

トレンドデータの取得間隔を秒数で指定します。

戻り値

トレンドデータの取得に成功した場合は，トレンドデータの情報を格納したトレンドデータオブジェクトが返却されます。トレンドデータオブジェクトの形式については，「7.2.3(1) トレンドデータオブジェクト」を参照してください。

トレンドデータの取得に失敗した場合に，オブジェクトに格納されるキーと値を，次に示します。

キー

値

errorMessage

エラーメッセージです。

引数jp1userが不正な場合は，KAJY22043-Eのメッセージが設定されます。

引数sidが不正な場合は，KAJY62003-Eのエラーメッセージが設定されます。

トレンドデータ管理サービスのポート番号の取得に失敗した場合は，KAJY62004-Eのメッセージが設定されます。

トレンドデータ管理サービスとの通信に失敗した場合は，KAJY62000-Eのメッセージが設定されます。

トレンドデータ管理サービスからエラーが返却された場合はKAJY62002-Eのメッセージが設定されます。

下位マネージャーで管理する構成情報のSIDを指定し，下位マネージャーのインテリジェント統合管理基盤への接続に失敗した場合は，KAJY00027-Eのメッセージが設定されます。

下位マネージャーで管理する構成情報のSIDを指定し，下位マネージャーのインテリジェント統合管理基盤の処理でエラーが発生した場合は，KAJY00029-Eのメッセージが設定されます。

errorMessageId

エラーメッセージのidを返却します。

このメソッドを呼び出すユーザー作成プラグインのメソッドは，キー「errorMessageId」の値の有無でエラーを判定し，値の内容に応じて，プラグインの仕様に基づいたエラーメッセージやエラー処理を検討してください。

キー「errorMessage」の値は，プラグインの内部ログに出力し，プラグインの障害調査に活用してください。

例外

なし

4.5.18　jp1TrendDataService.getLabelList

各マネージャーのトレンドデータ管理DBから，パラメーターで指定した条件に一致するラベルセットの時系列の一覧を取得するメソッドです。

メソッド名

Object jp1TrendDataService.getLabelList(String host, String[] match, String starttime, String endtime, String jp1User)

パラメーター

host

JP1/IM - Managerホストのホスト名を，1〜255バイトの範囲で指定します。

match

トレンドデータ管理DBから取得するラベルセットの絞り込み条件を指定します。

複数の条件を配列で指定でき，指定した場合はOR条件となります。条件は3つまで指定できます。

条件にはメトリック名を指定できます。また，｛｝で囲んだコンマ区切りのリストを追加して，ラベルと「'」で囲んだラベル値の比較条件を，条件に指定できます。比較条件の演算子と指定例を次に示します。

=：指定した文字列と一致する

!=：指定した文字列と一致しない

=~：指定された文字列に正規表現が一致する

!~：指定された文字列に正規表現が一致しない

（指定例）

各種ExporterのIM管理ノードを作成する場合

upメトリックのラベルセットを取得するときは，upを指定します。

Yet another cloudwatch exporterのIM管理ノードを作成する場合

__name__ラベルでaws_から始まるラベルセットを取得するときは，{__name__=~'aws_.*'}を指定します。

FluentdのIM管理ノードを作成する場合

fluentd_logtrap_runningメトリックのラベルセットを取得するときは，fluentd_logtrap_runningを指定します。

starttime

ラベルセットの一覧を取得する開始時刻を，UTC 1970年1月1日00:00:00（UNIXエポック）からの経過秒数で指定します。1970年1月1日午前0時0分0秒以前の時刻（マイナス値）は指定できません。

endtime

ラベルセットの一覧を取得する終了時刻を，UTC 1970年1月1日00:00:00（UNIXエポック）からの経過秒数で指定します。1970年1月1日午前0時0分0秒以前の時刻（マイナス値）は指定できません。

jp1User

次のJP1権限レベルが設定されたJP1ユーザー名を，1〜31バイトの範囲で指定します。

JP1_Console_Admin

戻り値

ラベルセットの一覧の取得に成功した場合は，ラベルセットの一覧が返却されます。ラベルセットの一覧の形式については，「7.2.3(2) ラベルセットリストオブジェクト」を参照してください。

ラベルセットの一覧の取得に失敗した場合に，オブジェクトに格納されるキーと値を，次に示します。

キー

値

errorMessage

エラーメッセージです。

トレンドデータ管理サービスのポート番号の取得に失敗した場合は，KAJY62004-Eのメッセージが設定されます。

トレンドデータ管理サービスとの通信に失敗した場合は，KAJY62000-Eのメッセージが設定されます。

トレンドデータ管理サービスからエラーが返却された場合はKAJY62005-Eのメッセージが設定されます。

指定したホストのインテリジェント統合管理基盤への接続に失敗した場合は，KAJY00027-Eのメッセージが設定されます。

指定したホストのインテリジェント統合管理基盤の処理で失敗した場合は，KAJY00029-Eのメッセージが設定されます。

errorMessageId

エラーメッセージのidを返却します。

このメソッドを呼び出すユーザー作成プラグインのメソッドは，キー「errorMessageId」の値の有無でエラーを判定し，値の内容に応じて，プラグインの仕様に基づいたエラーメッセージやエラー処理を検討してください。

キー「errorMessage」の値は，プラグインの内部ログに出力し，プラグインの障害調査に活用してください。

例外

なし

4.6　ユーザー作成プラグインのファイル名と配置場所

ユーザー作成プラグインのファイル名は，任意のファイル名を指定できます。ファイル名の規則を次に示します。

ファイル名に使用できる文字列：半角英数字

拡張子：「.js」固定です。

次のファイル名は使用できません。なお，大文字・小文字は区別しません。

「jp1」，または「hitachi」から始まるファイル名

ユーザー作成プラグインは，ユーザー作成プラグインのファイル名と同じ名前のディレクトリを作成して配置します。1つのディレクトリに配置できるのは，同名の1ファイルだけです。

「userPlugin.js」というユーザー作成プラグインを配置する場合の例を次に示します。

Windowsの場合

物理ホストのとき

Managerパス¥plugin¥imdd¥userPlugin¥

論理ホストのとき

共有フォルダ¥jp1imm¥plugin¥imdd¥userPlugin¥

UNIXの場合

物理ホストのとき

/etc/opt/jp1imm/plugin/imdd/userPlugin/

論理ホストのとき

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

プラグインの保存先として「user」というディレクトリを作成した場合，「user」ディレクトリに任意のファイル名のユーザー作成プラグインを複数配置できます。

4.6.1　ユーザー作成プラグインで使用する定義ファイル

ユーザー作成プラグインで使用する定義ファイルの配置先を次に示します。

Windowsの場合

物理ホストのとき

Managerパス¥conf¥imdd¥plugin¥製品名※¥

論理ホストのとき

共有フォルダ¥jp1imm¥conf¥imdd¥plugin¥製品名※¥

UNIXの場合

物理ホストのとき

/etc/opt/jp1imm/conf//imdd/plugin/製品名※/

論理ホストのとき

共有ディレクトリ/jp1imm/conf/imdd/plugin/製品名※/

注※　製品名は以下となります。

JP1/AJSの場合：jp1ajs

JP1/PFMの場合：jp1pfm

ファイル

ファイル名.拡張子

ファイル名.拡張子.model

ファイル名.拡張子.modelを同梱し，インストール時にファイル名.拡張子のファイルを作成します。

バージョンアップインストールの際は，ファイル名.拡張子.modelだけが上書きされます。

4.7　ユーザー作成プラグインの変更内容の反映

ユーザー作成プラグインに変更を加えた場合，JP1/IM3-Managerサービスを再起動する必要があります。

5　API

JP1/IM - Manager（インテリジェント統合管理基盤）が提供するAPIについて説明します。

5.1　API一覧

JP1/IMのユーザー作成プラグインで使用できるAPIの一覧を次の表に示します。

表5‒1　ユーザー作成プラグインのAPI一覧（JP1/IM - Managerに関するAPI）

分類

API名

機能

ユーザー認証

ログイン

インテリジェント統合管理基盤にログインします。

ログアウト

インテリジェント統合管理基盤にログアウトします。

初期シークレット発行

初期シークレットを発行します。

IMクライアントシークレット削除

データベースに登録済みのIMクライアントシークレットを削除します。

IMクライアントシークレット発行

IMクライアントシークレットを発行してデータベースに登録します。

IMクライアント一覧取得

登録済みのIMクライアントIDの一覧を取得します。

リンク情報

リンク情報取得

オブジェクトの順序関係を表すリンク情報を取得します。

リンク種別一覧取得

リンク情報の種別の一覧を取得します。

イベント管理

イベント検索

指定した条件に従って統合監視DBからイベントを検索します。

イベント詳細情報取得

指定したイベントの詳細情報を取得します。

イベント対処状況変更

指定したイベントの対処状況を変更します。

イベント発行

指定されたイベントを発行します。

JP1イベント変換

外部システムから通知されたイベント情報をJP1イベントに変換して発行します。

性能情報

プラグイン処理実行

性能情報のプラグイン処理を実行します。

システムのステータス監視

IM管理ノード関連情報の生成

システム構成情報を取得し，構成管理ツリーファイルを生成します。

IM管理ノード関連情報の反映

構成管理ツリーファイルをインテリジェント統合管理基盤に反映します。

IM管理ノード情報取得

JP1/AJS3，JP1/PFM，JP1/IM，JP1/Baseなどから取得したIM管理ノード情報を取得します。

構成管理ツリー情報取得

IM管理ノード（管理グループまたは管理オブジェクト）の構成情報をツリー形式で取得します。

IM管理ノードのステータス取得

IM管理ノード（管理グループまたは管理オブジェクト）のステータス情報をすべて取得します。

提案マッピング情報取得

IM管理ノードと提案IDのマッピング情報を取得します。

プロキシ

プロキシ認証情報設定

プロキシサーバの認証ユーザーとパスワードを設定します。

連携製品

URL情報取得

IM管理ノードに設定された連携製品起動URLを取得します。

トレンド

メトリック一覧取得

指定されたSIDのメトリック一覧を取得します。

時系列データ取得

指定されたSIDの時系列データを取得します。

トレンドデータ書き込み

トレンドデータをトレンドデータ管理DBに書き込みます。書き込むデータはJSON形式で指定できます。

情報管理

バージョン情報取得

JP1/IMのバージョンおよびREST APIのバージョンを取得します。

提案

前回実行履歴取得

対処アクションの前回実行履歴を取得します。

対処アクション提案

システム状況に応じた対処アクションを提案します。

対処アクション実行

対処アクションを実行します。

OpenID認証

シングルサインオンマッピング定義反映

シングルサインオンマッピング定義ファイル（imdd_sso_mapping.properties）で定義したマッピング情報を，インテリジェント統合管理基盤に反映します。

配布

配布物の取得（ファイルダウンロード）

リクエスト行で指定した配布物（ファイル）をダウンロードします。

自動/手動対処アクションの実行

対処アクションの実行結果取得

対処アクションの実行結果を取得します。

対処アクションの手動実行

対処アクションの手動実行を行います。

イベント引き継ぎ情報変換

イベント情報の引き継ぎを行います。

定義ファイル操作

定義ファイル一覧取得

定義ファイルの一覧を取得します。

定義ファイル取得

定義ファイルを取得します。

定義ファイル削除

定義ファイルを削除します。

定義ファイル更新

定義ファイルを更新します。

統合エージェント管理

統合エージェント情報取得

統合エージェント情報を取得します。

統合エージェント情報削除

統合エージェント情報を削除します。

シークレットの一覧取得

統合エージェント制御基盤で管理するシークレットの一覧を取得します。

シークレットの追加，更新，削除

統合エージェント制御基盤で管理するシークレットを追加，更新，削除します。

下位マネージャー情報管理

下位マネージャー情報一覧取得

統合マネージャー配下の拠点/中継マネージャーの情報を取得します。

下位マネージャー情報登録

統合マネージャー配下の拠点/中継マネージャーの情報を登録します。

下位マネージャー情報削除

統合マネージャー配下の拠点/中継マネージャーの情報を削除します。

表5‒2　ユーザー作成プラグインのAPI一覧（JP1/IM - Agentに関するAPI）

分類

API名※

機能

Prometheus server

Prometheus serverのリロード

Prometheus serverの定義ファイルを再読み込みし，Prometheus serverの動作に反映します。

Prometheus serverのヘルスチェック

Prometheus serverのヘルスチェックを行います。

ステータスコードは常に200を返却します。

Alertmanager

Alertmanagerのリロード

Alertmanagerの定義ファイルを再読み込みし，Alertmanagerの動作に反映します。

Alertmanagerのヘルスチェック

Alertmanagerのヘルスチェックを行います。

ステータスコードは常に200を返却します。

Alertmanagerのサイレンス一覧取得

Alertmanagerに作成されているサイレンスの一覧をJSON形式で取得します。

Alertmanagerのサイレンス作成

JSON形式のサイレンスの設定を引数で渡し，Alertmanagerにサイレンスを作成します。

Alertmanagerのサイレンス失効

Alertmanagerに作成されているサイレンスを失効（即時期限切れ）させます。

Alertmanagerのサイレンス取得

指定したサイレンスをJSON形式で取得します。

Blackbox exporter

Blackbox exporterのリロード

Blackbox exporterの定義ファイルを再読み込みし，Blackbox exporterの動作に反映します。

JP1/IM - Agentが使用するExporterのスクレイプ用のAPI

Prometheus serverのスクレイプ対象の各Exporterのスクレイプを実行します。

注※

各APIにアクセス制御機能はありません。ファイアウォールで許可するポートに対して，接続可能なIPアドレスを指定することにより，APIの接続元ホストを制限できます。

5.2　API共通の仕様

JP1/IM - Manager（インテリジェント統合管理基盤）が収集した監視対象の情報などを，APIを利用してhttp(s)経由で取得できます。

インテリジェント統合管理基盤のAPIは，REST（Representational State Transfer）アーキテクチャスタイルに従います。

5.2.1　通信方式

APIが使用する通信プロトコルおよびポート番号について，次に示します。APIとの通信には，httpプロトコルまたはhttpsプロトコルを使用できます。

通信プロトコル

HTTP，HTTPS

ポート番号

20703

ポート番号の設定については，「インテリジェント統合管理基盤定義ファイル（imdd.properties）」（2.　定義ファイル）を参照してください。

5.2.2　入出力形式

APIのリクエストおよびレスポンスのデータ形式として，JSON形式を利用します。文字コードは，UTF-8を使用します。

5.2.3　リクエスト形式

APIでインテリジェント統合管理基盤が提供する機能を利用するためのリクエスト形式を次に示します。

method△/application/component/apiVersion/resourceId?query△httpVersion
requestHeader

messageBody

（凡例）

△：半角スペース

リクエスト形式の構成内容について，次の表で説明します。

表5‒3　リクエスト形式の構成内容

項目

説明

method

リソースに対する操作を指定します。APIの処理に応じて，メソッドを指定してください。APIがサポートするメソッドを次に示します。

GET

リソースの一覧や情報を取得します。

POST

リソースに応じてインテリジェント統合管理基盤の処理を実行します。

PUT

リソースの一覧や情報を更新します。

DELETE

リソースの一覧や情報を削除します。

指定するメソッドについては，各APIの「リクエスト形式」を参照してください。

application

APIを提供するアプリケーション名称です。固定値として「im」指定します。

component

APIのコンポーネント名です。ユーザーが使用するAPIの場合は「api」，システムが使用するAPIの場合は「api_system」を指定します。なお，「5.2.8(4)REST APIに付加したクライアントシークレット情報による認証（Basic認証）」に使用できるAPIは，コンポーネント名が「api_system」のAPIに制限されます。

apiVersion

APIのバージョンです。固定値として「v1」指定します。

resourceId

インテリジェント統合管理基盤が提供する機能をAPIのリソース識別子として提供しています。実行したい処理に応じて指定します。詳細は「表5-4 リソース識別子」を参照してください。

query

クエリ文字列です。リクエストに検索条件を付加することで，レスポンスの出力内容をフィルタリングしたり，ソートしたりすることができます

httpVersion

APIが使用する通信プロトコルのバージョンです。固定値として「HTTP/1.1」を指定します。

requestHeader

レスポンスのデータ形式およびレスポンスの言語コードなどを指定します。詳細は「表5-5 リクエストヘッダー」を参照してください。

messageBody

メッセージボディーのデータ形式を指定します。

JSON形式を利用できます。文字コードは，UTF-8を使用します。

表5‒4　リソース識別子

リソース識別子

アクセスするリソース

nodes

管理ノード

status

ステータス情報

links

リンク情報（ジョブネットのつながりなど）

events

JP1イベント

actions

プラグインのアクション（性能情報取得など）

login

ログイントークンや権限

proxyUsers

プロキシユーザー情報

表5‒5　リクエストヘッダー

ヘッダー

説明

デフォルト値

指定の要否

Authorization

APIの認証情報を設定します。呼び出しに権限が必要なAPIでは必ず指定してください。

認証情報の詳細，および認証情報を設定してREST APIを呼び出す方法については「5.2.8　REST APIの認証方法」を参照してください。

なし

必須

Accept-Language

レスポンスデータに指定したい言語の言語コードを，次のどちらかの値で指定します。

jaまたはja-JP

日本語

en

英語

指定を省略した場合，指定できる値以外を指定した場合は，enが仮定されます。

指定した値に関わらず，ステータスコード200が返却されます。

en

任意

Content-Type

リクエストのメッセージボディーのデータ形式です。固定値として「application/json」を指定します。

POSTメソッドを使用する場合に指定を省略したり，不正な値を指定したりした場合は，ステータスコード415が返却されます。

POSTメソッドを使用する場合でメッセージボディーが無いとき，またはGETメソッドを使用する場合で「application/json」以外の値を指定したときは，ステータスコード200が返却されます。

なし

必須

Content-Length

リクエストのメッセージボディーの長さを指定します。

GETメソッドの場合

指定を省略するか，「0」を指定します。

POSTメソッドの場合

リクエストボディーのサイズ（単位：バイト）を，半角数字（10進数）で指定します。

POSTメソッドを使用する場合で指定を省略した場合は，ステータスコード411が返却されます。

POSTメソッドを使用する場合に指定したサイズ以上のリクエストボディーを指定した場合，ステータスコード500が返却されます。

POSTメソッドを使用する場合でメッセージボディーが無いとき，またはGETメソッドを使用する場合は，ステータスコード200が返却されます。

なし

任意

GETメソッド

必須

POSTメソッド

Accept

レスポンスのメッセージボディーのデータ形式です。固定値として「application/json」を指定します。

POSTメソッドを使用する場合で「application/json」以外の値を指定したときは，ステータスコード406を返却します。

POSTメソッドを使用する場合でメッセージボディーが無いとき，またはGETメソッドを使用する場合で「application/json」以外の値を指定したときは，ステータスコード200が返却されます。

application/json

任意

Cookie

再ログインしないで連続してREST APIを発行する場合，ログインAPIのレスポンスのCookie情報を指定します。

Cookieを指定するとセッションを維持できるようになり，REST APIを発行するたびにログイン/ログアウトをする必要がなくなります。REST APIの発行から3分を超えると，自動的にセッションは破棄されます。

セッションを維持しない場合は，指定する必要はありません。

また，REST APIに付加したログイン情報による認証（Basic認証）を使用する場合は，指定しないでください。

なし

任意

上記の表に示す以外のプロパティが指定された場合，そのプロパティは無視されます。

5.2.4　リクエストボディーサイズの制限

JP1/IMのAPIでは，リクエストボディーのサイズは10MB未満までに制限されています。10MBを超えた場合は，ステータスコード413を返却しKAJY00009-Eのエラーメッセージが出力されます。メッセージの詳細については，マニュアル「JP1/Integrated Management 3 - Manager メッセージ」を参照してください。

5.2.5　レスポンス形式

レスポンス形式を次に示します。

httpVersion△statusCode
responseHeader

messageBody

（凡例）

△：半角スペース

表5‒6　レスポンス形式の構成内容

項目

説明

httpVersion

APIが使用する通信プロトコルのバージョンとして「HTTP/1.1」が返却されます。

statusCode

リクエストの実行結果がステータスコードとして返却されます。

responseHeader

リクエストヘッダーで指定された，レスポンスのデータ形式が返却されます。

messageBody

メッセージボディーのデータが，次の形式で返却されます。

データ形式：JSON

文字コード：UTF-8

(1)　ステータスコード

APIの実行時に返却されるステータスコードの一覧を示します。なお，返却されるステータスコードは，APIごとに異なるため，詳細は各APIを参照してください。

表5‒7　ステータスコード

ステータスコード

メッセージ

説明

200

詳細は各APIを参照してください。

リクエストの処理に成功しました。

400

Bad-request

リクエスト内容が不正です。

401

Unauthorized

認証に失敗しています。認証情報または許可情報が不正です。

403

Forbidden

リクエストの実行権限がありません。

404

Not-found

リクエストされたリソースまたはリソースに対する操作がありません。または，パラメーターの指定が不正です。

406

Not-acceptable

指定されたレスポンスのフォーマット形式はサポートされていません。

411

Length Required

POSTメソッド使用時に，リクエストヘッダーのContent-Lengthプロパティが省略されています。

413

Payload Too Large

リクエストボディーサイズが上限を超えています。

415

Unsupported media type

指定されたリクエストのフォーマット形式はサポートされていません。

500

Server-error

サーバ処理エラーが発生しました。

503

Service Unavailable

インテリジェント統合管理基盤のサービスが利用できません。

一時的に混み合っているなどで使用できない可能性があります。

(2)　レスポンスヘッダー

インテリジェント統合管理基盤で制御しているレスポンスヘッダーを次の表に示します。

表5‒8　レスポンスヘッダー

ヘッダー

説明

Cache-Control

APIのレスポンス情報をキャッシュしないため，以下を指定します。

---
Cache-Control: no-store, no-cache, max-age=0
Pragma: no-cache
Expires: Thu, 01 Jan 1970 00:00:00 GMT

Content-Type

レスポンスデータのデータ形式です。固定値として「application/json」を返却します。

WWW-Authenticate

REST APIに付加したログイン情報による認証(Basic認証)を使用した場合に，認証が必要であることを示します。

---
WWW-Authenticate: Basic realm="JP1 Authentication Realm"

5.2.6　エラー発生時のレスポンスメッセージ

ステータスコードが「200」以外の場合は，レスポンスのメッセージボディーに次の例外オブジェクトを設定します。

{
"timestamp":1539923958358,
"status":403,
"error":"Forbidden",
"exception":"jp.co.hitachi_solutions.it_service_cooperation_framework.security.ImDdBadCredentialsException",
"message":"パラメーター不正によりログイン処理に失敗しました。,
"path":"/im/api/v1/login",
"messageId":"KAJY52001-E",
"returnCode":3
}

表5‒9　エラー発生時のレスポンス形式の構成内容

項目

説明

timestamp

1970年1月1日0:00からの経過を，ミリ秒単位（UTC形式）で設定します。

status

レスポンス形式のstatusCodeです。

exception

発生した例外オブジェクトのクラスです。

message

発生した例外オブジェクトが保持するメッセージです。

（Throwable#getMessage()で得られる文字列）

path

発行したREST APIのURIのpath以降です。

messageId

JP1のメッセージIDです。

returnCode

REST APIの戻り値です。

extensions

レスポンスの拡張情報です。

5.2.7　データ型

JP1/IMのAPIで対応するデータ型を次に示します。

表5‒10　対応するデータ型

データ型

説明

boolean

trueまたはfalse

int

32bit符号付きの整数

long

64bit符号付きの整数

string

テキストデータ

string型で数字を扱う場合，特に説明が無い限り10進数として扱います。

JSON形式のstring型で次の文字を使用する場合は，エスケープ表記で表現してください。

表5‒11　 JSON形式のstring型でエスケープする文字

文字

エスケープ表記

「"（ダブルクォーテーションマーク）」

¥"

「¥（バックスラッシュ）」

¥¥

バックスペース

¥b

フォームフィード，改ページ

¥f

ラインフィード

¥n

キャリッジリターン

¥r

タブ

¥t

日付と時間は，次の形式（ISO8601形式）で指定します。返却時も同じ形式です。

形式

YYYY-MM-DDThh:mm:ssTZD

表5‒12　日付と時間の構成内容

表記

説明

指定できる値

YYYY

年を指定します。

1994〜2099（単位：年）

MM

月を指定します。

01〜12（単位：月）

DD

日にちを指定します。

01〜指定した月の最終日（単位：日）

hh

時間を指定します。

00〜23（単位：時）

mm

分を指定します。

00〜59（単位：分）

ss

秒を指定します。

00〜59（単位：秒）

TZD

指定時刻と協定世界時（UTC）との時差を指定します。

UTCの場合

Z

UTC以外の場合

「+hh:mm」または「-hh:mm」

例えば，協定世界時で2019年3月1日12時0分0秒の時刻を，日本標準時で指定する場合は「2019-03-01T21:00:00+09:00」，アメリカ東部標準時で指定する場合は「2019-03-01T07:00:00-05:00」となります。

また，夏時間の制度を採用している国や地域の場合，例えば，協定世界時で2019年4月1日12時0分0秒の時刻を，IM-DDがアメリカ東部標準時（Daylight Saving Time）で指定する場合は「2019-04-01T08:00:00-04:00」となります。

5.2.8　REST APIの認証方法

APIのリクエストを発行してレスポンスを取得するには，ユーザー認証を受ける必要があります。インテリジェント統合管理基盤の認証方法には，次に示す種類があります。

ログインAPIによる認証

REST APIに付加したログイン情報による認証（Basic認証）

REST APIに付加したログイン情報による認証（OpenID認証）

REST APIに付加したクライアントシークレット情報による認証（Basic認証）

(1)　ログインAPIによる認証

ログインAPIによる認証の流れを次に示します。

ログインAPIを呼び出す。

JP1ユーザー名とパスワードで認証を行い，token情報とCookie情報を取得します。ログインAPIについては「5.4.1　ログイン」を参照してください。

任意のREST APIを呼び出す。

ログインAPIで取得したtoken情報を，次の形式でHTTPリクエストヘッダーに設定してREST APIを呼び出します。

呼び出し対象となるのはlogin，logout以外のREST APIです。

リクエストヘッダー

Authorization

設定値

"Bearer△" +tokenの文字列

（凡例）

　　△：半角スペース

設定例

ログインAPIで取得したtoken情報が"anAxYWRtaW46TUdGa01tTTJNMlV3TURFNFh6STNYekE0T2p"の場合の設定例を次に示します。

Authorization: Bearer anAxYWRtaW46TUdGa01tTTJNMlV3TURFNFh6STNYekE0T2p

ログアウトAPIを呼び出す。

ログインAPIで取得したCookie情報で，ログイン中の認証情報を破棄します。ログアウトAPIについては「5.4.2　ログアウト」を参照してください。

(2)　REST APIに付加したログイン情報による認証（Basic認証）

REST APIに付加したログイン情報によるBasic認証の流れを次に示します。

Basic認証の設定は，デフォルトで無効です。有効にする場合はインテリジェント統合管理基盤定義ファイル（imdd.properties）のjp1.imdd.authBasicプロパティにtrueを指定する必要があります。

インテリジェント統合管理基盤定義ファイル（imdd.properties）については，「インテリジェント統合管理基盤定義ファイル（imdd.properties）」（2.　定義ファイル）を参照してください。

任意のREST APIを呼び出す。

REST API呼び出し時のHTTPリクエストヘッダーに，認証方式"Basic"に続けて，ユーザー名とパスワードを":"（ASCII:0x3A）で連結した文字列をBase64エンコードしたもの（basic tokenと呼びます）を指定します。

リクエストヘッダー

Authorization

設定値

"Basic△" + JP1ユーザー名:パスワードをBase64エンコードしたASCII文字列

（凡例）

　　△：半角スペース

設定例

JP1ユーザーが"jp1user"，パスワードが"password"の場合に，"jp1user:password"をBase64エンコードした文字列"anAxdXNlcjpwYXNzd29yZA=="を使用して，次に示すようにbasic tokenを設定します。

Authorization: Basic anAxdXNlcjpwYXNzd29yZA==

重要

Basic認証はステートレスな認証手段のため，リクエストヘッダーにCookieは指定しないでください。

Basic認証はHTTP，およびHTTPSのどちらも使用できますが，セキュリティの向上のため，HTTPSによるアクセスを推奨します。

REST APIを実行するたびに認証サーバで認証を行うため，認証サーバには，ユーザー管理機能に関するメッセージが実行のたびに出力されます。認証サーバ内に統合トレースログを出力するシステムが混在している場合は，ユーザー管理機能に関するメッセージで統合トレースを圧迫してしまう可能性を考慮し，システム構成の設計をしてください。

(3)　REST APIに付加したログイン情報による認証（OpenID認証）

REST APIに付加したログイン情報によるOpenID認証の流れを次に示します。

OpenID認証の設定は，デフォルトで無効です。有効にする場合はインテリジェント統合管理基盤定義ファイル（imdd.properties）でOpenIDプロバイダに関するプロパティの設定が必要です。

インテリジェント統合管理基盤定義ファイル（imdd.properties）については，「インテリジェント統合管理基盤定義ファイル（imdd.properties）」（2.　定義ファイル）を参照してください。

任意のREST APIを呼び出す。

REST API呼び出し時のHTTPリクエストヘッダーに，認証方式"Bearer"に続けて，OpenIDプロバイダから取得したアクセストークンを指定します。

リクエストヘッダー

Authorization

設定値

"Bearer△" + アクセストークンの文字列

（凡例）

　　△：半角スペース

インテリジェント統合管理基盤側で複数のOpenIDプロバイダを認証基盤として設定している場合，REST API呼び出し時のHTTPリクエストヘッダーX-Token-Issuerに，インテリジェント統合管理基盤定義ファイル（imdd.properties）で定義したOpenIDプロバイダのキー名（アクセストークンの発行者）を指定する必要があります。

インテリジェント統合管理基盤側でREST APIの処理を受け付けした際に，HTTPリクエストヘッダーX-Token-Issuerの指定がない場合，またはX-Token-Issuerに指定した値とインテリジェント統合管理基盤定義ファイル（imdd.properties）で定義したOpenIDプロバイダのキー名が一致しない場合は認証エラーとなり，REST APIの呼び出し元にステータスコード403とエラーメッセージKAJY52030-Eが返却されます。

インテリジェント統合管理基盤側で一つのOpenIDプロバイダだけを認証基盤として設定している場合，REST API呼び出し時のHTTPリクエストヘッダーX-Token-Issuerの指定を省略できます。省略した場合，インテリジェント統合管理基盤定義ファイル（imdd.properties）で定義されているOpenIDプロバイダをアクセストークンの発行者と仮定して，処理を実行します。

X-Token-Issuerはインテリジェント統合管理基盤の独自定義のリクエストヘッダーです。フォーマットを次に示します。

リクエストヘッダー

設定値

X-Token-Issuer

アクセストークンを発行したOpenIDプロバイダ名です。

インテリジェント統合管理基盤定義ファイル（imdd.properties）で定義したOpenIDプロバイダのキー名の値を指定します。

設定例1

・アクセストークンの発行者がKeycloak

・インテリジェント統合管理基盤側定義ファイルに一つのOpenIDプロバイダを認証基盤として設定している

　OpenIDプロバイダのキー名（Keycloak）

・OpenIDプロバイダから取得したアクセストークンが"ABCDEFG.HIJKLMN.OPQRSTUVWXYZ"

次に示すようにリクエストヘッダーにアクセストークンを設定します。

Authorization: Bearer ABCDEFG.HIJKLMN.OPQRSTUVWXYZ

設定例2

・アクセストークンの発行者がKeycloak

・インテリジェント統合管理基盤側で複数のOpenIDプロバイダ（Keycloak，Okta）を認証基盤として設定している

　OpenIDプロバイダのキー名（Keycloak）

　OpenIDプロバイダのキー名（Okta）

・OpenIDプロバイダから取得したアクセストークンが"ABCDEFG.HIJKLMN.OPQRSTUVWXYZ"

次に示すようにリクエストヘッダーにアクセストークンとトークン発行者を設定します。

Authorization: Bearer ABCDEFG.HIJKLMN.OPQRSTUVWXYZ

X-Token-Issuer: Keycloak

重要

HTTP，およびHTTPSのどちらも使用できますが，OpenID認証を使用する場合は，中間者攻撃の対策としてHTTPSでの運用を強く推奨します。運用時は必ずHTTPSによるアクセスを使用してください。

インテリジェント統合管理基盤で使用するJP1ユーザー名とOpenIDプロバイダに登録されているユーザー名のマッピングのため，アクセストークンのpreferred_usernameクレームにOpenIDプロバイダのログインユーザー名を含める必要があります。アクセストークンの発行者がKeycloakの場合，preferred_usernameクレームはデフォルトでアクセストークンに設定されます。Oktaの場合は手動で設定する必要があります。設定方法については，Oktaのドキュメントを参照してください。

preferred_usernameクレームが設定されていない場合は，エラーメッセージKAJY52028-Eが返却されます。シングルサインオンマッピングの定義については「シングルサインオンマッピング定義ファイル（imdd_sso_mapping.properties）」（2.　定義ファイル）参照してください。

(4)　REST APIに付加したクライアントシークレット情報による認証（Basic認証）

REST APIに付加したクライアントシークレット情報によるBasic認証の流れを次に示します。この認証は，統合エージェントと統合マネージャーの通信にも使用されるため，常に有効です。また，この認証を使用できるREST APIはシステムが使用するAPIだけに制限されます。詳細については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「3.7 初期シークレットとクライアントシークレット」を参照してください。

この認証はJP1ユーザーを使用しないため，ログインおよびログアウトの処理は行いません。また，クライアント（被認証対象）に権限を設定しないため，権限によるアクセス制限は行いません。

認証の結果については，シークレット認証ログファイルに出力します。

任意のREST APIを呼び出す。

REST API呼び出し時のHTTPリクエストヘッダーに，認証方式（"Basic"または"basic_auth"を指定できます）に続けて，ユーザー名とパスワードを":"（ASCII:0x3A）で連結した文字列をBase64エンコードしたもの（client tokenと呼びます）を指定します。

リクエストヘッダー

Authorization

設定値

・認証方式に"Basic"を指定する場合

"Basic△" + クライアントID:クライアントシークレットをBase64エンコードしたASCII文字列

・認証方式に"basic_auth"を指定する場合

"basic_auth△" + クライアントID:クライアントシークレットをBase64エンコードしたASCII文字列

（凡例）

　　△：半角スペース

設定例

クライアントIDが">client"，クライアントシークレットが"secret"の場合に，">client:secret"をBase64エンコードした文字列" PmNsaWVudDpzZWNyZXQ="を使用して，次に示すようにclient tokenを設定します。

・認証方式に"Basic"を指定する場合

Authorization: Basic PmNsaWVudDpzZWNyZXQ=

・認証方式に"basic_auth"を指定する場合

Authorization: basic_auth PmNsaWVudDpzZWNyZXQ=

重要

Basic認証はステートレスな認証手段のため，リクエストヘッダーにCookieは指定しないでください。

Basic認証はHTTP，およびHTTPSのどちらも使用できますが，セキュリティの向上のため，HTTPSによるアクセスを推奨します。

5.3　APIの記述形式

各APIで説明する項目を次に示します。ただし，APIによっては説明の無い項目もあります。

機能

APIの機能について説明します。

実行権限

APIを実行できる権限およびロールを示します。

APIのバージョン

APIのバージョンを示します。

形式

APIのリクエスト形式およびレスポンス形式について説明しています。

パラメーター

リクエストのメッセージボディーに指定するパラメーターについて説明します。

ステータスコード

httpプロトコルまたはhttpsプロトコルを使用してAPIを実行したあとのステータスコードについて説明します。APIを実行する前にエラーになった場合のステータスコードについては，「5.2.5(1)　ステータスコード」を参照してください。

戻り値

APIが返却する戻り値の情報について説明します。

使用例

APIを使用するためのリクエスト例およびレスポンス例について説明します。

ただし，ここでは，httpプロトコルを使用している場合の例を記載します。httpsプロトコルを使用する場合は，「HTTP」を「HTTPS」に読み替えてください。

5.4　ユーザー認証のAPI

ユーザー認証のAPIに関する操作を説明します。

5.4.1　ログイン

機能

指定したリクエストに従って，インテリジェント統合管理基盤にログインします。

実行権限

JP1_Console_Admin

JP1_Console_Operator

JP1_Console_User

APIのバージョン

v1

形式

リクエスト行

POST /application/component/apiVersion/login/ httpVersion

リクエストのメッセージボディー

{
    "user":ユーザー名,
    "password":パスワード
}

レスポンスのメッセージボディー

{
    "jp1user":JP1ユーザー,
    "jp1token":JP1認証トークン,
    "token":Authorizationヘッダー認証トークン,
    "clientId":クライアントID,
    "permissions":[
        JP1ユーザー権限, …
    ]
}

パラメーター

user

ユーザー名を文字列型で指定します。

password

パスワードを文字列型で指定します。

ステータスコード

リクエストに対するレスポンスとして返却されるステータスコードを，次の表に示します。

ステータスコード

メッセージ

説明

200

−

ログインに成功しました。

403

KAJY52001-E

パラメーターが不正なためログインに失敗しました。

KAJY52002-E

認証データが登録されているサーバとの通信に失敗しました。

KAJY52003-E

内部エラーによりログインに失敗しました。

KAJY52004-E

ログイン権限がありません。

メッセージの詳細については，マニュアル「JP1/Integrated Management 3 - Manager メッセージ」を参照してください。

戻り値

レスポンスヘッダーに次の情報を返却します。

パラメーター名

説明

Set-Cookie

Cookie情報

ステータスコードが200の場合に，レスポンスボディーに次の情報を返却します。

項番

メンバー名

データ型

説明

1

jp1user

文字列

JP1ユーザー名

2

jp1token

文字列

JP1認証トークン

3

token

文字列

Authorizationヘッダー認証用トークン

4

clientId

文字列

クライアントを一意に識別するための識別子

5

permissions

配列

JP1権限文字列の配列

ステータスコードが200以外の場合は，レスポンスのメッセージボディーに次の例外オブジェクトを設定します。

項番

メンバー名

データ型

説明

1

returnCode

文字列

詳細要因コード

使用例

ログインAPI呼び出し例

POST http://hostname:xxxxx/im/api/v1/login HTTP/1.1

{
    "user": "jp1admin",
    "password":"password"
}

ログインAPI応答例

HTTP/1.1 200 OK
Set-Cookie: JSESSIONID=7F2FB43CF4829025661D9E139E911B3B

{
    "jp1user": "jp1admin",
    "jp1token": "MGFkMmM2M2UwMDE4XzI3XzA4OjI0OjMzX19fX19fX19fX19fX19fX2p
wMWFkbWluICAgICAgICAgICAgICAgICAgICAgICAg",
    "token": "anAxYWRtaW46TUdGa01tTTJNMlV3TURFNFh6STNYekE0T2pJME9qTXpYMT
lmWDE5ZlgxOWZYMTlmWDE5ZlgycHdNV0ZrYldsdUlDQWdJQ0FnSUNBZ0lDQWdJQ0FnSUNB
Z0lDQWdJQ0Fn",
    "clientId": "02157e39-2248-4a0e-8b63-78ffb4296e28",
    "permissions": {
        "*": [/*略*/]
    }
}

5.4.2　ログアウト

機能

ログイン中の認証情報を破棄します。

実行権限

なし。

APIのバージョン

v1

形式

リクエスト行

POST /application/component/apiVersion/logout/ httpVersion

リクエストヘッダー

Cookie:Cookie情報

リクエストのメッセージボディー

なし

レスポンスヘッダー

Set-Cookie:Cookie情報

レスポンスのメッセージボディー

true

パラメーター

Cookie

Cookie情報を指定します。

ステータスコード

リクエストに対するレスポンスとして返却されるステータスコードを，次の表に示します。

ステータスコード

メッセージ

説明

200

−

ログアウトに成功しました。

戻り値

レスポンスヘッダーに次の情報を返却します。

パラメーター名

説明

Set-Cookie

Cookie情報

使用例

ログアウトAPI呼び出し例

POST http://hostname:xxxxx/im/api/v1/logout HTTP/1.1
Cookie: JSESSIONID=7F2FB43CF4829025661D9E139E911B3B

5.4.3　初期シークレット発行

機能

初期シークレットを発行します。

マネージャーと連携するためには，認証対象となるクライアントごとに，クライアントシークレットの割り当てが必要です。クライアントシークレットを取得するまでのマネージャーとの連携では，マネージャーに対して1つ割り当てられ，すべての要求元で共有する初期シークレットを一時的に使用できます。

発行したシークレットは，統合エージェントホスト管理DBに保存されます。

実行権限

次の権限が必要です。

JP1資源グループ：*

JP1権限レベル：JP1_Console_Admin

APIのバージョン

v1

形式

リクエスト行

POST /application/component/apiVersion/secret/generateInfo httpVersion

リクエストのメッセージボディー

なし

レスポンスのメッセージボディー

{
  "secret": 認証用のシークレット,
  "lastUpdateTime": シークレットの生成日時
}

パラメーター

なし

ステータスコード

リクエストに対するレスポンスとして返却されるステータスコードを，次の表に示します。

ステータスコード

メッセージ

説明

200

−

APIの処理が成功しました。

403

KAJY01000-E

認証に使用したユーザーの権限不足です。

500

KAJY68001-E

DBアクセスエラー

戻り値

ステータスコードが200の場合に，レスポンスボディーに次の情報を返します。

メンバー名

データ型

説明

secret

string

発行したシークレット

lastUpdateTime

string

シークレットの発行日時

形式はISO8601の拡張形式のUTC時刻「YYYY-MM-DDThh:mm:ssZ」です。

エラーメッセージの出力について

APIの実行時にエラーが発生した場合，APIのレスポンスにエラーメッセージの内容を含めて呼び出し元へ返却します。呼び出し元は受け取ったレスポンスの情報を使って，呼び出し元でメッセージの表示を行います。

使用例

APIの使用例を次に示します。

リクエスト：

POST http://immhost01:20703/im/api/v1/secret/generateInfo

マネージャーホスト名：immhost01

レスポンス：

< HTTP/1.1 200 OK
< Content-Type: application/json

{
    "secret": "発行したシークレット",
    "lastUpdateTime": "2022-10-20T12:25:45Z"
}

5.4.4　IMクライアントシークレット削除

機能

データベースに登録されたIMクライアントシークレットを削除します。

実行権限

次の権限が必要です。

JP1資源グループ：*

JP1権限レベル：JP1_Console_Admin

APIのバージョン

v1

形式

リクエスト行

POST /application/component/apiVersion/secret/client/deleteInfo httpVersion

リクエストのメッセージボディー

{
    "clientIds": [ IMクライアントID, .... ]
}

リクエストのメッセージボディーに指定するパラメーターを次に示します。

メンバー名

データ型

省略可否

説明

clientIds

string[]

不可

削除するIMクライアントシークレットのIDのリストを指定します。

JP1/IMと連携する場合，リストの要素には，任意の文字列を指定できます。

ただし，次の文字列は指定できません。

「AGENT_」で始まる文字列

「MANAGER__INTEGRATED_ホスト名」以外の「MANAGER_」で始まる文字列

指定できる文字数は1〜280文字で，指定できる文字はASCIIコード（0x20〜0x7e（「:」を除く））です。

ステータスコード

リクエストに対するレスポンスとして返却されるステータスコードを，次の表に示します。

ステータスコード

メッセージ

説明

200

−

APIの処理が成功しました。

400

KAJY68002-E

リクエストパラメーターが不正です。

403

KAJY01000-E

認証に使用したユーザーの権限不足です。

500

KAJY68007-E

DBアクセスエラー

指定したIMクライアントIDがDBに登録されていない。

エラーメッセージの出力について

APIの実行時にエラーが発生した場合，APIのレスポンスにエラーメッセージの内容を含めて呼び出し元へ返却します。呼び出し元は受け取ったレスポンスの情報を使って，呼び出し元でメッセージの表示を行います。

使用例

APIの使用例を次に示します。

リクエスト：

POST http://immhost01:20703/im/api/v1/secret/client/deleteInfo

{
    "clientIds": [ "clientId1", "clientId2" ]
}

マネージャーホスト名：immhost01

レスポンス：

< HTTP/1.1 500 Internal Server Error
< Content-Type: application/json
{
    "timestamp": 1585561108345,
    "status": 500,
    "error": "Internal Server Error",
    "exception":"XXXXXXXXXXXXXXXXXXXXXXX",
    "message": "IMクライアントシークレットの削除に失敗しました。",
    "path": "/im/api/v1/secret/client/deleteInfo ",
    "messageId": " KAJY68007-E"
}

5.4.5　IMクライアントシークレット発行

機能

IMクライアントシークレットを発行します。

マネージャーホストに対して，ユーザー独自のOSS，または，JP1/IM - Managerが提供するCloudWatch Logs/AzureMonitorとの連携ツールや下位マネージャーと連携する場合，IMクライアントシークレットを使用して，インテリジェント統合管理基盤と連携先との通信で認証を行います。

実行権限

次の権限が必要です。

JP1資源グループ：*

JP1権限レベル：JP1_Console_Admin

APIのバージョン

v1

形式

リクエスト行

POST /application/component/apiVersion/secret/client/generateInfo httpVersion

リクエストのメッセージボディー

{
    "clientId": IMクライアントID
}

レスポンスのメッセージボディー

{
  "clientSecret": 認証用のIMクライアントシークレット,
  "lastUpdateTime": IMクライアントシークレットの発行日時
}

リクエストのメッセージボディーに指定するパラメーターを次に示します。

メンバー名

データ型

省略可否

説明

clientId

string

不可

発行するIMクライアントシークレットのIDを指定します。

JP1/IMと連携する場合，リストの要素には，任意の文字列を指定できます。

ただし，次の文字列は指定できません。

「AGENT_」で始まる文字列

「MANAGER_」で始まる文字列

指定できる文字数は1〜280文字で，指定できる文字はASCIIコード（0x20〜0x7e（「:」を除く））です。

ステータスコード

リクエストに対するレスポンスとして返却されるステータスコードを，次の表に示します。

ステータスコード

メッセージ

説明

200

−

APIの処理が成功しました。

400

KAJY68002-E

リクエストパラメーターが不正です。

400

KAJY68004-E

同じIMクライアントIDで登録済みです。

403

KAJY01000-E

認証に使用したユーザーの権限不足です。

500

KAJY68008-E

DBアクセスエラー

戻り値

ステータスコードが200の場合に，レスポンスボディーに次の情報を返します。

メンバー名

データ型

説明

clientSecret

string

発行したIMクライアントシークレット

lastUpdateTime

string

IMクライアントシークレットの発行日時

形式はISO8601の拡張形式のUTC時刻「YYYY-MM-DDThh:mm:ssZ」です。

エラーメッセージの出力について

APIの実行時にエラーが発生した場合，APIのレスポンスにエラーメッセージの内容を含めて呼び出し元へ返却します。呼び出し元は受け取ったレスポンスの情報を使って，呼び出し元でメッセージの表示を行います。

使用例

APIの使用例を次に示します。

リクエスト：

POST http://immhost01:20703/im/api/v1/secret/client/generateInfo
{
    "clientId": "clientSecret1"
}

マネージャーホスト名：immhost01

レスポンス：

< HTTP/1.1 200 OK
< Content-Type: application/json
{
    "clientSecret": "発行したIMクライアントシークレット",
   "lastUpdateTime": "2022-10-20T12:25:45Z"
}

5.4.6　IMクライアント一覧取得

機能

登録済みのIMクライアントIDの一覧を取得します。

マネージャーホストに対して，ユーザー独自のOSS，または，JP1/IM - Managerが提供するCloudWatch Logs/AzureMonitorとの連携ツールや下位マネージャーと連携する場合、IMクライアントシークレットを使用して，インテリジェント統合管理基盤と連携先との通信で認証を行います。

実行権限

次の権限が必要です。

JP1資源グループ：*

JP1権限レベル：JP1_Console_Admin

APIのバージョン

v1

形式

リクエスト行

GET /application/component/apiVersion/secret/client/list httpVersion

リクエストのメッセージボディー

なし

レスポンスのメッセージボディー

{
  "clientIds": [IMクライアントID,...]
}

ステータスコード

リクエストに対するレスポンスとして返却されるステータスコードを，次の表に示します。

ステータスコード

メッセージ

説明

200

−

APIの処理が成功しました。

403

KAJY01000-E

認証に使用したユーザーの権限不足です。

500

KAJY68009-E

DBアクセスエラー

戻り値

ステータスコードが200の場合に，レスポンスボディーに次の情報を返します。

メンバー名

データ型

説明

clientIds

string[]

IMクライアントシークレットを識別するIDの配列

エラーメッセージの出力について

APIの実行時にエラーが発生した場合，APIのレスポンスにエラーメッセージの内容を含めて呼び出し元へ返却します。呼び出し元は受け取ったレスポンスの情報を使って，呼び出し元でメッセージの表示を行います。

使用例

APIの使用例を次に示します。

リクエスト：

GET http://immhost01:20703/im/api/v1/secret/client/list

マネージャーホスト名：immhost01

レスポンス：

< HTTP/1.1 200 OK
< Content-Type: application/json
{
    "clientIds": [ "clientid1", "clientid2" ]
}

5.5　リンク情報のAPI

リンク情報のAPIに関する操作を説明します。

5.5.1　リンク情報取得

機能

ジョブなどのオブジェクトの順序関係を表す，リンク情報を取得します。

システムにリンク情報が登録されている場合に，特定のオブジェクトの前後などの指定された条件を満たすリンク情報を取得します。

実行権限

マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「付録E.1 インテリジェント統合管理基盤によるシステムの運用監視で必要な操作権限」を参照してください。

APIのバージョン

v1

形式

リクエスト行

POST /application/component/apiVersion/links httpVersion

リクエストのメッセージボディー

{
    "type": 処理対象種別,
    "sid": 処理対象IM管理ノードのSID,
    "fromLayerCount": 先行ノード階層数,
    "toLayerCount": 後続ノード階層数,
    "countPerLayer": 1階層当たりのノード数,
    "linkCount": ノード関係数
}

レスポンスのメッセージボディー

{
    "links": [
        {
            "from": 先行ノードのSID,
            "to": 後続ノードのSID,
            "type": 処理対象種別
        }, ...
    ],
    "exceedCountDetected": {
        "countPerLayer": {
        ...,
            "layer-2": -2階層の階層あたりノード数オーバー検知有無,
            "layer-1": -1階層の階層あたりノード数オーバー検知有無,
            "layer0": 0階層の階層あたりノード数オーバー検知有無,
            "layer1": 1階層の階層あたりノード数オーバー検知有無,
            "layer2": 2階層の階層あたりノード数オーバー検知有無,
            ...
         },
        "linkCount": ノード関係数オーバー検知有無
    },
    "messageId": メッセージID,
    "message":メッセージ
}

パラメーター

type

システムに適用されているリンク情報の種別のうち，取得したいリンク情報の種別を指定します。

typeは同じ意味を持つ関連同士をグループ化する情報です。統合オペレーション・ビューアーの［関連ノード］タブでは，typeごとに関連をフィルタリングして表示することができます。

JP1/IMの製品内や他製品との連携では次の種別を使用します。これらの種別以外に，ユーザーが任意の種別を指定することもできます。

rootJobnetExecutionOrder：ルートジョブネット実行順序の関連

managerAgent：JP1製品のマネージャーとエージェントの関連

rootJobnetAgent：ルートジョブネットとAJSエージェントの関連

sameNode：名称が同一のノードの関連

L2Connection：JP1/NNMiで管理するレイヤー2接続線の関連

Infrastructure：JP1/OAで管理するインフラリソースの関連

monitoringConfiguration：監視製品の構成における製品と監視対象の関連

この属性を省略，またはこの属性に空文字列を指定した場合，リンク情報の種別に関わらず，該当するリンク情報を返却します。

この属性を指定した場合，該当するリンク情報のうち，指定した種別のリンク情報を返却します。

sid

処理対象とするノードのSIDを指定します。指定した部位の先行・後続ノード情報が返却されます。

（例）ルートジョブネットを指定する場合

_JP1AJS-M_JP1/AJS3マネージャーホスト名/_HOST_JP1/AJS3マネージャーホスト名/_JP1SCHE_スケジューラーサービス名/_JP1JOBG_ジョブグループ名/_JP1ROOTJOBNET_ノード名

このパラメーターの指定を省略した場合は，すべてのリンク情報を取得します。

fromLayerCount

取得する先行ノード階層数の上限値を，0〜2147483647の範囲で指定します。

sidを指定した場合，fromLayerCountパラメーターは省略できません。

sidを省略した場合，fromLayerCountパラメーターの指定は無視されます。

リンク情報の中に同一ノードが複数階層に存在すると，階層の捉え方によっては指定値を超える場合があります。

このような現象が問題となる場合は，この現象が発生するリンク情報かどうかを確認してから使用してください。

toLayerCount

取得する後続ノード階層数の上限値を，0〜2147483647の範囲で指定します。

sidを指定した場合，toLayerCountパラメーターは省略できません。

sidを省略した場合，toLayerCountパラメーターの指定は無視されます。

リンク情報の中に同一ノードが複数階層に存在すると，階層の捉え方によっては指定値を超える場合があります。

このような現象が問題となる場合は，この現象が発生するリンク情報かどうかを確認してから使用してください。

countPerLayer

取得するノード数のノード階層当たりの上限値を，1〜2147483647の範囲で指定します。

sidを指定した場合，countPerLayerパラメーターは省略できません。

sidを省略した場合，countPerLayerパラメーターの指定は無視されます。

リンク情報の中に同一ノードが複数階層に存在すると，階層の捉え方によっては指定値を超える場合があります。

このような現象が問題となる場合は，この現象が発生するリンク情報かどうかを確認してから使用してください。

linkCount

取得するノードノード関係数（先行ノードと後続ノードのペアの数）の上限値を，1〜2147483647の範囲で指定します。

sidを指定した場合，linkCountパラメーターは省略できません。

sidを省略した場合，linkCountパラメーターの指定は無視されます。

リンク情報の中に同一ノードが複数階層に存在すると，階層の捉え方によっては指定値を超える場合があります。

このような現象が問題となる場合は，この現象が発生するリンク情報かどうかを確認してから使用してください。

ステータスコード

リクエストに対するレスポンスとして返却されるステータスコードを，次の表に示します。

ステータスコード

メッセージ

説明

200

なし

上限の制約のため，返却されないデータは存在しない。

KAJY22000-W

上限の制約のため，返却されないデータが存在する。

400

KAJY22002-E

リクエストのパラメーター指定形式が不正です。（キーが無い，仕様とデータ型が異なる）

500

KAJY22002-E

リクエストのパラメーター指定形式が不正です。（値が不正）

メッセージの詳細については，マニュアル「JP1/Integrated Management 3 - Manager メッセージ」を参照してください。

戻り値

ステータスコードが200の場合に，レスポンスボディーに次の情報を返却します。

項番

メンバー名

データ型

説明

1

links

配列

レスポンスオブジェクトの配列

配列順序に意味はありません。

2

from

string

先行ノード

形式はメッセージボディーのsidと同じです。

3

to

string

後続ノード

形式はメッセージボディーのsidと同じです。

4

type

string

リクエストパラメーターのtypeと同じ値

5

exceedCountDetected

オブジェクト

パラメーター指定値が上限を超えたことの検知有無

パラメーターごとにメンバーを持ちます。sidを省略した場合は省略されます。

6

countPerLayer

boolean

階層当たりのノード数が上限を超えたことの検知有無

階層ごとにメンバーを持ちます。

7

layer整数

string

返却対象となる全階層に対し，階層あたりのノード数が上限を超えたことの検知有無

sidに指定された階層を階層0として，後続の階層は順に+1，先行の階層は順に-1の規則で階層に番号を付けて，整数の部分に埋め込みます。

8

linkCount

boolean

リンク数が上限を超えたことの検知有無

true：検知した

false：検知していない

9

messageId

string

メッセージID

通知すべきメッセージが存在しない場合は省略されます。

10

message

string

メッセージ本文

使用される言語は，HTTPリクエストヘッダーのAccept-Languageプロパティの指定内容により決まります。

通知すべきメッセージが存在しない場合は省略されます。

使用例1

次の条件で実行した場合の使用例を説明します。

出力対象システム識別子

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

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

ジョブグループ名：jobgroup1

ノード名：rootjobnet3

取得する先行ノード階層数：100

取得する後続ノード階層数：1

ノード階層あたり取得ノード数：100

取得するノード関係数：100

ノード関連図

メッセージ言語：英語

リクエスト：

POST /im/api/v1/links 1.1
Authorization: Bearer XXXX
Accept-Language: ja
Content-Type: application/json
Accept: application/json
{
    "type": "rootJobnetExecutionOrder",
    "sid": "_JP1AJS-M_host1/_HOST_host1/_JP1SCHE_scheduler1/_JP1JOBG_jobgroup1/_JP1ROOTJOBNET_rootjobnet3",
    "fromLayerCount": 100,
    "toLayerCount": 1,
    "countPerLayer": 100,
    "linkCount": 100
}

レスポンス：

HTTP/1.1 200 OK
Content-Type: application/json
{
    "links": [
        {
        "from": "_JP1AJS-M_host1/_HOST_host1/_JP1SCHE_scheduler2/_JP1JOBG_jobgroup3._JP1ROOTJOBNET_rootjobnet1",
        "to": "_JP1AJS-M_host1/_HOST_host1/_JP1SCHE_scheduler1/_JP1JOBG_jobgroup1/_JP1ROOTJOBNET_rootjobnet3",
"type": "rootJobnetExecutionOrder"
        },
        {
        "from": "_JP1AJS-M_host1/_HOST_host1/_JP1SCHE_scheduler4/_JP1JOBG_jobgroup3/_JP1ROOTJOBNET_rootjobnet2",
        "to": "_JP1AJS-M_host1/_HOST_host1/_JP1SCHE_scheduler1/_JP1JOBG_jobgroup1/_JP1ROOTJOBNET_rootjobnet3",
        "type": "rootJobnetExecutionOrder"
        },
        {
        "from": "_JP1AJS-M_host1/_HOST_host1/_JP1SCHE_scheduler1/_JP1JOBG_jobgroup1/_JP1ROOTJOBNET_rootjobnet3",
        "to": "_JP1AJS-M_host1/_HOST_host1/_JP1SCHE_scheduler1/_JP1JOBG_jobgroup2/_JP1ROOTJOBNET_rootjobnet4",
        "type": "rootJobnetExecutionOrder"
        }
        ],
        "exceedCountDetected": {
            "countPerLayer": {
                "layer-1": false,
                "layer0": false,
                "layer1": false,
                 },
        "linkCount": false
    },
    "messageId": "KAJY22000-W",
    "message": "There is data that is not displayed because the upper limit is reached. (item = succeeding node layer count)"
}

5.5.2　リンク種別一覧取得

機能

システムに適用されているリンク情報の種別の一覧を取得します。

実行権限

JP1_Console_Admin

JP1_Console_Operator

JP1_Console_User

APIのバージョン

v1

形式

リクエスト行

GET /im/api/v1/links/types httpVersion

レスポンスのメッセージボディー

{
    "linkTypes": [
    {
        "name":"リンク情報の種別"
    }
}

パラメーター

なし

ステータスコード

リクエストに対するレスポンスとして返却されるステータスコードを，次の表に示します。

ステータスコード

メッセージ

説明

200

なし

リンク情報種別の一覧取得に成功しました。

403

KAJY01000-E

REST APIの実行権限がありません

戻り値

ステータスコードが200の場合に，レスポンスボディーに次の情報を返却します。

項番

メンバー名

データ型

説明

1

linkTypes

Object[]

リンク種別オブジェクトの配列

2

name

string

先行ノードのSID

使用例

リクエスト：

GET /im/api/v1/links/types HTTP/1.1
Authorization:Bearer xxxx

レスポンス：

HTTP/1.1 200 OK
Cache-Control: no-store, no-cache, max-age=0
Pragma: no-cache
Expires: Thu, 01 Jan 1970 00:00:00 GMT
Content-Type: application/json

{
    "linkTypes": [
        {
            "name":"rootJobnetExecutionOrder"
        },
        {
            "name":"sameNode"
        },  ・・・
    ]
}

5.6　イベント管理のAPI

イベント管理のAPIに関する操作を説明します。

5.6.1　イベント検索

機能

IM管理ノードに関連するイベントを，統合監視DBから取得します。

イベント検索条件をパラメーターとして指定した場合は，検索条件に一致したイベントの一覧を取得します。

ログインしたJP1ユーザーに参照権限が無いイベントは取得できません。また，エラーにもなりません。

取得できるイベントの範囲は，JP1資源グループの設定，およびJP1/IM - Managerのユーザーフィルターの設定に従います。

実行権限

JP1_Console_Admin

JP1_Console_Operator

JP1_Console_User

APIのバージョン

v1

形式

リクエスト行

POST /application/component/apiVersion/nodes/treeInfo/event httpVersion

リクエストのメッセージボディー

{
    "sid":"IM管理ノードのツリーのSID",
    "filter":"イベント検索条件",
    "direction":"イベント取得方向",
    "since":"イベントの取得開始位置",
    "count":"イベント取得件数",
    "attrs":"取得するイベント属性の一覧",
    "statusFilter":"ステータスフィルター",
    "consolidateEvent":"集約された繰り返しイベントを返却するかどうか",
    "searchCount":"イベントの検索回数"
}

レスポンスのメッセージボディー

{
  "eventData":[
    イベント情報オブジェクト,…
  ],
  "messageId":"メッセージID",
  "message":"メッセージ",
  "beginSid":"イベントの検索開始位置の次のJP1イベントのSID",
  "endSid":"イベントの検索終了位置のJP1イベントのSID"
}

パラメーター

sid

IM管理ノードのツリーのSIDを，string型で指定します。

指定したIM管理ノードが発生元となるイベントの一覧を取得します。省略した場合は，オールシステム（_ROOT_AllSystems）を指定したと仮定されます。IM管理ノードがセットアップされていない状態で，このパラメーターを省略した場合は，空のイベント一覧を返却します。

filter

イベント検索条件オブジェクトを指定します。

指定したイベント検索条件に従い，統合監視DBからイベントを検索します。イベント検索オブジェクトの詳細は「7.2.1(3)　イベント検索条件オブジェクト」を参照してください。

sidパラメーターの対象となるイベントを，filterパラメーターで指定したイベント検索条件で絞り込みます。

direction

イベントの検索方向を，次の値で指定します。

過去方向：past

未来方向：future

指定を省略した場合は「past」を仮定します。

since

イベントの検索開始位置をJP1イベントのSIDで指定します。指定したJP1イベントのSIDより未来または過去のイベントを検索します。ただし，指定したJP1イベントのSIDのイベントは検索対象に含みません。

指定を省略した場合は，directionパラメーターに従い，統合監視DBの先頭あるいは末尾から検索を開始します。

JP1イベントのSIDの詳細は「7.2.1(1)　イベント情報オブジェクト」を参照してください。

count

イベントの最大取得件数を1〜2,000件の範囲で指定します。指定を省略した場合は，2,000件を仮定します。

attrs

取得したいイベント属性の項目を配列で指定します。このパラメーターに指定した属性を，ユーザーが指定した並び順で取得します。

指定例

"attrs":["B.ID","B.MESSAGE",…]

指定を省略した場合は，イベントレポート出力機能で出力できるすべての属性，および「7.2.1(1)　イベント情報オブジェクト」の「集約開始イベントのイベント属性」の表に示す属性を取得します。

イベントレポート出力機能の詳細については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「4.15.2　統合監視DBのイベント情報を保管（イベントレポート出力）」を参照してください。

statusFilter

IM管理ノードのステータスを該当するイベントだけで絞り込みする場合に，intの配列でステータスの値を指定します。IM管理ノードのステータスについては「5.8.5　IM管理ノードステータス取得」を参照してください。

指定例：ステータスが「30」と「40」のイベントだけを取得する場合

"statusFilter":[30,40]

consolidateEvent

繰り返しイベントが集約されている場合に，集約された繰り返しイベントを返却するかどうかを指定します。指定を省略した場合は，「false」を仮定します。繰り返しイベントの返却を抑止する場合は，「true」を指定します。

true：インテリジェント統合管理基盤で繰り返しイベントの表示が抑止されている場合，集約開始イベントだけを返却します。集約開始イベントよりあとの繰り返しイベントは返却しません。

false：インテリジェント統合管理基盤で繰り返しイベントの表示が抑止されているかどうかに関わらず，繰り返しイベントを返却します。

searchCount

イベントの検索回数の上限を0〜120,000の範囲で指定します。

sidパラメーターで指定したIM管理ノードにマッピングされているイベントを，sinceパラメーターの検索開始位置からdirectionパラメーターの検索方向に向かって，100件分検索します。ユーザーフィルターなどによって，countパラメーターで指定した件数のイベントが取得できない場合は，次のイベント100件を対象として繰り返し検索します。この繰り返し行うイベント検索回数の上限値を指定します。

検索回数が上限値に達した場合は検索を中断し，中断までに取得できたイベントの一覧を返却します。指定を省略した場合，値に「0」を指定した場合は，検索回数は制限されません。

ステータスコード

リクエストに対するレスポンスとして返却されるステータスコードを，次の表に示します。

ステータスコード

メッセージ

説明

200

なし

イベント一覧の取得に成功しました。

KAJY32005-W

イベント検索の途中で一時的なエラーが発生しました。

KAJY32010-W

イベントの取得時のイベント検索が指定された検索回数上限に達したため，イベント取得を中断しました。

400

KAJY32200-E

リクエストのパラメーター指定形式が不正です。

KAJY32201-E

イベント検索条件（filterパラメーター）の記述が不正です。

404

KAJY32202-E

指定したノードがマネージャーに存在しません。

500

KAJY32000-E

〜

KAJY32004-E

KAJY32006-E

イベント検索処理中にエラーが発生しました。

メッセージの詳細については，マニュアル「JP1/Integrated Management 3 - Manager メッセージ」を参照してください。

戻り値

ステータスコードが200の場合に，レスポンスボディーに次の情報を返却します。

項番

メンバー名

データ型

説明

1

eventData

Object[]

取得したイベントの一覧を，イベント情報オブジェクトの配列として返却します。イベント情報オブジェクトについては「7.2.1(1)　イベント情報オブジェクト」を参照してください。

1つも存在しない場合は，要素数0の配列を返却します。

2

messageId

string

イベント検索の途中で発生した一時的なエラーメッセージのメッセージIDを返却します。通知すべきメッセージが無い場合は省略されます。

3

message

string

イベント検索の途中で発生した一時的なエラーメッセージのメッセージ本文を返却します。通知すべきメッセージが無い場合は省略されます。

4

beginSid

string

イベントの検索開始位置の次のJP1イベントのSIDを返却します。sinceからイベント取得方向に向かって1つ先のJP1イベントのSIDです。

検索対象となるイベントが1つも存在しない場合は省略されます。

5

endSid

string

イベントの検索終了位置のJP1イベントのSIDを返却します。イベント検索の中断が発生した場合は，中断位置のJP1イベントのSIDが返却されます。

検索対象となるイベントが1つも存在しない場合は省略されます。

使用例1

JP1/AJSのジョブグループに関連するイベントの一覧を取得する場合のAPIの使用例を次に示します。

POST /im/api/v1/nodes/treeInfo/event HTTP/1.1
Authorization:Bearer xxxx
Accept-Language: ja
Content-Type: application/json
Accept: application/json

{
    "sid": "_ROOT_AllSystems/_SYSTEM_System1/_SYSTEM_SubSystem1/_HOST_host1/_CATEGORY_Job/_SUBCATEGORY_JP1%2FAJS3%20-%20Manager/_OBJECT_ScheduleServ/_OBJECT_jobgroup",
"direction": "past",
"count": "200",
"attrs": [ "B.ID","E.@JP1IM_DEALT","E.SEVERITY" ]
}

使用例2

イベント検索条件を指定してイベントの一覧を取得する場合のAPIの使用例を次に示します。

リクエスト：

POST /im/api/v1/nodes/treeInfo/event HTTP/1.1
Authorization:Bearer xxxx
Accept-Language: ja
Content-Type: application/json
Accept: application/json

{
    "filter": {
        "include": [
            [
            {"key":"E.SEVERITY","ope":"IN","val": ["Error","Warning"] },
             {"key":"B.SOURCESERVER","ope":"IN","val":["host1","host2","host3"]}
            ],
            [
            {"key":"E.SEVERITY","ope":"IN","val": ["Error","Warning","Notice"] },
            {"key":"B.SOURCESERVER","ope":"IN","val":["host4","host5"]}
            ]
        ],
        "exclude": [
            [
                {"key":"E.@JP1IM_DEALT","ope":"IN","val":"1"}
            ]
        ]
    }
}

レスポンス：

HTTP/1.1 200 OK
Cache-Control: no-store, no-cache, max-age=0
Pragma: no-cache
Expires: Thu, 01 Jan 1970 00:00:00 GMT
Content-Type: application/json

{
    "eventData": [
    {
        "sid": "_JP1IM_imhost1/_JP1IMSEQNO_698/_JP1IMEVBSEQNO_747",
        "value": [
            "B.ID": "00004104",
            "E.@JP1IM_DEALT": "0",
            "E.SEVERITY": "Error"
    },
    {
        "sid": "_JP1IM_imhost1/_JP1IMSEQNO_697/_JP1IMEVBSEQNO_746",
        "value": [
            "B.ID": "00004107",
            "E.@JP1IM_DEALT": "0",
            "E.SEVERITY": "Error"
    }
    ]
}

5.6.2　イベント詳細情報取得

機能

指定したイベントの詳細情報を取得します。

ログインしたJP1ユーザーに指定したイベントの参照権限が無い場合は，イベント詳細情報は取得できません。

イベントの属性情報，イベントガイド情報，イベント属性名の表示項目名の情報が，イベント詳細情報として取得できます。

イベント詳細情報として取得できるイベント属性と表示項目名の情報は，JP1/IM - Managerのイベント拡張属性定義ファイルの設定に従います。

また，JP1/IM - Managerにイベントガイド情報の設定がされている場合，取得したイベントに対応したイベントガイドメッセージが取得されます。

実行権限

JP1_Console_Admin

JP1_Console_Operator

JP1_Console_User

APIのバージョン

v1

形式

リクエスト行

GET /application/component/apiVersion/events/detail?query httpVersion

レスポンスのメッセージボディー

{
    "eventData":イベント情報オブジェクト
}

パラメーター

sid

詳細情報を取得したいJP1イベントのSIDを指定します。JP1イベントのSIDについては「7.2.1(1)　イベント情報オブジェクト」を参照してください。

ステータスコード

リクエストに対するレスポンスとして返却されるステータスコードを，次の表に示します。

ステータスコード

メッセージ

説明

200

なし

詳細情報の取得に成功しました。

400

KAJY32210-E

リクエストのパラメーター指定形式が不正です。

404

KAJY32211-E

指定したイベントが見つかりません。

500

KAJY32000-E

〜

KAJY32003-E

KAJY32005-E

〜

KAJY32008-E

詳細情報の取得中にエラーが発生しました。

メッセージの詳細については，マニュアル「JP1/Integrated Management 3 - Manager メッセージ」を参照してください。

戻り値

ステータスコードが200の場合に，レスポンスボディーに次の情報を返却します。

項番

メンバー名

データ型

説明

1

eventData

Object

イベント情報オブジェクトを返却します。詳細については「7.2.1(1)　イベント情報オブジェクト」を参照してください。

使用例1

指定したイベントの詳細情報を取得する場合のAPIの使用例を次に示します。

リクエスト：

GET /im/api/v1/events/detail?sid=_JP1IM_imhost1/_JP1IMSEQNO_697/_JP1IMEVBSEQNO_746 HTTP/1.1
Authorization:Bearer xxxx
Accept-Language: ja
Content-Type: application/json
Accept: application/json

レスポンス：

HTTP/1.1 200 OK
Cache-Control: no-store, no-cache, max-age=0
Pragma: no-cache
Expires: Thu, 01 Jan 1970 00:00:00 GMT
Content-Type: application/json
{
  "eventData": {
    "sid": "_JP1IM_imhost1/_JP1IMSEQNO_697/_JP1IMEVBSEQNO_746",
    "value": [
      "B.ID":"00001F20",
      "B.MESSAGE":"エラーが発生しました",
      "E.STARTTIME":"2018-11-14T17:00:00Z",
      "E.@JP1IM_GUIDE":"host1のホストで異常が発生していないか確認してください",
         ・・・
    ],
    "title": [
      "B.ID":"イベントID",
      "B.MESSAGE":"メッセージ",
      "E.STARTTIME":"開始時刻",
      "E.@JP1IM_GUIDE":"ガイド",
          ・・・
    ],
    "type": [
      "B.MESSAGE":"text",
      "E.STARTTIME":"date",
      "E.@JP1IM_GUIDE":"html",
          ・・・
    ]
}

5.6.3　イベント対処状況変更

機能

指定したイベントの対処状況を変更します。

ログインしたJP1ユーザーに参照権限が無いイベントを指定した場合は，エラーになります。

実行権限

JP1_Console_Admin

JP1_Console_Operator

APIのバージョン

v1

形式

リクエスト行

POST /application/component/apiVersion/events/status httpVersion

リクエストのメッセージボディー

{
    "dealt":"対処状況",
    "sid":[
        "JP1イベントのSID ",…
}

レスポンスのメッセージボディー

{
  "eventData":[
    イベント情報オブジェクト,…
  ],
  "messageId":メッセージID,
  "message":メッセージ
}

パラメーター

dealt

変更後の対処状況を，次の値で指定します。

0：未対処

1：対処済

2：処理中

3：保留

sid

対処状況を取得したいイベントのSIDを配列で指定します。イベントのSIDについては「7.2.1(1)　イベント情報オブジェクト」を参照してください。イベントのSIDは2,000個まで指定できます。

ステータスコード

リクエストに対するレスポンスとして返却されるステータスコードを，次の表に示します。

ステータスコード

メッセージ

説明

200

なし

対処状況の変更に成功しました。

KAJY32110-W

権限が不足しているため，操作できなかったイベントがあります。

400

KAJY32220-E

リクエストのパラメーター指定形式が不正です。

500

KAJY32100-E

〜

KAJY32109-E

対処状況の変更処理中にエラーが発生しました。

KAJY32221-E

イベント対処状況変更中のため実行できません。

メッセージの詳細については，マニュアル「JP1/Integrated Management 3 - Manager メッセージ」を参照してください。

戻り値

ステータスコードが200の場合に，レスポンスボディーに次の情報を返却します。

項番

メンバー名

データ型

説明

1

eventData

Object[]

対処状況を変更したイベントの一覧をイベント情報オブジェクトの配列として返却します。詳細については「7.2.1(1)　イベント情報オブジェクト」を参照してください。

権限不足で一部のイベントを操作できなかった場合，操作に成功したイベントだけを返却します。

2

messageId

string

対処状況の変更処理の途中で発生した一時的なエラーメッセージのメッセージIDを返却します。

通知するメッセージが存在しない場合は省略されます。

3

message

string

対処状況の変更処理の途中で発生した一時的なエラーメッセージのメッセージ本文を返却します。

通知するメッセージが存在しない場合は省略されます。

注意事項

イベント対処状況変更APIを大量に同時実行すると，マネージャーの性能が低下したり，タイムアウトが発生したりすることがあります。

イベント対処状況変更APIの実行を運用に組み込む場合は，このAPIの実行性能とマネージャーの性能への影響が，運用要件上問題ないかを十分に検証した上で使用してください。

使用例

指定したイベントの対処状況を「対処済」に変更する場合のAPIの使用例を次に示します。

リクエスト：

POST /im/api/v1/events/status HTTP/1.1
Authorization:Bearer xxxx
Accept-Language: ja
Content-Type: application/json
Accept: application/json
{
    "dealt": "1",
    "sid":[
    "_JP1IM_imhost1/_JP1IMSEQNO_697/_JP1IMEVBSEQNO_746",
    "_JP1IM_imhost1/_JP1IMSEQNO_698/_JP1IMEVBSEQNO_747"
    ]
}

レスポンス：

HTTP/1.1 200 OK
Cache-Control: no-store, no-cache, max-age=0
Pragma: no-cache
Expires: Thu, 01 Jan 1970 00:00:00 GMT
Content-Type: application/json

{
  "eventData": [
    {
      "sid": "_JP1IM_imhost1/_JP1IMSEQNO_697/_JP1IMEVBSEQNO_746",
      "value": [
        "E.@JP1IM_DEALT": "1"
      ]
    },
    {
      "sid": "_JP1IM_imhost1/_JP1IMSEQNO_698/_JP1IMEVBSEQNO_747",
      "value": [
        "E.@JP1IM_DEALT": "1"
      ]
    }
  ]
}

5.6.4　イベント発行

機能

指定したJP1イベントを発行し，イベントをマネージャーホストに登録します。登録したあと，発行したイベントのDB内通し番号を返却します。

実行権限

JP1_Console_Admin

JP1_Console_Operator

JP1_Console_User

APIのバージョン

v1

形式

リクエスト行

POST /application/component/apiVersion/events/send httpVersion

リクエストのメッセージボディー

{
    "eventId":イベントID,
    "message":メッセージ,
    "attrs":{拡張属性名:拡張属性値[, ...]}
}

レスポンスのメッセージボディー

発行したイベントのDB内通し番号

パラメーター

eventId

発行する基本部イベントIDです。

次に示す範囲で指定します。

0〜1FFF

7FFF8000〜7FFFFFFF

指定できる範囲以外の値を指定した場合，KAJY02047-Eを出力します。

このパラメーターの指定を省略した場合は，0が仮定されます。

message

JP1イベントの内容を表すメッセージテキストを，1,023バイト以下の文字列で指定します。1,024バイト以上の文字列を指定した場合，例外が発生し処理を終了します。

なお，登録されるメッセージの文字コードは，マネージャーが配置されているOS環境の文字コードに依存します。

attrs

拡張属性です。

同じ拡張属性名を複数指定した場合，最後に指定された拡張属性の値で上書きされます。

拡張属性名は，英数字またはアンダーライン（英字は大文字，先頭は英字）から成る32バイトまでの文字列で指定します。指定できる文字列以外の拡張属性名を指定した場合，KAJY02047-Eを出力します。また，拡張属性名には接頭辞「E.」を指定しないでください。「E.」を指定した場合，KAJY02047-Eを出力します。

すべての拡張属性値の合計の長さは，10,000バイトまで指定できます。

イベント登録機能で登録されるイベント属性一覧を次に示します。

表5‒13　イベント登録機能で登録されるイベント属性一覧

項番

分類

項目名

属性名

イベント属性値の説明

1

基本属性

イベントDB内通し番号

SEQNO

発行されるJP1イベントのイベントDB内通し番号

2

基本イベントID※1

ID

パラメーターで渡されるイベントID

3

登録要因

REASON

現サーバにイベントが登録された要因

1：現イベントサーバで，自イベントサーバ宛の発行

2：現サーバから他サーバ宛の発行（値取得不可）

3：他サーバから現サーバ宛の発行

4：他サーバから環境設定の指定により転送

4

発行元プロセスID

PROCESSID

発行元APIのプロセスID

5

登録時刻

TIME

発行元イベントサーバでの登録時刻

6

到着時刻

ARRIVEDTIME

自イベントサーバでの登録時刻

7

発行元ユーザーID

USERID

発行元プロセスのユーザーID（固定値：-1）

8

発行元グループID

GROUPID

発行元プロセスのグループID（固定値：-1）

9

発行元ユーザー名

USERNAME

発行元プロセスのユーザー名

Windowsの場合：SYSTEM，Linuxの場合：root

10

発行元グループ名

GROUPNAME

発行元プロセスのグループ名（固定値：空文字）

11

発行元イベントサーバ名

SOURCESERVER

発行元のイベントサーバ名

発行元サーバ名が設定されていない場合，自ホストを設定する。

12

発行元IPアドレス

SOURCEIPADDR

発行元イベントサーバに対応するIPアドレス

13

送信先IPアドレス

DESTIPADDR

発行元APIが他イベントサーバへの転送を明示して指定した場合に，他イベントサーバの名称が入る。

14

発行元イベントDB内通し番号

SOURCESEQNO

発行元ホストでのイベントDB内通し番号

15

コードセット

CODESET

OSに設定されている文字コードが格納されます。

16

メッセージ

MESSAGE

JP1 イベントの内容を表した文字列

17

イベント詳細情報

BASIC

イベント基本属性の詳細情報

18

AOM情報

AOM

イベントのAOM情報

19

拡張属性（共通情報）※2

重大度

SEVERITY

「重大度」を表す以下の文字列など

"Emergency"：緊急

"Alert"：警戒

"Critical"：致命的

"Error"：エラー

"Warning"：警告

"Notice"：通知

"Information"：情報

"Debug"：デバッグ

20

ユーザー名

USER_NAME

実行しているユーザー名

21

プロダクト名

PRODUCT_NAME

JP1 イベントを発行したプログラム名

次に示すプログラム名などがある。

"/HITACHI/JP1/AJS"

"/HITACHI/JP1/AOM"

"/HITACHI/JP1/IM"

"/HITACHI/JP1/NBQ"

"/HITACHI/JP1/NETMDM"

"/HITACHI/JP1/NPS"

"/HITACHI/JP1/NQSEXEC"

22

オブジェクトタイプ

OBJECT_TYPE

「オブジェクトタイプ」を表す以下の文字列など

"JOB"

"JOBNET"

"ACTION"

"ACTIONFLOW"

"PRINTJOB"

"PRINTQUEUE"

"PRINTER"

"BATCHQUEUE"

"PIPEQUEUE"

"JOBBOX"

"LOGFILE"

"LINK"

"SERVICE"

"PRODUCT"

"CONFIGRATION"

"SERVER"

23

オブジェクト名

OBJECT_NAME

ジョブ，ジョブネットなどのオブジェクトの名称。ジョブネットなど階層のあるオブジェクトの場合，最下層の要素。

24

登録名タイプ

ROOT_OBJECT_TYPE

オブジェクトの種別

25

登録名

ROOT_OBJECT_NAME

ユーザーの操作時に実行を指示する単位になる名称

26

オブジェクトID

OBJECT_ID

オブジェクトID

PRODUCT_NAMEとの組み合わせによりオブジェクトのインスタンスを統合システム内で一意に意識できる文字列

27

事象種別

OCCURRENCE

OBJECT_NAMEに対して発生した事象を表す以下の文字列など

"ACTIVE"アクティブ

"INACTIVE"非アクティブ

"START"開始

"END"終了

"NOTSTART"開始できなかった

"CANCEL"キャンセル

"LATESTART"開始予定時刻を過ぎた

"LATEEND"終了予定時刻を過ぎた

"SUBMIT"サブミットされた

"ENQUEU"キューに登録された

"DEQUEU"キューから取り除かれた

"PAUSE"一時停止(保留）

"RELEASE"一時停止（保留解除）

"RESTART"再実行の開始

"CREATE"作成された

"DELETE"削除された

"MODIFY"更新された

"RETRY"リトライ開始した

"STOP"停止中

"MOVE"移動した

"COPY"コピーした

"NOTICE"通知した

"REPLY"応答された

"CONNECT"接続した

"DISCONNECT"切り離した

"EXCEPTION"その他のエラー

28

開始時刻

START_TIME

実行開始または再実行開始の時刻

29

終了時刻

END_TIME

実行終了または再実行終了の時刻

30

終了コード

RESULT_CODE

終了コード

31

発生元ホスト名

JP1_SOURCEHOST

発生元ホスト名を指定しない場合SOURCESERVERが設定される

32

個別拡張属性数

個別拡張属性の数

拡張属性の数

注※1

データベースに出力される形式を次に示します。

（指定例）ID:IDEXT 0000000A:00000000

注※2

共通属性は配列に格納されています。指定しない場合は登録されません。

このREST APIで登録されるイベントの属性の値を，次に示します。

--このパラメーターで実行した場合

{
   "eventId":"10000",
   "message":"クラウドサービスで障害が発生しました",
   "attrs":{"SEVERITY":"Error"}
}
SQ 18840099
ID 00010000:00000000
KN 0
HD 0
PI 0
RT 1559790829
AT 1559790829
RR 1
UI -1
GI -1
HQ 18840099
UN jp1admin
GN
SN HOSTA
SI %0Aﾜﾄ(
CS MS932
MS クラウドサービスで障害が発生しました
UP %00%00%00%00%00%00%00%00
XN 1
XV SEVERITY= Error

ステータスコード

リクエストに対するレスポンスとして返却されるステータスコードを，次の表に示します。

ステータスコード

メッセージ

説明

200

なし

JP1イベントを発行しました。

400

KAJY02047-E

リクエストのパラメーター指定形式が不正です。

403

KAJY01000-E

REST APIの実行権限がありません。

500

KAJY02048-E

JP1イベントが発行できませんでした

メッセージの詳細については，マニュアル「JP1/Integrated Management 3 - Manager メッセージ」を参照してください。

戻り値

ステータスコードが200の場合に，レスポンスボディーに次の情報を返却します。

データ型

説明

数値

発行したイベントのDB内通し番号

使用例

イベントAPIの使用例を次に示します。

リクエスト：

POST http://hostname:20703/im/api/v1/events/send
{
  "eventId":"1FFF",
  "message":"サービスAで障害が発生しました",
  "attrs":{"SEVERITY":"Error","JP1_SOURCEHOST":"HOSTA"}
}

レスポンス：

18839936

5.6.5　JP1イベント変換

機能

外部システムから通知されたイベント情報をJP1イベントに変換し，発行します。

製品プラグインに外部システムから通知されたイベント情報を渡し，返却されたJP1イベントの情報に従ってJP1イベントを発行します。

実行権限

なし

APIのバージョン

v1

形式

リクエスト行

POST /im/api/v1/events/transform HTTP/1.1

リクエストヘッダー

ヘッダー名

設定値

Authorization

設定しないでください。

リクエストのメッセージボディーがJSON形式の場合，ほかのリクエストヘッダーは，APIの共通仕様と同じです。APIの共通仕様のリクエストヘッダーについては，「5.2.3　リクエスト形式」の，リクエストヘッダーの説明を参照してください。

リクエストのメッセージボディー

JSON形式で送信できます。オブジェクトのデータ構造は，任意です（各製品プラグインの独自の形式を使用）。

JP1/IM - Managerに設定されているすべての製品プラグインで，JP1イベントに変換できないデータの場合は，次の形式でJP1イベントへの変換を試みます。

[
    {
        "eventId":イベントID,
        "message":メッセージ,
        "attrs":{拡張属性名:拡張属性値, ...}
    },
    ...
]

レスポンスのメッセージボディー

{
    "eventSeqNo":[発行したイベントのDB内通し番号, …]
    "exceeddJp1eventMaxDetected":変換されたJP1イベント数の上限超過検知有無,
    "messages":[
        {
            "messageId":"メッセージID",
            "message":"メッセージ本文"
        },
        ･･･
    ]
}

パラメーター

リクエストのメッセージボディーに指定するパラメーターを次に示します。

項番

パラメーター

データ型

説明

1

eventId※

string

発行するイベントIDを指定します。

2

message※

string

イベントの内容を表すメッセージテキストを指定します。

3

attrs※

配列

拡張属性を指定します。

注※

各項目に指定する内容については，「5.6.4　イベント発行」のパラメーターを参照してください。

ステータスコード

リクエストに対するレスポンスとして返却されるステータスコードを，次の表に示します。

ステータスコード

メッセージ

説明

200

なし

APIの処理が成功しました。

KAJY67002-W

JP1/Baseのイベントサービスとの通信に失敗しました。

KAJY67003-W

変換されたJP1イベントが100件を超えました。

KAJY67000-W

取得したデータにイベントIDが含まれていませんでした。

取得したデータにメッセージが含まれていませんでした。

拡張属性の指定が不正です。

拡張属性名が32バイトを超えています。

拡張属性値の合計が10000バイトを超えています。

406

KAJY67001-E

各連携製品プラグインからJP1イベントのデータが返却されませんでした，かつ，データフォーマットがデフォルト形式ではありませんでした。

ステータスコードが200の場合に，レスポンスボディーにJSON形式で次の情報を返却します。

項番

メンバー名

データ型

説明

1

eventSeqNo

Object[]

発行したイベントのDB内通し番号をstring型の配列として返却します。

2

exceedJp1eventMaxDetected

boolean

変換されたJP1イベント数が上限を超えたことの検知有無です。

true：検知した

false：検知しない

3

messages

object[]

通知すべきメッセージの配列です。

通知すべきメッセージが存在しない場合は省略されます。

4

messageId

string

メッセージIDです。通知すべきメッセージが存在しない場合は省略されます。

5

message

string

メッセージ本文です。使用される言語は，HTTPリクエストヘッダーのAccept-Languageプロパティの指定内容により決まります。通知すべきメッセージが存在しない場合は省略されます。

使用例

OSSのcurlコマンドを利用して，このAPIを実行した場合の使用例を，次に示します。

>curl -i --header "Accept-Language: ja" --header "Content-Type: application/json" --request POST --data @c:¥¥work¥¥request.json "http://localhost:20703/im/api/v1/events/transform"

request.json

{
  "receiver":"JP1IMDD",
  "status":"firing",
  "alerts":
  [
    {
      "status":"firing",
      "labels":
      {
        "alertname":"jp1_pc_exporter_healthcheck",
        "instance":"win2016:20717",
        "job":"jpc_windows",
        "jp1_pc_eventid":"0002",
        "jp1_pc_exporter":"JPC Windows exporter",
        "jp1_pc_metricname":"up",
        "jp1_pc_nodelabel":"Windows exporter",
        "jp1_pc_product_name":"/HITACHI/JP1/JPCCS",
        "jp1_pc_prome_hostname":"win2016",
        "jp1_pc_severity":"Error"
      },
      "annotations":
      {
        "jp1_pc_description":"Exporter is down."
      },
      "startsAt":"2021-12-17T07:46:20.027Z",
      "endsAt":"0001-01-01T00:00:00Z",
      "generatorURL":"http://win2016:20713/graph?g0.expr=up%7Bjp1_pc_remote_monitor_instance%3D%22%22%7D+%3D%3D+0+or+label_replace%28sum+by%28jp1_pc_remote_monitor_instance%2C+jp1_pc_exporter%29+%28up%7Bjp1_pc_remote_monitor_instance%21%3D%22%22%7D%29%2C+%22jp1_pc_nodelabel%22%2C+%22%24%7B1%7D%22%2C+%22jp1_pc_remote_monitor_instance%22%2C+%22%5E%5B%5E%3A%5D%2A%3A%28%5B%5E%3A%5D%2A%29%24%22%29+%3D%3D+0¥u0026g0.tab=1",
      "fingerprint":"430af6034503a24d"
    }
  ],
  "groupLabels":
  {
    "alertname":"jp1_pc_exporter_healthcheck",
    "instance":"win2016:20717",
    "job":"jpc_windows",
    "jp1_pc_eventid":"0002",
    "jp1_pc_exporter":"JPC Windows exporter",
    "jp1_pc_metricname":"up",
    "jp1_pc_nodelabel":"Windows exporter",
    "jp1_pc_product_name":"/HITACHI/JP1/JPCCS",
    "jp1_pc_prome_hostname":"win2016",
    "jp1_pc_severity":"Error"
  },
  "commonLabels":
  {
    "alertname":"jp1_pc_exporter_healthcheck",
    "instance":"win2016:20717",
    "job":"jpc_windows",
    "jp1_pc_eventid":"0002",
    "jp1_pc_exporter":"JPC Windows exporter",
    "jp1_pc_metricname":"up",
    "jp1_pc_nodelabel":"Windows exporter",
    "jp1_pc_product_name":"/HITACHI/JP1/JPCCS",
    "jp1_pc_prome_hostname":"win2016",
    "jp1_pc_severity":"Error"
  },
  "commonAnnotations":
  {
    "jp1_pc_description":"Exporter is down."
  },
  "externalURL":"http://win2016:20714",
  "version":"4",
  "groupKey":"{}:{alertname=¥"jp1_pc_exporter_healthcheck¥", instance=¥"win2016:20717¥", job=¥"jpc_windows¥", jp1_pc_eventid=¥"0002¥", jp1_pc_exporter=¥"JPC Windows exporter¥", jp1_pc_metricname=¥"up¥", jp1_pc_nodelabel=¥"Windows exporter¥", jp1_pc_product_name=¥"/HITACHI/JP1/JPCCS¥", jp1_pc_prome_hostname=¥"win2016¥", jp1_pc_severity=¥"Error¥"}",
  "truncatedAlerts":0
}

レスポンス例

{"eventSeqNo":["19"],"exceedJp1eventMaxDetected":false}

5.7　プラグイン用のAPI

プラグイン用のAPIに関する操作について説明します。

5.7.1　プラグイン処理実行

機能

プラグインの任意の関数処理を実行します。

実行権限

マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「付録E.1 インテリジェント統合管理基盤によるシステムの運用監視で必要な操作権限」を参照してください。

JP1/PFMと連携する際に，パラメーターmethodに「_performanceDataGet」を指定した場合，JP1/PFMのエージェントの資源グループに対して，実行ユーザーにAdminまたはOperator権限が与えられている必要があります。

APIのバージョン

v1

形式

リクエスト行

POST /application/component/apiVersion/actions httpVersions

リクエストのメッセージボディー

{
    "method": 関数名称,
    "sid": 処理対象IM管理ノードのSID,
    "args": 処理内容指定
}

レスポンスのメッセージボディー

処理結果

パラメーター

method

実行するプラグインの関数の名称を指定します。「__」（アンダースコア二つ）から始まる関数名は指定しないでください。

標準で提供される関数を次に示します。

関数名

プラグイン

処理内容

_performanceDataGet

JP1/PFMプラグイン

性能情報取得

sid

プラグイン処理の対象のIM管理ノードを，構成情報のSIDの形式で指定します。指定できるのはシステム構成ツリーで末端のIM管理ノードだけです。

SIDについては「7.1　SID」を参照してください。

args

実行するプラグイン関数の引数args.methodArgsに渡す値を指定します。渡す情報が存在しない場合は，空オブジェクト（{}）を指定します。

指定する値のサイズは，他のパラメーターも含めて10MB未満となるようにしてください。

methodパラメーターに「_performanceDataGet」を指定した場合にargs.methodArgsに渡す値を次に示します。

項番

メンバー名

データ型

省略可否

説明

1

recordId

string

不可

取得するレコードIDを指定します。指定できる文字は大文字だけです。

レコードIDの接頭辞「PI_」，「PD_」，「PL_」は省略可能です。

接頭辞「PI_」の場合の指定例

PI_LOGD → LOGD

なお，接頭辞違いにより一致するレコードが存在する場合は，そちらを指定したものとみなされます。

2

fieldIds

string[]

可

取得するフィールドを配列で指定します。指定できる文字は大文字だけです。

特定のフィールドのパフォーマンスデータを取得したい場合に，フィールドID※を指定します。配列の形式で指定します。

注※

レコードID_PFM - Manager名の形式です。PD_PDIレコードのCPU%の場合は，「PD_PDI_PCT_PROCESSOR_TIME」となります。指定の無い場合は指定したレコードに属するすべてのフィールドを出力します。値が空の場合（fieldIds:[ ]を指定）は指定なしとみなされます。

なお，次のデータ（レコードの特定に必要なキーフィールド）は，フィールドIDを指定しなくても出力されます。キーフィールドについては，各エージェントのマニュアルを参照してください。

■履歴レポート（単一エージェント）

- "Date and Time"フィールド

- ODBC キーフィールド

3

startTime

string

不可

レポート開始日時を指定します。ISO8601拡張形式表現（YYYY-MM-DDThh:mm:ssZ）で指定してください。末尾「Z」はタイムゾーンUTCの場合です。UTC以外の場合は「+hh:mm」または「-hh:mm」の形式で指定します。

4

endTime

string

不可

レポート終了日時を指定します。

タイムゾーン：UTCの日時をISO 8601拡張形式表現（YYYY-MM-DDThh:mm:ssZ）で指定してください。末尾「Z」はタイムゾーンUTCの場合です。UTC以外の場合は「+hh:mm」または「-hh:mm」の形式で指定します。

5

interval

string

不可

レポート間隔を指定します。次の形式で指定します。大文字小文字は区別しません。

MIN：分単位

HOUR：時単位

WEEK：週単位

DAY：日単位

MONTH：月単位

YEAR：年単位

PDレコードに対して指定した場合は無視されます。

6

filter

object[]

可

取得するパフォーマンスデータをフィールドの値でフィルターしたい場合に指定します。複数のフィールドに対して指定が可能です。

複数指定した場合はすべての条件に合致（AND条件）するパフォーマンスデータを取得します。

値が空の場合（fieldIds:[ ]を指定）の場合は指定なしとみなされます。

7

limit

number

可

取得レコード最大数を指定します。指定できる値は，1〜4320です。

省略した場合は，4320が指定されたものと仮定されます。指定できる値以外を指定した場合はエラーとし，処理を中断します。

filterに指定するオブジェクトの形式を次の表に示します。

項番

メンバー名

データ型

省略可否

説明

1

fieldId

string

不可

フィルター対象とするフィールドのフィルターIDを指定します。大文字のみ指定可能です。

2

operator

string

可

取得するパフォーマンスデータのフィルター条件を指定します。次のいずれかの値(半角)を指定します。

=：フィールドの値とvalueが等しい

<>：フィールドの値とvalueが異なる

<：フィールドの値がvalueより小さい

<=：フィールドの値がvalueより小さいか等しい

>：フィールドの値がvalueより大きい

>=：フィールドの値がvalueより大きいか等しい

省略した場合は，"="が指定されたものとみなされます。

3

value

string

不可

指定可能な値は，各JP1/PFM - AgentまたはJP1/PFM - RMのマニュアルに記述されているフィールドの形式に合わせて指定します。次に示す設定範囲で指定します。

■文字

指定値をそのまま設定します。ただし，"*"はワイルドカードとして扱います。

■整数

フィールドのデータ型の指定可能範囲の値「-2,147,483,648〜2,147,483,647」の範囲を超えての指定はできません。

ただし，データ型ulong(unsigned long)については，JP1/PFM - Web Consoleのconfig.xmlの

condExpValueUlongExtensionパラメーター

の設定により，チェック範囲の拡張が可能です。config.xmlパラメーターについては，マニュアル「JP1/Performance Managementリファレンス」を参照してください。

■小数

フィールドのデータ型の指定可能範囲の値を指定します。

対象のフィールドの形式が「float, double」かつ，小数点以下が4桁以上の場合，4桁目を四捨五入し，3桁に丸めます。

対象のフィールドの形式が「utime」かつ，小数点以下が7桁以上の場合，7桁目を四捨五入し，6桁に丸めます。

フィールドの形式については，JP1/PFM - AgentまたはJP1/PFM - RMのマニュアルの各フィールドの説明個所を参照してください。

■日付

日時をISO 8601 拡張形式表現（ "YYYY-MM-DDThh:mm:ssZ"）で指定します。末尾「Z」はタイムゾーンUTCの場合です。UTC 以外の場合は「+hh:mm」または「-hh:mm」の形式で指定します。（時刻はHH:mm:ss固定）

なお，値に制御文字および「( ) [ ] < > = ''」の文字を指定した場合はエラーとなります。指定できるバイト数は，最大2,048バイトです。

ステータスコード

リクエストに対するレスポンスとして返却されるステータスコードを，次の表に示します。

ステータスコード

メッセージ

説明

200

なし

プラグイン処理実行に成功しました。

400

KAJY22003-E

リクエストのパラメーター指定形式が不正です。

403

KAJY22004-E

指定されたIM管理ノードに対するアクセス権限がありません。

500

KAJY22005-E

プラグイン処理中にエラーが発生しました。

メッセージの詳細については，マニュアル「JP1/Integrated Management 3 - Manager メッセージ」を参照してください。

戻り値

項番

メンバー名

データ型

説明

1

−

Object

プラグイン処理の実行結果を格納するオブジェクトです。プラグイン関数の戻り値を設定します。

パラメーターmethodに「_performanceDataGet」を指定した場合の戻り値を次の表に示します。

項番

メンバー名

データ型

説明

1

component

string

コンポーネント名

「HITACHI/JP1/PFM/CONFINFO」固定です。

2

productId

string

パフォーマンスデータ取得対象エージェントのプロダクトID

3

dataModelVersion

string

パフォーマンスデータ取得対象エージェントのデータモデルバージョン

4

rc

number

リターンコード

0：データ取得に成功した

1：データ取得に成功したが，limitによって取得できなかったレコードが存在する

2：指定期間のデータが存在しない

5

fields

object[]

フィールド情報オブジェクトの配列

6

data

string[][]

パフォーマンスデータの[行データ][列データ]となる2次元配列。

列データの出力順は，フィールド情報の出力順を保証します。

なお，日時データは，タイムゾーン:UTCの日時を，ISO 8601拡張形式表現（"YYYY-MM-DDThh:mm:ssZ"）で返却します。UTC以外のタイムゾーンはサポート対象外です。また，出力データのdataTypeがFOLAT，DOUBLE，SECTIMEDOUBLEのどれかで，値が10の-3乗未満，10の7乗以上の場合，浮動小数表示形式（1.01E10など）で出力します。

フィールド情報オブジェクトの形式を次の表に示します。

項番

メンバー名

データ型

説明

1

id

string

フィールドID

2

displayName

string

フィールド表示名

3

dataType

string

フィールドのデータ種別

STR：文字列

SHORT：16ビット整数値

INT：32ビット整数値

LONG：64ビット整数値

FLOAT：32ビット単精度浮動小数点数

DOUBLE：64ビット倍精度浮動小数点数

SECTIMELONG：ある一時点※1からの時間(秒)を表すlong値

SECTIMEDOUBLE：ある一時点※1からの時間(秒)を表すdouble値

MILLTIME：ある一時点※1からの時間(ミリ秒)を表すlong値

DATE：年月日のみを表現するデータ(yyyy-MM-DDThh:mm:ssZ)

DATETIME：年月日，時刻(時分秒)のみを表現するデータ(yyyy-MM-DDThh:mm:ssZ)

TIME：時刻のみを表現するデータ(yyyy-MM-DDThh:mm:ssZ（出力情報として時刻のみ）

4

keyType

string

データ（レコード）の特定に必要なフィールドのキーの属性※2

DATE

全フィールド中必ず1つのフィールドで指定され，時間を特定するためのキーとなるフィールドであることを示す。

INST

全フィールド中，0または1つ以上のフィールドで指定され，データ（レコード）固有のキーとなるフィールドであることを示す。

NONE

キーとなるフィールドではないことを示す。

注※1

基準とする時点は，フィールドによって異なります。JP1/PFM - AgentまたはJP1/PFM - RMの各フィールド（utimeを形式とするフィールド）を参照してください。

注※2

データ（レコード）の特定に必要なキー属性の組み合わせを次の表に示します。

レポート種別

レコード種別

データ特定に必要な属性の組み合わせ

履歴レポート

（単一エージェント）

単一行レコード

DATE

複数行レコード

DATE

INST

使用例

次の条件で実行した場合の使用例を説明します。

使用機能：JP1/PFMプラグイン性能情報取得

JP1/PFMマネージャーホスト名：mgrhost1

JP1/PFMエージェントホスト名：agenthost1

処理対象IM管理ノード：JP1/Performance Management - Agent Option for Platform（Windows用）

取得監視項目：CPU使用率

出力期間始点：日本時間 2017年4月1日0時0分0秒

出力期間終点：日本時間 2017年4月1日1時0分0秒

リクエスト：

POST /im/api/v1/actions HTTP/1.1
Authorization:Bearer xxxx
Accept-Language: ja
Content-Type: application/json
Accept: application/json
{
    "method": "_performanceDataGet",
    "sid": "_JP1PFM-M_MGRHOST1/_JP1PFM-AHOST_AGENTHOST1/_HOST_AGENTHOST1/_JP1PFM-A_TA1agenthost1",
    "args": {
        "recordId": "PI",
        "fieldIds": ["PI_PCT_TOTAL_PROCESSOR_TIME"],
        "startTime": "2017-04-01T00:00:00+09:00",
        "endTime": "2017-04-01T01:00:00+09:00",
        "interval":"HOUR"
    }
}

レスポンス：

{
    "component": "/HITACHI/JP1/PFM/CONFINFO",
    "productId": "T",
    "dataModelVersion": "8.4",
    "rc": 0,
    "fields": [
    {
        "id": "PI_DATETIME",
        "displayName": "Date and Time",
        "dataType": "DATETIME",
        "keyType": "DATE"
    },
    {
        "id": "PI_PCT_TOTAL_PROCESSOR_TIME",
        "displayName": "CPU %",
        "dataType": "FLOAT",
        "keyType": "NONE"
    }
    ],
    "data": [
        [
            "2017-03-31T15:00:00Z",
            "14.04"
        ],
        [
            "2017-03-31T16:00:00Z","13.55"
        ]
    ]
}

5.8　システムのステータス監視のAPI

システムのステータス監視のAPIに関する操作を説明します。

5.8.1　IM管理ノード関連情報の生成

機能

JP1/AJS3，JP1/PFM，JP1/IM，およびJP1/Baseから各製品が管理する構成情報を取得し，次に示す定義ファイルを使用して，構成管理ツリーファイルを生成します。

システムノード定義ファイル（imdd_systemnode.conf）

IM管理ノードカテゴリ名称定義ファイル（imdd_category_name.conf）

構成取得対象ホスト定義ファイル（imdd_target_host.conf）

ホスト名定義ファイル（imdd_host_name.conf）

このAPIで作成したファイルの格納先ディレクトリは，次のとおりです。

Windowsの場合

物理ホストのとき

Managerパス¥tmp¥imdd¥imnode¥data

論理ホストのとき

共有フォルダ¥JP1IMM¥tmp¥imdd¥imnode¥data

Linuxの場合

物理ホストのとき

/var/opt/jp1imm/tmp/imdd/imnode/data

論理ホストのとき

共有ディレクトリ/jp1imm/tmp/imdd/imnode/data

また，生成に成功した場合はJP1イベント「3F80」，生成に失敗した場合は「3F81」を発行します。

実行権限

次の権限が必要です。

JP1資源グループ：*

JP1権限レベル：JP1_Console_Admin

APIのバージョン

v1

形式

リクエスト行

POST /application/component/apiVersion/nodes/create httpVersion

リクエストのメッセージボディー

なし

レスポンスのメッセージボディー

正常終了の場合，レスポンスはありません。

警告終了の場合，次のレスポンスを返却します。

{
  "returnCode": リターンコード,
  "messageList":[
    {
      "messageId": メッセージID,
      "message": メッセージ
    },
    ・・・
  ]
}

パラメーター

なし

ステータスコード

リクエストに対するレスポンスとして返却されるステータスコードを，次の表に示します。

ステータスコード

メッセージ

説明

200

OK

成功しました。

400

Bad Request

リクエストヘッダーが不正です。

403

Forbidden

実行権限がありません。

404

Not Found

リソースがありません。

406

Not Acceptable

Acceptヘッダー，Accept-Languageヘッダーの指定が不正です。

408

Request Timeout

リクエストがタイムアウトしました。

415

Unsupported media type

Content-Typeヘッダーの指定が不正です。

500

Internal Server Error

サーバ処理エラーが発生しました。

503

Service Unavailable

サービスが利用できません。

サービスが一時的に過負荷やメンテナンスで使用不可となっています。

一時的なエラーが発生した場合（時間経過で改善する見込みがある場合）に返却します。

戻り値

戻り値

説明

2

排他中です。

6

本APIの実行に必要な情報が不足しています。

9

格納ディレクトリのパスが長すぎます。

13

前提ファイルが存在しません。

14

前提ファイルの読み込みに失敗しました。

15

前提ファイルのフォーマット不正です。

16

前提ファイルの記載内容不正です。

17

プラグインからの情報取得に失敗しました。

18

プラグインからの情報が不正です。

20

IM管理ノードファイルの作成に失敗しました。

21

IM管理ノードリンクファイルの作成に失敗しました。

23

IM管理ノードツリーファイルの作成に失敗しました。

26

認証に使用したユーザーの権限が不足しています。

255

システムエラーです。

使用例

構成管理ツリーファイルを生成するAPIの使用例を次に示します。

リクエスト：

POST /im/api/v1/nodes/create HTTP/1.1
Authorization: Bearer anAxYWRtaW46TUdGa01tTTJNMlV3TURFNFh6STNYekE0T2pJME9qTXpYMTlmWDE5ZlgxOWZYMTlmWDE5ZlgycHdNV0ZrYldsdUlDQWdJQ0FnSUNBZ0lDQWdJQ0FnSUNBZ0lDQWdJQ0Fn
Accept-Language: ja
Content-Type: application/json
Accept: application/json

レスポンス：

HTTP/1.1 200 OK
Cache-Control: no-store, no-cache, max-age=0
Pragma: no-cache
Expires: Thu, 01 Jan 1970 00:00:00 GMT
Content-Type: application/json

5.8.2　IM管理ノード関連情報の反映

機能

IM管理ノード関連情報の生成APIで取得した次に示すファイルとIM管理ノードリンク定義ファイルを使用して，構成管理ツリーを作成します。

IM管理ノードツリーファイル

IM管理ノードデータファイル

IM管理ノードリンクファイル

反映方式に新規・再構築モードを指定した場合，統合管理DBに格納されているJP1イベントをすべて取得および評価し，各IM管理ノードのステータスを評価します。

反映方式に構成変更モードを指定した場合，統合監視DBからのJP1イベントの取得は行わず，すでに保持しているIM管理ノードのステータス情報とIM管理ノードに関連するイベント情報を引き継いで使用します。

IM管理ノード関連情報の生成APIで作成したファイルの格納先ディレクトリは，次のとおりです。

Windowsの場合

物理ホストのとき

Managerパス¥tmp¥imdd¥imnode¥data

論理ホストのとき

共有フォルダ¥JP1IMM¥tmp¥imdd¥imnode¥data

Linuxの場合

物理ホストのとき

/var/opt/jp1imm/tmp/imdd/imnode/data

論理ホストのとき

共有ディレクトリ/jp1imm/tmp/imdd/imnode/data

また，反映に成功した場合はJP1イベント「3F82」，反映に失敗した場合は「3F83」を発行します。

実行権限

次の権限が必要です。

JP1資源グループ：*

JP1権限レベル：JP1_Console_Admin

APIのバージョン

v1

形式

リクエスト行

POST /application/component/apiVersion/nodes/update httpVersion

リクエストのメッセージボディー

{
  "mode": 反映方式
}

レスポンスのメッセージボディー

正常終了の場合，レスポンスはありません。

警告終了の場合，次のレスポンスを返却します。

{
  "returnCode": リターンコード,
  "messageList":[
    {
      "messageId": メッセージID,
      "message": メッセージ
    },
    ・・・
  ]
}

パラメーター

リクエストのメッセージボディーに指定するパラメーターを次に示します。

パラメーター名

データ型

省略可否

説明

mode

string

可

反映方式を指定します。

reconfigure

新規・再構築モードで反映します。

change

構成変更モードで反映します。

省略時はインテリジェント統合管理基盤定義ファイル（imdd.properties）のjp1.imdd.simt.updateModeプロパティの設定値に従います。

ステータスコード

リクエストに対するレスポンスとして返却されるステータスコードを，次の表に示します。

ステータスコード

メッセージ

説明

200

OK

成功しました。

400

Bad Request

リクエストヘッダーが不正です。

403

Forbidden

実行権限がありません。

404

Not Found

リソースがありません。

406

Not Acceptable

Acceptヘッダー，Accept-Languageヘッダーの指定が不正です。

408

Request Timeout

リクエストがタイムアウトしました。

415

Unsupported media type

Content-Typeヘッダーの指定が不正です。

500

Internal Server Error

サーバ処理エラーが発生しました。

503

Service Unavailable

サービスが利用できません。

サービスが一時的に過負荷やメンテナンスで使用不可となっています。

一時的なエラーが発生した場合（時間経過で改善する見込みがある場合）に返却します。

戻り値

戻り値

説明

2

排他中です。

3

引数不正です。

6

このAPIの実行に必要な情報が不足しています。

9

格納ディレクトリのパスが長すぎます。

10

JP1/IM - Managerデータベースサービスが起動していません。

13

前提ファイルが存在しません。

14

前提ファイルの読み込みに失敗しました。

15

前提ファイルのフォーマット不正です。

16

前提ファイルの記載内容不正です。

17

イベント情報の取得に失敗しました。

19

プラグインからの情報取得に失敗しました。

22

マスターファイルの置換に失敗しました。

26

認証に使用したユーザーの権限が不足しています。

27

どのIM管理ノードにもマッピングされない提案定義が存在します。

28

提案関連マスターファイルの作成に失敗しました。

29

提案関連マスターファイルの置換えに失敗しました。

255

システムエラーです。

使用例

構成管理ツリーを再作成し，統合管理DBに格納されているJP1イベントをすべて取得および評価し，作成したツリーの構成オブジェクトのステータスに反映させるAPIの使用例を次に示します。

リクエスト：

POST /im/api/v1/nodes/update HTTP/1.1
Authorization: Bearer anAxYWRtaW46TUdGa01tTTJNMlV3TURFNFh6STNYekE0T2pJME9qTXpYMTlmWDE5ZlgxOWZYMTlmWDE5ZlgycHdNV0ZrYldsdUlDQWdJQ0FnSUNBZ0lDQWdJQ0FnSUNBZ0lDQWdJQ0Fn
Accept-Language: ja
Content-Type: application/json
Accept: application/json

{
  "mode":"reconfigure"
}

レスポンス：

HTTP/1.1 200 OK
Cache-Control: no-store, no-cache, max-age=0
Pragma: no-cache
Expires: Thu, 01 Jan 1970 00:00:00 GMT
Content-Type: application/json

5.8.3　IM管理ノード情報取得

機能

JP1/AJS3やJP1/PFM，JP1/IM，JP1/Baseなどから取得したIM管理ノード情報を取得します。ログインしたJP1ユーザーの参照権限に関わらず，すべてのIM管理ノード情報を取得できます。

実行権限

JP1_Console_Admin

JP1_Console_Operator

JP1_Console_User

APIのバージョン

v1

形式

リクエスト行

GET /application/component/apiVersion/nodes/configInfo httpVersion

リクエストのメッセージボディー

なし。

レスポンスのメッセージボディー

{
    "simtData":[
        IM管理ノード情報オブジェクト,…
    ]
}

パラメーター

なし。

ステータスコード

リクエストに対するレスポンスとして返却されるステータスコードを，次の表に示します。

ステータスコード

メッセージ

説明

200

OK

IM管理ノード情報の取得に成功しました。

400

Bad Request

リクエストヘッダーが不正です。

401

Unauthorized

認証が必要です。

403

Forbidden

実行権限がありません。

404

Not Found

リソースがありません。

406

Not Acceptable

Acceptヘッダー，Accept-Languageヘッダーの指定が不正です。

412

Precondition failed

サーバを利用できません。

415

Unsupported media type

Content-Typeヘッダーの指定が不正です。

500

Internal Server Error

サーバ処理エラーが発生しました。

戻り値

ステータスコードが200の場合に，レスポンスボディーに次の情報を返却します。

項番

メンバー名

データ型

説明

1

simtData

object[]

取得したIM管理ノード情報をIM管理ノード情報オブジェクトの配列として返却します。

IM管理ノード情報が無かった場合は，要素数0個の配列を返却します。

使用例

IM管理ノード情報を取得するAPIの使用例を次に示します。

なお，Authorizationヘッダーの値は1行で指定する必要があります。

リクエスト：

GET /im/api/v1/nodes/configInfo HTTP/1.1
Authorization: Bearer xxxx
Accept-Language: ja
Content-Type: application/json
Accept: application/json

レスポンス：

HTTP/1.1 200 OK
Cache-Control: no-store, no-cache, max-age=0
Pragma: no-cache
Expires: Thu, 01 Jan 1970 00:00:00 GMT
Content-Type: application/json

{
"simtData":[
    {"sid":"_JP1AJS-M_host1/_HOST_host1","value":{…}},
    {"sid":"_JP1AJS-M_host1/_HOST_host1/_JP1SCHE_schedulerserv","value":{…}},
    {"sid":"_JP1AJS-M_host1/_HOST_host1/_JP1SCHE_schedulerserv/_JP1JOBG_jobgroup","value":{…}},
    {"sid":"_JP1AJS-M_host1/_HOST_host1/_JP1SCHE_schedulerserv/_JP1JOBG_jobgroup/_JP1ROOTJOBNET_jobnet1","value":{…}},
    {"sid":"_JP1AJS-M_host1/_JP1AJS-A_AGT10/_HOST_host10","value":{…}},
    {"sid":"_JP1PFM-M_host2/_HOST_host2","value":{…}},
    {"sid":"_JP1PFM-M_host2/_JP1PFM-A_servid/_HOST_host20","value":{…}}
  ]
}

5.8.4　構成管理ツリー情報取得

機能

インテリジェント統合管理基盤のステータス監視機能で表示するツリー形式の情報を取得します。ログインしたJP1ユーザーに参照権限が無いIM管理ノードツリー情報は取得できません。

実行権限

JP1_Console_Admin

JP1_Console_Operator

JP1_Console_User

APIのバージョン

v1

形式

リクエスト行

GET /application/component/apiVersion/nodes/treeInfo httpVersion

リクエストのメッセージボディー

なし。

レスポンスのメッセージボディー

{
  "simtData":[
     IM管理ノードツリー情報オブジェクト,…
  ]
}

パラメーター

なし。

ステータスコード

リクエストに対するレスポンスとして返却されるステータスコードを，次の表に示します。

ステータスコード

メッセージ

説明

200

OK

IM管理ノードツリー情報の取得に成功しました。

400

Bad Request

リクエストヘッダーが不正です。

401

Unauthorized

認証が必要です。

403

Forbidden

実行権限がありません。

404

Not Found

リソースがありません。

406

Not Acceptable

Acceptヘッダー，Accept-Languageヘッダーの指定が不正です。

412

Precondition failed

サーバを利用できません。

415

Unsupported media type

Content-Typeヘッダーの指定が不正です。

500

Internal Server Error

サーバ処理エラーが発生しました。

戻り値

ステータスコードが200の場合に，レスポンスボディーに次の情報を返却します。

項番

メンバー名

データ型

説明

1

simtData

object[]

取得したIM管理ノードツリー情報をIM管理ノードツリー情報オブジェクトの配列として返却します。

参照できるIM管理ノードツリー情報が無かった場合は，要素数0個の配列を返却します。

IM管理ノードツリー情報オブジェクトについては「7.2.2(1)　IM管理ノードツリーオブジェクト」を参照してください。

使用例

IM管理ノードツリー情報を取得するAPIの使用例を次に示します。

なお，Authorizationヘッダーの値は1行で指定する必要があります。

リクエスト：

GET /im/api/v1/nodes/treeInfo HTTP/1.1
Authorization: Bearer xxxx
Accept-Language: ja
Content-Type: application/json
Accept: application/json

レスポンス：

HTTP/1.1 200 OK
Cache-Control: no-store, no-cache, max-age=0
Pragma: no-cache
Expires: Thu, 01 Jan 1970 00:00:00 GMT
Content-Type: application/json

{
    "simtData":[
        {"sid":"_ROOT_AllSystems","value":{"target":[],"label":"All Systems"}},
        {"sid":"_ROOT_AllSystems/_SYSTEM_System1","value":{"target":[],"label":"システム1",…}},
        {"sid":"_ROOT_AllSystems/_SYSTEM_System1/_SYSTEM_SubSystem1","value":{"target":[],"label":"サブシステム1",…}},
        {"sid":"_ROOT_AllSystems/_SYSTEM_System1/_SYSTEM_SubSystem1/_HOST_host1","value":{"target":[],"label":"host1",…}},
        {"sid":"_ROOT_AllSystems/_SYSTEM_System1/_SYSTEM_SubSystem1/_HOST_host1/_CATEGORY_Job","value":{"target":[],"label":"Job",…}},
        {"sid":"_ROOT_AllSystems/_SYSTEM_System1/_SYSTEM_SubSystem1/_HOST_host1/_CATEGORY_Job/_OBJECT_JP1AJSMJOB","value":{"target":[],"label":"JP1/AJS3 - Manager"}},
        {"sid":"_ROOT_AllSystems/_SYSTEM_System1/_SYSTEM_SubSystem1/_HOST_host1/_CATEGORY_Job/_OBJECT_JP1AJSMJOB/_OBJECT_ScheduleServ","value":{"target":[],"label":"ScheduleServ"}},
        {"sid":"_ROOT_AllSystems/_SYSTEM_System1/_SYSTEM_SubSystem1/_HOST_host1/_CATEGORY_Job/_OBJECT_JP1AJSMJOB/_OBJECT_ScheduleServ/_OBJECT_jobgroup","value":{"target":[],"label":"jobgroup",…}},
        {"sid":"_ROOT_AllSystems/_SYSTEM_System1/_SYSTEM_SubSystem1/_HOST_host1/_CATEGORY_job/_OBJECT_JP1AJSMJOB/_OBJECT_ScheduleServ/_OBJECT_jobgroup/_OBJECT_jobnet1","value":{"target":[],"label":"jobnet1",…}}
    ]
}

5.8.5　IM管理ノードステータス取得

機能

IM管理ノード（管理グループまたは管理オブジェクト）のステータス情報をすべて取得します。IM管理ノードをパラメーターとして指定した場合は，指定したIM管理ノードのステータス情報だけを取得します。

ログインしたJP1ユーザーに参照権限が無いIM管理ノードを指定した場合，要素数0個の配列を返却します。

実行権限

JP1_Console_Admin

JP1_Console_Operator

JP1_Console_User

APIのバージョン

v1

形式

リクエスト行

POST /application/component/apiVersion/nodes/treeInfo/status httpVersion

リクエストのメッセージボディー

{
    "sid":[
    "IM管理ノードのツリーのSID", …
        ]
}

レスポンスのメッセージボディー

{
    "simtData":[
    ステータス情報オブジェクト,…
        ]
}

パラメーター

sid

IM管理ノードのツリーのSIDを指定します。指定したIM管理ノードのステータス情報を取得します。SIDについては「7.1　SID」を参照してください。

このパラメーターは複数指定することができます。

指定を省略した場合は，参照できるすべてのIM管理ノードのステータス情報を取得します。

ステータスコード

リクエストに対するレスポンスとして返却されるステータスコードを，次の表に示します。

ステータスコード

メッセージ

説明

200

OK

IM管理ノードステータスの取得に成功しました。

400

Bad Request

リクエストヘッダーが不正です。

401

Unauthorized

認証が必要です。

403

Forbidden

実行権限がありません。

404

Not Found

リソースにアクセスする権限がありません。または，リソースがありません。

406

Not Acceptable

Acceptヘッダー，Accept-Languageヘッダーの指定が不正です。

412

Precondition failed

サーバを利用できません。

415

Unsupported media type

Content-Typeヘッダーの指定が不正です。

500

Internal Server Error

サーバ処理エラーが発生しました。

戻り値

ステータスコードが200の場合に，レスポンスボディーに次の情報を返却します。

項番

メンバー名

データ型

説明

1

simtData

object[]

取得したステータス情報をステータス情報オブジェクトの配列として返却します。

指定した識別IDに対応するIM管理ノードが存在しない場合や，参照できるIM管理ノードが無かった場合は，要素数0個の配列を返却します。

定義形式

{
  simtData: [
    {
      "sid": "ツリーのSID",
      "value":{
        "status":{"JP1EVENT": ステータス値}
      }
    },
    ・・・
  ]
}

メンバー

メンバーを次に示します。

項番

メンバー名

データ型

説明

1

simtData

配列

ステータス情報を格納する配列

2

sid

string

IM管理ノードのツリーのSID

3

value

配列

ステータス値を格納する配列

4

status

string

IM管理ノードのSIDのステータス

ステータスのタイプ（JP1EVENT）とステータスを表す数値

返却対象となるsimtDataオブジェクトは，リクエストパラメーターで指定したツリーノードのうち，JP1イベント，または上位伝搬によって1度以上ステータスが変化したツリーノードのオブジェクトだけです。

また，ステータス値の意味を次に示します。

40：緊急・警戒・致命的以下の重要イベントが発生し，対処されていない状態。

30：エラー以下の重要イベントが発生し，対処されていない状態。

20：警告以下の重要イベントが発生し，対処されていない状態。

10：該当するすべての重要イベントを対処（または重要イベント解除・削除）し，システムが健全な状態。

使用例

管理オブジェクトであるジョブネット（sid:_JP1AJS-M_host1/_HOST_host1/_JP1SCHE_sche

dulerserv/_JP1JOBG_jobgroup/_JP1ROOTJOBNET_jobnet1）のステータスを取得するAPIの使用例を次に示します。

なお，Authorizationヘッダーの値は1行で指定する必要があります。

リクエスト：

POST /im/api/v1/nodes/treeInfo/status HTTP/1.1
Authorization: Bearer xxxx
Accept-Language: ja
Content-Type: application/json
Accept: application/json

{
    "sid":[
    "_JP1AJS-M_host1/_HOST_host1/_JP1SCHE_schedulerserv/_JP1JOBG_jobgroup/_JP1ROOTJOBNET_jobnet1"
    ]
}

レスポンス：

HTTP/1.1 200 OK
Cache-Control: no-store, no-cache, max-age=0
Pragma: no-cache
Expires: Thu, 01 Jan 1970 00:00:00 GMT
Content-Type: application/json

{
    "simtData":[
        {
        "sid": "_ROOT_AllSystem",
        "value":{
        "status":{"JP1EVENT": 40}
        }
    ]
}

5.8.6　提案マッピング情報取得

機能

構成管理ツリーと提案定義の情報をマッピングした，提案定義マッピング情報を取得します。

実行権限

JP1_Console_Admin

JP1_Console_Operator

JP1_Console_User

APIのバージョン

v1

形式

リクエスト行

GET /application/component/apiVersion/nodes/treeInfo/suggestions httpVersion

リクエストのメッセージボディー

なし。

レスポンスのメッセージボディー

{
    "simtData": [
        {
            "sid": ツリーSID,
            "value":{
                        "suggestionIds": [提案ID,...]
                    }
            }
        },
        ...
    ]
}

パラメーター

なし。

ステータスコード

リクエストに対するレスポンスとして返却されるステータスコードを，次の表に示します。

ステータスコード

メッセージ

説明

200

なし

提案定義マッピング情報の取得に成功しました。

403

KAJY01000-E

実行権限がありません。

戻り値

ステータスコードが200の場合に，レスポンスボディーに次の情報を返却します。

項番

メンバー名

データ型

説明

1

simtData

object[]

取得した提案定義マッピング情報を配列として返却します。ただし，提案定義がマッピングされていないツリーSIDの情報は，返却されません。

jddupdatetreeコマンド，jddupdatesuggestionコマンドのどちらも実行されていない場合は，空の配列が返却されます。

2

sid

string

IM管理ノードのツリーSIDを指定します。

3

value

object

ツリーSIDの付与情報です。

4

suggestionIds

string[]

ツリーのSIDにマッピングされた提案IDの配列です。

ログインユーザーが表示条件を満たさない提案定義の提案IDの場合でも，返却されます。

使用例

使用例を次に示します。

リクエスト：

GET http://hostname:20703/im/api/v1/nodes/treeInfo/suggestions

レスポンス：

HTTP/1.1 200 OK
Content-Type: application/json
{
    "simtData":[
        {"sid":"_ROOT_AllSystems/_HOST_HISOL_host1/_CATEGORY_job/_OBJECT_JP1AJSMJOB","value":{"suggestionIds":["suggestion1","suggestion2"]}},
        ...
    ]
}

5.9　プロキシのAPI

プロキシのAPIに関する操作を説明します。

5.9.1　プロキシ認証情報設定

機能

インテリジェント統合管理基盤のユーザー作成プラグインからREST APIを実行する場合の，プロキシサーバの認証情報を設定します。プロキシ認証が不要な場合は設定する必要はありません。設定した情報はインテリジェント統合管理基盤に即時反映されます。

実行権限

JP1_Console_Admin

JP1_Console_Operator

APIのバージョン

v1

形式

リクエスト行

POST /application/component/apiVersion/proxyUsers httpVersion

リクエストのメッセージボディー

{
    "op" : 操作内容,
    "id" : ユーザーID,
    "pw" : パスワード
}

レスポンスのメッセージボディー※

{
    "userIdList": [
        "ユーザーID",…
  ]
}

注※　opパラメーターにlistを指定した場合です。

パラメーター

op

操作内容を指定します。このパラメーターは省略できません。

list

インテリジェント統合管理基盤に設定されているプロキシサーバ認証情報を返却します。

add

インテリジェント統合管理基盤にプロキシサーバ認証情報を更新します。

rm

インテリジェント統合管理基盤に設定されているプロキシサーバ認証情報を削除します。

id

プロキシサーバ認証用ユーザーIDを指定します。opパラメーターに「list」を指定した場合は，指定する必要はありません。

pw

プロキシサーバ認証用ユーザーのパスワードを指定します。

opパラメーターに「list」または「rm」を指定した場合は，指定する必要はありません。

ステータスコード

リクエストに対するレスポンスとして返却されるステータスコードを，次の表に示します。

ステータスコード

メッセージ

説明

200

なし

プロキシ認証情報REST APIの処理が成功しました。

400

KAJY52012-E

プロキシ認証情報設定REST APIのパラメーターの指定が不正なため，プロキシ認証情報設定REST APIを実行できません。

403

KAJY01000-E

REST APIの実行権限がありません。

500

KAJY52013-E

プロキシ認証情報の排他に失敗しました。

KAJY52014-E

プロキシ認証情報の設定に失敗しました。

戻り値

ステータスコードが200の場合に，レスポンスボディーに次の情報を返却します。opパラメーターの指定によって，戻り値は異なります。

listの場合

項番

メンバー名

データ型

説明

1

userIdList

配列

プロキシ認証ユーザーIDの一覧

addおよびrmの場合

なし。

レスポンスのメッセージボディーのサイズは0バイトです。

戻り値

説明

2

排他中

3

引数不正

7

実行権限エラー

13

更新失敗エラー

255

システムエラー

注意事項

このAPIを同時に実行することはできません。実行した場合エラーとなります。

使用例

プロキシ認証情報設定APIの使用例を次に示します。

リクエスト：

POST http://hostname:20703/im/api/v1/proxyUsers
{
"op":"list"
}

レスポンス：

{
  "userIdList": [
    "user001","user002",…
  ]
}

5.10　連携製品のAPI

連携製品のAPIに関する操作を説明します。

5.10.1　URL情報取得

機能

指定したIM管理ノードのSIDに対応した連携製品のモニター画面を起動するURLを取得します。このAPIを実行すると，ユーザー作成プラグインの__urlGetメソッド経由でURLが返却されます。

__urlGetメソッドの詳細については「4.4.4(11)　__urlGetメソッド」を参照してください。

実行権限

JP1_Console_Admin

JP1_Console_Operator

JP1_Console_User

APIのバージョン

v1

形式

リクエスト行

POST /application/component/apiVersion/nodes/monitorUrl httpVersion

リクエストのメッセージボディー

{
    "sid" : IM管理ノードのSID
}

レスポンスのメッセージボディー

{
    urlList:[
    {
      "url": モニター起動用URL,
      "name": URLの表示名称
    },
    …
    ]
}

パラメーター

sid

SID（管理オブジェクトID）を指定します。このパラメーターは省略できません。

ステータスコード

ステータスコード

メッセージ

説明

200

なし

URL情報取得REST APIの処理が成功しました。

400

KAJY02049-E

URL情報取得REST APIのパラメーターの指定が不正なため，URL情報取得REST APIを実行できません。

KAJY22011-E

存在しないSIDが指定されています。

403

KAJY01000-E

REST APIの実行権限がありません。

500

KAJY02050-E

URLの取得に失敗しました。

戻り値

ステータスコードが200の場合に，レスポンスボディーに次の情報を返却します。

項番

メンバー名

データ型

説明

1

urlList

object[]

取得したURL情報を配列として返却します。指定したSIDに対応するURLが存在しない場合は，要素数0個の配列を返却します。

2

url

string

連携製品起動用のURLが設定されます。

3

name

string

URLの表示名称が設定されます。

使用例

管理オブジェクトであるジョブネット（sid:_JP1AJS-M_host1/_HOST_host1/_JP1SCHE_sche

dulerserv/_JP1JOBG_jobgroup/_JP1ROOTJOBNET_jobnet1）のモニター起動用URLを取得するAPIの使用例を次に示します。

リクエスト：

POST http://hostname:20703/im/api/v1/nodes/monitorUrl
{
"sid":"_JP1AJS-M_host1/_HOST_host1/_JP1SCHE_schedulerserv/_JP1JOBG_jobgroup/_JP1ROOTJOBNET_jobnet1"
}

レスポンス：

{
  urlList:[
    {
      "url":"http://xxx.xxx.xxx.xxx:22252/ajs/…",
      "name":"JP1/AJS3 - Web Console (List)"
    }
  ]
}

5.11　トレンドのAPI

トレンドのAPIに関する操作を説明します。

5.11.1　メトリック一覧取得

機能

指定したIM管理ノードのSIDで取得可能な時系列データのメトリック一覧を取得します。

実行権限

JP1_Console_Admin

JP1_Console_Operator

JP1_Console_User

APIのバージョン

v1

形式

リクエスト行

POST /application/component/apiVersion/nodes/metrics httpVersion

リクエストのメッセージボディー

{
    "sid" : IM管理ノードのSID
}

レスポンスのメッセージボディー

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

パラメーター

sid

SID（管理オブジェクトID）を指定します。このパラメーターは省略できません。

ステータスコード

ステータスコード

メッセージ

説明

200

なし

メトリック一覧取得REST APIの処理が成功しました。

400

KAJY22009-E

メトリック一覧取得REST APIのパラメーターの指定が不正なため，メトリック一覧取得REST APIを実行できません。

KAJY22011-E

存在しないSIDが指定されています。

403

KAJY01000-E

REST APIの実行権限がありません。

500

KAJY22007-E

メトリック一覧の取得に失敗しました。

KAJY22008-E

取得したデータが不正です。

戻り値

ステータスコードが200の場合に，レスポンスボディーに次の情報を返却します。

項番

メンバー名

データ型

説明

1

metrics

object[]

取得したメトリック一覧を配列として返却します。

2

name

string

メトリック名が設定されます。

3

label

string

メトリックの表示名称が設定されます。

設定されていない場合は，省略されます。

4

category

string

メトリックのカテゴリが設定されます。

設定されていない場合は，省略されます。

5

description

string

メトリックの説明が設定されます。

設定されていない場合は，省略されます。

6

default

boolean

デフォルトのメトリック名かどうかが設定されます。

true：デフォルトのメトリック

false：デフォルト以外のメトリック

使用例

管理オブジェクトであるPFMエージェントのサービス（sid：_JP1PFM-M_HOST2/_JP1PFM-AHOST_HOST20/_HOST_HOST20/_JP1PFM-A_serviceID）のメトリック一覧を取得するAPIの使用例を次に示します。

リクエスト：

POST http://hostname:20703/im/api/v1/nodes/metrics
{
"sid":"_JP1PFM-M_HOST2/_JP1PFM-AHOST_HOST20/_HOST_HOST20/_JP1PFM-A_serviceID"
}

レスポンス：

{
    "metrics": [
         {
               "name":"cpu_used_rate",
               "label":"CPU使用率",
               "description":"プロセッサの使用率（%）。プロセッサが非アイドル状態のスレッドを実行した経過時間の割合。（単位:%）",
               "default":true
    } …
  ]
}

5.11.2　時系列データ取得

機能

指定したIM管理ノードのSID，およびメトリックに応じた時系列データを取得します。

実行権限

JP1_Console_Admin

JP1_Console_Operator

JP1_Console_User

APIのバージョン

v1

形式

リクエスト行

POST /application/component/apiVersion/nodes/timeSeries httpVersion

リクエストのメッセージボディー

{
    "sid" : IM管理ノードのSID
    "metric": メトリック名,
    "startTime": 開始時刻,
    "endTime": 終了時刻,
    "countPerInstance":インスタンス当たりのデータ数の上限,
    "instanceCount":インスタンス数の上限,
}

レスポンスのメッセージボディー

{
    "metric":"メトリック",
    "timeSeriesData":[
        {
            "instance":"インスタンス名",
            "unit":"単位",
            "data":[
                {"time":"時刻","value": 値},
                                 ・・・
          ]
      },
      ・・・
    ] ,
    "exceedCountDetected": {
        "countPerInstance": インスタンスごとのデータ数上限超過検知有無,
        "instanceCount": インスタンス数の上限超過検知有無
    },
    "messageId":"メッセージID",
    "message":"メッセージ"
}

パラメーター

sid

SID（管理オブジェクトID）を指定します。このパラメーターは省略できません。

metric

取得するメトリックを指定します。このパラメーターは省略できません。

半角英数字と次の記号で，1〜255文字以内で指定します。

-（ハイフン），_（アンダースコア）

startTime

時系列データの開始日時をISO 8601形式のUTC時刻で指定します。このパラメーターは省略できません。小数点以下の秒数は指定できません。

endTime

時系列データの終了日時をISO 8601形式のUTC時刻で指定します。このパラメーターは省略できません。小数点以下の秒数は指定できません。

countPerInstance

取得する1インスタンスあたりのデータ数の上限を指定します。指定できる範囲は，1〜30,000です。countPerInstanceパラメーターとinstanceCountパラメーターを掛けた数値が30,000以下となるように指定してください。指定を省略した場合は，60が仮定されます。

instanceCount

取得するインスタンス数の上限を指定します。指定できる範囲は，1〜30,000です。countPerInstanceパラメーターとinstanceCountパラメーターを掛けた数値が30,000以下となるように指定してください。指定を省略した場合は，10が仮定されます。

ステータスコード

ステータスコード

メッセージ

説明

200

なし

時系列データ取得REST APIの処理が成功しました。

KAJY22012-W

上限値を超えたため，返却されないデータが存在します。

400

KAJY22010-E

時系列データ取得REST APIのパラメーターの指定が不正なため，時系列データ取得REST APIを実行できません。

KAJY22011-E

存在しないSIDが指定されています。

403

KAJY01000-E

REST APIの実行権限がありません。

500

KAJY22006-E

時系列データの取得に失敗しました。

KAJY22008-E

取得したデータが不正です。

戻り値

ステータスコードが200の場合に，レスポンスボディーに次の情報を返却します。

項番

メンバー名

データ型

説明

1

timeSeriesData

object[]

取得した時系列データを配列として返却します。

2

metric

string

メトリック名が設定されます。

3

instance

string

インスタンス名が設定されます。

設定されていない場合は，省略されます。

4

unit

string

メトリックの単位が設定されます。

5

data

object[]

時刻，値のデータを配列として返却します。

6

time

string

時系列データの時刻がISO 8601形式のUTC時刻で設定されます。小数点以下の秒数は指定されません。

7

value

number

データの値が設定されます。

8

exceedCountDetected

object

パラメーターの指定値が上限を超えたことの検知有無です。パラメーターごとにメンバーを持ちます。

9

countPerInstance

boolean

1インスタンスあたりのデータ数が上限を超えたことの検知有無です。

true：検知した

false：検知しない

10

instanceCount

boolean

インスタンス数が上限を超えたことの検知有無です。

true：検知した

false：検知しない

11

messageId

string

メッセージIDです。

通知するメッセージが存在しない場合は省略されます。

12

message

string

メッセージ本文です。

使用される言語は，HTTPリクエストヘッダーのAccept-Languageプロパティの指定内容により決まります。

通知するメッセージが存在しない場合は省略されます。

使用例

管理オブジェクトであるPFMエージェントのサービス（sid：_JP1PFM-M_HOST2/_JP1PFM-AHOST_HOST20/_HOST_HOST20/_JP1PFM-A_serviceID）の時系列データを取得するAPIの使用例を次に示します。

リクエスト：

POST http://hostname:20703/im/api/v1/nodes/timeSeries
{
    "sid":"_JP1PFM-M_HOST2/_JP1PFM-AHOST_HOST20/_HOST_HOST20/_JP1PFM-A_serviceID",
    "metric":"cpu_used_rate",
    "startTime":"2019-05-22T00:00:00Z",
    "endTime":"2019-05-22T01:00:00Z",
    "countPerInstance":60,
    "instanceCount":10
}

レスポンス：

{
    "metric":"cpu_used_rate",
    "timeSeriesData":[
            {
                 "unit":"%",
                 "data":[
                  {"time":"2019-05-22T00:00:00Z","value":14.04},
                               ・・・
              ]
          }
    ],
    "exceedCountDetected": {
        "countPerInstance": true,
        "instanceCount": false
    }
}

5.11.3　トレンドデータ書き込み

機能

トレンドデータをトレンドデータ管理DBに書き込みます。

書き込むデータはJSON形式で指定します。

実行権限

なし

APIのバージョン

v1

形式

リクエスト行

POST /im/api/v1/trendData/write HTTP/1.1

リクエストヘッダー

ヘッダー名

設定値

Authorization

設定しないでください。

リクエストのメッセージボディーがJSON形式の場合，ほかのリクエストヘッダーは，APIの共通仕様と同じです。APIの共通仕様のリクエストヘッダーについては，「5.2.3　リクエスト形式」の，リクエストヘッダーの説明を参照してください。

リクエストのメッセージボディー

次に示すJSON形式で送信できます。

{
    "labels":{"__name__": "メトリクス名", "ラベル名":"ラベル値", ...},
    "samples":[
        [時刻, 値],
        ...
    ]
}
{
    "labels":{"__name__": "メトリクス名", "ラベル名":"ラベル値", ...},
    "samples":[
        [時刻, 値],
        ...
    ]
}
...

レスポンスのメッセージボディー

なし

パラメーター

リクエストのメッセージボディーに指定するパラメーターを次に示します。

項番

パラメーター

データ型

説明

1

labels

配列

時系列データのラベルを配列で指定します。

2

__name__

string

時系列データのメトリクス名を指定します。指定は必須です。

3

ラベル名

string

時系列データのラベル名を指定します。

4

ラベル値

string

時系列データのラベル値を指定します

5

samples

配列

時系列データを配列で指定します。

6

時刻

数値

性能データの時刻（UTC時刻における1970年1月1日午前0時0分0秒（UNIXエポック）からの経過ミリ秒数）を指定します。1970年1月1日午前0時0分0秒以前の時刻（マイナス値）は指定できません。

7

値

数値

性能データの値を指定します。

ステータスコード

リクエストに対するレスポンスとして返却されるステータスコードを，次の表に示します。

ステータスコード

メッセージ

説明

200

なし

APIの処理が成功しました。

500

KAJY62001-E

トレンドデータ管理サービスからエラーが返却されました。

KAJY62000-E

トレンドデータ管理サービスとの通信に失敗しました。

KAJY62004-E

トレンドデータ管理サービスのポート番号の取得に失敗しました。

使用例

OSSのcurlコマンドを利用して，このAPIを実行した場合の使用例を，次に示します。

>curl -i --header "Content-Type: application/json" --request POST --data @c:¥¥work¥¥trenddata.json "http://localhost:20703/im/api/v1/trendData/write"

trenddata.json

{
    "labels":{"__name__":"foo","job":"hoge"},
    "samples":[
        [1617436800000,100]
    ]
}

レスポンス例

HTTP/1.1 200
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
Content-Length: 0
Date: Fri, 25 Feb 2022 05:59:58 GMT

5.12　情報管理のAPI

情報管理のAPIに関する操作を説明します。

5.12.1　バージョン情報取得

機能

JP1/IMの製品バージョンおよびサポートするREST APIのバージョンを取得します。このAPIは，ログインを含めたすべてのREST APIを呼び出す前に呼び出されるため，認証なしで呼び出します。

実行権限

なし。

APIのバージョン

なし。

形式

リクエスト行

GET /application/component/version httpVersion

リクエストのヘッダー

共通のリクエストヘッダーです。

なお，リクエストヘッダーにはCookieを指定しないでください。

リクエストのメッセージボディー

なし。

レスポンスのヘッダー

共通のレスポンスヘッダーです。

レスポンスのメッセージボディー

{
    "productName": "製品名",
    "productVersion": "製品バージョン",
    "apiVersion": ["REST APIバージョン", "REST APIバージョン", ...]
}

パラメーター

なし。

ステータスコード

リクエストに対するレスポンスとして返却されるステータスコードを，次の表に示します。

ステータスコード

メッセージ

説明

200

−

バージョン情報の取得に成功しました。

戻り値

ステータスコードが200の場合に，レスポンスボディーに次の情報を返却します。

項番

メンバー名

データ型

説明

1

productName

文字列

バージョン情報を取得した製品名を返却します。

2

productVersion

文字列

製品バージョンを「VV-RR」または「VV-RR-SS」形式で返却します。

例えば，製品バージョンが「12-00」の場合は「SS」を省略して「12-00」，製品バージョンが「12-00-02」の場合は「12-00-02」を返却します。

3

apiVersion

配列

サポートするREST APIバージョンの配列を，「VV.RR.SS」形式で返却します。「VV」，「RR」，「SS」はそれぞれ2桁の数字です。

なお，REST APIのURIを構成するapiVersionの場合，「VV」の値の1文字目の0を消去し，文字列「v」と連結した配列を返却します。

例えば，VVが「01」の場合，URIのapiVersionは「v1」となります。

使用例

リクエスト：

GET /im/api/version HTTP/1.1
Accept-Language: ja
Content-Type: application/json
Accept: application/json

レスポンス：

HTTP/1.1 200 OK
Cache-Control: no-store, no-cache, max-age=0
Pragma: no-cache
Expires: Thu, 01 Jan 1970 00:00:00 GMT
Content-Type: application/json

{
    "productName": "JP1/Integrated Management 3 - Manager",
    "productVersion": "12-00",
    "apiVersion": ["01.00.00"]
}

5.13　提案のAPI

提案のAPIに関する操作を説明します。

5.13.1　前回実行履歴取得

機能

指定したIM管理ノード，または提案IDに応じた対処アクションを，前回いつ実行したかの履歴情報を取得します。

実行権限

JP1_Console_Admin

JP1_Console_Operator

JP1_Console_User

APIのバージョン

v1

形式

リクエスト行

POST /application/component/apivVersion/nodes/suggestions/history httpVersion

リクエストのメッセージボディー

{
    "sid": IM管理ノードのツリーSID,
    "suggestionIds": 提案IDのリスト
}

レスポンスのメッセージボディー

{
    "histories":[
        {
            "suggestionId": 提案ID,
            "label": 提案表示名,
            "jp1UserName": 対処アクションを実行したJP1ユーザー名,
            "startTime": 対処アクションの実行開始日時,
            "endTime": 対処アクションの実行終了日時,
            "status" : 対処アクションの実行状態
        },
        ...
    ]
}

パラメーター

sid

IM管理ノードのツリーSIDを指定します。このパラメーターは省略できません。

suggestionIds

提案IDのリストを指定します。1〜1,000件まで指定できます。空のリストを指定した場合，エラーメッセージKAJY22019-Eを出力し，対処アクションの前回実行履歴の取得を中断します。

このパラメーターの指定を省略した場合は，指定したIM管理ノードにマッピングされた提案定義のうち，ログインユーザーが表示条件を満たしている提案定義について，対処アクションの前回実行履歴を取得します。

指定されたIM管理ノードのツリーSIDにマッピングされていない提案定義，またはログインユーザーが表示できない提案定義の提案IDを指定した場合，エラーメッセージKAJY22021-Eを出力し，対処アクションの前回実行履歴の取得を中断します。

ステータスコード

リクエストに対するレスポンスとして返却されるステータスコードを，次の表に示します。

ステータスコード

メッセージ

説明

200

なし

前回実行履歴の取得に成功しました。

400

KAJY22019-E

REST APIのリクエストが不正です。

IM管理ノードのツリーSIDの形式が不正，提案IDが不正，提案IDのリスト数が不正，などの原因が考えられます。

KAJY22022-E

REST APIのリクエストが不正です。

提案IDが重複しています。

KAJY22011-E

存在しないSIDを指定しているか，指定したIM管理ノードの参照権限がログインユーザーにありません。

KAJY22021-E

指定されたIM管理ノードにマッピングされていない提案，またはログインユーザーが表示できない提案の提案IDを指定しています。

403

KAJY01000-E

REST APIの実行権限がありません。

ステータスコードが200の場合に，レスポンスボディーに次の情報を返却します。

項番

メンバー名

データ型

説明

1

histories

object[]

対処アクションの前回実行履歴を配列として返却します。

指定されたIM管理ノードのツリーSIDにマッピングされている提案定義が存在しない，またはマッピングされている提案定義の中に，ログインユーザーが表示できる提案定義が存在しない場合は，空の配列が返却されます。

2

suggestionId

string

提案IDが設定されます。

3

label

string

提案表示名が設定されます。

4

jp1UserName

string

対処アクションを実行したJP1ユーザー名です。前回実行履歴が存在しない場合，このメンバーは返却されません。

5

startTime

string

対処アクションの実行開始年月，日時をISO 8601形式のUTC時刻で返却します。前回実行履歴が存在しない場合，このメンバーは返却されません。

6

endTime

string

対処アクションの実行終了年月，日時をISO 8601形式のUTC時刻で返却します。対処アクションが実行中，または失敗した場合は，空文字が返却されます。前回実行履歴が存在しない場合，このメンバーは返却されません。

7

status

int

対処アクションの実行状態です。次のどれかを返却します。

0：実行中

1：成功

2：失敗

前回実行履歴が存在しない場合，このメンバーは返却されません。

使用例

APIの使用例を次に示します。

リクエスト：

POST http://hostname:20703/im/api/v1/nodes/suggestions/history
{
    "sid":"_ROOT_AllSystems/_HOST_HOSTA/_CATEGORY_managementApplications/_OBJECT_JP1IMMGR"
}

レスポンス：

{
    "histories":[
        {
            "suggestionId":"exec_jim_log",
            "label":"JP1/IMの資料採取ツールの実行",
            "jp1UserName":"jp1admin",
            "startTime":"2020-03-01T00:00:00Z",
            "endTime":"",
            "status" :0
        },
        {
            "suggestionId":"reg_ticket",
            "label":"Redmineへチケットを登録する",
            "jp1UserName":"jp1admin",
            "startTime":"2020-03-01T00:00:00Z",
            "endTime":"2020-03-01T00:00:10Z",
            "status" :1
        }
    ]
}

5.13.2　対処アクション提案

機能

指定したIM管理ノード，提案IDに応じた提案定義について，提案が活性化する条件を判定し，システム状況に応じた対処アクションを提案します。

実行権限

JP1_Console_Admin

JP1_Console_Operator

JP1_Console_User

APIのバージョン

v1

形式

リクエスト行

POST /application/component/apivVersion/nodes/suggestions/suggest httpVersion

リクエストのメッセージボディー

{
    "sid": IM管理ノードのツリーSID,
    "suggestionIds": 提案IDのリスト
}

レスポンスのメッセージボディー

{
    "suggestions":[
        {
            "suggestionId": 提案ID,
            "label": 提案表示名,
            "status": 提案活性条件が成立したか,
            "cases":[
                [
                    {
                        "description": 条件の説明,
                        "status": 条件の状態,
                        "acquisitionDate": 取得日時,
                    },
                    ...
                ],
                [
                    {
                        "description": 条件の説明,
                        "status": 条件の状態,
                        "acquisitionDate": 取得日時,
                    },
                ...
            ],
            "action": {
                    "type": 対処アクションの種別,
                    "params": 対処アクションのパラメーター,
                    "description": 対処アクションの説明
                      }
            "messageList":[
                {
                    "messageId": メッセージID,
                    "message": メッセージ文
                },
                ...
            ]
        },
        ...
    ]
}

パラメーター

sid

IM管理ノードのツリーSIDを指定します。

suggestionIds

提案IDのリストを指定します。1〜1,000件まで指定できます。空のリストを指定した場合，エラーメッセージKAJY22019-Eを出力し，対処アクションの提案処理を中断します。

このパラメーターの指定を省略した場合は，指定したIM管理ノードにマッピングされた提案定義のうち，ログインユーザーが表示できる提案定義について，提案活性条件を判定し，システム状況に応じた対処アクションの提案情報を取得します。

指定されたIM管理ノードのツリーSIDにマッピングされていない提案定義，またはログインユーザーが表示できない提案定義の提案IDを指定した場合，エラーメッセージKAJY22021-Eを出力し，対処アクションの提案処理の取得を中断します。

ステータスコード

リクエストに対するレスポンスとして返却されるステータスコードを，次の表に示します。

ステータスコード

メッセージ

説明

200

なし

対処アクションの提案に成功しました。

KAJY22026-W

提案定義の変数変換に失敗しました。

KAJY22027-W

提案定義を変数変換したあとの提案情報が不正です。

KAJY22028-W

提案活性条件の判定に失敗しました。

KAJY22047-W

繰り返しイベント一覧画面の情報の取得に失敗しました。

400

KAJY22020-E

REST APIのリクエストが不正です。

IM管理ノードのツリーSIDの形式が不正，提案IDが不正，提案IDのリスト数が不正，などの原因が考えられます。

KAJY22022-E

REST APIのリクエストが不正です。

提案IDが重複しています。

KAJY22011-E

存在しないツリーSIDを指定しているか，指定したIM管理ノードの参照権限がログインユーザーにありません。

KAJY22021-E

指定されたIM管理ノードにマッピングされていない提案，またはログインユーザーが表示できない提案の提案IDを指定しています。

403

KAJY01000-E

REST APIの実行権限がありません。

ステータスコードが200の場合に，レスポンスボディーに次の情報を返却します。

項番

メンバー名

データ型

説明

1

suggestions

object[]

取得した提案情報を配列として返却します。

指定されたIM管理ノードのツリーSIDにマッピングされている提案定義が存在しない，またはマッピングされている提案定義の中に，ログインユーザーが表示できる提案定義が存在しない場合は，空の配列が返却されます。

2

suggestionId

string

提案IDが設定されます。

3

label

string

提案表示名が設定されます。

4

status

int

提案活性条件が成立したかどうかです。次のどれかを返却します。

0：条件成立

1：条件不成立

2：エラー

5

cases

object[][]

提案条件オブジェクトの二重配列が設定されます。内側の配列がAND条件群，外側の配列がOR条件群を表します。提案定義のcasesメンバーを省略した場合，このメンバーは返却されません。

6

description

string

変数を変換したあとの条件の説明が返却されます。

7

status

int

条件の状態です。次のどれかを返却します。

0：未判定

1：一致

2：不一致

3：エラー

8

acquisitionDate

string

条件情報の取得日時をISO 8601形式のUTC時刻で返却します。

status（条件の状態）が0（未判定），または3（エラー）の場合は，空文字が返却されます。

9

action

object

対処アクションの情報が返却されます。

10

type

string

提案定義に指定された対処アクションの種別が返却されます。typeのメンバーの詳細については「提案定義ファイル（imdd_suggestion.conf）」（2.　定義ファイル）の「(2)対処アクション」を参照してください。

11

params

object

対処アクションのtypeにjumpが指定され，かつrelatedEventが指定されている場合はredlatedEventおよび項番12〜項番15のメンバーが返却されます。

その他の場合は，提案定義に指定された対処アクションのパラメーターが変数を変換された状態で返却されます。項番12〜項番15以外のメンバーの詳細については「提案定義ファイル（imdd_suggestion.conf）」（2.　定義ファイル）の「(2) 対処アクション」を参照してください。

12

suppressId

string

relatedEvent※で指定されたJP1イベントの属性E.JP1_IMSUPPRESS_ID（監視抑止ID）の値です。

13

eventSevere

string

relatedEvent※で指定されたJP1イベントの属性E.@JP1IM_SEVERE（重要イベント）の値です。

14

suppressName

string

relatedEvent※で指定されたJP1イベントの属性E.JP1_IMSUPPRESS_NAME（繰り返しイベント条件名）の値です。

15

nodeSid

string

relatedEvent※で指定されたJP1イベントに対応するIM管理ノードのツリーSIDです。

16

description

string

status（提案活性条件の成立）が0（条件成立）の場合

変数を変換したあとの対処アクションの説明が返却されます。

statusが上記以外の場合

変数を変換する前の対処アクションの説明が返却されます。512文字を超える場合は，513文字目以降は削除されます。

17

messageList

object[]

処理中に発生した続行が可能な警告メッセージを返却しましす。

続行が可能な警告メッセージがない場合，このメンバーは返却されません。

18

messageId

string

メッセージIDが返却されます。

19

message

string

メッセージ文が返却されます。

注※

relatedEventの詳細については「提案定義ファイル（imdd_suggestion.conf）」（2.　定義ファイル）の「(2)(A)(e) typeに「jump」を指定した場合の対処アクション」のrelatedEventの説明を参照してください。

使用例

管理オブジェクトであるPFMエージェントのサービスのIM管理ノード（ツリーsid：_ROOT_AllSystems/_HOST_HOST1/_CATEGORY_platform/_SUBCATEGORY_JP1%2FPFM%20-%20Windows/_OBJECT_JP1PFM-ATA1HOST2）の対処アクションを提案する場合の使用例を次に示します。

リクエスト：

POST http://hostname:20703/im/api/v1/nodes/suggestions/suggest
{
"sid":"_ROOT_AllSystems/_HOST_HOST1/_CATEGORY_platform/_SUBCATEGORY_JP1%2FPFM%20-%20Windows/_OBJECT_JP1PFM-ATA1HOST2"
}

レスポンス：

HTTP/1.1 200 OK
Content-Type: application/json
{
    "suggestions":[
        {
            "suggestionId":"check_affected_rootJobnet",
            "label":"ホスト停止に影響されるルートジョブネットの影響",
            "status":0,
            "cases":[
                [
                    {
                         "description":"選択中のノード(PFM-Agent)と同じホストにJP1/AJS-Agentのノードが存在する",
                         "status":1,
                         "acquisitionDate":"2020-03-11T11:00:00Z"
                    },
                    {
                         "description":"ホスト停止のJP1イベントが発行されている",
                        "status"：1,
                         "acquisitionDate":"2020-03-11T11:00:01Z"
                    },
                    {
                         "description":"選択ノードのホストが停止している",
                         "status"：1,
                         "acquisitionDate":"2020-03-11T11:00:02Z"
                    }
                ]
            ],
            "action":
                {
                    "type":"jump",
                    "params":
                        {
                            " url":"index?sid=%5FROOT%5FAllSystems%2F%5FHOST%5FHOST1%2F%5FCATEGORY%5FmanagementApplications%2F%5FOBJECT%5FJP1AJSAGT&view=tree&tab=relation&eou=1"
                        },
                    "description":"JP1/AJS-Agentのノードの関連ノードタブに移動"
                }
        }
    ]
}

5.13.3　対処アクション実行

機能

指定された対処アクションを実行します。

実行権限

JP1_Console_Admin

JP1_Console_Operator

JP1_Console_User

APIのバージョン

v1

形式

リクエスト行

POST /application/component/apivVersion/nodes/suggestions/action httpVersion

リクエストのメッセージボディー

{
    "sid": ツリーのSID,
    "suggestionId": 提案ID,
    "action": {
             "type": 対処アクションの種別,
             "params": 対処アクションのパラメーター,
             "description": 対処アクションの説明
              }
}

レスポンスのメッセージボディー

{
    "location": 画面遷移先のURL,
    "target": 画面遷移先のURLを開く際のHTMLのtarget属性,
    "suppressId":［繰り返しイベント一覧］画面の情報（監視抑止ID）,
    "eventSevere":［繰り返しイベント一覧］画面の情報（重大イベント）,
    "suppressName":［繰り返しイベント一覧］画面の情報（繰り返しイベント条件名）,
    "nodeSid":［繰り返しイベント一覧］画面の情報（IM管理ノードのツリーSID）,
    "message":{
        "messageId": メッセージID,
        "message": メッセージ文
    }
}

パラメーター

sid

ツリーのSIDを指定します。

suggestionId

提案IDを指定します。提案IDについては「提案定義ファイル（imdd_suggestion.conf）」（2.　定義ファイル）のsuggestionIdの説明を参照してください。

action

対処アクションを指定します。

type：対処アクションの種別を指定します。指定できる種別の詳細については「提案定義ファイル（imdd_suggestion.conf）」（2.　定義ファイル）の「(2)対処アクション」を参照してください。

params：変数変換したあとの対処アクションのパラメーターを指定します。なお，対処アクション種別がjumpでかつrelatedEventが指定されている場合は，次のメンバーを追加で指定します。各メンバーの詳細については「5.13.2　対処アクション提案」を参照してください。

・suppressId

・eventSevere

・suppressName

・nodeSid

description：変数変換したあとの対処アクションの説明を指定します。指定できるのは，制御文字を含まない512文字以内の文字列です。空文字は指定できません。

ステータスコード

リクエストに対するレスポンスとして返却されるステータスコードを，次の表に示します。

ステータスコード

メッセージ

説明

200

なし

対処アクション実行REST APIの処理が成功しました。

KAJY22029-W

対処アクションは実行中です。

400

KAJY22031-E

REST APIのリクエストが不正です。

IM管理ノードのツリーSIDの形式が不正，提案IDが不正，対処アクションが不正，などの原因が考えられます。

KAJY22011-E

存在しないSIDを指定しているか，指定したIM管理ノードの参照権限がログインユーザーにありません。

KAJY22021-E

指定されたIM管理ノードにマッピングされていない提案，またはログインユーザーが表示できない提案の提案IDを指定しています。

403

KAJY01000-E

REST APIの実行権限がありません。

500

KAJY22033-E

対処アクションの同時実行数が上限を超えました。

ステータスコードが200の場合に，レスポンスボディーに次の情報を返却します。

項番

メンバー名

データ型

説明

1

location

string

画面の遷移先URLを返却します。

対処アクションの種別がjumpでかつurlが指定されている場合

ジャンプ先のURLを返却します。

上記以外の場合

このメンバーは返却されません。

対処アクションが実行中の場合は，対処アクションの種別に関わらず，このメンバーは返却されません。

2

target

string

画面遷移先のURLを開く際のHTMLのtarget属性を返却します。

対処アクションの種別がjumpでかつurlが指定されている場合

ジャンプ先のURLを開く際のHTMLのtarget属性を返却します。

対処アクションの種別がjump以外の場合

このメンバーは返却されません。

対処アクションが実行中の場合は，対処アクションの種別に関わらず，このメンバーは返却されません。

3

suppressId

string

［繰り返しイベント一覧］画面の情報（監視抑止ID）を返却します。

対処アクションの種別がjumpでかつrelatedEventが指定されている場合

［繰り返しイベント一覧］画面の情報（監視抑止ID）を返却します。

上記以外の場合

このメンバーは返却されません。

対処アクションが実行中の場合は，対処アクションの種別に関わらず，このメンバーは返却されません。

4

eventSevere

string

［繰り返しイベント一覧］画面の情報（重大イベント）を返却します。

対処アクションの種別がjumpでかつrelatedEventが指定されている場合

［繰り返しイベント一覧］画面の情報（重大イベント）を返却します。

上記以外の場合

このメンバーは返却されません。

対処アクションが実行中の場合は，対処アクションの種別に関わらず，このメンバーは返却されません。

5

suppressName

string

［繰り返しイベント一覧］画面の情報（繰り返しイベント条件名）を返却します。

対処アクションの種別がjumpでかつrelatedEventが指定されている場合

［繰り返しイベント一覧］画面の情報（繰り返しイベント条件名）を返却します。

上記以外の場合

このメンバーは返却されません。

対処アクションが実行中の場合は，対処アクションの種別に関わらず，このメンバーは返却されません。

6

nodeSid

string

［繰り返しイベント一覧］画面の情報（IM管理ノードのツリーSID）を返却します。

対処アクションの種別がjumpでかつrelatedEventが指定されている場合

［繰り返しイベント一覧］画面の情報（IM管理ノードのツリーSID）を返却します。

上記以外の場合

このメンバーは返却されません。

対処アクションが実行中の場合は，対処アクションの種別に関わらず，このメンバーは返却されません。

7

message

object

対処アクションが実行中の場合，対処アクションの実行中を通知するメッセージを返却します。対処アクションが実行中ではない場合，このメンバーは返却されません。

8

messageId

string

メッセージIDが返却されます。

9

message

string

メッセージ文が返却されます。

注意事項

このAPIは，10個まで同時に実行できます。上限を超えた場合，エラーメッセージKAJY22033-Eを出力し，対処アクションの実行を中止します。

使用例

管理オブジェクトであるPFMエージェントのサービスのIM管理ノード（ツリーsid：_ROOT_AllSystems/_HOST_HOST1/_CATEGORY_platform/_SUBCATEGORY_JP1%2FPFM%20-%20Windows/_OBJECT_JP1PFM-ATA1HOST2）で「JP1/AJS-Agentのノードの関連ノードタブに移動」の対処アクション（提案ID：check_affected_rootJobnet）を実行する場合の使用例を次に示します。

リクエスト：

POST http://hostname:20703/im/api/v1/nodes/suggestions/action
{
    "sid":"_ROOT_AllSystems/_HOST_HOST1/_CATEGORY_platform/_SUBCATEGORY_JP1%2FPFM%20-%20Windows/_OBJECT_JP1PFM-ATA1HOST2",
    "suggestionId":"check_affected_rootJobnet",
    "action":
        {
            "type":" jump",
            "params":
                {
                    "url":"index?sid=%5FROOT%5FAllSystems%2F%5FHOST%5FHOST1%2F%5FCATEGORY%5FmanagementApplications%2F%5FOBJECT%5FJP1AJSAGT&view=tree&tab=relation&eou=1"

                },
            "description":"JP1/AJS-Agentのノードの関連ノードタブに移動"
        }
}

レスポンス：

HTTP/1.1 200 OK
Content-Type: application/json
{
    "location":"index?sid=%5FROOT%5FAllSystems%2F%5FHOST%5FHOST1%2F%5FCATEGORY%5FmanagementApplications%2F%5FOBJECT%5FJP1AJSAGT&view=tree&tab=relation&eou=1",
    "target":""
}

5.14　OpenID認証のAPI

OpenID認証のAPIに関する操作を説明します。

5.14.1　シングルサインオンマッピング定義反映

機能

シングルサインオンマッピング定義ファイル（imdd_sso_mapping.properties）で定義したマッピング情報を，インテリジェント統合管理基盤に反映します。設定した情報はインテリジェント統合管理基盤に即時反映されます。

シングルサインオンマッピング定義ファイルに有効なプロパティが一つも存在しない状態で定義の反映を実行した場合はKAJY52031-Wメッセージをレスポンスに設定し，反映済みのシングルサインオンマッピング定義をクリアします。

シングルサインオンマッピング定義ファイル（imdd_sso_mapping.properties）については，「シングルサインオンマッピング定義ファイル（imdd_sso_mapping.properties）」（2. 定義ファイル）を参照してください。

実行権限

JP1_Console_Admin

JP1_Console_Operator

APIのバージョン

v1

形式

リクエスト行

POST /application/component/apivVersion/updateSsoMap httpVersion

リクエストのメッセージボディー

なし。

パラメーター

なし。

ステータスコード

リクエストに対するレスポンスとして返却されるステータスコードを，次の表に示します。

ステータスコード

戻り値

メッセージ

説明

200

−

なし

シングルサインオンマッピング定義反映REST APIの処理が成功しました。

KAJY52031-W

シングルサインオンマッピング定義ファイルに有効な定義がありません。

403

7

KAJY01000-E

REST APIの実行権限がありません。

500

2

KAJY52022-E

シングルサインオンマッピング定義の排他に失敗しました。

13

KAJY52023-E

シングルサインオンマッピング定義の反映に失敗しました。

14

KAJY52026-E

シングルサインオンマッピング定義ファイルが正しく読み込めませんでした。

戻り値

戻り値の説明を次に示します。

戻り値

説明

2

排他失敗

7

実行権限エラー

13

更新エラー

14

定義ファイル読み込みエラー

255

システムエラー

注意事項

このAPIを同時に実行することはできません。実行した場合エラーとなります。

APIの実行時にエラーが発生した場合，エラーメッセージを統合トレースログへ出力します。APIのエラーのレスポンスの内容にエラーメッセージを含めて呼び出し元へ返却します。呼び出し元は受け取ったレスポンスの情報を使って，呼び出し元でメッセージの表示を行います。jddupdatessomapコマンドからREST APIが呼ばれた際に，エラーのレスポンスが返却された場合は，エラーの内容を標準エラー出力に出力します。jddupdatessomapコマンドについては「jddupdatessomap」（1. コマンド）を参照してください。

使用例

リクエスト：

POST http://hostname:20703/im/api/v1/updateSsoMap HTTP/1.1
Authorization: Bearer xxxx
Accept-Language: ja
Content-Type: application/json
Accept: application/json

警告終了時のレスポンス：

  {
  "messageList": [
    {
      "messageId": "KAJY52031-W",
      "message": "シングルサインオンマッピング定義ファイルに有効な定義がありません"
    }
  ]
}

5.15　配布のAPI

配布のAPIに関する操作を説明します。

5.15.1　配布物の取得（ファイルダウンロード）

機能

リクエスト行で指定した配布物（ファイル）をダウンロードします。

実行権限

なし※

注※

インテリジェント統合管理基盤へのログインに使用するログインAPIの実行権限は必要です。

APIのバージョン

なし

形式

リクエスト行

GET /download/配布物のディレクトリ名/配布物のファイル名 HTTP/1.1

リクエストヘッダー

ヘッダー名

設定値

Accept

指定しないでください。

指定しても，ダウンロードするファイルがzip形式の場合は「application/zip」，gz形式の場合は「application/x-gzip」が仮定されます。

ほかのリクエストヘッダーは，APIの共通仕様と同じです。APIの共通仕様のリクエストヘッダーについては，「5.2.3　リクエスト形式」の，リクエストヘッダーの説明を参照してください。

リクエストのメッセージボディー

なし

レスポンスのメッセージボディー

配布物のファイルの内容

パラメーター

リクエスト行に指定するパラメーターを次に示します。

項番

パラメーター

データ型

説明

1

配布物のディレクトリ名

string

配布物のディレクトリを必須で指定します。

存在しない配布物のディレクトリ名を指定した場合，配布物の取得に失敗します。

2

配布物のファイル名

string

配布物のディレクトリを必須で指定します。

存在しない配布物のファイル名を指定した場合，配布物の取得に失敗します。

ステータスコード

リクエストに対するレスポンスとして返却されるステータスコードを，次の表に示します

ステータスコード

HTTPステータスコードのフレーズ

説明

200

OK

APIの処理が成功しました。

403

Forbidden

認証していません，認証情報に誤りがあります。

404

Not Found

指定した配布物が存在していません，Windows環境の場合，配布物にアクセスできません。

ただし，Windows環境の場合，配布物のファイル自体にアクセス権限がない場合，エラーにならず，数分間の無応答のあと，通信を閉じます。

ステータスコードが200の場合，レスポンスのメッセージボディーに配布物のファイルの内容を返却します。

注意事項

JP1/IM - Manager（Linux）に格納する配布物（ファイル）の要件を，次に示します。

■配布物のファイル

ファイルとして扱えること

圧縮ファイルであること（配布先がLinux環境の場合：gz形式，配布先がWindows環境の場合：zip形式）

ファイル名は，下記の「■配布物のファイル名と格納先のディレクトリ名の命名規則」に従うこと

ファイルには，次に示す権限を付与すること

権限

オーナー

グループ

-r--r--r--

root

root

ファイルサイズの上限は，300MBです。

■配布物の格納先として作成するディレクトリ

次に示す格納場所に，同系の配布物を格納するディレクトリを作成し，作成したディレクトリに配布物を格納すること

格納場所

/opt/jp1imm/public/download

ディレクトリ名は，下記に示す「■配布物のファイル名と格納先のディレクトリ名の命名規則」に従うこと

ディレクトリには，次の権限を付与すること

権限

オーナー

グループ

drwxr-xr-x

root

root

■配布物のファイル名と格納先のディレクトリ名の命名規則

＜予約語＞

次に示す文字列で始まるファイル名およびディレクトリ名は，予約語です。大文字・小文字は区別しません。

hitachi_

jp1_

上記の予約語は，日立製品またはJP1製品（JP1/IM - Agentを含む）が提供する機能やサービスの範囲で，ファイルを配布する場合に使用します。それ以外のユーザー独自のファイルを配布する場合には使用できません。

＜使用できる文字＞

ファイル名およびディレクトリ名に使用できる文字を，次に示します。

半角英数字

-（ハイフン）

.（ピリオド）

_（アンダースコア）

■配布物のファイルパス（拡張子を含む）

235文字以下であること

ファイルパスに環境変数を使用する場合，環境変数を展開したあとの配布物のファイルパス（拡張子を含む）が235文字以下であること。

■配布物（配布製品）の提供元

配布物（配布製品）の提供元は，配布物のバージョン情報を確認する方法を提供すること

JP1/IM - Agentのバージョン情報は，バージョンファイル（Version.txt）で確認できます。

JP1/IM - Agentのバージョンファイルの格納先については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「付録A.4　JP1/IM - Agent」の「(3)統合エージェントホスト（Windows）」および「(4)統合エージェントホスト（Linux）」を参照してください。

使用例

リクエスト例

GET http://hostname:20703/download/im2-agent/xxx.zip

5.16　自動／手動対処アクションの実行のAPI

自動/手動対処アクションの実行のAPIに関する操作を説明します。

5.16.1　対処アクションの実行結果取得

機能

対処アクションの実行結果を取得します。

検索条件をパラメーターに設定した場合は，検索条件に一致した対処アクションの実行結果を取得します。

実行権限

次の権限が必要です。

filterにkey「execDetailEventSid」1件のみを指定する場合

JP1権限レベル：JP1_Console_Admin，JP1_Console_Operator，JP1_Console_User

その他の場合

JP1資源グループ：*

JP1権限レベル：JP1_Console_Admin，JP1_Console_Operator，JP1_Console_User

APIのバージョン

v1

形式

リクエスト行

POST  /application/component/apiVersion/responseActions/results httpVersion

リクエストのメッセージボディー

{
  "type":"処理内容",
  "direction":"対処アクション実行結果取得方向",
  "searchType":検索種別,
  "count":対処アクション実行結果の取得件数,
  "since":"検索開始位置の対処アクションSID",
  "lastDirection":"前回の検索処理で指定した対処アクション実行結果の検索方向"
  "dbInfo":[
    {"beginData":"検索開始位置の対処アクションSID",
      "endData":"検索終了位置の対処アクションSID",
      "since":"前回の検索処理で指定した検索開始位置の対処アクションSID"
    }
  ]
  "filter":[    //対処アクション結果検索フィルタ
    {"key":"検索キー","ope":"比較キーワード","val":["オペランド1",…]},
    …
  ]
}

レスポンスのメッセージボディー

{
  "actionResult":[  //対処アクション結果
    {
      "actionSid":"対処アクションSID",
      "executionHost":"実行先ホスト名",
      "actionName":"アクション名",
      "executionCommand":"実行コマンド",
      "actionStatus":"アクション状態",
      "targetSid":"実行対象SID",
      "executionDeal":"実行契機",
      "executionDetailInfo":"実行契機詳細情報",
      "actionType":"アクション種別",
      "actionAcceptTime":"対処アクション受付時刻",
      "actionSendTime":"対処アクション投入時刻",
      "actionEndTime":"対処アクション終了時刻",
      "executionResult":["実行結果"],
      "returnValue":"戻り値",
      "message":["メッセージ"]
    },
    …
  ],
  "beginData":"対処アクション実行結果検索開始位置の対処アクション結果情報",
  "endData":"対処アクション実行結果の検索終了位置の対処アクション結果情報",
  "dbInfo":"分散DB用対処アクション実行結果の次回検索情報",
  "messageList":[
    {
      "messageId":"メッセージID",
      "message":"メッセージ"
    },
    …
  ]
}

パラメーター

メッセージボディーに指定するパラメーターを次の表に示します。

メンバー名

データ型

省略可否

説明

type

string

不可

取得する対処アクションの実行結果を指定します。

list

対処アクションの結果一覧の情報を取得する

detail

対処アクションの結果詳細の情報を取得する

上記以外の値を指定した場合はエラーとなります。

direction

string

可

対処アクション実行結果の検索方向を指定します。

past

過去方向に検索する

future

未来方向に検索する

省略時は「past」を仮定します。

上記以外の値を指定した場合はエラーとなります。

searchType

int

不可

検索種別を指定します。

0：対処アクションSID指定

sinceに対象のSID，countに1を指定します。

1：最新ページ

2：新しいページ

3：更新

4：古いページ

5：最古ページ

上記以外を指定した場合はエラーとなります。

count

int

可

対処アクション実行結果の最大取得件数を1〜2000の範囲で指定します。

省略時は100を仮定します。

上記以外を指定した場合はエラーとなります。

since

string

可

対処アクション実行結果の検索開始位置を対処アクションSIDで指定します。

1,024バイト未満の文字列で指定し，それ以外は，エラーとなります。

指定した対処アクションSIDより未来または過去の対処アクション実行結果を検索します（指定した対処アクションSIDの対処アクション実行結果は検索対象に含みません。

ただし，countが1の場合は，指定した対処アクションSIDを検索対象とします）。

省略時は，directionの指定に従い，対処アクション結果管理DBの先頭または末尾から検索を開始します。

設定方法については，下記の「■取得対象に対するsinceとdirectionの設定方法について」を参照してください。

lastDirection

string

可

前回の検索処理で指定した対処アクション実行結果の検索方向を指定します。

過去方向の場合は「past」，未来方向の場合は「future」を指定します。

searchTypeが2または4の場合は必須で指定します。

上記以外を設定した場合はエラーとなります。

dbInfo

object[]

可

対処アクションの実行制御にある対処アクション結果管理DBの対処アクション結果の検索開始位置，終了位置を指定するオブジェクトです。

初回，先頭（最新）からの検索の場合，省略できます。

次回以降は，前回の「戻り値」で返却された「dbInfo」の内容をそのまま指定します。

設定方法については，下記の「■取得対象に対するsinceとdirectionの設定方法について」を参照してください。

beginData

string

可

対処アクション実行結果の検索開始位置の対処アクションSIDを指定します。

1,024バイト未満の文字列で指定し，それ以外は，エラーとなります。

endData

string

可

対処アクション実行結果の検索終了位置の対処アクションSIDです 。

1,024バイト未満の文字列で指定し，それ以外は，エラーとなります。

since

string

可

前回の検索種別に1，2，4，5を指定したときの検索開始位置の対処アクションSIDです。

1,024バイト未満の文字列で設定し，それ以外はエラーとなります。

filter

object[]

可

対処アクションの実行結果取得のフィルターを指定するオブジェクトです。

詳細については，下記の「■対処アクション結果検索フィルターについて」を参照してください。

■取得対象に対するsinceとdirectionの設定方法について

取得対象

searchType

since

direction

その他の設定

最新ページ（初回）

1

空文字（省略可）

past

なし

最古ページ

5

空文字（省略可）

future

なし

1つ新しいページに遷移する場合

2

前回検索時のレスポンスのactionResultデータから最も新しい（配列の並びで最後）actionSidを設定します。

future

dbInfo，lastDirectionは必須です。

1つ古いページに遷移する場合

4

前回検索時のレスポンスのactionResultデータから最も古い（配列の並びで最初）actionSidを設定します。

past

dbInfo，lastDirectionは必須です。

更新（再表示）

3

前回検索時のパラメーターのsinceと同じ値を設定します。

前回検索時のパラメーターのdirectionと同じ値を設定します。

dbInfoは必須です。

lastDirectionは省略可です。

対処アクションSID指定で詳細情報取得

0

取得したい対処アクションSIDを設定します。

past/future

countに1，

typeにdetailを設定します。

lastDirectionは省略可です。

注　上記の設定内容が不正な場合は，正しい結果が取得できないことがあります。その場合は，最新ページ（初回）の取得から再度実行します。

■対処アクション結果検索フィルターについて

パラメーターの指定方法について以下に示します。

{
"key":"検索キー","ope":"比較キーワード","val":["オペランド1","オペランド2",…]
}

表5‒14　指定できる属性名と比較キーワードの組み合わせ

検索キー

（設定する値）

データ型

比較

キーワード

オペランド

対処アクションSID

（actionSid）

string

完全一致

（MATCH）

正規表現

（REGEX）

対処アクションSIDを指定します。

1〜4,096バイトの範囲で，最大100件まで指定できます。それ以外はエラーとなります。

また，正規表現を指定した場合，複数指定できません。複数指定したときはエラーとなります。

実行先ホスト名

（executionHost）

string

完全一致

（MATCH）

正規表現

（REGEX）

対処アクションを実行するホスト名を指定します。

1〜4,096バイトの範囲で，最大100件まで指定できます。それ以外はエラーとなります。

また，正規表現を指定した場合，複数指定できません。複数指定した場合はエラーとなります。

アクション状態

（actionStatus）

string

完全一致

（MATCH）

対処アクションの状態を指定します。複数指定できます。

指定できる値を次に示します。

send（実行先送信中）

queue（キューイング）

running（実行中）

ended（終了）

unknown（状態不明）

none（なし）

fail（実行不可）

senderror（通信失敗）

error（実行失敗）

上記以外の値を指定した場合はエラーとなります。

アクション名

（actionName）

string

完全一致

（MATCH）

正規表現

（REGEX）

対処アクションのアクション名を指定します。

1〜4,096バイトの範囲で，最大100件まで指定できます。それ以外はエラーとなります。

制御文字（0x00〜0x1F，0x7F〜0x9F）以外の文字を指定できます。

また，正規表現を指定した場合，複数指定できません。複数指定した場合はエラーとなります。

実行契機詳細情報

−

−

対処アクションの実行契機を指定します。

自動対処アクションの場合は，JP1イベントのSID，手動対処アクションの場合は，手動実行要求を行ったJP1ユーザー名を指定します。

JP1イベントのSID（execDetailEventSid）

string

完全一致

（MATCH）

JP1イベントのSIDを指定します。

1〜4096バイトの範囲で，最大100件まで指定できます。それ以外はエラーとなります。

JP1ユーザー名（execDetailUserName）

string

完全一致

（MATCH）

正規表現

（REGEX）

JP1ユーザー名を指定します。

1〜4,096バイトの範囲で，最大100件まで指定できます。それ以外はエラーとします。

また，正規表現を指定した場合，複数指定できません。複数指定した場合はエラーとなります。

対処アクション受付時刻

（actionAcceptTime）

string

日時指定

（TRANGE）

対処アクション実行制御が対処アクションの実行要求を受け付けた時刻を指定します。

入力形式は，ISO 8601の拡張形式（YYYY-MM-DDThh:mm:ssTZD）とし，それ以外はエラーとなります。開始日時，終了日時の順に指定します。

開始日時を入力しなかった場合は，終了日時より前の日時の情報をすべて取得します。

終了日時を入力しなかった場合は，開始日時から後の日時の情報をすべて取得します。

戻り値

（returnValue）

string

完全一致

（MATCH）

正規表現

（REGEX）

実行結果の戻り値を指定します。

1〜4,096バイトの範囲で，最大100件まで指定できます。それ以外はエラーとなります。

また，正規表現を指定した場合，複数指定できません。複数指定した場合はエラーとなります。

■正規表現ついて

対処アクション結果検索フィルターで使用する正規表現を次に示します。

Windowsの場合：拡張正規表現（XPG4準拠）

Linuxの場合：拡張正規表現（POSIX1003.2）

ステータスコード

リクエストのレスポンスで返却されるステータスコードを次の表に示します。

ステータスコード

メッセージID

説明

200

−

−

200

KAJY63041-W

対処アクション実行結果取得先の対処アクション実行制御との通信ができないため，一部の実行結果が取得できません。

200

KAJY63042-W

対処アクション実行結果取得先の対処アクション実行制御からエラーが返却され，一部の実行結果が取得できません。

400

KAJY63302-E

REST APIのパラメーターの指定が不正です。

＜要因＞

省略できないパラメーターが省略されています

設定できない値を設定しています

文字数制限オーバーです

指定できる件数の最大数をオーバーしています

検索キーが重複しています

400

KAJY63303-E

リクエストメッセージボディーのJSONフォーマットが不正です。

403

KAJY01000-E

REST APIの実行権限がありません。

500

KAJY63040-E

システム構成情報から実行先が取得できません（システム構成上に実行要求先ホストの管理ノードがありません）。

システム構成情報から実行先が取得できません（実行要求先ホストを管理している統合エージェント管理基盤が取得できませんでした）。

500

KAJY63039-E

システム構成情報にアクセスできません。

500

KAJY63333-E

REST API処理で想定外のエラーが発生しました。

500

KAJY00007-E

システムエラーが発生しました（ディスク不足，メモリー不足など）。

戻り値

ステータスコードが200の場合

レスポンスのメッセージボディーに，次の表に示す情報を返却します。

リクエストパラメーターのtypeに指定した値によって返却される情報が異なります。

メンバー名

データ型

typeの値

説明

list

detail

actionResult

object[]

○

○

対処アクション結果のオブジェクトです。リクエストパラメーターのtypeで指定した値によって返却されるメンバーが異なります。

actionSid

string

○

○

対処アクションSIDを返却します。

executionHost

string

○

○

実行先ホストを返却します。

アクション種別がcmdの場合

実行先の統合エージェント制御基盤のホスト名

アクション種別がcmd以外の場合

対処アクション実行制御のホスト名

actionName

string

○

○

アクション名を返却します。

executionCommand

object

○

○

実行コマンドを返却します。返却するオブジェクトはアクション種別によって異なります。

アクション種別がcmdの場合

下記の「■アクション種別がcmdの場合」の表を参照してください。

アクション種別がrestapiの場合

下記の「■アクション種別がrestapiの場合」の表を参照してください。

アクション種別がeventstatusの場合

下記の「■アクション種別がeventstatusの場合」の表を参照してください。

actionStatus

string

○

○

対処アクションの状態を返却します。

targetSid

string

○

○

対処アクションを実行するシステム（統合エージェント制御基盤，またはJP1/IM - Manager）の構成情報のSIDを返却します。

executionDeal

string

○

○

対処アクションが実行された契機を返却します。

executionDetailInfo

string

○

○

対処アクションが実行された契機の詳細情報を返却します。

自動対処アクション（JP1イベント契機）の場合

JP1イベントのSID

手動対処アクションの場合

実行要求を行ったJP1ユーザー名

actionType

string

○

○

実行される対処アクションの種別を返却します。

返却する値を次に示します。

cmd

restapi

eventstatus

actionAcceptTime

string

○

○

対処アクション実行制御が対処アクションの実行要求を受け付けた時刻を返却します。

actionSendTime

string

○

○

対処アクション実行制御が対処アクションの実行要求を送信した時刻を返却します。

actionEndTime

string

○

○

対処アクションの実行が完了した時刻を返却します。

executionResult

string[]

×

○

実行結果を返却します。

アクション種別がcmdの場合

コマンドの標準出力，標準エラー出力

アクション種別がrestapiの場合

REST APIのレスポンスボディー

アクション種別がeventstatusの場合

イベント対処状況変更メソッドのリターンオブジェクト

returnValue

string

○

○

実行結果の戻り値を返却します。

アクション種別がcmdの場合

コマンドの戻り値

アクション種別がrestapiの場合

REST APIのステータスコード

アクション種別がeventstatusの場合

イベント対処状況変更が成功した場合0，失敗した場合1

message

string[]

×

○

対処アクション実行制御が出力したメッセージです。

beginData

string

○

○

対処アクション実行結果の検索開始位置の次の対処アクションSIDを返却します。

検索開始位置の次の対処アクションSIDが存在しない場合は省略します。

endData

string

○

○

対処アクション実行結果の検索終了位置の次の対処アクションSIDを返却します。

検索終了位置の次の対処アクションSIDが存在しない場合は省略します。

dbInfo

object[]

○

○

分散DBの対処アクション結果の検索開始位置，終了位置を返却するオブジェクトです。

beginData

string

○

○

対処アクション実行結果の検索開始位置の対処アクションSIDを返却します。検索対象となる対処アクション実行結果が一つも存在しない場合は省略します。

endData

string

○

○

対処アクション実行結果の検索終了位置の対処アクションSIDを返却します。検索対象となる対処アクション実行結果が一つも存在しない場合は省略します。

since

string

○

○

前回検索種別に1，2，4，5を指定した時の検索開始位置の対処アクションSIDを返却します。

messageList

object[]

○

○

処理中に発生した続行可能なワーニングのメッセージがある場合にのみ返却します。

messsageId

string

○

○

メッセージIDを返却します。

message

string

○

○

メッセージを返却します。

（凡例）

○：該当するメンバーの情報が返却される

×：該当するメンバーの情報が返却されない

■アクション種別がcmdの場合

メンバー名

データ型

説明

cmd

string

コマンド名を返却します。

envFile

string

環境変数ファイル名とパスを返却します。

■アクション種別がrestapiの場合

メンバー名

データ型

説明

method

string

REST APIのメソッドを返却します。

url

string

REST APIのURLを返却します。

headers

object

REST APIのリクエストヘッダーを返却します。

body

string

REST APIのリクエストボディーを返却します。リクエストボディーが不要な場合は省略します。

■アクション種別がeventstatusの場合

メンバー名

データ型

説明

dealt

string

対処状況を返却します。

eventSid

string

JP1イベントのSIDを返却します。

ステータスコードが200以外の場合

レスポンスのメッセージボディーに，「5.2.6 エラー発生時のレスポンスメッセージ」に記載されているレスポンス形式の例外オブジェクトが返却されます。ただし，「returnCode」の項目は省略されます。

ワーニングが発生していたときは，「extensions」（拡張情報）の項目に，ステータスコードが200の場合と同様のワーニング情報を付与したものが，リクエスト元に返却されます。

使用例

リクエスト：

検索条件をパラメーターとして設定して，対処アクション結果一覧の情報を取得する場合のAPIの使用例を次に示します。

POST http://hostname:20703/im/api/v1/responseActions/results HTTP/1.1
content-type: application/json
・・・（省略）・・・
{
  "type":"list",
  "direction":"past",
  "searchType":1,
  "count":100,
  "filter":[
    {"key":"actionStatus","ope":"MATCH","val":["running","ended"]},
    {"key":"executionHost","ope":"MATCH","val":["HOST185"]},
    {"key":"actionAcceptTime","ope":"TRANGE","val":["2023-10-25T12:00:00+09:00", "2023-10-30T12:00:00+09:00"]}
  ]
}

レスポンス：

HTTP/1.1 200
content-type: application/json
・・・（省略）・・・
{
  "actionResult": [
    {
      "actionSid":"_JP1IMACTID_20f916e2-10d7/_JP1IMMHOST_ HOST185//",
      "executionHost": "HOST185",
      "actionName": "act002",
      "actionType": "eventstatus",
      "executionCommand": {
        "dealt": 3,
        "eventSid":"_JP1IM_HOST185/_JP1IMSEQNO_8/_JP1IMEVBSEQNO_401"
      },
      "actionStatus": "ended",
      "targetSid": "_JP1IM_HOST185/_HOST_HOST185",
      "executionDeal": "manual",
      "executionDetailInfo": "jp1admin",
      "actionAcceptTime": "2023-10-27T15:26:50+09:00",
      "actionSendTime": "2023-10-27T15:26:50+09:00",
      "actionEndTime": "2023-10-27T15:26:50+09:00",
      "returnValue": "0",
      "executionResult": null,
      "message": null
    },
    ・・・（省略）・・・
  ],
  "beginData":"",
  "endData":"_JP1IMACTID_25e566fa-c54a/_JP1IMMHOST_ HOST185//",
  "dbInfo":[
    {"beginData":"_JP1IMACTID_d9947fe1-23a5/_JP1IMMHOST_ HOST185//",
     "endData":"_JP1IMACTID_20f916e2-10d7/_JP1IMMHOST_ HOST185//",
     "since":"",
    },
    ・・・（省略）・・・
  ]
}

5.16.2　対処アクションの手動実行

機能

対処アクションの手動実行の操作を行います。

次に示すアクション種別のコマンドを実行できます。

コマンドの実行

REST APIの実行

対処状況の更新

実行権限

JP1_Console_Admin

JP1_Console_Operator

APIのバージョン

v1

形式

リクエスト行

POST /application/component/apiVersion/responseActions/manualExec httpVersion

リクエストのメッセージボディー

{
    "actionType":"アクション種別",
    "actionName":"対処アクションの名称",
    "params":{"対処アクションのパラメーター"}
}

対処アクションのパラメーター

アクション種別が「リモートコマンド（cmd）」の場合

    "params":{
        "host":"実行ホスト名",
        "cmd":"実行コマンド",
        "envFile":"環境変数ファイル"
    }

アクション種別が「REST API（restapi）」の場合

    "params":{
        "method":"REST APIのメソッド",
        "url":"REST APIのURL",
        "headers":"REST APIのリクエストヘッダー",
        "body":"REST APIのリクエストのボディー"
    }

アクション種別が「対処状況の更新（eventstatus）の場合

    "params":{
        "dealt":対処状況,
        "eventSid":"JP1イベントのSID,・・・"
    }

レスポンスのメッセージボディー

{
  "actionSid":"対処アクションSID",
  "warning":[
    {
      "messageId":"ワーニング発生時のメッセージID",
      "message":"ワーニング発生時のメッセージ"
    },
　：
  ]
}

パラメーター

メッセージボディーに指定するパラメーターを次の表に示します。

メンバー名

データ型

省略

説明

actionType

string

不可

対処アクションの種別を指定します。

次のどれかの値を指定できます。それ以外の値を指定した場合はエラーになります。

cmd

リモートコマンドを実行する

restapi

REST APIを実行する

eventstatus

イベントの対処状況の更新を実行する

actionName

string

可

対処アクション名称を指定します。

次の値が指定できます。それ以外の値を指定した場合はエラーになります。

1〜50バイト

制御文字「アスキーコードで0x00〜0x1F，0x7F〜0x9F」を除くすべての文字

params

object

不可

対処アクション内容を指定します。

対処アクションの種別に応じて，指定するパラメーターが異なります。

cmdの場合

下記の「リモートコマンド（cmd）の場合」の表を参照してください。

restapiの場合

下記の「REST API（restapi）の場合」の表を参照してください。

eventstatusの場合

下記の「イベントの対処状況の更新（eventstatus）の場合」の表を参照してください。

リモートコマンド（cmd）の場合

メンバー名

データ型

省略可否

説明

host

string

不可

実行先ホスト名を指定します。255バイト以下で指定してください。それ以外はエラーになります。

cmd

string

不可

実行するOSコマンドと引数を指定します。4,096バイト以下で指定してください。それ以外はエラーになります。

envFile

string

可

コマンド実行時に読み込む環境変数を記載した，実行先ホストにあるファイルのファイルパスを絶対パスで指定します。255バイト以下で指定してください。それ以外はエラーになります。

REST API（restapi）の場合

メンバー名

データ型

省略可否

説明

method

string

不可

実行するREST APIのメソッドを指定します。下記のメソッドを指定できます。それ以外はエラーになります。

GET

HEAD

POST

PUT

PATCH

DELETE

OPTIONS

TRACE

url

string

不可

実行するREST APIのURLを指定します。指定できる値は次のとおりです。それ以外はエラーになります。

2,046バイト以下で指定してください。

使用できる文字は，RFC2396に準拠した半角英数字と次の記号です。

「;」，「/」，「?」，「:」，「@」，「&」，「=」，「+」，「$」，「,」，「-」，「_」，「.」，「!」，「~」，「*」，「'」，「(」，「)」，「%」

先頭には「http://」または「https://」を指定してください。

headers

object

不可

実行するREST APIのヘッダーを指定します。65,536バイト以下で指定してください。それ以外はエラーになります。

body

string

可

実行するREST APIのボディーを指定します。ボディーが不要な場合は省略します。指定する場合は，10MB未満で指定してください。それ以外はエラーになります。

イベントの対処状況の更新（eventstatus）の場合

メンバー名

データ型

省略可否

説明

dealt

string

不可

対処状況の値を指定します。下記の値を指定できます。それ以外はエラーになります。

0：未対処

1：対処済

2：処理中

3：保留

eventSid

string

不可

JP1イベントのSIDを指定します。複数のイベントSIDを指定する場合は，イベントSIDを「,」で連結します。

件数は2,000件まで指定できます。それ以上はエラーになります。

バイト数は1MB未満で指定してください。それ以上はエラーになります。

ステータスコード

リクエストに対するレスポンスとして返却されるステータスコードを，次の表に示します。

ステータスコード

メッセージ

説明

200

−

−

400

KAJY64004-E

対処アクションの実行要求の内容が不正です。

＜要因＞

設定できない値を設定しています

文字数制限オーバーです

省略できないパラメーターが省略されています

400

KAJY63321-E

リクエストメッセージボディーのJSONフォーマットが不正です。

403

KAJY01000-E

REST APIの実行権限がありません。

500

KAJY63333-E

REST API処理で想定外のエラーが発生しました。

500

KAJY64003-E

送信先の対処アクション実行制御からエラーが返却されました。

＜要因＞

対処アクションの実行に失敗した

500

KAJY64001-E

システム構成情報から実行先が取得できません（システム構成上に実行要求先ホストの管理ノードがありません）。

システム構成情報から実行先が取得できません（実行要求先ホストを管理している統合エージェント管理基盤が取得できませんでした）。

500

KAJY64000-E

システム構成情報にアクセスできません。

500

KAJY64002-E

送信先の対処アクション実行制御との通信ができない。

＜要因＞

対処アクション実行制御との通信に失敗した

500

KAJY00007-E

システムエラーが発生しました（ディスク不足，メモリー不足など）。

■ワーニングについて

実行不可アクションデータテーブルから情報の取得に失敗した場合，次のメッセージIDを出力します。出力先は，正常時はレスポンスのwarningオブジェクト，エラー時は拡張情報（extensions）のwarningオブジェクトです。

メッセージID

説明

KAJY63309-W

対処アクション結果管理DBとの通信ができない。

＜要因＞

DBへの接続に失敗した

KAJY63310-W

対処アクション結果管理DBで書き込みエラーが発生した。

＜要因＞

DBの読み込みの操作に失敗した

戻り値

ステータスコードが200の場合

対処アクションの実行要求APIから返却されたレスポンスにワーニング情報が付与されていた場合，次の表に示すワーニング情報をこのREST APIのレスポンスに付与してリクエスト元に返却します。

返却する情報については，上記の「■ワーニングについて」を参照してください。

メンバー名

データ型

説明

actionSid

string

対処アクション結果管理DB内で一意の対処アクションSIDを返却します。

warning

object[]

ワーニングメッセージのオブジェクトです。

messageId

string

発生したワーニングのメッセージIDを返却します。

message

string

発生したワーニングのメッセージを返却します。

ステータスコードが200以外の場合

レスポンスのメッセージボディーに，「5.2.6 エラー発生時のレスポンスメッセージ」に記載されているレスポンス形式の例外オブジェクトが返却されます。ただし，「returnCode」の項目は省略されます。

対処アクションの実行要求APIから返却されたレスポンスにワーニング情報が付与されていた場合は，次の表に示すワーニング情報をエラー時のレスポンスのメッセージボディの「extensions」（拡張情報）の項目に付与して，リクエスト元に返却されます。

メンバー名

データ型

説明

extensions

object[]

拡張情報のオブジェクトです。発生したワーニング情報を設定します。

messageId

string

発生したワーニングのメッセージIDを返却します。

message

string

発生したワーニングのメッセージを返却します。

使用例

リクエスト：

コマンドを実行をする場合のAPIの使用例を，次に示します。

POST http://hostname:20703/im/api/v1/responseActions/manualExec HTTP/1.1
content-type: application/json
・・・省略・・・
{
  "actionType":"cmd",
  "actionName":"act001",
  "params":{
    "host":"HOST185",
    "cmd":"dir"
  }
}

JP1イベントの情報を使用してREST APIを実行をする場合のAPIの使用例を，次に示します。

POST http://hostname:20703/im/api/v1/responseActions/manualExec HTTP/1.1
content-type: application/json
・・・省略・・・
{
  "actionType":"restapi",
  "actionName":"act001",
  "params":{
    "method":"GET",
    "url":"http://hostname:20703/im/api/version",
    "headers":"{}"
  }
}

イベントの対処状況を「対処済」に変更する場合のAPIの使用例を，次に示します。

POST http://hostname:20703/im/api/v1/responseActions/manualExec HTTP/1.1
content-type: application/json
・・・省略・・・
{
  "actionType":"eventstatus",
  "actionName":"act001",
  "params": {
    "dealt":1,
    "eventSid":"_JP1IM_HOST185/_JP1IMSEQNO_8/_JP1IMEVBSEQNO_401"
  }
}

レスポンス：

HTTP/1.1 200 OK
content-type: application/json
・・・省略・・・
{
  "actionSid": "_JP1IMACTID_cb82bd6d-6409/_JP1IMMHOST_HOST185//"
}

5.16.3　イベント引き継ぎ情報変換

機能

イベント引き継ぎ情報を変換します。

実行権限

JP1_Console_Admin

JP1_Console_Operator

APIのバージョン

v1

形式

リクエスト行

POST /application/component/apiVersion/responseActions/eventsReplace httpVersion

リクエストのメッセージボディー

{
  "eventSid":"JP1イベントのSID",
  "actionType":"アクション種別",
  "params":{"対処アクションのパラメーター"}
}

レスポンスのメッセージボディー

{
"params":{"対処アクションのパラメーター"},
"results":{"対処アクションのパラメーターの変換結果"}
}

■対処アクションのパラメーター

アクション種別が「リモートコマンド（cmd）」の場合

    "params":{
        "host":"実行ホスト名",
        "cmd":"実行コマンド",
        "envFile":"環境変数ファイル"
    }

アクション種別が「REST API（restapi）」の場合

    "params":{
        "method":"REST APIのメソッド",
        "url":"REST APIのURL",
        "headers":"REST APIのリクエストヘッダー",
        "body":"REST APIのリクエストのボディー"
    }

アクション種別が「イベントの対処状況の更新（eventstatus）」の場合

    "params":{
        "dealt":対処状況,
        "eventSid":"JP1イベントのSID,..."
    }

アクション種別が「指定したURLのページを表示・ジャンプ（jump）」の場合

    "params":{
        "url":"ジャンプ先のURL",
        "target":"HTMLのターゲット属性"
    }

パラメーター

メッセージボディーに指定するパラメーターを次に示します。

メンバー名

データ型

省略可否

説明

eventSid

string

不可

詳細情報を取得したいJP1イベントのSIDを指定します。JP1イベントSIDの詳細については，「7.2.1(1)　イベント情報オブジェクト」を参照してください。1〜512バイトの範囲で指定してください。それ以外はエラーになります。

actionType

string

不可

対処アクションの種別を指定します。

次のどれかの値を指定できます。それ以外の値を指定した場合はエラーになります。

cmd

リモートコマンドを実行する

restapi

REST APIを実行する

eventstatus

イベントの対処状況の更新を実行する

jump

指定したURLのページを表示・ジャンプする

params

object

不可

対処アクション内容を指定します。

対処アクションの種別に応じて，指定するパラメーターが異なります。

cmdの場合

下記の「リモートコマンド（cmd）の場合」の表を参照してください。

restapiの場合

下記の「REST API（restapi）の場合」の表を参照してください。

eventstatusの場合

下記の「イベントの対処状況の更新（eventstatus）の場合」の表を参照してください。

jumpの場合

下記の表「指定したURLのページを表示・ジャンプ（jump）の場合」を参照してください。

リモートコマンド（cmd）の場合

メンバー名

データ型

省略可否

説明

host

string

不可

実行先ホスト名を指定します。1〜255バイトの範囲で指定してください。それ以外はエラーになります。

cmd

string

不可

実行するOSコマンドと引数を指定します。1〜4,096バイトの範囲で指定してください。それ以外はエラーになります。

envFile

string

可

コマンド実行時に読み込む環境変数を記載した，実行先ホストにあるファイルのファイルパスを絶対パスで指定します。1〜255バイトの範囲で指定してください。それ以外はエラーになります。

REST API（restapi）の場合

メンバー名

データ型

省略可否

説明

method

string

不可

実行するREST APIのメソッドを指定します。7バイト以下で指定してください。それ以外はエラーになります。

url

string

不可

実行するREST APIのURLを指定します。1〜2,046バイトの範囲で指定してください。それ以外はエラーになります。

headers

object

不可

実行するREST APIのヘッダーを指定します。1〜65,536バイトの範囲で指定してください。それ以外はエラーになります。

body

string

可

実行するREST APIのボディーを指定します。ボディーが不要な場合は省略します。指定する場合は，1〜10MB未満の範囲で指定してください。それ以外はエラーになります。

イベントの対処状況の更新（eventstatus）の場合

メンバー名

データ型

省略可否

説明

dealt

int

不可

対処状況の値を指定します。0〜3の範囲で指定してください。それ以外はエラーになります。

eventSid

string

不可

JP1イベントのSIDを指定します。複数のイベントSIDを指定する場合はイベントSIDを「,」で連結し，2,000件まで指定できます。

1〜1MB未満の範囲で指定してください。それ以外はエラーになります。

指定したURLのページの表示・ジャンプ（jump）の場合

メンバー名

データ型

省略可否

説明

url

string

不可

ジャンプ先のURLを指定します。1〜2,046バイトの範囲で指定してください。それ以外はエラーになります。

target

string

可

ターゲット属性を指定します。1〜64バイトの範囲で指定してください。それ以外はエラーになります。

ステータスコード

レスポンスで返却するステータスコードを次に示します。メッセージの詳細については，マニュアル「JP1/Integrated Management 3 - Manager メッセージ」を参照してください。

ステータスコード

メッセージ

説明

200

−

−

403

KAJY01000-E

REST APIの実行権限がありません。

400

KAJY63328-E

REST APIのパラメーターの指定が不正です。省略できないパラメーターが省略されていることが要因です。

400

KAJY63329-E

リクエストメッセージボディーのJSONフォーマットが不正です。

400

KAJY63330-E

イベント引き継ぎ情報変換処理を行った結果，指定可能なバイト数の上限を超えました。

500

KAJY63332-E

イベント詳細情報取得APIからのレスポンスでエラーが返却されました。

500

KAJY63333-E

REST API処理で想定外のエラーが発生しました。

500

KAJY00007-E

システムエラーが発生しました（ディスク不足，メモリー不足など）。

戻り値

レスポンスで返却するパラメーターを次に示します。

メンバー名

データ型

説明

params

object

イベント引き継ぎ情報変換処理後のパラメーターを返却します。パラメーターの「params」と同じ形式で返却します。パラメーターの詳細については，パラメーターの表の「params」を参照してください。

results

object

上記の「params」のパラメーターに対応する，イベント引き継ぎ情報変換結果を返却します。省略されたパラメーターについては返却しません。このパラメーターが返却する値は次の通りです。

0

正常終了です。

1

変数の変換によって，上限値を超過しました。

2

変数に該当する属性が存在しません。

3

変数に該当する属性の属性値が空文字です。

4

変数に対するエンコーディング指定形式が不正です。

エラー時のレスポンスは，「5.2.6　エラー発生時のレスポンスメッセージ」に記載されているフォーマットですが，「returnCode」は省略されます。拡張情報「extensions」は，レスポンスと同一のパラメーターを付与します。ただし，イベント引き継ぎ情報変換処理前にエラー処理が発生した場合は省略します。

■拡張情報（extensions）のパラメーター

{
  "timestamp":1539923958358,
  "status":400,
  ・・・途中省略・・・
  "extensions":{
    "params":{"対処アクションのパラメーター"},
    "results":{"対処アクションのパラメーターの変換結果"}
  }
}

使用例

コマンドを実行する場合の例を次に示します。

リクエスト：

POST http://hostname:20703/im/api/v1/responseActions/eventsReplace HTTP/1.1
content-type: application/json
・・・省略・・・
{
  "eventSid":"_JP1IM_HOST185/_JP1IMSEQNO_8/_JP1IMEVBSEQNO_401",
  "actionType":"cmd",
  "params":{
    "host":"${event:EVHOST:}",
    "cmd":"dir",
    "envFile":"C:¥¥tmp¥¥envFile.txt"
  }
}

レスポンス：

HTTP/1.1 200 OK
content-type: application/json
・・・省略・・・
{
  "params": {
    "host": "HOST185",
    "cmd": "dir",
    "envFile": "C:¥¥tmp¥¥envFile.txt"
  },
  "results": {
  "host": 0,
  "cmd": 0,
  "envFile": 0
  }
}

5.17　定義ファイル操作のAPI

5.17.1　定義ファイル一覧取得

機能

JP1/IM - ManagerまたはJP1/IM - Agentの定義ファイルの一覧を取得します。

実行権限

次の権限が必要です。

hostCategoryに「Manager」を指定する場合

JP1資源グループ：*

JP1権限レベル：JP1_Console_Admin

hostCategoryに「Agent」を指定する場合

JP1権限レベル：JP1_Console_Admin

APIのバージョン

v1

形式

リクエスト行

POST /application/component/apiVersion/fileOperation/getFileList httpVersion

リクエストのヘッダー

「5.2.3　リクエスト形式」のリクエストヘッダーに従います。

リクエストのメッセージボディー

リクエストのメッセージボディーは，JSONフォーマットで送信できます。

[
  "hostCategory":"ホスト種別",
  "managerHostName":"定義ファイル一覧取得先Agentホスト管理先Mangerホスト名",
  "agentHostName":"定義ファイル一覧取得先Agentホスト名"
]

パラメーター

リクエストのメッセージボディーに指定するパラメーターを次に示します。

パラメーター

省略可否

説明

hostCategory

不可

ホスト種別として「Manager」または「Agent」を指定します。指定したホスト種別の定義ファイルに対して操作を行います。

managerHostName

「説明」欄を参照

hostCategoryが「Manager」の場合

指定項目を無視します。自ホストをJP1/IMのマネージャーホストと仮定し，JP1/IMのマネージャーホストの定義ファイルの一覧を取得します。

hostCategoryが「Agent」の場合

定義ファイル一覧取得先のエージェントを管理しているJP1/IMのマネージャーホスト名を1〜255バイトで指定します。

agentHostName

「説明」欄を参照

hostCategoryが「Manager」の場合

指定項目を無視します。

hostCategoryが「Agent」の場合

定義ファイル一覧取得先のエージェントホスト名を1〜255バイトで指定します。

ステータスコード

リクエストに対するレスポンスとして返却されるステータスコードを，次の表に示します。

ステータスコード

出力されるメッセージ

説明

200

−

APIの処理が成功しました。

KAJY02058-W

ユーザー作成定義ファイルリスト定義ファイルのフォーマット不正です。

KAJY68102-W

ユーザー作成定義ファイルリスト定義ファイルに記載のファイルが存在しません。製品提供の定義ファイルが存在しません。

KAJY68103-W

ファイル名またはファイルパスの長さが上限を超えています。

必須の設定がありません。

カテゴリ名が不正です（文字列の長さが上限を超えています，または，「jp1_」から始まっています）。

定義反映のための操作の文字列の長さが上限を超えています。

ユーザー作成定義ファイルリスト定義ファイルに定義できないファイルが指定されています。

KAJY68126-W

統合エージェント制御基盤でワーニングが発生しました。

400

KAJY68101-E

リクエストパラメーターが不正です。

KAJY68205-E

リクエストに指定した統合エージェントホスト名がJP1/IM - Managerが管理する構成に存在しません

ログインユーザーにリクエストに指定した統合エージェントの参照・操作権限がありません

リクエストに指定した統合エージェントまたはマネージャーホストの情報が統合エージェントホスト管理DBにありません

403

KAJY01000-E

認証に使用したユーザーの権限が不足しています。

500

KAJY68104-E

統合エージェント制御基盤でエラーが発生しました。

KAJY00007-E

システムエラーが発生しました（ディスク不足，メモリー不足など）。

KAJY68203-E

インテリジェント統合管理基盤に接続できません。

KAJY68212-E

統合エージェント制御基盤に接続できません。

KAJY68501-E

マネージャーの統合エージェントホスト管理DBに接続できません。

戻り値

ステータスコードが200の場合

レスポンスのメッセージボディーに，「7.2.4(1)　自動対処アクション定義オブジェクト」に記載されている自動対処アクション定義オブジェクトが返却されます。

データの形式については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「3.6.5(1) 定義ファイルの一覧取得機能」を参照してください。JP1/IM - Agentと仕様が異なる部分を次に示します。

メンバー名

説明

errfilelist:message

エラーメッセージのメッセージIDとメッセージ本文を記載します。成功した場合は省略します。

KAJY68102-W，KAJY68103-Wのメッセージを設定します。

message:errmessage

エラーメッセージのメッセージIDとメッセージ本文を記載します。成功した場合はmessageの項目を省略します。KAJY02058-Wのメッセージを設定します。

ステータスコードが200以外の場合

レスポンスのメッセージボディーに，「5.2.6 エラー発生時のレスポンスメッセージ」に記載されているレスポンス形式の例外オブジェクトが返却されます。

使用例

リクエスト：

POST http://hostname:20703/im/api/v1/fileOperation/getFileList  HTTP/1.1
Authorization:Bearer anAxYWRtaW46TUdGa01tTTJNMlV3TURFNFh6STNYekE0T2pJME9qTXpYMTlmWDE5ZlgxOWZYMTlmWDE5ZlgycHdNV0ZrYldsdUlDQWdJQ0FnSUNBZ0lDQWdJQ0FnSUNBZ0lDQWdJQ0Fn
Accept-Language: ja
Content-Type: application/json
Content-Length: 1024000
Accept: application/json
{
  "hostCategory":"Agent",
  "managerHostName":"immanager",
  "agentHostName":"imagent"
}

レスポンス：

HTTP/1.1 200 OK
Content-Type:application/json
・・・省略・・・

{
  "filelist":[
    {
      "filename": "jpc_alertmanager.yml",
      "filepath": "C:¥¥Program Files¥¥Hitachi¥¥jp1ima¥¥conf",
      "filecategoryID": "jp1_imagent",
      "filecategoryName": "jp1_imagent",
      "updatetime": "2023-07-21T10:23+09:00",
      "updateaction": "jp1ima¥¥addon_management¥¥alertmanager¥¥addon_jpc_service_reload.bat"
    }, ・・・
  ],
"errfilelist":[
    {
      "filename": "file_sd_config_test.yml",
      "filepath": "C:¥¥Program Files¥¥Hitachi¥¥jp1ima¥¥conf",
    }, ・・・
  ]
}

5.17.2　定義ファイル取得

機能

JP1/IM - ManagerまたはJP1/IM - Agentの定義ファイルを取得します。

実行権限

次の権限が必要です。

hostCategoryに「Manager」を指定する場合

JP1資源グループ：*

JP1権限レベル：JP1_Console_Admin

hostCategoryに「Agent」を指定する場合

JP1権限レベル：JP1_Console_Admin

APIのバージョン

v1

形式

リクエスト行

POST /application/component/apiVersion/fileOperation/getFile httpVersion

リクエストのヘッダー

「5.2.3　リクエスト形式」のリクエストヘッダーに従います。

リクエストのメッセージボディー

リクエストのメッセージボディーは，JSONフォーマットで送信できます。

[
  "filelist":[
    {
      "filename": "ファイル名",
      "filepath": "ファイルの絶対パス"
    }, ・・・
  ],
  "hostCategory":"ホスト種別",
  "managerHostName":"定義ファイル取得先Agentホスト管理先Mangerホスト名",
  "agentHostName":"定義ファイル取得先Agentホスト名"
]

パラメーター

リクエストのメッセージボディーに指定するパラメーターを次に示します。

パラメーター

省略可否

説明

filename

不可

ファイル名を指定します。

filepath

不可

ファイルの配置先を絶対パスで指定します。ファイルパスにファイル名を含めた絶対パスが，200文字を超えた場合は，エラーとなります。

hostCategory

不可

ホスト種別として「Manager」または「Agent」を指定します。指定したホスト種別の定義ファイルに対して操作を行います。

managerHostName

「説明」欄を参照

hostCategoryが「Manager」の場合

指定項目を無視します。自ホストをJP1/IMのマネージャーホストと仮定し，JP1/IMのマネージャーホストの定義ファイルを取得します。

hostCategoryが「Agent」の場合

定義ファイル取得先のエージェントを管理しているJP1/IMのマネージャーホスト名を1〜255バイトで指定します。

agentHostName

「説明」欄を参照

hostCategoryが「Manager」の場合

指定項目を無視します。

hostCategoryが「Agent」の場合

定義ファイル取得先のエージェントホスト名を1〜255バイトで指定します。

ステータスコード

リクエストに対するレスポンスとして返却されるステータスコードを，次の表に示します。

ステータスコード

メッセージ

説明

200

−

APIの処理が成功しました。

400

KAJY68105-E

リクエストパラメーターが不正です。

KAJY68205-E

リクエストに指定した統合エージェントホスト名がJP1/IM - Managerが管理する構成に存在しません

ログインユーザーにリクエストに指定した統合エージェントの参照・操作権限がありません

リクエストに指定した統合エージェントまたはマネージャーホストの情報が統合エージェントホスト管理DBにありません

403

KAJY01000-E

認証に使用したユーザーの権限が不足しています。

500

KAJY68104-E

統合エージェント制御基盤でエラーが発生しました。

KAJY00007-E

システムエラーが発生しました（ディスク不足，メモリー不足など）。

KAJY68203-E

インテリジェント統合管理基盤に接続できません。

KAJY68212-E

統合エージェント制御基盤に接続できません。

KAJY68501-E

マネージャーの統合エージェントホスト管理DBに接続できません。

取得したい定義ファイルが存在せず，圧縮した定義ファイルが作成できる場合（複数のファイルを取得しようとして，一部のファイルが存在しなかった場合），取得に失敗したファイルの情報は，定義ファイルを圧縮したzipファイルの中にある定義ファイルプロパティファイルに記載します。

レスポンス

ステータスコードが200の場合に，レスポンスボディーにzip形式に圧縮した定義ファイルのファイルデータを返却します。

レスポンスヘッダーとして，次の情報を設定します。

Content-Type:application/zip
Content-Disposition: attachment; filename="zip形式に圧縮した定義ファイルのファイル名"

ほかのレスポンスヘッダーは，APIの共通仕様と同じです。APIの共通仕様のレスポンスヘッダーについては，「5.2.5(2)　レスポンスヘッダー」を参照してください。

戻り値

ステータスコードが200の場合

レスポンスのメッセージボディーに，zip形式に圧縮した定義ファイルのファイルデータが返却されます。

ステータスコードが200以外の場合

レスポンスのメッセージボディーに，「5.2.6 エラー発生時のレスポンスメッセージ」に記載されているレスポンス形式の例外オブジェクトが返却されます。

使用例

リクエスト：

POST http://hostname:20703/im/api/v1/fileOperation/getFile  HTTP/1.1
Authorization:Bearer anAxYWRtaW46TUdGa01tTTJNMlV3TURFNFh6STNYekE0T2pJME9qTXpYMTlmWDE5ZlgxOWZYMTlmWDE5ZlgycHdNV0ZrYldsdUlDQWdJQ0FnSUNBZ0lDQWdJQ0FnSUNBZ0lDQWdJQ0Fn
Accept-Language: ja
Content-Type: application/json
Content-Length: 1024000
Accept: application/zip
{
  "filelist":[
    {
      "filename": "jpc_imagent.json",
      "filepath": "C:¥¥Program Files¥¥Hitachi¥¥jp1ima¥¥conf",
    }, ・・・
  ],
  "hostCategory":"Agent",
  "managerHostName":"immanager",
  "agentHostName":"imagent"
}

レスポンス：

HTTP/1.1 200 OK
Content-Type:application/zip
Content-Disposition: attachment; filename="C:¥Program Files¥Hitachi¥jp1ima¥tmp¥upload¥imagenthost_UUID.zip"
・・・省略・・・

5.17.3　定義ファイル削除

機能

JP1/IM - ManagerまたはJP1/IM - Agentの定義ファイルを削除します。

実行権限

次の権限が必要です。

hostCategoryに「Manager」を指定する場合

JP1資源グループ：*

JP1権限レベル：JP1_Console_Admin

hostCategoryに「Agent」を指定する場合

JP1権限レベル：JP1_Console_Admin

APIのバージョン

v1

形式

リクエスト行

POST /application/component/apiVersion/fileOperation/deleteFile httpVersion

リクエストのヘッダー

「5.2.3　リクエスト形式」のリクエストヘッダーに従います。

リクエストのメッセージボディー

リクエストのメッセージボディーは，JSONフォーマットで送信できます。

[
  "filelist":[
    {
      "filename": "ファイル名",
      "filepath": "ファイルの絶対パス",
      "updateaction": "定義反映のための操作"
    }, ・・・
  ],
  "hostCategory":"ホスト種別",
  "managerHostName":"定義ファイル削除先Agentホスト管理先Mangerホスト名",
  "agentHostName":"定義ファイル削除先Agentホスト名"
]

パラメーター

リクエストのメッセージボディーに指定するパラメーターを次に示します。

パラメーター

省略可否

説明

filename

不可

ファイル名を指定します。

filepath

不可

ファイルの配置先を絶対パスで指定します。ファイルパスにファイル名を含めた絶対パスが，200文字を超えた場合は，エラーとなります。

updateaction

可

定義ファイルを更新した場合に実行すべき操作を，1〜4096バイトで指定します。

hostCategory

不可

ホスト種別として「Manager」または「Agent」を指定します。指定したホスト種別の定義ファイルに対して操作を行います。

managerHostName

「説明」欄を参照

hostCategoryが「Manager」の場合

指定項目を無視します。自ホストをJP1/IMのマネージャーホストと仮定し，JP1/IMのマネージャーホストの定義ファイルを削除します。

hostCategoryが「Agent」の場合

定義ファイル削除先のエージェントを管理しているJP1/IMのマネージャーホスト名を1〜255バイトで指定します。

agentHostName

「説明」欄を参照

hostCategoryが「Manager」の場合

指定項目を無視します。

hostCategoryが「Agent」の場合

定義ファイル削除先のエージェントホスト名を1〜255バイトで指定します。

ステータスコード

リクエストに対するレスポンスとして返却されるステータスコードを，次の表に示します。

ステータスコード

メッセージ

説明

200

−

APIの処理が成功しました。

KAJY68126-W

統合エージェント制御基盤でワーニングが発生しました。

400

KAJY68107-E

リクエストパラメーターが不正です。

KAJY68205-E

リクエストに指定した統合エージェントホスト名がJP1/IM - Managerが管理する構成に存在しません。

ログインユーザーにリクエストに指定した統合エージェントの参照・操作権限がありません。

リクエストに指定した統合エージェントまたはマネージャーホストの情報が統合エージェントホスト管理DBにありません。

403

KAJY01000-E

認証に使用したユーザーの権限が不足しています。

500

KAJY68104-E

統合エージェント制御基盤でエラーが発生しました。

KAJY00007-E

システムエラーが発生しました（ディスク不足，メモリー不足など）。

KAJY68203-E

インテリジェント統合管理基盤に接続できません。

KAJY68212-E

統合エージェント制御基盤に接続できません。

KAJY68501-E

マネージャーの統合エージェントホスト管理DBに接続できません。

レスポンス

ステータスコードが200の場合に，レスポンスボディーにJSON形式で次の情報を返却します。

{
  "filelist":[
    {
      "filename": "ファイル名",
      "filepath": "ファイルの絶対パス",
      "result": "ファイル削除の結果",
      "message": "メッセージ"
    }, ・・・
  ]
}

メンバー名

説明

filename

ファイル名を記載します。

filepath

ファイルの配置先の絶対パスを記載します。

result

ファイル削除の結果を記載します。

記載する文字列については，表5-15を参照してください。

filelist:message

ファイル削除のための操作が失敗した場合のエラーメッセージIDとその本文を記載します。成功した場合は省略します。

resultが「recovery fail」の場合に記載するエラーメッセージは，定義反映のための操作に失敗したときのメッセージを記載します。

表5‒15　 resultの内容

ファイルの削除

定義反映のための操作

リカバリー処理

resultの内容

〇

〇

−

success

×

−

−

delete fail

〇

×

〇

action fail

〇

×

×

recovery fail

（凡例）

〇：成功　×：失敗　−：処理なし

戻り値

ステータスコードが200の場合

なし

ステータスコードが200以外の場合

レスポンスのメッセージボディーに，「5.2.6 エラー発生時のレスポンスメッセージ」に記載されているレスポンス形式の例外オブジェクトが返却されます。

使用例

リクエスト：

POST http://hostname:20703/im/api/v1/fileOperation/deleteFile HTTP/1.1
Authorization:Bearer anAxYWRtaW46TUdGa01tTTJNMlV3TURFNFh6STNYekE0T2pJME9qTXpYMTlmWDE5ZlgxOWZYMTlmWDE5ZlgycHdNV0ZrYldsdUlDQWdJQ0FnSUNBZ0lDQWdJQ0FnSUNBZ0lDQWdJQ0Fn
Accept-Language: ja
Content-Type: application/json
Content-Length: 1024000
Accept: application/json
{
  "filelist":[
    {
      "filename": "user_file_sd_config_test.yml",
      "filepath": "C:¥¥Program Files¥¥Hitachi¥¥jp1ima¥¥conf¥¥user",
      "updateaction": "jp1ima¥¥addon_management¥¥alertmanager¥¥addon_jpc_service_reload.bat"
    }, ・・・
  ],
  "hostCategory":"Agent",
  "managerHostName":"immanager",
  "agentHostName":"imagent"
}

レスポンス：

HTTP/1.1 200 OK
Content-Type:application/json
・・・省略・・・

{
  "filelist":[
    {
      "filename": "user_file_sd_config_test.yml",
      "filepath": "C:¥¥Program Files¥¥Hitachi¥¥jp1ima¥¥conf¥¥user",
      "result": "delete fail",
      "message": "KAJY68126-W 統合エージェント制御基盤でワーニングが発生。(詳細情報: KNBC20015-W 定義ファイルの削除に失敗しました。(詳細情報: target file does not exist. filename=C:¥¥Program Files¥¥Hitachi¥¥jp1ima¥¥conf¥¥user¥¥user_file_sd_config_test.yml))"
    }, ・・・
  ]
}

注意事項

定義ファイルの削除後に，定義情報の反映のために，サービスが再起動されるおそれがあります。

定義ファイルの削除後のサービス起動に失敗した場合，リカバリー処理を行いますが，リカバリー処理にも失敗したときは，サービスが停止した状態になるおそれがあります。

クラスタ構成の場合，定義ファイルを削除したことによって，フェールオーバーが発生するおそれがあります。また，フェールオーバー先でもサービスを起動できず，フェールオーバーが失敗するおそれがあります。負荷の状況によっては，サービスの再起動やリカバリー処理に時間がかかり，クラスタ構成の場合は，クラスタソフトが異常と判断して，フェールオーバーが発生するおそれがあります。そのため，定義ファイルの削除は，システムのメンテナンスの時間に実施してください。

5.17.4　定義ファイル更新

機能

JP1/IM - ManagerまたはJP1/IM - Agentの定義ファイルを更新します。

実行権限

次の権限が必要です。

hostCategoryに「Manager」を指定する場合

JP1資源グループ：*

JP1権限レベル：JP1_Console_Admin

hostCategoryに「Agent」を指定する場合

JP1権限レベル：JP1_Console_Admin

APIのバージョン

v1

形式

リクエスト行

POST /application/component/apiVersion/fileOperation/updateFile httpVersion

リクエストのヘッダー

Authorization:BeareranAxYWRtaW46TUdGa01tTTJNMlV3TURFNFh6STNYekE0T2pJME9qTXpYMTlmWDE5ZlgxOWZYMTlmWDE5ZlgycHdNV0ZrYldsdUlDQWdJQ0FnSUNBZ0lDQWdJQ0FnSUNBZ0lDQWdJQ0Fn
Accept-Language: ja

「5.2.3　リクエスト形式」のリクエストヘッダーに従います。ただし，Content-Typeは次の形式となります。

Content-Type: multipart/form-data; boundary=-----5a6a576p44OV44Kh44Kk44Or5pu05paw
Content-Length: 1024000
Accept: application/json

リクエストのメッセージボディー

[
-----5a6a576p44OV44Kh44Kk44Or5pu05paw
Content-Disposition: form-data; name="hostCategory"

"ホスト種別"
-----5a6a576p44OV44Kh44Kk44Or5pu05paw
Content-Disposition: form-data; name="managerHostName"

"定義ファイル更新先Agentホスト管理先Mangerホスト名"
-----5a6a576p44OV44Kh44Kk44Or5pu05paw
Content-Disposition: form-data; name="agentHostName"

"定義ファイル更新先Agentホスト名"
-----5a6a576p44OV44Kh44Kk44Or5pu05paw
Content-Disposition: form-data; name="file"; filename="/C:/Users/xxxxx/Desktop/sample.zip"
Content-Type: application/zip

zipデータ
-----5a6a576p44OV44Kh44Kk44Or5pu05paw
]

パラメーター

リクエストのメッセージボディーに指定するパラメーターを次に示します。

パラメーター

省略可否

説明

filename

不可

定義ファイルをzipに圧縮したファイル名を絶対パスで指定します。ファイル名は1〜200バイトで指定します。

ファイルサイズの上限はチェックせず，リクエストボディーのサイズの上限をチェックします。

hostCategory

不可

ホスト種別として「Manager」または「Agent」を指定します。指定したホスト種別の定義ファイルに対して操作を行います。

managerHostName

「説明」欄を参照

hostCategoryが「Manager」の場合

指定項目を無視します。自ホストをJP1/IMのマネージャーホストと仮定し，JP1/IMのマネージャーホストの定義ファイルを更新します。

hostCategoryが「Agent」の場合

定義ファイル更新先のエージェントを管理しているJP1/IMのマネージャーホスト名を1〜255バイトで指定します。

agentHostName

「説明」欄を参照

hostCategoryが「Manager」の場合

指定項目を無視します。

hostCategoryが「Agent」の場合

定義ファイル更新先のエージェントホスト名を1〜255バイトで指定します。

ステータスコード

リクエストに対するレスポンスとして返却されるステータスコードを，次の表に示します。

ステータスコード

メッセージ

説明

200

−

APIの処理が成功しました。

KAJY68126-W

統合エージェント制御基盤でワーニングが発生しました。

400

KAJY68111-E

リクエストパラメーターが不正です。

KAJY68205-E

リクエストに指定した統合エージェントホスト名がJP1/IM - Managerが管理する構成に存在しません。

ログインユーザーにリクエストに指定した統合エージェントの参照・操作権限がありません。

リクエストに指定した統合エージェントまたはマネージャーホストの情報が統合エージェントホスト管理DBにありません。

403

KAJY01000-E

認証に使用したユーザーの権限が不足です。

500

KAJY68104-E

統合エージェント制御基盤でエラーが発生しました。

KAJY00009-E

リクエストボディーの上限を超えました。

KAJY00007-E

システムエラーが発生しました（ディスク不足，メモリー不足など）。

KAJY68203-E

インテリジェント統合管理基盤に接続できません。

KAJY68212-E

統合エージェント制御基盤に接続できません。

KAJY68501-E

マネージャーの統合エージェントホスト管理DBに接続できません。

レスポンス

ステータスコードが200の場合に，レスポンスボディーにJSON形式で次の情報を返却します。

{
  "filelist":[
    {
      "filename": "ファイル名",
      "filepath": "ファイルの絶対パス",
      "result": "ファイル更新の結果",
      "message": "メッセージ"
    }, ・・・
  ]
}

メンバー名

説明

filename

ファイル名を記載します。

filepath

ファイルの配置先の絶対パスを記載します。

result

ファイル更新の結果を記載します。

記載する文字列については，表5-16を参照してください。

filelist:message

ファイル更新のための操作が失敗した場合のエラーメッセージIDとその本文を記載します。成功した場合は省略します。

resultが「recovery fail」の場合に記載するエラーメッセージは，定義反映のための操作に失敗したときのメッセージを記載します。

表5‒16　 resultの内容

ファイルの上書き

定義反映のための操作

リカバリー処理

resultの内容

〇

〇

−

success

×

−

−

update fail

〇

×

〇

action fail

〇

×

×

recovery fail

（凡例）

〇：成功　×：失敗　−：処理なし

戻り値

ステータスコードが200の場合

なし

ステータスコードが200以外の場合

レスポンスのメッセージボディーに，「5.2.6 エラー発生時のレスポンスメッセージ」に記載されているレスポンス形式の例外オブジェクトが返却されます。

使用例

リクエスト：

POST http://hostname:20703/im/api/v1/fileOperation/updateFile HTTP/1.1
Content-Type: multipart/form-data;boundary=-----5a6a576p44OV44Kh44Kk44Or5pu05paw
[
-----5a6a576p44OV44Kh44Kk44Or5pu05paw
Content-Disposition: form-data; name="hostCategory"

"Agent"
-----5a6a576p44OV44Kh44Kk44Or5pu05paw
Content-Disposition: form-data; name="managerHostname"

"immanager"
-----5a6a576p44OV44Kh44Kk44Or5pu05paw
Content-Disposition: form-data; name="agentHostname"

"imagent"
-----5a6a576p44OV44Kh44Kk44Or5pu05paw
Content-Disposition: form-data; name="file"; filename="/C:/Users/xxxxx/Desktop/sample.zip"
Content-Type: multipart/form-data; boundary=
-----5a6a576p44OV44Kh44Kk44Or5pu05paw

zipデータ
-----5a6a576p44OV44Kh44Kk44Or5pu05paw--
]

レスポンス：

HTTP/1.1 200 OK
Content-Type:application/json
・・・省略・・・

{
  "filelist":[
    {
      "filename": "user_file_sd_config_test2.yml",
      "filepath": "C:¥¥Program Files¥¥Hitachi¥¥jp1ima¥¥conf¥¥user",
      "result": "update fail",
      "message": "KAJY68126-W 統合エージェント制御基盤でワーニングが発生。(詳細情報 : KNBC20020-W 定義ファイルの更新に失敗しました。(詳細情報: specified file not included in user-definition file list file. filename= C:¥¥Program Files¥¥Hitachi¥¥jp1ima¥¥conf¥¥user¥¥user_file_sd_config_test2.yml))"
    }, ・・・
  ]
}

注意事項

定義ファイルを更新する前に，定義ファイルの書式，文字コードなどが正しいことを，マニュアルで確認してください。

定義ファイルが不正な場合，更新に失敗するおそれがあります。定義ファイルの更新が失敗すると，JP1イベントが送信されるため，発生したJP1イベントの内容を確認して対処してください。

定義ファイルの更新時に，自動的に再起動されるサービスがあります。

サービスが再起動されることによって，監視業務が一時的に停止することがあります。また，クラスタ構成の場合，クラスタソフトの監視対象サービスに対する停止の検知時間の設定※により，フェールオーバーが発生するおそれがあります。そのため，定義ファイルの更新は，システムのメンテナンスの時間に実施してください。

注※

停止の検知時間の目安は，マシンスペックや負荷状況にも依存しますが，1つの定義ファイルの更新ごとに，サービスを再起動するため，定義ファイル1つにつき1分程度と考えてください。

例えば，定義ファイルを10個同時に更新する運用の場合，クラスタソフトの停止の検知時間の設定を10分にしてください。

検知時間を延ばすことができない場合は，定義ファイル操作機能を使用せず，ホストにログインして，直接定義ファイルを更新してください。

5.18　統合エージェント管理のAPI

5.18.1　統合エージェント情報取得

機能

統合エージェントの情報を取得するAPIです。

統合マネージャーの配下に拠点/中継マネージャーが存在する場合，拠点/中継マネージャー配下の統合エージェントの情報も取得します。

ログインしたJP1ユーザーに参照権限がある場合は，エージェントの情報を取得します。

実行権限

JP1_Console_Admin

APIのバージョン

v1

形式

リクエスト行

POST /im/api/v1/agents httpVersion

リクエストのメッセージボディー

なし

レスポンスのメッセージボディー

{
  "agents": [
    統合エージェント情報オブジェクト, ...
  ],
  "messageList":[
    {
      "messageId": メッセージID,
      "message": メッセージ
    }, ...
}

パラメーター

なし

ステータスコード

リクエストに対するレスポンスとして返却されるステータスコードを，次の表に示します。

ステータスコード

メッセージ

説明

200

−

APIの処理が成功しました。

403

KAJY01000-E

認証に使用したユーザーの権限が不足しています。

200

KAJY68500-W

マネージャーの統合エージェントホスト管理DBに接続できません。

複数の管理マネージャーの統合エージェントホスト管理DBに接続できなかった場合はホスト名に各管理マネージャーホスト名を「,」で連結した文字列を指定します。

200

KAJY68204-W

マネージャーのインテリジェント統合管理基盤に接続できません。

複数のマネージャーのインテリジェント統合管理基盤に接続できなかった場合はホスト名に各管理マネージャーホスト名を「,」で連結した文字列を指定します。

200

KAJY68210-W

インテリジェント統合管理基盤の処理でエラーが発生しました。

500

KAJY68501-E

マネージャーの統合エージェントホスト管理DBに接続できません。

戻り値

戻り値を次の表に示します。

パラメーター名

データ型

省略可否

説明

agents

object[]

不可

統合エージェント情報オブジェクトの配列を指定します。

統合エージェントが存在しない場合は空の配列を指定します。

統合エージェント情報オブジェクト

object

可

「7.2.5(1) 統合エージェント情報オブジェクト」を参照してください。

messageList

object

可

メッセージオブジェクトの配列を指定します。

メッセージが存在しない場合は省略されます。

messageId

string

不可

メッセージIDを指定します。

message

string

不可

メッセージ本文を指定します。

使用される言語は，HTTPリクエストヘッダーのAccept-Languageプロパティの指定内容により決まります。

使用例

リクエスト：

POST http://hostname:20703/im/api/v1/agents

レスポンス：

< HTTP/1.1 200 OK
< Content-Type: application/json
{
     "agents": [
          {
               "agentid": "RENEMzNENDg5RkQyNEM2OT",
               "hostname": "agenthostA",
               "os": "windows",
               "installpath": "¥¥Program Files¥¥Hitachi¥¥jp1ima",
               "imversion": "130000",
               "managerhost": "managerhostA",
               "registeredtime": "2020-03-01T00:00:00Z",
               "addons": [
                    {
                         "addonName": "Windows metric collector(Windows exporter)",
                         "enables": true
                    }
               ]
          }
     ]
}

5.18.2　統合エージェント情報削除

機能

指定された統合エージェントの情報を削除するAPIです。

ログインしたJP1ユーザーに参照・操作権限がある統合エージェントは削除できます。

実行権限

JP1_Console_Admin

APIのバージョン

v1

形式

リクエスト行

POST /im/api/v1/agents/delete httpVersion

リクエストのメッセージボディー

{
  "agents": [
    {
      "agenthost": 統合エージェントホスト名,
      "managerhost": マネージャーホスト名
    }, ・・・
  ]
}

レスポンスのメッセージボディー

正常終了の場合，レスポンスはありません。

警告終了の場合，次のレスポンスを返却します。

{
    "errhostlist":[
        {
            "agenthost": 統合エージェントホスト名,
            "managerhost": マネージャーホスト名
        },・・・
    ],
    "messageList":[
        {
            "messageId": メッセージID,
            "message": メッセージ
        }, ・・・
    ]
}

パラメーター

リクエストのメッセージボディーに指定するパラメーターを次に示します。

パラメーター名

データ型

省略可否

説明

agents

object[]

不可

削除する統合エージェントを指定します。指定できる統合エージェントは200件までです。

空配列は指定できません。

agenthost

string

不可

統合エージェントのホスト名を1〜255バイトの範囲で指定します。

managerhost

string

不可

マネージャーホスト名を1〜255バイトの範囲で指定します。

レスポンス

パラメーター名

データ型

省略可否

説明

errhostlist

object[]

可

削除に失敗した統合エージェントの配列が設定されます。失敗したホストがない場合は省略されます。

agenthost

string

不可

統合エージェントのホスト名が設定されます。

managerhost

string

不可

マネージャーホスト名が設定されます。

messageList

object

可

メッセージオブジェクトの配列が設定されます。メッセージが存在しない場合は省略されます。

messageId

string

不可

メッセージIDが設定されます。

message

string

不可

メッセージの本文が設定されます。使用される言語は，HTTPリクエストヘッダーのAccept-Languageプロパティの指定内容によって決まります。

ステータスコード

リクエストに対するレスポンスとして返却されるステータスコードを，次の表に示します。

ステータスコード

メッセージ

説明

200

−

APIの処理が成功しました。

400

KAJY68201-E

APIのリクエストが不正です。

リクエスト不正が一個所見つかった時点で処理を中断します。

200

KAJY68213-W

リクエストに指定した統合エージェントホスト名または，マネージャーホスト名がJP1/IM - Managerが管理する構成に存在しません

ログインユーザーにリクエストに指定した統合エージェントの参照・操作権限がありません

リクエストに指定した統合エージェントまたはマネージャーホストの情報が統合エージェントホスト管理DBにありません。

403

KAJY01000-E

認証に使用したユーザーの権限が不足しています。

500

KAJY68501-E

指定された統合マネージャーの統合エージェントホスト管理DBに接続できません。

200

KAJY68500-W

指定された下位マネージャーの統合エージェントホスト管理DBに接続できません。

200

KAJY68204-W

指定された統合エージェントのマネージャーのインテリジェント統合管理基盤に接続できません。

200

KAJY68210-W

インテリジェント統合管理基盤の処理でエラーが発生しました。

戻り値

なし

使用例

リクエスト：

POST http://hostname:20703/im/api/v1/agents/delete
{
    "agents": [
      {
        "agenthost":"hostA",
        "managerhost":"hostB"
      }
    ]
}

レスポンス：

< HTTP/1.1 200 OK
< Content-Type: application/json

5.18.3　シークレットの一覧取得

機能

統合エージェント制御基盤で管理するシークレットの一覧を取得します。

実行権限

JP1_Console_Admin

APIのバージョン

v1

形式

リクエスト行

POST /application/component/apiVersion/agents/secrets httpVersion

リクエストのヘッダー

「5.2.3　リクエスト形式」のリクエストヘッダーに従います。

リクエストのメッセージボディー

リクエストのメッセージボディーは，JSONフォーマットで送信できます。

[
  "agenthost":"統合エージェントホスト名",
  "managerhost":"マネージャーホスト名"
]

レスポンスのメッセージボディー

シークレットの一覧を返却します。このときobfuscatedとsecretの値は空文字列となります。

{
    "secrets": [
        {
            "key": "キー1",
            "obfuscated": "",
            "secret": ""
        },
        {
            "key": "キー2",
            "obfuscated": "",
            "secret": ""
        },
        {
            "key": "キー3",
            "obfuscated": "",
            "secret": ""
        }
    ]
}

パラメーター

リクエストのメッセージボディーに指定するパラメーターを次に示します。

パラメーター

データ型

省略可否

説明

agenthost

string

不可

統合エージェントホスト名を1〜255バイトで指定します。

managerhost

string

不可

マネージャーホスト名を1〜255バイトで指定します。

ステータスコード

リクエストに対するレスポンスとして返却されるステータスコードを，次の表に示します。

ステータスコード

出力されるメッセージ

説明

200

−

APIの処理が成功しました。

400

KAJY68209-E

リクエストパラメーターが不正です。

400

KAJY68205-E

リクエストに指定した統合エージェントホスト名または，マネージャーホスト名がJP1/IM - Managerが管理する構成に存在しません

ログインユーザーにリクエストに指定した統合エージェントの参照・操作権限がありません

403

KAJY01000-E

認証に使用したユーザーの権限が不足しています。

500

KAJY00007-E

システムエラーが発生しました（ディスク不足，メモリー不足など）。

500

KAJY68203-E

指定された統合エージェントのマネージャーのインテリジェント統合管理基盤に接続できません。

500

KAJY68207-E

統合エージェント基盤の処理でエラーが発生しました。

500

KAJY68211-E

インテリジェント統合管理基盤の処理でエラーが発生しました。

500

KAJY68212-E

統合エージェント基盤に接続できません。

500

KAJY68501-E

マネージャーの統合エージェントホスト管理DBに接続できません。

エラーメッセージの出力について

APIの実行時にエラーが発生した場合，APIのレスポンスにエラーメッセージの内容を含めて呼び出し元へ返却します。呼び出し元は受け取ったレスポンスの情報を使って，呼び出し元でメッセージの表示を行います。

戻り値

なし

使用例

リクエスト：

POST http://immhost01:20703/im/api/v1/agents/secrets

マネージャーホスト名：immhost01

{
    "agenthost": "hostA",
    "managerhost": "hostB"
}

レスポンス：

省略

5.18.4　シークレットの追加，更新，削除

機能

統合エージェント制御基盤で管理するシークレットの追加，更新，削除を実行します。

登録できるシークレットは1000件までです。

実行権限

JP1_Console_Admin

APIのバージョン

v1

形式

リクエスト行

POST /application/component/apiVersion/agents/secrets/change httpVersion

リクエストのヘッダー

「5.2.3　リクエスト形式」のリクエストヘッダーに従います。

リクエストのメッセージボディー

リクエストのメッセージボディーは，JSONフォーマットで送信できます。

追加または更新だけを実行する（削除は実行しない）場合

追加するシークレットをaddに記載します。

[
    "agenthost":"統合エージェントホスト名",
    "managerhost":"マネージャーホスト名",
    "add": {
        "secrets": [
            {
                "key": "キー1",
                "secret": "平文シークレット1"
            },
            {
                "key": "キー2",
                "secret": "平文シークレット2"
            },
            {
                "key": "キー3",
                "secret": "平文シークレット3"
            }
        ]
    }
}

削除だけを実行する（追加や変更は実行しない）場合

削除するシークレットをdeleteに記載します。

[
    "agenthost":"統合エージェントホスト名",
    "managerhost":"マネージャーホスト名",
    "delete": {
        "secrets": [
            {
                "key": "キー1",
            },
            {
                "key": "キー2",
            },
            {
                "key": "キー3",
            }
        ]
    }
}

追加や更新と削除を実行する場合

追加や更新するシークレットをaddに記載し，削除するシークレットをdeleteに記載します。

addとdeleteに同一のキーを指定した場合，addで指定した内容が適用されます。

[
    "agenthost":"統合エージェントホスト名",
    "managerhost":"マネージャーホスト名",
    "add": {
        "secrets": [
            {
                "key": "キー1",
                "secret": "平文シークレット1"
            },
            {
                "key": "キー2",
                "secret": "平文シークレット2"
            },
            {
                "key": "キー3",
                "secret": "平文シークレット3"
            }
        ]
    },
    "delete": {
        "secrets": [
            {
                "key": "キー1",
            },
            {
                "key": "キー2",
            },
            {
                "key": "キー3",
            }
        ]
    }
}

レスポンスのメッセージボディー

なし

パラメーター

リクエストのメッセージボディーに指定するパラメーターを次に示します。

パラメーター

データ型

省略可否

説明

agenthost

string

不可

統合エージェントホスト名を1〜255バイトで指定します。

managerhost

string

不可

マネージャーホスト名を1〜255バイトで指定します。

add

object

可

追加または更新するシークレットを指定します。追加または更新するシークレットがない場合は省略します。

secrets

object[]

不可

追加または更新するシークレットを指定します。

key

string

不可

キー名にシークレットキーを指定します。

指定できる文字数は1〜1024文字で，指定できる文字はASCIIコード（0x20〜0x7e）です。それ以外はエラーとなります。

secret

string

不可

シークレットを指定します。

指定できる文字数は1〜1024文字で，指定できる文字はASCIIコード（0x20〜0x7e）です。それ以外はエラーとなります。

delete

object

可

削除するシークレットを指定します。削除するシークレットがない場合は省略します。

secrets

object[]

不可

削除するシークレットを指定します。

key

string

不可

キー名にシークレットキーを指定します。

指定できる文字数は1〜1024文字で，指定できる文字はASCIIコード（0x20〜0x7e）です。それ以外はエラーとなります。

ステータスコード

リクエストに対するレスポンスとして返却されるステータスコードを，次の表に示します。

ステータスコード

出力されるメッセージ

説明

200

−

APIの処理が成功しました。

400

KAJY68209-E

リクエストパラメーターが不正です。

400

KAJY68205-E

リクエストに指定した統合エージェントホスト名または，マネージャーホスト名がJP1/IM - Managerが管理する構成に存在しません

ログインユーザーにリクエストに指定した統合エージェントの参照・操作権限がありません

403

KAJY01000-E

認証に使用したユーザーの権限が不足しています。

500

KAJY00007-E

システムエラーが発生しました（ディスク不足，メモリー不足など）。

500

KAJY02039-E

内部エラーが発生しました（APIの引数指定不正、環境不正など）。

500

KAJY68203-E

指定された統合エージェントのマネージャーのインテリジェント統合管理基盤に接続できません。

500

KAJY68207-E

統合エージェント基盤の処理でエラーが発生しました。

500

KAJY68211-E

インテリジェント統合管理基盤の処理でエラーが発生しました。

500

KAJY68212-E

統合エージェント基盤に接続できません。

500

KAJY68501-E

マネージャーの統合エージェントホスト管理DBに接続できません。

エラーメッセージの出力について

APIの実行時にエラーが発生した場合，APIのレスポンスにエラーメッセージの内容を含めて呼び出し元へ返却します。呼び出し元は受け取ったレスポンスの情報を使って，呼び出し元でメッセージの表示を行います。

戻り値

なし

使用例

リクエスト：

POST http://immhost01:20703/im/api/v1/agents/secrets/change

マネージャーホスト名：immhost01

{
    "agenthost": "hostA",
    "managerhost": "hostB",
    "add": {
      "secrets": [
        {
          "key": "key1",
          "secret": "secret1"
        },
        {
          "key": "key2",
          "secret": "secret2"
        }
      ]
    }
}

レスポンス：

省略

5.19　下位マネージャー情報管理のAPI

5.19.1　下位マネージャー情報一覧取得

機能

統合マネージャー配下の拠点マネージャーまたは中継マネージャーの一覧を取得します。

実行権限

次の権限が必要です。

JP1資源グループ：*

JP1権限レベル：JP1_Console_Admin

APIのバージョン

v1

形式

リクエスト行

GET /application/component/apiVersion/subManagers httpVersion

リクエストのヘッダー

「5.2.3　リクエスト形式」のリクエストヘッダーに従います。

リクエストのメッセージボディー

なし

レスポンスのメッセージボディー

{
    "subManagers": [
         ホスト名,・・・
    ]
}

パラメーター

なし

ステータスコード

リクエストに対するレスポンスとして返却されるステータスコードを，次の表に示します。

ステータスコード

出力されるメッセージ

説明

200

−

APIの処理が成功しました。

403

KAJY01000-E

認証に使用したユーザーの権限が不足しています。

500

KAJY68501-E

統合エージェントホスト管理DBに接続できません。

戻り値

ステータスコードが200の場合に，レスポンスボディーに次の情報を返却します。

メンバー名

データ型

省略可否

説明

subManagers

string[]

不可

下位マネージャーのホスト名の配列を指定します。ホスト名は1〜255バイトで指定します。

空配列は指定できません。

エラーメッセージの出力について

APIの実行時にエラーが発生した場合，APIのレスポンスにエラーメッセージの内容を含めて呼び出し元へ返却します。呼び出し元は受け取ったレスポンスの情報を使って，呼び出し元でメッセージの表示を行います。

使用例

リクエスト：

GET http://immhost01:20703/im/api/v1/subManagers

マネージャーホスト名：immhost01

レスポンス：

< HTTP/1.1 200 OK
< Content-Type: application/json
{
    "subManagers":["hostA"]
}

5.19.2　下位マネージャー情報登録

機能

統合マネージャー配下の下位マネージャーの情報を登録します。

登録済みの下位マネージャーの情報が指定された場合は，その情報で更新します。

IM構成管理で統合マネージャーの下位ホストとして登録されたホストだけが指定できます。

実行権限

次の権限が必要です。

JP1資源グループ：*

JP1権限レベル：JP1_Console_Admin

APIのバージョン

v1

形式

リクエスト行

POST /application/component/apiVersion/subManagers/createInfo httpVersion

リクエストのヘッダー

「5.2.3　リクエスト形式」のリクエストヘッダーに従います。

リクエストのメッセージボディー

リクエストのメッセージボディーは，JSONフォーマットで送信できます。

{
    "hostname": ホスト名,
    "initialsecret": 初期シークレット
}

レスポンスのメッセージボディー

なし

パラメーター

リクエストのメッセージボディーに指定するパラメーターを次に示します。

パラメーター

データ型

省略可否

説明

hostname

string

不可

下位マネージャーのホスト名を1〜255バイトで指定します。

initialsecret

string

不可

初期シークレットを指定します。

指定できる文字数は1〜1024文字で，指定できる文字はASCIIコード（0x20〜0x7e）です。

ステータスコード

リクエストに対するレスポンスとして返却されるステータスコードを，次の表に示します。

ステータスコード

出力されるメッセージ

説明

200

−

APIの処理が成功しました。

400

KAJY68012-E

APIのリクエストが不正です。

リクエスト不正が1個所見つかった時点で処理を中断します。

403

KAJY01000-E

認証に使用したユーザーの権限が不足しています。

500

KAJY68501-E

統合マネージャーの統合エージェントホスト管理DBに接続できません。

500

KAJY68203-E

下位マネージャーのインテリジェント統合管理基盤に接続できません。

500

KAJY68017-E

下位マネージャー情報の登録に失敗しました。

戻り値

レスポンスボディーはありません。

使用例

リクエスト：

POST http://immhost01:20703/im/api/v1/subManagers/createInfo
{
    "hostname":"hostA",
    "initialsecret": "XXXXXXXXXXX"
}

マネージャーホスト名：immhost01

レスポンス：

< HTTP/1.1 200 OK
< Content-Type: application/json

5.19.3　下位マネージャー情報削除

機能

統合マネージャー配下の拠点マネージャーまたは中継マネージャーの情報を削除します。

実行権限

次の権限が必要です。

JP1資源グループ：*

JP1権限レベル：JP1_Console_Admin

APIのバージョン

v1

形式

リクエスト行

POST /application/component/apiVersion/subManagers/deleteInfo httpVersion

リクエストのヘッダー

「5.2.3　リクエスト形式」のリクエストヘッダーに従います。

リクエストのメッセージボディー

リクエストのメッセージボディーは，JSONフォーマットで送信できます。

{
    "subManagers":[
        ホスト名,・・・
    ]
}

レスポンスのメッセージボディー

正常終了の場合，レスポンスはありません。

警告終了の場合，次のレスポンスを返却します。

{
    "errhostlist":[
        ホスト名,・・・
    ],
    "messageList":[
        {
            "messageId": メッセージID,
            "message": メッセージ
        },・・・
    ]
}

パラメーター

リクエストのメッセージボディーに指定するパラメーターを次に示します。

パラメーター

データ型

省略可否

説明

subManagers

string[]

不可

下位マネージャーのホスト名の配列を指定します。ホスト名は1〜255バイトで指定します。

空配列は指定できません。

ステータスコード

リクエストに対するレスポンスとして返却されるステータスコードを，次の表に示します。

ステータスコード

出力されるメッセージ

説明

200

−

APIの処理が成功しました。

400

KAJY68013-E

APIのリクエストが不正です。

リクエスト不正が1個所見つかった時点で処理を中断します。

403

KAJY01000-E

認証に使用したユーザーの権限が不足しています。

500

KAJY68501-E

統合マネージャーの統合エージェントホスト管理DBに接続できません。

200

KAJY68500-W

下位マネージャーの統合エージェントホスト管理DBに接続できません。複数の管理マネージャーの統合エージェントホスト管理DBに接続できなかった場合は，ホスト名に各管理マネージャーホスト名を「,」で連結した文字列が記載されます。

200

KAJY68204-W

下位マネージャーのインテリジェント統合管理基盤に接続できません。複数のマネージャーのインテリジェント統合管理基盤に接続できなかった場合は，ホスト名に各管理マネージャーホスト名を「,」で連結した文字列が記載されます。

200

KAJY68016-W

下位マネージャー情報が存在しません。

200

KAJY68018-W

下位マネージャー情報の削除に失敗しました。

レスポンス

パラメーター名

データ型

省略可否

説明

errhostlist

string[]

可

削除に失敗した下位マネージャーのホスト名の配列が設定されます。失敗したホストがない場合は省略されます。

messageList

object

可

メッセージオブジェクトの配列が設定されます。メッセージが存在しない場合は省略されます。

messageId

string

不可

メッセージIDが設定されます。

message

string

不可

メッセージの本文が設定されます。使用される言語は，HTTPリクエストヘッダーのAccept-Languageプロパティの指定内容によって決まります。

使用例

リクエスト：

POST http://immhost01:20703/im/api/v1/subManagers/deleteInfo
{
    "subManagers":["hostA"]
}

マネージャーホスト名：immhost01

レスポンス：

< HTTP/1.1 200 OK
< Content-Type: application/json
{
    "errhostlist":[
      "hostA"
    ],
    "messageList":[
        {
            "messageId":"KAJY68500-W",
            "message": "インテリジェント統合管理データベースに接続できません。(JP1/IM-Managerホスト名 : hostA)"
        }
    ]
}

5.20　Prometheus serverの操作関連のAPI

Prometheus serverの操作関連のAPIに関する操作を説明します。

5.20.1　Prometheus serverのリロード

機能

Prometheus serverの定義ファイル（jpc_prometheus_server.yml，jpc_alerting_rules.yml，ファイルディスカバリ定義ファイルなど）を再読み込みし，Prometheus serverの動作に反映します。

Prometheus serverのリロードは，Prometheus serverの再起動と比べて処理が速く，通知失敗時の状態を維持します。

APIの動作に関する特記事項

すべての定義項目がリロードされます。

アラートルールのしきい値を変更してリロードを行うと，アラートのステータスが変更したしきい値に該当するステータスに変化します。

不正な定義ファイルをリロードした場合，すべての定義項目が更新されません。リロードする前に，promtool check configコマンドで，設定ファイルの書式チェックを実施することを推奨します。

形式

リクエスト行

POST /-/reload HTTP/1.1

リクエストヘッダー

ヘッダー名

設定値

Host

APIの接続先のPrometheus serverのホストの情報を，ヘッダーの値として次の形式で指定します。

ホスト名またはIPアドレス:ポート番号

「:ポート番号」は省略可能です。

ホスト名またはIPアドレス

Prometheus serverのホスト名またはIPv4アドレスを指定します。

ポート番号

Prometheus serverに接続する際に使用するポート番号を指定します。

このヘッダーは省略不可です。

リクエストのメッセージボディー

なし。

レスポンスのメッセージボディー

リロードに成功した場合，レスポンスはなしです。

リロードに失敗した場合，失敗した要因を示すメッセージ（Prometheus serverが出力する値）が設定されます。

ステータスコード

ステータスコード

メッセージ

説明

200

OK

リロードに成功した。

200以外

OK以外

リロードに成功した。

使用例

OSSのcurlコマンドを利用して，このAPIを実行した場合の使用例を，次に示します。

リロード成功時：

>curl --request POST "http://localhost:20713/-/reload"

>

リロード失敗時：

>curl --request POST "http://localhost:20713/-/reload"
failed to reload config: couldn't load configuration (--config.file="C:¥¥jp1pccs¥¥conf¥¥jpc_prometheus_server.yml"): parsing YAML file C:¥¥jp1pccs¥¥conf¥¥jpc_prometheus_server.yml: yaml: unmarshal errors:
  line 10: field test not found in type config.plain
>

5.20.2　Prometheus serverのヘルスチェック

機能

Prometheus serverのヘルスチェックを行います。

ステータスコードは常に200を返却します。

形式

リクエスト行

GET /-/healthy HTTP/1.1

リクエストヘッダー

ヘッダー名

設定値

Host

APIの接続先のPrometheus serverのホストの情報を，ヘッダーの値として次の形式で指定します。

ホスト名またはIPアドレス:ポート番号

「:ポート番号」は省略可能です。

ホスト名またはIPアドレス

Prometheus serverのホスト名またはIPv4アドレスを指定します。

ポート番号

Prometheus serverに接続する際に使用するポート番号を指定します。

このヘッダーは省略不可です。

リクエストのメッセージボディー

なし。

ステータスコード

常に200を返却します。

使用例

OSSのcurlコマンドを利用して，このAPIを実行した場合の使用例を，次に示します。

Prometheus serverが正常に動作している場合：

>curl -I --request GET "http://localhost:20713/-/healthy"
HTTP/1.1 200 OK
Date: Sat, 07 Aug 2021 01:20:57 GMT
Content-Length: 23
Content-Type: text/plain; charset=utf-8
>

Prometheus serverが正常に動作していない場合：

>curl -I --request GET "http://localhost:20713/-/healthy"
curl: (7) Failed to connect to localhost port 20713: Connection refused
>

5.21　Alertmanagerの操作関連のAPI

Alertmanagerの操作関連のAPIに関する操作を説明します。

5.21.1　Alertmanagerのリロード

機能

Alertmanagerの定義ファイル（jpc_alertmanager.yml）を再読み込みし，Alertmanagerの動作に反映します。

Alertmanagerのリロードは，Alertmanagerの再起動と比べて処理が速く，通知失敗時の状態を維持します。

APIの動作に関する特記事項

すべての定義項目がリロードされます。

アラートを正常状態にしておき，アラートルールのしきい値を変更して異常になるようにすると，アラートは異常になります。

アラートを異常状態にしておき，アラートルールのしきい値を変更して正常になるようにすると，アラートは正常になります。

不正な定義ファイルをリロードした場合，すべての定義項目が更新されません。

形式

リクエスト行

POST /-/reload HTTP/1.1

リクエストヘッダー

ヘッダー名

設定値

Host

APIの接続先のAlertmanagerのホストの情報を，ヘッダーの値として次の形式で指定します。

ホスト名またはIPアドレス:ポート番号

「:ポート番号」は省略可能です。

ホスト名またはIPアドレス

Alertmanagerのホスト名またはIPv4アドレスを指定します。

ポート番号

Alertmanagerに接続する際に使用するポート番号を指定します。

このヘッダーは省略不可です。

リクエストのメッセージボディー

なし。

レスポンスのメッセージボディー

リロードに成功した場合，レスポンスはなしです。

リロードに失敗した場合，失敗した要因を示すメッセージ（Alertmanagerが出力する値）が設定されます。

ステータスコード

ステータスコード

メッセージ

説明

200

OK

リロードに成功した。

200以外

OK以外

リロードに失敗した。

使用例

OSSのcurlコマンドを利用して，このAPIを実行した場合の使用例を，次に示します。

リロード成功時：

>curl --request POST "http://localhost:20714/-/reload"

>

リロード失敗時：

>curl --request POST "http://localhost:20714/-/reload"
failed to reload config: yaml: line 11: could not find expected ':'
>

5.21.2　Alertmanagerのヘルスチェック

機能

Alertmanagerのヘルスチェックを行います。

ステータスコードは常に200を返却します。

形式

リクエスト行

GET /-/healthy HTTP/1.1

リクエストヘッダー

ヘッダー名

設定値

Host

APIの接続先のAlertmanagerのホストの情報を，ヘッダーの値として次の形式で指定します。

ホスト名またはIPアドレス:ポート番号

「:ポート番号」は省略可能です。

ホスト名またはIPアドレス

Alertmanagerのホスト名またはIPv4アドレスを指定します。

ポート番号

Alertmanagerに接続する際に使用するポート番号を指定します。

このヘッダーは省略不可です。

リクエストのメッセージボディー

なし。

ステータスコード

常に200を返却します。

使用例

OSSのcurlコマンドを利用して，このAPIを実行した場合の使用例を，次に示します。

Alertmanagerが正常に動作している場合：

>curl -I --request GET "http://localhost:20714/-/healthy"
HTTP/1.1 200 OK
Date: Sat, 07 Aug 2021 01:20:57 GMT
Content-Length: 23
Content-Type: text/plain; charset=utf-8
>

Alertmanagerが正常に動作していない場合：

>curl -I --request GET "http://localhost:20714/-/healthy"
curl: (7) Failed to connect to localhost port 20714: Connection refused
>

5.21.3　Alertmanagerのサイレンス一覧取得

機能

Alertmanagerに作成されているサイレンスの一覧をJSON形式で取得します。

形式

リクエスト行

GET /api/v2/silences HTTP/1.1

リクエストヘッダー

ヘッダー名

設定値

Host

APIの接続先のAlertmanagerのホストの情報を，ヘッダーの値として次の形式で指定します。

ホスト名またはIPアドレス:ポート番号

「:ポート番号」は省略可能です。

ホスト名またはIPアドレス

Alertmanagerのホスト名またはIPv4アドレスを指定します。

ポート番号

Alertmanagerに接続する際に使用するポート番号を指定します。

このヘッダーは省略不可です。

リクエストのメッセージボディー

なし。

レスポンスのメッセージボディー

[
    {
        "id": "サイレンスID",
        "status": {
            "state": "ステータス"
        },
        "updatedAt": "更新日時",
        "comment": "コメント",
        "createdBy": "作成者名",
        "endsAt": "終了日時",
        "matchers": [
            {
                "isRegex":正規表現フラグ,
                "name": "ラベル名",
                "value": "値"
            },
            ・・・
        ],
        "startsAt": "開始日時"
    },
    ・・・
]

レスポンスのパラメーター

メンバー名

データ型

説明

id

string

サイレンスの設定に対して一意に割り振られるIDが設定されます。「サイレンス失効」APIを実行する際に使用します。

Alertmanagerが自動的に設定します。

status

object

サイレンスの状態を表すオブジェクトです。

Alertmanagerが自動的に設定します。

state

string

次のどれかの値が設定されます。

active

サイレンスの設定が有効である。

pending

適用開始日時を経過していない。

expired

適用終了日時を経過している。

Alertmanagerが自動的に設定します。

updatedAt

string

サイレンスの設定の作成日時または更新日時がISO8601拡張形式で設定されます。

Alertmanagerが自動的に設定します。

matchers

object

アラートの発行を抑止する条件が設定されます。nameとvalueで指定したラベル名とラベルの値に一致するアラートの発行を抑止します。

name

string

ラベル名が設定されます。

value

string

ラベルの値が設定されます。

isRegex

boolean

valueの値を正規表現で指定しているかどうかが設定されます。

true

正規表現で指定している。

false

正規表現で指定していない。

isEqual

boolean

matchersに該当した場合にアラート通知を抑止するかどうかが設定されます。

常に「true」（アラート通知を抑止する）が設定されます。

Alertmanagerが自動的に設定します。

startsAt

string

サイレンスの適用開始日時がISO8601拡張形式で設定されます。日時は「サイレンス作成」APIで指定したタイムゾーンとなります。

endsAt

string

サイレンスの適用終了日時がISO8601拡張形式で設定されます。日時は「サイレンス作成」APIで指定したタイムゾーンとなります。

createdBy

string

サイレンスの設定の作成者名が設定されます。

comment

string

サイレンスの設定のコメントが設定されます。

ステータスコード

ステータスコード

メッセージ

説明

200

OK

サイレンスの一覧取得に成功した。

200以外

OK以外

サイレンスの一覧取得に失敗した。

使用例

OSSのcurlコマンドを利用して，このAPIを実行した場合の使用例を，次に示します。下記の使用例では，見やすくするために改行とインデントを追加しています。実際の出力結果には改行とインデントは出力されません。また，JSONのプロパティの出力順は不定です。

>curl --request GET "http://localhost:20714/api/v2/silences"
[
    {
        "id": "787594fd-29a6-495d-921a-d37709f6186e",
        "status": {
            "state": "pending"
        },
        "updatedAt": "2021-08-07T02:02:56.206Z",
        "comment": "cpu alert silence",
        "createdBy": "api",
        "endsAt": "2021-08-15T05:00:00.000Z",
        "matchers": [
            {
                "isEqual": true,
                "isRegex": false,
                "name": "alertname",
                "value": "cpu alert"
            }
        ],
        "startsAt": "2021-08-15T04:00:00.000Z"
    }
]
>

5.21.4　Alertmanagerのサイレンス作成

機能

JSON形式のサイレンスの設定を引数で渡し，Alertmanagerにサイレンスを作成します。

レスポンスとして返却されるサイレンスIDは，サイレンスの設定に対して一意に割り振られるIDです。Alertmanagerのサイレンス失効のAPIを実行する際に使用します。

サイレンスの設定をすると，Alertmanagerが自動的に次の項目を追加します。

id

status

status.state

updatedAt

matchers.isEqual

形式

リクエスト行

POST /api/v2/silences HTTP/1.1

リクエストヘッダー

ヘッダー名

設定値

Host

APIの接続先のAlertmanagerのホストの情報を，次に示す形式で指定します。

ホスト名またはIPアドレス : ポート番号

「: ポート番号」は省略可能です。

ホスト名またはIPアドレス

Alertmanagerのホスト名またはIPv4アドレスを指定します。

ポート番号

Alertmanagerに接続する際に使用するポート番号を指定します。

このヘッダーは省略不可です。

Content-Type

リクエストヘッダーの形式を，次に示すとおりに指定します。

Content-Type: application/json

このヘッダーは省略不可です。

リクエストのメッセージボディー

{
    "matchers": [
        {
            "name": "ラベル名",
            "value": "値",
            "isRegex": 正規表現フラグ
        },
        ・・・
    ],
    "startsAt": "開始日時",
    "endsAt": "終了日時",
    "createdBy": "作成者名",
    "comment": "コメント",
}

リクエストのパラメーター

メンバー名

データ型

説明

matchers

object

アラートの発行を抑止する条件を指定するオブジェクトです。

nameとvalueで指定したラベル名とラベルの値に一致するアラートの発行を抑止します。

name

string

ラベル名を指定します。

次の値をラベル名に指定できます。

メトリックのラベル名

アラート設定ファイル（jpc_alerting_rules.yml）のlabels以下に設定したラベル名（jp1_pc_eventidなど）

「alertname」ラベル※

注※

アラート名を条件にしてアラートの発行を抑止する場合，nameメンバーに「alertname」，valueメンバーにアラート名を指定します。

指定できる文字は，半角英数字だけです。

空文字列は指定できません。

value

string

ラベルの値を指定します。

空文字列は指定できません。

isRegex

boolean

valueの値を正規表現で指定しているかどうかを指定します。

true

正規表現で指定している。

false

正規表現で指定していない。

startsAt

string

サイレンスの適用開始日時（ISO8601拡張形式）を指定します。

日時にはタイムゾーンを指定できます。

（指定例）2022-02-08T19:00:00+09:00

endsAt

string

サイレンスの適用終了日時（ISO8601拡張形式）を指定します。

startAtよりも前の日時や，期限切れの日時（現在時刻よりも前の日時）を指定した場合，サイレンスの作成に失敗します。

日時にはタイムゾーンを指定できます。

（指定例）2022-02-08T21:00:00+09:00

createdBy

string

作成者名を指定します。

comment

string

コメントを指定します。

レスポンスのメッセージボディー

{
"silenceID":"サイレンスID"
}

ステータスコード

ステータスコード

メッセージ

説明

200

OK

サイレンスの作成に成功した。

200以外

OK以外

サイレンスの作成に失敗した。

使用例

OSSのcurlコマンドを利用して，このAPIを実行した場合の使用例を，次に示します。

ます。

> curl --header "Content-Type: application/json" --request POST --data @C:¥tmp¥silence.json "http://localhost:20714/api/v2/silences"
{"silenceID":"9ae46d02-4db8-4098-a8e4-f9181d66611c"}
>

silence.json：

{
    "matchers": [
        {
            "name": "alertname",
            "value": "cpu idel alert",
            "isRegex": false
        }
    ],
    "startsAt": "2021-08-09T19:00:00+09:00",
    "endsAt": "2021-08-09T21:00:00+09:00",
    "createdBy": "api",
    "comment": "test silence"
}

5.21.5　Alertmanagerのサイレンス失効

機能

Alertmanagerに作成されているサイレンスを失効（即時期限切れ）させます。

形式

リクエスト行

DELETE /api/v2/silence/サイレンスID HTTP/1.1

サイレンスIDには，「Alertmanagerのサイレンス一覧取得」APIで取得する値，「Alertmanagerのサイレンス作成」APIの戻り値として返却される値を指定できます。

リクエストヘッダー

ヘッダー名

設定値

Host

APIの接続先のAlertmanagerのホストの情報を，ヘッダーの値として次の形式で指定します。

ホスト名またはIPアドレス:ポート番号

「:ポート番号」は省略可能です。

ホスト名またはIPアドレス

Alertmanagerのホスト名またはIPv4アドレスを指定します。

ポート番号

Alertmanagerに接続する際に使用するポート番号を指定します。

このヘッダーは省略不可です。

リクエストのメッセージボディー

なし。

レスポンスのメッセージボディー

なし。

ステータスコード

ステータスコード

メッセージ

説明

200

OK

サイレンスの失効に成功した。

200以外

OK以外

サイレンスの失効に失敗した。

使用例

OSSのcurlコマンドを利用して，このAPIを実行した場合の使用例を，次に示します。

>curl --request DELETE "http://localhost:20714/api/v2/silence/b37a053b-6172-46dd-8211-be808cc25e01"

>

5.21.6　Alertmanagerのサイレンス取得

機能

指定したサイレンスをJSON形式で取得します。

形式

リクエスト行

GET /api/v2/silence/サイレンスID HTTP/1.1

サイレンスIDには，「Alertmanagerのサイレンス一覧取得」APIで取得する値，「Alertmanagerのサイレンス作成」APIの戻り値として返却される値を指定できます。

リクエストヘッダー

ヘッダー名

設定値

Host

APIの接続先のAlertmanagerのホストの情報を，ヘッダーの値として次の形式で指定します。

ホスト名またはIPアドレス:ポート番号

「:ポート番号」は省略可能です。

ホスト名またはIPアドレス

Alertmanagerのホスト名またはIPv4アドレスを指定します。

ポート番号

Alertmanagerに接続する際に使用するポート番号を指定します。

このヘッダーは省略不可です。

リクエストのメッセージボディー

なし

レスポンスのメッセージボディー

{
    "id": "サイレンスID",
    "status": {
        "state": "ステータス"
    },
    "updatedAt": "更新日時",
    "comment": "コメント",
    "createdBy": "作成者名",
    "endsAt": "終了日時",
    "matchers": [
        {
            "isRegex":正規表現フラグ,
            "name": "ラベル名",
            "value": "値"
        },
        ・・・
    ],
    "startsAt": "開始日時"
}

レスポンスのパラメーター

「5.21.3 Alertmanagerのサイレンス一覧取得」APIの「レスポンスのパラメーター」を参照してください。

ステータスコード

ステータスコード

メッセージ

説明

200

OK

サイレンスの取得に成功した。

200以外

OK以外

サイレンスの取得に失敗した。

使用例

OSSのcurlコマンドを利用して，このAPIを実行した場合の使用例を，次に示します。下記の使用例では，見やすくするために改行とインデントを追加しています。実際の出力結果には改行とインデントは出力されません。また，JSONのプロパティの出力順は不定です。

> curl --request GET "http://localhost:20714/api/v2/silence/00ed3d4d-da1f-4971-81cd-b2687933e602"
{
    "id":"00ed3d4d-da1f-4971-81cd-b2687933e602",
    "status":{
        "state":"active"
    },
    "updatedAt":"2022-08-09T03:35:41.821Z",
    "comment":"cc",
    "createdBy":"aa",
    "endsAt":"2022-08-09T05:35:32.825Z",
    "matchers":[
        {
            "isEqual":true,
            "isRegex":false,
            "name":"env",
            "value":"production"
        }
    ],
    "startsAt":"2022-08-09T03:35:41.821Z"
}

5.22　Blackbox exporterの操作関連のAPI

Alertmanagerの操作関連のAPIに関する操作を説明します。

5.22.1　Blackbox exporterのリロード

機能

Blackbox exporterの定義ファイルを再読み込みし，Blackbox exporterの動作に反映します。

Blackbox exporterのリロードは，Blackbox exporterの再起動と比べて処理が速く，通知失敗時の状態を維持します。

形式

リクエスト行

POST /-/reload HTTP/1.1

リクエストヘッダー

ヘッダー名

設定値

Host

APIの接続先のBlackbox exporterのホストの情報を，ヘッダーの値として次の形式で指定します。

ホスト名またはIPアドレス:ポート番号

「:ポート番号」は省略可能です。

ホスト名またはIPアドレス

Blackbox exporterのホスト名またはIPv4アドレスを指定します。

ポート番号

Blackbox exporterに接続する際に使用するポート番号を指定します。

このヘッダーは省略不可です。

リクエストのメッセージボディー

なし。

レスポンスのメッセージボディー

リロードに成功した場合，レスポンスはなしです。

リロードに失敗した場合，失敗した要因を示すメッセージ（Blackbox exporterが出力する値）が設定されます。

ステータスコード

ステータスコード

メッセージ

説明

200

OK

リロードに成功した。

200以外

OK以外

リロードに失敗した。

注意事項

不正な定義ファイルをリロードした場合，読み込んだ定義ファイルのすべての内容が無効となります。

リロードした内容は，次に実行するBlackbox exporterのAPI（スクレイプなど）から有効となり，実行中のAPIには影響しません。

使用例

OSSのcurlコマンドを利用して，このAPIを実行した場合の使用例を，次に示します。

リロード成功時：

>curl --request POST "http://localhost:20715/-/reload"

>

リロード失敗時：

# curl -request POST http://localhost:20715/-/reload
failed to reload config: error parsing config file: yaml: unmarshal errors:
  line 3: field priber not found in type config.plain

5.23　JP1/IM - Agentが使用するExporterのスクレイプ用のAPI

機能

Prometheus serverのスクレイプ対象の各Exporterのスクレイプを実行します。Prometheus設定ファイル（jpc_prometheus_server.yml）の項目「scrape_interval」に設定された間隔で，スクレイプを実行します。

ステータスコードに200以外が返却されてもリトライは行いません。

通信方式

通信プロトコル：HTTP

ポート番号：Exporterのポート番号

形式

リクエスト行

GET /metrics※ HTTP/1.1

通信プロトコルは「HTTP」だけです。Exporterのポート番号を指定します。

注※

「/metrics」の部分は，Prometheus設定ファイル（jpc_prometheus_server.yml）の<scrape_configs>の項目「metrics_path」で変更できます。

リクエストヘッダー

ヘッダー名

設定値

host

Prometheus設定ファイル（jpc_prometheus_server.yml）の項目「targets」の値が設定されます。

user-agent

「Prometheus/2.23.0」が設定されます。

accept

「application/openmetrics-text; version=0.0.1,text/plain;version=0.0.4;q=0.5,*/*;q=0.1」が設定されます。

accept-encoding

「gzip」が設定されます。

x-prometheus-scrape-timeout-seconds

Prometheus設定ファイル（jpc_prometheus_server.yml）の項目「scrape_timeout」の値が設定されます。

その他

Prometheus設定ファイル（jpc_prometheus_server.yml）の設定内容に合わせて，認証情報などが追加されます。

リクエストのメッセージボディー

なし

レスポンスのメッセージボディー

次に示すPrometheusのテキストフォーマットで情報を返却します。

■基本情報

項目

説明

サポート対象のPrometheusのバージョン

0.40以降

通信プロトコル

HTTP

エンコーディング

UTF-8

改行文字は「¥n」を使用してください。

HTTPコンテンツのデータ形式（Content-Type）

text/plain; version=0.0.4

バージョンの値がない場合は，最新のテキストフォーマットのバージョンとして扱われます。

HTTPコンテンツのエンコーディング（オプション）-

gzip

サポート対象のメトリック

Counter

Gauge

Histogram

Summary

Untyped

■テキストフォーマットの詳細

行単位で記述します。

行の終端の改行文字は'¥n'としてください。

空行は無視されます。

■行のフォーマット

1行に記述するトークンは，任意の数の空白またはタブで区切ることができます。

先頭および末尾の空白は無視されます。

■コメント，ヘルプテキスト，型情報

「#」で始まる行はコメント扱いとなります。「#」の直後のトークンが"HELP"または型情報でない行は無視されます。

「#」の直後のトークンが"HELP"の場合は，少なくとも1つのメトリック名のトークンが必要です。残りのすべてのトークンはそのメトリック名に対する説明文とみなされます。

ヘルプテキストの行は，メトリック名の後ろに任意のUTF-8の文字列を含めることができますが，バックスラッシュ（¥）と改行文字（¥n）については，「¥¥」と「¥¥n」のようにエスケープする必要があります。

ヘルプテキストの行は，1つのメトリック名に対して1行だけ記述できます。

「#」の直後のトークンが型情報の場合は，2つ以上のトークンを記述します。1つ目はメトリック名，2つ目はcounter，gauge，histogram，summary，またはuntypedのどれかで，メトリックの型を定義します。

型情報の行は，1つのメトリック名に対して1行だけ記述できます。

型情報の行は，その行のメトリック名に対する最初のサンプルの前に表示する必要があります。

メトリック名に対する型情報の行が存在しない場合，そのメトリックの型には「untyped」が設定されます。

■サンプルの構文

metric_name [
    "{" label_name "=" `"` label_value `"` { "," label_name "=" `"` label_value `"` } [ "," ] "}"
] value [ timestamp ]

metric_nameとlabel_nameには，通常のPrometheusでの記述の制約があります。

label_valueは，任意のUTF-8文字列です。バックスラッシュ（¥），ダブルクォート（"），ラインフィードは，それぞれ「¥¥」，「¥"」，「¥¥n」として，エスケープする必要があります。

valueは，GoのParseFloat()関数で必要とされる浮動小数点数付きの数値です。通常の数値以外に，NaN（数値ではない），+Inf（正の無限大），-Inf（負の無限大）の値も有効です。

タイムスタンプは，int64（1970-01-01 00:00:00 UTCからのミリ秒（うるう秒を除く））です。GoのParseInt()関数で必要に応じて表示されます。

■グルーピングとソート

1つのメトリックに対するすべての行は，オプションのヘルプテキストの行と型情報の行と合わせて，1つのグループとして提供する必要があります。

各行は，メトリック名とラベルのユニークな組み合わせになっている必要があります。

■テキストフォーマットの例

# HELP http_requests_total The total number of HTTP requests.
# TYPE http_requests_total counter
http_requests_total{method="post",code="200"} 1027 1395066363000
http_requests_total{method="post",code="400"}    3 1395066363000

# Escaping in label values:
msdos_file_access_time_seconds{path="C:¥¥DIR¥¥FILE.TXT",error="Cannot find file:¥n¥"FILE.TXT¥""} 1.458255915e9

# Minimalistic line:
metric_without_timestamp_and_labels 12.47

# A weird metric from before the epoch:
something_weird{problem="division by zero"} +Inf -3982045

# A histogram, which has a pretty complex representation in the text format:
# HELP http_request_duration_seconds A histogram of the request duration.
# TYPE http_request_duration_seconds histogram
http_request_duration_seconds_bucket{le="0.05"} 24054
http_request_duration_seconds_bucket{le="0.1"} 33444
http_request_duration_seconds_bucket{le="0.2"} 100392
http_request_duration_seconds_bucket{le="0.5"} 129389
http_request_duration_seconds_bucket{le="1"} 133988
http_request_duration_seconds_bucket{le="+Inf"} 144320
http_request_duration_seconds_sum 53423
http_request_duration_seconds_count 144320

# Finally a summary, which has a complex representation, too:
# HELP rpc_duration_seconds A summary of the RPC duration in seconds.
# TYPE rpc_duration_seconds summary
rpc_duration_seconds{quantile="0.01"} 3102
rpc_duration_seconds{quantile="0.05"} 3272
rpc_duration_seconds{quantile="0.5"} 4773
rpc_duration_seconds{quantile="0.9"} 9001
rpc_duration_seconds{quantile="0.99"} 76656
rpc_duration_seconds_sum 1.7560473e+07
rpc_duration_seconds_count 2693

6　［統合オペレーション・ビューアー］画面のカスタマイズ

JP1/IM - Manager（インテリジェント統合管理基盤）の［統合オペレーション・ビューアー］画面で，特定のIM管理ノードを選択した際に［関連情報］領域にユーザーが定義した任意の画面を表示する機能について説明します。

6.1　［統合オペレーション・ビューアー］画面のカスタマイズの概要

［統合オペレーション・ビューアー］画面のカスタマイズの概要と，定義ファイルの配置先について説明します。

6.1.1　［統合オペレーション・ビューアー］画面のカスタマイズとは

［統合オペレーション・ビューアー］画面のカスタマイズでは，ユーザーが特定のIM管理ノードを選択した際に，あらかじめ定義した情報に基づいた任意の画面を［詳細表示］領域の［カスタムUI］タブに表示することができます。また，領域のタイトルも定義できます。

［統合オペレーション・ビューアー］画面のカスタマイズを適用した画面イメージを次の図に示します。

図6‒1　［統合オペレーション・ビューアー］画面のカスタマイズの適用例

6.1.2　配置場所

［統合オペレーション・ビューアー］画面のカスタマイズの定義ファイルは，html形式で次の場所にサブフォルダまたはサブディレクトリを作成して配置します。物理ホスト，論理ホストとも同じ配置場所です。クラスタ構成の場合は両系に同一のファイルを配置してください。

なお，「hitachi」から始まるサブディレクトリ名は使用できません。

Windowsの場合

Managerパス¥public¥customUI¥

UNIXの場合

/var/opt/jp1imm/public/customUI/

JP1/IM - Managerをアンインストールする場合は，必要に応じて配置したファイルのバックアップを取得してください。

6.1.3　注意事項

［カスタムUI］タブには，<iframe>タグを使用しています。このため，window.location.hrefなどでWebページを表示する場合に，そのWebページにX-Frame-Optionsが指定されていると，Webページを表示することができません。

Webページを提供するサイト側でJP1/IMからのアクセスを許可するなどの設定をする必要があります。

設定例

X-Frame-Options ALLOW-FROM <JP1/IMのURL>

6.2　［統合オペレーション・ビューアー］画面のカスタマイズの定義情報

［統合オペレーション・ビューアー］画面のカスタマイズの定義情報について説明します。

6.2.1　定義するプロパティ情報

定義するプロパティ情報を次の表に示します。

項目はプロパティ内の1つの<custom UI Id>に対して指定が必須となります。<custom UI Id>に指定する文字列については「6.2.2　<custom UI Id>に指定する文字列」を参照してください。

表6‒1　［統合オペレーション・ビューアー］画面のカスタマイズの定義情報

項番

プロパティ名

指定規則

説明

指定範囲

1

jp1.imdd.gui.settings.contentViews.<custom UI Id>.title

必須

［カスタムUI］タブに表示するタイトルを指定します。※1

半角英数字で長い文字列をタイトルに指定した場合，［カスタムUI］タブのタイトルのツールチップで表示する文字列が，WWWブラウザーによって途中で打ち切られるときがあります。

タイトルの文字列に，適宜，半角スペースまたは全角文字を指定すると，途中で打ち切りされずに，すべての文字がツールチップに表示されるようになります。

1〜255文字

2

jp1.imdd.gui.settings.contentViews.<custom UI Id>.url

必須

［ユーザー定義の画面表示領域］に表示したいhtmlファイルのパスをpublicからの相対パスで指定します。※1

パス区切り文字は「/」を使用する必要があります。半角スペース「 」を含む場合でも，前後をダブルクォート「"」で囲む必要はありません。

なお，urlに存在しないパスが指定された場合は，［ユーザー定義の画面表示領域］に「Not Found 指定したパス」の形式でメッセージが表示されます。

1〜255文字

3

jp1.imdd.gui.settings.contentViews.<custom UI Id>.sid

必須※2

ユーザー定義の画面を表示するIM管理ノードのツリーのSIDを指定します。

正規表現※3で指定できます。なお，指定したツリーのSIDが存在するかどうかのチェックはしません。

1〜1,048,576文字

4

jp1.imdd.gui.settings.contentViews.<custom UI Id>.target

必須※2

ユーザー定義の画面を表示するIM管理ノードのSIDを指定します。

正規表現※3で指定できます。なお，指定したSIDが存在するかどうかのチェックはしません。

注※1

2バイト文字を指定する場合はUnicodeに変換してください。その場合の文字数は，Unicodeに変換済みの文字列の文字数でカウントされます。指定できるのは制御文字以外の文字列です。機種依存文字は指定できません。

注※2

1つの<custom UI Id>に対して，sidまたはtargetのどちらかを必ず指定してください。なお，指定できる文字は，指定するツリーのSIDまたは構成情報のSIDに準じます。

注※3

正規表現で指定する場合，すべての文字に一致する表現の「.*」を多用すると，検索に時間が掛かることがあります。「.*」を使用する場合は，必要な個所にだけ「.*」を使用するようにしてください。

6.2.2　<custom UI Id>に指定する文字列

プロパティの<custom UI Id>には任意の文字列を指定し，キーがユニークになるように記載する必要があります。

指定できる文字列は半角英数字です。大文字・小文字を区別します。1〜255文字以内で指定します。「_HITACHI」から始まる文字列は指定できません。

同一のキーに対して複数の文字列を定義した場合は，あとに定義した文字列が有効となります。

指定例を次に示します。

jp1.imdd.gui.settings.contentViews.sample.title =Custom+UI
jp1.imdd.gui.settings.contentViews.sample.url = ./customUI/sample/index.html
jp1.imdd.gui.settings.contentViews.sample.target =^(?=.*MYHOST).*$

jp1.imdd.gui.settings.contentViews.sample2.title =Custom+UI
jp1.imdd.gui.settings.contentViews.sample2.url = ./customUI/sample2/index.html
jp1.imdd.gui.settings.contentViews.sample2.sid = _ROOT_AllSystems

6.2.3　インテリジェント統合管理基盤定義ファイル（imdd.properties）の記載例

定義内容はインテリジェント統合管理基盤定義ファイル（imdd.properties）に記載します。インテリジェント統合管理基盤定義ファイル（imdd.properties）については，「インテリジェント統合管理基盤定義ファイル（imdd.properties）」（2.　定義ファイル）を参照してください。

インテリジェント統合管理基盤定義ファイル（imdd.properties）のモデルファイル（imdd.properties.model）の記載を次に示します。

server.port = 20703

#jp1.imdd.gui.settings.contentViews.<custom UI Id>.title =
#jp1.imdd.gui.settings.contentViews.<custom UI Id>.url =
#jp1.imdd.gui.settings.contentViews.<custom UI Id>.sid =
#jp1.imdd.gui.settings.contentViews.<custom UI Id>.target =

(1)　複数のカスタムUIを表示する場合

1つのIM管理ノードに対して，異なる<custom UI Id>の定義を複数行うと，定義した数の［カスタムUI］タブが表示されます。

なお，［カスタムUI］タブの表示順序は，インテリジェント統合管理基盤定義ファイル（imdd.properties）に定義した順番で表示されます。

定義例を次に示します。

jp1.imdd.gui.settings.contentViews.System01CustomUI1.title = System01¥u30ab¥u30b9¥u30bf¥u30e0UI1
jp1.imdd.gui.settings.contentViews.System01CustomUI1.url = ./customUI/sample/customUI1.html
jp1.imdd.gui.settings.contentViews.System01CustomUI1.sid = _ROOT_AllSystems/_SYSTEM_SYSTEM01

jp1.imdd.gui.settings.contentViews.System01CustomUI2.title = System01¥u30ab¥u30b9¥u30bf¥u30e0UI2
jp1.imdd.gui.settings.contentViews.System01CustomUI2.url = ./customUI/sample/customUI2.html
jp1.imdd.gui.settings.contentViews.System01CustomUI2.sid = _ROOT_AllSystems/_SYSTEM_SYSTEM01

jp1.imdd.gui.settings.contentViews.System01CustomUI3.title = System01¥u30ab¥u30b9¥u30bf¥u30e0UI3
jp1.imdd.gui.settings.contentViews.System01CustomUI3.url = ./customUI/sample/customUI3.html
jp1.imdd.gui.settings.contentViews.System01CustomUI3.sid = _ROOT_AllSystems/_SYSTEM_SYSTEM01

重要

1つのIM管理ノードに対して表示できる［カスタムUI］タブの数は，10個までです。

6.2.4　定義情報の確認

インテリジェント統合管理基盤定義ファイル（imdd.properties）に記載したIM管理ノードを選択した際に任意の画面を出すための設定内容が正しいかは，［統合オペレーション・ビューアー］画面で確認します。

対象のIM管理ノードを選択し，意図した画面が表示されるかを確認してください。定義情報が不正な場合は，WWWブラウザーのコンソールに表示されるエラーの詳細を確認し対処してください。

6.3　ユーザー定義画面で使用できるメソッドとオブジェクト

ユーザー定義の画面のhtmlでインテリジェント統合管理基盤が提供するインターフェースを利用するためには，次のjsファイルを読み込みます。

Windowsの場合

Managerパス¥public¥assets¥js¥customContent.js

Managerパス¥public¥assets¥js¥vendor.js

UNIXの場合

/opt/jp1imm/public/assets/js/customContent.js

/opt/jp1imm/public/assets/js/vendor.js

記述例については，「6.3.1　CustomContent.initialize」の使用例を参照してください。

ユーザー定義画面で使用できるメソッドとオブジェクトを，次に示します。

表6‒2　ユーザー定義画面で使用できるメソッドとオブジェクト

メソッド名

機能

CustomContent.initialize

引数で受け取ったイベントハンドラで初期化処理を行うメソッドです。

CustomContent.simt

Simtデータを操作するメソッドを提供します。

CustomContent.node

統合オペレーション・ビューアーで選択したIM管理ノードの情報を持つオブジェクトです。

CustomContent.options.props

クライアントの情報を持つオブジェクトです。

CustomContent.postActions

指定されたプラグインの関数を実行するメソッドです。

CustomContent.showMessage

［タイトル・メッセージ］表示領域に表示するメッセージを定義するメソッドです。

CustomContent.selectNodeByTreeSid

引数に指定したSIDのIM管理ノードを，統合オペレーション・ビューアーで選択状態とするメソッドです。

CustomContent.selectNodeByTargetSid

6.3.1　CustomContent.initialize

機能

引数で受け取ったイベントハンドラで初期化処理を行うメソッドです。

ユーザー定義画面を描画する際には，必ずこのメソッドを実行してください。

形式

initialize(handlers)

引数

ユーザー定義画面で取得したいイベントと，イベントを取得した際に実行される関数名の受け渡しを定義します。

handlers

イベントハンドラ

イベントハンドラの種類を次に示します。

onSetup()

setupイベントハンドラ

ユーザー定義画面を初めて描画するときに発生するイベントのハンドラです。

onActivate()

有効化イベントハンドラ

ユーザー定義画面の描画が完了したときに発生するイベントのハンドラです。

onInactivate()

無効化イベントハンドラ

描画したユーザー定義画面に別の画面を表示するときに発生するイベントのハンドラです。

onNodeSelect(node)

ノード選択イベントハンドラ

IM管理ノードが選択されたときに発生するイベントのハンドラです。

onStatusUpdate(node)

ノード状態更新イベントハンドラ

選択中のIM管理ノードに関わらず，IM管理ノードの状態が更新されたときに発生するイベントのハンドラです。

戻り値

なし

使用例

次の場合の使用例を示します。

onSetupイベントを受け取った時にユーザー定義画面のSetup関数が実行される。

onNodeSelectイベントを受け取った時にユーザー定義画面のNodeSelect関数が実行される。

onActivateイベントを受け取った時にユーザー定義画面のActivate関数が実行される。

<html>
<script src="/assets/js/vendor.js"></script>
<script src="/assets/js/customContent.js"></script>
<script>

CustomContent.initialize({
  onSetup: Setup,
  onNodeSelect: NodeSelect,
  onActivate: Activate
});
function Activate() {
alert("onActivate");
}
function NodeSelect () {
alert("onNodeSelect ");
}
function Setup () {
alert("onSetup");
}
</script>
</html>

6.3.2　CustomContent.simt

Simtデータを操作するメソッドを提供します。CustomContent.simtが提供するメソッドを次に示します。

表6‒3　CustomContent.simtが提供するメソッド一覧

項番

メソッド名

説明

1

encodeValue

文字列をURLエンコードして返却するメソッドです。

2

decodeValue

URLエンコードされた文字列をデコードして返却するメソッドです。

3

filter

指定された構造化IDを含むSIDとそのvalue値を返却するメソッドです。

4

get

指定されたSIDに一致するSIDとそのvalue値を返却するメソッドです。

5

pack

構造化IDの種別と名称を結合し，生成した構造化IDを返却するメソッドです。

6

packHost

構造化IDの種別とホスト名を結合し，生成した構造化IDを返却するメソッドです。

7

unpack

構造化IDを種別と名称で分割し，返却するメソッドです。

8

join

構造化ID を結合し，生成したSID を返却するメソッドです。

9

split

SIDを構造化IDに分割し，返却するメソッドです。

10

parse

SID を構造化IDに分割し，分割した構造化IDをさらに種別とURLデコードした名称に分割し返却するメソッドです。

11

data

SIDとvalue値から，オブジェクトを生成し，返却するメソッドです。

(1)　encodeValueメソッド

機能

パラメーターに指定された文字列の「.」「~」「-」「:」以外の記号，英数字以外をURLエンコードし，返却するメソッドです。

形式

encodeValue(value)

引数

value

URLエンコードする文字列

戻り値

URLエンコードされた文字列

(2)　decodeValueメソッド

機能

パラメーターに指定された文字列をデコードし，返却するメソッドです。

形式

decodeValue(value)

引数

value

URLエンコードされた文字列

戻り値

URLデコードされた文字列

(3)　filterメソッド

機能

第1パラメーターに指定されたSimtDataオブジェクト（SIDとvalue値の情報をまとめたオブジェクト）の配列から，第2パラメーターに指定された構造化IDを含むSIDを持つSimtDataオブジェクトを抜き出して返却するメソッドです。

形式

filter(array, pattern)

引数

array

SimtDataオブジェクト※の配列

pattern

構造化ID

戻り値

SimtDataオブジェクト※の配列

指定された構造化IDを含むSIDを持つSimtData※

オブジェクトが存在しない場合は空の配列を返却します。

注※　SimtDataオブジェクトには次に示すプロパティが存在します。

sid：SIDを示す文字列

value：SIDの値を格納するオブジェクト

(4)　getメソッド

機能

第1パラメーターに指定されたSimtDataオブジェクト（SIDとvalue値の情報をまとめたオブジェクト）の配列から，第2パラメーターに指定されたSIDに一致するSIDを持つSimtDataオブジェクトを抜き出して返却するメソッドです。

形式

get(array, sid)

引数

array

SimtDataオブジェクト※の配列

pattern

SID

戻り値

SimtDataオブジェクト※

指定されたSIDと一致するSIDを持つSimtDataオブジェクト※

オブジェクトが存在しない場合は空のnullを返却します。

注※　SimtDataオブジェクトには次に示すプロパティが存在します。

sid：SIDを示す文字列

value：SIDの値を格納するオブジェクト

(5)　packメソッド

機能

第1パラメーターに指定された構造化IDの種別（アンダースコア以外）を「_（アンダースコア）」で括り，第2パラメーターに指定された名称のうち「.」「~」「-」「:」以外の記号，英数字以外をURLエンコードしたあとに，種別，名称の順で結合し，生成した構造化IDを返却するメソッドです。

形式

pack(key, value)

引数

key

構造化IDの種別

value

構造化IDの名称

戻り値

構造化IDの文字列

(6)　packHostメソッド

機能

第1パラメーターに指定された構造化IDの種別（アンダースコア以外）を「_（アンダースコア）」で括り，第2パラメーターに指定された名称（ホスト名）を大文字変換および「.」「~」「-」「:」以外の記号，英数字以外をURLエンコードしたあとに，種別，名称の順で結合し，生成した構造化IDを返却するメソッドです。

名称がホスト名以外の構造化IDを作成する場合は，CustomContent.simt.packメソッドを使用します。

形式

packHost(key, value)

引数

key

構造化IDの種別

value

構造化IDの名称（ホスト）

戻り値

構造化IDの文字列

(7)　unpackメソッド

機能

指定された構造化IDを種別（アンダースコア以外）とURLデコードした名称に分割し，両者を格納したSimtIdUnitオブジェクトを返却するメソッドです。

形式

unpack(simtId)

引数

simtId

構造化ID

戻り値

SimtIdUnitオブジェクト※

注※　SimtIdUnitオブジェクトには次に示すプロパティが存在します。

key：構造化IDの種別（アンダースコア以外）

value：構造化IDのURLデコードした名称

(8)　joinメソッド

機能

パラメーターに指定された複数の構造化IDを「/（スラッシュ）」で結合し，生成したSIDを返却するメソッドです。

形式

join(...simtId)

引数

simtId

構造化ID

戻り値

SIDの文字列

(9)　splitメソッド

機能

パラメーターに指定されたSIDを「/（スラッシュ）」で分割し，構造化IDを返却するメソッドです。

形式

split(sid)

引数

sid

SID

戻り値

構造化IDの文字列の配列

(10)　parseメソッド

機能

パラメーターに指定されたSIDを構造化IDに分割し，分割した構造化IDをさらに「_（アンダースコア）」を除外した種別とURLデコードした名称に分割します。それらの情報をSimtIdUnitオブジェクトとして格納し，SimtIdUnitオブジェクトを格納した配列を返却するメソッドです。

形式

parse(sid)

引数

sid

SID

戻り値

SimtIdUnitオブジェクト※の配列

注※　SimtIdUnitオブジェクトには次に示すプロパティが存在します。

key：構造化IDの種別（アンダースコア以外）

value：構造化IDのURLデコードした名称

(11)　dataメソッド

機能

パラメーターに指定されたSIDとvalue値から，SimtDataオブジェクトを生成し，返却するメソッドです。

形式

data(sid, value)

引数

sid

SID

value

value値

戻り値

SID とvalue値の情報をまとめたSimtDataオブジェクト※

注※　SimtDataオブジェクトには次に示すプロパティが存在します。

sid：SIDを示す文字列

value：SIDのvalue値を格納するオブジェクト

6.3.3　CustomContent.node

統合オペレーション・ビューアーで選択したIM管理ノードの情報を持つオブジェクトです。CustomContent.nodeのプロパティを次に示します。

表6‒4　CustomContent.nodeのプロパティ

項番

プロパティ名

説明

1

CustomContent.node.sid

統合オペレーション・ビューアーで選択したIM管理ノードのツリーのSIDの情報

2

CustomContent.node.value.target

統合オペレーション・ビューアーで選択したIM管理ノードのSIDの情報

3

CustomContent.node.value.label

統合オペレーション・ビューアーで選択したIM管理ノードのラベルの情報

6.3.4　CustomContent.options.props

クライアントの情報を持つオブジェクトです。CustomContent.options.propsのプロパティを次に示します。

表6‒5　 CustomContent.options.propsのプロパティ

項番

プロパティ名

説明

1

CustomContent.options.language

クライアントの言語種別の情報

2

CustomContent.options.clientId

クライアントIdの情報

3

CustomContent.options.props.title※

統合オペレーション・ビューアーで選択したIM管理ノードに関連したtitleの設定情報

4

CustomContent.options.props.url※

統合オペレーション・ビューアーで選択したIM管理ノードに関連したurlの設定情報

5

CustomContent.options.props.target※

統合オペレーション・ビューアーで選択したIM管理ノードに関連したtargetの設定情報

6

CustomContent.options.props.sid※

統合オペレーション・ビューアーで選択したIM管理ノードに関連したsidの設定情報

7

CustomContent.options.auth.jp1user

ログインしているJP1ユーザーIdの情報

8

CustomContent.options.auth.jp1token

ログインしているJP1ユーザーのJP1トークンの情報

9

CustomContent.options.auth.token

クライアントのトークンの情報

10

CustomContent.options.auth.acl.permissions

ログインしているJP1ユーザーが保持している権限情報の配列

注※

インテリジェント統合管理基盤定義ファイル（imdd.properties）の次のパラメーターに定義した値が表示されます。

CustomContent.options.propsのプロパティ

インテリジェント統合管理基盤定義ファイルのパラメーター

CustomContent.options.props.title

jp1.imdd.gui.settings.contentViews.<custom UI Id>.title

CustomContent.options.props.url

jp1.imdd.gui.settings.contentViews.<custom UI Id>.url

CustomContent.options.props.target

jp1.imdd.gui.settings.contentViews.<custom UI Id>.target

CustomContent.options.props.sid

jp1.imdd.gui.settings.contentViews.<custom UI Id>.sid

6.3.5　CustomContent.postActions

機能

指定されたプラグインの関数を実行するメソッドです。

形式

postActions(method, sid, args)

引数

method

実行するプラグインの名称

sid

プラグイン処理の対象のIM 管理ノードのSID

args

実行するプラグイン関数の引数args.methodArgsに渡す値を指定します。渡す情報が存在しない場合は，空オブジェクト（{}）を指定します。

戻り値

実行したアクションの結果を表すオブジェクト。オブジェクトの内容は実行したアクションによって異なります。

6.3.6　CustomContent.showMessage

機能

引数messageに指定した文字列を［メッセージ表示領域］に表示するメソッドです。

指定した文字列がエラーのメッセージIDから始まっている場合は，メッセージの前に[図データ]を表示します。

指定した文字列がワーニングのメッセージIDから始まっている場合は，メッセージの前に[図データ]を表示します。

その他の場合は，メッセージの前に[図データ]を表示します。

形式

showMessage(message)

引数

message

［メッセージ表示領域］に表示する文字列

戻り値

なし

6.3.7　CustomContent.selectNodeByTreeSid

機能

引数に指定したツリーのSIDのIM管理ノードを，統合オペレーション・ビューアーで選択状態とするメソッドです。

形式

selectNodeByTreeSid(sid)

引数

sid

統合オペレーション・ビューアーで選択状態にするIM管理ノードのツリーのSID

戻り値

なし

6.3.8　CustomContent.selectNodeByTargetSid

機能

引数に指定したSIDのIM管理ノードを，統合オペレーション・ビューアーで選択状態とするメソッドです。

形式

selectNodeByTargetSid(sid)

引数

sid

統合オペレーション・ビューアーで選択状態にするIM管理ノードのSID

戻り値

なし

7　インテリジェント統合管理基盤を使うための情報

インテリジェント統合管理基盤を使うために必要なSIDやjsonオブジェクト，およびユーザー作成プラグインを利用するために必要なアダプタコマンドの情報，IM管理ノードツリー生成機能について説明しています。また，サンプルプラグイン，制御文字についても説明しています。

7.1　SID

SIDとは，構成取得アダプタコマンドおよびユーザー作成プラグインを使って取得した各製品の構成要素を一意に表すID（SID）です。構成情報のSID，ツリーのSID，イベントのSIDの三種類があり，JP1/IM - Manager（インテリジェント統合管理基盤）で付与します。

SIDは，構成要素を表す種別と，その種別に対応する名称の組み合わせ（構造化ID）をスラッシュ「/」で表します。SIDの構成例を次に示します。

図7‒1　 SIDの構成例

SIDの並び順には意味があり，各製品の構成要素の包含関係に基づきます。詳細については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の各製品から取得する情報の節を参照してください。

SIDの規則を次に示します。

SIDの種別，名称に指定できる文字は「_」（アンダースコア），「/」（スラッシュ），制御コードの3種を除いたASCII文字です。

「.」（ピリオド），「~」（チルダ），「-」（ハイフン），「: 」（コロン）以外の記号，英数字以外はURLエンコードしてください。URLエンコードしたSIDはデコードできる必要があります。

ホスト名に指定できる文字は大文字です。SIDとしては大文字・小文字を区別します。

SIDのバイト長は1〜1,048,576バイト（1メガバイト）です。SIDは「/（スラッシュ）」で終わってはいけません。

7.1.1　構成情報のSID

構成情報のSIDは，システムの構成情報を表すSIDです。

構成情報のSIDの種別には，製品ごとに使用する種別と共通で使用する種別が設定されます。それぞれで使用する種別名の予約語を次の表に示します。

表7‒1　構成情報のSIDの種別名の予約語

項番

使用製品

種別名※1

意味

指定する名称※2

1

共通

_HOST_

ホスト名を表す。

ホスト名

2

JP1/AJS3

_JP1AJS-M_

JP1/AJS3 - Managerであることを表す。

JP1/AJS3 - Managerが入っているホスト名

3

_JP1AJS-A_

JP1/AJS3 - Agentであることを表す。

JP1/AJS3 - Agentが入っているホスト名

4

_JP1AJSMGR_

JP1/AJS3 - Managerであることを表す。

指定しない

5

_JP1AJSAGT_

JP1/AJS3 - Agentであることを表す。

指定しない

6

_JP1AJSSCHE_

JP1/AJS3のスケジューラーサービスであることを示す。

指定しない

7

_JP1ROOTJOBNET_

ルートジョブネット名を表す。

ルートジョブネット名

8

_JP1ROOTJOBNETDUMMY_

ジョブネットのリンク情報で先行ノードまたは後続ノードが不明なことを表す。

UNKNOWN

9

JP1/AJS3

JP1/IM

_JP1SCHE_

スケジューラーサービス名を表す。

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

10

_JP1JOBG_

ジョブグループ名を表す。

ジョブグループ名

11

JP1/PFM

_JP1PFM-M_

JP1/PFM - Managerであることを表す。

JP1/PFM - Managerが入っているホスト名

12

_JP1PFM-A_

JP1/PFM - AgentまたはJP1/PFM - RMのサービスIDを表す。

サービスID

13

_JP1PFM-AHOST_

JP1/PFM - AgentまたはJP1/PFM - RMが稼動するホスト名，またはJP1/PFM - RMの監視対象ホスト名を表す。

JP1/PFM - AgentまたはJP1/PFM - RMが稼動するホスト名，またはJP1/PFM - RMの監視対象ホスト名

14

_JP1PFMMGR_

JP1/PFM - Managerであることを表す。

指定しない

15

_JP1PFMBASE_

JP1/PFM-Baseであることを表す。

指定しない

16

_JP1AGENTSERVICE_

JP1/PFM - AgentまたはJP1/PFM - RMのサービスであることを表す。

指定しない

17

JP1/IM

JP1/Base

_JP1IM_

該当ホストがJP1/IMの統合マネージャーであることを表す。

JP1/IMの統合マネージャーが入っているホスト名

18

_JP1IMBASEMGR_

該当ホストがIMの拠点/中継マネージャーであることを表す。

IMの拠点/中継マネージャーが入っているホスト名

19

_JP1IMRM_

該当ホストがリモート監視ホストであることを表す。

リモート監視対象のホスト名

20

_JP1IMMGR_

JP1/IM - Managerであることを表す。

指定しない

21

_JP1BASE_

該当ホストにJP1/Baseが入っていることを表す。

JP1/Baseが入っているホスト名

22

_JP1BASEAGT_

JP1/Baseであることを表す。

指定しない

23

_JP1BASETRAP_

ログファイルトラップ/イベントログトラップであることを表す。

指定しない

24

JP1/IM

_ROOT_

システムのルート名を表す。

システムのルート名

25

_SYSTEM_

システム名を表す。

システム名

26

_CATEGORY_

カテゴリ名を表す。

カテゴリ名

27

_SUBCATEGORY_

サブカテゴリ名を表す。

サブカテゴリ名

28

_OBJECT_

管理オブジェクト名を表す。

管理オブジェクト名

29

JP1/NNMi

_JP1NNMI-M_

JP1/NNMiであることを表す。

JP1/NNMiが入っているホスト名

30

_JP1NNMI-A_

JP1/NNMiが検出しているノードであることを表す。

JP1/NNMiが検出しているノード名

31

_JP1NNMiMGR_

JP1/NNMiであることを表す。

指定しない

32

_NNMINODE_

JP1/NNMiが検出しているノードであることを表す。

指定しない

33

JP1/OA

JP1/NNMi

JP1/SSO

_NETWORKDEVICE_

ネットワーク機器であることを表す。

ホスト名，IPスイッチ名またはFCスイッチ名

34

JP1/OA

_JP1OA

JP1/OAであることを表す。

JP1/OAが入っているホスト名

35

_JP1OA-A

JP1/OAの監視対象を表す。

JP1/OAの監視対象名

36

_JP1OAMGR_

JP1/OAであることを表す。

指定しない

37

_CONSUMER_

監視対象（コンシューマー）を表す。

コンシューマー名

38

_CONTAINERCLUSTER_

監視対象（コンテナクラスタ）を表す。

コンテナ環境クラスタ名

39

_CONTAINERNODE_

監視対象（コンテナノード）を表す。

コンテナ環境ノード名

40

_SERVERCLUSTER_

監視対象（クラスタ）を表す。

クラスタ名

41

_HYPERVISOR_

監視対象（ハイパーバイザー）を表す。

ハイパーバイザー名

42

_VM_

監視対象（仮想マシン）を表す。

仮想マシン名

43

_STORAGE_

監視対象（ストレージシステム）を表す。

ストレージシステム名

44

_STORAGEVOLUME_

監視対象（ボリューム）を表す。

ボリューム名

45

JP1/SSO

_JP1SSO-M_

JP1/SSOのマネージャーに関するSIDであることを表す。

JP1/SSOが入っているホスト名

46

_JP1SSO-A_

JP1/SSOのエージェントに関するSIDであることを表す。

JP1/SSOのエージェントのホスト名

47

_JP1SSOMGR_

JP1/SSOのマネージャーであることを表す。

指定しない

48

_JP1SSOAGT_

JP1/SSOのエージェントであることを表す。

指定しない

注※1

種別の文字長は1〜255文字です。

注※2

名称の文字長は0から255文字です。ただし，オブジェクトルートノード種別に対する名称の文字長は1から255文字です。

構成情報のSIDには各種別に対応する値とは別に，value値として情報の付与が可能です。付与情報の例を次の図に示します。

図7‒2　構成情報のSIDに指定する付与情報の例

構成情報のSIDの付与情報の項目を次の表に示します。

表7‒2　構成情報のSIDの付与情報

項番

使用製品

変数名

意味

1

共通

component

コンポーネント名です。__configurationGetメソッドのcomponentの値です。

すべての構成情報のSIDに付与します。

2

jp1ResourceGroup

JP1資源グループ名を1〜64文字で指定します。指定できる文字は半角英数字と次の半角記号です。

!#$%&'()*-.@¥^_`{}~

この変数は，省略できます。

3

category

カテゴリを1〜255文字で指定します。指定できる文字は半角英数字です。指定できる値は「表4-2 category変数に指定できるカテゴリID」を参照してください。この変数は，省略できます。

4

subCategory

製品の略称名称を1〜255文字で指定します。指定できる文字は，制御文字以外の文字です。JP1製品の場合は「JP1/」で始まる文字列となります。この変数は，省略できます。

5

visible

［稼働状況］領域に表示するかどうかを指定します。

true：表示する

false：表示しない

trueを指定します。

6

label

ツリーに表示する構成要素の表示名称を，1〜255文字で指定します。JP1製品の場合は「JP1/」で始まる文字列となります。指定できる文字は，制御文字以外の文字です。この変数は，省略できます。

7

methods

当該構成要素に対して，実行可能なプラグイン関数の名称のリストです。

どの製品のプラグインか意識せずに，関数を実行できるようにするための情報です。そのため，製品固有の関数は登録しないでください。「_」（アンダースコア）から始まる関数名の関数だけを登録してください。

そのノードに対して実行可能かをクライアントが識別するための情報です。ユーザープラグインの拡張性を考慮し，ノードに該当するプラグインはmethodsに無いメソッドが呼び出されてもエラーとはせず，即時returnとしてください。

8

property

各構成要素のプロパティ情報をobject形式で指定します。

指定できる要素数は，0〜100個です。指定できるプロパティ名は，1〜64文字の制御文字以外の文字です。指定できるプロパティ値は，1〜255文字の制御文字以外の文字です。この変数は，省略できます。

指定例：

"property":{"DataModelVersion":"yyy",…}

9

jp1im_TrendData_labels

トレンドデータの参照時に，SIDに紐付くラベル名とラベル値をobject形式で指定します。

指定できる要素数は，0〜100個です。指定できるプロパティ名は，1〜255文字の制御文字以外の文字です。指定できるプロパティ値は，1〜2,595文字の制御文字以外の文字です。この変数は，省略できます。

指定例：

"jp1im_TrendData_labels":{"instance":"host1:9001"}

10

JP1/AJS

jobExecAgentList

実行エージェント名情報です。

11

JP1/PFM

productId

JP1/PFM - AgentまたはJP1/PFM - RMのプロダクトID

12

dataModelVersion

JP1/PFM - AgentまたはJP1/PFM - RMのデータモデルバージョン

13

wcHostName

JP1/PFM - Web Consoleのホスト名

14

portNumber

JP1/PFM - Web Consoleのポート番号

15

protocol

https通信設定

7.1.2　ツリーのSID

ツリーのSIDは，システム管理ツリー上のパスを表すSIDです。IM管理ノードをツリー形式で表現したときの各ノードへのパスの情報を，IDとして扱います。

ツリーのSIDでは，構成要素を表す種別と，その種別に対応する名称の組み合わせ（構造化ID）をスラッシュ「/」でつなぎ合わせる際に，各ノードへのパスの形式となるようにつなぎ合わせます。

また，ツリーのSIDの種別は構成情報のSIDと異なり，「_ROOT_AllSystems」から始まる必要があります。ツリー全体の階層数の上限は45階層です。

ツリーのSIDの種別を次に示します。

表7‒3　ツリーのSIDの種別名の予約語

項番

種別名

意味

1

_ROOT_

システムのルート名を表す。名称にはシステムのルート名を指定する。

2

_SYSTEM_

システム名を表す。名称にはシステム名を指定する。

3

_HOST_

ホスト名を表す。名称にはホスト名を指定する。

3

_CATEGORY_

カテゴリ名を表す。名称にはカテゴリ名を指定する。

4

_SUBCATEGORY_

サブカテゴリ名を表す。名称にはサブカテゴリ名を指定する。

5

_OBJECT_

管理オブジェクト名を表す。名称には管理オブジェクト名を指定する。

ツリーの構成とツリーのSIDの例を，次に示します。

図7‒3　ツリーの構成とツリーのSIDの例

ツリーのSIDの付与情報を次に示します。

表7‒4　ツリーのSIDの付与情報

変数名

意味

target

ツリーのSIDに対応する構成情報のSID

ツリーのSIDに対応する構成情報のSIDが存在しない場合は，空の配列を指定します。指定するSIDは存在するSIDを指定する必要があります。

label

ツリーに表示する構成要素の表示名称

ツリーのSIDの付与情報のlabelまたはシステムノード定義ファイル（imdd_systemnode.conf）のdisplayNameの情報を引き継ぎます。

情報が無い場合，この変数は省略できます。

resourceGroup

資源グループ情報

ツリーのSIDの付与情報のlabelまたはシステムノード定義ファイル（imdd_systemnode.conf）のjp1ResourceGroupの情報を引き継ぎます。

情報が無い場合，この変数は省略できます。

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

7.1.3　JP1イベントのSID

JP1イベントのSIDは，各JP1イベントを一意に識別するためのIDです。

JP1イベントのSIDの種別を次に示します。

表7‒5　 JP1イベントのSIDの種別名の予約語

項番

種別名

意味

1

_JP1IM

JP1IMのイベントであることを表す。名称にはIMマネージャーホスト名を指定する。

2

_JP1IMSEQNO_

統合監視DB内通し番号を表す。名称には統合監視DB内通し番号を指定する。

3

_JP1IMEVBSEQNO_

イベントDB内通し番号を表す。名称にはイベントDB内通し番号を指定する。

JP1イベントのSIDの例

_JP1IM_imhost1/_JP1IMSEQNO_697/_JP1IMEVBSEQNO_7

7.1.4　各製品から取得する情報

JP1/IM - Manager（インテリジェント統合管理基盤）と連携する各製品は，アダプタコマンド，およびプラグインで取得した各製品の構成情報からSIDを生成します。生成されたSIDはインテリジェント統合管理基盤で管理します。

各製品から取得する情報の種類と，その形式を次に示します。なお，valueの内容は，製品ごとに異なります。

(1)　JP1/IMまたはJP1/Baseから取得する情報

JP1/IMまたはJP1/Baseから取得する情報の種類と，その形式を次に示します。

表7‒6　JP1/IMまたはJP1/Baseから取得する情報の種類と取得形式

情報の種類

取得する形式

JP1/IM - Manager（統合マネージャー）が入っているホスト名

{"sid":"_JP1IM_統合マネージャーホスト名/_HOST_統合マネージャーホスト名","value":{…}},…

上記ホスト内のJP1/IM - Manager（統合マネージャー）

{"sid":"_JP1IM_統合マネージャーホスト名/_HOST_統合マネージャーホスト名/_JP1IMMGR_","value":{…}},…

統合マネージャーおよび統合マネージャー配下のJP1/Baseが存在するホスト

{"sid":"_JP1IM_統合マネージャーホスト名/_JP1BASE_Baseホスト名/_HOST_Baseホスト名","value":{…}},…

上記ホストに入っている統合マネージャーおよび統合マネージャー配下のJP1/Base

{"sid":"_JP1IM_統合マネージャーホスト名/_JP1BASE_Baseホスト名/_HOST_Baseホスト名/_JP1BASEAGT_","value":{…}},…

統合マネージャーおよび統合マネージャー配下のJP1/Baseが入っているホストで行われているログファイルトラップおよびイベントログトラップ

{"sid":"_JP1IM_統合マネージャーホスト名/_JP1BASE_Baseホスト名/_HOST_Baseホスト名/_JP1BASETRAP_","value":{…}},…

統合マネージャー配下のリモート監視ホスト

{"sid":"_JP1IM_統合マネージャーホスト名/_JP1IMRM_リモート監視ホスト名/_HOST_リモート監視ホスト名","value":{…}},…

統合マネージャー配下のリモート監視ホストで行われているログファイルトラップおよびイベントログトラップ

{"sid":"_JP1IM_統合マネージャーホスト名/_JP1IMRM_リモート監視ホスト名/_HOST_リモート監視ホスト名/_JP1BASETRAP_","value":{…}},…

統合マネージャー配下の拠点/中継マネージャーが入っているホスト

{"sid":"_JP1IM_統合マネージャーホスト名/_JP1IMBASEMGR_拠点/中継マネージャーホスト名/_HOST_拠点/中継マネージャーホスト名","value":{…}},…

上記ホストに入っているJP1/IM - Manager（統合マネージャー配下の拠点/中継マネージャー）

{"sid":"_JP1IM_統合マネージャーホスト名/_JP1IMBASEMGR_拠点/中継マネージャーホスト名/_HOST_拠点/中継マネージャーホスト名/_JP1IMMGR_","value":{…}},…

拠点/中継マネージャーおよび拠点/中継マネージャー配下のJP1/Baseが入っているホスト

{"sid":"_JP1IM_統合マネージャーホスト名/_JP1IMBASEMGR_拠点/中継マネージャーホスト名/_JP1BASE_Baseホスト名/_HOST_Baseホスト名","value":{…}},…

上記ホストに入っている拠点/中継マネージャーおよび拠点/中継マネージャー配下のJP1/Base

{"sid":"_JP1IM_統合マネージャーホスト名/_JP1IMBASEMGR_拠点/中継マネージャーホスト名/_JP1BASE_Baseホスト名/_HOST_Baseホスト名/_JP1BASEAGT_","value":{…}},…

拠点/中継マネージャーおよび拠点/中継マネージャー配下のJP1/Baseが入っているホストで行われているログファイルトラップおよびイベントログトラップ

{"sid":"_JP1IM_統合マネージャーホスト名/_JP1IMBASEMGR_拠点/中継マネージャーホスト名/_JP1BASE_Baseホスト名/_HOST_Baseホスト名/_JP1BASETRAP_","value":{…}},…

拠点/中継マネージャー配下のリモート監視ホストとホスト

{"sid":"_JP1IM_統合マネージャーホスト名/_JP1IMBASEMGR_拠点/中継マネージャーホスト名/_JP1IMRM_リモート監視ホスト名/_HOST_リモート監視ホスト名","value":{…}},…

拠点/中継マネージャー配下のリモート監視ホストで行われているログファイルトラップおよびイベントログトラップ

{"sid":"_JP1IM_統合マネージャーホスト名/_JP1IMBASEMGR_拠点/中継マネージャーホスト名/_JP1IMRM_リモート監視ホスト名/_HOST_リモート監視ホスト名/_JP1BASETRAP_","value":{…}},…

(2)　JP1/AJSから取得する情報

JP1/AJSから取得する情報の種類と，その形式を次に示します。

表7‒7　 JP1/AJSから取得する情報の種類と取得形式

情報の種類

取得する形式

JP1/AJS3 - Managerがインストールされているホスト名

{"sid":"_JP1AJS-M_AJSマネージャーホスト名/_HOST_AJSマネージャーホスト名", "value":{…}},

ホスト内のJP1/AJS3 - Manager

{"sid":"_JP1AJS-M_AJSマネージャーホスト名/_HOST_AJSマネージャーホスト名/_JP1AJSMGR_, "value":{…}},

スケジューラーサービス名（ルートジョブグループ）

{"sid":"_JP1AJS-M_AJSマネージャーホスト名/_HOST_AJSマネージャーホスト名/_JP1SCHE_スケジューラーサービス名", "value":{…}}, …

起動しているスケジューラーサービス名

"sid":"_JP1AJS-M_AJSマネージャーホスト名/_HOST_AJSマネージャーホスト名/_JP1SCHE_スケジューラーサービス名/_JP1AJSSCHE_"

ジョブグループ名

{"sid":"_JP1AJS-M_AJSマネージャーホスト名/_HOST_AJSマネージャーホスト名/_JP1SCHE_スケジューラーサービス名/_JP1JOBG_ジョブグループ名"}, "value":{…}}, …

ルートジョブネット名

{"sid":"_JP1AJS-M_AJSマネージャーホスト名/_HOST_AJSマネージャーホスト名/_JP1SCHE_スケジューラーサービス名/_JP1JOBG_ジョブグループ名/_JP1ROOTJOBNET_ルートジョブネット名"}, "value":{…}}, …

JP1/AJS3 - Manager配下のJP1/AJS3 - Agentがインストールされているホスト名

{"sid":"_JP1AJS-M_AJSマネージャーホスト名/_JP1AJS-A_AJSエージェントホスト名/_HOST_AJSエージェントホスト名", "value":{…}}, …

ホスト内のJP1/AJS3 - Manager配下のJP1/AJS3 - Agent

{"sid":"_JP1AJS-M_AJSマネージャーホスト名/_JP1AJS-A_AJSエージェントホスト名/_HOST_AJSエージェントホスト名/_JP1AJSAGT_", "value":{…}}, …

(3)　JP1/PFMから取得する情報

JP1/PFMから取得する情報の種類と，その形式を次に示します。

表7‒8　 JP1/PFMから取得する情報の種類と取得形式

情報の種類

取得する形式

JP1/PFM - Managerがインストールされているホスト名

{"sid":"_JP1PFM-M_PFMマネージャーホスト名/_HOST_PFMマネージャーホスト名","value":{…}},

ホスト内のJP1/PFM - Manager

{"sid":"_JP1PFM-M_PFMマネージャーホスト名/_HOST_PFMマネージャーホスト名/_JP1PFMMGR_","value":{…}},

JP1/PFM - Manager配下のJP1/PFM - AgentまたはJP1/PFM - RMがインストールされているホスト名およびJP1/PFM - RMの監視対象ホスト名

{"sid":"_JP1PFM-M_PFMマネージャーホスト名/_JP1PFM-AHOST_PFMエージェントホスト名/_HOST_PFMエージェントホスト名","value":{…}},…

JP1/PFM - Manager 配下のJP1/PFM - AgentまたはJP1/PFM - RMがインストールされているホストにインストールされているJP1/PFM - Base

{"sid":"_JP1PFM-M_PFMマネージャーホスト名/_JP1PFM-AHOST_PFMエージェントホスト名/_HOST_PFMエージェントホスト名/_JP1PFMBASE_","value":{…}},…

JP1/PFM - Manager 配下のJP1/PFM - AgentまたはJP1/PFM - RMのサービスID

{"sid":"_JP1PFM-M_PFMマネージャーホスト名/_JP1PFM-AHOST_PFMエージェントホスト名/_HOST_PFMエージェントホスト名/_JP1PFM-A_サービスID","value":{…}},…

JP1/PFM - Manager 配下のJP1/PFM - AgentまたはJP1/PFM - RMのサービス

{"sid":"_JP1PFM-M_PFMマネージャーホスト名/_JP1PFM-AHOST_PFMエージェントホスト名/_HOST_PFMエージェントホスト名/_JP1PFM-A_サービスID/_JP1AGENTSERVICE_","value":{…}},…

(4)　JP1/NNMiから取得する情報

JP1/NNMiから取得する情報の種類と，その形式を次に示します。

表7‒9　 JP1/NNMiから取得する情報の種類と取得形式

情報の種類

取得する形式

JP1/NNMiがインストールされているホスト名

{"sid":"_JP1NNMI-M_NNMiマネージャーホスト名/_HOST_NNMiマネージャーホスト名","value":{…}},…

ホスト内のJP1/NNMi

{"sid":"_JP1NNMI-M_NNMiマネージャーホスト名/_HOST_NNMiマネージャーホスト名/_JP1NNMiMGR_","value":{…}},…

JP1/NNMiが管理しているノード（ネットワーク機器以外）のノード名

{"sid":"_JP1NNMI-M_NNMiマネージャーホスト名/_JP1NNMI-A_NNMi管理ノード名/_HOST_NNMi管理ノード名","value":{…}},…

JP1/NNMiが管理しているノード（ネットワーク機器以外）

{"sid":"_JP1NNMI-M_NNMiマネージャーホスト名/_JP1NNMI-A_NNMi管理ノード名/_HOST_NNMi管理ノード名/_NNMINODE_/","value":{…}},…

JP1/NNMiが管理しているノード（ネットワーク機器）のノード名

{"sid":"_JP1NNMI-M_NNMiマネージャーホスト名/_JP1NNMI-A_NNMi管理ノード名/_NETWORKDEVICE_NNMi管理ノード名","value":{…}},…

JP1/NNMiが管理しているノード（ネットワーク機器）

{"sid":"_JP1NNMI-M_NNMiマネージャーホスト名/_JP1NNMI-A_NNMi管理ノード名>/_NETWORKDEVICE_NNMi管理ノード名/_NNMINODE_/","value":{…}},…

(5)　JP1/OAから取得する情報

JP1/OAから取得する情報の種類と，その形式を次に示します。

表7‒10　 JP1/OAから取得する情報の種類と取得形式

情報の種類

取得する形式

JP1/OAがインストールされているホスト名

{"sid":"_JP1OA_JP1/OAのホスト名/_HOST_JP1/OAホスト名","value":{…}},…

ホスト内のJP1/OA

{"sid":"_JP1OA_JP1/OAのホスト名/_HOST_JP1/OAホスト名/_JP1OAMGR_","value":{…}},…

JP1/OAの監視対象（コンシューマー）

{"sid":"_JP1OA_JP1/OAのホスト名/_JP1OA-A_監視対象コンシューマー名/_CONSUMER_監視対象コンシューマー名","value":{…}},…

JP1/OAの監視対象（コンテナクラスタ）

{"sid":"_JP1OA_JP1/OAのホスト名/_JP1OA-A_監視対象コンテナ環境クラスタ名/_CONTAINERCLUSTER_監視対象コンテナ環境のクラスタ名","value":{…}},…

JP1/OAの監視対象（コンテナノード）

{"sid":"_JP1OA_JP1/OAのホスト名/_JP1OA-A_監視対象コンテナ環境クラスタ名/_CONTAINERCLUSTER_監視対象コンテナ環境のクラスタ名/_CONTAINERNODE_監視対象コンテナ環境ノード名","value":{…}},…

JP1/OAの監視対象（クラスタ）

{"sid":"_JP1OA_JP1/OAのホスト名/_JP1OA-A_監視対象コンテナ環境クラスタ名/_SERVERCLUSTER_監視対象クラスタ名","value":{…}},…

JP1/OAの監視対象（クラスタ環境のハイパーバイザー）

{"sid":"_JP1OA_JP1/OAのホスト名/_JP1OA-A_監視対象コンテナ環境クラスタ名/_SERVERCLUSTER_監視対象クラスタ名/_HYPERVISOR_監視対象ハイパーバイザ名","value":{…}},…

JP1/OAの監視対象（ハイパーバイザー）

{"sid":"_JP1OA_JP1/OAのホスト名/_JP1OA-A_監視対象ハイパーバイザ名/_HYPERVISOR_監視対象ハイパーバイザ名","value":{…}},…

JP1/OAの監視対象（仮想マシン）

{"sid":"_JP1OA_JP1/OAのホスト名/_JP1OA-A_監視対象VM名/_VM_監視対象VM名","value":{…}},…

JP1/OAの監視対象（ホスト）

{"sid":"_JP1OA_JP1/OAのホスト名/_JP1OA-A_監視対象ホスト名/_HOST_監視対象ホスト名","value":{…}},…

JP1/OAの監視対象（IPスイッチ）

{"sid":"_JP1OA_JP1/OAのホスト名/_JP1OA-A_監視対象IPスイッチ名/_NETWORKDEVICES_監視対象IPスイッチ名","value":{…}},…

JP1/OAの監視対象（FCスイッチ）

{"sid":"_JP1OA_JP1/OAのホスト名/_JP1OA-A_監視対象FCスイッチ名/_NETWORKDEVICES_監視対象FCスイッチ名","value":{…}},…

JP1/OAの監視対象（ストレージシステム）

{"sid":"_JP1OA_JP1/OAのホスト名/_JP1OA-A_監視対象ストレージ名/_STORAGE_監視対象ストレージシステム名","value":{…}},…

JP1/OAの監視対象（ボリューム）

{"sid":"_JP1OA_JP1/OAのホスト名/_JP1OA-A_監視対象ストレージ名/_STORAGE_監視対象ストレージ名/_STORAGEVOLUME_監視対象ボリューム名","value":{…}},…

(6)　JP1/SSOから取得する情報

JP1/SSOから取得する情報の種類と，その形式を次に示します。

表7‒11　 JP1/SSOから取得する情報の種類と取得形式

情報の種類

取得する形式

JP1/SSOがインストールされているホスト名

{"sid":"_JP1SSO-M_JP1/SSOマネージャーのホスト名/_HOST_JP1/SSOマネージャーのホスト名","value":{…}},…

ホスト内のJP1/SSO

{"sid":"_JP1SSO-M_JP1/SSOマネージャーのホスト名/_HOST_JP1/SSOマネージャーのホスト名/_JP1SSOMGR_","value":{…}},…

JP1/SSOが監視しているホスト（ネットワーク機器以外）

{"sid":"__JP1SSO-M_JP1/SSOマネージャーのホスト名/_JP1SSO-A_エージェントホスト/_HOST_エージェントホスト名","value":{…}},…

ホスト内のJP1/SSOのエージェント（ネットワーク機器以外）

{"sid":"__JP1SSO-M_JP1/SSOマネージャーのホスト名/_JP1SSO-A_エージェントホスト名/_HOST_エージェントホスト名/_JP1SSOAGT_","value":{…}},…

JP1/SSOが監視しているホスト（ネットワーク機器）

{"sid":"__JP1SSO-M_JP1/SSOマネージャーのホスト名/_JP1SSO-A_エージェントホスト名/_NETWORKDEVICE_エージェントホスト名","value":{…}},…

ホスト内のJP1/SSOのエージェント（ネットワーク機器）

{"sid":"__JP1SSO-M_JP1/SSOマネージャーのホスト名/_JP1SSO-A_エージェントホスト名/_NETWORKDEVICE_エージェントホスト名/_JP1SSOAGT_","value":{…}},…

7.2　jsonオブジェクト

インテリジェント統合管理基盤のインターフェースで参照できるjsonオブジェクトの一覧を次の表に示します。

表7‒12　jsonオブジェクト一覧

分類

オブジェクト名

機能

参照先

イベント

イベント情報

イベントの情報を示すオブジェクトです。

7.2.1(1)

イベントを発行した連携製品のモニター画面呼び出し情報

連携製品のモニター画面呼び出し情報を示すオブジェクトです。

7.2.1(2)

イベント検索条件

イベント検索条件を示すオブジェクトです。

7.2.1(3)

IM管理ノード

IM管理ノードツリー情報

IM管理ノードツリー情報を示すオブジェクトです。

7.2.2(1)

IM管理ノード

IM管理ノード情報を表すオブジェクトです。

7.2.2(2)

IM管理ノードリンクマスター

IM管理ノードリンクマスター情報を表すオブジェクトです。

7.2.2(3)

トレンドデータ管理

トレンドデータ

トレンドデータ管理サービスが扱うトレンドデータのオブジェクトです。

7.2.3(1)

ラベルセットリスト

トレンドデータ管理サービスを介して，トレンドデータ管理DBから取得できるラベルセットの一覧オブジェクトです。

7.2.3(2)

対処アクションの自動実行

自動対処アクション定義

自動対処アクション定義の情報を表すオブジェクトです。

7.2.4(1)

統合エージェント管理

統合エージェント情報

統合エージェントの情報を表すオブジェクトです。

7.2.5(1)

7.2.1　イベント

イベントを示すjsonオブジェクトについて説明します。

(1)　イベント情報オブジェクト

機能

イベント情報を表すオブジェクトです。

形式

{
    "sid":"JP1イベントのSID",
    "value": [
        "イベント属性名":"イベント属性値",…
    ],
    "title": [
        "イベント属性名":"イベント属性の表示項目名",…
    ],
    "type": [
        "イベント属性名":"イベント属性のタイプ",…
    ],
    "monitor": [
         イベントを発行した連携製品のモニター画面呼び出し情報
    ]
}

メンバー

メンバーを次の表に示します。

表7‒13　イベント情報オブジェクトのメンバー

項番

メンバー

データ型

説明

1

sid

string

イベントを一意に識別するJP1イベントのSIDを指定します。形式を次に示します。

_JP1IM_マネージャーホスト名/_JP1IMSEQNO_統合監視DB内通し番号/_JP1IMEVBSEQNO_イベントDB内通し番号

2

value

Object[]

イベントの属性名と属性値の情報を配列で返却します。イベントに無い属性は，属性値に0バイトの文字列を返却します。

パラメーターvalueに返却されるイベントの属性名の一覧と属性値の形式は，時刻型のイベント属性※1とIPアドレスのイベント属性※2以外はDBの値となります。

時刻型のイベント属性の形式は，ISO 8601の拡張形式（YYYY-MM-DDThh:mm:ssTZD）に従います。

「イベント検索」APIを実行した場合は，リクエストのattrsパラメーターに指定したイベント属性が本メンバーとして返却されます。

「イベント詳細情報取得」APIを実行した場合は，イベント拡張属性定義ファイルの設定に従ったイベント属性が本メンバーとして返却されます。

3

title

Object[]

イベント属性名と属性の表示項目名の一覧を返却します。

このメンバーは，イベント詳細情報取得APIを実行した場合に返却されます。詳細については「5.6.2　イベント詳細情報取得」を参照してください。

4

type※3

Object[]

イベント属性名と属性値のタイプの一覧を返却します。

このメンバーは，イベント詳細情報取得APIを実行した場合に返却されます。詳細については「5.6.2イベント詳細情報取得」を参照してください。

5

monitor

Object[]

「イベント検索」API，「イベント詳細情報取得」APIを実行した場合，イベントを発行した連携製品のモニター画面呼び出し情報を返却します。詳細については「7.2.1(2)　イベントを発行した連携製品のモニター画面呼び出し情報オブジェクト」を参照してください。

注※1

時刻型のイベント属性とは，登録時刻（B.TIME），到着時刻（B.ARRIVEDTIME），開始時刻（E.START_TIME），終了時刻（E.END_TIME）のことです。ISO 8601の拡張形式（YYYY−MM−DDThh:mm:ssTZD）で出力されます。ただし，開始時刻（E.START_TIME），終了時刻（E.END_TIME）が数値以外の場合，0未満の数値の場合は，文字列として出力されます。

注※2

IPアドレスのイベント属性とは，発行元IPアドレス（B.SOURCEIPADDR），送信先IPアドレス（B.DESTIPADDR）のことです。

注※3

typeメンバーが返却する属性名と属性値について，次に示します。

項番

type

説明

イベント属性と返却するタイプの対応

1

なし

文字列

GUIはシングルラインのテキスト形式で表示されます。

制御文字（改行コードなど）は半角スペースに置き換わります。

text，html，date以外の属性

2

text

文字列

GUIはマルチラインのテキスト形式（＜pre＞タグ付き）で，表示されます。

メッセージ（B.MESSAGE）

変更後メッセージ（E.@JP1IM_DISPLAY_MESSAGE）

メモ（E.@JP1IM_MEMO）

テキスト形式のガイドメッセージ（E.@JP1IM_GUIDE）

3

html

htmlドキュメント

GUIはHTML形式（＜iframe＞タグ付き）で，表示されます。

HTML形式のガイドメッセージ（E.@JP1IM_GUIDE）

4

date

日付データをISO8601形式（2004-04-01T12:00+09:00）にした文字列

GUIはクライアントのタイムゾーンに変換して（new Date（value）して）表示されます。

イベント拡張属性定義ファイルのattrステートメントに，次のどちらかが定義されている属性

type="elapsed_time/date_format:CLIENT"

"elapsed_time_in_milli/date_format:CLIENT"

JP1/IMのイベントでは，次に示す属性となります。

登録時刻（B.TIME）

到着時刻（B.ARRIVEDTIME）

開始時刻（E.START_TIME）

終了時刻（E.END_TIME）

イベント拡張属性定義ファイルについては，「イベント拡張属性定義ファイル」（2.　定義ファイル）を参照してください。

重要

ガイドメッセージのイベント属性は，REST APIではIM属性（E.@JP1IM_GUIDE）として返却されます。表示項目名は日本語で「ガイド」，英語で「Guide」となります。

集約開始イベントのイベント属性

「イベント検索」APIのリクエストパラメーターconsolidateEventにtrueを指定した場合，集約開始イベントに次に示すイベント属性を設定します。集約開始イベント以外のイベントには設定されません。また，集約開始イベントのイベント属性は，jcoevtreportコマンドでは出力されません。

表7‒14　集約開始イベントのイベント属性

項番

属性名

説明

1

E.@JP1IM_CONSOLIDATION

集約開始イベントかどうかを示します。

1：集約開始イベント

2

E.@JP1IM_CONSOLIDATION_STATUS

集約開始イベントのステータスを示します。

10：異常なし/対処済

20：警告/通知/情報/デバッグ

30：エラー

40：緊急/警戒/致命的

3

E.@JP1IM_CONSOLIDATION_SEVERE_MIXED

集約イベントに重要イベントと重要ではないイベントが混在しているかどうかを示します。

0：混在していない

1：混在している

4

E.@JP1IM_CONSOLIDATION_DEALT_MIXED

集約イベントの対処状況が混在しているかどうかを示します。

0：混在していない

1：混在している

5

E.@JP1IM_CONSOLIDATION_ACTCONTROL_MIXED

集約イベントの自動アクションの状態が混在しているかどうかを示します。

0：混在していない

1：混在している

(2)　イベントを発行した連携製品のモニター画面呼び出し情報オブジェクト

機能

連携製品のモニター画面呼び出し情報を表すオブジェクトです。

形式

{
   "url":"連携製品の画面URL"
}

メンバー

メンバーを次の表に示します。

表7‒15　イベントを発行した連携製品のモニター画面呼び出し情報オブジェクトのメンバー

項番

メンバー

データ型

説明

1

url

string

連携製品の画面URL

(3)　イベント検索条件オブジェクト

機能

イベント検索条件を表すオブジェクトです。すべての除外条件群に一致しないイベント，かつ通過条件群のどれか1つに一致するイベントを取得対象のイベントと判断します。

形式

{
   "include":[通過条件群,…],
   "exclude":[除外条件群,…]
}

通過条件群，除外条件群の形式

通過条件群，除外条件群を配列で指定します。指定したイベント条件は，AND条件で判定します。

[
{ "key":"イベント属性名","ope":"比較条件","val":"オペランド" },…
]

メンバー

メンバーを次の表に示します。

表7‒16　イベント検索条件オブジェクトのメンバー

項番

メンバー

データ型

説明

1

include

Object[]

イベント検索条件の通過条件群を0〜5件の範囲で指定します。

通過条件群には0〜50件のイベント条件が指定できます。拡張属性（固有情報）のイベント条件は，1つの通過条件群に最大5件まで指定できます。

2

exclude

Object[]

イベント検索条件の除外条件群を0〜5件の範囲で指定します。

除外条件群には0〜50件のイベント条件が指定できます。拡張属性（固有情報）のイベント条件は，1つの除外条件群に最大5件まで指定できます。

3

key

String

比較したいイベント属性名を指定します。基本属性を指定する場合は，名称の前に「B.」を付けます。拡張属性（共通情報），拡張属性（固有情報）を指定する場合は，名称の前に「E.」を付けます。英大文字・英小文字を区別します。

指定できるイベント属性については，「表7-17 指定できる属性名と比較キーワードの組み合わせ」の「属性名」を参照してください。

4

ope

String

keyに指定したイベント属性の比較条件を指定します。比較条件には，「BEGIN（から始まる）」，「IN（と一致する）」，「NOTIN（と一致しない）」，「SUBSTR（を含む）」，「NOTSUBSTR（を含まない）」，「REGEX（正規表現）」，「TRANGE（日時指定）」のどれか一つを指定できます。英大文字・英小文字を区別します。

イベント属性ごとに指定できる比較条件については，「表7-17 指定できる属性名と比較キーワードの組み合わせ」の「比較キーワード」を参照してください。

時刻型のイベント属性※の比較条件については，「表7-18 時刻型のイベント属性の比較条件」および「表7-19 時刻型のイベント属性一覧」を参照してください。

5

val

keyに依存

keyに指定したイベント属性の比較値（オペランド）を指定します。英大文字・英小文字を区別します。複数指定が可能なオペランドについては，配列の形式で指定します。複数指定したオペランドはOR条件となります。ただし，比較キーワードに正規表現を指定している場合は，複数指定できません。

複数指定可能なオペランドでも空の配列または要素にnullが指定された配列は指定できません。

オペランドに，半角スペース，タブ，改行コード（CR，LF）および%を指定したい場合，次のように記述します。

半角スペース（0x20）：%20

タブ（0x09）：%09

改行コード LF（0x0a）：%0a

改行コード CR（0x0d）：%0d

%（0x25）：%25

オペランドは，イベント条件1 件当たり4,096バイトまで，イベント条件ブロック1件当たり4,096バイト（イベント条件ブロックに記述したオペランドの合計バイト数）まで指定できます。

イベント属性ごとに指定できる比較値（オペランド）は，「表7-17 指定できる属性名と比較キーワードの組み合わせ」の「オペランド」を参照してください。

複数指定が可能なオペランドについては，配列の形式で指定します。

注※

時刻型のイベント属性とは，登録時刻（B.TIME），到着時刻（B.ARRIVEDTIME），開始時刻（E.START_TIME），終了時刻（E.END_TIME）のことです。

表7‒17　指定できる属性名と比較キーワードの組み合わせ

項番

種別

属性名

型

指定できる比較キーワード

オペランド

1

基本属性

イベントID

（B.ID）

数値

と一致する

と一致しない

複数指定できる。複数指定では最大100件指定できる。

16進数形式で指定する。大文字・小文字は区別しない。ただし，正規表現では大文字・小文字を区別する。

指定できる範囲は0〜7FFFFFFFである。

2

登録要因

（B.REASON）

数値

と一致する

と一致しない

複数指定できる。複数指定では最大100件指定できる。

3

発行元プロセスID

（B.PROCESSID）

数値

と一致する

と一致しない

複数指定できる。複数指定では最大100件指定できる。

指定できる範囲は，-2147483648〜2147483647である。

4

発行元ユーザーID

（B.USERID）

数値

と一致する

と一致しない

複数指定できる。複数指定では最大100件指定できる。

指定できる範囲は，-2147483648〜2147483647である。

5

発行元グループID

（B.GROUPID）

数値

6

発行元ユーザー名

（B.USERNAME）

文字列

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。複数指定では最大100件指定できる。ただし，正規表現を指定した場合は，複数指定できない。

7

発行元グループ名

（B.GROUPNAME）

文字列

8

発行元イベントサーバ名

（B.SOURCESERVER）

文字列

9

送信先イベントサーバ名

（B.DESTSERVER）

文字列

10

メッセージ

（B.MESSAGE）

文字列

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。複数指定では最大100件指定できる。ただし，正規表現を指定した場合は，複数指定できない。

11

登録時刻

（B.TIME）

時刻

日時指定

範囲開始日時および範囲終了日時を指定する。

範囲開始日時≦時刻≦範囲終了日時が成立する場合に一致する。

12

到着時刻

（B.ARRIVEDTIME）

時刻

日時指定

13

拡張属性（共通情報）

重大度

（E.SEVERITY）

文字列

と一致する

複数指定できる。ただし，重複した重大度は指定できない。

"Emergency"，"Alert"，"Critical"，"Error"，"Warning"，"Notice"，"Information"，"Debug"のどれかを指定できる。

14

ユーザー名

（E.USER_NAME）

文字列

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。複数指定では最大100件指定できる。ただし，正規表現を指定した場合は，複数指定できない。

15

プロダクト名

（E.PRODUCT_NAME）

文字列

16

オブジェクトタイプ

（E.OBJECT_TYPE）

文字列

17

オブジェクト名

（E.OBJECT_NAME）

文字列

18

登録名タイプ

（E.ROOT_OBJECT_TYPE）

文字列

19

登録名

（E.ROOT_OBJECT_NAME）

文字列

20

オブジェクトID

（E.OBJECT_ID）

文字列

21

事象種別

（E.OCCURRENCE）

文字列

22

開始時刻

（E.START_TIME）

文字列

日時指定

範囲開始日時および範囲終了日時を指定する。

範囲開始日時≦時刻≦範囲終了日時が成立する場合に一致する。

23

終了時刻

（E.END_TIME）

文字列

日時指定

24

終了コード

（E.RESULT_CODE）

文字列

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。複数指定では最大100件指定できる。ただし，正規表現を指定した場合は，複数指定できない。

25

発生元ホスト名

（E.JP1_SOURCEHOST）

文字列

26

拡張属性（固有情報）

E.*属性

文字列

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

属性名には，先頭が英大文字で英大文字，数字，およびアンダースコア（_）から構成される32バイトまでの名称を設定できる。

複数指定できる。複数指定では最大100件指定できる。ただし，正規表現を指定した場合は，複数指定できない。

27

IM属性

アクション種別

（E.@JP1IM_ACTTYPE）

数値

と一致する

と一致しない

次の数値を指定できる。

0（アクション対象外）

1（コマンド）

複数指定できる。

28

アクション抑止

（E.@JP1IM_ACTCONTROL）

数値

次の数値を指定できる。

0（アクション対象外）

1（実行）

2（抑止）

3（一部抑止）

複数指定できる。

29

重要イベント

（E.@JP1IM_SEVERE）

数値

次の数値を指定できる。

0（重要イベントではない）

1（重要イベント）

複数指定できる。

30

相関イベント

（E.@JP1IM_CORRELATE）

数値

次の数値を指定できる。

0（相関イベントではない）

1（相関成立イベント）

2（相関不成立イベント）

複数指定できる。

31

応答待ちイベント

（E.@JP1IM_RESPONSE）

数値

次の数値を指定できる。

0（応答待ちイベントではない）

1（応答待ちイベント）

複数指定できる。

32

重大度（変更前）

（E.@JP1IM_ORIGINAL_SEVERITY）

文字列

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。複数指定では最大100件指定できる。ただし，正規表現では複数指定はできない。

33

重大度変更

（E.@JP1IM_CHANGE_SEVERITY）

数値

と一致する

と一致しない

次の数値を指定できる。

0（重大度変更なし）

1（重大度変更あり）

複数指定できる。

34

対処状況

（E.@JP1IM_DEALT）

数値

次の数値を指定できる。

0（未対処）

1（対処済）

2（処理中）

3（保留）

複数指定できる。

35

重要イベント解除

（E.@JP1IM_RELEASE）

数値

次の数値を指定できる。

0（重要イベントを解除していない）

1（重要イベントを解除している）

複数指定できる。

36

重要イベント削除

（E.@JP1IM_DISMISSED）

数値

次の数値を指定できる。

0（重要イベントを削除していない）

1（重要イベントを削除している）

複数指定できる。

37

メモ

（E.@JP1IM_MEMO）

文字列

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。複数指定では最大100件指定できる。ただし，正規表現を指定した場合は，複数指定できない。

38

メッセージ（変更後） （E.@JP1IM_DISPLAY_MESSAGE）

文字列

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。複数指定では最大100件指定できる。ただし，正規表現を指定した場合は，複数指定できない。

39

表示メッセージ変更（E.@JP1IM_CHANGE_MESSAGE）

数値

と一致する

と一致しない

指定できる範囲は，-2147483648〜2147483647である。

40

表示メッセージ変更定義名（E.@JP1IM_CHANGE_MESSAGE_NAME）

文字列

から始まる

と一致する

と一致しない

を含む

を含まない

正規表現

複数指定できる。複数指定では最大100件指定できる。ただし，正規表現を指定した場合は，複数指定できない。

（凡例）

×：比較できない

−：対象外

表7‒18　時刻型のイベント属性の比較条件

項番

比較キーワード

データ型

説明

1

日時指定

（TRANGE）

開始日時と終了日時を指定

JP1イベントの属性値（時刻型）が，オペランドの開始日時と終了日時の範囲に含まれる場合，イベント条件と一致したとみなされます。

オペランドはISO 8601の拡張形式で指定します。

指定できる範囲

開始日時≦属性値≦終了日時

指定形式

YYYY−MM−DDThh:mm:ssTZD

指定例

2018年3月1日から3月31日の範囲を指定する場合

{"key":"B.TIME","ope":"TRANGE","val": ["2018−03−01T00:00:00+09:00", "2018−03−31T00:00:00+09:00"]}

表7‒19　時刻型のイベント属性一覧

項番

種別

属性名

型

指定できる比較キーワード

オペランド

1

基本属性

登録時刻

（B.TIME）

時刻

日時指定

オペランドの指定形式は「表7-18 時刻型のイベント属性の比較条件」と同じです。

2

到着時刻

（B.ARRIVEDTIME）

時刻

日時指定

3

拡張属性

開始時刻

（E.START_TIME）

時刻

日時指定

4

終了時刻

（E.END_TIME）

時刻

7.2.2　IM管理ノード

IM管理ノードの情報を示すjsonオブジェクトについて説明します。

(1)　IM管理ノードツリーオブジェクト

機能

IM管理ノードツリー情報を表すオブジェクトです。

形式

{
  "meta":{
    "format":"ファイル種別",
    "timestamp":"ファイル作成時刻"
    "componentName":"コンポーネント名" ,
    "hostName":"ホスト名",
    "version":"1"
  },
  "simtData":[
    {"sid":"IM管理ノードのツリーのSID"},…
  ]
}

メンバー

メンバーを次の表に示します。

表7‒20　IM管理ノードツリーオブジェクトのメンバー

項番

メンバー

データ型

説明

1

meta

配列

ファイルの情報を格納する配列です。

2

format

string

ファイルの種別です。「conf」固定です。

この属性は省略できません。

3

timestamp

string

ファイル作成の年月日，日時をISO 8601形式のUTC時刻で返却します。この属性は省略できません。時間はJP1/IM - Managerのサーバ時間です。

4

compornentName

string

IM管理ノードを取得したコンポーネント名を設定します。

5

hostName

string

IM管理ノードを取得したホスト名を設定します。

6

version

string

バージョンです。固定値として「1」を指定します。

7

simtData

配列

IM管理ノードのSIDを格納する配列です。

ツリーのSIDのValueとしてTargetにIM管理ノードのSIDと表示用のLabel，およびiconNameに［関連ノード］タブのノードアイコンとして表示する画像ファイル名を指定できます。

画像ファイル名については，マニュアル「JP1/Integrated Management 3 - Manager 画面リファレンス」の「2.6.1(7) 関連ノードのアイコンの種類」を参照してください。

8

sid

string

IM管理ノードのツリーのSIDを指定します。

出力例

{
  "meta":{
    "format":"conf"
    "timestamp":"2018-11-11T00:00:00Z"
　　 "componentName"："/HITACHI/JP1/IMDD"
　　 "hostName"："host1"
  },
  "simtData":[
    {"sid":"_ROOT_AllSystems","value":{"target":[],"iconName":"ROOT.png","label":"All Systems"}},
    {"sid":"_ROOT_AllSystems/_SYSTEM_System1","value":{"target":[],"label":"システム1",…}},
{"sid":"_ROOT_AllSystems/_SYSTEM_System1/_SYSTEM_SubSystem1","value":{"target":[],"label":"サブシステム1",…}},
{"sid":"_ROOT_AllSystems/_SYSTEM_System1/_SYSTEM_SubSystem1/_HOST_host1","value":{"target":[],"label":"host1",…}},
{"sid":"_ROOT_AllSystems/_SYSTEM_System1/_SYSTEM_SubSystem1/_HOST_host1/_CATEGORY_job","value":{"target":[],"label":"Job",…}},
{"sid":"_ROOT_AllSystems/_SYSTEM_System1/_SYSTEM_SubSystem1/_HOST_host1/_CATEGORY_job/_SUBCATEGORY_JP1%2FAJS3%20-%20Manager/_OBJECT_AJSROOT1/_OBJECT_jobgroup","value":{"target":[],"label":"jobgroup",…}},
{"sid":"_ROOT_AllSystems/_SYSTEM_System1/_SYSTEM_SubSystem1/_HOST_host1/_CATEGORY_job/_SUBCATEGORY_JP1%2FAJS3%20-%20Manager/_OBJECT_AJSROOT1/_OBJECT_jobgroup/_OBJECT_jobnet1","value":{"target":[],"label":"jobnet1",…}}
  ]
}

(2)　IM管理ノードオブジェクト

機能

IM管理ノード情報を表すオブジェクトです。

形式

{
  "meta":{
    "format":"ファイル種別",
    "timestamp":"ファイル作成時刻"
    "componentName":"コンポーネント名" ,
    "hostName":"ホスト名",
    "version":"1"
  },
  "simtData":[
    {"sid":"IM管理ノードSID"},…
  ]
}

メンバー

メンバーを次の表に示します。

表7‒21　IM管理ノードオブジェクトのメンバー

項番

メンバー

データ型

説明

1

meta

配列

ファイルの情報を格納する配列です。

2

format

string

ファイルの種別です。「conf」固定です。

この属性は省略できません。

3

timestamp

string

ファイル作成の年月日，日時をISO 8601形式のUTC時刻で返却します。この属性は省略できません。時間はJP1/IM - Managerのサーバ時間です。

4

componentName

string

IM管理ノードを取得したコンポーネント名を設定します。使用できる文字は，半角英数字と記号「/」です。

5

hostName

string

IM管理ノードオブジェクトファイルの場合

IM管理ノードを取得したホスト名を設定します。

IM管理ノードオブジェクトマスターファイルの場合

固定値として「mastar」を設定します。

6

version

string

バージョンです。固定値として「1」を指定します。

7

simtData

配列

IM管理ノードのSIDを格納する配列です。

8

sid

string

IM管理ノードのSIDを指定します。

出力例

{
  "meta":{
    "format":"conf"
    "timestamp":"2018-11-11T00:00:00Z"
    "componentName"："/HITACHI/JP1/AJS3/CONFINFO"
    "hostName"："host1"
  },
"simtData":[
    {"sid":"_JP1AJS-M_host1/_HOST_host1","value":{…}},
    {"sid":"_JP1AJS-M_host1/_HOST_host1/_JP1SCHE_schedulerserv","value":{…}},
{"sid":"_JP1AJS-M_host1/_HOST_host1/_JP1SCHE_schedulerserv/_JP1JOBG_jobgroup","value":{…}},
{"sid":"_JP1AJS-M_host1/_HOST_host1/_JP1SCHE_schedulerserv/_JP1JOBG_jobgroup/_JP1ROOTJOBNET_jobnet1","value":{…}},
{"sid":"_JP1AJS-M_host1/_JP1AJS-A_AGT10/_HOST_host10","value":{…}},
  ]
}

(3)　IM管理ノードリンクマスターオブジェクト

機能

IM管理ノードリンクマスター情報を表すオブジェクトです。

形式

{
    "meta":{
      "format":"ファイル種別",
      "timestamp":"ファイル作成時刻"
      "componentName":"コンポーネント名" ,
      "hostName":"ホスト名",
      "version":"1"
    },
    "links": [
        {
        "from":"先行ノードのSID",
        "to":"後続ノードのSID",
        "type":"処理対象種別"
        }, ...
    ]
}

メンバー

メンバーを次の表に示します。

表7‒22　IM管理ノードリンクマスターオブジェクトのメンバー

項番

メンバー

データ型

説明

1

meta

配列

ファイルの情報を格納する配列です。

2

format

string

ファイルの種別です。「conf」固定です。

この属性は省略できません。

3

timestamp

string

ファイル作成の年月日，日時をISO 8601形式のUTC時刻で返却します。この属性は省略できません。時間はJP1/IM - Managerのサーバ時間です。

4

compornentName

string

固定値として「mastar」を設定します。

5

hostName

string

固定値として「mastar」を設定します。

6

version

string

バージョンです。固定値として「1」を指定します。

7

links

配列

レスポンスオブジェクトの配列です。配列順序に意味はありません。

8

from

string

先行ノードです。先行ノードのSIDを指定します。この属性は省略できません。

指定例：ルートジョブネットを指定する場合

_JP1AJS-M_JP1/AJS3マネージャーホスト名/_HOST_JP1/AJS3マネージャーホスト名/_JP1SCHE_スケジューラーサービス名/_JP1JOBG_ジョブグループ名/_JP1ROOTJOBNET_ノード名

9

to

string

後続ノードです。後続ノードのSIDを指定します。この属性は省略できません。

指定例：ルートジョブネットを指定する場合

_JP1AJS-M_JP1/AJS3マネージャーホスト名/_HOST_JP1/AJS3マネージャーホスト名/_JP1SCHE_スケジューラーサービス名/_JP1JOBG_ジョブグループ名/_JP1ROOTJOBNET_ノード名

10

type

string

システムに適用されているリンク情報の種別のうち，取得したいリンク情報の種別を指定します。

typeは同じ意味を持つ関連同士をグループ化する情報です。統合オペレーション・ビューアーの［関連ノード］タブでは，typeごとに関連をフィルタリングして表示することができます。

JP1/IMの製品内や他製品との連携では次の種別を使用します。これらの種別以外に，ユーザーが任意の種別を指定することもできます。

rootJobnetExecutionOrder：ルートジョブネット実行順序の関連

managerAgent：JP1製品のマネージャーとエージェントの関連

rootJobnetAgent：ルートジョブネットとAJSエージェントの関連

sameNode：名称が同一のノードの関連

L2Connection：JP1/NNMiで管理するレイヤー2接続線の関連

Infrastructure：JP1/OAで管理するインフラリソースの関連

monitoringConfiguration：監視製品の構成における製品と監視対象の関連

出力例

{
 "meta":{
    "format":"conf"
    "timestamp":"2018-11-11T00:00:00Z"
        "componentName"："AJS"
        "hostName"："host1"
  },
    "links": [
        {
        "from":"先行ノードのSID",
        "to":"後続ノードのSID",
        "type":"処理対象種別"
        }, ...
    ],
}

7.2.3　トレンドデータ管理

(1)　トレンドデータオブジェクト

機能

トレンドデータ管理DBが保持しているトレンドデータを表すjsonオブジェクトです。

製品プラグインからjp1trendDataService.getTrendDataメソッドを実行すると，トレンドデータ管理サービス（Promscale）を経由して，戻り値のデータオブジェクトとして，トレンドデータオブジェクトが返却されます。

jp1TrendDataService.getTrendDataメソッドの詳細については，「4.5.17 jp1TrendDataService.getTrendData」を参照してください。

形式

{
  "status":"状態",
  "data":{
     "resultType":"結果タイプ",
     "result":[
       {"metric":{
         "ラベル名":"ラベル値",
         ...
         },
        "values":[
          [時刻,"値"],
          ...
          ]
       }
     ]
  }
}

メンバー

メンバーを次の表に示します。

表7‒23　トレンドデータオブジェクトのメンバー

項番

メンバー

データ型

説明

1

status

string

取得結果を表す文字列です。

取得に成功している場合，"success"が設定されます。

2

resultType

string

取得したデータのタイプを表す文字列です。

固定で"matrix"が設定されます。

3

result

配列

トレンドデータを表す配列です。

4

metric

配列

トレンドデータに付与されているラベルを格納する配列です。

5

ラベル名

string

トレンドデータに付与されているラベルの名前です。

6

ラベル値

string

トレンドデータに付与されているラベルの値です。

7

values

配列

時刻ごとのパフォーマンスデータを表す配列です。

8

時刻

数値

パフォーマンスデータの時刻（UTC 1970年1月1日00:00:00からの経過秒数）です。

9

値

数値

パフォーマンスデータの値です。

出力例

{
  "status":"success",
  "data":{
     "resultType":"matrix",
     "result":[
       {"metric":{
         "__name__":"foo",
         "job":"hoge"
         },
        "values":[
          [1617436800,"100"],
          [1617436830,"100"],
          [1617436860,"100"],
          [1617436890,"100"]
          ]
       }
     ]
  }
}

(2)　ラベルセットリストオブジェクト

機能

トレンドデータ管理DBが保持しているトレンドデータのラベルセットの一覧を表すjsonオブジェクトです。

製品プラグインからjp1trendDataService.getLabelListメソッドを実行すると，トレンドデータ管理サービス（Promscale）を経由して，戻り値のデータオブジェクトとして，ラベルセットリストオブジェクトが返却されます。

jp1TrendDataService.getLabelListメソッドの詳細については，「4.5.18 jp1TrendDataService.getLabelList」を参照してください。

形式

{
  "status":"状態",
  "data":[
       {
         "ラベル名":"ラベル値",
         ...
       },
       {
         "ラベル名":"ラベル値",
         ...
       },
       ...
  ]
}

上記の定義内で，下記の部分は1つのラベルセットを示します。

       {
         "ラベル名":"ラベル値",
         ...
       },

メンバー

メンバーを次の表に示します。

表7‒24　トレンドデータオブジェクトのメンバー

項番

メンバー

データ型

説明

1

status

string

取得結果を表す文字列です。

取得に成功している場合，"success"が設定されます。

2

ラベル名

string

トレンドデータに付与されているラベルの名前です。

3

ラベル値

string

トレンドデータに付与されているラベルの値です。

出力例

{
   "status" : "success",
   "data" : [
      {
         "__name__" : "up",
         "job" : "prometheus",
         "instance" : "localhost:9090"
      },
      {
         "__name__" : "up",
         "job" : "node",
         "instance" : "localhost:9091"
      }
   ]
}

7.2.4　対処アクションの自動実行

(1)　自動対処アクション定義オブジェクト

機能

自動対処アクション定義の情報を表すjsonオブジェクトです。このオブジェクトのサイズは10MB未満までに制限されています。

形式

{
  "meta":{
    "version":"バージョン情報"
  },
  "actions":[
    {"actionGroup":"アクショングループ",
     "actionId":"アクションID",
     "label":"アクション名",
     "description":"コメント",
     "valid":"有効/無効",
     "conditions":[
       {"type":"種別",
        "key":"属性名",
        "ope":"オペレーター",
        "val":["属性値",．．．]
       },
       …
     ],
     "action":{
       "type":"アクション種別",
       "params":"アクション内容"
     }
    },
  …
  ]
}

上記の定義内の項目で文字列を指定する場合，「"」，「¥」を通常の文字として含める場合は，直前に「¥」を付けて「¥"」「¥¥」とします。

定義

メンバー

メンバーを次の表に示します。

表7‒25　自動対処アクション定義オブジェクトのメンバー

項番

メンバー名

データ型

指定要否

説明

1

meta

object

必須

対処アクションの自動実行機能の全体に関わる共通情報を設定するオブジェクト

2

version

string

必須

バージョンを指定します。

固定値として「1」を指定します。

3

actions

object[]

任意

対処アクションを実行する契機となる条件や対処アクションの実行内容を設定する自動対処アクション設定の配列

指定できる件数は，0〜1,000件（デフォルト値）です。

4

actionGroup

int

必須

対処アクショングループの番号を0〜9の整数で指定します。

対処アクショングループの数字の大小は，実行条件判定の優先順位および対処アクションの実行条件とは関係ありません。

グループごとに1つの対処アクションの実行を指定できるため，1つのシステム状況の変化に対して，最大10件の対処アクションを同時に実行できます。

5

actionId

int

必須

自動対処アクション設定ごとに一意に割り振るアクションIDを指定します。指定できる値は，0〜2,147,483,647の整数です。

6

label

string

必須

自動対処アクション設定を識別するためのアクション名を1〜50バイトの文字列で指定します。制御文字（0x00〜0x1F，0x7F〜0x9F）以外の文字を指定できます。

7

description

string

任意

自動対処アクション設定に対するコメント（実行する対処アクションの説明や解説文）を1〜1,040バイトの文字列で指定します。制御文字（0x00〜0x1F，0x7F〜0x9F）以外の文字を指定できます。

この項目は，対処アクションの自動実行には影響しません。

8

valid

boolean

任意

該当する自動対処アクション設定の有効/無効を指定します。

true：有効

false：無効

省略時は「true」が仮定されます。

9

conditions

object[]

必須

対処アクションを実行する契機となる条件を指定します。

指定できる条件数は1〜256件です。複数の実行条件を指定した場合，すべてのイベント条件に合致（AND条件）したときに，実行条件に一致したと判定されます。

10

type

string

必須

実行条件の種別を指定します。

固定値として「event」を指定します。

11

key

string

必須

実行条件の属性名を指定します。

指定できる属性名を次に示します。

B.ID（イベントID）

B.REASON（登録要因）

B.PROCESSID（発行元プロセスID）

B.USERID（発行元ユーザーID）

B.GROUPID（発行元グループID）

B.TIME（登録時刻）

B.ARRIVEDTIME（到着時刻）

B.USERNAME（発行元ユーザー名）

B.GROUPNAME（発行元グループ名）

B.SOURCEIPADDR（発行元IPアドレス）

B.SOURCESERVER（発行元イベントサーバ名）

B.MESSAGE（メッセージ）

E.START_TIME（開始時刻）

E.END_TIME（終了時刻）

E.PRODUCT_NAME（プロダクト名）

E.OBJECT_TYPE（オブジェクトタイプ）

E.OBJECT_NAME（オブジェクト名）

E.ROOT_OBJECT_TYPE（登録名タイプ）

E.ROOT_OBJECT_NAME（登録名）

E.OBJECT_ID（オブジェクトID）

E.OCCURRENCE（事象種別）

E.USER_NAME（ユーザー名）

E.RESULT_CODE（終了コード）

E.SEVERITY（重大度）

E.*（固有の拡張属性）

E.@JP1IM_DISPLAY_MESSAGE（メッセージ（変更後））

12

ope

string

必須

keyに指定した属性名の比較条件を指定します。

比較条件には，次のどれかを指定できます。

BEGIN（から始まる）

IN（と一致する）

NOTIN（と一致しない)

SUBSTR（を含む）

NOTSUBSTR（を含まない）

REGEX（正規表現）

属性名ごとに指定できる比較条件については，下記の「■実行条件に指定できる設定の組み合わせ」の表を参照してください。

13

val

string[]

必須

keyに指定した属性名の比較値（文字列）を指定します。

英小文字・英大文字を区別します。

比較値に正規表現を指定していない場合，複数指定できます（最大100個）。複数指定した場合，どれかに一致（OR条件）したときに，実行条件に一致したと判定されます。

比較値には，次の条件を満たす文字列を指定できます。

比較値1個当たり4,096バイトまで，実行条件1件につき合計4,096バイト（実行条件に記述した比較値の合計バイト数）までの文字列

keyに指定した属性名の比較値

属性名ごとに指定できる比較条件については，下記の「■実行条件に指定できる設定の組み合わせ」の表を参照してください。

14

action

object

必須

実行条件に一致した場合に実行する内容を設定するオブジェクト

15

type

string

必須

実行するアクションの種別を指定します。

cmd：OSコマンドを実行する場合に指定します。

restapi：REST APIを実行する場合に指定します。

16

params

object

必須

実行するアクションの内容を指定します。

この項目には，イベント引き継ぎ情報を含む値を指定できます。

アクションの種別が「cmd」の場合

指定できるメンバーについては，下記の「■typeがcmdの場合に指定できるメンバー」の表を参照してください。

アクションの種別が「restapi」の場合

指定できるメンバーについては，下記の「■typeがrestapiの場合に指定できるメンバー」の表を参照してください。

■実行条件に指定できる設定値の組み合わせ

key（属性名）

種別

ope（比較条件）

val（比較値）

B.ID

（イベントID）

数値

IN（と一致する）

NOTIN（と一致しない）

イベントIDを指定する。

大文字・小文字を区別しない。

指定できる範囲は，0〜7FFFFFFFFである。

イベントID基本部またはイベントID拡張部が8桁未満の値であった場合，先頭を0で埋め，8桁の文字列とする。

B.REASON

（登録要因）

数値

登録要因を指定する。

指定できる範囲は，-2,147,483,648〜2,147,483,648である。

B.PROCESSID

（発行元プロセスID）

数値

発行元アプリケーションのプロセスIDを指定する。

指定できる範囲は，-2,147,483,648〜2,147,483,648である。

B.USERID

（発行元ユーザーID）

数値

発行元プロセスのユーザーID（数値）を指定する。

指定できる範囲は，-2,147,483,648〜2,147,483,648である。

B.GROUPID

（発行元グループID）

数値

発行元プロセスのグループID（数値）を指定する。

指定できる範囲は，-2,147,483,648〜2,147,483,648である。

B.TIME

（登録時刻）

時刻

REGEX（正規表現）

JP1イベントが発行元ホストのイベントDBに登録された時刻を指定する。

YYYYMMDDhhmmssの形式で正規表現で指定する。

B.ARRIVEDTIME

（到着時刻）

時刻

JP1イベントが発行元ホストのイベントDBに到着した時刻を指定する。

YYYYMMDDhhmmssの形式で正規表現で指定する。

B.USERNAME

（発行元ユーザー名）

文字列

BEGIN（から始まる）

IN（と一致する）

NOTIN（と一致しない）

REGEX（正規表現）

発行元プロセスのユーザー名を指定する。

B.GROUPNAME

（発行元グループ名）

文字列

発行元プロセスのグループ名を指定する。

B.SOURCEIPADDR

（発行元IPアドレス）

文字列

発行元イベントサーバに対応するIPアドレスを指定する。

IPアドレスの指定形式については，下記の「■アクションの実行条件に指定できる値」の表を参照してください。

B.SOURCESERVER

（発行元イベントサーバ名）

文字列

JP1イベントが発生したホストのホスト名（イベントサーバ名）を指定する。

B.MESSAGE

（メッセージ）

文字列

イベント基本属性のメッセージを指定する。

E.START_TIME

（開始時刻）

文字列

REGEX（正規表現）

実行開始または再実行開始の時刻を指定する。

通算秒の正規表現指定で指定する。

E.END_TIME

（終了時刻）

文字列

実行終了の時刻を指定する。

通算秒の正規表現指定で指定する。

E.PRODUCT_NAME

（プロダクト名）

文字列

BEGIN（から始まる）

IN（と一致する）

NOTIN（と一致しない）

SUBSTR（を含む）

NOTSUBSTR（を含まない）

REGEX（正規表現）

JP1イベントを発行したプログラムの名称を指定する。

E.OBJECT_TYPE

（オブジェクトタイプ）

文字列

JP1イベントのオブジェクトの種類を指定する。

E.OBJECT_NAME

（オブジェクト名）

文字列

JP1イベントのオブジェクト名を指定する。

E.ROOT_OBJECT_TYPE

（登録名タイプ）

文字列

JP1イベントの登録名タイプを指定する。

E.ROOT_OBJECT_NAME

（登録名）

文字列

JP1イベントの登録名を指定する。

E.OBJECT_ID

（オブジェクトID）

文字列

JP1イベントのオブジェクトIDを指定する。

E.OCCURRENCE

（事象種別）

文字列

JP1イベントの事象種別を指定する。

E.USER_NAME

（ユーザー名）

文字列

JP1イベントを発行したユーザー名を指定する。

E.RESULT_CODE

（終了コード）

文字列

終了コードを指定する。

E.SEVERITY

（重大度）

文字列

IN（と一致する）

REGEX（正規表現）

JP1イベントの重大度を指定する。

opeにIN（と一致する）を指定した場合，"Emergency"（緊急），"Alert"（警戒），"Critical"（致命的），"Error"（エラー），"Warning"（警告），"Notice"（通知），"Information"（情報），"Debug"（デバッグ）の中から指定する。

E.*

（固有の拡張属性）

文字列

BEGIN（から始まる）

IN（と一致する）

NOTIN（と一致しない）

SUBSTR（を含む）

NOTSUBSTR（を含まない）

REGEX（正規表現）

keyにE.*形式で指定した属性名の値を指定する。

E.@JP1IM_DISPLAY_MESSAGE

（メッセージ（変更後））

文字列

JP1イベントのIM属性のメッセージを指定する。

■アクションの実行条件に指定できる値

発行元IPアドレスのイベント条件には，IPv4アドレスの条件に加え，IPv6アドレスの条件をIPv6アドレス表記で指定できます（IPv6表記の英字部分は，英小文字で指定してください）。

発行元IPアドレスのイベント条件に指定できるIPアドレスの条件を次に示します。

発行元IPアドレス

指定例

指定可否

IPv4アドレス

11.22.33.44

可

IPv6アドレス

0011:2233:4455:6677:8899:aabb:cccdd:eeff

可

0011:2233:4455:6677:8899:AABB:CCDD:EEFF

不可

2012:7:8::a:b

不可

特殊なIPv6アドレス

IPv4射影アドレス

::ffff:11.22.33.44

不可

IPv6射影アドレス

::11.22.33.44

不可

■typeがcmdの場合に指定できるメンバー

メンバー名

データ型

指定要否

説明

host

string

必須

コマンドの実行先ホスト名を1〜255バイトの範囲で指定します。

cmd

string

必須

実行コマンドと引数を1〜4,096バイトの範囲で指定します。

コマンド名に空白を含む場合は「"」（ダブルクォーテーション）で囲みます。

envFile

string

任意

実行先ホストの環境変数ファイルの絶対パスを1〜255バイトの範囲で指定します。

環境変数ファイルについては，「環境変数ファイル（任意のファイル名）」（2.　定義ファイル）を参照してください。

■typeがrestapiの場合に指定できるメンバー

メンバー名

データ型

指定要否

説明

method

string

必須

REST APIのメソッドを指定します。

url

string

必須

REST APIのURLを指定します。

ホスト名を含むURLを指定する場合，ホスト名はhostsファイルやDNSに登録し，JP1/IM - ManagerホストのOS上で名前解決できるようにしてください。jp1hostsファイルおよびjp1hosts2ファイルの設定は参照されません。

headers

object

必須

次の形式で，REST APIのリクエストヘッダーを指定します。

{

"要素名1":"要素の値1",

"要素名2";"要素の値2"

}

body

string

任意

任意の文字列の形式で，REST APIのリクエストボディーを指定します。

指定例

{
  "meta":{
    "version":"1"
  },
  "actions":[
    {"actionGroup":0,
     "actionId":"0",
     "label":"イベント異常時_資料採取用",
     "description":"特定のイベントIDで異常検知時に資料採取を実行",
     "valid":true,
     "conditions":[
       {"type":"event",
        "key":"B.ID",
        "ope":"IN",
        "val":["00004860","00004861"]
       },
       {"type":"event",
        "key":"E.SEVERITY",
        "ope":"IN",
        "val":["Error","Emergency"]
       }
     ],
     "action":{
       "type":"cmd",
       "params":{
         "host":"${event:EVHOST:}",
         "cmd":"¥"C:¥¥Program Files (x86)¥¥Hitachi¥¥JP1IMM¥¥tools¥¥jim_log¥" -f C:¥¥temp -q",
         "envFile":"C:¥¥tmp¥¥envFile.txt"
       }
     }
    }
  ]
}

7.2.5　統合エージェント管理

(1)　統合エージェント情報オブジェクト

機能

統合エージェントの情報を表すjsonオブジェクトです。

形式

{
  "agentid": エージェントID,
  "agenthost": 統合エージェントホスト名,
  "os": OS名,
  "installpath": インストールパス,
  "imversion": 統合エージェントのバージョン,
  "managerhost" マネージャーホスト名,
  "registeredtime" 登録日時,
  "addons": [
    {
      "addonName": 機能名,
      "enabled ": 状態
    }, ...
  ]
}

メンバー

メンバーを次の表に示します。

表7‒26　統合エージェント情報オブジェクトのメンバー

項番

メンバー

データ型

説明

1

agentid

string

統合エージェントのIDを指定します。

2

agenthost

string

統合エージェントのホスト名を指定します。

3

os

string

統合エージェントのホストのOS名を指定します。

（例：windows，linux）

4

installpath

string

統合エージェントホストにインストールされたJP1/IM - Agentのインストールパスを指定します。

5

imversion

string

JP1/IM - Agentのバージョン（VVRRSS）を6桁の数字で指定します。

6

managerhost

string

統合エージェントのマネージャーのホスト名を指定します。

7

registeredtime

string

統合エージェント情報の登録日時を，ISO 8601形式のUTC時刻で指定します。

登録日時は，次の操作の実施後，JP1/IM - Agentを起動したときに更新されます。

JP1/IM - Agentのインストール

JP1/IM - Agentのバージョンアップ

統合オペレーション・ビューアーの［統合エージェント一覧］画面でJP1/IM - Agentを削除

8

addons

object[]

アドオン情報オブジェクトの配列を指定します。

9

addonName

string

アドオン名を指定します。

10

enabled

boolean

アドオン機能の有効/無効を指定します。

true：有効

false：無効

指定例

{
  "agentid": "RENEMzNENDg5RkQyNEM2OT",
  "agenthost": "agenthostA",
  "os": "windows",
  "installpath": "C¥¥Program Files¥¥Hitachi¥¥jp1ima",
  "imversion": "130000",
  "managerhost": "managerhostA",
  "registeredtime": "2020-03-01T00:00:00Z",
  "addons": [
    {
      "addonName": "Windows metric collector(Windows exporter)",
      "enables": true
    }, ...
  ]
}

7.3　アダプタコマンドの設定

アダプタコマンドの設定について説明します。

なお，アダプタコマンドの実行環境には，JP1/Baseが必要です。

7.3.1　アダプタコマンドのセットアップ

(1)　セットアップ

各連携製品が提供するセットアップコマンドを実行する。

次の格納先に，アダプタコマンド設定ファイルが生成される。

Windowsの場合

JP1/Baseインストール先フォルダ※¥plugin¥conf

UNIXの場合

/opt/jp1base/plugin/conf

注※

各製品を初期設定のままインストールした場合のインストール先フォルダを次に示します。なお，「システムドライブ:¥ProgramData」と表記している部分は，インストール時のOS環境変数によって決定されるため，環境によって異なる場合があります。

x86環境の場合：システムドライブ:¥Program Files¥Hitachi¥JP1Base

x64環境の場合：システムドライブ:¥Program Files (x86)¥Hitachi¥JP1Base

重要

Windowsの場合，JP1/Baseのインストール先ディレクトリは，次のレジストリから取得します。

HKEY_LOCAL_MACHINE¥SOFTWARE¥HITACHI¥JP1BASE¥PATHNAME¥PATH00

同じ名称のファイルが格納先に存在した場合は，上書きされます。

JP1/Baseのサービスは停止しないでください。

(2)　アンセットアップ

各連携製品が提供するアンセットアップコマンドを実行する。

アダプタコマンド設定ファイルを手動で削除する。

重要

JP1/Baseのサービスは停止しないでください。

各連携製品をアンインストールした場合は，アダプタコマンド設定ファイルもアンインストールされます。

7.3.2　アダプタコマンド設定ファイル

アダプタコマンド設定ファイル名称，コンポーネント識別子，アダプタコマンド設定ファイルの注意事項について説明します。

(1)　アダプタコマンド設定ファイルの命名規則

アダプタコマンド設定ファイルの命名規則を次に示します。

Adapterコンポーネント識別子.conf

例えば，「コンポーネント識別子」が/HITACHI/JP1/BASE/GETHOSTNAMEの場合，アダプタコマンド設定ファイル名は「Adapter_HITACHI_JP1_BASE_GETHOSTNAME.conf」となります。

(2)　コンポーネント識別子

コンポーネント識別子は，各製品の持つ各コンポーネントを識別するための文字列です。各連携製品のコンポーネントごとに，固有のコンポーネント識別子が割り当てられます。

インテリジェント統合管理基盤は，構成取得対象ホスト定義ファイルのproductに指定した製品名が，コンポーネント識別子に部分一致した場合，そのコンポーネントのアダプタコマンド・プラグインを実行して構成情報を収集します。

「SYSTEM」，「DEFAULT」，「HITACHIから始まる文字列」は予約識別子です。コンポーネント識別子は，次の規則で作成します。

文字列の長さ：240バイトまで

使用できる文字：ASCII文字の数字，大文字の英字，記号「/」

(3)　アダプタコマンド設定ファイルの設定項目

アダプタコマンド設定ファイルの設定項目については，「表4-4　アダプタコマンド設定ファイルの設定項目」を参照してください。

(4)　アダプタコマンド設定ファイルの注意事項

アダプタコマンド設定ファイルのcmdpath属性のパスに，正しいアダプタコマンドのフルパスが設定されていない場合でも，jddcreatetreeコマンドはエラーになりません。事前に開発環境で正しくアダプタコマンドのパスが設定されていることを確認してから，運用を行うようにしてください。

cmdpath属性のフルパスに空白がある場合でも，ダブルクォートなどでパスを囲む必要はありません。

1行に指定できる文字は，最大4,096文字です。

同じラベル名が複数存在した場合は，エラーとなります。

ラベルの指定を省略した場合は，エラーとなります。

ファイル中に1つでもエラーが存在した場合は，そのファイルは無効となります。

ファイルの終端は改行です。

使用できる文字はASCII文字だけです。

ラベルを指定する場合，行頭の空白，タブは許可されません。

空白，タブだけの行は無視されます。

7.4　IM管理ノードツリー生成機能

IM管理ノードツリー生成機能は，IM管理ノード関連情報を取得するための機能の一つです。IM管理ノード関連情報の取得には，システム構成情報の収集，IM管理ノードリンク生成，IM管理ノードツリー生成の3つの機能があります。

システム構成情報の収集機能は，アダプタコマンドやプラグインで連携製品のシステム構成情報を収集する機能です。IM管理ノードリンク生成機能は，収集した構成情報を基に構成間の関連を生成する機能です。詳細は「4.4.4(6)　__createLinkメソッド」を参照してください。

IM管理ノードツリー生成機能の入力情報，および出力情報を次に示します。

表7‒27　IM管理ノードツリー生成機能の入力情報

項番

入力情報

内容

1

システム構成情報

アダプタコマンドやプラグインで収集した連携製品のシステム構成情報です。

システム構成情報は，SIDとSIDに対応した付与情報で表示されます。SIDについては「7.1　SID」を参照してください。

2

システムノード定義ファイル（imdd_systemnode.conf）

システム，サブシステムとその配下に配置する任意のノードの階層構造の定義情報です。

3

IM管理ノードカテゴリ名称定義ファイル（imdd_category_name.conf）

サンバースト形式やツリー形式で表示するカテゴリの名称と表示の順番の定義情報です。

4

ホスト名定義ファイル（imdd_host_name.conf）

ホスト名にエイリアス名を付与できる製品をIM管理ノードの構成に加える場合に，エイリアス名と実ホスト名をマッピングするための定義情報です。

表7‒28　IM管理ノードツリー生成機能の出力情報

項番

入力情報

内容

1

ツリー情報

IM管理ノードをサンバースト形式やツリー形式で表示するために必要な情報です。ツリー情報を記載したIM管理ノードツリーファイル（imdd_nodeTree.json）を生成します。

ツリー情報はツリーのSIDとツリーのSIDに対応した付与情報で表示されます。SIDについては「7.1　SID」を参照してください。

システムノード定義ファイル（imdd_systemnode.conf），IM管理ノードカテゴリ名称定義ファイル（imdd_category_name.conf）およびホスト名定義ファイル（imdd_host_name.conf）の詳細については，「システムノード定義ファイル（imdd_systemnode.conf）」（2.　定義ファイル），「IM管理ノードカテゴリ名称定義ファイル（imdd_category_name.conf）」（2.　定義ファイル）および「ホスト名定義ファイル（imdd_host_name.conf）」（2.　定義ファイル）を参照してください。

IM管理ノードツリー生成機能は，システムノード生成，ノード生成，ツリーのSID変換の3つの機能を持ちます。

7.4.1　システムノード生成機能

システム構成情報とシステムノード定義ファイル（imdd_systemnode.conf）の情報を基にして，ルートノードからシステムノードまでのツリー情報を生成する機能です。

システムノード生成機能の入力情報，および出力情報を次に示します。

表7‒29　システムノード生成機能の入力情報と出力情報

項番

入力情報／出力情報

内容

1

入力情報

システム構成情報

アダプタコマンドやプラグインで収集した連携製品のシステム構成情報です。

システム構成情報は，SIDとSIDに対応した付与情報で表示されます。SIDについては「7.1　SID」を参照してください。

2

システムノード定義ファイル（imdd_systemnode.conf）

システム，サブシステムとその配下に配置する任意のノードの階層構造の定義情報です。

3

出力情報

ルートノードからシステムノードまでのツリー情報

IM管理ノードをサンバースト形式やツリー形式で表示するために必要な情報です。

ツリー情報はツリーのSIDとツリーのSIDに対応した付与情報で表示されます。SIDについては「7.1　SID」を参照してください。

システムノード生成機能には，ファイルによるシステムノード生成機能とプラグインによるシステムノード生成機能があります。それぞれについて説明します。

ファイルによるシステムノード生成機能

システムノード定義ファイル（imdd_systemnode.conf）に記載されているシステムノードの情報を基に，システムノードのツリーのSIDおよび付与情報を生成します。また，ルートノードの「All Systems」のツリーのSIDおよび付与情報も生成します。

生成するルートノードおよびシステムノードの付与情報を次に示します。

表7‒30　ルートノードとシステムノードの付与情報

項番

ノード

付与情報

1

ルートノード

target

2

label※

3

システムノード

target

4

resourceGroup

5

label

注※　「All Systems」を指定します。

プラグインによるシステムノード生成機能

システムノード定義ファイルで指定したシステムノード以外を作成する場合，プラグインによるシステムノード生成機能でシステムノードのツリーのSIDおよび付与情報を生成します。

例えば，JP1/IMと連携する製品が，JP1/IMのシステムと同様の概念であるものを管理している場合で，その製品をすでにユーザーが使用している場合に，プラグインでシステムノードを生成します。

プラグインで作成したシステムノードのツリーのSIDとシステムノード定義ファイルを基に作成したシステムノードのツリーのSIDが同じ場合，すでに作成済みのツリーのSIDの付与情報に対して，新たに作成したツリーのSIDの付与情報の対処を次の表に示します。

表7‒31　ツリーのSID重複時における付与情報の対処

項番

付与情報

対処

1

target

追加

2

label

生成済みのツリーのSIDのlabelを優先

3

resourceGroup

生成済みのツリーのSIDのresourceGroupを優先

7.4.2　ノード生成機能

システムノード生成機能で生成したルートノードからシステムノードまでのツリー情報を，ツリーのシステムノード配下以降のすべてのノードのツリー情報を生成，連結し，ツリー全体のツリー情報を生成する機能です。

ノード生成機能の入力情報，および出力情報を次に示します。

表7‒32　ノード生成機能の入力情報と出力情報

項番

入力情報／出力情報

内容

1

入力情報

システム構成情報

アダプタコマンドやプラグインで収集した連携製品のシステム構成情報です。

システム構成情報は，SIDとSIDに対応した付与情報で表示されます。SIDについては「7.1　SID」を参照してください。

2

システムノードまでのツリー情報

システムノード生成機能で生成したツリー情報です。

3

IM管理ノードカテゴリ名称定義ファイル

(imdd_category_name.conf)

インテリジェント統合管理基盤が収集したデータをサンバースト形式，ツリー形式で表示する際の管理グループのIM管理ノードカテゴリの名称，および順番を定義するファイルです。

4

ホスト名定義ファイル

（imdd_host_name.conf）

ホスト名にエイリアス名を付与できる製品をIM管理ノードの構成に加える場合に，エイリアス名と実ホスト名をマッピングするための定義情報です。

5

出力情報

ツリー情報

IM管理ノードをサンバースト形式やツリー形式で表示するために必要な情報です。

ツリー情報はツリーのSIDとツリーのSIDに対応した付与情報で表示されます。SIDについては「7.1　SID」を参照してください。

ノード生成機能には，JP1/IMによるノード生成機能とプラグインによるノード生成機能があります。それぞれについて説明します。

JP1/IMによるノード生成機能

JP1/IMによって，システムノード配下のツリーのSIDおよび付与情報を生成します。生成するシステムノード配下のノードの付与情報を次に示します。

表7‒33　システムノード配下のノードの付与情報

項番

付与情報

1

target

2

resourceGroup

3

label

プラグインによるノード生成機能

プラグインでツリー全体のツリーのSIDを生成できます。プラグインによるノード生成は，__createTreeNodeメソッドで行います。詳細は「4.4.4(3)　__createTreeNodeメソッド」を参照してください。

プラグインで作成したシステムノード配下のツリーのSIDとJP1/IMで作成したシステムノード配下のツリーのSIDが同じ場合，すでに作成済みのツリーのSIDの付与情報に対して，新たに作成したツリーのSIDの付与情報の対処を次の表に示します。

表7‒34　ツリーのSID重複時における付与情報の対処

項番

付与情報

対処

1

target

追加

2

label

生成済みのツリーのSIDのlabelを優先

3

resourceGroup

生成済みのツリーのSIDのresourceGroupを優先

(1)　デフォルトのツリーのSID

システムノードの定義に合致せず，かつプラグインでノードが生成されない場合は，次のデフォルトのツリーのSIDの作成規則に従って，オブジェクトルートノード，およびオブジェクトのツリーノードを生成します。

_ROOT_AllSystems/_SYSTEM_オブジェクトルートノードの種別/_オブジェクトルートノードの種別_オブジェクトルートノードの名前/_CATEGORY_オブジェクトのカテゴリ/_SUBCATEGORY_オブジェクトのサブカテゴリ/_OBJECT_オブジェクトの名前

デフォルトのツリーのSIDを次に示します。

表7‒35　デフォルトのツリーのSID

項番

IM管理ノードタイプ

構造化IDの名称

labelの値

作成条件

1

SYSTEM

構成情報のmeta.objectRoot.defaultSystem.nameの値※

上記が無い場合は，オブジェクトルートノードの種別

構成情報のmeta.objectRoot.defaultSystem.labelの値※

上記が無い場合は，値はなし

構成情報のSIDにオブジェクトルートノードの構造化IDを含み，かつ構成情報のmeta.objectRoot.defaultSystem※がある場合

2

オブジェクトルートノードの種別

オブジェクトルートノードの名前

構成情報のlabelの値

構成情報のSIDにオブジェクトルートノードの構造化IDを含む場合

3

CATEGORY

構成情報の付与情報

categoryの値

構成情報の付与情報categoryからIM管理ノードカテゴリ名称定義ファイルで解決された名前

構成情報の付与情報にcategoryが設定されている場合

4

SUBCATEGORY

構成情報の付与情報

subCategoryの名前

なし

構成情報の付与情報にcategory,subCategoryが設定されている場合

5

OBJECT

構成情報のSIDのオブジェクトルートノードよりも下位に並ぶ構造化IDの「種別」と「名称」を連結した名前

構成情報のlabelの値

構成情報のSIDにオブジェクトルートノードの構造化IDを含み，かつそれより下位に構造化IDがある場合

注※　meta.objectRoot.defaultSystemについては，「4.4.4(1)　__configurationGetメソッド」の「返却する構成情報一覧」を参照してください。

ツリーの構成を次の図に示します。

図7‒4　ツリーの構成

インテリジェント統合管理基盤ではツリーの構成をJSON形式で保持します。これをツリーオブジェクトと呼びます。上記の図のツリーオブジェクトを次に示します。

{
  "meta":{
    "format":"conf",
    "timestamp":"2018-11-11T11:11:11Z"
  },
  "simtData":[
    {"sid":"_ROOT_AllSystem","value":{"target":[],"label":""}},
    {"sid":"_ROOT_AllSystem/_SYSTEM_SystemA","value":{"target":[],"resourceGroup":["userA"],"label":"システムA"}},
    {"sid":"_ROOT_AllSystem/_SYSTEM_SystemA/_HOST_HostA","value":{"target":[],"label":"ホストA"}},
    {"sid":"_ROOT_AllSystem/_SYSTEM_SystemA/_HOST_HostA/_CATEGORY_Job","value":{"target":[],"label":"ジョブ"}},
    {"sid":"_ROOT_AllSystem/_SYSTEM_SystemA/_HOST_HostA/_CATEGORY_Job/_SUBCATEGORY_SubCategoryA","value":{"target":[],"label":""}},
    {"sid":"_ROOT_AllSystem/_SYSTEM_SystemA/_HOST_HostA/_CATEGORY_Job/_SUBCATEGORY_SubCategoryA/_OBJECT_ServiceA",
        "value":{"target":[],"label":"サービスA"}},
    {"sid":"_ROOT_AllSystem/_SYSTEM_SystemA/_HOST_HostA/_CATEGORY_Job/_SUBCATEGORY_SubCategoryA/_OBJECT_ServiceA/_OBJECT_JobGroupA",
        "value":{"target":[],"label":"ジョブグループA"}},
    {"sid":"_ROOT_AllSystem/_SYSTEM_SystemA/_HOST_HostA/_CATEGORY_Job/_SUBCATEGORY_SubCategoryA/_OBJECT_ServiceA/_OBJECT_JobGroupA/_OBJECT_RootJobnetA",
        "value":{"target":["_JP1AJS-M_HostA/_HOST_HostA/_JP1SCHE_ServiceA/_JP1JOBG_JobGroupA/_JP1ROOTJOBNET_RootJobnetA"],"label":"ルートジョブネットA"}},
    {"sid":"_ROOT_AllSystem/_SYSTEM_SystemA/_SYSTEM_SubSystemA","value":{"target":[],"label":"サブシステムA"}},
    {"sid":"_ROOT_AllSystem/_SYSTEM_SystemA/_SYSTEM_SubSystemA/_SYSTEM_SubSystemAA","value":{"target":[],"label":"サブシステムAA"}},
    {"sid":"_ROOT_AllSystem/_HOST_HostB","value":{"target":["_JP1IM_IMMGR/_JP1BASE_HostB/_HOST_HostB"],"label":"ホストB"}},
    {"sid":"_ROOT_AllSystem/_HOST_HostB/_CATEGORY_Job","value":{"target":[],"label":"ジョブ"}},
    {"sid":"_ROOT_AllSystem/_HOST_HostB/_CATEGORY_Job/_OBJECT_ServiceB",
        "value":{"target":["_JP1IM_IMMGR/_JP1BASE_HostB/_HOST_HostB/_JP1BASEAGT_"],"label":"サービスB"}}
  ]
}

ヒント

simtDataオブジェクトの並び順が，画面での同階層の表示順となります。

7.4.3　ツリーのSID変換機能

収集したシステム構成情報やシステムノード定義ファイル（imdd_systemnode.conf）からSIDの情報を取得し，ツリーのSIDに変換する機能です。ツリーのSIDは，入力情報のシステム構成情報のSIDのパターン，およびシステムノード定義ファイル（imdd_systemnode.conf）の定義内容によって，複数生成されます。

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

生成されるツリーのSIDを次の表に示します。

表7‒36　生成されるツリーのSID

項番

入力情報

カテゴリ，サブカテゴリ情報

生成されるツリーのSID

システムノードの定義

SIDパターン

1

あり

システムノード定義ファイルに指定した種別または「HOST」がSIDの末尾の構造化IDの種別と一致

−

S1/S2/…Sn/Ax

指定例：_ROOT_AllSystems/_SYSTEM_system1/_HOST_HOST1

2

システムノード定義ファイルに指定した種別または「HOST」が，SIDの末尾以外の構造化IDの種別と一致

カテゴリ情報あり

S1/S2/…Sn/Ax/C/

S1/S2/…Sn/Ax/C/Y1

S1/S2/…Sn/Ax/C/Y1/Y2

S1/S2/…Sn/Ax/C/Y1/Y2

・・・

S1/S2/…Sn/Ax/C/Y1/Y2/…Yn

指定例：_ROOT_AllSystems/_SYSTEM_system1/_HOST_HOST1/_CATEGORY_managementApplications_ROOT_AllSystems/_SYSTEM_system1/_HOST_HOST1/_CATEGORY_managementApplications/_OBJECT_JP1IMMGR

3

カテゴリおよびサブカテゴリ情報あり

S1/S2/…Sn/Ax/C/

S1/S2/…Sn/Ax/C/SC/Y1

S1/S2/…Sn/Ax/C/SC/Y1/Y2

S1/S2/…Sn/Ax/C/SC/Y1/Y2/

・・・

S1/S2/…Sn/Ax/C/SC/Y1/Y2/…Yn

指定例：_ROOT_AllSystems/_SYSTEM_system1/_HOST_HOST1/_CATEGORY_platform_ROOT_AllSystems/_SYSTEM_system1/_HOST_HOST1/_CATEGORY_platform/_SUBCATEGORY_JP1%2FPFM%20-%20Windows_ROOT_AllSystems/_SYSTEM_system1/_HOST_HOST1/_CATEGORY_platform/_SUBCATEGORY_JP1%2FPFM%20-%20Windows/_OBJECT_TA1HOST1

4

システムノード定義ファイルに指定した種別または「HOST」が，SIDの構造化IDの種別と一致しない

−

ツリーのSIDは生成しない

5

なし（ルートノードのみあり）

システムノード定義ファイルに指定した種別または「HOST」がSIDの末尾の構造化IDの種別と一致

−

S1/Ax

指定例：_ROOT_AllSystems/_HOST_HOST1

6

システムノード定義ファイルに指定した種別または「HOST」が，SIDの末尾以外の構造化IDの種別と一致

カテゴリ情報あり

S1/Ax/C/

S1/Ax/C/Y1

S1/Ax/C/Y1/Y2

S1/Ax/C/Y1/Y2

・・・

S1/C/Y1/Y2/…Yn

指定例：_ROOT_AllSystems/_HOST_HOST1/_CATEGORY_managementApplications_ROOT_AllSystems/_HOST_HOST1/_CATEGORY_managementApplications/_OBJECT_JP1IMMGR

7

カテゴリおよびサブカテゴリ情報あり

S1/Ax/C/

S1/Ax/C/SC/Y1

S1/Ax/C/SC/Y1/Y2

S1/Ax/C/SC/Y1/Y2/

・・・

S1/Ax/C/SC/Y1/Y2/…Yn

指定例：_ROOT_AllSystems/_HOST_HOST1/_CATEGORY_platform/_ROOT_AllSystems/_HOST_HOST1/_CATEGORY_platform/_SUBCATEGORY_JP1%2FPFM%20-%20Windows_ROOT_AllSystems/_HOST_HOST1/_CATEGORY_platform/_SUBCATEGORY_JP1%2FPFM%20-%20Windows/_OBJECT_TA1HOST1

8

システムノード定義ファイルに指定した種別または「HOST」が，SIDの構造化IDの種別と一致しない

−

ツリーのSIDは生成しない

（凡例）

S1/S2/…Sn：ルートノードおよびシステムノードを表したツリーのSID

A1，A2，…An：構造化ID

Ax：「HOST」およびオブジェクトルートノード種別を含む構造化ID

C，SC：カテゴリおよびサブカテゴリを表す構造化ID

Y1，Y2，…Yn：オブジェクトノードを表す構造化ID

重要

SIDの中に，システムノード定義ファイル（imdd_systemnode.conf）に指定したホスト名以外のホスト，またはオブジェクトノード種別に対応する名称以外のものが存在した場合は，システムノード配下ではなく，ルートノード配下に配置します。

7.5　サンプルプラグイン

サンプルプラグインについて説明します。

7.5.1　想定する運用・構成

Manager-Agent方式の監視を行う管理ツールAを，インテリジェント統合管理基盤で管理します。管理ツールAは監視対象ホスト上のユーザープログラム，OSのログ，性能を監視します。監視結果は管理ツールAのAgentからManagerへ通知されたあと，管理ツールのManagerがJP1イベントを発行しJP1/IMへ通知します。

図7‒5　管理ツールAを使用した運用・構成

管理ツールAをインテリジェント統合管理基盤で管理する場合のツリー構成を，次に示します。

図7‒6　管理ツールAをインテリジェント統合管理基盤で管理する場合のツリー構成

7.5.2　管理ツールAの管理ノードのSIDの例

SIDの例として，管理ツールAのManagerホストAとAgentホストBのSIDを，次の表に示します。

表7‒37　管理ツールAのManagerホストAとAgentホストBのSID

管理ノード

SID

カテゴリ

ToolA-Managerのホスト名

_ToolA-M_hostA/_HOST_hostA

−

ホスト内のToolA-Manager

_ToolA-M_hostA/_HOST_hostA/_TOOLAMGR_

Management Applications

監視対象ホスト（ToolA-Agent）のホスト名

_ToolA-M_hostA/_ToolA-A_hostB/_HOST_hostB

−

監視対象ホスト（ToolA-Agent）のToolA-Agent

_ToolA-M_hostA/_ToolA-A_hostB/_HOST_hostB/_TOOLAAGR_

Management Applications

監視対象ホスト（ToolA-Agent）のPlatform

_ToolA-M_hostA/_ToolA-A_hostB/_HOST_hostB/_PLATFORM_

Platform

監視対象ホスト（ToolA-Agent）のUser Program

_ToolA-M_hostA/_ToolA-A_hostB/_HOST_hostB/_PLATFORM_UP-1

UP

7.5.3　管理ツールAが発行するJP1イベント

管理ツールAが発行するJP1イベントで，管理ツールAのAgentホストDで発生した事象に対するJP1イベントの例を，次の表に示します。

表7‒38　 AgentホストDで発生した事象に対するJP1イベント

イベントの種類

イベントID

B.SOURCESERVER

E.TOOLA_AGTHOST

E.UP_NAME

ToolA-Agentイベント

0x7FFF8000

hostA

hostD

なし

OS監視イベント

0x7FFF8001

hostA

hostD

なし

User Program監視イベント

0x7FFF8002

hostA

hostD

UP-3

7.5.4　サンプルプラグイン

管理ツールAをインテリジェント統合管理基盤で管理する場合に作成するプラグインのサンプルを，次に示します。

/*
 * Copyright (C) 2018, Hitachi, Ltd.
 * Copyright (C) 2018, Hitachi Solutions, Ltd.
 * Licensed Material of Hitachi, Ltd.
 * Licensed Material of Hitachi Solutions, Ltd.
 */

// Component name of the management tool A
const TOOLA_COMPONENT_NAME = "/HITACHI/TOOLA";
// JavaScript name of the management tool A
const JS_NAME = "toola";
// The type of SID for representing the SID related to host
const TYPE_SID_HOST = "HOST";
// The type of SID for representing the SID related to the server of the management tool A
const TYPE_SID_TOOLA_M = "ToolA-M";
// The type of SID for representing the SID related to the agent of the management tool A
const TYPE_SID_TOOLA_A = "ToolA-A";
// The type of SID for representing the SID related to the management tool A - Manager
const TYPE_SID_TOOLA_MGR = "TOOLAMGR";
// The type of SID for representing the SID related to the management tool A - Agent
const TYPE_SID_TOOLA_AGT = "TOOLAAGT";
// The type of SID for representing the SID related to the platform
const TYPE_SID_PLATFORM = "PLATFORM";
// The type of SID for representing the SID related to the user program
const TYPE_SID_UP = "UP";

module.exports = {

    /**
     * Convert ToolA configuration information to JSON format.
     *
     * @param {Object} args
     *     args = {
     *       hostname: string,        // Acquired host name
     *       component: string,       // Target component("/HITACHI/TOOLA")
     *       data: string,            // Result of execution of adapter command(UTF-8) (except header)
     *       jp1UserName: string,     // JP1 user name
     *       jp1Token: string,        // JP1 token
     *       protocolName:string,     // Protocol name with adapter command
     *       protocolVersion:string,  // Protocol version with adapter command
     *       codeset:string,          // Codeset with adapter command
     *       productName:string       // Product name with adapter command
     *       setResult:function       // Function for normal case
     *       setError:function        // Function for error case
     *     }
     */
    __configurationGet: function(args) {
        logTrace("__configurationGet start");

        if (!isValidProductName(args.component)) {
            var msg = "Componentname (" + String(args.component) + ") is invalid.";
            logTrace(msg);
            return;
        }

        // Configuration information object in JSON format.
        var configObj = {
            "meta": {
                "timestamp": ""
            },
            "simtData": []
        };

        try {
            // adapter command data.
            var adapterCmdDataObj = parseAdapterCmdData(args.data);

            // ToolA - Manager host name
            var mgrHostName = encodeURI(adapterCmdDataObj.hostName);

            // push SimtData for ToolA - Manager
            pushSimtDataForManagerHost(configObj.simtData, mgrHostName);

            // ToolA - Agent host object list
            var agtHostObjList = getAgentHostObjList(adapterCmdDataObj.baseURL, adapterCmdDataObj.uid, adapterCmdDataObj.pwd);
            agtHostObjList.forEach(function(agtHostObj) {
                // push SimtData for ToolA - Agent
                pushSimtDataForAgentHost(configObj.simtData, mgrHostName, agtHostObj);
            });
        } catch(e) {
            var msg = "Exception occurs. message=" + e.message;
            logTrace(msg);
            args.setError(msg);
        }

        configObj.meta.timestamp = (new Date()).toISOString();
        args.setResult(JSON.stringify(configObj));
        logTrace("__configurationGet end");
    },

    /**
     * Generate sid from JP1 event.
     *
     * @param {Object} args
     *     args = {
     *       productName: string,    // Name of the program that issued the JP1 event.
     *       idBase: number,        // Event ID
     *       event: {value: Object}    // JP1 event attribute information
     *     }
     */
    __eventGet: function(args) {
        logTrace("__eventGet start");

        if (!isValidProductName(args.productName)) {
            return;
        }

        try {
            var sid = null;
            switch (args.idBase) {
                // generate sid of ToolA - Agent event.
                case 0x7FFF8000:
                    sid = createToolAAgtSidFromEvent(args.event.value);
                    break;

                // generate sid of os event.
                case 0x7FFF8001:
                    sid = createPlatformSidFromEvent(args.event.value);
                    break;

                // generate sid of user program event.
                case 0x7FFF8002:
                    sid = createUPSidFromEvent(args.event.value);
                    break;

                default:
                    logTrace("Unsupported args.idBase=" + args.idBase.toString(16));
                    break;
            }

            if (sid !== null) {
                logTrace("args.setTargetSid=" + sid);
                args.setTargetSid(sid);
            }

        } catch(e) {
            var msg = "Exception occurs. message=" + e.message;
            logTrace(msg);
            args.setError(msg);
        }
        logTrace("__eventGet end");
    },

    __createLink: function(args) {
        logTrace("__createLink start");

        logTrace("__createLink end");
    },

    xxxt: function(args) {
        logTrace("xxxt start");

        logTrace("xxxt end");
    }
};

// if debug is true, output debug message.
var isDebug = true;

/**
 * Output log message.
 * @param {string} msg message
*/
function logTrace(msg) {
    jp1Logger.trace(JS_NAME, msg);
}

/**
 * Output log message.
 * @param {string} msg message
*/
function logDebug(msg) {
    if (!isDebug) {
        return;
    }
    jp1Logger.trace(JS_NAME, msg);
}

/**
 * Return whether product name is valid
 * @param {string} productName product name
 * @return {boolean} true if product name is valid
*/
function isValidProductName(productName) {
    return (String(productName) === TOOLA_COMPONENT_NAME);
}

/**
 * Parse data of adapter command
 * @param {string} adapterCmdData adapter command data
 * @return {Object} adapterCmdDataObj
 *     adapterCmdDataObj = {
 *       hostname: string,   // Server name
 *       baseURL: string,    // base URL for REST API
 *       uid: string,        // user id for REST API
 *       pwd: string,        // user password for REST API
 *     }
*/
function parseAdapterCmdData(adapterCmdData) {
    return JSON.parse(adapterCmdData);
}

/**
 * push simtData of ToolA - Manager
 * @param {Object[]} simtData simt data
 * @param {string} mgrHostName ToolA-Manager host name
 */
function pushSimtDataForManagerHost(simtData, mgrHostName) {
    // create Manager Host SID
    var mgrHostSid = jp1SimtService.join(
        jp1SimtService.packHost(TYPE_SID_TOOLA_M, mgrHostName),
        jp1SimtService.packHost(TYPE_SID_HOST, mgrHostName));
    var mgrHostSidValue = {
        component: TOOLA_COMPONENT_NAME,
        label: mgrHostName
    };
    simtData.push({
        sid: mgrHostSid,
        value: mgrHostSidValue
    });

    // create Manager SID
    var mgrSid = jp1SimtService.join(
        jp1SimtService.packHost(TYPE_SID_TOOLA_M, mgrHostName),
        jp1SimtService.packHost(TYPE_SID_HOST, mgrHostName),
        jp1SimtService.pack(TYPE_SID_TOOLA_MGR, ""));
    var mgrSidValue = {
        component: TOOLA_COMPONENT_NAME,
        category: "managementApplications",
        label: "ToolA - Manager"
    };
    simtData.push({
        sid: mgrSid,
        value: mgrSidValue
    });
}

/**
 * push simtData of ToolA - Agent
 * @param {Object[]} simtData simt data
 * @param {string} mgrHostName ToolA-Manager host name
 * @param {Object} agtHostObj
 */
function pushSimtDataForAgentHost(simtData, mgrHostName, agtHostObj) {
    // ToolA - Agent host name
    var agtHostName = encodeURI(agtHostObj.hostName);

    // create Agent Host SID
    var agtHostSid = jp1SimtService.join(
        jp1SimtService.packHost(TYPE_SID_TOOLA_M, mgrHostName),
        jp1SimtService.packHost(TYPE_SID_TOOLA_A, agtHostName),
        jp1SimtService.packHost(TYPE_SID_HOST, agtHostName));
    var agtHostSidValue = {
        component: TOOLA_COMPONENT_NAME,
        label: agtHostName
    };
    simtData.push({
        sid: agtHostSid,
        value: agtHostSidValue
    });

    // create Agent SID
    var agtSid = jp1SimtService.join(
        jp1SimtService.packHost(TYPE_SID_TOOLA_M, mgrHostName),
        jp1SimtService.packHost(TYPE_SID_TOOLA_A, agtHostName),
        jp1SimtService.packHost(TYPE_SID_HOST, agtHostName),
        jp1SimtService.pack(TYPE_SID_TOOLA_AGT, ""));
    var agtSidValue = {
        component: TOOLA_COMPONENT_NAME,
        category: "managementApplications",
        label: "ToolA - Agent"
    };
    simtData.push({
        sid: agtSid,
        value: agtSidValue
    });

    // create Platform SID
    var agtSid = jp1SimtService.join(
        jp1SimtService.packHost(TYPE_SID_TOOLA_M, mgrHostName),
        jp1SimtService.packHost(TYPE_SID_TOOLA_A, agtHostName),
        jp1SimtService.packHost(TYPE_SID_HOST, agtHostName),
        jp1SimtService.pack(TYPE_SID_PLATFORM, ""));
    var agtSidValue = {
        component: TOOLA_COMPONENT_NAME,
        category: "platform",
        label: agtHostObj.osName
    };
    simtData.push({
        sid: agtSid,
        value: agtSidValue
    });

    // create UserProgram SID
    agtHostObj.upList.forEach(function(upName){
        var agtSid = jp1SimtService.join(
            jp1SimtService.packHost(TYPE_SID_TOOLA_M, mgrHostName),
            jp1SimtService.packHost(TYPE_SID_TOOLA_A, agtHostName),
            jp1SimtService.packHost(TYPE_SID_HOST, agtHostName),
            jp1SimtService.pack(TYPE_SID_UP, upName));
        var agtSidValue = {
            component: TOOLA_COMPONENT_NAME,
            category: "up",        // custom categoryId
            label: upName
        };
        simtData.push({
            sid: agtSid,
            value: agtSidValue
        });
    });
}

/**
 * Get ToolA Agent data from ToolA - Manager
 * @param {string} baseURL ToolA-Manager host name
 * @param {string} uid userid for RESTAPI
 * @param {string} pwd password for RESTAPI
 * @return {Object[]} agtHostObjList list of agtHostObj
 *     agtHostObj = {
 *       hostName: string,   // Server name
 *       osName: string,     // OS name
 *       upList: [string]    // user program list
 *     }
 */
function getAgentHostObjList(baseURL, uid, pwd) {
    var agtHostObjList = [];

    // make url for authentication
    var fullUrl = baseURL + "/v1/authentication";
    var requestHeaderObj = {"ContentType" : "application/json"};
    var requestBody = JSON.stringify({"Username" : uid, "Password" : pwd});

    // call authentication REST API
    logTrace(fullUrl);
    logDebug(JSON.stringify(requestHeaderObj));
    logDebug(requestBody);

//    var resultObj = jp1Imdd.callRest(
//        "POST"
//        , fullUrl
//        , requestHeaderObj
//        , requestBody
//    );
//    if (resultObj.response === undefined) {
//        logTrace(JSON.stringify(resultObj));
//        return agtHostObjList;
//    }
    var resultObj = {
        "response": {
            "body": JSON.stringify({"token": "auth_token"})
        }
    };

    // authentication result
    var bodyObj = JSON.parse(resultObj.response.body);
    logDebug(JSON.stringify(bodyObj));

    // make url for agent configuration
    fullUrl = baseURL + "/v1/devices/list";
    requestHeaderObj = {"ContentType" : "application/json", "X-Authorization" : bodyObj.token};
    requestBody = JSON.stringify({"filter": ""});

    // call agent configuration REST API
    logTrace(fullUrl);
    logDebug(JSON.stringify(requestHeaderObj));
    logDebug(requestBody);

//    resultObj = jp1Imdd.callRest(
//        "POST"
//        , fullUrl
//        , requestHeaderObj
//        , requestBody
//    );
//    if (resultObj.response === undefined) {
//        logTrace(JSON.stringify(resultObj));
//        return agtHostObjList;
//    }
    resultObj = {
        "response": {
            "body": JSON.stringify({
                "deviceList": [
                {"hostName": "hostB", "osName": "Linux", "upList": ["UP-1"]},
                {"hostName": "hostC", "osName": "Linux", "upList": ["UP-2"]},
                {"hostName": "hostD", "osName": "Windows", "upList": ["UP-3"]},
                {"hostName": "hostE", "osName": "Windows", "upList": ["UP-1", "UP-4"]}]
            })
        }
    };

    bodyObj = JSON.parse(resultObj.response.body);
    logDebug(JSON.stringify(bodyObj));

    bodyObj.deviceList.forEach(function(deviceObj) {
        agtHostObjList.push({
            "hostName": deviceObj.hostName,
            "osName": deviceObj.osName,
            "upList": deviceObj.upList
        });
    });

    return agtHostObjList;
}

/**
 * create SID related to the ToolA - Agent from JP1 event
 * @param {Object} eventValue event value
 * @return {string} sid
*/
function createToolAAgtSidFromEvent(eventValue) {
    var mgrHostName = encodeURI(eventValue["B.SOURCESERVER"]);
    var agtHostName = encodeURI(eventValue["E.TOOLA_AGTHOST"]);

    return jp1SimtService.join(
        jp1SimtService.packHost(TYPE_SID_TOOLA_M, mgrHostName),
        jp1SimtService.packHost(TYPE_SID_TOOLA_A, agtHostName),
        jp1SimtService.packHost(TYPE_SID_HOST, agtHostName),
        jp1SimtService.pack(TYPE_SID_TOOLA_AGT, ""));
}

/**
 * create SID related to the platform from JP1 event
 * @param {Object} eventValue event value
 * @return {string} sid
*/
function createPlatformSidFromEvent(eventValue) {
    var mgrHostName = encodeURI(eventValue["B.SOURCESERVER"]);
    var agtHostName = encodeURI(eventValue["E.TOOLA_AGTHOST"]);

    return jp1SimtService.join(
        jp1SimtService.packHost(TYPE_SID_TOOLA_M, mgrHostName),
        jp1SimtService.packHost(TYPE_SID_TOOLA_A, agtHostName),
        jp1SimtService.packHost(TYPE_SID_HOST, agtHostName),
        jp1SimtService.pack(TYPE_SID_PLATFORM, ""));
}

/**
 * create SID related to the user program from JP1 event
 * @param {Object} eventValue event value
 * @return {string} sid
*/
function createUPSidFromEvent(eventValue) {
    var mgrHostName = encodeURI(eventValue["B.SOURCESERVER"]);
    var agtHostName = encodeURI(eventValue["E.TOOLA_AGTHOST"]);
    var upName = encodeURI(eventValue["E.UP_NAME"]);

    return jp1SimtService.join(
        jp1SimtService.packHost(TYPE_SID_TOOLA_M, mgrHostName),
        jp1SimtService.packHost(TYPE_SID_TOOLA_A, agtHostName),
        jp1SimtService.packHost(TYPE_SID_HOST, agtHostName),
        jp1SimtService.pack(TYPE_SID_UP, upName));
}

7.6　制御文字

ユーザー作成プラグインで使用できない制御文字について，次の表に示します。

表7‒39　ユーザー作成プラグインで使用できない制御文字

コード

値

説明

00

NUL

NULl（ヌル）

01

SOH

Start Of Heading（ヘッダー開始）

02

STX

Start of TeXt（テキスト開始）

03

ETX

End of TeXt（テキスト終了）

04

EOT

End Of Transmission（転送終了）

05

ENQ

ENQuiry（問い合わせ）

06

ACK

ACKnowledge（肯定応答）

07

BEL

BELl（ベル）

08

BS

Back Space（後退）

09

HT

Horizontal Tabulation（水平タブ）

0A

LF

Line Feed（改行）

0B

VT

Vertical Tabulation（垂直タブ）

0C

FF

Form Feed（改ページ）

0D

CR

Carriage Return（復帰）

0E

SO

Shift Out（シフトアウト）

0F

SI

Shift In（シフトイン）

10

DLE

Data Link Escape（伝送制御拡張）

11

DC1

Device Control 1（装置制御1）

12

DC2

Device Control 2（装置制御2）

13

DC3

Device Control 3（装置制御3）

14

DC4

Device Control 4（装置制御4）

15

NAK

Negative AcKnowledge（否定応答）

16

SYN

SYNchronous idle（同期信号）

17

ETB

End of Transmission Block（転送ブロック終了）

18

CAN

CANcel（取消）

19

EM

End of Medium（媒体終端）

1A

SUB

SUBstitute（置換）

1B

ESC

ESCape（拡張）

1C

FS

File Separator（ファイル分離）

1D

GS

Group Separator（グループ分離）

1E

RS

Record Separator（レコード分離）

1F

US

Unit Separator（ユニット分離）

7F

DEL

DELete（削除）

80

PAD

PADding character（埋め込み文字）

81

HOP

High Octet Preset（ハイオクテットプリセット）

82

BPH

Break Permitted Here（分割許可）

83

NBH

No Break Here（分割禁止）

84

IND

INDex（索引）

85

NEL

NExt Line（復帰改行）

86

SSA

Start of Selected Area（選択領域開始）

87

ESA

End of Selected Area（選択領域終了）

88

HTS

Horizontal Tabulation Set（水平タブ）

89

HTJ

Horizontal Tabulation with Justification（調整付水平タブ）

8A

VTS

Vertical Tabulation Set（垂直タブ）

8B

PLD

Partial Line Down（下行）

8C

PLU

Partial Line Up（上行）

8D

RI

Reverse line feed（前ページ）

8E

SS2

Single Shift 2（1文字シフト2）

8F

SS3

Single Shift 3（1文字シフト3）

90

DCS

Device Control String（装置制御文字列）

91

PU1

Private Use 1（私的利用1）

92

PU2

Private Use 2（私的利用2）

93

STS

Set Transmit State（転送状態設定）

94

CCH

Cancel CHaracter（取消文字）

95

MW

Message Waiting（メッセージ待機）

96

SPA

Start of Protected Area（保護領域開始）

97

EPA

End of Protected Area（保護領域終了）

98

SOS

Start Of String（文字列開始）

99

SGCI

Single Graphic Character Introducer（単一図形文字開始）

9A

SCI

Single Character Introducer（単一文字開始）

9B

CSI

Control Sequence Introducer（制御シーケンス開始）

9C

ST

String Terminator（文字列終了）

9D

OSC

Operating System Command（OSコマンド）

9E

PM

Privacy Message（秘密メッセージ）

9F

APC

Application Program Command（APコマンド）

8　システム監視オブジェクト一覧（セントラルスコープ用）

この章では，JP1/IMで提供しているシステム監視オブジェクトについて説明します。

8.1　システム監視オブジェクトとは

システム監視オブジェクトとは，システムが提供している監視オブジェクトで，製品ごとに基本的な設定項目があらかじめ定義されています。

この章で説明する監視ツリーや監視オブジェクトに関する機能，および表の見方については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の「5.2　監視ツリー」を参照してください。また，監視ツリーや監視オブジェクトの設定手順については，マニュアル「JP1/Integrated Management 3 - Manager 構築ガイド」の「6.3　監視ツリーをGUIで作成する」を参照してください。

8.2　システム監視オブジェクト対応製品一覧

JP1/IM - Managerがシステム監視オブジェクトを提供している製品と自動生成機能への対応を次の表に示します。

JP1/IM - Managerがシステム監視オブジェクトを提供している製品と自動生成機能への対応

表8‒1　JP1/IM - Managerがシステム監視オブジェクトを提供している製品と自動生成機能への対応状況

製品名

自動生成機能への対応

JP1/AJS2 07-00以降，JP1/AJS3 09-00以降

対応済み※3

JP1/Cm2/SSO バージョン7またはバージョン8※1※2

対応済み※3

JP1/Cm2/SSO 07-00以降※1※2

対応済み※3

JP1/PFM 07-00以降

対応済み※3

JP1/PAM 07-00以降

未対応

JP1/NETM/DM 07-00以降

未対応

JP1/Cm2/NNM バージョン7またはバージョン8※2

未対応

JP1/NNMi

未対応

JP1/IM - Central Console 07-00以降

対応済み※3

Cosminexus 06-00以降

対応済み※3

HiRDB 07-02以降

未対応

JP1/ServerConductor 07-50以降

未対応

注※1　バージョン7時の製品名称は，JP1/PFM/SSOです。

注※2　連携製品のインストールホスト上にバージョン7またはバージョン8のJP1/Baseが必要です。

注※3　自動生成するには，連携製品のインストールホスト上に07-00以降のJP1/Baseが必要です。また，JP1/IM - Managerと同バージョンのJP1/IM - Viewが必要です。

8.3　JP1/AJS用システム監視オブジェクト

JP1/AJS用のシステム監視オブジェクトには，「AJS監視」と「ジョブネット監視(AJS)」があります。

8.3.1　「AJS監視」システム監視オブジェクト

表8‒2　システム監視オブジェクトの概要

項目

説明

監視ノード種別

AJS監視

目的

JP1/AJS自身の障害の監視，

ジョブネットの実行状態の監視

基本情報

オブジェクト名

ジョブネットの完全名（スケジューラーサービス名：/ジョブネット名）

（例）AJSROOT1:/業務A/受注処理

ホスト名

JP1/AJS - Managerがインストールされているマネージャーのホスト名

（例）host01

表8‒3　状態変更条件

状態変更条件

共通条件※，個別条件

条件名

状態

条件

比較する値

ジョブネット警告のイベント(AJS)

警告

ジョブネット警告のイベント(AJS)※

イベントID（B.ID）

00004108，00004122，00004123

オブジェクトID（E.OBJECT_NAME）

基本情報のオブジェクト名

発行元イベントサーバ名（B.SOURCESERVER）

基本情報のホスト名

ジョブネットエラーのイベント(AJS)

エラー

ジョブネットエラーのイベント(AJS)※

イベントID（B.ID）

00004104，00004131，00004142，00004143，00004144

オブジェクトID（E.OBJECT_NAME）

基本情報のオブジェクト名

発行元イベントサーバ名（B.SOURCESERVER）

基本情報のホスト名

システム警告のイベント(AJS)

警告

システム警告のイベント(AJS)※

イベントID（B.ID）

00004154，00004164，00004171，000041F1

発行元イベントサーバ名（B.SOURCESERVER）

基本情報のホスト名

システムエラーのイベント(AJS)

エラー

システムエラーのイベント(AJS)※

イベントID（B.ID）

00004110，00004130，00004152，00004162，00004170，000041F0，000041F3

発行元イベントサーバ名（B.SOURCESERVER）

基本情報のホスト名

注※　共通条件（各監視オブジェクトで共通に使われる条件）です。

8.3.2　「ジョブネット監視(AJS)」システム監視オブジェクト

表8‒4　システム監視オブジェクトの概要

項目

説明

監視ノード種別

ジョブネット監視(AJS)

目的

ジョブの実行状態の監視

基本情報

ジョブ実行ホスト

ジョブを実行するホストのホスト名

（例）jp1-agent

発行元イベントサーバ

JP1/AJS - Managerがインストールされているホストのホスト名

（例）jp1-manager

登録名

ルートジョブネットの完全名（スケジューラーサービス名：/ルートジョブネット名）

（例）AJSROOT1:/業務A/受注処理

表8‒5　状態変更条件

状態変更条件

共通条件※，個別条件

条件名

状態

条件

比較する値

ジョブ警告のイベント(AJS)

警告

ジョブ警告のイベント(AJS)※

イベントID（B.ID）

00004109

登録名（E.ROOT_OBJECT_NAME）

基本情報の登録名

実行先ホスト名（E.C0）

基本情報のジョブ実行ホスト

発行元イベントサーバ名（B.SOURCESERVER）

基本情報の発行元イベントサーバ

ジョブエラーのイベント(AJS)

エラー

ジョブエラーのイベント(AJS)※

イベントID（B.ID）

00004107

登録名（E.ROOT_OBJECT_NAME）

基本情報の登録名

実行先ホスト名（E.C0）

基本情報のジョブ実行ホスト

発行元イベントサーバ名（B.SOURCESERVER）

基本情報の発行元イベントサーバ

注※　共通条件（各監視オブジェクトで共通に使われる条件）です。

8.4　JP1/Cm2/SSO用システム監視オブジェクト

バージョン8以前のJP1/Cm2/SSO用のシステム監視オブジェクトには，「SSO監視」と「カテゴリー監視(SSO)」および「アプリケーション監視(SSO)」があります。

8.4.1　バージョン8以前のJP1/Cm2/SSO用のシステム監視オブジェクトを監視をする場合の設定について

バージョン8以前のJP1/Cm2/SSO用システム監視オブジェクトを監視する場合に必要な設定について説明します。次の事項を設定する必要があります。

バージョン8以前のJP1/Cm2/SSOはJP1イベントを発行しないため，JP1/Cm2/SSOがバージョン8以前のJP1/Cm2/NNMまたはバージョン7.5以前のHP NNMに対して発行しているSNMPトラップをJP1/Baseの機能を利用してJP1イベントに変換する必要があります。この変換のときに，SNMPトラップのバリアブルバインディングを取り込むようJP1/BaseのSNMPトラップ変換機能で設定する必要があります。

「アプリケーション監視(SSO)」の監視をする場合，バージョン8以前のJP1/Cm2/SSOの定義ファイル（ssoapmon.def）に，SNMPトラップのバリアブルバインディングのソース名を取り込むよう設定する必要があります。

8.4.2　「SSO監視」システム監視オブジェクト

表8‒6　システム監視オブジェクトの概要

項目

説明

監視ノード種別

SSO監視

目的

バージョン8以前のJP1/Cm2/SSO自身の障害の監視

基本情報

ホスト名

バージョン8以前のJP1/Cm2/SSOがインストールされている監視サーバのホスト名

（例）host01

表8‒7　状態変更条件

状態変更条件

共通条件※1，個別条件

条件名

状態

条件

比較する値

システム警戒のイベント(SSO)

警戒

システム警戒のイベント(SSO)※1

イベントID（B.ID）

00003A80

SNMP Object ID（E.SNMP_OID）

〜.15※2

イベント発行元ホスト名（E.SNMP_VARBIND6）

基本情報のホスト名

システムエラーのイベント(SSO)

エラー

システムエラーのイベント(SSO)※1

イベントID（B.ID）

00003A80

SNMP Object ID（E.SNMP_OID）

〜.13※2

イベント発行元ホスト名（E.SNMP_VARBIND6）

基本情報のホスト名

注※1　共通条件（各監視オブジェクトで共通に使われる条件）です。

注※2　「〜」には，「.iso.org.dod.internet.private.enterprises.hitachi.systemAP.comet.sso.0」が入ります。

8.4.3　「カテゴリー監視(SSO)」システム監視オブジェクト

表8‒8　システム監視オブジェクトの概要

項目

説明

監視ノード種別

カテゴリー監視(SSO)

目的

バージョン8以前のJP1/Cm2/SSOが監視しているリソース状態の監視

基本情報

カテゴリー名

カテゴリー名

イベント発行元ホスト

バージョン8以前のJP1/Cm2/SSOがインストールされている監視サーバのホスト名

（例）host01

ホスト名

バージョン8以前のJP1/Cm2/SSOが監視対象としているサーバのホスト名

（例）host02

表8‒9　状態変更条件

状態変更条件

共通条件※1，個別条件

条件名

状態

条件

比較する値

リソース警戒のイベント(SSO)

警戒

リソース警戒のイベント(SSO)※1

イベントID（B.ID）

00003A80

SNMP Object ID（E.SNMP_OID）

〜.24※2

ソース名（E.SNMP_VARBIND12）

基本情報のホスト名

イベント発行元ホスト名（E.SNMP_VARBIND11）

基本情報のイベント発行元ホスト

カテゴリー名（E.SNMP_VARBIND2）

基本情報のカテゴリー名

リソースエラーのイベント(SSO)

エラー

リソースエラーのイベント(SSO)※1

イベントID（B.ID）

00003A80

SNMP Object ID（E.SNMP_OID）

〜.(21|23)※2

ソース名（E.SNMP_VARBIND12）

基本情報のホスト名

イベント発行元ホスト名（E.SNMP_VARBIND11）

基本情報のイベント発行元ホスト

カテゴリー名（E.SNMP_VARBIND2）

基本情報のカテゴリー名

注※1　共通条件（各監視オブジェクトで共通に使われる条件）です。

注※2　「〜」には，「.iso.org.dod.internet.private.enterprises.hitachi.systemAP.comet.sso.0」が入ります。

8.4.4　「アプリケーション監視(SSO)」システム監視オブジェクト

表8‒10　システム監視オブジェクトの概要

項目

説明

監視ノード種別

アプリケーション監視(SSO)

目的

バージョン8以前のJP1/Cm2/SSOで監視しているアプリケーションの状態の監視

基本情報

イベント発行元ホスト

バージョン8以前のJP1/Cm2/SSOがインストールされている監視サーバのホスト名

（例）host01

アプリケーション名

バージョン8以前のJP1/Cm2/SSOが監視対象としているアプリケーションの名称

（例）JP1/PFM

ホスト名

バージョン8以前のJP1/Cm2/SSOが監視対象としているリソース収集対象サーバのホスト名です。

（例）host02

表8‒11　状態変更条件

状態変更条件

共通条件※1，個別条件

条件名

状態

条件

比較する値

アプリケーション警戒のイベント(SSO)

警戒

アプリケーション警戒のイベント(SSO)※1

イベントID（B.ID）

00003A80

SNMP Object ID（E.SNMP_OID）

〜.(109|112|115)※2

ソース名（E.SNMP_VARBIND3）

基本情報のホスト名

イベント発行元ホスト名（E.SNMP_VARBIND2）

基本情報のイベント発行元ホスト

アプリケーション名（E.SNMP_VARBIND1）

基本情報のアプリケーション名

アプリケーションエラーのイベント(SSO)

エラー

アプリケーションエラーのイベント(SSO)※1

イベントID（B.ID）

00003A80

SNMP Object ID（E.SNMP_OID）

〜.(108|110|111|113|116|118)※2

ソース名（E.SNMP_VARBIND3）

基本情報のホスト名

イベント発行元ホスト名（E.SNMP_VARBIND2）

基本情報のイベント発行元ホスト

アプリケーション名（E.SNMP_VARBIND1）

基本情報のアプリケーション名

プロセス監視障害警戒のイベント（SSO）

警戒

プロセス監視障害警戒のイベント（SSO）※1

イベントID（B.ID）

00003A80

SNMP Object ID（E.SNMP_OID）

〜.304※2

監視対象マシンのホスト名（E.SNMP_VARBIND1）

基本情報のホスト名

イベント発行元ホスト（E.SNMP_VARBIND4）

基本情報のイベント発行元ホスト

プロセス監視障害エラーのイベント（SSO）

エラー

プロセス監視障害エラーのイベント（SSO）※1

イベントID（B.ID）

00003A80

SNMP Object ID（E.SNMP_OID）

〜.303※2

監視対象マシンのホスト名（E.SNMP_VARBIND1）

基本情報のホスト名

イベント発行元ホスト（E.SNMP_VARBIND4）

基本情報のイベント発行元ホスト

注※1　共通条件（各監視オブジェクトで共通に使われる条件）です。

注※2　「〜」には，「.iso.org.dod.internet.private.enterprises.hitachi.systemAP.comet.sso.0」が入ります。

8.5　JP1/PFM用システム監視オブジェクト

JP1/PFM用のシステム監視オブジェクトには，「エージェント監視(PFM)」があります。

8.5.1　JP1/PFM用システム監視オブジェクトを監視する場合の設定について

JP1/PFM用システム監視オブジェクトを監視する場合に必要な設定について説明します。次の事項を設定する必要があります。

JP1/PFM - Managerからの事象を管理するには，JP1/PFM - Managerのアラームの設定で，アラーム状態が変化したときに，コマンド実行のアクションでJP1イベントを発行するよう設定が必要です。これは，デフォルトではJP1イベントを発行しない設定になっているためです。

8.5.2　「エージェント監視(PFM)」システム監視オブジェクト

表8‒12　システム監視オブジェクトの概要

項目

説明

監視ノード種別

エージェント監視(PFM)

目的

JP1/PFMのエージェントの状態の監視

基本情報

オブジェクトID

JP1/PFMのエージェントのサービスID

（例）TA1host01

発行元イベントサーバ

JP1/PFM - Managerがインストールされているホストのホスト名

（例）pfm-manager

ホスト名

JP1/PFM - Agentがインストールされているホストのホスト名

（例）pfm-agent

表8‒13　状態変更条件

状態変更条件

共通条件※1，個別条件

条件名

状態

条件

比較する値

リソースエラーのイベント(PFM)

エラー

リソースエラーのイベント(PFM)※2

重大度（E.SEVERITY）

Error

プロダクト名（E.PRODUCT_NAME）

/PFM/ALARM_EVENT

オブジェクトID（E.OBJECT_ID）

基本情報のオブジェクトID

アラーム発生ホスト名（E.JPC_AGENT）

基本情報のホスト名

発行元イベントサーバ名（B.SOURCESERVER）

基本情報の発行元イベントサーバ

リソース警告のイベント(PFM)

警告

リソース警告のイベント(PFM)※1

重大度（E.SEVERITY）

Warning

プロダクト名（E.PRODUCT_NAME）

/PFM/ALARM_EVENT

オブジェクトID（E.OBJECT_ID）

基本情報のオブジェクトID

アラーム発生ホスト名（E.JPC_AGENT）

基本情報のホスト名

発行元イベントサーバ名（B.SOURCESERVER）

基本情報の発行元イベントサーバ

注※1　共通条件（各監視オブジェクトで共通に使われる条件）です。

注※2　サービスIDに含まれるプロダクトIDと機能IDで，JP1/PFMのサービスを判別します。次に，対応するサービスを示します。

プロダクトIDが「P」（PFM-Manager）以外のサービス。

機能IDが「A」（Agent Collector）のサービス。

8.6　JP1/PAM用システム監視オブジェクト

JP1/PAM用のシステム監視オブジェクトには，「メトリック監視(PAM)」と「オブジェクト監視(PAM)」があります。

8.6.1　「メトリック監視(PAM)」システム監視オブジェクト

表8‒14　システム監視オブジェクトの概要

項目

説明

監視ノード種別

メトリック監視(PAM)

目的

JP1/PAMのメトリックの状態を監視

基本情報

ホスト名

JP1/PAMの監視対象ホストのホスト名

（例）host1

表8‒15　状態変更条件

状態変更条件

共通条件※，個別条件

条件名

状態

条件

比較する値

メトリックエラーのイベント（PAM）

エラー

メトリックエラーのイベント（PAM）※

イベントID（B.ID）

00004602，00004604，0000460B

ホスト名（E.PAM_HOSTNAME）

基本情報のホスト名

メトリック警告のイベント（PAM）

警告

メトリック警告のイベント（PAM）※

イベントID（B.ID）

00004600，00004603，00004609

ホスト名（E.PAM_HOSTNAME）

基本情報のホスト名

注※　共通条件（各監視オブジェクトで共通に使われる条件）です。

8.6.2　「オブジェクト監視(PAM)」システム監視オブジェクト

表8‒16　システム監視オブジェクトの概要

項目

説明

監視ノード種別

オブジェクト監視(PAM)

目的

JP1/PAMが管理するオブジェクトの状態の監視

基本情報

ホスト名

JP1/PAMの監視対象ホストのホスト名

（例）host1

表8‒17　状態変更条件

状態変更条件

共通条件※，個別条件

条件名

状態

条件

比較する値

オブジェクトエラーのイベント（PAM）

エラー

オブジェクトエラーのイベント（PAM）※

イベントID（B.ID）

00004620，00004625

ホスト名（E.PAM_HOSTNAME）

基本情報のホスト名

注※　共通条件（各監視オブジェクトで共通に使われる条件）です。

8.7　JP1/NETM/DM用システム監視オブジェクト

JP1/NETM/DM用のシステム監視オブジェクトには，「NETM/DM監視」と「配布ジョブ監視(NETM/DM)」があります。

8.7.1　「NETM/DM監視」システム監視オブジェクト

表8‒18　システム監視オブジェクトの概要

項目

説明

監視ノード種別

NETM/DM監視

目的

JP1/NETM/DM Manager自身の障害の監視

基本情報

ホスト名

JP1/NETM/DM Managerがインストールされているマネージャーのホスト名

（例）host01

表8‒19　状態変更条件

状態変更条件

共通条件※，個別条件

条件名

状態

条件

比較する値

システム致命的のイベント(NETM/DM)

致命的

システム致命的のイベント(NETM/DM)※

イベントID（B.ID）

00010401

発行元イベントサーバ名（B.SOURCESERVER）

基本情報のホスト名

注※　共通条件（各監視オブジェクトで共通に使われる条件）です。

8.7.2　「配布ジョブ監視(NETM/DM)」システム監視オブジェクト

表8‒20　システム監視オブジェクトの概要

項目

説明

監視ノード種別

配布ジョブ監視(NETM/DM)

目的

JP1/NETM/DMによる配布ジョブの実行状態の監視

基本情報

ホスト名

JP1/NETM/DM Managerがインストールされているマネージャーのホスト名

（例）host01

表8‒21　状態変更条件

状態変更条件

共通条件※，個別条件

条件名

状態

条件

比較する値

配布ジョブエラーのイベント(NETM/DM)

エラー

配布ジョブエラーのイベント(NETM/DM)※

イベントID（B.ID）

00010403

発行元イベントサーバ名（B.SOURCESERVER）

基本情報のホスト名

注※　共通条件（各監視オブジェクトで共通に使われる条件）です。

8.8　JP1/NNMi用システム監視オブジェクト

JP1/NNMi用のシステム監視オブジェクトには，「NNMi監視(NNMi)」と「ノード監視(NNMi)」があります。

8.8.1　JP1/NNMi用システム監視オブジェクトを監視する場合の設定について

JP1/NNMi用システム監視オブジェクトを監視する場合に必要な設定について説明します。JP1/NNMiが発行するNNMiインシデントの監視にあたって，ManagementインシデントとSNMPトラップの区別は行いません。

「NNMi監視(NNMi)」または「ノード監視(NNMi)」を使用する場合は，JP1/IM - EG for NNMiが発行するNNMiインシデントを変換したJP1イベントに，拡張属性「NNMI_FAMILY_UK」を設定してください。

拡張属性「NNMI_FAMILY_UK」を設定しない場合，「NNMi監視(NNMi)」または「ノード監視(NNMi)」による監視ができません。

拡張属性「NNMI_FAMILY_UK」の設定およびNNMiインシデントの詳細については，マニュアル「JP1/Integrated Management 3 - Event Gateway for Network Node Manager i」を参照してください。

8.8.2　「NNMi監視(NNMi)」システム監視オブジェクト

表8‒22　システム監視オブジェクトの概要

項目

説明

監視ノード種別

「NNMi監視(NNMi)」

目的

JP1/NNMi自身の障害の監視

基本情報

ホスト名

JP1/NNMiがインストールされているマネージャーのホスト名

（例）host01

表8‒23　状態変更条件

状態変更条件

共通条件※，個別条件

条件名

状態

条件

比較する値

システム警戒のイベント(NNMi)

警戒

システム警戒のイベント(NNMi)※

イベントID（B.ID）

00006100

イベント発生ノード名（E.NNMI_SRC_NODE_NAME）

ホスト名

システム致命的のイベント(NNMi)

致命的

システム致命的のイベント(NNMi)※

イベントID（B.ID）

00006100

イベント発生ノード名（E.NNMI_SRC_NODE_NAME）

ホスト名

システム警告のイベント(NNMi)

警告

システム警告のイベント(NNMi)※

イベントID（B.ID）

00006100

イベント発生ノード名（E.NNMI_SRC_NODE_NAME）

ホスト名

注※　共通条件（各監視オブジェクトで共通に使われる条件）です。

8.8.3　「ノード監視(NNMi)」システム監視オブジェクト

表8‒24　システム監視オブジェクトの概要

項目

説明

監視ノード種別

ノード監視(NNMi)

目的

JP1/NNMiが監視するノードの状態の監視

基本情報

ホスト名

JP1/NNMiが監視しているノードのホスト名

（例）host01

表8‒25　状態変更条件

状態変更条件

共通条件※，個別条件

条件名

状態

条件

比較する値

ネットワーク警戒のイベント(NNMi)

警戒

ネットワーク警戒のイベント(NNMi)※

イベントID（B.ID）

00006100

イベント発生ノード名（E.NNMI_SRC_NODE_NAME）

基本情報のホスト名

ネットワーク致命的のイベント(NNMi)

致命的

ネットワーク致命的のイベント(NNMi)※

イベントID（B.ID）

00006100

イベント発生ノード名（E.NNMI_SRC_NODE_NAME）

基本情報のホスト名

ネットワーク警告のイベント(NNMi)

警告

ネットワーク警告のイベント(NNMi)※

イベントID（B.ID）

00006100

イベント発生ノード名（E.NNMI_SRC_NODE_NAME）

基本情報のホスト名

注※　共通条件（各監視オブジェクトで共通に使われる条件）です。

8.9　JP1/Cm2/NNM用システム監視オブジェクト

バージョン8以前のJP1/Cm2/NNM用のシステム監視オブジェクトには，「NNM監視」と「ノード監視(NNM)」があります。

8.9.1　「NNM監視」システム監視オブジェクト

表8‒26　システム監視オブジェクトの概要

項目

説明

監視ノード種別

NNM監視

目的

バージョン8以前のJP1/Cm2/NNM自身の障害の監視

基本情報

ホスト名

バージョン8以前のJP1/Cm2/NNMがインストールされているマネージャーのホスト名

（例）host01

表8‒27　状態変更条件

状態変更条件

共通条件※1，個別条件

条件名

状態

条件

比較する値

システム警戒のイベント(NNM)

警戒

システム警戒のイベント(NNM)※1

イベントID（B.ID）

00003A80

SNMP Object ID（E.SNMP_OID）

〜.(50790429|58851330|59179066|59179227|59179229|59179230|40000020)※2

イベント発生ノード名（E.SNMP_VARBIND2）

基本情報のホスト名

システム致命的のイベント(NNM)

致命的

システム致命的のイベント(NNM)※1

イベントID（B.ID）

00003A80

SNMP Object ID（E.SNMP_OID）

〜.(58720265|58720270|58851329|58851332|59179058|59181005|59181006|59179225|59179228|59179232|59179234|59180002|59180005|59180100|59181002|59181004|58982397|58982398|58982401|58982402|58982415|58982417|58982422|59179061|40000028|58720263)※2

イベント発生ノード名（E.SNMP_VARBIND2）

基本情報のホスト名

システムエラーのイベント(NNM)

エラー

システムエラーのイベント(NNM)※1

イベントID（B.ID）

00003A80

SNMP Object ID（E.SNMP_OID）

〜.(58720266|59047936|59179226|59179233|59179235|58982408|58982414|50790430|40000021)※1

イベント発生ノード名（E.SNMP_VARBIND2）

基本情報のホスト名

システム警告のイベント(NNM)

警告

システム警告のイベント(NNM)※1

イベントID（B.ID）

00003A80

SNMP Object ID（E.SNMP_OID）

〜.(40000027|58982399|59179065)※2

イベント発生ノード名（E.SNMP_VARBIND2）

基本情報のホスト名

注※1　共通条件（各監視オブジェクトで共通に使われる条件）です。

注※2　「〜」には，「.iso.org.dod.internet.private.enterprises.hp.nm.openView.hpOpenView.0」が入ります。

8.9.2　「ノード監視(NNM)」システム監視オブジェクト

表8‒28　システム監視オブジェクトの概要

項目

説明

監視ノード種別

ノード監視(NNM)

目的

バージョン8以前のJP1/Cm2/NNMが監視するノードの状態の監視

基本情報

ホスト名

バージョン8以前のJP1/Cm2/NNMが監視しているノードのホスト名

（例）host01

表8‒29　状態変更条件

状態変更条件

共通条件※1，個別条件

条件名

状態

条件

比較する値

ネットワーク致命的のイベント(NNM)

致命的

ネットワーク致命的のイベント(NNM)※1

イベントID（B.ID）

00003A80

SNMP Object ID（E.SNMP_OID）

〜.58916868※2

イベント発生ノード名（E.SNMP_VARBIND2）

基本情報のホスト名

ネットワーク警告のイベント(NNM)

警告

ネットワーク警告のイベント(NNM)※1

イベントID（B.ID）

00003A80

SNMP Object ID（E.SNMP_OID）

〜.(40000083|40000084|40000085|50790400|58916865)※2

イベント発生ノード名（E.SNMP_VARBIND2）

基本情報のホスト名

注※1　共通条件（各監視オブジェクトで共通に使われる条件）です。

注※2　「〜」には，「.iso.org.dod.internet.private.enterprises.hp.nm.openView.hpOpenView.0」が入ります。

8.10　JP1/IM - Manager用システム監視オブジェクト

JP1/IM - Manager用のシステム監視オブジェクトには，「IM監視」があります。

8.10.1　「IM監視」システム監視オブジェクト

表8‒30　システム監視オブジェクトの概要

項目

説明

監視ノード種別

IM監視

目的

JP1/IM - Manager自体の障害の監視

基本情報

ホスト名

JP1/IM - Managerがインストールされているマネージャーのホスト名

（例）host01

表8‒31　状態変更条件

状態変更条件

共通条件※，個別条件

条件名

状態

条件

比較する値

システム警告のイベント(IM)

警告

システム警告のイベント(IM)※

イベントID（B.ID）

000020E6，000020E7，00003F91

発行元イベントサーバ名（B.SOURCESERVER）

基本情報のホスト名

システムエラーのイベント(IM)

エラー

システムエラーのイベント(IM)※

イベントID（B.ID）

00002010，00002011，00002012，00002020，00002021，000020A0，000020E2，000020E5，000020E8，00003F90

発行元イベントサーバ名（B.SOURCESERVER）

基本情報のホスト名

注※　共通条件（各監視オブジェクトで共通に使われる条件）です。

8.11　Cosminexus用システム監視オブジェクト

Cosminexus用のシステム監視オブジェクトには，「論理サーバ監視(Cosminexus)」および「J2EEアプリケーション監視(Cosminexus)」があります。

8.11.1　「論理サーバ監視(Cosminexus)」システム監視オブジェクト

表8‒32　システム監視オブジェクトの概要

項目

説明

監視ノード種別

論理サーバ監視(Cosminexus)

目的

サーバレベルの障害に関するJP1イベントの監視※

基本情報

ドメイン名

Cosminexusサーバのドメイン名

（例）DOM001

論理ホスト名

Cosminexusが監視対象としている論理ホスト名

（例）APSV001

注※　重大度が「Warning」以上のJP1イベントを監視します。

表8‒33　状態変更条件

状態変更条件

共通条件※，個別条件

条件名

状態

条件

比較する値

論理サーバ緊急のイベント(Cosminexus)

緊急

論理サーバ緊急のイベント(Cosminexus)※

イベントID

（B.ID）

00012000，00012080

ドメイン名（E.DOMAIN_NAME）

基本情報のドメイン名

論理サーバ名（E.LOGICAL_SERVER_NAME）

基本情報の論理ホスト名

論理サーバ警戒のイベント(Cosminexus)

警戒

論理サーバ警戒のイベント(Cosminexus)※

イベントID

（B.ID）

00012001，00012081

ドメイン名（E.DOMAIN_NAME）

基本情報のドメイン名

論理サーバ名（E.LOGICAL_SERVER_NAME）

基本情報の論理ホスト名

論理サーバ致命的のイベント(Cosminexus)

致命的

論理サーバ致命的のイベント(Cosminexus)※

イベントID

（B.ID）

00012002，00012082

ドメイン名（E.DOMAIN_NAME）

基本情報のドメイン名

論理サーバ名（E.LOGICAL_SERVER_NAME）

基本情報の論理ホスト名

論理サーバエラーのイベント(Cosminexus)

エラー

論理サーバエラーのイベント(Cosminexus)※

イベントID

（B.ID）

00012003，00012083

ドメイン名（E.DOMAIN_NAME）

基本情報のドメイン名

論理サーバ名（E.LOGICAL_SERVER_NAME）

基本情報の論理ホスト名

論理サーバ警告のイベント(Cosminexus)

警告

論理サーバ警告のイベント(Cosminexus)※

イベントID

（B.ID）

00012004，00012084

ドメイン名（E.DOMAIN_NAME）

基本情報のドメイン名

論理サーバ名（E.LOGICAL_SERVER_NAME）

基本情報の論理ホスト名

注※　共通条件（各監視オブジェクトで共通に使われる条件）です。

8.11.2　「J2EEアプリケーション監視(Cosminexus)」システム監視オブジェクト

表8‒34　システム監視オブジェクトの概要

項目

説明

監視ノード種別

J2EEアプリケーション監視(Cosminexus)

目的

アプリケーションレベルの障害に関するJP1イベントの監視※

基本情報

ドメイン名

Cosminexusサーバのドメイン名

（例）DOM001

論理ホスト名

Cosminexusが監視対象としている論理ホスト名

（例）APSV001

J2EEアプリケーション名

Cosminexusが監視対象としている論理ホスト上のJ2EEアプリケーション名

（例）API

注※　重大度が「Warning」以上のJP1イベントを監視します。

表8‒35　状態変更条件

状態変更条件

共通条件※，個別条件

条件名

状態

条件

比較する値

J2EEアプリケーション緊急のイベント(Cosminexus)

緊急

J2EEアプリケーション緊急のイベント(Cosminexus)※

イベントID

（B.ID）

00012090，000120D0

ドメイン名（E.DOMAIN_NAME）

基本情報のドメイン名

論理サーバ名（E.LOGICAL_SERVER_NAME）

基本情報の論理ホスト名

J2EEアプリケーション名

（E.APPLICATION_NAME）

基本情報のJ2EEアプリケーション名

J2EEアプリケーション警戒のイベント(Cosminexus)

警戒

J2EEアプリケーション警戒のイベント(Cosminexus)※

イベントID

（B.ID）

00012091，000120D1

ドメイン名（E.DOMAIN_NAME）

基本情報のドメイン名

論理サーバ名（E.LOGICAL_SERVER_NAME）

基本情報の論理ホスト名

J2EEアプリケーション名

（E.APPLICATION_NAME）

基本情報のJ2EEアプリケーション名

J2EEアプリケーション致命的のイベント(Cosminexus)

致命的

J2EEアプリケーション致命的のイベント(Cosminexus)※

イベントID

（B.ID）

00012092，000120D2

ドメイン名（E.DOMAIN_NAME）

基本情報のドメイン名

論理サーバ名（E.LOGICAL_SERVER_NAME）

基本情報の論理ホスト名

J2EEアプリケーション名

（E.APPLICATION_NAME）

基本情報のJ2EEアプリケーション名

J2EEアプリケーションエラーのイベント(Cosminexus)

エラー

J2EEアプリケーションエラーのイベント(Cosminexus)※

イベントID

（B.ID）

00012093，000120D3

ドメイン名（E.DOMAIN_NAME）

基本情報のドメイン名

論理サーバ名（E.LOGICAL_SERVER_NAME）

基本情報の論理ホスト名

J2EEアプリケーション名

（E.APPLICATION_NAME）

基本情報のJ2EEアプリケーション名

J2EEアプリケーション警告のイベント(Cosminexus)

警告

J2EEアプリケーション警告のイベント(Cosminexus)※

イベントID

（B.ID）

00012094，000120D4

ドメイン名（E.DOMAIN_NAME）

基本情報のドメイン名

論理サーバ名（E.LOGICAL_SERVER_NAME）

基本情報の論理ホスト名

J2EEアプリケーション名

（E.APPLICATION_NAME）

基本情報のJ2EEアプリケーション名

注※　共通条件（各監視オブジェクトで共通に使われる条件）です。

8.12　HiRDB用システム監視オブジェクト

HiRDB用システム監視オブジェクトには，「HiRDB監視」があります。

8.12.1　HiRDB用システム監視オブジェクトを監視する場合の設定について

HiRDB用システム監視オブジェクトを監視する場合に必要な設定について説明します。次の事項を設定する必要があります。

HiRDBに関する事象を管理するには，HiRDBが管理する障害情報をJP1イベントとして発行するよう設定が必要です。これは，デフォルトではJP1イベントを発行しない設定になっているためです。

8.12.2　「HiRDB監視」システム監視オブジェクト

表8‒36　システム監視オブジェクトの概要

項目

説明

監視ノード種別

HiRDB監視

目的

HiRDB自身の障害監視

基本情報

ホスト名

HiRDBがインストールされているホストのホスト名

（例）host02

HiRDB識別子

HiRDBを識別するための識別子

（例）PDB1

表8‒37　状態変更条件

状態変更条件

共通条件※，個別条件

条件名

状態

条件

比較する値

HiRDB緊急のイベント

緊急

HiRDB緊急のイベント※

プロダクト名（E.PRODUCT_NAME）

/HITACHI/HiRDB

重大度（E.SEVERITY）

Emergency

発行元イベントサーバ名（B.SOURCESERVER）

基本情報のホスト名

登録名（E.ROOT_OBJECT_NAME）

基本情報のHiRDB識別子

HiRDB警戒のイベント

警戒

HiRDB警戒のイベント※

プロダクト名（E.PRODUCT_NAME）

/HITACHI/HiRDB

重大度（E.SEVERITY）

Alert

発行元イベントサーバ名（B.SOURCESERVER）

基本情報のホスト名

登録名（E.ROOT_OBJECT_NAME）

基本情報のHiRDB識別子

HiRDB致命的のイベント

致命的

HiRDB致命的のイベント※

プロダクト名（E.PRODUCT_NAME）

/HITACHI/HiRDB

重大度（E.SEVERITY）

Critical

発行元イベントサーバ名（B.SOURCESERVER）

基本情報のホスト名

登録名（E.ROOT_OBJECT_NAME）

基本情報のHiRDB識別子

HiRDBエラーのイベント

エラー

HiRDBエラーのイベント※

プロダクト名（E.PRODUCT_NAME）

/HITACHI/HiRDB

重大度（E.SEVERITY）

Error

発行元イベントサーバ名（B.SOURCESERVER）

基本情報のホスト名

登録名（E.ROOT_OBJECT_NAME）

基本情報のHiRDB識別子

HiRDB警告のイベント

警告

HiRDB警告のイベント※

プロダクト名（E.PRODUCT_NAME）

/HITACHI/HiRDB

重大度（E.SEVERITY）

Warning

発行元イベントサーバ名（B.SOURCESERVER）

基本情報のホスト名

登録名（E.ROOT_OBJECT_NAME）

基本情報のHiRDB識別子

注※　共通条件（各監視オブジェクトで共通に使われる条件）です。

8.13　JP1/ServerConductor用システム監視オブジェクト

JP1/ServerConductor用システム監視オブジェクトには，「物理ホスト監視（System Manager）」があります。

8.13.1　JP1/ServerConductor用システム監視オブジェクトを監視する場合の設定について

JP1/ServerConductor用システム監視オブジェクトを監視する場合に必要な設定について説明します。次の事項を設定する必要があります。

JP1/ServerConductorが管理する物理ホストに関する事象を管理するには，JP1/ServerConductorのマネージャーサービスが検知したアラートをJP1イベントとして発行するよう設定が必要です。これは，デフォルトではJP1イベントを発行しない設定になっているためです。

8.13.2　「物理ホスト監視（System Manager）」システム監視オブジェクト

表8‒38　システム監視オブジェクトの概要

項目

説明

監視ノード種別

物理ホスト監視（System Manager）

目的

JP1/ServerConductorが管理する物理ホストに関する障害監視

基本情報

ホスト名

System Managerが管理する物理ホスト名

（例）host02

表8‒39　状態変更条件

状態変更条件

共通条件※，個別条件

条件名

状態

条件

比較する値

物理ホスト緊急のイベント

緊急

物理ホスト緊急のイベント※

プロダクト名（E.PRODUCT_NAME）

/HITACHI/SYSTEM_MANAGER

重大度（E.SEVERITY）

Emergency

JP1/ServerConductorが管理する物理ホスト名（E.HSM_SERVER）

基本情報のホスト名

物理ホスト警戒のイベント

警戒

物理ホスト警戒のイベント※

プロダクト名（E.PRODUCT_NAME）

/HITACHI/SYSTEM_MANAGER

重大度（E.SEVERITY）

Alert

JP1/ServerConductorが管理する物理ホスト名（E.HSM_SERVER）

基本情報のホスト名

物理ホスト致命的のイベント

致命的

物理ホスト致命的のイベント※

プロダクト名（E.PRODUCT_NAME）

/HITACHI/SYSTEM_MANAGER

重大度（E.SEVERITY）

Critical

JP1/ServerConductorが管理する物理ホスト名（E.HSM_SERVER）

基本情報のホスト名

物理ホストエラーのイベント

エラー

物理ホストエラーのイベント※

プロダクト名（E.PRODUCT_NAME）

/HITACHI/SYSTEM_MANAGER

重大度（E.SEVERITY）

Error

JP1/ServerConductorが管理する物理ホスト名（E.HSM_SERVER）

基本情報のホスト名

物理ホスト警告のイベント

警告

物理ホスト警告のイベント※

プロダクト名（E.PRODUCT_NAME）

/HITACHI/SYSTEM_MANAGER

重大度（E.SEVERITY）

Warning

JP1/ServerConductorが管理する物理ホスト名（E.HSM_SERVER）

基本情報のホスト名

注※　共通条件（各監視オブジェクトで共通に使われる条件）です。

9　監視ツリーモデル（セントラルスコープ用）

この章では，監視ツリーを自動生成するときに作成される監視ツリーの構造について説明します。

9.1　監視ツリーを自動生成するときのテンプレートについて

監視ツリーを自動生成するときに作成される監視ツリーの構造は，［自動生成-構成選択］画面で選択するテンプレートによって異なります。セントラルコンソールが用意しているテンプレートを次に示します。

「業務指向ツリー」テンプレート

「サーバ指向ツリー」テンプレート

テンプレートごとに監視ツリーのモデルが定義されています。監視ツリーを自動生成する場合，各ホストから収集した定義を，監視ツリーモデルに合わせて自動的に監視ツリーを生成します。

9.2　「業務指向ツリー」の監視ツリーモデル

監視ツリーを自動生成するときに，「業務指向ツリー」テンプレートを選択した場合に生成される監視ツリーのモデルを次に示します。

「業務指向ツリー」テンプレートを選択した場合に生成される監視ツリーのモデル

図9‒1　監視ツリー（業務指向ツリー）のモデル

図9‒2　監視ツリー（業務指向ツリー）のモデル

9.3　「サーバ指向ツリー」の監視ツリーモデル

監視ツリーを自動生成するときに，「サーバ指向ツリー」テンプレートを選択した場合に生成される監視ツリーのモデルを次に示します。

「サーバ指向ツリー」テンプレートを選択した場合に生成される監視ツリーのモデル

図9‒3　監視ツリー（サーバ指向ツリー）のモデル

図9‒4　監視ツリー（サーバ指向ツリー）のモデル

索引

記号

__configurationGetAdapterlessメソッド[1]

__configurationGetメソッド[1]

__createLinkメソッド[1]

__createTreeNodeメソッド[1]

__eventGetメソッド[1]

__linkValueGetメソッド[1]

__metricListGetメソッド[1]

__simtLoadメソッド[1]

__timeSeriesDataGetメソッド[1]

__transformEventメソッド[1]

__urlGetメソッド[1]

!JP1_CS_APP0.conf（起動プログラム定義ファイル）[1]

!JP1_CS_FTOOL0.conf（ツールバー定義ファイル）[1]

!JP1_CS_FTREE0.conf（アイコン動作定義ファイル）[1]

.system（システムプロファイル）[1]

A

actdef.conf（自動アクション定義ファイル）[1]

actdef.conf（自動アクション定義ファイル）（互換用）[1]

action_complete_xxx.conf（対処済み連動設定ファイル）[1]

action.conf.update（自動アクション環境定義ファイル）[1]

actnotice.conf（自動アクション通知定義ファイル）[1]

Alertmanager設定ファイル（jpc_alertmanager.yml）[1]

Alertmanagerのサイレンス一覧取得[1]

Alertmanagerのサイレンス作成[1]

Alertmanagerのサイレンス失効[1]

Alertmanagerの操作関連のAPI[1]

Alertmanagerのヘルスチェック[1]

Alertmanagerのリロード[1]

API[1]

Alertmanagerの操作関連[1]

Basic認証[1]

Blackbox exporterの操作関連[1]

IM管理ノード関連情報の生成[1]

IM管理ノード関連情報の反映[1]

IM管理ノード情報取得[1]

IM管理ノードステータス取得[1]

IMクライアントシークレット一覧取得[1]

IMクライアントシークレット削除[1]

IMクライアントシークレット発行[1]

JP1/IM - Agentが使用するExporterのスクレイプ[1]

OpenID認証[1]、[2]

Prometheus serverの操作関連[1]

REST APIの認証方法[1]

URL情報取得[1]

イベント管理[1]

イベント検索[1]

イベント詳細情報取得[1]

イベント対処状況変更[1]

イベント発行[1]

構成管理ツリー情報取得[1]

時系列データ取得[1]

システムのステータス監視[1]

自動／手動対処アクションの実行[1]

情報管理[1]

初期シークレット発行[1]

通信方式[1]

提案[1]

データ型[1]

トレンド[1]

入出力形式[1]

バージョン情報取得[1]

配布[1]

プラグイン[1]

プラグイン処理実行[1]

プロキシ[1]

プロキシ認証情報設定[1]

メトリック一覧取得[1]

ユーザー認証[1]

リンク種別一覧取得[1]

リンク情報[1]

リンク情報取得[1]

連携製品[1]

ログアウト[1]

ログイン[1]

API一覧[1]

API共通の仕様[1]

attr_list.conf（イベント条件表示項目定義ファイル）[1]

auto_dbbackup_xxx.conf（監視オブジェクトDBの自動バックアップ・リカバリー設定ファイル）[1]

AWS定義ファイル（aws_settings.conf）[1]

B

Basic認証[1]

Blackbox exporter（HTTP/HTTPS監視）のディスカバリ設定ファイル（jpc_file_sd_config_blackbox_http.yml）[1]

Blackbox exporter（ICMP監視）のディスカバリ設定ファイル（jpc_file_sd_config_blackbox_icmp.yml）[1]

Blackbox exporter設定ファイル（jpc_blackbox_exporter.yml）[1]

Blackbox exporterの操作関連のAPI[1]

Blackbox exporterのメトリック定義ファイル（metrics_blackbox_exporter.conf）[1]

Blackbox exporterのリロード[1]

C

chmsg_attr_list.conf（表示メッセージ変更定義表示項目定義ファイル）[1]

chmsg_auto_list.conf（表示メッセージ変更定義自動入力定義ファイル）[1]

chmsgevent.conf（表示メッセージ変更後イベント環境定義ファイル）[1]

chsev_attr_list.conf（重大度変更定義表示項目定義ファイル）[1]

chsev_auto_list.conf（重大度変更定義自動入力定義ファイル）[1]

COMMANDセクション[1]、[2]

common_exclude_filter_attr_list.conf（共通除外条件表示項目定義ファイル）[1]

CONNECTセクション[1]、[2]

console.conf.update（通信環境定義ファイル）[1]

CustomContent.initialize[1]

CustomContent.node[1]

CustomContent.options.props[1]

CustomContent.postActions[1]

CustomContent.selectNodeByTargetSid[1]

CustomContent.selectNodeByTreeSid[1]

CustomContent.showMessage[1]

CustomContent.simt[1]

D

defaultUser（ユーザープロファイル）[1]

E

egs_system.conf（相関イベント発行システムプロファイル）[1]

event_info_replace.conf（イベント引き継ぎ情報変換設定ファイル）[1]

event_storm_attr_list.conf（繰り返しイベント条件表示項目定義ファイル）[1]

event_storm_auto_list.conf（繰り返しイベント条件自動入力定義ファイル）[1]

evhist_warn_event_xxx.conf（状態変更イベント件数の上限監視設定ファイル）[1]

evtreport.conf（イベントレポート出力環境定義ファイル）[1]

EXTRACTFILEセクション[1]、[2]

F

Fluentdのメトリック定義ファイル（metrics_fluentd.conf）[1]

FORMATセクション[1]、[2]

H

hitachi_jp1_製品名.html（WWWページ呼び出し定義ファイル）[1]

host_collect_data.csv（ホスト収集情報ファイル）[1]

host_input_data.csv（ホスト入力情報ファイル）[1]

I

imagentaction設定ファイル（jpc_imagentaction.json）[1]

imagentproxy設定ファイル（jpc_imagentproxy.json）[1]

imagent共通設定ファイル（jpc_imagentcommon.json）[1]

imagent設定ファイル（jpc_imagent.json）[1]

imbaseproxy設定ファイル（jpc_imbaseproxy.json）[1]

imbase共通設定ファイル（jpc_imbasecommon.json）[1]

imbase設定ファイル（jpc_imbase.json）[1]

imdd_category_name.conf（IM管理ノードカテゴリ名称定義ファイル）[1]

imdd_host_name.conf（ホスト名定義ファイル）[1]

imdd_nodeLink_def.conf（IM管理ノードリンク定義ファイル）[1]

imdd_systemnode.conf（システムノード定義ファイル）[1]

imdd_target_host.conf（構成取得対象ホスト定義ファイル）[1]

imdd.properties（インテリジェント統合管理基盤定義ファイル）[1]

IM-View設定ファイル（tuning.conf）[1]

IM管理ノードカテゴリ名称定義ファイル（imdd_category_name.conf）[1]

IM管理ノードツリー生成機能[1]

IM管理ノードリンク定義ファイル（imdd_nodeLink_def.conf）[1]

IM構成管理・ビューアー動作定義ファイル（jcfview.conf）[1]

IM構成反映方式設定ファイル（jp1cf_applyconfig.conf）[1]

IMパラメーター定義ファイル（jp1co_param_V7.conf）[1]

incident_info.conf（インシデント引き継ぎ情報設定ファイル）[1]

incident.conf（インシデント手動登録定義ファイル）[1]

J

jcacancel[1]

jcachange[1]

jcadefconv[1]

jcamakea[1]

jcashowa[1]

jcastatus[1]

jcfaleltdef（Windows限定）[1]

jcfaleltreload（Windows限定）[1]

jcfaleltstart（Windows限定）[1]

jcfaleltstat（Windows限定）[1]

jcfaleltstop（Windows限定）[1]

jcfallogdef[1]

jcfallogreload[1]

jcfallogstart[1]

jcfallogstat[1]

jcfallogstop[1]

jcfcolvmesx[1]

jcfcolvmhcsm[1]

jcfcolvmkvm[1]

jcfcolvmscvmm（Windows限定）[1]

jcfcolvmvc[1]

jcfcolvmvirtage[1]

jcfdbsetup[1]

jcfdbunsetup[1]

jcfexport[1]

jcfimport[1]

jcfmkcsdata[1]

jcfmkhostsdata[1]

jcfthreaddmp（Windows限定）[1]

jcfview.conf（IM構成管理・ビューアー動作定義ファイル）[1]

jcfview（Windows限定）[1]

jcfvirtualchstat[1]

jco_guide.txt（イベントガイド情報ファイル）[1]

jco_killall.cluster（UNIX限定）[1]

jco_spmd_reload[1]

jco_spmd_status[1]

jco_start.cluster（UNIX限定）[1]

jco_start（UNIX限定）[1]

jco_stop.cluster（UNIX限定）[1]

jco_stop（UNIX限定）[1]

jcoappexecfcheck（Windows限定）[1]

jcoattrfcheck[1]

jcochafmode（UNIX限定）[1]

jcochcefmode[1]

jcochfilter[1]

jcochstat[1]

jcodbsetup[1]

jcodbunsetup[1]

jcoegschange[1]

jcoegscheck[1]

jcoegsstart[1]

jcoegsstatus[1]

jcoegsstop[1]

jcoevtreport[1]

jcofuncfcheck（Windows限定）[1]

jcogencore[1]

jcohc.conf（ヘルスチェック定義ファイル）[1]

jcohctest[1]

jcoimdef[1]

jcomonitorfcheck[1]

jcothreaddmp（Windows限定）[1]

jcovcfsetup（Windows限定）[1]

jcoview_log.bat（Windows限定）[1]

jcoview（Windows限定）[1]

jcs_guide_xxx.txt（ガイド情報ファイル）[1]

jcs_hosts（ホスト情報ファイル）[1]

jcs_sysprofile_xxx.def（システムプロファイル（セントラルスコープ））[1]

jcschstat[1]

jcsdbexport[1]

jcsdbimport[1]

jcsdbsetup[1]

jcshostsexport[1]

jcshostsimport[1]

jddcreatetree[1]

jddsetaccessuser[1]

jddsetopinfo[1]

jddsetproxyuser[1]

jddupdateaction[1]

jddupdatessomap[1]

jddupdatesuggestion[1]

jddupdatetree[1]

jim_log.bat（Windows限定）[1]

jim_log.sh（UNIX限定）[1]

jimasecret[1]

jimasetup[1]

jimdbbackup[1]

jimdbclustersetupinfo.conf（クラスタセットアップ情報ファイル）[1]

jimdbreclaim[1]

jimdbrecovery[1]

jimdbrorg[1]

jimdbsetupinfo.conf（セットアップ情報ファイル）[1]

jimdbstatus[1]

jimdbstop[1]

jimdbupdate[1]

jimgndbbackup[1]

jimgndbclustersetupinfo.conf（クラスタ環境インテリジェント統合管理データベースセットアップ情報ファイル）[1]

jimgndbrestore[1]

jimgndbsetup[1]

jimgndbsetupinfo.conf（インテリジェント統合管理データベースセットアップ情報ファイル）[1]

jimgndbstatus[1]

jimgndbstop[1]

jimgndbunsetup[1]

jimmail（Windows限定）[1]

jimmailpasswd（Windows限定）[1]

JP1/AJS用システム監視オブジェクト[1]

JP1/Cm2/NNM用システム監視オブジェクト[1]

JP1/Cm2/SSO用システム監視オブジェクト[1]

JP1/IM - Managerの管理ノード数

カウントする[1]

JP1/IMが出力するJP1イベント[1]

JP1/IM - Agentが使用するExporterのスクレイプ用のAPI[1]

JP1/IM - Agentが発行するJP1イベント

一覧[1]

JP1/IM - Managerが出力するJP1イベント

一覧[1]

詳細[1]

JP1/NNMi用システム監視オブジェクト[1]

jp1cc_setup_cluster（UNIX限定）[1]

jp1cc_setup（UNIX限定）[1]

jp1cf_applyconfig.conf（IM構成反映方式設定ファイル）[1]

jp1cf_setup_cluster（UNIX限定）[1]

jp1cf_setup（UNIX限定）[1]

jp1cfhasetup（Windows限定）[1]

jp1co_param_V7.conf（IMパラメーター定義ファイル）[1]

jp1co_service.conf（拡張起動プロセス定義ファイル）[1]

jp1cohasetup（Windows限定）[1]

jp1cohaverup[1]

jp1cs_setup_cluster（UNIX限定）[1]

jp1cs_setup（UNIX限定）[1]

jp1cshasetup（Windows限定）[1]

jp1cshaverup.bat（Windows限定）[1]

jp1cshaverup（UNIX限定）[1]

jp1csverup.bat（Windows限定）[1]

jp1csverup（UNIX限定）[1]

jp1EmService.changeEventStatus[1]

jp1EmService.getEvent[1]

jp1Imdd.callRest[1]

jp1Imdd.encodeBase64[1]

jp1Imdd.execCmd[1]

jp1Imdd.getPluginConfDirPath[1]

jp1Imdd.getVersion[1]

jp1Imdd.readFile[1]

jp1Logger.trace[1]

jp1SimtService.get[1]

jp1SimtService.getLink[1]

jp1SimtService.getTreeSid[1]

jp1SimtService.join[1]

jp1SimtService.pack[1]

jp1SimtService.packHost[1]

jp1SimtService.parse[1]

jp1TrendDataService.getLabelList[1]

jp1TrendDataService.getTrendData[1]

JP1イベント[1]

属性[1]

JP1イベント変換[1]

jpc_service[1]

jpc_service_autostart[1]

jpc_service_start[1]

jpc_service_stop[1]

jpc_stop_node_exporter_aix（AIX限定）[1]

jr3alget[1]

jr3algetコマンドの環境パラメーター設定ファイル（jr3alget.ini）[1]

jr3algetコマンドの環境パラメーター設定ファイルのサンプルファイル（jr3alget.ini.sample）[1]

jr3slget[1]

jr3slgetコマンドの環境パラメーター設定ファイル（jr3slget.ini）[1]

jr3slgetコマンドの環境パラメーター設定ファイルのサンプルファイル（jr3slget.ini.sample）[1]

JSON

IM管理ノード[1]

IM管理ノードオブジェクト[1]

IM管理ノードリンクマスターオブジェクト[1]

イベント[1]

イベント検索条件オブジェクト[1]

イベント情報オブジェクト[1]

イベントを発行した連携製品のモニター画面呼び出し情報オブジェクト[1]

対処アクションの自動実行[1]

統合エージェント管理[1]

トレンドデータ管理[1]

jsonオブジェクト[1]

N

Node exporter（サービス監視）のメトリック定義ファイル（metrics_node_exporter_service.conf）[1]

Node exporter for AIXのディスカバリ設定ファイル（jpc_file_sd_config_node_aix.yml）[1]

Node exporter for AIXのメトリック定義ファイル（metrics_node_exporter_aix.conf）[1]

Node exporterのディスカバリ設定ファイル（jpc_file_sd_config_node.yml）[1]

Node exporterのメトリック定義ファイル（metrics_node_exporter.conf）[1]

nosslhost.conf(非暗号化通信ホスト設定ファイル）[1]

O

OpenID認証のAPI[1]

Optionセクション[1]、[2]

OracleDB exporterのディスカバリ設定ファイル（jpc_file_sd_config_oracledb.yml）[1]

OracleDB exporterのデフォルトの収集メトリック定義ファイル（default-metrics.toml）[1]

OracleDB exporterのメトリック定義ファイル（metrics_oracledb_exporter.conf）[1]

P

postgresql.conf（インテリジェント統合管理データベースの設定ファイル）[1]

Process exporter設定ファイル（jpc_process_exporter.yml）[1]

Process exporterのディスカバリ設定ファイル（jpc_file_sd_config_process.yml）[1]

Process exporterのメトリック定義ファイル（metrics_process_exporter.conf）[1]

processupdate.conf（対処状況イベント定義ファイル）[1]

profile_ユーザー名（ユーザープロファイル）[1]

Prometheus serverの操作関連のAPI[1]

Prometheus serverのヘルスチェック[1]

Prometheus serverのリロード[1]

Prometheus設定ファイル（jpc_prometheus_server.yml）[1]

Promitor Resource Discovery runtime設定ファイル（runtime.yaml）[1]

Promitor Resource Discovery設定ファイル（resource-discovery-declaration.yaml）[1]

Promitor Scraper runtime設定ファイル（runtime.yaml）[1]

Promitor Scraper設定ファイル（metrics-declaration.yaml）[1]

Promitorのディスカバリ設定ファイル（jpc_file_sd_config_promitor.yml）[1]

Promitorのメトリック定義ファイル（metrics_promitor.conf）[1]

PromQL文に関する注意事項[1]

promtool[1]

S

SAPシステム監視のScript exporter設定ファイルのサンプルファイル（jpc_script_exporter_sap.yml）[1]

SAPシステムのCCMSアラート情報監視定義ファイルのサンプルファイル（fluentd_sap_alertlog_tail.conf）[1]

SAPシステムのシステムログ情報監視定義ファイルのサンプルファイル（fluentd_sap_syslog_tail.conf）[1]

SAPシステムのタイムゾーンの注意事項[1]

Script exporter設定ファイル（jpc_script_exporter.yml）[1]

Script exporterのディスカバリ設定ファイル（jpc_file_sd_config_script.yml）[1]

Script exporterのメトリック定義ファイル（metrics_script_exporter.conf）[1]

SID[1]

JP1/AJSから取得する情報[1]

JP1/IMまたはJP1/Baseから取得する情報[1]

JP1/PFMから取得する情報[1]

JP1イベントのSID[1]

各製品から取得する情報[1]

構成情報のSID[1]

ツリーのSID[1]

SpmSetSvcCon（Windows限定）[1]

system.conf（システムプロファイル（セントラルスコープ・ビューアー））[1]

systemColor.conf（システムカラー定義ファイル）[1]

T

TARGETセクション[1]、[2]

TRACEセクション[1]、[2]

tree_view.conf.update（通信環境定義ファイル）[1]

tuning.conf（IM-View設定ファイル）[1]

U

user_hostmap.conf（発生元ホストマッピング定義ファイル）[1]

V

view.conf.update（通信環境定義ファイル）[1]

W

Windows exporter（サービス監視）のメトリック定義ファイル（metrics_windows_exporter_service.conf）[1]

Windows exporter（プロセス監視）のメトリック定義ファイル（metrics_windows_exporter_process.conf）[1]

Windows exporter設定ファイル（jpc_windows_exporter.yml）[1]

Windows exporterのディスカバリ設定ファイル（jpc_file_sd_config_windows.yml）[1]

Windows exporterのメトリック定義ファイル（metrics_windows_exporter.conf）[1]

Windowsイベントログの監視定義ファイル（fluentd_@@trapname@@_wevt.conf.template）[1]

WWWページ呼び出し定義ファイル（hitachi_jp1_製品名.html）[1]

Y

Yet another cloudwatch exporter設定ファイル（jpc_ya_cloudwatch_exporter.yml）[1]

Yet another cloudwatch exporterのディスカバリ設定ファイル（jpc_file_sd_config_cloudwatch.yml）[1]

Yet another cloudwatch exporterのメトリック定義ファイル（metrics_ya_cloudwatch_exporter.conf）[1]

ymlファイルの記述項目で使用している一般的なプレースホルダーの定義について[1]

あ

アイコン動作定義ファイル（!JP1_CS_FTREE0.conf）[1]

アクション情報ファイルの容量を小さくする場合[1]

アダプタコマンド設定ファイル[1]

アダプタコマンドの設定[1]

アダプタコマンドのセットアップ[1]

アプリケーション実行定義ファイル[1]

チェックする[1]

置換文字列[1]

アラート設定ファイル（jpc_alerting_rules.yml）[1]

い

一次資料

JP1/IM - Manager用（UNIX）[1]

JP1/IM - View，JP1/IM - Manager用（Windows）[1]

イベントID

00002010の詳細[1]

00002011の詳細[1]

00002012の詳細[1]

00002013の詳細[1]

00002014の詳細[1]

00002015の詳細[1]

00002016の詳細[1]

00002020の詳細[1]

00002021の詳細[1]

000020A0の詳細[1]

000020A1の詳細[1]

000020A2の詳細[1]

000020A3の詳細[1]

000020A4の詳細[1]

000020A5の詳細[1]

000020A6の詳細[1]

000020E0の詳細[1]

000020E1の詳細[1]

000020E2の詳細[1]

000020E3の詳細[1]

000020E4の詳細[1]

000020E5の詳細[1]

000020E6の詳細[1]

000020E7の詳細[1]

000020E8の詳細[1]

00003A71の詳細[1]

00003A71またはリモート監視イベントログトラップ動作定義ファイルのfilterブロックに指定されたイベントIDの詳細[1]

00003F01の詳細[1]

00003F02の詳細[1]

00003F03の詳細[1]

00003F04の詳細[1]

00003F05の詳細[1]

00003F06の詳細[1]

00003F07の詳細[1]

00003F08の詳細[1]

00003F11の詳細[1]

00003F13の詳細[1]

00003F15の詳細[1]

00003F16の詳細[1]

00003F17の詳細[1]

00003F20の詳細[1]

00003F21の詳細[1]

00003F22の詳細[1]

00003F23の詳細[1]

00003F25の詳細[1]

00003F26の詳細[1]

00003F28の詳細[1]

00003F31の詳細[1]

00003F41の詳細[1]

00003F42の詳細[1]

00003F51の詳細[1]

00003F52の詳細[1]

00003F53の詳細[1]

00003F54の詳細[1]

00003F56の詳細[1]

00003F57の詳細[1]

00003F58の詳細[1]

00003F59の詳細[1]

00003F60の詳細[1]

00003F61の詳細[1]

00003F63の詳細[1]

00003F64の詳細[1]

00003F65の詳細[1]

00003F68の詳細[1]

00003F69の詳細[1]

00003F6Aの詳細[1]

00003F71の詳細[1]

00003F76の詳細[1]

00003F77の詳細[1]

00003F78の詳細[1]

00003F7Cの詳細[1]

00003F80の詳細[1]

00003F81の詳細[1]

00003F82の詳細[1]

00003F83の詳細[1]

00003F90の詳細[1]

00003F91の詳細[1]

00003F92の詳細[1]

00003FB0の詳細[1]

00003FB1の詳細[1]

00003FC0の詳細[1]

00003FC1の詳細[1]

00003FC2の詳細[1]

00003FC3の詳細[1]

00003FC5の詳細[1]

00003FC6の詳細[1]

00003FC9の詳細[1]

00003FC7の詳細[1]

00003FC8の詳細[1]

00003FD0の詳細[1]

00003FD1の詳細[1]

00003FD2の詳細[1]

00003FD3の詳細[1]

00003FD4の詳細[1]

00003FD5の詳細[1]

00003FD6の詳細[1]

00003FD7の詳細[1]

00003FD8の詳細[1]

00003FD9の詳細[1]

00003FDAの詳細[1]

00003FDBの詳細[1]

00003FDCの詳細[1]

00003FE0の詳細[1]

00003FE1の詳細[1]

00003FF0の詳細[1]

00003FF1の詳細[1]

00003FF2の詳細[1]

00003FF3の詳細[1]

00003FF4の詳細[1]

00003FF5の詳細[1]

00003FF6の詳細[1]

00003FF7の詳細[1]

00003FF8の詳細[1]

00003FF9の詳細[1]

00003FFAの詳細[1]

00003FFBの詳細[1]

00006400の詳細[1]

ACTDEFパラメーターに指定されている値[1]

相関イベント発行定義ファイルのFAIL_EVENTパラメーターに指定されたイベントIDの詳細[1]

相関イベント発行定義ファイルのSUCCESS_EVENTパラメーターに指定されたイベントIDの詳細[1]

リモート監視イベントログトラップ動作定義ファイルのfilterブロックに指定されたイベントIDの詳細[1]

イベントガイド情報ファイル（jco_guide.txt）[1]

イベント拡張属性定義ファイル[1]

チェックする[1]

イベント拡張属性定義ファイル（拡張ファイル）[1]

イベント監視条件の優先度[1]

イベント管理のAPI[1]

イベント条件表示項目定義ファイル（attr_list.conf）[1]

イベント引き継ぎ情報変換設定ファイル（event_info_replace.conf）[1]

イベントレポート出力環境定義ファイル（evtreport.conf）[1]

イベントレポート出力の項目ファイル[1]

イベントレポート出力のフィルターファイル[1]

インシデント手動登録定義ファイル（incident.conf）[1]

インシデント引き継ぎ情報設定ファイル（incident_info.conf）[1]

インテリジェント統合管理基盤定義ファイル（imdd.properties）[1]

インテリジェント統合管理基盤を使うための情報[1]

インテリジェント統合管理データベースの設定ファイル（postgresql.conf）[1]

インテリジェント統合管理データベースセットアップ情報ファイル（jimgndbsetupinfo.conf）[1]

お

オブジェクトタイプ定義ファイル[1]

か

ガイド情報ファイル（jcs_guide_xxx.txt）[1]

ガイドメッセージファイル[1]

外部管理インターフェースを使用するための権限（S_XMI_PROD）[1]、[2]

下位マネージャー情報一覧取得[1]

下位マネージャー情報管理のAPI[1]

下位マネージャー情報削除[1]

下位マネージャー情報登録[1]

拡張起動プロセス定義ファイル（jp1co_service.conf）[1]

拡張属性[1]

環境変数ファイル（任意のファイル名）[1]

監視オブジェクトDBの自動バックアップ・リカバリー設定ファイル（auto_dbbackup_xxx.conf）[1]

監視オブジェクト初期化設定ファイル[1]

監視ツリーモデル

業務指向ツリー[1]

サーバ指向ツリー[1]

監視ツリーモデル（セントラルスコープ用）[1]

管理対象からの情報取得[1]

REST APIでの情報取得[1]

アダプタコマンドでの情報取得[1]

管理対象の設定と検討[1]

SIDのvalue値の検討[1]

SIDの検討[1]

ホストを追加する[1]

き

キーワード置換文字列[1]

起動オプションの注意事項[1]

起動プログラム定義ファイル（!JP1_CS_APP0.conf）[1]

基本属性[1]

キャンセル処理中に実行先のホストが再起動した場合の処理[1]

共通除外条件拡張定義ファイル[1]

共通除外条件自動入力定義ファイル（common_exclude_filter_auto_list.conf）[1]

共通除外条件表示項目定義ファイル（common_exclude_filter_attr_list.conf）[1]

共通定義設定用ファイル（JP1イベントの属性変更）[1]

「業務指向ツリー」の監視ツリーモデル[1]

く

クラスタ環境インテリジェント統合管理データベースセットアップ情報ファイル（jimdbclustersetupinfo.conf）[1]

クラスタセットアップ情報ファイル（jimdbclustersetupinfo.conf）[1]

繰り返しイベント条件自動入力定義ファイル（event_storm_auto_list.conf）[1]

繰り返しイベント条件表示項目定義ファイル（event_storm_attr_list.conf）[1]

こ

構成取得対象ホスト定義ファイル（imdd_target_host.conf）[1]

コマンド[1]

IM構成管理に関するコマンド[1]

IM構成管理に関するコマンド（リモート監視構成）[1]

IMデータベース[1]

jcacancel[1]

jcachange[1]

jcadefconv[1]

jcamakea[1]

jcashowa[1]

jcastatus[1]

jcfaleltdef（Windows限定）[1]

jcfaleltreload（Windows限定）[1]

jcfaleltstart（Windows限定）[1]

jcfaleltstat（Windows限定）[1]

jcfaleltstop（Windows限定）[1]

jcfallogdef[1]

jcfallogreload[1]

jcfallogstart[1]

jcfallogstat[1]

jcfallogstop[1]

jcfcolvmesx[1]

jcfcolvmhcsm[1]

jcfcolvmkvm[1]

jcfcolvmscvmm（Windows限定）[1]

jcfcolvmvc[1]

jcfcolvmvirtage[1]

jcfdbsetup[1]

jcfdbunsetup[1]

jcfexport[1]

jcfimport[1]

jcfmkcsdata[1]

jcfmkhostsdata[1]

jcfthreaddmp（Windows限定）[1]

jcfview（Windows限定）[1]

jcfvirtualchstat[1]

jco_killall.cluster（UNIX限定）[1]

jco_spmd_reload[1]

jco_spmd_status[1]

jco_start.cluster（UNIX限定）[1]

jco_start（UNIX限定）[1]

jco_stop.cluster（UNIX限定）[1]

jco_stop（UNIX限定）[1]

jcoappexecfcheck（Windows限定）[1]

jcoattrfcheck[1]

jcochafmode（UNIX限定）[1]

jcochcefmode[1]

jcochfilter[1]

jcochstat[1]

jcodbsetup[1]

jcodbunsetup[1]

jcoegschange[1]

jcoegscheck[1]

jcoegsstart[1]

jcoegsstatus[1]

jcoegsstop[1]

jcoevtreport[1]

jcofuncfcheck（Windows限定）[1]

jcogencore[1]

jcohctest[1]

jcoimdef[1]

jcomonitorfcheck[1]

jcothreaddmp（Windows限定）[1]

jcovcfsetup（Windows限定）[1]

jcoview_log.bat（Windows限定）[1]

jcoview（Windows限定）[1]

jcschstat[1]

jcsdbexport[1]

jcsdbimport[1]

jcsdbsetup[1]

jcshostsexport[1]

jcshostsimport[1]

jddcreatetree[1]

jddsetaccessuser[1]

jddsetopinfo[1]

jddsetproxyuser[1]

jddupdateaction[1]

jddupdatessomap[1]

jddupdatesuggestion[1]

jddupdatetree[1]

jim_log.bat（Windows限定）[1]

jim_log.sh（UNIX限定）[1]

jimasecret[1]

jimasetup[1]

jimdbbackup[1]

jimdbreclaim[1]

jimdbrecovery[1]

jimdbrorg[1]

jimdbstatus[1]

jimdbstop[1]

jimdbupdate[1]

jimgndbbackup[1]

jimgndbrestore[1]

jimgndbsetup[1]

jimgndbstatus[1]

jimgndbstop[1]

jimgndbunsetup[1]

jimmail（Windows限定）[1]

jimmailpasswd（Windows限定）[1]

jimnodecount[1]

JP1/IM - Agent[1]

JP1/IM - Managerの管理ノード数をカウントする[1]

JP1/IM - Managerの定義ファイルのチェック[1]

JP1/IM - Viewの定義ファイルのチェック[1]

jp1cc_setup_cluster（UNIX限定）[1]

jp1cc_setup（UNIX限定）[1]

jp1cf_setup_cluster（UNIX限定）[1]

jp1cf_setup（UNIX限定）[1]

jp1cfhasetup（Windows限定）[1]

jp1cohasetup（Windows限定）[1]

jp1cohaverup[1]

jp1cs_setup_cluster（UNIX限定）[1]

jp1cs_setup（UNIX限定）[1]

jp1cshasetup（Windows限定）[1]

jp1cshaverup.bat（Windows限定）[1]

jp1cshaverup（UNIX限定）[1]

jp1csverup.bat（Windows限定）[1]

jp1csverup（UNIX限定）[1]

jpc_service[1]

jpc_service_autostart[1]

jpc_service_start[1]

jpc_service_stop[1]

jpc_stop_node_exporter_aix（AIX限定）[1]

jr3alget[1]

jr3slget[1]

promtool[1]

SAPシステム監視機能[1]

SpmSetSvcCon（Windows限定）[1]

一覧[1]

イベント[1]

インテリジェント統合管理基盤[1]

インテリジェント統合管理データベース[1]

監視オブジェクトDBの情報の移行[1]

監視ノードの状態変更[1]

起動・終了，セットアップ[1]

共通の注意事項[1]

構成定義[1]

自動アクションおよびコマンド実行[1]

セントラルスコープの環境設定[1]

相関イベントの発行[1]

トラブルシューティング[1]

バージョンアップ[1]

ビューの起動に関するコマンド[1]

フィルター[1]

メール通知機能[1]

コマンドの記述形式[1]

コマンドボタン定義ファイル（cmdbtn.conf）[1]

コンテナ監視のメトリック定義ファイル（metrics_kubernetes.conf）[1]

さ

「サーバ指向ツリー」の監視ツリーモデル[1]

サービス定義ファイル（jpc_プログラム名_service.xml）[1]

サイレンス取得[1]

サンプルプラグイン[1]

し

シークレットの一覧取得[1]

シークレットの追加，更新，削除[1]

システムカラー定義ファイル（systemColor.conf）[1]

システム監視オブジェクト

Cosminexus用[1]

HiRDB用[1]

JP1/IM - Manager用[1]

JP1/NETM/DM用[1]

JP1/PAM用[1]

JP1/PFM用[1]

JP1/ServerConductor用[1]

システム監視オブジェクト一覧（セントラルスコープ用）[1]

システム監視オブジェクト対応製品一覧[1]

システム監視オブジェクトとは[1]

システムノード生成機能[1]

システムノード定義ファイル（imdd_systemnode.conf）[1]

システムのステータス監視のAPI[1]

システムプロファイル（.system）[1]

システムプロファイル（セントラルスコープ）（jcs_sysprofile_xxx.def）[1]

システムプロファイル（セントラルスコープ・ビューアー）（system.conf）[1]

実装可能なメソッド[1]

実装可能なメソッド形式[1]

指定内容の確認[1]

自動／手動対処アクションの実行のAPI[1]

自動アクション環境定義ファイル（action.conf.update）[1]

自動アクション通知定義ファイル（actnotice.conf）[1]

自動アクション定義パラメーターのサイズチェック[1]

自動アクション定義ファイル（actdef.conf）[1]

自動アクション定義ファイル（actdef.conf）（互換用）[1]

自動アクション定義ファイル（互換用）

イベント監視条件の優先度[1]

指定内容の確認[1]

自動アクション定義パラメーターのサイズチェック[1]

定義の記述[1]

パラメーターグループとAND条件[1]

自動対処アクション定義ファイル（autoactconf.json）[1]

収集基点時間の注意事項[1]、[2]

重大度変更定義自動入力定義ファイル（chsev_auto_list.conf）[1]

重大度変更定義表示項目定義ファイル（chsev_attr_list.conf）[1]

重大度変更定義ファイル[1]

状態変更イベント件数の上限監視設定ファイル（evhist_warn_event_xxx.conf）[1]

状態変更イベント自動削除設定ファイル[1]

状態変更条件メモリー常駐機能の設定ファイル[1]

情報管理のAPI[1]

シングルサインオンマッピング定義反映API[1]

シングルサインオンマッピング定義ファイル（imdd_sso_mapping.properties）[1]

す

ステートメント[1]

構成要素の生成規則[1]

構造[1]

種類[1]

詳細[1]

せ

正規表現[1]

正規表現に関する注意事項[1]、[2]

制御文字[1]

性能レポート表示定義ファイル（performance.conf）[1]

セットアップ情報ファイル（jimdbsetupinfo.conf）[1]

前回実行履歴取得API[1]

そ

相関イベント発行環境定義ファイル[1]

相関イベント発行機能の状態

起動処理中[1]

機能停止[1]

相関稼働[1]

停止[1]

停止処理中[1]

相関イベント発行システムプロファイル（egs_system.conf）[1]

相関イベント発行定義ファイル[1]

操作ログ定義ファイル（imm_operationlog.conf）[1]

た

対処アクション実行API[1]

対処アクション状態監視定義ファイル（responseactionnotice.conf）[1]

対処アクション提案API[1]

対処アクションの実行結果取得[1]

対処アクションの手動実行[1]

対処状況イベント定義ファイル（processupdate.conf）[1]

対処済み連動設定ファイル（action_complete_xxx.conf）[1]

ち

置換文字列[1]

キーワード置換文字列[1]

レジストリー置換文字列[1]

つ

通信環境定義ファイル（console.conf.update）[1]

通信環境定義ファイル（tree_view.conf.update）[1]

通信環境定義ファイル（view.conf.update）[1]

ツールバー定義ファイル（!JP1_CS_FTOOL0.conf）[1]

ツリー構成ファイル[1]

ツリーのSID[1]

ツリーのSID変換機能[1]

て

提案定義ファイル[1]

提案のAPI[1]

提案マッピング情報取得[1]

定義の記述[1]

定義ファイル[1]

Alertmanager設定ファイル（jpc_alertmanager.yml）[1]

AWS定義ファイル（aws_settings.conf）[1]

Blackbox exporter（HTTP/HTTPS監視）のディスカバリ設定ファイル（jpc_file_sd_config_blackbox_http.yml）[1]

Blackbox exporter（ICMP監視）のディスカバリ設定ファイル（jpc_file_sd_config_blackbox_icmp.yml）[1]

Blackbox exporter設定ファイル（jpc_blackbox_exporter.yml）[1]

Blackbox exporterのメトリック定義ファイル（metrics_blackbox_exporter.conf）[1]

Fluentdのメトリック定義ファイル（metrics_fluentd.conf）[1]

imagentaction設定ファイル（jpc_imagentaction.json）[1]

imagentproxy設定ファイル（jpc_imagentproxy.json）[1]

imagent共通設定ファイル（jpc_imagentcommon.json）[1]

imagent設定ファイル（jpc_imagent.json）[1]

imbaseproxy設定ファイル（jpc_imbaseproxy.json）[1]

imbase共通設定ファイル（jpc_imbasecommon.json）[1]

imbase設定ファイル（jpc_imbase.json）[1]

IM-View設定ファイル（tuning.conf）[1]

IM管理ノードカテゴリ名称定義ファイル（imdd_category_name.conf）[1]

IM管理ノードリンク定義ファイル（imdd_nodeLink_def.conf）[1]

IM構成管理・ビューアー動作定義ファイル（jcfview.conf）[1]

IM構成反映方式設定ファイル（jp1cf_applyconfig.conf）[1]

IMパラメーター定義ファイル（jp1co_param_V7.conf）[1]

jr3algetコマンドの環境パラメーター設定ファイル（jr3alget.ini）[1]

jr3algetコマンドの環境パラメーター設定ファイルのサンプルファイル（jr3alget.ini.sample）[1]

jr3slgetコマンドの環境パラメーター設定ファイル（jr3slget.ini）[1]

jr3slgetコマンドの環境パラメーター設定ファイルのサンプルファイル（jr3slget.ini.sample）[1]

Node exporter（サービス監視）のメトリック定義ファイル（metrics_node_exporter_service.conf）[1]

Node exporter for AIXのメトリック定義ファイル（metrics_node_exporter_aix.conf）[1]

Node exporter for AIXのディスカバリ設定ファイル（jpc_file_sd_config_node_aix.yml）[1]

Node exporterのディスカバリ設定ファイル（jpc_file_sd_config_node.yml）[1]

Node exporterのメトリック定義ファイル（metrics_node_exporter.conf）[1]

OracleDB exporterのディスカバリ設定ファイル（jpc_file_sd_config_oracledb.yml）[1]

OracleDB exporterのデフォルトの収集メトリック定義ファイル（default-metrics.toml）[1]

OracleDB exporterのメトリック定義ファイル（metrics_oracledb_exporter.conf）[1]

Process exporter設定ファイル（jpc_process_exporter.yml）[1]

Process exporterのディスカバリ設定ファイル（jpc_file_sd_config_process.yml）[1]

Process exporterのメトリック定義ファイル（metrics_process_exporter.conf）[1]

Prometheus設定ファイル（jpc_prometheus_server.yml）[1]

Promitor Resource Discovery runtime設定ファイル（runtime.yaml）[1]

Promitor Resource Discovery設定ファイル（resource-discovery-declaration.yaml）[1]

Promitor Scraper runtime設定ファイル（runtime.yaml）[1]

Promitor Scraper設定ファイル（metrics-declaration.yaml）[1]

Promitorのディスカバリ設定ファイル（jpc_file_sd_config_promitor.yml）[1]

Promitorのメトリック定義ファイル（metrics_promitor.conf）[1]

SAPシステム監視のScript exporter設定ファイルのサンプルファイル（jpc_script_exporter_sap.yml）[1]

SAPシステムのCCMSアラート情報監視定義ファイルのサンプルファイル（fluentd_sap_alertlog_tail.conf）[1]

SAPシステムのシステムログ情報監視定義ファイルのサンプルファイル（fluentd_sap_syslog_tail.conf）[1]

Script exporter設定ファイル（jpc_script_exporter.yml）[1]

Script exporterのディスカバリ設定ファイル（jpc_file_sd_config_script.yml）[1]

Script exporterのメトリック定義ファイル（metrics_script_exporter.conf）[1]

Windows exporter（サービス監視）のメトリック定義ファイル（metrics_windows_exporter_service.conf）[1]

Windows exporter（プロセス監視）のメトリック定義ファイル（metrics_windows_exporter_process.conf）[1]

Windows exporter設定ファイル（jpc_windows_exporter.yml）[1]

Windows exporterのディスカバリ設定ファイル（jpc_file_sd_config_windows.yml）[1]

Windows exporterのメトリック定義ファイル（metrics_windows_exporter.conf）[1]

Windowsイベントログの監視定義ファイル（fluentd_@@trapname@@_wevt.conf.template）[1]

WWWページ呼び出し定義ファイル（hitachi_jp1_製品名.html）[1]

Yet another cloudwatch exporter設定ファイル（jpc_ya_cloudwatch_exporter.yml）[1]

Yet another cloudwatch exporterのディスカバリ設定ファイル（jpc_file_sd_config_cloudwatch.yml）[1]

Yet another cloudwatch exporterのメトリック定義ファイル（metrics_ya_cloudwatch_exporter.conf）[1]

アイコン動作定義ファイル（!JP1_CS_FTREE0.conf）[1]

アプリケーション実行定義ファイル[1]

アラート設定ファイル（jpc_alerting_rules.yml）[1]

一覧[1]

イベントガイド情報ファイル（jco_guide.txt）[1]

イベント拡張属性定義ファイル（拡張ファイル）[1]

イベント条件表示項目定義ファイル（attr_list.conf）[1]

イベント引き継ぎ情報変換設定ファイル（event_info_replace.conf）[1]

イベントレポート出力環境定義ファイル（evtreport.conf）[1]

インシデント手動登録定義ファイル（incident.conf）[1]

インシデント引き継ぎ情報設定ファイル（incident_info.conf）[1]

インテリジェント統合管理基盤定義ファイル（imdd.properties）[1]

インテリジェント統合管理データベースの設定ファイル（postgresql.conf）[1]

インテリジェント統合管理データベースセットアップ情報ファイル（jimgndbsetupinfo.conf）[1]

オブジェクトタイプ定義ファイル[1]

ガイド情報ファイル（jcs_guide_xxx.txt）[1]

概要[1]

拡張起動プロセス定義ファイル（jp1co_service.conf）[1]

格納先[1]

環境変数ファイル（任意のファイル名）[1]

監視オブジェクトDBの自動バックアップ・リカバリー設定ファイル（auto_dbbackup_xxx.conf）[1]

監視オブジェクト初期化設定ファイル[1]

起動プログラム定義ファイル（!JP1_CS_APP0.conf）[1]

共通除外条件拡張定義ファイル[1]

共通除外条件自動入力定義ファイル（common_exclude_filter_auto_list.conf）[1]

共通除外条件表示項目定義ファイル（common_exclude_filter_attr_list.conf）[1]

共通定義設定用ファイル（JP1イベントの属性変更）[1]

クラスタ環境インテリジェント統合管理データベースセットアップ情報ファイル（jimgndbclustersetupinfo.conf）[1]

クラスタセットアップ情報ファイル（jimdbclustersetupinfo.conf）[1]

繰り返しイベント条件自動入力定義ファイル（event_storm_auto_list.conf）[1]

繰り返しイベント条件表示項目定義ファイル（event_storm_attr_list.conf）[1]

構成取得対象ホスト定義ファイル（imdd_target_host.conf）[1]

構成要素[1]

構造[1]

コマンドボタン定義ファイル（cmdbtn.conf）[1]

コンテナ監視のメトリック定義ファイル（metrics_kubernetes.conf）[1]

サービス定義ファイル（jpc_プログラム名_service.xml）[1]

システムカラー定義ファイル（systemColor.conf）[1]

システムノード定義ファイル（imdd_systemnode.conf）[1]

システムプロファイル（.system）[1]

システムプロファイル（セントラルスコープ）（jcs_sysprofile_xxx.def）[1]

システムプロファイル（セントラルスコープ・ビューアー）（system.conf）[1]

自動アクション環境定義ファイル（action.conf.update）[1]

自動アクション通知定義ファイル（actnotice.conf）[1]

自動アクション定義ファイル（actdef.conf）[1]

自動アクション定義ファイル（actdef.conf）（互換用）[1]

自動対処アクション定義ファイル（autoactconf.json）[1]

重大度変更定義自動入力定義ファイル（chsev_auto_list.conf）[1]

重大度変更定義表示項目定義ファイル（chsev_attr_list.conf）[1]

重大度変更定義ファイル[1]

状態変更イベント件数の上限監視設定ファイル（evhist_warn_event_xxx.conf）[1]

状態変更イベント自動削除設定ファイル[1]

状態変更条件メモリー常駐機能の設定ファイル[1]

シングルサインオンマッピング定義ファイル（imdd_sso_mapping.properties）[1]

性能レポート表示定義ファイル（performance.conf）[1]

セットアップ情報ファイル（jimdbsetupinfo.conf）[1]

相関イベント発行環境定義ファイル[1]

相関イベント発行システムプロファイル（egs_system.conf）[1]

相関イベント発行定義ファイル[1]

操作ログ定義ファイル（imm_operationlog.conf）[1]

対処アクション状態監視定義ファイル（responseactionnotice.conf）[1]

対処状況イベント定義ファイル（processupdate.conf）[1]

対処済み連動設定ファイル（action_complete_xxx.conf）[1]

通信環境定義ファイル（console.conf.update）[1]

通信環境定義ファイル（tree_view.conf.update）[1]

通信環境定義ファイル（view.conf.update）[1]

ツールバー定義ファイル（!JP1_CS_FTOOL0.conf）[1]

ツリー構成ファイル[1]

定義ファイルプロパティファイル（imdd_file_properties.json）[1]

定義ファイルプロパティファイル（jpc_file_properties.json）[1]

テキスト形式のログファイルの監視定義ファイル（fluentd_@@trapname@@_tail.conf.template）[1]

統合機能メニュー定義ファイル[1]

任意のPrometheusトレンド名のメトリック定義ファイル（metrics_任意のPrometheusトレンド名.conf）[1]

発生元ホストマッピング定義ファイル（user_hostmap.conf）[1]

非暗号化通信ホスト設定ファイル（nosslhost.conf）[1]

表示メッセージ変更後イベント環境定義ファイル（chmsgevent.conf）[1]

表示メッセージ変更定義自動入力定義ファイル（chmsg_auto_list.conf）[1]

表示メッセージ変更定義表示項目定義ファイル（chmsg_attr_list.conf）[1]

表示メッセージ変更定義ファイル[1]

プロパティ表示文字列定義ファイル（property_labels.conf）[1]

プロファイル管理環境定義ファイル（jp1cf_profile_manager.conf）[1]

ヘルスチェック定義ファイル（jcohc.conf）[1]

ホスト収集情報ファイル（host_collect_data.csv）[1]

ホスト情報ファイル（jcs_hosts）[1]

ホスト入力情報ファイル（host_input_data.csv）[1]

ホスト名定義ファイル（imdd_host_name.conf）[1]

命名規則[1]

メール環境定義ファイル（jimmail.conf）[1]

モニター画面呼び出し定義ファイル[1]

ユーザー作成定義ファイルリスト定義ファイル（imdd_user_deffile_list.json）[1]

ユーザー作成定義ファイルリスト定義ファイル（jpc_user_deffile_list.json）[1]

ユーザー独自のディスカバリ設定ファイル（user_file_sd_config_任意の名前.yml）[1]

ユーザー独自のメトリック定義ファイル（metrics_任意のPrometheusトレンド名.conf）[1]

ユーザー独自のメトリック定義ファイル（Promitor）（metrics_任意のPrometheusトレンド名.conf）[1]

ユーザー独自のメトリック定義ファイル（コンテナ監視）（metrics_任意のPrometheusトレンド名.conf）[1]

ユーザープロファイル（defaultUser）[1]

ユーザープロファイル（profile_ユーザー名）[1]

ユニット定義ファイル（jpc_プログラム名.service）[1]

リモート監視イベントログトラップ動作定義ファイル[1]

リモート監視ログファイルトラップ動作定義ファイル[1]

リモートログトラップ環境定義ファイル（jp1cf_remote_logtrap.conf）[1]

ログ監視共通定義ファイル（jpc_fluentd_common.conf）[1]

ログ監視対象定義ファイル（jpc_fluentd_common_list.conf）[1]

ログメトリクス定義ファイル（fluentd_任意の名前_logmetrics.conf）[1]

定義ファイル一覧取得[1]

定義ファイル更新[1]

定義ファイル削除[1]

定義ファイル取得[1]

定義ファイル操作のAPI[1]

定義ファイルの記述形式[1]

定義ファイルプロパティファイル（imdd_file_properties.json）[1]

定義ファイルプロパティファイル（jpc_file_properties.json）[1]

テキスト形式のログファイルの監視定義ファイル（fluentd_@@trapname@@_tail.conf.template）[1]

と

統合エージェント管理のAPI[1]

統合エージェント情報削除[1]

統合エージェント情報取得[1]

［統合オペレーション・ビューアー］画面のカスタマイズ[1]

<custom UI Id>に指定する文字列[1]

インテリジェント統合管理基盤定義ファイル（imdd.properties）の記載例[1]

概要[1]

注意事項[1]

定義情報[1]

定義情報の確認[1]

定義するプロパティ情報[1]

配置場所[1]

ユーザー定義画面で使用できるメソッドとオブジェクト[1]

統合機能メニュー定義ファイル[1]

チェックする[1]

トレンドデータ書き込み[1]

トレンドのAPI[1]

に

二次資料

JP1/IM - Manager用（UNIX）[1]

JP1/IM - View，JP1/IM - Manager用（Windows）[1]

任意のPrometheusトレンド名のメトリック定義ファイル（metrics_任意のPrometheusトレンド名.conf）[1]

の

ノード生成機能[1]

は

配布のAPI[1]

配布物の取得（ファイルダウンロード）[1]

パスワードに指定できる文字[1]、[2]

発生元ホストマッピング定義ファイル（user_hostmap.conf）[1]

パラメーターグループとAND条件[1]

ひ

非暗号化通信ホスト設定ファイル（nosslhost.conf）[1]

必要な権限[1]、[2]

表示メッセージ変更後イベント環境定義ファイル（chmsgevent.conf）[1]

表示メッセージ変更定義自動入力定義ファイル（chmsg_auto_list.conf）[1]

表示メッセージ変更定義表示項目定義ファイル（chmsg_attr_list.conf）[1]

表示メッセージ変更定義ファイル[1]

ふ

フィールドID[1]、[2]

プラグイン用のAPI[1]

プロキシのAPI[1]

プロパティ表示文字列定義ファイル（property_labels.conf）[1]

プロファイル管理環境定義ファイル（jp1cf_profile_manager.conf）[1]

へ

ヘルスチェック定義ファイル（jcohc.conf）[1]

ほ

ホスト収集情報ファイル（host_collect_data.csv）[1]

ホスト情報ファイル（jcs_hosts）[1]

ホスト入力情報ファイル（host_input_data.csv）[1]

ホスト名定義ファイル（imdd_host_name.conf）[1]

め

メール環境定義ファイル（jimmail.conf）[1]

メソッド

__configurationGet[1]

__configurationGetAdapterless[1]

__createLink[1]

__createTreeNode[1]

__eventGet[1]

__linkValueGet[1]

__metricListGet[1]

__simtLoad[1]

__timeSeriesDataGet[1]

__transformEvent[1]

__urlGet[1]

例外発生時の処理[1]

メソッド一覧[1]

も

モニター画面呼び出し定義ファイル[1]

チェックする[1]

ゆ

ユーザーが汎用モジュールにRFC接続するための権限（S_RFC）[1]、[2]

ユーザー作成定義ファイルリスト定義ファイル（imdd_user_deffile_list.json）[1]

ユーザー作成定義ファイルリスト定義ファイル（jpc_user_deffile_list.json）[1]

ユーザー作成プラグイン[1]

ユーザー作成プラグイン内で使用できるメソッド[1]

ユーザー作成プラグインによって実現できること[1]

ユーザー作成プラグインの形式[1]

ユーザー作成プラグインの言語規約[1]

ユーザー作成プラグインの実装規約[1]

ユーザータイプ[1]、[2]

ユーザー独自のディスカバリ設定ファイル（user_file_sd_config_任意の名前.yml）[1]

ユーザー独自のメトリック定義ファイル（metrics_任意のPrometheusトレンド名.conf）[1]

ユーザー独自のメトリック定義ファイル（Promitor）（metrics_任意のPrometheusトレンド名.conf）[1]

ユーザー独自のメトリック定義ファイル（コンテナ監視）（metrics_任意のPrometheusトレンド名.conf）[1]

ユーザー認証のAPI[1]

ユーザープロファイル（defaultUser）[1]

ユーザープロファイル（profile_ユーザー名）[1]

ユニット定義ファイル（jpc_プログラム名.service）[1]

り

リモート監視イベントログトラップ動作定義ファイル[1]

リモート監視ログファイルトラップ動作定義ファイル[1]

リモート監視ログファイルトラップ動作定義ファイルのACTDEFパラメーターに指定されている値[1]

リモートログトラップ環境定義ファイル（jp1cf_remote_logtrap.conf）[1]

リンク情報のAPI[1]

れ

レジストリー置換文字列[1]

連携製品のAPI[1]

ろ

ログ監視共通定義ファイル（jpc_fluentd_common.conf）[1]

ログ監視対象定義ファイル（jpc_fluentd_common_list.conf）[1]

ログメトリクス定義ファイル（fluentd_任意の名前_logmetrics.conf）[1]