> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Analyzing Your Matchmaking Queue Usage

> Learn how to interpret the PlayFab Matchmaking Usage Charts in Game Manager to analyze queue throughput, ticket volume, and match wait times.

# Matchmaking Queue Usage

PlayFab matchmaking provides charts that help developers understand their
customer's matchmaking usage patterns.  The Matchmaking Usage view can be
accessed within the GameManager portal under the Muliplayer->Matchmaking tab.
Once a specific queue is selected, there will appear a "Usage" sub tab adjacent
to the "Edit Queue" sub tab.  As long as matchmaking activity is occurring in
that queue, selecting the Usage tab will render various charts that depict
matchmaking activity (or possibly lack thereof) within it.

<img src="https://mintcdn.com/microsoft-4404708b/dqv53299jA1M-fNi/images/playfab/multiplayer/matchmaking/matchusage.PNG?fit=max&auto=format&n=dqv53299jA1M-fNi&q=85&s=93e0e18bda1ce5d2eb6056b11a90b91e" alt="Matchmaking Usage" width="543" height="354" data-path="images/playfab/multiplayer/matchmaking/matchusage.PNG" />

## Charts

Each of the charts described below can render data over the past hour,  4 hours,
day, 3 days, week, or month (4 weeks).  To change the time window, select the
time duration dropdown and select a different time window.  All graphs will
render using the same time window.

### Average Matchmaking Time

This chart shows how long it takes for a match to be found in this matchmaking
queue.  If the time seems to take longer than expected, it's worth re-examining
the rules for this queue to see if those rules are overly restrictive resulting
in longer matchmaking times.  It also is worth looking at the other charts to
see how active this queue is and if other issues may be preventing timely
matches.

<Note>
  Y-Axis: seconds
</Note>

### Average Time to Cancel a Ticket

This chart shows how long it takes to cancel a ticket.  Tickets can be canceled
by the matchmaking service or by players.  This graph can be used in conjunction
with the Canceled Ticket Rate graph to better understand not only how long
tickets take to be canceled, but what is driving those cancellations and how
many of each cancellation type is happening.

<Note>
  Y-Axis: seconds
</Note>

### Match Completion Rate

This chart shows how frequently matches are found for players in that
matchmaking queue.  If the rate is lower than expected or bouncing off of zero,
that may indicate either an issue with the matchmaking service, or how the
matchmaking queue rules are configured.  This graph can be used in conjunction
with the "Average Matchmaking Time" graph to ascertain how successfully matches
in this queue are occurring (or not).

<Note>
  Y-Axis: # of completed matches /sec
</Note>

### Canceled Ticket Rate

This chart shows the rate of ticket cancellations within this matchmaking queue,
and also shows what cancellation types are occurring by kind. If matches are not
happening as quickly or frequently as expected, this graph may indicate a higher
than expected rate of ticket cancellations that is hindering the
matchmaking process.

#### Cancellation Types

Each of the ticket cancellation types is listed below, along with its purpose
and what entity initiated it.

| Cancellation Type      | Description                                                                                       | Origin |
| ---------------------- | ------------------------------------------------------------------------------------------------- | ------ |
| Requested              | A user manually canceled a ticket from this queue's matchmaking process.                          | User   |
| Timeout                | The matchmaking process for this ticket exceeded its maximum configured time to find a match.     | Server |
| TicketUnmatchable      | The ticket in this queue will never find a match based on its current queue rules.                | Server |
| ServerAllocationFailed | A match was successfully created, but for some reason could not be allocated to a PlayFab server. | Server |
| Internal               | An unknown internal error occurred. If these errors occur often, please contact support.          | Server |

<Note>
  Y-Axis: ticket cancellations /sec
</Note>

### Tickets Waiting for a Match

This chart shows how many tickets are still waiting to be matched with other
tickets in that queue.  If this number is low, it may indicate that the
matchmaking queue is not popular with users, but alternatively could indicate
that new matches are occurring very quickly in this queue.  If this number is
high, it is worth looking at the "Average Matchmaking Time" graph to see if the
high number is related to a slow matchmaking process in this queue, or if this
queue is merely popular with players.

<Note>
  Y-Axis: # of waiting tickets
</Note>

## Other Common Issues Identified with Matchmaking Usage Data

As mentioned in some of the chart descriptions above, charts can be used and
cross-referenced to pinpoint issues with matchmaking queues.  The following
table suggests how to use one or more charts to quickly diagnose common problems.

\| Issue   | Probable Meaning |
\|---------------------|-------------|----------------|
\| Zero or erratic match completion rate | Queue configured incorrectly, queue doesn't match with title |
\| Low match completion rate, long matchmaking times | Queue rules are too restrictive |
\| High match completion rate, high ticket cancellation rate | Quitters, unsatisfactory matches |


## Related topics

- [PIX on XBOX and Windows for GDK titles](/tools/tools-console/pix/index.md)
- [Configuring matchmaking queues](/services/playfab/multiplayer/matchmaking/config-queues.md)
- [Async task queue design](/build/core-features/common/async/async-task-queue-design.md)
- [Matchmaking quickstart](/services/playfab/multiplayer/matchmaking/quickstart.md)
- [Displaying queue statistics in your title](/services/playfab/multiplayer/matchmaking/display-statistics.md)