ABAP エージェントは他の AppDynamics エージェントに接続して、SAP システムの可視性を高めることができます。

AppDynamics マシンエージェントへの接続

リリース 20.11.0 では、HTTP SDK を使用して、アプリケーション イベント レポート用のマシンエージェント HTTP リスナーを置き換えることができます。詳細については、「分析 API アダプタ」を参照してください。

コントローラに SAP イベントをレポートするには、AppDynamics スタンドアロン マシン エージェントを使用します。マシンエージェントはすべてのアプリケーションサーバーで実行され、CPU、メモリ、ディスク、ネットワーク使用率などの基本的なハードウェアメトリックを収集します。SAP システムは HTTP を介してマシンエージェントと通信するため、マシンエージェントで HTTP リスナーを有効にする必要があります。詳細については、「マシンエージェント HTTP リスナー」を参照してください。

AppDynamics マシンエージェントに接続するには、次の手順を実行します。

  1. 次のトランザクションに移動します:/DVD/APPD_CUST
  2. 編集モードに切り替え、次の場所にマシンエージェントポートを入力します:Other agents

マシンエージェントホストは、SAP アプリケーションサーバーのホスト名に自動的に設定されます。マシンエージェントポートは、デフォルトで 8293 に設定されています。マシンエージェントの HTTP リスナーが別のポートで実行されている場合は、値をそのポート番号に変更します。

コントローラは、一意のホスト ID を使用して、マシンエージェントを HTTP SDK(C ++ SDK)に自動的にリンクします。場合によっては、この値が一致せず、マシンエージェントで HTTP SDK によって使用される値にオーバーライドする必要があります。「ユニークホスト ID」を参照してください。

HTTP SDK で使用される値は、[Unique Host ID] 列の [Controller] > [Controller Settings ] > [ AppDynamics Agents] で確認できます。

マシンエージェントの構成または起動パラメータでは、[Node Name] パラメータを使用しないでください。このパラメータを使用すると、HTTP SDK(C++ SDK)インスタンスがコントローラに正しく登録されないことがあります。マシンエージェントのインスタンスを HTTP SDK(C++ SDK)インスタンスに自動的に関連付けるには、上記の [Unique Host ID] の方法を使用してください。

AppDynamics イベントサービスと分析への接続


リリース 20.11.0 では、整合分析 API アダプタを使用できます。元の(レガシー)アダプタは、引き続き SAP データをカスタム分析スキーマに複製するためのデフォルトアダプタとして使用されますが、この新しいバージョンのすべての利点を得るために、整合アダプタバージョンへの切り替えまたは移行をお勧めします。レガシーアダプタは、将来の ABAP エージェントのリリースで段階的に廃止されます。

詳細については、「分析 API アダプタ」を参照してください。

AppDynamics 分析イベント API アカウントに接続して、分析イベント API にデータを送信します。AppDynamics コントローラのグローバルアカウント名は、[Controller Settings ] > [ Licenses ] > [ Account] で確認できます。

AppDynamics イベントサービスと分析に接続するには、次の手順を実行します。

  1. デフォルト値を使用できない場合、[host name] と [port] を調整します。

    Host name は、プレフィックス http:// または https:// で始まる必要があります。

  2. 次の権限を持つ API キーを生成します。API キーの作成」を参照してください。
    1. すべてのカスタム分析イベントの権限
    2. ログ権限:すべてのログをクエリ可能

    トランザクション分析ライセンスは、分析イベント API を使用する場合に必要です。

  3. [Analytics events API settings] ウィンドウの [Key] フィールドに、生成した API キーを入力します。


  4. レガシーまたは整合分析 API アダプタのバージョンを選択します。「分析 API アダプタ」を参照してください。

  5. (オプション)分析イベント API との SSL 通信が必要な場合は、次の手順を実行します。

    1. ホスト名の先頭を http:// から https:// に変更します
    2. オンプレミスのイベント分析サーバーを使用する場合は、ポートを 443 に変更するか、SSL ポートを使用します
    3. Web ブラウザでイベントサービス URL を開き、/_ping を追加します。すべての公開証明書をダウンロードし、証明書を SAP にインポートします。
    4. [Additional SSL settings] の下の [STRUST SSL identity] フィールドで、証明書がアップロードされている STRUST SSL アイデンティティを選択します。

