アプリのパフォーマンス・ダッシュボードを拡張する
注釈：本資料はAI技術を用いて翻訳されています。
Overview
AccelByte Gaming Services (AGS) Extend Observability を使用すると、Grafana Cloud ダッシュボードにアクセスし、Extend アプリのパフォーマンス・メトリクスの概要を確認できます。これらのダッシュボードを使用すると、詳細なログやメトリクスを個別に確認しなくても、各 Extend アプリの稼働状況を素早く把握できるため、発生した問題を早期に発見し、トラブルシューティングをより効率的に行えます。
このドキュメントでは、ダッシュボードへのアクセス方法、表示される情報、およびその情報の活用例について説明します。
前提条件
AGS Extend Observability ダッシュボードを使用するには、少なくとも 1 つの AGS Extend アプリ（Override、Service Extension、または Event Handler）を設定し、AGS と統合しておく必要があります。
ダッシュボードへのアクセス
Extend アプリのダッシュボードにアクセスするには、Observability の概要 の手順を使用します。Grafana Cloud にログインしたら、次の手順を実行します。
-
サイドバーの Dashboards をクリックします。
-
検索バーで「Extend dashboard」を検索します。利用可能な Extend ダッシュボードがリストに表示されます。
-
表示したいダッシュボードをクリックします。
All Extend Apps Performance ダッシュボード
All Extend Apps Performance ダッシュボードには、すべてのゲームネームスペースにおける AGS Extend アプリのパフォーマンス・メトリクスを示すパネルのセクションが含まれています。特定のゲームネームスペースの Extend アプリのデータを表示するには、ダッシュボード上部の Game Namespace フィルターを使用します。また、アプリ ID、名前、シナリオなどのデフォルトフィルターやカスタムフィルターを適用して、ダッシュボードに表示されるデータを絞り込むこともできます。
生成したいデータの期間も必ず指定してください。期間設定はダッシュボードの右上にあり、デフォルトでは過去 30 分に設定されています。
All Extend Apps Performance ダッシュボードには、以下のパネルが含まれています。
Overview セクション
このセクションのパネルは、すべての Extend アプリの一般的な情報と基本的なパフォーマンス・メトリクスを表示します。
Total Game Namespace パネル
アクティブにデプロイされたイメージを持つ Extend アプリが存在するゲームネームスペースの総数を表示します。
Total App パネル
アクティブにデプロイされたイメージを持つ Extend アプリの総数を表示します。
App Information パネル
アクティブにデプロイされたイメージを持つすべての Extend アプリを一覧表示し、各アプリの ID、名前、元となるゲームネームスペース、および Extend シナリオ（またはアプリタイプ）を表示します。
Deployment Duration パネル
Extend アプリのデプロイメントを一覧表示し、各デプロイメントの日付、時間、および所要時間を表示します。
Failed Deployment (count) パネル
イメージデプロイメントの失敗回数が最も多い上位 3 つの Extend アプリを表示します。
Timeout Deployment (count) パネル
デプロイメントのタイムアウト時間の上限を超えたイメージデプロイメントの試行回数が最も多い上位 3 つの Extend アプリを表示します。
CPU Usage (service) パネル
指定した期間内の CPU 使用量を示すグラフを表示します。グラフにカーソルを合わせると、具体的な使用量と時間の詳細を確認できます。
Memory Usage (service) パネル
Extend アプリのメモリ使用量を示すグラフを表示します。グラフにカーソルを合わせると、具体的な使用量と時間の詳細を確認できます。
Replica Count & Limit パネル
アクティブにデプロイされたイメージを持つ Extend アプリのレプリカ数を示すグラフを表示します。
Total Service Error Logs パネル
アクティブにデプロイされたイメージを持つすべての Extend アプリから生成されたサービスエラーログの数を示すグラフを表示します。
Service Error Logs パネル
アクティブにデプロイされたイメージを持つすべての Extend アプリから生成された最新 20 件のサービスエラーログを一覧表示します。
Overridable feature セクション
このセクションのパネルは、Extend Override アプリに特化したパフォーマンス情報を表示します。
Received Rate パネル
Extend Override アプリから AGS が受信したリクエストのレートです。
Response Rate per Status Code パネル
AGS が Extend Override アプリに対して行ったレスポンスのレートを、gRPC ステータスコード別に分類して表示します。
Response Latency パネル
AGS が Override アプリからリクエストを受信してから、レスポンスを送信するまでの遅延時間（ミリ秒）を示すグラフです。
Event Handler セクション
このセクションのパネルは、Extend Override アプリに特化したパフォーマンス情報を表示します。
Record Read Total パネル
Event Handler アプリがリッスンした Kafka Connect イベントの数を示すグラフです。
Records Consumed Rate パネル
Event Handler アプリがリッスンして消費した Kafka Connect イベントの数を示すグラフです。
Records Lag パネル
リクエスト時に処理に失敗したイベントの数です。
Service Extension セクション
このセクションのパネルは、Service Extension アプリに特化したパフォーマンス情報を表示します。
Request Success Rate/5m (Linkerd) パネル
Event Handler アプリから AGS バックエンドへの、5 分あたりの HTTP リクエスト成功率を示すグラフです。
Response Latency パネル
AGS が Override アプリからリクエストを受信してから、レスポンスを送信するまでの遅延時間（ミリ秒）を示すグラフです。
5xx/5m (Linkerd) パネル
ステータスコードが 400〜499 の間で完了した HTTP レスポンス（サーバーエラーレスポンス）の数で、AGS バックエンドの一時的な問題を示しています。
Event Handler ダッシュボード
Event Handler (EH) ダッシュボードには、AGS Extend Event Handler アプリのパフォーマンス・メトリクスを示すパネルのセクションが含まれています。
特定の Event Handler アプリのデータを表示するには、ダッシュボード上部で環境とゲームネームスペースを設定します。次に、App ドロップダウンから表示したいアプリを選択します。選択したアプリのデータがダッシュボードに表示されます。
各セクションに含まれるパネルとその情報の説明は以下を参照してください。
EH Overview セクション
このセクションのパネルは、アプリの一般的な情報と基本的なパフォーマンス・メトリクスを表示します。
このセクションの具体的なパネル情報は以下を参照してください。
EH App Information パネル
一般的なアプリ情報です。
- App ID: コード内で使用されるこのアプリの ID。
- App: アプリの名前。
- Game Namespace: このアプリが属するゲームネームスペース。
- Extend Scenario: AGS Extend アプリのタイプ（
event-handler、function-override、またはservice-extension）
EH App Creation Duration パネル
選択したアプリの作成にかかった時間（分単位）です。
EH Deployment Duration パネル
選択したアプリのイメージデプロイメントに関連する情報です。各項目は、新しくデプロイされたイメージバージョンを表します。
- deployment_time: イメージがデプロイされた日時。
- deployment_id: デプロイされたイメージの ID。
- deployment_duration: このイメージのデプロイにかかった時間（秒単位）。
このパネルの情報を使用して、イメージデプロイメントの問題をトラブルシューティングできます。たとえば、特定のイメージがデプロイされたときにパフォーマンスが低下し始めた場合や、特定のイメージの deployment_duration が他のデプロイメントより長くかかった場合は、そのイメージに問題がないか調査する価値があります。イメージに問題が見つからない場合は、AccelByte サポートに問い合わせてください。
EH Failed Deployment (count) パネル
失敗したイメージデプロイメントの試行回数です。
失敗したデプロイメントの試行回数が多い場合は、イメージデプロイメントプロセスに問題があることを示している可能性があります。問題の原因が見つからない場合は、AccelByte サポートに問い合わせてください。
EH Timeout Deployment (count) パネル
デプロイメントのタイムアウト時間の上限を超えたイメージデプロイメントの試行回数です。
イメージのデプロイに時間がかかりすぎる傾向がある場合は、デプロイメントプロセスに非効率なロジックがある可能性があります。問題の原因が見つからない場合は、AccelByte サポートに問い合わせてください。
EH Replica Count & Limit パネル
選択した Extend アプリに対して作成されたレプリカの数と、作成可能なレプリカの最大数です。レプリカはアプリで利用可能なリソースを増加させます。このアプリの CPU またはメモリ使用率が 80% を超えると、新しいレプリカが作成されます。
レプリカ数がレプリカ制限に近づいている場合は、AccelByte サポートに問い合わせて、レプリカ制限の引き上げについて相談したり、リソース使用率を削減するためのサポートを受けたりできます。
EH Container OOMKilled per Replica パネル
Out of Memory Killed (OOMKilled)。メモリ不足のために停止または強制終了されたレプリカの一覧です。
EH Service Container CPU Usage パネル
選択した期間内の CPU 使用量を示すグラフです。グラフにカーソルを合わせると、具体的な使用量と時間の詳細を確認できます。
このグラフは選択したアプリの CPU 使用量のみを表示します。他のアプリやサービスとの集計値ではありません。
EH Service Container Memory Usage パネル
選択した期間内のメモリ使用量を示すグラフです。グラフにカーソルを合わせると、具体的な使用量と時間の詳細を確認できます。
このグラフは選択したアプリのメモリ使用量のみを表示します。他のアプリやサービスとの集計値ではありません。
EH Total Service Error Logs パネル
選択した期間内に生成されたエラーログの数を示すグラフです。特定の時間にカーソルを合わせると、その時点で生成されたログの数を確認できます。
これを使用して、エラーが多く発生し始めた時間を確認できます。問題の原因が見つからない場合は、AccelByte サポートに問い合わせてください。
EH Service Error Logs パネル
生成された最新 20 件のエラーログです。
これにより、最新のエラーログを確認できるため、現在の問題を解決するのに役立ちます。問題の原因が見つからない場合は、AccelByte サポートに問い合わせてください。
EH Kafka Connect セクション
このセクションのパネルは、Kafka Connect とイベントの消費に関連する情報を表示します。
このセクションの具体的なパネル情報は以下を参照してください。
EH Partition Count パネル
特定の時点でこのアプリに割り当てられたトピックパーティション（またはイベントソース）の数を示すグラフです。
EH Record Read Total パネル
特定の時点でこのアプリがリッスンした Kafka Connect イベントの数を示すグラフです。
この情報を使用して、アプリが多くのリクエストを受け取る時間帯を確認でき、トラブルシューティングとエラー防止に役立ちます。
EH Records Consumed Rate パネル
特定の時点でこのアプリがリッスンして消費した Kafka Connect イベントの数を示すグラフです。
消費レートがレコード読み取り数と一致していない場合は、ロジックの問題またはリソース不足を示している可能性があります。問題の原因が見つからない場合は、AccelByte サポートに問い合わせてください。
EH Records Lag パネル
リクエスト時に処理できなかったイベントの数です。
レコードにラグが発生する傾向がある場合は、アプリへのリクエストの需要を処理するためのリソースが不足していることを示している可能性があります。AccelByte サポートに問い合わせて、アプリへのリソースの追加割り当てについて相談できます。
Overridable Features ダッシュボード
Overridable Features (OF) ダッシュボードには、AGS Extend Override アプリのパフォーマンス・メトリクスを示すパネルのセクションが含まれています。
特定の Extend Override アプリのデータを表示するには、ダッシュボード上部で環境とゲームネームスペースを設定します。次に、App ドロップダウンから表示したいアプリを選択します。選択したアプリのデータがダッシュボードに表示されます。
各セクションに含まれるパネルとその情報の説明は以下を参照してください。
OF Overview セクション
このセクションのパネルは、アプリの一般的な情報と基本的なパフォーマンス・メトリクスを表示します。
このセクションの具体的なパネル情報は以下を参照してください。
OF App Information パネル
一般的なアプリ情報です。
- App ID: コード内で使用されるこのアプリの ID。
- App: アプリの名前。
- Game Namespace: このアプリが属するゲームネームスペース。
- Extend Scenario: AGS Extend アプリのタイプ（
event-handler、function-override、またはservice-extension）
OF App Creation Duration パネル
選択したアプリの作成にかかった時間（分単位）です。
OF Deployment Duration パネル
選択したアプリのイメージデプロイメントに関連する情報です。各項目は、新しくデプロイされたイメージバージョンを表します。
- deployment_time: イメージがデプロイされた日時。
- deployment_id: デプロイされたイメージの ID。
- deployment_duration: このイメージのデプロイにかかった時間（秒単位）。
このパネルの情報を使用して、イメージデプロイメントの問題をトラブルシューティングできます。たとえば、特定のイメージがデプロイされたときにパフォーマンスが低下し始めた場合や、特定のイメージの deployment_duration が他のデプロイメントより長くかかった場合は、そのイメージに問題がないか調査する価値があります。イメージに問題が見つからない場合は、AccelByte サポートに問い合わせてください。
OF Failed Deployment (count) パネル
失敗したイメージデプロイメントの試行回数です。
失敗したデプロイメントの試行回数が多い場合は、イメージデプロイメントプロセスに問題があることを示している可能性があります。問題の原因が見つからない場合は、AccelByte サポートに問い合わせてください。
OF Timeout Deployment (count) パネル
デプロイメントのタイムアウト時間の上限を超えたイメージデプロイメントの試行回数です。
イメージのデプロイに時間がかかりすぎる傾向がある場合は、デプロイメントプロセスに非効率なロジックがある可能性があります。問題の原因が見つからない場合は、AccelByte サポートに問い合わせてください。
OF Replica Status
選択したアプリのレプリカのステータスを表示します。
OF Replica Count & Limit パネル
選択した Extend アプリに対して作成されたレプリカの数と、作成可能なレプリカの最大数です。レプリカはアプリで利用可能なリソースを増加させます。このアプリの CPU またはメモリ使用率が 80% を超えると、新しいレプリカが作成されます。
レプリカ数がレプリカ制限に近づいている場合は、AccelByte サポートに問い合わせて、レプリカ制限の引き上げについて相談したり、リソース使用率を削減するためのサポートを受けたりできます。
OF Container OOMKilled per Replica パネル
Out of Memory Killed (OOMKilled)。メモリ不足のために停止または強制終了されたレプリカの一覧です。
OH Service Container CPU Usage
選択した期間内の CPU 使用量を示すグラフです。グラフにカーソルを合わせると、具体的な使用量と時間の詳細を確認できます。
このグラフは選択したアプリの CPU 使用量のみを表示します。他のアプリやサービスとの集計値ではありません。
OH Service Container Memory Usage
選択した期間内のメモリ使用量を示すグラフです。グラフにカーソルを合わせると、具体的な使用量と時間の詳細を確認できます。
このグラフは選択したアプリのメモリ使用量のみを表示します。他のアプリやサービスとの集計値ではありません。
OF Total Service Error Logs パネル
選択した期間内に生成されたエラーログの数を示すグラフです。特定の時間にカーソルを合わせると、その時点で生成されたログの数を確認できます。
これを使用して、エラーが多く発生し始めた時間を確認できます。問題の原因が見つからない場合は、AccelByte サポートに問い合わせてください。
OF Service Error Logs パネル
生成された最新 20 件のエラーログです。
これにより、最新のエラーログを確認できるため、現在の問題を解決するのに役立ちます。問題の原因が見つからない場合は、AccelByte サポートに問い合わせてください。
OF gRPC セクション
このセクションのパネルは、gRPC リクエストとレスポンスに関連する情報を表示します。
このセクションの具体的なパネル情報は以下を参照してください。
OF Response Rate パネル
選択した Extend アプリが受信したリクエストに対して AGS が行ったレスポンスの数です。
受信レートとレスポンスレートに差異がある場合は、AGS バックエンドの一時的な問題を示している可能性があります。この場合は、詳細情報について AccelByte サポートに問い合わせてください。
OF Response Rate per Status Code パネル
AGS が選択した Extend アプリに対して行ったレスポンスのレートを、gRPC ステータスコード別に分類して表示します。
この数値を使用して、想定している Extend アプリからのリクエスト数と、AGS がステータスコード別に受信した数を比較できます。差異がある場合は、問題を調査してください。原因を特定できない場合は、AccelByte サポートに問い合わせてください。
OF Response Latency パネル
AGS が選択した Extend アプリからリクエストを受信してから、レスポンスを送信するまでの遅延時間（ミリ秒）を示すグラフです。
レスポンス時間に大きな遅延がある場合は、AGS バックエンドの一時的な速度低下を示している可能性があります。この場合は、詳細情報について AccelByte サポートに問い合わせてください。
OF Received Rate パネル
選択した Extend アプリから AGS が受信したリクエストのレートです。
この数値を使用して、想定している Extend アプリからのリクエスト数と、AGS が受信した数を比較できます。差異がある場合は、問題を調査してください。原因を特定できない場合は、AccelByte サポートに問い合わせてください。
Service Extension ダッシュボード
Service Extension (SE) ダッシュボードには、AGS Extend Service Extension アプリのパフォーマンス・メトリクスを示すパネルのセクションが含まれています。
特定の Service Extension アプリのデータを表示するには、ダッシュボード上部で環境とゲームネームスペースを設定します。次に、App ドロップダウンから表示したいアプリを選択します。選択したアプリのデータがダッシュボードに表示されます。
各セクションに含まれるパネルとその情報の説明は以下を参照してください。
SE Overview セクション
このセクションのパネルは、アプリの一般的な情報と基本的なパフォーマンス・メトリクスを表示します。
このセクションの具体的なパネル情報は以下を参照してください。
SE App Information パネル
一般的なアプリ情報です。
- App ID: コード内で使用されるこのアプリの ID。
- App: アプリの名前。
- Game Namespace: このアプリが属するゲームネームスペース。
- Extend Scenario: AGS Extend アプリのタイプ（
event-handler、function-override、またはservice-extension）
SE App Creation Duration パネル
選択したアプリの作成にかかった時間（分単位）です。
SE Deployment Duration パネル
選択したアプリのイメージデプロイメントに関連する情報です。各項目は、新しくデプロイされたイメージバージョンを表します。
- deployment_time: イメージがデプロイされた日時。
- deployment_id: デプロイされたイメージの ID。
- deployment_duration: このイメージのデプロイにかかった時間（秒単位）。
このパネルの情報を使用して、イメージデプロイメントの問題をトラブルシューティングできます。たとえば、特定のイメージがデプロイされたときにパフォーマンスが低下し始めた場合や、特定のイメージの deployment_duration が他のデプロイメントより長くかかった場合は、そのイメージに問題がないか調査する価値があります。イメージに問題が見つからない場合は、AccelByte サポートに問い合わせてください。
SE Failed Deployment (count) パネル
失敗したイメージデプロイメントの試行回数です。
失敗したデプロイメントの試行回数が多い場合は、イメージデプロイメントプロセスに問題があることを示している可能性があります。問題の原因が見つからない場合は、AccelByte サポートに問い合わせてください。
SE Timeout Deployment (count) パネル
デプロイメントのタイムアウト時間の上限を超えたイメージデプロイメントの試行回数です。
イメージのデプロイに時間がかかりすぎる傾向がある場合は、デプロイメントプロセスに非効率なロジックがある可能性があります。問題の原因が見つからない場合は、AccelByte サポートに問い合わせてください。
SE Replica Status
選択したアプリのレプリカのステータスを表示します。
SE Replica Count & Limit パネル
選択した Extend アプリに対して作成されたレプリカの数と、作成可能なレプリカの最大数です。レプリカはアプリで利用可能なリソースを増加させます。このアプリの CPU またはメモリ使用率が 80% を超えると、新しいレプリカが作成されます。
レプリカ数がレプリカ制限に近づいている場合は、AccelByte サポートに問い合わせて、レプリカ制限の引き上げについて相談したり、リソース使用率を削減するためのサポートを受けたりできます。
SE Container OOMKilled per Replica パネル
Out of Memory Killed (OOMKilled)。メモリ不足のために停止または強制終了されたレプリカの一覧です。
SE Service Container CPU Usage
選択した期間内の CPU 使用量を示すグラフです。グラフにカーソルを合わせると、具体的な使用量と時間の詳細を確認できます。
このグラフは選択したアプリの CPU 使用量のみを表示します。他のアプリやサービスとの集計値ではありません。
SE Service Container Memory Usage
選択した期間内のメモリ使用量を示すグラフです。グラフにカーソルを合わせると、具体的な使用量と時間の詳細を確認できます。
このグラフは選択したアプリのメモリ使用量のみを表示します。他のアプリやサービスとの集計値ではありません。
SE Total Service Error Logs パネル
選択した期間内に生成されたエラーログの数を示すグラフです。特定の時間にカーソルを合わせると、その時点で生成されたログの数を確認できます。
これを使用して、エラーが多く発生し始めた時間を確認できます。問題の原因が見つからない場合は、AccelByte サポートに問い合わせてください。
SE Service Error Logs パネル
生成された最新 20 件のエラーログです。
これにより、最新のエラーログを確認できるため、現在の問題を解決するのに役立ちます。問題の原因が見つからない場合は、AccelByte サポートに問い合わせてください。
SE HTTP セクション
このセクションのパネルは、HTTP リクエストとレスポンスに関連するメトリクスを表示します。
このセクションの具体的なパネル情報は以下を参照してください。
SE Request Success Rate/5m (Linkerd) パネル
選択した Extend アプリから AGS バックエンドへの、5 分あたりの HTTP リクエスト成功率を示すグラフです。
SE Response Latency パネル
AGS バックエンドが選択した Extend アプリから HTTP リクエストを受信してから、AGS がレスポンスを送信するまでの遅延時間（ミリ秒）を示すグラフです。
レスポンス時間に大きな遅延がある場合は、AGS バックエンドの一時的な速度低下を示している可能性があります。この場合は、詳細情報について AccelByte サポートに問い合わせてください。
SE 2xx/5m (Linkerd) パネル
ステータスコードが 200〜299 の間で完了した HTTP レスポンス（正常に完了）の数です。
SE 4xx/5m (Linkerd) パネル
ステータスコードが 400〜499 の間で完了した HTTP レスポンス（クライアントエラーレスポンス）の数で、選択した Extend アプリに問題があることを示しています。
これらのエラーは、クライアント（Extend アプリ）側の問題を示しています。アプリをトラブルシューティングして、エラーの原因を確認してください。原因を特定できない場合は、AccelByte サポートに問い合わせてください。
SE 5xx/5m (Linkerd) パネル
ステータスコードが 400〜499 の間で完了した HTTP レスポンス（サーバーエラーレスポンス）の数で、AGS バックエンドの一時的な問題を示しています。
これらのエラーは、AGS バックエンドの一時的な問題を示しています。この場合は、詳細情報について AccelByte サポートに問い合わせてください。