Difficulty: Beginner
Estimated Time: 10-15 minutes

Sensu is the industry-leading telemetry and service health-checking solution for multi-cloud monitoring at scale.

Sensu is a monitoring event pipeline. The value comes from getting data into the pipe. Then, you can use Sensu’s extensibility to:

  • Automate your monitoring workflows and gain deep visibility into systems that are important to your business operations, from Kubernetes to bare metal.
  • Get complete control over your alerts so you know whether your systems are performing the job you expect, learn about problems before your customers do, and have the tools to reduce alert fatigue (like flexible filters, better context, and auto-remediation).
  • Integrate anywhere, including with the tools you're already using like Nagios plugins, Chef, Grafana, InfluxDB, PagerDuty, and more.

This interactive tutorial will help you get started with Sensu Go, using only your browser. You'll:

  • Deploy a basic Sensu stack
  • Log in to the Sensu web UI
  • Create a monitoring event and use Sensu to send alerts based on the event to a Slack channel
  • Use a Sensu agent to automatically produce events, then store event data with InfluxDB and visualize it with Grafana

Continue your Sensu journey with these resources:

Learn Sensu in 15 minutes

Step 1 of 4

Get started with Sensu

On the right, there’s an interactive Ubuntu terminal where you’ll run commands in this tutorial. To run commands, you can either click them or type them. Try it out:

echo "Hello, world!"

You’ll also see tabs for the Sensu web UI and Grafana, which you’ll use later in this tutorial.

To get started with Sensu Go, let’s deploy a common Sensu stack. Run:

cd sandbox/sensu-go-docker && docker-compose up -d

This deploys these four stack components in Docker containers:

  • A Sensu backend
  • The Nginx web server that you’ll monitor
  • InfluxDB, which you’ll use to store metrics
  • Grafana, which you’ll use for visualization

We’ll cover InfluxDB and Grafana later. For now, to see the four Docker containers, run:

docker container list

You can also check out the Docker Compose file in the Sensu Go Docker sandbox.

Log in to the web UI

The Sensu web UI provides a unified view of your cloud and server monitoring events with powerful, user-friendly filtering tools that help operators respond to alerts efficiently.

To open the web UI in a new browser tab, select the Sensu web UI tab in the terminal. Log in with Sensu’s default admin credentials:

Right now, the web UI should be a blank slate: no incidents or entities. Select the ☰ icon in the web UI to explore the events, entities, and checks pages.

Next: Create a monitoring event