分析エージェントへの接続

一般に、分析エージェントとトランザクション分析は、AppDynamics 分析イベント API を使用して複製されたカスタム分析データから独立しています。分析イベント API の設定分析 API アダプタは、トランザクション分析と分析エージェントの設定に影響を与えません。その逆も同様です。

マシンエージェントにバンドルされている AppDynamics 分析エージェントを使用して、イベントサービスへのビジネス トランザクション レポートを有効にできます。「Deploy Analytics With the Analytics Agent」も参照してください。

デフォルトでは、トランザクション分析はオフになっています。[Transaction analytics is active] フラグが設定されている場合、HTTP SDK が再起動されると、デフォルトのポート 9090 を介して、同じサーバーで実行されているアクティブな分析エージェントインスタンスに自動的に接続します。分析エージェントインスタンスが使用できない場合、HTTP SDK は正常に動作しますが、ビジネストランザクション分析データは使用できません。

集中型分析エージェントを使用する場合は、[Other agents ] のデフォルトの分析エージェントのホスト名とポートを変更できます。

[Other agents] 設定でトランザクション分析をアクティブにすると、[Transaction analytics replication] で t-code /DVD/APPD_STATUS を使用して分析エージェントの接続の可用性および接続をモニターできます。

トラブルシューティング

接続に関する問題

  • SSL Error

    • SSL 通信が使用されているが、証明書が見つからないか正しくない場合に発生します。

    • それぞれの API またはエージェントでエラーが発生する可能性があります。

      • Event Service

        • Web ブラウザを使用して、分析 API コントローラの URL(例:https://analytics.api.appdynamics.com/)に移動します。

        • このガイドを使用して証明書をダウンロードします。

        • このガイドに従って、ダウンロードした証明書をトランザクション /DVD/APPD_CUST で使用している STRUST アイデンティティに追加します。トランザクション /DVD/APPD_CUST の STRUST アイデンティティが入力されていない場合は、DFAULT STRUST アイデンティティが使用されます。

  • Event Service

    • 接続失敗 - アクセスの禁止

      • イベントサービス用に生成された API キーに十分な権限がありません。

      • [Controller] > [Analytics] > [Configuration] > [API keys] に移動します。

      • トランザクション /DVD/APPD_CUST で使用しているキーを探します。

      • [Edit] をクリックし、すべてのノードを展開し、すべてのチェックボックスをオンにします。

  • Machine Agent

    • マシンエージェントは実行されているが、ABAP エージェントがマシンエージェントに到達できない

      • マシンエージェントが有効な HTTP リスナーを使用して開始されたことを確認します。

      • /DVD/APPD_CUST トランザクションで正しいポート(デフォルトは 8293)を使用していることを確認します。

    • マシンエージェントがコントローラで HTTP SDK と関連付けられていない

      • マシンエージェント設定の一意のホスト ID 値は、HTTP SDK が使用する値と同じである必要があります。これは自動的に行われますが、不一致が発生し、手動で処理する必要がある場合があります。一意のホスト ID は、このガイドに従って変更できます。一意のホスト ID を変更した後、変更を有効にするには、マシンエージェントを忘れずに再起動してください。

  • Analytics Agent

    • 分析エージェントは実行されているが、ABAP エージェントに検出されない

      • ホストとポートが正しく設定されており、トランザクション /DVD/APPD_CUST でトランザクション分析が有効になっていることを確認します。

      • 分析エージェントが実行されているホストに HTTP SDK ホストから到達可能であることを確認します。

      • HTTP SDK は、分析エージェント/トランザクション分析の設定後に再起動する必要があります。