Directly contact our Support Team

How to calculate the endpoint usage with the Monthly License Usage report

As a Bitdefender managed service provider (MSP), you are able to offer Bitdefender cloud security services in a flexible manner, best suited to your clients with monthly license. Consequently, you can charge them depending on how they use these services.

GravityZone helps you keep a clean tracking of the consumed resources with the Monthly License Usage report, which you have to generate at the beginning of each month for the previous month. For details about generating a Monthly License Usage report in Control Center or via API, refer to this article.

About the Monthly License Usage report

The Monthly License Usage aims to provide all the details you need to measure and charge the usage of GravityZone services accordingly.

Starting with the 2nd quarter of 2020, the report includes more information to simplify the process of billing. The Only Endpoint Details and Only Direct Companies options, available when creating this report, help you focus on the data you are interested in.

As displayed in Control Center, the Monthly License Usage report consists mainly of two areas:

  • The chart, which depicts the usage of some GravityZone add-ons during the month.
  • The table, which lists details about companies, license and usage. The table is customizable by clicking the Show/Hide Columns button in the top-right corner.

    Clicking the numbers of each element of the column provides you with more details regarding endpoints and the usage of GravityZone add-ons.

    The table includes the following details:

    • Path – location of the target company in the network tree.
    • Company name.
    • Company type.
    • License key.
    • Month.
    • Licensed endpoints – number of machines under a GravityZone license.
    • Endpoint usage – number of machines with core protection.
    • Patch Management usage – number of endpoints that have installed this add-on during the month.
    • SVE: VS – number of virtual servers with Central Scan.
    • SVE: VDI – number of uptime hours for virtual desktops with Central Scan.<.li>
    • ATS usage – number of endpoints that have used at least one of the Advanced Threat Security add-ons (HyperDetect or Sandbox Analyzer).
    • EDR usage – number of endpoints with the EDR sensor.
    • Reserved seats – total number of license seats available for a company. The previous name of this column was Total.

If a GravityZone add-on has not been enabled for a company, it is specified as such.

From Control Center, you can export the report in PDF and CSV formats, or you can send it through email.

PDF file

The report in PDF format contains only general data about the report and the chart.

CSV file

The CSV file contains in two areas all the details available with the Monthly License Usage report:

  • One area with general information on companies. This are corresponds to the table from Control Center.
  • Another area with details on endpoints and the usage for each module and add-on.

To calculate the monthly usage, you need to filter the CSV file by the type of information you are looking for.

How to calculate the monthly usage

To calculate the monthly usage for GravityZone modules and add-ons, you need the CSV file.

The monthly usage is counted based on the enabled modules and add-ons during the month. The modules are part of the GravityZone core protection, while add-ons are optional and billed separately.

The CSV file lists all the standard and optional security layers, along with other relevant data on companies and endpoints.

Usage for endpoints with core protection

The GravityZone core protection includes the following modules and roles:

  • Antimalware (not listed in the report as it is installed by default on endpoints)
  • Advanced Threat Control
  • Advanced Anti-Exploit
  • Firewall
  • Content Control
  • Device Control
  • Network Attack Defense
  • Power User
  • Relay

The usage for endpoints with standard protection is based on the Antimalware module.

The other modules do not generate additional usage in terms of billing, but they are listed in the CSV file for you to have a complete view over what is installed on the endpoints.

The usage is calculated based on the number of endpoints with core protection installed during the month and is available in the Endpoint Usage column.

If a company has used the Security for Virtualized Environments add-on (Central Scan protection), you have to subtract virtual servers (VS) and virtual desktops (VDI) from this number.

API

Use the getMonthlyUsage method to obtain the value for endpointMonthlyUsage. For details, refer to Bitdefender GravityZone API Guide for Partners, chapter Licensing > getMonthlyUsage.

Usage for endpoints with add-ons

The GravityZone add-ons include:

Full Disk Encryption

The usage for Full Disk Encryption is calculated by the number of endpoints that have installed this add-on during the month.

In the CSV file of the Monthly License Usage report, filter the corresponding column by "Full Disk Encryption = Yes" to get the usage of this add-on.

API

