/sensu-go-plugin

Template repo for Sensu Go plugins

Primary LanguageGoMIT LicenseMIT

Bonsai Asset Badge TravisCI Build Status

Sensu Go CHANGEME Plugin

TODO: Table of Contents

Overview

If you're writing or updating a plugin's README, review the Sensu Community plugin README style guide for content suggestions and guidance.

TODO: Write an overview of the plugin's functionality.

Configuration

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 CHANGEME/sensu-CHANGEME:VERSION

If you're using an earlier version of sensuctl, you can find the asset on the Bonsai Asset Index.

Asset configuration

TODO: Provide an example asset manifest

---
type: Asset
api_version: core/v2
metadata:
  name: CHANGEME
spec:
  url: https://CHANGEME
  sha512: CHANGEME

Resource(CHANGEME to: check,filter,mutator,handler) configuration

Example Sensu Go definition:

---
api_version: core/v2
type: CHANGEME
metadata:
  namespace: default
  name: CHANGEME
spec:
  "...": "..."

Functionality

TODO: Document anything special needed for this plugin to function. Does it need an on-disk configuration? Does it require anything special to operate?

Installation from source and contributing

The preferred way of installing and deploying this plugin is to use it as an [asset]. If you would like to compile and install the plugin from source or contribute to it, download the latest version of the sensu-CHANGEME from releases or create an executable script from this source.

From the local path of the sensu-CHANGEME repository:

go build -o /usr/local/bin/sensu-CHANGEME main.go

For more information about contributing to this plugin, see https://github.com/sensu/sensu-go/blob/master/CONTRIBUTING.md