Tessen

Tessen is the Sensu call-home service. Included with every Sensu backend, Tessen sends anonymized data about Sensu instances to Sensu Inc., including:

  • The Sensu version
  • The number of Sensu agents and backends in the cluster
  • Whether the Sensu instance uses an enterprise license

All data submissions are logged for complete transparency at the info log level and transmitted over HTTPS. Read the blog post to learn more about Tessen.

Configuring Tessen

You can use the Tessen API and sensuctl to view and manage Tessen configuration. Tessen is enabled by default on Sensu backends and required for licensed Sensu instances. To manage Tessen configuration using sensuctl, configure sensuctl as the default admin user.

To see the status of Tessen:

sensuctl tessen info

To opt out of Tessen:

sensuctl tessen opt-out

NOTE: Licensed Sensu instances override Tessen configuration to opt in at runtime.

You can use the --skip-confirm flag to skip the confirmation step.

sensuctl tessen opt-out --skip-confirm

To opt in to Tessen:

sensuctl tessen opt-in

Tessen specification

Top-level attributes

type
description Top-level attribute specifying the sensuctl create resource type. Tessen configuration should always be of type TessenConfig.
required Required for Tessen configuration in wrapped-json or yaml format for use with sensuctl create.
type String
example
"type": "TessenConfig"
api_version
description Top-level attribute specifying the Sensu API group and version. For Tessen configuration in Sensu backend version 5.5, this attribute should always be core/v2.
required Required for Tessen configuration in wrapped-json or yaml format for use with sensuctl create.
type String
example
"api_version": "core/v2"
spec
description Top-level map that includes Tessen configuration spec attributes.
required Required for Tessen configuration in wrapped-json or yaml format for use with sensuctl create.
type Map of key-value pairs
example
"spec": {
  "opt_out": false
}

Spec attributes

opt_out
description Set to false to enable Tessen; set to true to opt out of Tessen. Licensed Sensu instances override the opt_out attribute to false at runtime.
required true
default false
type Boolean
example
opt_out": false

Tessen example

The following example is in wrapped-jsonformat for use with sensuctl create. To manage Tessen using the Tessen API, use non-wrapped json format as shown in the API docs.

{
  "type": "TessenConfig",
  "api_version": "core/v2",
  "spec": {
    "opt_out": false
  }
}