Choose one of these variants:

  • Get the usage for Full Disk Encryption by parsing the CSV file obtained through GravityZone API. For details about generating the CSV file through API, refer to this article.
  • Use the getMonthlyUsage method to obtain the value for encryptionMonthlyUsage. For details, refer to Bitdefender GravityZone API Guide for Partners, chapter Licensing > getMonthlyUsage.

Patch Management

The usage of Patch Management is calculated by the number of endpoints that have used this add-on during the month.

In the CSV file of the Monthly License Usage report, filter the corresponding column by “Patch Management = Yes” to get the usage of this add-on.

API

Choose one of these variants:

  • Get the usage for Patch Management by parsing the CSV file obtained through GravityZone API. For details about generating the CSV file through API, refer to this article.
  • Use the getMonthlyUsage method to obtain the value for patchManagementMonthlyUsage. For details, refer to Bitdefender GravityZone API Guide for Partners, chapter Licensing > getMonthlyUsage.

Advanced Threat Security (HyperDetect and Sandbox Analyzer)

The usage for Advanced Threat Security is calculated by the number of endpoints that have installed at least one of HyperDetect or Sandbox Analyzer add-ons during the month.

In the CSV file, filter the Advanced Threat Security by “ATS=Yes”.

If you want granular information, filter the HyperDetect and Sandbox Analyzer columns by "HyperDetect = Yes", then "Sandbox Analyzer = Yes". You have to combine the results to get the usage of these modules.

API

Choose one of these variants:

  • Get the usage for HyperDetect and Sandbox Analyzer by parsing the CSV file obtained through GravityZone API. For details about generating the CSV file through API, refer to this article.
  • Use the getMonthlyUsage method to obtain the value for atsMonthlyUsage, which provides the usage for HyperDetect and Sandbox Analyzer. For details, refer to Bitdefender GravityZone API Guide for Partners, chapter Licensing > getMonthlyUsage.

Endpoint Detection and Response

The usage for Endpoint Detection and Response (EDR) is calculated by the number of endpoints that have installed the EDR sensor during the month.

In the CSV file of the Monthly License Usage report, filter the corresponding column by “Endpoint Detection and Response = Yes” to get the usage of this module.

API

Choose one of these variants:

  • Get the usage for EDR by parsing the CSV file obtained through GravityZone API. For details about generating the CSV file through API, refer to this article.
  • Use the getMonthlyUsage method to obtain the value for edrMonthlyUsage. For details, refer to Bitdefender GravityZone API Guide for Partners, chapter Licensing > getMonthlyUsage.

Security for Virtualized Environments

The usage for this module is calculated by:

  • Number of virtual servers (VS) with Security for Virtualized Environments
    note Note:

    Linux virtual machines are considered virtual servers.

  • Number of hours of using virtual workstations (VDI) with Security for Virtualized Environments

To obtain these data, you are provided with the following columns in the CSV file of the Monthly License Usage report:

  • Endpoint OS type: server or workstation.
  • Endpoint type: physical or virtual.
  • Uptime: how much time the endpoint has been protected by GravityZone. The uptime is counted in seconds and it is rounded up when converted in hours. For example, if the uptime for an endpoint with Central Scan is 3,600 seconds it means the endpoint will be charged for one hour. If the uptime is 3,650 seconds, the endpoint will be charged for two hours.
    important Important:

    The sleep and hibernation modes are not counted for uptime.

  • Security for Virtualized Environments: Yes means the endpoint has used Central Scan engine at least once during the month. No means the company has been using Local Scan or Hybrid Scan engines.

In the CSV file, filter the columns as follows:

  1. For virtual servers (VS) with Security for Virtualized Environments by selecting "Security for Virtualized Environments = Yes" and "Endpoint type= Virtual" and "OS type = Server"
  2. For virtual workstations (VDI) with Security for Virtualized Environments by selecting "Security for Virtualized Environments = Yes" and "Endpoint type= Virtual" and "OS type = Workstation", then sum up the uptime and divide it by 3600 to get the hourly usage. The result is rounded up.
note Note:

In case of using virtual servers (VS) or virtual workstations (VDI), you need to subtract them from the total number of machines to avoid double billing.

API

