AppDynamics エージェントへの接続

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 によって使用される値は Controller > Controller Settings > AppDynamics Agents の列にある [Unique Host ID] 列で確認できます。

警告: マシンエージェントの構成または起動パラメータでは、[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. デフォルト値を使用できない場合は、ホスト名とポートを調整します。

    注: ホスト名 は、プレフィックス http:// または https:// で始まる必要があります。
  2. 次の権限を持つ API キーを生成します。「API キーの作成」を参照してください。
    1. すべてのカスタム分析イベントの権限
    2. ログ権限：すべてのログをクエリ可能
    警告: トランザクション分析ライセンスは、分析イベント API を使用する場合に必要です。
  3. [Analytics events API settings] ウィンドウの [Key] フィールドに、生成した API キーを入力します

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

    注: リリース 24.8.0 以降、新しいインストールではレガシー分析アダプタを使用できなくなりました。レガシー分析アダプタを使用しているユーザは 整合に切り替えることができますが、その逆に切り替えることはできません。
    注: レガシー分析アダプタは間もなく廃止れるため、整合アダプタに移行することをお勧めします。 「整合アダプタへの移行」 と 「分析ダッシュボードとメトリックの移行」 を参照してください。

  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 分析エージェントを使用して、イベントサービスへのビジネス トランザクション レポートを有効にできます。「Analytics エージェントを使用した分析の展開」も参照してください。

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

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

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

トラブルシューティング

接続に関する問題

  • SSLエラー

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

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

      • イベント サービス

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

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

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

  • イベント サービス

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

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

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

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

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

  • マシンエージェント

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

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

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

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

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

  • 分析エージェント

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

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

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

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