~derf / projects / icli v0.48
dark mode

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