Sensu memory and swap usage checks
Table of Contents
Overview
The Sensu memory usage checks are a collectoin of Sensu Checks that provide alerting and metrics for memory and swap usage. Metrics are provided in nagios_perfdata format.
Checks
This collection contains the following checks:
check-memory-usage
- for checking memory usagecheck-swap-usage
- for checking swap usage
Usage examples
check-memory-usage
Check memory usage and provide metrics
Usage:
check-memory-usage [flags]
check-memory-usage [command]
Available Commands:
help Help about any command
version Print the version number of this plugin
Flags:
-c, --critical float Critical threshold for overall memory usage (default 90)
-w, --warning float Warning threshold for overall memory usage (default 75)
-h, --help help for check-memory-usage
Use "check-memory-usage [command] --help" for more information about a command.
check-swap-usage
Check swap usage and provide metrics
Usage:
check-swap-usage [flags]
check-swap-usage [command]
Available Commands:
help Help about any command
version Print the version number of this plugin
Flags:
-c, --critical float Critical threshold for overall swap usage (default 90)
-w, --warning float Warning threshold for overall swap usage (default 75)
-h, --help help for check-memory-usage
Use "check-swap-usage [command] --help" for more information about a command.
Configuration
Asset registration
Sensu 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 with Sensu Backend 5.13 or later, you can use the following command to add the asset:
sensuctl asset add sensu/check-memory-usage
If you're using an earlier version of sensuctl, you can find the asset on the Bonsai Asset Index.
Check definitions
check-memory-usage
---
type: CheckConfig
api_version: core/v2
metadata:
name: check-memory-usage
namespace: default
spec:
command: >-
check-memory-usage
--critical 90
--warning 80
output_metric_format: nagios_perfdata
output_metric_handlers:
- influxdb
subscriptions:
- system
runtime_assets:
- sensu/check-memory-usage
check-swap-usage
---
type: CheckConfig
api_version: core/v2
metadata:
name: check-swap-usage
namespace: default
spec:
command: >-
check-swap-usage
--critical 90
--warning 75
output_metric_format: nagios_perfdata
output_metric_handlers:
- influxdb
subscriptions:
- system
runtime_assets:
- sensu/check-memory-usage
Installation from source
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 or create executables from this source.
From the local path of the check-cpu-usage repository:
go build ./cmd/check-memory-usage/
go build ./cmd/check-swap-usage/
Contributing
For more information about contributing to this plugin, see Contributing.