You can use the CCU tracking feature to view how many concurrent players are connected to your zeuz game servers.
Before you enable CCU tracking, ensure that you have:
- Arranged with zeuz to have the CCU tracking feature added to your account.
- Integrated your game with Steam. See Integrate your game with the A2S protocol below for details.
- Included the
statsPortvariable in your allocation’s Command configuration. See Include statsPort in your allocation’s Command below for details.
To use CCU tracking, you must expose your CCU with A2S, the standard Steam query protocol, in your game server process. There are two ways to do this:
- If you use the Steam SDK or the Online Subsystem Steam for Unreal Engine, your CCU is already exposed with A2S.
- If you do not use the Steam SDK or the Unreal Subsystem Steam, you must expose your CCU with A2S directly. Contact your zeuz account manager for more information.
If you’re not sure if you have A2S, use the check below.
TIP: Check if you can use CCU tracking
To check if you have the A2S protocol, which is a requirement for the CCU tracking feature, follow these steps:
Download and install the
qstatcommand line utility.
Linux: Ubuntu qstat (download is at the top of the page).
Windows: qstat downloads
In the zeuz control panel, go to Payloads and view Reserved payloads. Make a note of any reserved payload IP address and its port mapping details.
At the command line, run the following
qstatcommand. It uses the A2S protocol to try to connect to the IP address and port, and returns the results in XML format.
./qstat -xml -a2s <ipaddress:port>
./qstat -xml -a2s 18.104.22.168:32082
A successful A2S connection returns a result similar to the following, showing details including the game type, number of players and max players:
<qstat> <server type="A2S" address="22.214.171.124:32082" status="UP"> <hostname>126.96.36.199</hostname> <name>My_zeuz_game</name> <gametype>My_game_type</gametype> <map>Precinct</map> <numplayers>7</numplayers> <maxplayers>32</maxplayers> <numspectators>0</numspectators> <maxspectators>0</maxspectators> <ping>127</ping> <retries>0</retries> </server> </qstat>
An unsuccessful A2S connection attempt returns a short result with
- If the connection is unsuccessful and there are other mapped ports, retry the command with another mapped port.
If you try the command with all port mappings on a reserved payload IP address and none of them make a successful A2S connection, then you can’t use the CCU tracking feature.
To use CCU tracking, you must include the
statsPort variable in the Command section of your allocation configuration.
statsPort variable passes the port configuration to your game and allows it to transmit information about concurrent players.
For more information, see the Command configuration instructions.
You enable CCU tracking as part of creating an allocation. In the zeuz control panel go to Orchestration > Allocations and click +ADD ALLOCATION. See Create an allocation for more information.
In the Payload definition section, locate the CCU tracking drop-down.
CCU tracking is disabled by default. To enable it, select one of the following options:
Private: Only zeuz can access your tracking data.
Public: No restriction on who can access your tracking data. Use this option if you need to allow access to both zeuz and Steam.
Note: The A2S protocol does not allow for authentication.
Once you enable CCU tracking, newly started payloads report tracking information, but existing payloads do not.
2020-mar-04 Page updated with editorial review.
2020-dec-14 Page created with editorial review.