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.

The monthly usage is counted based on the enabled services during the previous month. Some of them are part of the GravityZone standard protection, while others are optional, billable security layers. In each situation, the usage is calculated differently.

All the standard and optional security layers are always listed in the CSV file of the Monthly License Usage report, along with another relevant data regarding the endpoints.

This article includes:

How to calculate the usage for endpoints with standard protection

The GravityZone standard protection includes:

  • Advanced Threat Control
  • Firewall
  • Content Control
  • Device Control

It also includes the following roles:

  • Power User
  • Relay

These features are listed separately in the CSV file of the Monthly License Usage report, but they do not generate additional usage to the Antimalware module.

The reason of these features being listed separately is to provide a complete view of the services used during the previous month.

The usage is calculated by the number of the endpoints for companies without Security for Virtualized Environments.

If you have companies with Security for Virtualized Environments, filter the corresponding column of the CSV file by "Security for Virtualized Environments = No". In this case, any type of endpoint protected with local engines is considered to be in the standard package.

API

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

How to calculate the usage for endpoints with optional security layers

The GravityZone optional security layers include:

Full Disk Encryption

The usage for Full Disk Encryption is calculated by the number of endpoints that have used this module during the previous 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 module.

API

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 module during the previous 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 module.

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 HyperDetect and Sandbox Analyzer is calculated collectively by the number of endpoints that have used at least one of these modules during the previous month.

In the CSV file of the Monthly License Usage report, filter the corresponding 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 used this module during the previous 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 of the Monthly License Usage report, you have to 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 of using the Monthly License Usage report

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 two companies: Customer1 and Customer2. The endpoints of these companies have used different modules during the past month. To calculate the usage, filter the relevant columns for each security layer.

Results for Customer1:

  • 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.

Results for Customer2:

  • 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.

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


Rate this article:

Submit