bolo send - Bolo Monitoring System Client
bolo send -t state name (ok|warning|critical|unknown) message string
bolo send -t counter name [increment-value]
bolo send -t sample name value [value ...]
bolo send -t key key1=value1 key2=value2 ...
bolo send -t event name [extra description ...]
./script | bolo send -t stream
bolo is a lightweight monitoring system kernel that aggregates counter
data and sample readings, maintains event and state information, and
broadcasts its findings to all connected *bolo subscribers*. These
subscribers can perform a wide variety of functions, from storing metric
data in RRDs to sending notifications on state changes.
bolo send is a client that connects to a bolo daemon and submits data.
-t, --type (state|counter|sample|key|event|stream)
Changes the behavior of bolo send. For all but *stream*, bolo send
will interpret the rest of its arguments as a single type of data to
For -t state, bolo send expects three arguments: a state name, a
status code (one of *ok*, *warning*, *critical* or *unknown*), and a
message. Any remaining arguments will be concatenated to the message
argument, separated by spaces (much like /bin/echo).
bolo send -t state cpu warning CPU is 96.3% used
For -t counter, provide the name of the counter and optionally, the
value to increment it by (which if not provided defaults to 1).
bolo send -t counter eth0.drops 44
bolo send -t counter logins
For -t sample, the name and one or more values must be provided.
Each value will be submitted. For example, to submit three network
bolo send -t sample packets-per-second 120.4 130.8 99.76
For -t key, you should supply one or more arguments, of the format
bolo send -t key hostname=host01 fqdn=host01.example.com
Finally, for -t event, all you need to provide is the event name;
the remaining arguments will be treated as extra data for the event,
separated by a single space.
bolo send -t event user.login jhacker logged in from 10.0.0.233
Stream mode (-t stream) allows the caller to submit multiple types
of data within a single session, by reading specially-formatted
lines on standard input.
Known commands for stream mode are:
SAMPLE [ ...]
KEY = ...
-e, --endpoint *tcp://host:port*
The bolo listener to connect to. Defaults to *tcp://127.0.0.1:2999*.
Supports DNS resolution for both IPv4 and IPv6 endpoints.
bolo(7) for general information,
bolo(1) and bolo.conf(5) for documentation on the CLI tools,
dbolo(1), dbolo.conf(5) for details on the distributed bolo agent,
and read about subscribers in bolo2rrd(8), bolo2pg(8), bolo2meta(8), and
Bolo was designed and written by James Hunt and Dan Molik.