Activate your commercial license
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
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.
=== 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/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
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.