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.

Screenshot of Sensu account license download

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 and JSON), 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
[...]
sensuctl license info --format json

{
  "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.