Java の「 NetWeaver 」センサーを使用した SAP の監視

「 Instana 」 Java NetWeaver センサーを使用することで、 SAP Java NetWeaver 上で実行されている Java アプリケーションを監視し、ボトルネックを特定してパフォーマンスを最適化することができます。 Instana ホストエージェントをインストールすると、 Java の NetWeaver センサーが自動的にインストールされます。 「 Java 」 NetWeaver センサーの設定が完了すると、 Instana のUIで、これに関連するメトリクスを確認できます。

補足情報

SAP Java NetWeaver のセンサーが現在の環境と互換性があるかどうかを確認するには、以下のセクションをご確認ください:

サポートされる OS

Instana SAP、 Java、 NetWeaver センサーのローカルおよびリモート監視において、以下のオペレーティングシステムに対応しています:

  • ローカル監視 : Instana エージェントは、 SAP Java NetWeaver システムと同じホストにインストールされます:

    • AIX
    • Linux ( x86 および IBM PowerPC 64ビット版 LE)
    • Windows
  • リモート監視 : Instana エージェントは別のホストにインストールされ、 SAP Java NetWeaver サーバーにリモート接続します:

    • AIX
    • Linux ( x86 および IBM PowerPC 64ビット版 LE)
    • Windows
    • IBM i ( OS/400 PASE)
    • Apple macOS (64ビット - Intelおよび Apple silicon )
注: リモート監視の場合、上記のOS一覧は、 Instana エージェントがインストールされているホストを指します。

サポートされるバージョン

SAP Java NetWeaverセンサーは、 SAP Java NetWeaver 7.5 をサポートしています。

SAP、 Java、 NetWeaver センサーの設定

Instana SAP、 Java、 NetWeaver センサーのローカルおよびリモート監視の両方をサポートしています。

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

センサーを SAP、 Java、 NetWeaver のインスタンスに直接接続するには、以下の例に示すように、 ロー カルまたはリモートの設定を追加してください。 サンプル値を、ご自身の環境に合わせて変更してください。 メトリックのデフォルトのポーリング間隔は60秒に設定されています。

以下の例に示すように、各行の前のスペースの書式が維持されるようにしてください。これは、 YAML の書式指定構文に従っているためです。

ローカル構成

ローカル監視の設定パラメータは、以下の例に示されています:

# SAP Java Netweaver
com.instana.plugin.sap.java.netweaver:
 enabled: true
 local: # local monitoring configuration
  - jmxport: '12345'
    user: 'User1'
    password: 'password'
    sysnr: '01'
    poll_rate: 60 # seconds
 

ファイル configuration.yaml 内で、、 passworduser 、および sysnrjmxport インスタンスID)に適切な値を入力してください。 メトリックのデフォルトのポーリング間隔は60秒に設定されています。

ローカル監視において、この host パラメータは省略可能です。 デフォルトでは、システムは またはループバックIPアドレスを使用します localhost 。 SAP、 Java、 NetWeaver で特定のホスト名または IP アドレスを使用したい場合は、設定に `` host パラメータを含めることができます。

次の例は、設定にパラメータが host 追加される箇所を示しています:
# SAP Java Netweaver
com.instana.plugin.sap.java.netweaver:
 enabled: true
 local: # local monitoring configuration
  - host: 'host-1.com' # Optional, only required if you want to use a specific host name or IP address
    jmxport: '12345'
    user: 'User1'
    password: 'password'
    sysnr: '01'
    poll_rate: 60 # seconds

リモート構成

リモート監視の設定パラメータは、以下の例に示されています:

# SAP Java Netweaver 
com.instana.plugin.sap.java.netweaver # remote monitoring configuration 
  enabled: true
  remote : #multiple configurations supported
    - host: 'remote.host-1.com'
      jmxport: '23456'
      user: 'User1'
      password: 'password'
      sysnr: '72'
      poll_rate: 60 # seconds
    - host: 'remote.host-2.com'
      jmxport: '23456'
      user: 'User1'
      password: 'password'
      sysnr: '72'
      poll_rate: 60 # seconds
 

ファイル configuration.yaml 内で、、、 passwordjmxportuser 、および sysnrhost インスタンスID)に適切な値を入力してください。 メトリックのデフォルトのポーリング間隔は60秒に設定されています。

構成パラメーター

次の表は、 SAP Java NetWeaverセンサーの設定パラメータの一覧です:

パラメーター 説明
host センサーがメトリクスを取得する、 SAP、 Java、 NetWeaver インスタンスの IP アドレスまたは完全修飾ホスト名。
jmxport JMX エージェントとのリモート通信に使用されるポート。
sysnr SAP、 Java、 NetWeaver の各インスタンスのインスタンスID。例:01。
user SAP の Java インスタンスで設定されたユーザー名。 SAP のユーザーは、メトリクスを取得する権限を持っている必要があります。 詳細については、 「メトリクスの取得に関するユーザー認証の確認」 を参照してください。
password ユーザーが SAP、 Java、 NetWeaver システムにログインするために必要なパスワード。

メトリクスを取得するためのユーザー権限の確認

SAP NetWeaver システムのリモート監視を有効にするには、 SAP NetWeaver システムの Java Management Extensions ( JMX )で以下の手順を実行して設定してください:

  1. ブラウザから管理者として SAP NetWeaver システムにログインしてください。
  2. Go 「 SAP NetWeaver 」の「管理者」> 「構成 」>「 インフラストラクチャ 」>「 Java 」>「システムのプロパティ」>「 システム VM パラメータ 」へ。
  3. 以下のパラメータを追加してください:
    com.sun.management.jmxremote.port = 23456 
    com.sun.management.jmxremote.rmi.port = 23456 
    com.sun.management.jmxremote.ssl  = false 
    com.sun.management.jmxremote.authenticate = false 
     
    NetWeaver 役割
  4. 認証が必須の場合、以下のパラメータが次のように設定されている trueことを確認してください:

    com.sun.management.jmxremote.authenticate = true
