Select Supported Platforms

Select Supported Architectures

Select Tier

Github Name


v0.5.1 · public · Published about 2 months ago

README
Asset Definition
Release Notes
Release Assets

Sensu Bonsai Asset
Go Test
goreleaser

Sensu Go Flowdock Handler

Overview

The Senso Go Flowdock Handler is a Sensu Event Handler for sending incident notifications to CA Flowdock.

Files

N/A

Usage examples

Help

The Sensu Go Flowdock handler for sending notifications

Usage:
  sensu-go-flowdock-handler [flags]

Flags:
  -a, --autherAvatar string     Avatar URL (default "https://avatars1.githubusercontent.com/u/1648901?s=200&v=4")
  -n, --authorName string       Name for the auther of the thread (default "Sensu")
  -b, --backendURL string       The URL for the backend, used to create links to events
  -u, --flowdockAPIURL string   The Flowdock API URL (default "https://api.flowdock.com/messages")
  -t, --flowdockToken string    The Flowdock application token
  -h, --help                    help for sensu-go-flowdock-handler
  -i, --includeNamespace        Include the namespace with the entity name in title and thread ID
  -l, --labelPrefix string      Label prefix for entity fields to be included in thread

Configuration

Sensu Go

Asset registration

Assets are the best way to make use of this plugin. If you're not using an asset, please consider doing so! If you're using sensuctl 5.13 or later, you can use the following command to add the asset:

sensuctl asset add nixwiz/sensu-go-flowdock-handler

If you're using an earlier version of sensuctl, you can download the asset definition from this project's Bonsai asset index page or one of the existing releases or create an executable script from this source.

From the local path of the sensu-go-flowdock-handler repository:

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

Asset definition

---
type: Asset
api_version: core/v2
metadata:
  name: sensu-go-flowdock-handler
spec:
  url: https://assets.bonsai.sensu.io/32c48319cfe4c2620aaf057a62cd5140be57633e/sensu-go-flowdock-handler_0.4.0_linux_amd64.tar.gz
  sha512: e4419af45c367cddd461b6d324f63043c476ed11a2d2e078d9f43eb7ccd87d988e986307324116379f2b9ee62ddbf0c84487a260d0aefadde78ff5143d4377d3

Handler definition

{
    "api_version": "core/v2",
    "type": "Handler",
    "metadata": {
        "namespace": "default",
        "name": "flowdock"
    },
    "spec": {
        "type": "pipe",
        "command": "sensu-go-flowdock-handler -t 0123456789abcdef0123456789abcdef -b http://sensu-backend.example.com:3000",
        "timeout": 10,
        "filters": [
            "is_incident",
            "not_silenced"
        ]
    }
}

Sensu Core

N/A

Installation from source

Sensu Go

See the instructions above for asset registration.

Sensu Core

Install and setup plugins on Sensu Core.

Additional notes

Flowdock Configuration

This handler makes use of Flowdock's "new" Integration API mechanism. This means creating a developer application
and then a source. This source will have the API Token needed by this handler.

Note: Actions for these messages are not implemented.

Usage Examples

Environment Variables and Annotations

Environment Variable Setting Annotation
SENSU_FLOWDOCK_TOKEN same as -t / --flowdockToken sensu.io/plugins/flowdock/flowdockToken
SENSU_FLOWDOCK_BACKENDURL same as -b / --backendURL sensu.io/plugins/flowdock/backendURL
N/A same as -n / --authorName sensu.io/plugins/flowdock/authorName
N/A same as -a / --authorAvatar sensu.io/plugins/flowdock/authorAvatar

Precedence

environment variable < command-line argument < annotation

Usage of entity labels to add fields to output

This handler can make use of labels provided by the entity to populate addtional fields in the thread.

---
##
# agent configuration
##
#name: ""
namespace: "default"
subscriptions:
  - linux
backend-url:
  - "ws://127.0.0.1:8081"

labels:
  flowdock_Application: "webapp1"
  flowdock_Environment: "live"

Sample in Flowdock

Below is a thread sample that includes surfacing the labels defined above.

Flowdock Sample

Contributing

N/A

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

Download

×

Either download the source code:

Download Source

Or download the asset definition: