README
¶
Sensu Go
CircleCI: 
Sensu is an open source monitoring tool for ephemeral infrastructure and distributed applications. It is an agent based monitoring system with built-in auto-discovery, making it very well-suited for cloud environments. Sensu uses service checks to monitor service health and collect telemetry data. It also has a number of well defined APIs for configuration, external data input, and to provide access to Sensu's data. Sensu is extremely extensible and is commonly referred to as "the monitoring router".
To learn more about Sensu, please visit the website and read the documentation.
What is Sensu Go?
Sensu Go is a complete rewrite of Sensu in Go, with new capabilities and reduced operational overhead. It eliminates several sources of friction for new and experienced Sensu users.
The original Sensu required external services like Redis or RabbitMQ. Sensu Go can rely on an embedded etcd datastore for persistence, making the product easier to get started with. External etcd services can also be used, in the event that you already have them deployed.
Sensu Go replaces Ruby expressions with JavaScript filter expressions, by embedding a JavaScript interpreter.
Unlike the original Sensu, Sensu Go events are always handled, unless explicitly filtered.
Installation
Sensu Go installer packages are available for a number of computing platforms (e.g. Debian/Ubuntu, RHEL/Centos, etc), but the easiest way to get started is with the official Docker image, sensu/sensu.
See the installation documentation to get started.
Contributing
For guidelines on how to contribute to this project, how to hack on Sensu, and information about what we require from project contributors, please see CONTRIBUTING.md.
Sensu is and always will be open source, and we continue to highly value community contribution. The packages we’re releasing for new versions are from our Enterprise repo; Sensu Go is the upstream for Sensu Enterprise (as they’d say in the Go community: Sensu Go is vendored into the Sensu Enterprise Go repo). We encourage you to download new versions, as the functionality will be identical to what you find in the public repo, and access to the enterprise-only features can be unlocked with a license key. Because these releases are in our Enterprise repo, there may be times that you don’t see the actual work being done on an issue you open, but that doesn’t mean we’re not working on it! Our team is committed to updating progress on open issues in the sensu-go repo, even if that work is being done in our Enterprise repo.
Directories
¶
| Path | Synopsis |
|---|---|
|
Package agent is the running Sensu agent.
|
Package agent is the running Sensu agent. |
|
api
|
|
|
Package asset provides a mechanism for installing, managing, and utilizing Sensu Assets.
|
Package asset provides a mechanism for installing, managing, and utilizing Sensu Assets. |
|
etcd
Package etcd manages the embedded etcd server that Sensu uses for storing state consistently across sensu-backend processes.
|
Package etcd manages the embedded etcd server that Sensu uses for storing state consistently across sensu-backend processes. |
|
messaging
Package messaging provides the means of coordination between the different components of the Sensu backend.
|
Package messaging provides the means of coordination between the different components of the Sensu backend. |
|
pipelined
Package pipelined provides the traditional Sensu event pipeline.
|
Package pipelined provides the traditional Sensu event pipeline. |
|
cmd
|
|
|
sensuctl
Use a windows-only main file in order to get an .exe when cross compiling.
|
Use a windows-only main file in order to get an .exe when cross compiling. |
|
Package command provides system command execution.
|
Package command provides system command execution. |
|
integration
Package contains only tests.
|
Package contains only tests. |
|
Package js provides facilities based on the Otto VM for parsing and executing javascript expressions.
|
Package js provides facilities based on the Otto VM for parsing and executing javascript expressions. |
|
Package rpc defines extension points for Sensu that can be used by third parties to extend Sensu.
|
Package rpc defines extension points for Sensu that can be used by third parties to extend Sensu. |
|
extension
Package extension provides types and functions for creating Sensu extensions in Go.
|
Package extension provides types and functions for creating Sensu extensions in Go. |
|
extension/example
This program is a sensu extension.
|
This program is a sensu extension. |
|
scripts
|
|
|
Package system provides information about the system of the current process.
|
Package system provides information about the system of the current process. |
|
testing
|
|
|
util
|
|