注: ユーザーの認証は、 SAP Java NetWeaver システム上で行われます。 この「 Java 」 NetWeaver センサー configuration.yaml で指定されているのと同じユーザーおよびインスタンス ID に対するユーザー認証情報を提供する必要があります。

JMX のMBeanにアクセスするには、ユーザーには適切な権限が必要です。 ユーザーには、 SAP Java NetWeaver で利用可能なデフォルトのロール(例:、 GuestEveryone、または NWA_READONLY)のいずれか、あるいは作成済みのカスタムロールを割り当てることができます。 JMX を通じて必要なすべての指標が収集されるため、その JmxManageAll アクションが使用中のロールに割り当てられていることを確認してください。

以下の手順では説明のために「 Guest role」を使用していますが、他の割り当てられたロールについても手順は同様です:

  1. Go 「 SAP NetWeaver 」の「管理者」>「 設定 」>「 セキュリティ 」>「 ID管理 」へ。

  2. 役割 」で絞り込み、「 ゲスト 」を選択してください。

  3. [ 割り当てられたアクション ] タブで、 jmx を追加します。

    NetWeaver 役割

あるいは、ゲストの役割を変更する代わりに、対象のユーザーに必要な JMX の権限を割り当ててください。

メトリックの表示

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

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

インフラストラクチャ ビューでメトリクスを表示するには、以下の手順を実行してください:

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

収集されたすべてのメトリクスが表示されたダッシュボードは、 SAP、 Java、 NetWeaver でご覧いただけます。

プラットフォームの眺め

プラットフォームビューでメトリクスを表示するには、以下の手順を実行してください:

  1. Instana のUIにあるナビゲーションメニューから、 「Platform 」>「 SAP 」を選択します。 SAP のシステム、インスタンス、データベースは、それぞれ別のタブで確認できます。
  2. 「 Java 」の「 NetWeaver 」センサーに接続されている SAP インスタンスを表示するには、「 インスタンス 」タブをクリックします。 センサー名は通常、次のように表示 JavaNetWeaverInstance@HostName_SID_InstanceIDされます。
  3. SAP Java NetWeaver のインスタンスをクリックすると、収集されたすべてのメトリクスが表示されたダッシュボード( SAP Java NetWeaver )を確認できます。

収集されるメトリック

以下の表は、 Java ( NetWeaver )によって収集されるメトリクスと、その収集頻度をまとめたものです:

収集されたメトリクス 収集頻度
アプリケーションのタスク 60 秒
アプリケーションスレッド 60 秒
アプリケーションスレッドプール 60 秒
キャッシュ・ヒット率 60 秒
キャッシュ使用量 60 秒
クラス・ロード 60 秒
コンパイル時間 60 秒
CPU 60 秒
ディスク使用量 120 秒
GCコレクション 60 秒
GCエラー 60 秒
GCの問題 60 秒
GCレポート 60 秒
ヒープメモリと非ヒープメモリ 60 秒
HTTP 要求 60 秒
HTTP 応答 60 秒
JDBC 接続プール 60 秒
タイムアウトになったJDBC要求数 60 秒
JVM スレッド 60 秒
JVM CPU使用率 60 秒
JVM システム平均負荷 60 秒
ライセンスの有効期間 60 秒
ログ・メッセージ 60 秒
ログイン済みユーザー 60 秒
メモリー 60 秒
プロセス CPU 使用量 60 秒
RFC 60 秒
セッション数 60 秒
スワップ・スペース 60 秒
システム負荷の平均 60 秒
システムの問題 60 秒
テーブルバッファ 60 秒
スレッド数 60 秒
スレッド・プール使用量 60 秒
スレッド・タイム 60 秒
トランザクション数 60 秒
待機タスクの使用状況 60 秒
Webコンテナ・セッション 60 秒
Web コンテナー要求数 60 秒
Webコンテナ・スループット 60 秒
Web セッション数 60 秒
WebService 60 秒
アップタイム 60 秒

Java NetWeaver センサーは、さまざまなシナリオに対応した組み込みイベントを生成します。 詳細については、 「組み込みイベントのリファレンス」 を参照してください。

カスタムメトリクスの収集設定

Java の NetWeaver センサーを設定することで、標準メトリクスに加えて、ご自身の環境に特化したカスタムメトリクスを収集することができます。

たとえば、 SAP Java NetWeaver システムをリモートで監視しているとします。 Java メッセージサービス(JMS)に関連するメトリクスを収集するには、次の例に示すように、カスタムセクションでJMS関連情報を指定します

com.instana.plugin.sap.java.netweaver:
  enabled: true
  remote:
    - host: 'remote.host-1.com'
      jmxport: '23456'
      user: 'User1'
      password: 'password'
      sysnr: '72'
      poll_rate: 60 
  custom:
     jmxBeans:
       - name: JMS_CONNECTION_COUNT
         object: "com.sap.default:name=\"/Services/JMS/default/SessionContainer/Connections count\",j2eeType=SAP_MonitorPerNode,*"
         attribute: "Value"
       - name: JMS_CONSUMER_COUNT
         object: "com.sap.default:name=\"/Services/JMS/default/SessionContainer/Consumers count\",j2eeType=SAP_MonitorPerNode,*"
         attribute: "Value"
       - name: JMS_PRODUCER_COUNT
         object: "com.sap.default:name=\"/Services/JMS/default/SessionContainer/Producers count\",j2eeType=SAP_MonitorPerNode,*"
         attribute: "Value"