ABAP センサーを使用した SAP のモニター
ABAPセンサーを使用して SAP を監視するには、 Instana ホストエージェントをインストールする必要があります。 ホスト・エージェントをインストールすると、ABAP センサーが自動的にインストールされます。 ABAPセンサーの設定が完了すると、 Instana のUIで SAP に関連するメトリクスを確認できます。
詳細については、 「 Instana ホストエージェントのインストール」 を参照してください。
補足情報
サポートされる OS
Instana SAP Java Connector がサポートする以下のオペレーティングシステムに対応しており、ローカルおよびリモートでの監視が可能です:
ローカル監視の場合( Instana エージェントがABAPサーバーと同じホストにインストールされている場合):
- AIX
- Linux (x86 および IBM PowerPC 64 ビット LE)
- Windows
リモート監視の場合( Instana エージェントが別のホストにインストールされ、ABAPサーバーにリモート接続する場合):
- AIX
- Linux (x86 および IBM PowerPC 64 ビット LE)
- Windows
- IBM i ( OS/400 PASE)
- Apple macOS (64 ビット-Intel および Apple silicon)
注: リモート監視については、 SAP は IBM i を含むあらゆるプラットフォーム上で動作させることができ、これらのプラットフォームに Instana エージェントをインストールすることでリモート監視が可能です。
SAP Java Connector でサポートされているオペレーティングシステムの詳細については、 「サポート対象の OS」 を参照してください。
サポートされるバージョン
ABAP センサーは、以下の SAP バージョンをサポートします。
- SAP R/3 3.1
- S/4 HANA 以降
- SAP Java コネクタ 3.1.8 以降
前提条件
ABAPセンサーは、 SAP の Java Connector(JCo)ライブラリを使用して、ABAPインスタンスからメトリクスを取得します。 SAP のライセンスをお持ちの場合、JCoライブラリを以下のURLから無料でダウンロードできます。Download SAP Java Connector 3.1 SDK 詳細については、 「 SAP 」JCoライブラリの追加を参照してください。
ABAP センサーは SAP JCo 3.1.8 以降のみをサポートしています。
ABAPセンサーの設定
ABAP インスタンスからメトリックを収集するには、ABAP センサーを以下のように構成する必要があります。
SAP のJCoライブラリを追加する
SAP JCo ライブラリーを Linuxベースのシステムに追加するには、以下の手順を実行します。
ディレクトリ
/opt/instana/agent内で、インストール済みの Instana エージェントを探してください。Instana エージェントのインストールディレクトリ内に、
system/com/sap/sapjco3/<Major>.<Minor>.<patch>ディレクトリを作成します
ここで、 system/com/sap/sapjco3/3.1.13 Majorは3、Minorは1、patchは13です。
使用する JAR バージョンに基づいてこれらの値を更新します。
以下の手順では、例として SAP JCo 3.1.13 を扱います。使用するJARファイルのバージョンに合わせて、このURLを修正してください:
次のようなディレクトリ構造が設定されていることを確認してください。
/opt/instana/agent/system/com/sap/sapjco3/3.1.13。ダウンロードして解凍するSAPJCo パッケージに記載されている指示に従ってください。
Readme.txtファイル。JCoのインストールはプラットフォームに依存するため、 Instana エージェントが実行されるプラットフォームに対応したJCoのバージョンをダウンロードする必要があります。 ABAPセンサーは、 Instana エージェントと同じコンピュータに展開され、 SAP システムと通信してメトリクスを取得します。
ファイルを
.zipダウンロードして解凍したら、解凍されたフォルダからファイルをsapjco3.jar/opt/instana/agent/system/com/sap/sapjco3/3.1.13/ディレクトリにコピーしてください。注: この/opt/instana/agent/system/com/sap/sapjco3/3.1.13/ディレクトリにはセンサーの設定に不要なファイルが多数含まれているため、ファイルを.zip直接このディレクトリに解凍しないでください。 必要なのは、このディレクトリ内のファイルsapjco3.jarと、OS固有のライブラリファイル1つだけです。/opt/instana/agent/system/com/sap/sapjco3/3.1.13/ディレクトリで、'sapjco3.jarファイルを'sapjco3-3.1.13.jarにリネームする。注: 指定されたディレクトリには、.jar ファイルが1つだけ含まれている必要があります。 この例では、.jar ファイルはsapjco3-3.1.13.jar.OS-specificライブラリファイルを '/opt/instana/agent/system/com/sap/sapjco3/3.1.13/ディレクトリに置く。 ファイルの拡張子は '.dllまたは '.soです。ファイルをディレクトリーに配置した後、ディレクトリーは以下のように表示される必要があります。 以下の例は、ファイルを配置した後の Linuxベースのインストール・ディレクトリーを示しています。
ls /opt/instana/agent/system/com/sap/sapjco3/3.1.13/ libsapjco3.so sapjco3-3.1.13.jar拡張子が
.dllまたは.soのファイルは名前変更しないでください。- ファイル
configuration.yaml内の パラメータlibpathを に更新してください/opt/instana/agent/system/com/sap/sapjco3/3.1.13/。 詳細については、 「設定パラメータ」 を参照してください。
ABAPセンサーをABAPインスタンスに接続する
Instana SAP のABAPインスタンスには、 直接、または SAP メッセージサーバー を経由して接続できます。
SAP のABAPインスタンスまたはメッセージサーバーが外部クライアントからの直接接続を許可せず、 SAProuter代わりにSAProuter経由での接続を必要とする場合は、「 SAProuter経由での接続 」を参照してください。
ABAPセンサーを設定し、1つ以上のABAPインスタンスに、直接、または SAP メッセージサーバーを経由して接続できるようにする必要があります。 両方の設定を混在させないでください。
ABAPインスタンスへの直接接続
Instana SAP のABAPセンサーについて、ローカルおよびリモートでの監視の両方をサポートしています。
ABAPセンサーをABAPインスタンスに直接接続するには、以下の例に示すように、 ロー カルまたはリモートの設定を追加してください。 パラメータに適切な値を入力してください。 メトリックのデフォルトのポーリング間隔は 60 秒に設定されています。
ローカル構成
ローカル・モニターの構成パラメーターを以下の例に示します。
# SAP ABAP
com.instana.plugin.sap.abap:
# local monitoring configuration
local : #multiple configurations supported
- sysnr: '72'
client: '100'
user: 'User1'
password: 'password'
lang: 'en'
pool_capacity: '10'
libpath: <INSERT_SAP_JCO_LIBRARY_LOCATION>
# path to JCo drivers. For static agent configuration details, follow documentation.
poll_rate: 60 # seconds
リモート構成
リモート・モニターの構成パラメーターを以下の例に示します。
# SAP ABAP
com.instana.plugin.sap.abap:
# remote monitoring configuration
remote : #multiple configurations supported
- host: 'remote.host-1.com'
sysnr: '72'
client: '100'
user: 'User1'
password: 'password'
lang: 'en'
pool_capacity: '10'
libpath: <INSERT_SAP_JCO_LIBRARY_LOCATION>
# path to JCo drivers. For static agent configuration details, follow documentation.
poll_rate: 60 # seconds
- host: 'remote.host-2.com'
sysnr: '01'
client: '900'
user: 'User2'
password: 'password'
lang: 'en'
pool_capacity: '10'
libpath: <INSERT_SAP_JCO_LIBRARY_LOCATION>
# path to JCo drivers. For static agent configuration details, follow documentation.
poll_rate: 60 # seconds
前の例に示されているように、各行の前のスペースの配置が維持されるようにしてください。これは、 YAML の書式指定構文に従っているためです。
構成パラメーター
以下の表は、ABAPインスタンスに直接接続する場合の SAP ABAPセンサーの設定パラメータを一覧にしたものです:
| パラメーター | 説明 |
|---|---|
host |
ABAP センサーがメトリックをフェッチする元の SAP インスタンスの IP アドレスまたは修飾ホスト名。 |
sysnr |
SAP ABAP インスタンスのインスタンス ID。例えば、01 などです。 |
client |
SAP ABAP インスタンスのクライアント ID (例: 200)。 |
user |
SAP インスタンスで設定されたユーザー名。 SAP のユーザーは、メトリクスを取得する権限を持っている必要があります。 詳細については、 「メトリクスの取得に関するユーザーの権限を確認する」 を参照してください。 |
password |
ユーザーの SAP システムにログインするために必要となるパスワード。 |
libpath |
コンピューター上で JCo がセットアップされ、OS 固有のライブラリー・ファイルが入っているフォルダー。 例えば、'/opt/instana/agent/system/com/sap/sapjco3/3.1.13/' です。 Linux ベースのシステムでは、そのディレクトリに ファイル libsapjco3.so が存在する必要があります。 Windows ベースのシステムでは、そのディレクトリに ファイル sapjco3.dll が存在する必要があります。 |
lang |
SAP のログオン言語。 デフォルト値は「en」です。 |
pool_capacity |
ABAP センサーが SAP インスタンスに対して行うことができる接続の最大数。 |
SAP メッセージサーバー経由でABAPインスタンスに接続する
ABAPセンサーを設定して、メッセージサーバー経由でABAPインスタンスに接続することができます。
SAP メッセージサーバーを介してABAPインスタンスに接続するには、次の例に示すような設定を使用してください
# SAP ABAP
com.instana.plugin.sap.abap:
remote : # Connecting via Message Server
- host: 'remote.messageserver-host.com'
port: '3600' # Default port for Message Server
type: 'message_server'
client: '100'
user: 'User1'
password: 'password'
group : 'PUBLIC' # Optional, Default is PUBLIC
lang: 'en'
pool_capacity: '10'
libpath: <INSERT_SAP_JCO_LIBRARY_LOCATION>
# path to JCo drivers. For static agent configuration details, follow documentation.
poll_rate: 60 # seconds
構成パラメーター
次の表は、 SAP メッセージサーバーを介してABAPインスタンスに接続する際の、 SAP ABAPセンサーの設定パラメータの一覧です
| パラメーター | 説明 |
|---|---|
host |
メッセージサーバーのIPアドレスまたは完全修飾ホスト名。 |
port |
メッセージサーバーのポート番号は、通常、3600に2桁のインスタンスIDを加えた値になります。 たとえば、インスタンス ID が 01 の場合、メッセージサーバーのポートは 3601. デフォルトのポートは 3600. |
type |
message_server に設定します。 |
client |
たとえば、 SAP システムのクライアントIDは、 200. |
user |
SAP インスタンスで設定されているユーザー名。 SAP のユーザーは、メトリクスを取得する権限を持っている必要があります。 詳細については、 「メトリクスの取得に関するユーザーの権限を確認する」 を参照してください。 |
password |
ユーザーの SAP システムにログインするために必要となるパスワード。 |
group (任意) |
ログオン グループ。 デフォルトは PUBLIC です。 |
libpath |
コンピューター上で JCo がセットアップされ、OS 固有のライブラリー・ファイルが入っているフォルダー。 例えば、'/opt/instana/agent/system/com/sap/sapjco3/3.1.13/' です。 Linux ベースのシステムでは、そのディレクトリに ファイル libsapjco3.so が存在する必要があります。 Windows ベースのシステムでは、そのディレクトリに ファイル sapjco3.dll が存在する必要があります。 |
lang |
SAP のログオン言語。 デフォルト値は "en"です。 |
pool_capacity |
ABAP センサーが SAP インスタンスに対して行うことができる接続の最大数。 |
SAProuter経由での接続
SAP のABAPインスタンスまたはメッセージサーバーが外部クライアントからの直接接続を許可せず、代わりに経由した接続を必要とする場合は、ファイル configuration.yaml に以下の SAProuter追加パラメータを追加する必要があります:
sap_router: '/H/saprouter-host'
がデフォルトのポートとは SAProuter 異なるポートで実行 3299されている場合は、次のようにポート番号を指定できます:
sap_router: '/H/saprouter-host/P/saprouter-port'
メトリクスを取得するためのユーザーの権限を確認する
YAML ファイル内のABAPセンサー設定で指定されたユーザーが、 SAP JCoからメトリクスを取得する権限を持っていることを確認してください。
SAP JCo からメトリックをプルするには、 SAP ユーザー・アカウントで以下の Authorization Object パラメーターを指定する必要があります。
Authorization Object: S_RFC
RFC_TYPE: Function Module
RFC_NAME: *
Activity: Execute
Authorization Object: /SDF/E2E
Activity: 03
Authorization Object: S_ADMI_FCD
S_ADMI_FCD: ST0R
Authorization Object: S_RZL_ADM
Activity: 03
Authorization Object: S_TABU_DIS
DICBERCLS: &NC&,EDI0,SA,SC,SS,SPWD
Activity: 03
メトリックの表示
ホストエージェントをインストールし、ABAPセンサーを設定すると、 Instana のUIで SAP のメトリクスとアラートを確認できるようになります。
インフラストラクチャの概要
メトリックを表示するには、以下のステップを実行します。
- Instana のUIのサイドバーで、 「インフラストラクチャ」 を選択します。
- 「マップ」 タブで、 SAPに固有のタワーをクリックします。
- 「ダッシュボードを開く」 をクリックします。
収集されたすべてのメトリックを含む SAP ダッシュボードを表示できます。
プラットフォームの眺め
Platformでメトリックを表示するには、以下の手順を実行します。
- Instana のUIにあるナビゲーションメニューから、 「Platform 」>「 SAP 」を選択します。 システム、 インスタンス、およびデータベースの一覧を表示できます。
- ABAP センサーに接続されている SAP インスタンスを表示するには、 「インスタンス」 タブをクリックします。 センサー名は として表示されています
AbapInstance@HostName_SID_InstanceID。

