Select Supported Platforms

Select Supported Architectures

Select Tier

Github Name


asachs01/sensu-go-cpu-check (4) Versions 0.0.4 Community Tier

A CPU check for Sensu Go

Downloads in last month
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0
Commits in last year
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,9,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0
README
Release Notes

Bonsai Asset Badge TravisCI Build Status

Sensu Go CPU Check

This plugin provides a check for system CPU utilization for Sensu Go. The sensu-go-cpu-check check takes the flags -w (warning) and -c (critical) and a desired duration utilization percentage after each flag. By default, these are a warning value of 75% and a critical value of 90%. This check also outputs data as nagios_perfdata(for more information, see this Nagios documentation article. This allows for the check to be used as both a status check and a metric check. You can see an example of this in the example check definition below.

Usage Examples

Command line help

The Sensu Go check for system CPU usage

Usage:
  sensu-go-cpu-check [flags]

Flags:
  -c, --critical string   Critical value for system cpu (default "90")
  -h, --help              help for sensu-go-cpu-check
  -w, --warning string    Warning value for system cpu. (default "75")

Example Output

./sensu-go-cpu-check
CheckCPU OK - value = 39.50 | system_cpu=39.50

Configuration

Asset registration

Assets are the best way to make use of this check. If you're not using an asset, please consider doing so! You can find this asset on the Bonsai Asset Index.

Asset definition

You can download the asset definition there, or you can do a little bit of copy/pasta and use the one below:

---
type: Asset
api_version: core/v2
metadata:
  name: sensu-go-cpu-check
  namespace: CHANGEME
  labels: {}
  annotations: {}
spec:
  url: https://github.com/asachs01/sensu-go-cpu-check/releases/download/0.0.1/sensu-go-cpu-check_0.0.1_linux_amd64.tar.gz
  sha512: 
  filters:
  - entity.system.os == 'linux'
  - entity.system.arch == 'amd64'

NOTE: PLEASE ENSURE YOU UPDATE YOUR URL AND SHA512 BEFORE USING THE ASSET. If you don't, you might just be stuck on a super old version. Don't say I didn't warn you ¯\(ツ)

Check definition

Example Sensu Go definition:

sensu-go-cpu-check

type: CheckConfig
api_version: core/v2
metadata:
  name: sensu-go-cpu-check
  namespace: CHANGEME
spec:
  command: sensu-go-cpu-check -w 80 -c 95
  runtime_assets:
  - sensu-go-cpu-check
  interval: 60
  publish: true
  output_metric_format: nagios_perfdata
  output_metric_handlers:
  - infuxdb
  handlers:
  - slack
  subscriptions:
  - system

Installation from source and contributing

While it's generally recommended to use an asset, you can download a copy of the handler plugin from releases,
or create an executable script from this source.

From the local path of the sensu-go-cpu-check repository:

sensu-go-cpu-check

go build -o /usr/local/bin/sensu-go-cpu-check main.go

To contribute to this repo, see https://github.com/sensu/sensu-go/blob/master/CONTRIBUTING.md.

Additional notes

Supported operating systems

This project uses gopsutil, and is thus largely dependent on the systems that it supports. For this plugin, the following operating systems are supported:

  • Linux
  • FreeBSD
  • OpenBSD
  • Mac OS X
  • Windows
  • Solaris

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