Download PDF
Download page AppDynamics エージェントへの接続.
AppDynamics エージェントへの接続
On this page:
Related pages:
ABAP エージェントは他の AppDynamics エージェントに接続して、SAP システムの可視性を高めることができます。
AppDynamics マシンエージェントへの接続
リリース 20.11.0 では、HTTP SDK を使用して、アプリケーション イベント レポート用のマシンエージェント HTTP リスナーを置き換えることができます。詳細については、「分析 API アダプタ」を参照してください。
コントローラに SAP イベントをレポートするには、AppDynamics スタンドアロン マシン エージェントを使用します。マシンエージェントはすべてのアプリケーションサーバーで実行され、CPU、メモリ、ディスク、ネットワーク使用率などの基本的なハードウェアメトリックを収集します。SAP システムは HTTP を介してマシンエージェントと通信するため、マシンエージェントで HTTP リスナーを有効にする必要があります。詳細については、「マシンエージェント HTTP リスナー」を参照してください。
AppDynamics マシンエージェントに接続するには、次の手順を実行します。
- 次のトランザクションに移動します:
/DVD/APPD_CUST
- 編集モードに切り替え、次の場所にマシンエージェントポートを入力します: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 イベントサービスと分析に接続するには、次の手順を実行します。
デフォルト値を使用できない場合、[host name] と [port] を調整します。
Host name は、プレフィックス http:// または https:// で始まる必要があります。
- 次の権限を持つ API キーを生成します。「API キーの作成」を参照してください。
- すべてのカスタム分析イベントの権限
- ログ権限:すべてのログをクエリ可能
トランザクション分析ライセンスは、分析イベント API を使用する場合に必要です。
- [Analytics events API settings] ウィンドウの [Key] フィールドに、生成した API キーを入力します。
レガシーまたは整合分析 API アダプタのバージョンを選択します。「分析 API アダプタ」を参照してください。
(オプション)分析イベント API との SSL 通信が必要な場合は、次の手順を実行します。
- ホスト名の先頭を
http://
からhttps://
に変更します - オンプレミスのイベント分析サーバーを使用する場合は、ポートを
443,
に変更するか、SSL ポートを使用します - Web ブラウザでイベントサービス URL を開き、/_ping を追加します。すべての公開証明書をダウンロードし、証明書を SAP にインポートします。
- [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 は、分析エージェント/トランザクション分析の設定後に再起動する必要があります。