sensu-enterprise-metrics's Introduction

Sensu Enterprise Metrics Collector

TravisCI:

The Sensu Go check plugin for collecting Sensu Enterprise (Classic) metrics.

Installation

Download the latest version of the sensu-enterprise-metrics from releases, or create an executable script from this source.

From the local path of the sensu-enterprise-metrics repository:

go build -o /usr/local/bin/sensu-enterprise-metrics main.go

Configuration

Example Sensu Go check definition:

{
    "api_version": "core/v2",
    "type": "CheckConfig",
    "metadata": {
        "namespace": "default",
        "name": "sensu-enterprise-metrics"
    },
    "spec": {
        "command": "sensu-enterprise-metrics -user username -password secret -latest",
        "subscriptions":[
            "sensu-enterprise"
        ],
        "publish": true,
        "interval": 10,
        "output_metric_format": "graphite_plaintext",
        "output_metric_handlers": [
            "influxdb"
        ]
    }
}

Usage Examples

Help:

$ sensu-enterprise-metrics -h
Usage of sensu-enterprise-metrics:
  -ca-cert string
    	Path to CA certificate
  -host string
    	Sensu Enterprise API host. (default "localhost")
  -insecure-skip-verify
    	Don't verify TLS hostnames
  -latest
    	Only return the latest point per Enterprise metric.
  -password string
    	Sensu Enterprise API password.
  -port int
    	Sensu Enterprise API port. (default 4567)
  -scheme string
    	Sensu Enterprise URL scheme (http or https) (default "http")
  -timeout int
    	Sensu Enterprise API request timeout (in seconds). (default 15)
  -user string
    	Sensu Enterprise API user.

Contributing

See https://github.com/sensu/sensu-go/blob/master/CONTRIBUTING.md

sensu-enterprise-metrics's People

Contributors

Watchers

sensu-enterprise-metrics's Issues

Plugin appears to report incorrect metrics

When curling the metrics endpoint, I see that there are 16,000+ clients:

{"metric":"clients","points":[[1587761650,16077],[1587761660,16077]

However, this plugin is reporting significantly less, against the same host:

sensu_enterprise_clients 576 1587761710
sensu_enterprise_clients 471 1587761720
sensu_enterprise_clients 463 1587761730
sensu_enterprise_clients 494 1587761740
sensu_enterprise_clients 492 1587761750
sensu_enterprise_clients 482 1587761760
sensu_enterprise_clients 566 1587761770
sensu_enterprise_clients 468 1587761780
sensu_enterprise_clients 505 1587761790

Readme should provide example Sensu 1.x check definition

The readme currently describes usage with Sensu Go and some Enterprise users may need to collect metrics with Sensu 1.x as part of their approach when upgrading to Go.