This article describes how to generate and view an OS Units report, which provides asset-level detail on the calculation of OS Units. For more details on OS Units, see Introduction to OS Units.


  1. Only the Primary Administrator or a User with the Reports role assigned can generate OS Units Usage reports.
  2. The retention period for such reporting is one year. Data beyond one year old is not available.

Content / Solution:

  1. From the Home screen, click on the Compute menu, and select Download Reports from the drop-down menu:

  2. The Download Reports page will be displayed:

  3. Select "OS Units Usage" from the drop-down menu:

  4. The system will ask you to define the Start and End dates for the report. The date range cannot be larger than 31 days. Click the "Download" button when you've entered the dates:

    • You will need to select an end date one day later than your actual desired end date for audit data. For example, if you want to generate a report showing OS Units Usage for the month of June 2020, your start date should be 6/1/20, but your end date should be 7/1/20.
    • You can generate a report for up to 31 days worth of usage
    • A report cannot be generated for greater than a year earlier than the current date (allows for leap years).

  5. The system will download a CSV formatted report that provides the details of OS Units for the organization during the time period selected. Opening up this file in Microsoft Excel or Google Docs is probably the easiest way of understanding the results:

  6. The report contains a daily summary of the aggregate total of usage for each of the variables associated with the Cloud pricing model, including:

    • Server - Name of the Server
    • Server ID - ID of the Server
    • CPU Count - How many CPU are associated with the Server
    • OS Units Group - Associated OS Units Group
    • OS Rate Type - How the OS Units are billed
    • OS Rate for Server Configuration - The amount of OS Unit Hours that are generated by the Server while it is running. Note that:
      • For Servers whose OS Units Group uses a Per CPU methodology, this represents the "per cpu" rate for the OS Unit Group. So OS Units = CPU x Deployed Hours
      • For Servers whose OS Units Group uses a CPU Range methodology, this represents the specific server's OS Unit rate given the Server's CPU configuration and the OS Unit Group's range rates. So OS Units = OS Rate for Server Configuration x Deployed Hours.
        • The entire range of possibilities for the Server's OS is not included - this column represents the rate given the server's CPU configuration and the OS Unit Group definition at the time represented by the row.
      • For more details on the methodologies, see Introduction to OS Units
    • Deployed hours - How many hours the Server was deployed
    • OS Units - The total amount of OS Units for the reported time period
    • REDHAT OS Units - The total amount of RedHat OS Units for the reported time period
    • SUSE OS Units - The total amount of SUSE OS Units for the reported time period
    • SUSE SAP OS Units - The total amount of SUSE SAP OS Units for the reported time period
    • WINDOWS OS Units - The total amount of Windows OS Units for the reported time period

  7. Additional Notes:
    • Each report contains a row of data per day for each location in the Geographic Region. Reports are generated each day at midnight in the timezone of the Geographic Region. For details on these timezones, see Introduction to Geographic Regions.
    • CloudControl does not handle billing and supports Cloud Providers using a variety of pricing methodologies and currencies, so the report only includes usage.  To identify your current month-to-date charges, you will need to apply your Cloud Provider's specific pricing against the usage totals listed in this report.