EC2 integration

The Sensu EC2 Handler plugin is a Sensu handler that checks an AWS EC2 instance and removes it from Sensu if it is not in one of the specified states.

NOTE: The Sensu EC2 Handler plugin is an example of Sensu’s deregistration integrations. To find more integrations, search Bonsai, the Sensu asset hub.


  • Tunable arguments: use Sensu annotations to set custom instance ID, instance ID labels, timeouts, and more in EC2.
  • Specify custom values for Sensu event metric points via metric tags.
  • Keep your AWS EC2 API token, username, and password secure with Sensu environment variables and secrets management.

Get the plugin

For a turnkey experience with the Sensu EC2 Handler plugin, use our curated, configurable quick-start template to integrate Sensu with your existing AWS EC2 workflows.

You can also add the Sensu EC2 Handler plugin with a dynamic runtime asset from Bonsai, the Sensu asset hub, to build your own workflow or integrate Sensu with your existing EC2 workflows. Dynamic runtime assets are shareable, reusable packages that make it easier to deploy Sensu plugins.

More resources

Set up a limited service account with the access and permissions required to automatically remove AWS EC2 instances using the Sensu EC2 Handler integration.