Select Supported Platforms

Select Supported Architectures

Select Tier

Github Name

Asset Definition
Release Notes
Release Assets

Sensu Go Hangouts Chat Handler

Go Test
Sensu Bonsai Asset

The Sensu Go Hangouts Chat Handler is a Sensu Event Handler which manages
Hangouts Chat for alerting purposes. With this handler,
Sensu can alert systems administrators in Hangouts Chats.

This handler was inspired by hangouts ruby plugin.


Download the latest version of the sensu-hangouts-chat-handler from releases,
or create an executable script from this source.

From the local path of the sensu-hangouts-chat-handler repository:

go build -o /usr/local/bin/sensu-hangouts-chat-handler main.go


Example Sensu Go handler definition:

type: Handler
api_version: core/v2
  name: hangouts-chat
  namespace: default
  type: pipe
  command: sensu-hangouts-chat-handler
  - HANGOUTSCHAT_WEBHOOK="https://...."
  timeout: 10
  - betorvs/sensu-hangouts-chat-handler
  - is_incident

Example Sensu Go check definition:

type: CheckConfig
api_version: core/v2
  name: dummy-app-healthz
  namespace: default
  command: check-http -u http://localhost:8080/healthz
  - dummy
  - hangouts-chat
  interval: 60
  publish: true

Usage Examples


The Sensu Go Google Hangsout handler for alerting

  sensu-hangouts-chat-handler [flags]
  sensu-hangouts-chat-handler [command]

Available Commands:
  help        Help about any command
  version     Print the version number of this plugin

  -A, --annotations-as-link string   Parse Check.metadata.annotations as link to post in Hangouts Chat. e. prometheus_url
  -L, --descriptionLimit int         The maximum length of the description field (default 1500)
  -d, --descriptionTemplate string   The template for the description to be sent (default "{{.Check.Output}}")
  -h, --help                         help for sensu-hangouts-chat-handler
  -l, --messageLimit int             The maximum length of the message field (default 130)
  -m, --messageTemplate string       The template for the message to be sent (default "{{.Entity.Name}}/{{.Check.Name}}")
  -s, --sensuDashboard string        The HANGOUTS Chat Handler will use it to create a source Sensu Dashboard URL. Use HANGOUTSCHAT_SENSU_DASHBOARD. Example: http://sensu-dashboard.example.local/c/~/n (default "disabled")
  -w, --webhook string               The Webhook URL, use default from HANGOUTSCHAT_WEBHOOK env var
  -a, --withAnnotations              Include the event.metadata.Annotations in details to send to Hangouts Chat
  -W, --withLabels                   Include the event.metadata.Labels in details to send to Hangouts Chat

Use "sensu-hangouts-chat-handler [command] --help" for more information about a command.

Note: Make sure to set the HANGOUTSCHAT_WEBHOOK environment variable for sensitive credentials in production to prevent leaking into system process table. Please remember command arguments can be viewed by unprivileged users using commands such as ps or top. The --webhook argument is provided as an override primarily for testing purposes.

Argument Annotations

All arguments for this handler are tunable on a per entity or check basis based on annotations. The
annotations keyspace for this handler is


To change the team argument for a particular check, for that checks's metadata add the following:

type: CheckConfig
api_version: core/v2
  annotations: "https://LongWebhookURLHere"

Asset creation

The easiest way to get this handler added to your Sensu environment, is to add it as an asset from Bonsai:

sensuctl asset add betorvs/sensu-hangouts-chat-handler --rename sensu-hangouts-chat-handler

See sensuctl asset --help for details on how to specify version.



Are you sure you want to report this asset?

Please describe the reason for reporting this asset. Our moderators will be notified and will disable the asset if it is found to be inappropriate.


You must be signed in to report this asset.

Sign In with Github



Either download the source code:

Download Source

Or download the asset definition: