Skip to main content

August 11, 2026

Generating Tenant Billing Reports

The platform captures desktop usage for each tenant so the Service Provider can have access to billing summary information.

All billing information retrieval must be done via REST APIs. The retrieval of billing information via scripts is not supported.

Note: By default the Billing Summary Report will contain information about disabled and enabled tenants, but there is a policy (‘billing.summary.skip.disabled.tenants’) that can alter this functionality to only collect information for enabled tenants. To activate this option, set the policy value to ‘true’.

Report Content

For each data center associated with a tenant, the platform captures the following data:

  • The quota for each desktop model.
  • The desktops in use for each model.
  • The quota for each protocol.
  • The desktops in use for each protocol.

By default, the platform captures this information daily just after midnight (UTC) and purges previous summaries older than 180 days.

Unlimited quota is represented with the value -1.

Description of Record Layout

The table below describes the values returned in each column.

Column NameSample ValueDescription
snapshot201203220856Date and Time of record (format: yyyyMMddhhmm)
org_id1001The unique ID of the Organization/Tenant
org_nameTenant AThe name for the tenant identified by org_id
datacenter_id5925d361-4c1c-490e-9616-c5041d067b8eA unique ID that identifies the Datacenter location
statusenabledThe status of the tenant: Enabled, Disabled, Error
type_id1cb3f348-f987-4834-a33c-742ef30d356bUnique Id for given Type:
  • 'template' for Template quota
  • 'desktop' if there are no quotas (all 0) and no in_use_count numbers. In this case, quota and in_use_count are set to -1 to indicate nothing was found for the tenant.
desktop_model_nameProThis value is blank for a Template.Quota
model_protocols31If the type is PROTOCOL, this column indicates the bitmask value for that protocol.
  • RDP = bit 0
  • RGS = bit 1
  • HDX = bit 2
  • VNC = bit 3
  • NX = bit 4
  • PCoIP = bit 5
For example, the bitmask 31 means RDP, RGS, HDX, VNC, and NX are available and the bitmask 1 means only RDP. If the type is DESKTOPMODEL, this column is ignored and contains 0.
quota17Error Value of -1
in_use_count17When Session Type= Number of sessions provisioned for; otherwise -1 indicates an error while the summary was being taken or that the system could not communicate with the tenant. The in_use_count can be higher than the quota only if the VMs exist on the hypervisor or are created outside the environment. This occurs only for Imported or Utility Desktop Model Quota mapped to the Imported, Recycle and Utility pools.
date_updated2012-03-22 08:56:30.784The last time this row was modified
typePROTOCOLIndicates the type of quota (DESKTOPMODEL, SESSION, PROTOCOL, TEMPLATE)

Override Report Intervals

By default, the platform captures billing summary information daily just after midnight (UTC) and purges previous summaries older than 180 days. To override these default intervals, follow the procedure below.

  1. In the Service Center, select tenants > policy.
  2. On the Policy Configuration page, set the following policies:
    • billing.summary.collection.interval - The interval between billing collections in milliseconds (ms). The default is 86400000 ms (24 hours).
    • billing.summary.purge.interval policies - The number of days to retain billing summary records in the database. The default is 180 days. Records older than the interval are purged from the database. Set to 0 to retain all billing history in the database.

Was this page helpful?

Provide feedback for this topic

Was this topic helpful?

Please do not include any personal or confidential information.

Generating link…