メトリック
ABAP センサーは、以下のメトリックを収集します。
- CPU
- メモリー
- ワーク・プロセス
- バックグラウンド・ジョブ
- データベース接続数
- データベース待機時間
- ユーザー・ログイン
- ワークロード応答時間
- アップタイム
- トップ・プロセス
- 要求キュー
- ディスク・データ
- ファイル・システム
- エラーおよびダンプ
- ユーザー統計
- スプール
- データベース・ヒット・リスト
- Webクライアント
- Web宛先
- トランスポート要求
- RFC 呼び出し
- トランザクション RFC
- 保留中のRFC
- ネットワーク
- ICM
- フィオリ
- ゲートウェイ接続
- ゲートウェイ・エラー・ログ
- エントリーのロック
- ゲートウェイ統計
- IDoc
- システム・ログ・エラー
- 更新エラー
- システム・ログ統計
- ABAP ダンプ統計
- ロック項目
- スプール・エラー
- システム構成の変更
- クライアント構成の変更
メトリクスの収集頻度
以下の表に、ABAP センサーによるメトリック収集の頻度の概要を示します。
| 収集されたメトリック | 収集頻度 |
|---|---|
| バックグラウンド・ジョブ | 30 秒 |
| 作業プロセス・リスト | 60 秒 |
| ワーク・プロセス・ステータス | 60 秒 |
| ジョブ状況 | 60 秒 |
| HTTP 指標 | 60 秒 |
| SPOOL | 60 秒 |
| ユーザー・リスト | 60 秒 |
| DB 接続 | 60 秒 |
| データベース・ヒット・リスト | 60 秒 |
| Fiori メトリック | 60 秒 |
| RFC 呼び出し | 60 秒 |
| メモリー使用率 | 60 秒 |
| ダイアログ応答時間 | 60 秒 |
| サーバー状況 | 90 秒 |
| ABAP ダンプ | 2 分間 |
| エントリー・リストのロック | 2 分間 |
| 更新エラー | 2 分間 |
| トランスポート要求 | 2 分間 |
| ゲートウェイ・メトリック | 2 分間 |
| バッファー統計 | 3 分 |
| ショート・ダンプ履歴 | 3 分 |
| ユーザー情報 | 3 分 |
| トップ・プロセス・リスト | 3 分 |
| システム・ログ | 3 分 |
| ページインおよびページアウト | 3 分 |
| CPUメトリック | 3 分 |
| LAN インターフェース | 4分 |
| ゲートウェイ・エラー | 4分 |
| 要求キュー | 5 分 |
| ICM | 5 分 |
| インバウンド IDoc | 5 分 |
| アウトバウンド IDoc | 5 分 |
| RFC エラー・ログ | 5 分 |
| Webクライアント | 5 分 |
| Web宛先 | 5 分 |
| ファイル・システム | 7 分 |
| ディスク・データ | 10 分 |
SAPABAP センサーは、さまざまなシナリオの組み込みイベントを生成します。 詳細については、組み込みイベントリファレンス。