1. Download

DockerUbuntu/DebianRHEL/CentOSWindows

  1. # Add the Sensu repository
  2. curl -s https://packagecloud.io/install/repositories/sensu/stable/script.rpm.sh | sudo bash
  3. # Install the sensu-go-agent package
  4. sudo yum install sensu-go-agent

2. Configure and start

You can configure the Sensu agent with sensu-agent start flags (recommended) or an /etc/sensu/agent.yml file. The Sensu agent requires the --backend-url flag at minimum, but other useful configurations and templates are available.
DockerDocker ComposeUbuntu/DebianRHEL/CentOSWindows

  1. # Copy the config template from the docs
  2. sudo curl -L https://docs.sensu.io/sensu-go/latest/files/agent.yml -o /etc/sensu/agent.yml
  3. # Start sensu-agent using a service manager
  4. service sensu-agent start

For a complete list of configuration options, see the agent reference.

3. Verify keepalive events

Sensu keepalives are the heartbeat mechanism used to ensure that all registered agents are operating and can reach the Sensu backend. To confirm that the agent is registered with Sensu and is sending keepalive events, open the entity page in the Sensu web UI or run sensuctl entity list.

Commercial features

Sensu Inc. offers support packages for Sensu Go and commercial features designed for monitoring at scale.
All commercial features are free for your first 100 entities. To learn more about Sensu Go commercial licenses for more than 100 entities, contact the Sensu sales team.
If you already have a Sensu commercial license, log in to your Sensu account and download your license file, then add your license using sensuctl.

  1. sensuctl create --file sensu_license.json

You can use sensuctl to view your license details at any time.

  1. sensuctl license info

https://docs.sensu.io/sensu-go/latest/installation/install-sensu/#install-sensu-agents
https://docs.sensu.io/sensu-go/latest/installation/install-sensu/#4-open-the-web-ui
image.png