Choose one of these variants:

  • Get the usage for Security for Virtualized Environments by parsing the CSV file obtained through GravityZone API. For details about generating the CSV file through API, refer to this article.
  • Use the getMonthlyUsage method to obtain the value for:
    • sveVsMonthlyUsage, which provides the usage for virtual servers (VS) scanned with Security Server (Central Scan).
    • sveVdiMonthlyUsage, which provides the usage (in hours) for virtual desktops scanned with Security Server (Central Scan).

    For details, refer to Bitdefender GravityZone API Guide for Partners, chapter Licensing > getMonthlyUsage.

Security for Exchange

The usage of Security for Exchange is calculated with the dedicated [Exchange] Monthly License Usage report. This report provides you with details such as: company name, license keys, month, and the number of protected mailboxes belonging to each managed company.

In the Monthly License Usage report, you can view the number of endpoints with Security for Exchange, but only for your information.

API

Use the getMonthlyUsage method to obtain the value for exchangeMonthlyUsage. For details, refer to Bitdefender GravityZone API Guide for Partners, chapter Licensing > getMonthlyUsage.

Email Security

The usage for Email Security is calculated based on the active primary mailboxes (excluding aliases and distribution lists) that have sent or received at least one email during the month.

The [Email Security] Monthly License Usage report provides you with details such as: company name, license keys, month, and the number of protected mailboxes belonging to each company. The report takes into account

API

Use the createReport method to generate the [Email Security] Monthly License Usage report through API. For details, refer to Bitdefender GravityZone API Guide for Partners, chapter Reports > createReport.

Use the emailSecurityMonthlyUsage method to obtain the value for emailSecurityMonthlyUsage. For details, refer to Bitdefender GravityZone API Guide for Partners, chapter Licensing > getMonthlyUsage.

Example

In a Monthly License Usage report, you have the following data presented in the CSV file:

Click the image to view it larger. Click here to download the above CSV file.

According to these data, there are four companies:

  • Partner 1 – Partner company with monthly license
  • Customer A – Customer company under Partner 1, with monthly subscription
  • Customer B – Customer company under Partner 1, with monthly subscription
  • Customer C – Customer company under Partner 1, with monthly subscription

Partner 1 has 14 licensed endpoints from a total of 100 reserved seats. The licensed endpoints are counted from the Customer A, Customer B and Customer C companies, which inherit reserved seats from Partner 1.

The usage for these companies is calculated by filtering relevant columns for each GravityZone service, in the endpoint details area.

Monthly usage for the companies under Partner 1:

Customer A

  • Endpoints with standard protection: 3
  • Endpoints with Full Disk Encryption: 2
  • Endpoints with Patch Management: 1
  • Endpoints with Advanced Threat Security: 9 (7 with both HyperDetect and Sandbox Analyzer, plus 2 with HyperDetect only)
  • Endpoints with Endpoint Detection and Response: 2
  • Endpoints with Security for Virtualized Environments:
    • Virtual servers: 1
    • Usage of virtual workstations (VDI): 30 hours (107,280 seconds from three virtual workstations)
  • Endpoints with Security for Exchange: 2.

    However, the usage must be calculated with the [Exchange] Monthly License Usage report.

Customer B

  • Endpoints with standard protection: 1
  • Endpoints with Full Disk Encryption: 3
  • Endpoints with Patch Management: 1
  • Endpoints with Advanced Threat Security: 4 (1 with both HyperDetect and Sandbox Analyzer, plus 3 with HyperDetect only)
  • Endpoints with Endpoint Detection and Response: 2
  • Endpoints with Security for Virtualized Environments:
    • Virtual servers: 0
    • Usage of virtual workstations (VDI): 2 hours (3,900 seconds from one virtual workstation)
  • Endpoints with Security for Exchange: 0.

Customer C

  • Endpoints with standard protection: 1
  • Endpoints with Full Disk Encryption: 1
  • Endpoints with Patch Management: 0
  • Endpoints with Advanced Threat Security: 0
  • Endpoints with Endpoint Detection and Response: 2
  • Endpoints with Security for Virtualized Environments:
    • Virtual servers: 0
    • Usage of virtual workstations (VDI): 0
  • Endpoints with Security for Exchange: 0.

For details about Bitdefender offering for MSP, refer to Frequently Asked Questions (FAQ) about Bitdefender Cloud Security for MSP.

Can't find a solution for your problem? Open an email ticket and we will answer the question or concern in the shortest time possible.

Rate this article:

Submit