DragonFly On-Line Manual Pages
ICLI(1) User Contributed Perl Documentation ICLI(1)
NAME
icli - Icinga Command Line Interface
SYNOPSIS
icli [-v|-vv] [-z filter] [-h hosts] [-g hostgroups] [-s services] [-c
config] [-C] [-f status-file] [-F rw-file] [-r|-u|-lh|-ls|-lq|-ld]
[host/service ...]
VERSION
version 0.47
DESCRIPTION
icli is a command line interface to Icinga. By default it lists all
services and their states.
Note that when supplying custom config and status file paths, icli also
works with Nagios. 100% compatibility is not guaranteed, however.
icli only works when executed on the host running the Icinga daemon.
To use it on another host, shell aliases (like "alias icli='ssh
$icingahost icli'") or similar are recommended.
You can narrow down the list of services you want displayed either
using filters (like "icli -z!o"), the -h/-s arguments ("icli -h
aneurysm -s Libraries,Websites") or commandline args ("icli
aneurysm/{Libraries,Websites}" with shell expansion).
OPTIONS
-a|--acknowledge comment
Acknowledge all matching services with string comment. This creates
a sticky acknwoledgment with notification and no expire time. The
comment will not be persistent.
Note: Acknowledgement of host problems is not yet supported.
-c|--config config
Read config from file
-C|--no-colours
Disable colours in output
-f|--status-file file
Read the status from file
-F|--rw-file file
Use file as external commands file.
-g|--hostgroup hostgroup
Limit selection to hosts in hostgroup (comma separated list)
-h|--host hosts
Limit selection to hosts (comma separated list)
-l|--list downtimes|hosts|services|queue
List either services (the default) or hosts. Note that only the
first character of the argument is checked, so "icli -lh", "icli
-ls" etc. are also fine.
-m|--match regex
Limit selection to hosts/services whose plugin output matches regex
(perl regular expression, case insensitive. see perlre).
-o|--overview
Display "tactical overview"-style overview. By default (or when
used with "-ls") the number of all hosts and services (both total
and divided by their state) is shown.
When used with "-lh", lists all hosts with the number of ok /
warning / ... checks on each host.
-r|--recheck
Schedule an immediate recheck of all selected services
-u|--force-recheck
Schedule a forced, immediate recheck of all selected services
-U|--as-contact name
Only operate on service visible to name. Doesn't work for -lh yet,
most useful for -ls.
NOTE: This is meant to help find out which services a user has
access to. It is NOT intended as a way to restrict access and
should never be used that way.
-s|--service services
Limit selection to services (comma separated lists). Can be
combined with -h/-g to further narrow down the selection, but may
also be used stand-alone.
-v|--verbose
Increase output verbosity. Can be combined up to -vvv
-V|--version
Show version information
-x|--cut-mode mode
What to do with lines which are too long for the terminal: nothing,
cut off, line break (with proper indentation). The default is line
breaks
-z|--filter expression
Limit selection to hosts/services passing the filter. expression
is a comma separated list of filters, only hosts/services to which
all filters apply are selected. See also "FILTER EXPRESSIONS"
OUTPUT
SERVICE LISTING
This is the standard output method. It contains the following:
o Service description
o -v: Service Flags (Acknowledged, Flapping, Passive, !no checks)
o Service state (ok / warning / critical / unknown)
o -v: Current attempt / Max attempts
o Plugin output
HOST LISTING
Enabled with -ld
o Host name
o Host state (ok / down / unreachable)
o -v: Current attempt / Max attempts
o Plugin output
QUEUE LISTING
Enabled with -lq
o Host name
o Service name
o Last check
o Next check
FILTER EXPRESSIONS
Each expression can be negated with an exclamation mark, e.g. "!A" for
all non-acknowledged services.
A Check state has been acknowledged
D The host this service belongs to is Down or Unreachable
F Service is flapping between states
N Notifications for this service are disabled
P Only passive checks are enabled. Note that !P simply means that
active checks are enabled, no matter the status of passive checks
S Check state is soft. For instance, it used to be OK and is now
critical, but has not reached its maximum number and caused a
notification yet. Good to find (or ignore) service problems which
might just be temporary, non-critical glitches.
o Host/Service state is OK
w Service state is Warning
c Service state is Critical
u Service state is Unknown
p Host or service state is Pending
d Host state is Down
x Host state is Unreachable
EXIT STATUS
Zero, unless errors occured.
CONFIGURATION
None.
DEPENDENCIES
o autodie (included with perl >= 5.10.1)
o Term::Size
BUGS AND LIMITATIONS
This software is in early development stages. So there will probably be
quite a lot.
REPORTING BUGS
Either via mail to <derf@finalrewind.org> or on
<http://github.com/derf/icinga-cli/issues>.
EXAMPLES
"icli -r -s 'APT Updates'"
Schedule a check of the "APT Updates" service on all hosts having
it
"icli -lq -h aneurysm -g chaosdorf-hosts"
List check queue for all hosts in the hostgroup "chaosdorf-hosts",
plus the host aneurysm
"icli -z!o,!A,!S,!D"
Show all service problems which are already hard states and have
not yet been acknowledged. Also weed out problem services on hosts
which are down anyways
AUTHOR
Copyright (C) 2010 by Daniel Friesel <derf@finalrewind.org>
LICENSE
0. You just DO WHAT THE FUCK YOU WANT TO.
perl v5.20.2 2015-08-12 ICLI(1)