~derf / projects / icli v0.48

This project is no longer being developed. There will be no updates and no security fixes. This page serves archival purposes only.

Command line interface to Icinga.


  • Listing of service/host states, check queue or downtimes
  • Detailed service/host info
  • Scheduling of service rechecks and downtimes, problem acknowledgement
  • Detailed filtering (host(group)/service name, state, passive, acknowledged, etc.)
  • Mostly nagios-compatible

Future plans

  • Custom output formats
  • Support for web API (only works locally at the moment)

See also: icli on GitHub.


Standard list mode

Detailed service list

Using filters


App::Icli v0.48

App-Icli-0.48.tar.gz (signature)

  • New dependencies: DateTime, DateTime::Format::Strptime, DateTime::TimeZone
  • NOT BACKWARDS COMPATIBLE: Add -a/--action option to invoke generic actions on selected services. This replaces -a/--acknowledge with -aa/ -a acknowledge, -r/--recheck with -ar / -a recheck and -u/--force-recheck wiht -aR / -a force_recheck
  • add -ad / -a downtime option to schedule host/service downtimes
  • Also show service downtimes when using -ld, improve its output
  • Show service comments when using -vvv
  • Rename package to App::Icli to avoid CPAN namespace conflicts

icli v0.47

icli-0.47.tar.gz (signature)

  • Remove autodie dependency, improve error messages
  • Allow build-time specification of icinga paths (perl Build.PL --icli-xyz-file=..., see README)
  • Do not throw warnings when encountering empty contact groups
  • Do not require --recheck when using --force-recheck
  • Support --force-recheck with a host-only argument to immediately recheck all services on a host (closses #15)
  • Fix -lh not showing serviceless hosts (closes #14)

icli v0.46

icli-0.46.tar.gz (signature)

  • Fix !o filter not matching pending services
  • Add p filter (pending hosts/services)
  • Show pending hosts/services with --overview
  • Remove Date::Format dependency (now uses POSIX::strftime)

icli v0.45

icli-0.45.tar.gz (signature)

  • Fix --filter N and --filter !N
  • Ignore 'serviceescalation' field in the icinga status file
  • fix smartmatch warnings on perl ≥ 5.018

icli v0.44

icli-0.44.tar.gz (signature)

  • Ignore module field in the icinga status file
  • Add -o / --overview option to display a 'tactical overview'-style host and service listing

icli v0.43

icli-0.43.tar.gz (signature)

  • Add missing documentation for -a / --acknowledge
  • Add -m / --match option to select on plugin output

icli v0.42

icli-0.42.tar.gz (signature)

  • Add -U / --as-contact option to only operate on services visible to a certain contact
  • New dependency List::MoreUtils

icli v0.41

icli-0.41.tar.gz (signature)

  • Add icli host/service as icli -h host -s service shortcut
  • Add -u / --force-recheck option (Patch by Hugh Brown)

icli v0.4

icli-0.4.tar.gz (signature)

  • icli -vvv lists hosts/services with maximum verbosity
  • Acknowledging of host/service problems
  • Cut off or break long lines with -x (improves output readability)
  • Print long plugin output in -vv/-vvv (if available)
  • Fix -C (didn't remove all colours)

icli v0.3

icli-0.3.tar.gz (signature)

  • Show service flags with -v -ls (acknowledged, flapping etc.)
  • Filter hosts/services by check state or various flags
  • icli -vv lists hosts/services in an even more detailed manner

icli v0.2

icli-0.2.tar.gz (signature)

  • List downtimes and check queue
  • Reschedule service checks
  • Filter by host/hostgroup and/or service name

icli v0.1

icli-0.1.tar.gz (signature)

  • First release
  • listing of service/host states, filtered by hosts/hostgroups