License reference
Activate your commercial license
If you haven’t already, install the backend, agent, and sensuctl and configure sensuctl.
Log in to your Sensu account at account.sensu.io and click Download license to download your license file.

With the license file downloaded, you can activate your license with sensuctl or the license API.
To activate your license with sensuctl:
sensuctl create --file sensu_license.json
Use sensuctl to view your license details at any time.
# Active license
sensuctl license info
=== You are currently using 10/100 total entities, 5/50 agent entities, and 5/50 proxy entities
Account Name: Training Team - Sensu
Account ID: 123
Plan: managed
Version: 1
Features: all
Issuer: Sensu, Inc.
Issued: 2020-02-15 15:01:44 -0500 -0500
Valid: true
Valid Until: 2021-02-15 00:00:00 -0800 -0800
# No license found
sensuctl license info
Error: not found
Entity limit
Your commercial license may include the entity limit and entity class limits tied to your Sensu licensing package. Contact Sensu to upgrade your commercial license.
Your Sensu license may include two types of entity limits:
- Entity limit: the maximum number of entities of all classes your license includes. Both agent and proxy entities count toward the overall entity limit.
- Entity class limits: the maximum number of a specific class of entities (e.g. agent or proxy) that your license includes.
For example, if your license has an entity limit of 10,000 and an agent entity class limit of 3,000, you cannot run more than 10,000 entities (agent and proxy) total. At the same time, you cannot run more than 3,000 agents. If you use only 1,500 agent entities, you can have 8,500 proxy entities before you reach the overall entity limit of 10,000.
View entity count and entity limit
Your current entity count and entity limit are included in the sensuctl license info
response.
In tabular format, the entity count and limit are included in the response title:
sensuctl license info --format tabular
=== You are currently using 10/100 total entities, 5/50 agent entities, and 5/50 proxy entities
Account Name: Training Team - Sensu
Account ID: 123
Plan: managed
Version: 1
Features: all
Issuer: Sensu, Inc.
Issued: 2020-02-15 15:01:44 -0500 -0500
Valid: true
Valid Until: 2021-02-15 00:00:00 -0800 -0800
If you have an unlimited entity count, the sensuctl license info
response title will still include a current count for each type of entity you are using.
For example:
=== You are currently using 10/unlimited total entities, 5/unlimited agent entities, and 5/unlimited proxy entities
In other formats (e.g. yaml), the entity count and limit are included as labels:
sensuctl license info --format yaml
type: LicenseFile
api_version: licensing/v2
metadata:
labels:
sensu.io/entity-count: "10"
sensu.io/entity-limit: "100"
spec:
license:
version: 1
issue: Sensu, Inc.
accountName: Training Team - Sensu
[...]
You can also see your current entity count and limit in the response headers for any /api/core
or /api/enterprise
API request. For example:
curl http://127.0.0.1:8080/api/core/v2/namespaces/default/entities -v -H "Authorization: Bearer $SENSU_ACCESS_TOKEN"
The response headers will include your current entity count and limit:
HTTP/1.1 200 OK
Content-Type: application/json
Sensu-Entity-Count: 10
Sensu-Entity-Limit: 100
License expiration
To see your commercial license expiration date, log in to your Sensu account.
If your license is within 30 days of expiration, Sensu issues regular warnings in the Sensu backend logs. If your license expires, you will still have access to commercial features, but your entity limit will drop back down to the free limit of 100.