License
Other
Baseline health and metric checks for Sensu, written in go.
Almost all subcommands support the --metrics
option (there is no short form to it), which suppresses health checks, and emits measurements in OpenTSDB format.
This check is modeled after sensu-plugins-disk-checks' check-disk-usage.rb script.
Usage:
sensu-base-checks filesystem [flags]
Flags:
-c, --bcrit float Critical if PERCENT or more of filesystem full; (0,100] (default 95)
-w, --bwarn float Warn if PERCENT or more of filesystem full; (0,100] (default 85)
-M, --excmnt strings Ignore mount points
-o, --excopt strings Ignore options
-p, --excpath string Ignore path regular expression
-T, --exctype strings Ignore filesystem types
-h, --help help for filesystem
-C, --icrit float Critical if PERCENT or more of inodes used; (0,100] (default 95)
-m, --incmnt strings Include mount points
-t, --inctype strings Filter for filesystem types
-W, --iwarn float Warn if PERCENT or more of inodes used; (0,100] (default 85)
-x, --magic float Magic factor to adjust warn/crit thresholds; (0,1] (default 1)
--metrics Output measurements in OpenTSDB format
-l, --minimum int Minimum size to adjust (ing GB) (default 100)
-n, --normal int Levels are not adapted for filesystems of exactly this size (GB). Levels reduced below this size, and raised for larger sizes. (default 20)
It filters filesystems, in a way that it enumerates all not explicitly excluded or explicitly included ones. In practice, it means all inclusion options are affecting as a veto for exclusion options.
This command goes through all the selected filesystems, and enumerates free space / inode size (unix only) on them, comparing to a common percentage (free/size). For large filesystems, percentage calculation can be distorted by magic
, minimum
, and normal
options using the following expression, when the filesystem size is larger than minimum
filesystem size:
100 - (100 - percent) * (size/normal)^(magic-1)
Examples for 95% full filesystems, with 20G normal size:
FS size | magic | distorted percentage |
---|---|---|
1 TB | 0.95 | 95.892 |
1 TB | 0.9 | 96.625 |
1 TB | 0.5 | 99.3 |
10 TB | 0.95 | 96.34 |
10 TB | 0.9 | 97.32 |
10 TB | 0.5 | 99.779 |
The command aggregates all the errors, showing all warning / critical level alerts, and it returns with the highest criticality issue it encountered.
When --metrics
is provided, it returns
Tags:
This command has been modeled after sensu-plugins-http's check-http.rb and check-http-json.rb scripts.
This check runs a HTTP query, and inspects return values. Returns
Timeout duration can be provided in short range (eg. ms, s, m, h), cert expiry
can be provided with longer range too (like d, w, mo).
Usage:
sensu-base-checks http [flags]
Flags:
-d, --body string HTTP body
-C, --ca string CA Certificate file
-c, --cert string Certificate file
-e, --expiry string Warn EXPIRY before cert expires (duration, like 5d)
-H, --header strings HTTP header
-h, --help help for http
-k, --insecure Enable insecure connections
-K, --json-key string JSON key selector in JMESPath syntax
-V, --json-val string expected value for JSON key in string form
-X, --method string HTTP method (default "GET")
--metrics Output measurements in OpenTSDB format
-R, --redirect string Expect redirection to
-r, --response uint HTTP error code to expect; use 3-digits for exact, 1-digit for first digit check (default 2)
-t, --timeout string Connection timeout (default "5s")
-u, --url string Target URL (default "http://127.0.0.1:80/")
-A, --user-agent string User agent
This command checks for:
The JSON check uses JMESPath to identify the key, and it converts the value to string using Go's default format (%v).
When --metrics
is provided, it shows the following measurements:
Provided tags:
This command checks for system time to be in operation limits, or it provides this data as metrics.
Measures and warns on system clock time drifts.
Usage:
sensu-base-checks time [flags]
Flags:
-c, --crit string Crit on drift higher than this duration (default "5s")
-h, --help help for time
--metrics Output measurements in TSDB format
-s, --server string NTP server used for drift detection (default "pool.ntp.org")
-w, --warn string Warn on drift higher than this duration (default "1s")
When --metrics
is provided, it returns a single value as time.ntp.offset
, in microseconds.
There are three goals for this project:
This project is licensed under Blue Oak Model License v1.0.0. It is not registered either at OSI or GNU, therefore GitHub is widely looking at the other direction. However, this is the license I'm most happy with: you can read and understand it with no legal degree, and there are no hidden or cryptic meanings in it.
The project is also governed with Contributor Covenant's Code of Conduct in mind. I'm not copying it here, as a pledge for taking the verbatim version by the word, and we are not going to modify it in any way.
Open a ticket, perhaps a pull request. We support GitHub Flow. You might want to fork this project first.
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.
×