メインコンテンツまでスキップ

マッチメイキング X-Ray ツールの機能

Last updated on February 4, 2026

注釈:本資料はAI技術を用いて翻訳されています。

概要

この記事では、AccelByte Gaming Services (AGS) 管理ポータルの マッチメイキング X-Ray ツールの機能について説明します。

前提条件

  • マッチメイキング X-Ray がチケットを追跡できるようにするには、マッチメイキングルールセットに "ticket_observability_enable": true パラメータを追加します。

    注記

    この機能はデバッグやマッチメイキング動作に関する洞察を得るために不可欠ですが、その実装には、集中的なモニタリングと追跡が含まれるため、追加費用が発生する可能性があります。そのため、トレードオフを評価し、この機能を有効化する前に、インフラストラクチャが増加したワークロードに対応できることを確認することをお勧めします。

    X-Ray 設定のオンまたはオフを切り替えても、ゲーム自体の動作は変わりません。代わりに、開発者がマッチメイキング中に発生する可能性のある問題を見つけて修正するのに役立ちます。

マッチメイキング X-Ray ツールへのアクセス

このツールにアクセスするには、AGS 管理ポータルでゲームの名前空間に移動します。次に、サイドバーで、Multiplayer > Development & Utilities > Matchmaking X-Ray に移動します。Matchmaking X-Ray ページが表示されます。

Matchmaking X-Ray ページでは、OverviewTimeline という 2 つの主要なタブを通じて可視性が提供されます。

最初のセクションは X-Ray 概要セクション として知られており、マッチメイキングメトリクスを高レベルで表示し、マッチメイキングプロセスのステータスを迅速に把握できるようにします。2 番目のセクションである X-Ray タイムラインセクション は、キューイングチケットからマッチの取得まで、マッチメイキングイベントの詳細な時系列ビューを提供し、マッチメイキングプロセス中の未選択チケットの識別や、詳細なマッチメイキング結果の提示を含みます。Match IDMatch PoolTicket IDUser ID など、さまざまな基準に基づいて検索を実行できます。

X-Ray Overview タブ

X-Ray Overview タブは、マッチメイキングステータスの簡単な概要を提供します。これには、さまざまなメトリクスが含まれます。作成された総チケット数 (キャンセルされたものと正常にマッチングされたものを含む)、アクティブなマルチプレイヤーセッションの数とその平均プレイヤー数、およびセッション期間。さらに、チケットがマッチを見つけるための 99 パーセンタイル (P99) と平均キュー時間、およびプレイヤーが専用サーバーに接続するための待機時間を表示するダッシュボードも備えています。

X-Ray overview metrics

  • 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 のリストを表示し、各リクエストの処理を担当する Worker を識別できます。さらに、個々のチケット ID を展開して、チケットの詳細、関与するプレイヤー、チケット履歴、チケットの JSON データなどの詳細情報にアクセスできます。

X-Ray search by user ID

Ticket ID で検索

このセクションでは、ユーザーはチケット ID で検索して、チケットの進行状況とステータスを追跡できます。特定のチケット ID を入力することで、チケットの現在のステータスや進行中のプロセスを含むチケットのジャーニーを表示できます。さらに、ユーザーはリクエストボディ/ペイロード、チケット履歴、フレックスステータス、バックフィルされない理由、未マッチチケットの説明などの詳細にアクセスできます。

X-Ray search by ticket ID

Match ID で検索

このセクションでは、マッチ ID を検索して、マッチメイキングプロセスに関する情報にアクセスできます。さらに、ユーザーは関与する Worker に関する詳細を表示でき、包括的なマッチ Worker の詳細を含むページにつながり、同時に処理されている他のチケットを識別できます。さらに、このセクションにはリクエストされたリージョンデータが含まれており、マッチに対してリクエストされたリージョンに関する洞察を提供します。

X-Ray search by match ID

Match pool で検索

このセクションでは、Match Pool で検索して、特定の期間内の入力チケット数、作成されたマッチ、未マッチチケットに関する洞察を得ることができます。この機能は、通常、低同時接続ユーザー (CCU) 期間中に、特定の時間に処理されたチケットの量を理解するために使用されます。

X-Ray search by match pool