マッチメイキング X-Ray ツールの機能
注釈：本資料はAI技術を用いて翻訳されています。
Overview
この記事では、AccelByte Gaming Services (AGS) Admin Portal にある Matchmaking X-ray ツールの機能について説明します。
前提条件
-
マッチメイキング X-Ray がチケットを追跡できるようにするには、マッチメイキングルールセットに
"ticket_observability_enable": trueパラメーターを追加します。注記この機能はマッチメイキングの挙動をデバッグし、その動作について把握するために欠かせないものですが、集中的な監視と追跡が必要となるため、有効化すると追加コストが発生する可能性があります。したがって、この機能を有効化する前に、トレードオフを評価し、インフラストラクチャが増加するワークロードに対応できることを確認することをお勧めします。
なお、X-Ray 設定を有効または無効にしても、ゲーム自体の動作は変わりません。この機能は、開発者がマッチメイキング中に発生する問題を見つけて修正できるように支援するためのものです。
-
(AGS Public Cloud のみ) X-Ray は AGS Public Cloud においてユーザーのホワイトリストを使用します。ユーザーは X-Ray ツールを使用する前にホワイトリストに登録される必要があります。ユーザーをホワイトリストに追加する方法は次のとおりです。
- AGS Admin Portal で、Multiplayer > Matchmaking > Matchmaking X-Ray に移動します。
- Whitelist タブを開きます。
- アクセスが必要なユーザーのメールアドレスを追加します。
AGS Public Cloudホワイトリストに登録されていない場合、ルールセットで
"ticket_observability_enable": trueが設定されていても、X-Ray はそのユーザーのチケットを追跡しません。このホワイトリストの手順は、AGS Private Cloud では不要です。
Matchmaking X-Ray ツールへのアクセス
このツールにアクセスするには、AGS Admin Portal でゲームの名前空間に移動します。次に、サイドバーで Multiplayer > Matchmaking > Matchmaking X-Ray に移動します。Matchmaking X-Ray ページが表示されます。
Matchmaking X-ray ページでは、Overview と Timeline という 2 つの主要なタブを通じてマッチメイキングの状況を可視化できます。
最初のセクションである X-Ray overview セクション では、マッチメイキングのメトリクスを概要レベルで表示し、マッチメイキングプロセスの状態を素早く把握できるようにします。2 番目のセクションである X-Ray timeline セクション では、チケットのキューイングからマッチの取得までのマッチメイキングイベントの詳細な時系列表示が提供され、マッチメイキングプロセス中に選択されなかったチケットの特定や、詳細なマッチメイキング結果の表示が含まれます。Match ID、Match Pool、Ticket ID、User ID など、さまざまな条件で検索を行うことができます。
X-Ray Overview タブ
X-Ray Overview タブでは、マッチメイキングの状態を簡単に確認できます。作成されたチケットの総数(キャンセルされたものやマッチが成立したものを含む)、アクティブなマルチプレイヤーセッションの数とその平均プレイヤー数、セッションの継続時間など、さまざまなメトリクスが含まれます。さらに、チケットがマッチを見つけるまでの 99 パーセンタイル(P99)および平均待機時間、およびプレイヤーがデディケートサーバーに接続するまでの待機時間を表示するダッシュボードも備えています。
- Ticket Created
- Total Ticket Created: 指定した期間内に作成されたチケットの総数。
- Total Match Created: 特定の期間内に作成されたマッチの総数。
- Total Ticket Canceled: 開始後にキャンセルまたは期限切れとなったチケットの総数。
- Active Multiplayer Session
- Total Active Multiplayer Session: 指定した期間内のアクティブなマルチプレイヤーゲームセッションの総数。
- Average Player Per Session: 各マルチプレイヤーゲームセッションに参加しているプレイヤーの平均数。
- Average Match Length: ゲームセッションの平均継続時間。
- Matchmaking Time
- P99 of matchmaking: リクエストの 99 パーセンタイルが処理されるまでにかかる時間。
- Average matchmaking time: プレイヤーがチケットを作成してからチケットがマッチするまでのマッチメイキングプロセスの平均時間。
- Average Acquiring DS Wait Time
- Successful acquiring DS: DS の取得に成功したセッションの総数。
- Failed acquiring DS: マッチが成立したにもかかわらず、DS の取得に失敗したセッションの総数。
X-Ray Timeline タブ
X-Ray Timeline タブは、マッチメイキングアクティビティの包括的な概要を提供します。ここでは、ゲーム開発者がマッチメイキングプロセスに関わる特定のユーザー、マッチ、ゲームモード、またはチケットを検索できます。このページには、詳細なタイムスタンプ、チケットのステータス、リクエストされたゲームモードとルールセット、およびチケットがマッチしたか、プールに戻されてキューイングされたか、(タイムアウト設定により)期限切れになったかに関する情報が表示されます。この機能は、チケットがどのようにマッチングされるか、また全体的なマッチメイキングプロセスに関する貴重なインサイトを提供し、各サイクルで処理されたチケットの数と種類を確認できるようにします。
User ID による検索
このセクションでは、ユーザー ID を検索し、そのユーザーに関連するリクエストされたチケット ID のリストを表示し、各リクエストの処理を担当するワーカーを特定できます。さらに、個々のチケット ID を展開して、チケットの詳細、関係するプレイヤー、チケットの履歴、チケットの JSON データなどの詳細情報にアクセスできます。
Ticket ID による検索
このセクションでは、チケット ID で検索して、チケットの進行状況とステータスを追跡できます。特定のチケット ID を入力すると、現在のステータスや進行中のプロセスを含む、チケットの経過を確認できます。さらに、リクエストの本文/ペイロード、チケットの履歴、フレックスステータス、バックフィルされなかった理由、マッチしなかったチケットの説明などの詳細にアクセスできます。
Match ID による検索
このセクションでは、マッチ ID を検索してマッチメイキングプロセスに関する情報にアクセスできます。さらに、関連するワーカーの詳細を表示することができ、包括的なマッチワーカーの詳細情報が表示されるページに移動して、同時に処理されている他のチケットを特定できます。さらに、このセクションにはリクエストされたリージョンのデータが含まれており、マッチに対してリクエストされたリージョンについてのインサイトを提供します。
Match pool による検索
このセクションでは、マッチプールで検索して、特定の期間内における入力チケット数、作成されたマッチ数、マッチしなかったチケット数についてのインサイトを得ることができます。この機能は、同時接続ユーザー数(CCU)が少ない期間に、特定の時間帯に処理されたチケットの量を把握するためによく使用されます。
