Updates the readme to be more readable/usable

sensu · Nov 6, 2019 · 513fa27 · 513fa27
1 parent ef81228
commit 513fa27
Showing 1 changed file with 128 additions and 41 deletions.
diff --git a/README.md b/README.md
@@ -1,5 +1,19 @@
+[![Bonsai Asset Badge](https://img.shields.io/badge/Sensu%20Prometheus%20Collector-Download%20Me-brightgreen.svg?colorB=89C967&logo=sensu)](https://bonsai.sensu.io/assets/sensu/sensu-prometheus-collector) [![Build Status](https://travis-ci.org/sensu/sensu-prometheus-collector.svg?branch=master)](https://travis-ci.org/sensu/sensu-prometheus-collector)
 ## Sensu Prometheus Collector
 
+- [Overview](#overview)
+- [Usage examples](#usage-examples)
+- [Configuration](#configuration)
+  - [Sensu Go](#sensu-go)
+    - [Asset manifest](#asset-manifest)
+    - [Check manifest(s)](#check-manifests)
+  - [Sensu Core](#sensu-core)
+    - [Check definition](#check-definition)
+    - [Handler definition](#handler-definition)
+- [Installation from source and contributing](#installation-from-source-and-contributing)
+
+### Overview
+
 The Sensu Prometheus Collector is a Sensu Check Plugin that collects
 metrics from a Prometheus exporter or the Prometheus query API. The
 collected metrics are outputted to STDOUT in one of three formats,
@@ -12,48 +26,8 @@ one or more time-series databases, for example InfluxDB and/or
 Graphite! Instrument your applications with the Prometheus libraries
 and immediately begin collecting your metrics with Sensu!
 
-### Installation
-
-Download the latest version of the `sensu-prometheus-collector` binary
-from
-[Releases](https://github.com/portertech/sensu-prometheus-collector/releases).
-
-### Configuration
-
-Example Sensu 1.x check definition:
-
-```
-{
-  "checks": {
-    "prometheus_metrics": {
-      "type": "metric",
-      "command": "sensu-prometheus-collector -exporter-url http://localhost:8080/metrics",
-      "subscribers": ["app_tier"],
-      "interval": 10,
-      "handler": "influx"
-    }
-  }
-}
-```
-
-Example Sensu 1.x handler definition:
-
-```
-{
-  "handlers": {
-    "influx": {
-      "type": "udp",
-      "mutator": "only_check_output",
-      "socket": {
-        "host": "influx.example.com",
-        "port": 8189
-      }
-    }
-  }
-}
-```
+### Usage examples
 
-### Usage Examples
 
 Help:
 
@@ -102,3 +76,116 @@ Prometheus query API:
 $ sensu-prometheus-collector -prom-url http://localhost:9090 -prom-query up
 up,instance=localhost:9090,job=prometheus value=1 1506991495
 ```
+
+### Asset registration
+
+Assets are the best way to make use of this handler. 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 sensu/sensu-prometheus-collector`
+
+If you're using an earlier version of sensuctl, you can download the asset definition from [this project's Bonsai Asset Index page](https://bonsai.sensu.io/assets/sensu/sensu-prometheus-collector).
+
+### Configuration
+
+#### Sensu Go
+
+##### Asset manifiest
+```yaml
+---
+type: Asset
+api_version: core/v2
+metadata:
+  name: sensu-prometheus-collector_linux_amd64
+  labels: 
+  annotations:
+    io.sensu.bonsai.url: https://bonsai.sensu.io/assets/sensu/sensu-prometheus-collector
+    io.sensu.bonsai.api_url: https://bonsai.sensu.io/api/v1/assets/sensu/sensu-prometheus-collector
+    io.sensu.bonsai.tier: Supported
+    io.sensu.bonsai.version: 1.1.6
+    io.sensu.bonsai.namespace: sensu
+    io.sensu.bonsai.name: sensu-prometheus-collector
+    io.sensu.bonsai.tags: check
+spec:
+  url: https://assets.bonsai.sensu.io/ef812286f59de36a40e51178024b81c69666e1b7/sensu-prometheus-collector_1.1.6_linux_amd64.tar.gz
+  sha512: a70056ca02662fbf2999460f6be93f174c7e09c5a8b12efc7cc42ce1ccb5570ee0f328a2dd8223f506df3b5972f7f521728f7bdd6abf9f6ca2234d690aeb3808
+  filters:
+  - entity.system.os == 'linux'
+  - entity.system.arch == 'amd64'
+```
+
+##### Check manifest
+
+```yaml
+---
+type: CheckConfig
+api_version: core/v2
+metadata:
+  name: sensu-prom-metrics
+  namespace: default
+spec:
+  check_hooks: null
+  command: sensu-prometheus-collector -exporter-url http://localhost:9182/metrics
+  output_metric_format: influxdb_line
+  output_metric_handlers:
+  - influxdb
+  runtime_assets:
+  - sensu/sensu-prometheus-collector
+  stdin: false
+  subdue: null
+  subscriptions:
+  - linux
+  timeout: 5
+  ttl: 0
+```
+
+#### Sensu Core
+
+##### Check definition
+
+```
+{
+  "checks": {
+    "prometheus_metrics": {
+      "type": "metric",
+      "command": "sensu-prometheus-collector -exporter-url http://localhost:8080/metrics",
+      "subscribers": ["app_tier"],
+      "interval": 10,
+      "handler": "influx"
+    }
+  }
+}
+```
+
+##### Handler definition
+
+```
+{
+  "handlers": {
+    "influx": {
+      "type": "udp",
+      "mutator": "only_check_output",
+      "socket": {
+        "host": "influx.example.com",
+        "port": 8189
+      }
+    }
+  }
+}
+```
+
+
+## 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][1]
+or create an executable script from this source.
+
+From the local path of the sensu-prometheus-collector repository:
+
+```
+go build -o /usr/local/bin/sensu-prometheus-collector main.go
+```
+
+If you'd like to contribute to this plugin, see https://github.com/sensu/sensu-go/blob/master/CONTRIBUTING.md
+
+[1]: https://github.com/sensu/sensu-prometheus-collector/releases
+[2]: #asset-registration