API モニタリング機能は、アプリケーションの API 呼び出しの詳細をモニタリングするために使用されます。API 呼び出しは、SQL 分析、NoSQL 分析、例外分析、およびエラー分析を実行したり、アップストリームおよびダウンストリームデータを送信したり、トレースをクエリしたりするために発行できます。このトピックでは、Serverless App Engine (SAE) アプリケーションの API 呼び出しの詳細を表示する方法について説明します。
手順
SAE コンソール にログインします。左側のナビゲーションウィンドウで、 を選択します。表示されるページで、トップナビゲーションバーでリージョンを選択し、[名前空間] ドロップダウンリストから名前空間を選択し、目的のアプリケーション名をクリックします。
左側のナビゲーションウィンドウで、 を選択します。
[API 呼び出し] ページの左側のペインには、モニタリングエージェントによって自動的に検出されたすべての API 呼び出しが表示されます。応答時間 (RT)、リクエスト数、エラー数、または例外数で API 呼び出しをソートできます。
説明メトリクスはプログラミング言語によって異なります。ビジネス要件に基づいて、プログラミング言語のアプリケーションモニタリングメトリクスを表示できます。
サポートされているフレームワーク
この機能は、以下の Web フレームワークおよびリモートプロシージャコール (RPC) フレームワークで提供されるインターフェイスを自動的に検出してモニタリングできます。
Tomcat 7+
Jetty 8+
Resin 3.0+
Undertow 1.3+
WebLogic 11.0+
SpringBoot 1.3.0+
HSF 2.0+
Dubbo 2.5+
メトリクスのカテゴリ
概要
[概要] タブでは、インターフェイスの詳細な呼び出しトポロジーと、リクエスト数、エラー数、応答時間、および HTTP ステータスコードに関する時系列曲線を表示できます。
SQL 分析と NoSQL 分析
[SQL 分析] タブと [NoSQL 分析] タブでは、[API 操作呼び出し] ページの左側のペインで選択した API 操作のコード内で開始された SQL リクエストと NoSQL リクエストを表示できます。これらのタブでは、API の応答が遅い原因となっている SQL 文または NoSQL 文を見つけることができます。また、SQL 文または NoSQL 文の [アクション] 列にある [トレースクエリ] をクリックして、SQL または NoSQL の実行ロジックが存在する完全なトレースを表示することもできます。
例外分析
[例外分析] タブには、左側のペインで選択したインターフェイスのコードからスローされた Java 例外が表示されます。また、[アクション] 列の [インターフェイススナップショット] をクリックして、例外スタックが存在する完全なトレースを表示することもできます。詳細については、「トレースを表示する」をご参照ください。
アップストリームサービスとダウンストリームサービス
[アップストリームサービス] タブと [ダウンストリームサービス] タブでは、アプリケーションを呼び出すアップストリームサービスと、アプリケーションによって呼び出されるダウンストリームサービスのインターフェイスとパフォーマンスメトリクスを表示できます。パフォーマンスメトリクスには、応答時間、リクエスト数、エラー数が含まれます。
[アップストリームトレース] タブと [ダウンストリームトレース] タブでは、ビジネス要件に基づいて次の操作を実行できます。
タブの上部にある [すべて展開/折りたたむ] をクリックして、すべてのインターフェイスを表示または非表示にします。
検索ボックスにアプリケーション名またはインターフェイス名のキーワードを入力し、検索アイコンをクリックして、名前にキーワードが含まれるインターフェイスを検索します。
インターフェイスのパフォーマンスメトリクスに関する情報を表示または非表示にする場合は、インターフェイスを見つけて折りたたみパネルをクリックするか、行末にある上向き矢印または下向き矢印をクリックします。
エラー分析
[エラー分析] タブでは、アプリケーションのエラーと HTTP ステータスコードを表示できます。また、[TraceId] 列の値をクリックして、新しいページにトレース情報を表示することもできます。詳細については、「トレースを表示する」をご参照ください。
トレースクエリ
[インターフェイススナップショット] タブでは、選択したインターフェイスのパラメーターと、パラメーターに基づいて生成された 2 つのグラフを表示できます。グラフには、インターフェイス呼び出しの総数とインターフェイス呼び出しの RT に関する統計が表示されます。
[合計トレース] グラフには、インターフェイス呼び出しの総数と低速インターフェイス呼び出しの数が表示されます。インターフェイス呼び出しの RT が 500 ミリ秒を超える場合、インターフェイス呼び出しは低速インターフェイス呼び出しとして定義されます。しきい値はアプリケーション設定で構成できます。低速インターフェイス呼び出しの数には、非同期シナリオで生成されるローカルインターフェイス呼び出しは含まれません。
インターフェイス応答時間グラフには、RT の経時変化が表示されます。グラフは、インターフェイス呼び出しの統計に基づいて生成され、指定したサンプリングレートの影響を受けます。
トレース詳細テーブルには、詳細なトレース情報が表示されます。[TraceId] 列の値をクリックして、トレース情報を表示できます。詳細については、「呼び出しリンク詳細」をご参照ください。
[アクション] 列の [ログを表示] をクリックして、インターフェイス呼び出しのログを表示することもできます。
説明トレース ID をアプリケーションのビジネスログに関連付ける必要があります。こうすることで、アプリケーションでエラーが発生した場合、トレース ID に関連付けられているビジネスログにアクセスしてエラーをトラブルシューティングできます。詳細については、「Java アプリケーションのログにトレース ID を関連付ける」をご参照ください。