3.15.5　SAPシステム監視機能

■ ログ抽出可能なSAPシステム

SAPのログ抽出コマンドは，RFCコネクションを介して，SAPシステムの外部インターフェースにアクセスします。RFC接続情報を，環境パラメーター設定ファイルまたはSAPのログ抽出コマンドの引数で指定することで，リモートホストを含むホスト上のSAPシステムにアクセスできます。

■ コマンドのパラメーター定義

SAPシステムのログ抽出コマンドのパラメーターは，コマンドの引数または環境パラメーター設定ファイルで指定します。

コマンドの各種環境パラメーターを事前定義するためには，SAPシステムのログ抽出コマンドの入力ファイルとして，環境パラメーター設定ファイルを作成する必要があります。

JP1/IM - Agentが提供する環境パラメーター設定ファイルのサンプルを，任意のディレクトリにコピーし，カスタマイズして使用できます。環境パラメーター設定ファイルのサンプルについては，マニュアル「コマンド・定義ファイル・APIリファレンス」（2. 定義ファイル）の「jr3slgetコマンドの環境パラメーター設定ファイルのサンプルファイル（jr3slget.ini.sample）」と「jr3algetコマンドの環境パラメーター設定ファイルのサンプルファイル（jr3alget.ini.sample）」を参照してください。

■ ログファイル出力

上記のコマンドで抽出したSAPシステムのシステムログ情報とCCMSアラート情報を，SAPシステムのログ抽出コマンドのログファイルに出力します。出力先は，環境パラメーター設定ファイルまたはSAPシステムのログ抽出コマンドの引数で，任意のパスを指定します。出力する文字コードはOSの言語設定に従います。

スクリプト実行結果監視機能（Fluentd）を使用して出力されたログファイルを監視する場合は，出力形式をWRAP2に指定する必要があります。

ログ監視機能（Fluentd）で監視可能なテキストファイルについては，「3.15.3(3)テキスト形式のログファイルの監視機能（tailプラグイン）」を参照してください。

また，JP1/Baseのログファイルトラップ機能を使用してログファイルを監視する場合も，WRAP1形式ではトラップ遅延などの問題があるため，WRAP2形式でログファイルを出力することを推奨します。

■ 保守情報の記録

SAPシステムのログ抽出コマンドの保守情報は，コマンドのトレースファイルに出力します。トレースファイルのパスは，環境パラメーター設定ファイルで任意のパスを指定します。指定しない場合，コマンドの作業ディレクトリに出力されます。出力する文字コードはOSの言語設定に従います。

■ 前回のレコード抽出時刻の管理

SAPシステムのログ抽出コマンドで，前回のコマンド実行以降に出力したSAPシステムのシステムログ情報とCCMSアラート情報を抽出する場合は，タイムスタンプファイルを作成する必要があります。この場合は，コマンド実行時に-lasttimeオプションでタイムスタンプファイルを指定します。

■ スクリプト実行結果監視機能（Fluentd）

スクリプト実行結果監視機能（Fluentd）は，Fluentdのログ監視機能を使用して，テキストファイルに出力されたSAPシステムのシステムログ情報とCCMSアラート情報を監視する機能です。テキスト形式のログファイルの監視機能を使用してテキストファイルを監視し，JP1イベントに変換します。監視定義ファイルのサンプルとして，次に示す2つのテキスト形式のログファイル監視定義ファイルを提供します。サンプルファイルは，Fluentdのログ監視機能がサポートする範囲で編集できます。

• SAPシステムのシステムログ情報監視定義サンプル（fluentd_sap_syslog_tail.conf）

• SAPシステムのCCMSアラート情報監視定義サンプル（fluentd_sap_alertlog_tail.conf）

■ スクリプト実行結果監視機能（JP1/Base）

スクリプト実行結果監視機能（JP1/Base）は，JP1/Baseのログファイルトラップ機能を使用して，テキストファイルに出力されたSAPシステムのシステムログ情報とCCMSアラート情報を監視する機能です。テキストファイルに出力された情報は，JP1イベントに変換できます。

■ メトリック送信機能（Script exporter）

スクリプト実行状況の情報取得には，Script exporterの機能を使用します。Script exporterの機能，およびScript exporterが取得するメトリックについては，「3.15.1(1)(j)Script exporter（UAP監視機能）」を参照してください。

Script exporterのメトリックは，統合オペレーション・ビューアーの［トレンド］タブや［ダッシュボード］タブで確認できます。Script exporterのIM管理ノードについては，「3.15.6(1)IM管理ノードの作成」を参照してください。

Script exporterを使用して作成するIM管理ノードのラベル名は，Script exporter設定ファイルに指定したscripts.nameの値です。SAPシステム監視のメトリック送信機能（Script exporter）のscripts.nameのデフォルト値は，マニュアル「JP1/Integrated Management 3 - Manager コマンド・定義ファイル・APIリファレンス」の「SAPシステム監視のScript exporter設定ファイルのサンプルファイル（jpc_script_exporter_sap.yml）」（2. 定義ファイル）を参照してください。

Script exporter設定ファイルに，SAPシステムのログ抽出コマンドを実行するスクリプトを定義する場合，script.nameにはSAPシステムのログ抽出コマンド名（jr3slgetまたはjr3alget）を含める必要があります。含めない場合，SAPシステム監視のメトリック送信機能のIM管理ノードがOther Applicationsカテゴリ配下に作成されます。

SAPシステム監視のメトリック送信機能（Script exporter）を使用して作成するIM管理ノードは，Enterpriseカテゴリ配下に作成されます。SAPシステム監視のメトリック送信機能（Script exporter）を使用する場合は，Prometheus設定ファイルを編集し，Script exporterが取得するメトリックのうち，SAPシステム監視に関するメトリックが，IM管理ノードのEnterpriseカテゴリに振り分けられるように設定してください。

設定内容については，マニュアル「JP1/Integrated Management 3 - Manager 構築ガイド」の「1.21.2(3)(h)SAPシステムのログ抽出コマンドをScript exporterを使用して実行する場合の設定（Windowsの場合）（オプション）」および「2.19.2(3)(h)SAPシステムのログ抽出コマンドをScript exporterを使用して実行する場合の設定（Linuxの場合）（オプション）」を参照してください。

上記の設定を行うと，Script exporter設定ファイル内のscript.nameにSAPシステムのログ抽出コマンド名（jr3slgetまたはjr3alget）が含まれている場合に，Enterpriseカテゴリ配下にSAPシステム監視のメトリック送信機能のIM管理ノードが作成されます。

■ メトリック送信機能（Fluentd）

スクリプト実行結果監視状況の情報取得には，Fluentdのログ監視機能のメトリック送信機能を使用します。メトリック送信機能については，「3.15.3(14)メトリック送信機能」を参照してください。

FluentdのIM管理ノードについては，「3.15.6(1)IM管理ノードの作成」を参照してください。jp1_pc_categoryで指定するカテゴリとjp1_pc_nodelabelの値については，マニュアル「JP1/Integrated Management 3 - Manager コマンド・定義ファイル・APIリファレンス」の「SAPシステムのシステムログ情報監視定義ファイルのサンプルファイル（fluentd_sap_syslog_tail.conf）」（2. 定義ファイル）および「SAPシステムのCCMSアラート情報監視定義ファイルのサンプルファイル（fluentd_sap_alertlog_tail.conf）」（2. 定義ファイル）を参照してください。