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 のIDocライブラリは必要ありません。 「 SAP 」 Java、「Connector」 3.1、および「SDK」ファイルは、 Instana エージェントが展開されているプラットフォーム用のみをダウンロードすれば十分です。 たとえば、 Linux x86 上で実行されている Instana エージェントは、 Windows x86 上で実行されている SAP のABAPアプリケーションサーバーを監視します。 「 SAP 」 Java、「Connector」 3.1、「SDK」ファイル、および「 Linux 」 x86 をダウンロードする必要があります。

ABAP センサーは SAP JCo 3.1.8 以降のみをサポートしています。

ABAPセンサーの設定

ABAP インスタンスからメトリックを収集するには、ABAP センサーを以下のように構成する必要があります。

注: 以下の情報は、静的エージェントと動的エージェントの両方に適用されます。 説明のために、 Linux ベースの展開を使用しています。 Windows、Mac、およびその他のサポート対象の Unix システムなど、他のオペレーティングシステムについても同様の手順に従う必要があります。

SAP のJCoライブラリを追加する

SAP JCo ライブラリーを Linuxベースのシステムに追加するには、以下の手順を実行します。

  1. ディレクトリ /opt/instana/agent 内で、インストール済みの Instana エージェントを探してください。

  2. 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を修正してください:

  1. 次のようなディレクトリ構造が設定されていることを確認してください。/opt/instana/agent/system/com/sap/sapjco3/3.1.13

  2. ダウンロードして解凍するSAPJCo パッケージに記載されている指示に従ってください。Readme.txtファイル。

    JCoのインストールはプラットフォームに依存するため、 Instana エージェントが実行されるプラットフォームに対応したJCoのバージョンをダウンロードする必要があります。 ABAPセンサーは、 Instana エージェントと同じコンピュータに展開され、 SAP システムと通信してメトリクスを取得します。

  3. ファイルを .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つだけです。
  4. /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.
  5. 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のファイルは名前変更しないでください。

  6. ファイル 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センサーについて、ローカルおよびリモートでの監視の両方をサポートしています。

注: すべてのローカル監視設定を「local」タグの下に追加してください。

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
 
注: ユーザーの認証は、 SAP のABAPシステム上で行われます。 このABAPセンサーの configuration.yaml で指定されているのと同じユーザー、インスタンスID、およびクライアントIDに対して、ユーザー認証を行う必要があります。

メトリックの表示

ホストエージェントをインストールし、ABAPセンサーを設定すると、 Instana のUIで SAP のメトリクスとアラートを確認できるようになります。

インフラストラクチャの概要

メトリックを表示するには、以下のステップを実行します。

  1. Instana のUIのサイドバーで、 「インフラストラクチャ」 を選択します。
  2. 「マップ」 タブで、 SAPに固有のタワーをクリックします。
  3. 「ダッシュボードを開く」 をクリックします。

収集されたすべてのメトリックを含む SAP ダッシュボードを表示できます。

プラットフォームの眺め

Platformでメトリックを表示するには、以下の手順を実行します。

  1. Instana のUIにあるナビゲーションメニューから、 「Platform 」>「 SAP 」を選択します。 システムインスタンス、およびデータベースの一覧を表示できます。
  2. ABAP センサーに接続されている SAP インスタンスを表示するには、 「インスタンス」 タブをクリックします。 センサー名は として表示されています AbapInstance@HostName_SID_InstanceID

SAP ダッシュボード

メトリック

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 センサーは、さまざまなシナリオの組み込みイベントを生成します。 詳細については、組み込みイベントリファレンス