Icinga 2 v2.7.1 bugfix release

We’ve come around several issues with Icinga 2 v2.7.0 and fixed them with this new v2.7.1 release. It also contains other bug fixes requested by Icinga partners and their customer support (Livestatus, DB IDO downtimehistory).
There also was an issue with large configuration files being synced in distributed environments. Aside from the bugfix the configuration sync logs now tell you how many bytes will be synced for better debugging low bandwidth issues. Cluster setups could also run into the problem that the “Downtime End” event was not correctly updated in the IDO database history tables. (more…)

Monthly Snap June: Icinga Camp Amsterdam, OSMC, RHEL Kernel, Debian Stretch & Release updates

June brought warm weather, cool events and new release updates. We’ve enjoyed Amsterdam quite a bit after the stressful week with the Kernel problems on RedHat. We’ve also learned more cool things about NagVis 1.9 and Debian Stretch. Read on below.
July is on its way and vacation aka offline not-on-call starts hopefully soon 🙂

Monthly Snap May: Events, Integrations & Community Updates

This time we’re focusing on many cool integrations, past and upcoming events and even more with and around Icinga.
We’ve celebrated eight years Icinga in May – hooray!
Currently we are working on Icinga 2 v2.7 to be released in June. This will include certain enhancements for performance and metrics. I’m writing a blog post soon. We are also pushing resources into Icinga Exchange and our new backend. Many things cooking under the hood, and soon to be shared with insights.
One of them is new build infrastructure which has been released this week. Built with Jenkins and Puppet and developed in the open. All involved scripts, modules and a Vagrant test environment can be found on GitHub. You’ll also recognise a new theme on packages.icinga.com 🙂

Vagrant box playtime

vagrant_icingaweb2_dashboardWhile preparing for our OSMC booth and talk, we thought about enhancing the existing Vagrant boxes and include more demo cases. While the icinga2x-cluster boxes illustrate the cluster in a master-checker setup, the standalone box icinga2x focuses on a single Icinga 2 instance with Icinga Web 2 and the Icinga 2 API.
Alongside the Icinga 2 API and Icinga Web 2 there are numerous additions to the icinga2x Vagrant box:


vagrant_icinaweb2_detail_graphs_ttsPNP4Nagios is installed from the EPEL repository. The Icinga 2 Perfdata feature ensures that performance data files are written and the NPCD daemon updates the RRD files. Navigate to the host or service detail in Icinga Web 2 and watch the beautiful graphs. There’s also a menu entry in Icinga Web 2 providing an iframe to the PNP web frontend on its own.


There are demo comments including a ticket id inside the Vagrant box. A simple script feeds them into the Icinga 2 API and the Icinga Web 2 module takes care of parsing the regex and adding a URL for demo purposes.

Business Process

vagrant_icingaweb2_business_processThe box provides 2 use cases for a business process demo: web services and mysql services. In order to check the MySQL database serving DB IDO and Icinga Web 2, we’ve added the check_mysql_health plugin (Icinga 2 v2.4 also provides a CheckCommand inside the ITL <plugins-contrib> already, so integration is a breeze).
These Icinga 2 checks come configured as Business Processes in the Icinga Web 2 module which also allows you to change and simulate certain failure scenarios. You’ll also recognise a dashboard item for the Top Level View allowing you to easily navigate into the BP tree and the host and service details. Pretty cool, eh?


vagrant_icingaweb2_nagvisThe puppet module installs the latest stable NagVis release and configures the DB IDO as backend. The integration into Icinga Web 2 uses a newly developed module providing a more complete style and integrated authentication for the NagVis backend. Though there are no custom dashboards yet – send in a patch if you have some cool ones 🙂


vagrant_graphite_webThe Graphite backend installation is helped with Puppet modules, the main difference is that Graphite Web VHost is listening on port 8003 by default (80 is reserved for Icinga Web 2). The carbon cache daemon is listening on 2003 where the Icinga 2 Graphite feature is writing the metrics to.


vagrant_grafanaGrafana 2 uses Graphite Web as datasource. It comes preconfigured with the Icinga 2 dashboard providing an overview on load, http, mysql metrics and allows you to easily modify or add new graphs to your dashboard(s).


vagrant_dashingWe’ve had a Dashing demo using the Icinga 2 API with us at Icinga Camp Portland though it required some manual installation steps. Since the Vagrant box already enabled the Icinga 2 API, the provisioner now also installs Dashing and the demo files. Note: Installing the Ruby gems required for Dashing might take a while depending on your internet connection. If Dashing is not running, call `restart-dashing`.


The icinga2x box requires a little more resources so make sure to have 2 cpu cores and 2 GB RAM available. You’ll need Vagrant and Virtualbox or Parallels installed prior to provision the box.

git clone https://github.com/Icinga/icinga-vagrant.git
cd icinga-vagrant/icinga2x
vagrant up

The initial provisioning takes a while depending on your internet connection.
Each web frontend is available on its own using the host-only network address

Icinga Web 2 icingaadmin/icinga
Graphite Web
Grafana 2 admin/admin

In the future we’ll add more Icinga Web 2 modules or other addons, just let us know what you want to play with or send a patch even 🙂

Addons for Icinga: Visualisation & Maps

There is a wealth of information that can be gathered by Icinga’s monitoring core. The question is, how best to visualise it? To complement the Icinga Classic and Icinga Web UIs, there are plenty of great addons to map your network with real time status information, connect the dots in monitoring business processes and even see the temperature distribution in a data center. Below are just a couple examples – the possibilities are endless.
NagVisNagVis is an Icinga compatible addon that displays colour-coded, monitoring information in myriad ways – on network maps, server-rack photos, maps of data centers and geographical regions. As it also supports the Business Process Addons for Nagios and Icinga, it too can offer visuals that connect the chain of business processes and their consequent availability.
Requisites: Icinga Core with IDOUtils (with MySQL database and MKLivestatus), web server, PHP, Graphvis (for Automap feature)
Features: Scalable network maps (Automap), network overlays on Open Street Maps (Geomap), traffic flow visualisation (Weathermap), status overlays on images, mouse-over host/service details, optional performance data graphing, web configuration UI, installer tool.
Version compatibility: All NagVis versions (v1.7.4 at time of writing) with all Icinga versions
More info & documentation: www.nagvis.org
BusinessProcessAddonsAs mentioned above, the Business Process Addons are two tools that help visualise the relationships between monitored objects that form business processes. The ‘Business Process View’ addon displays the aggregate status of a business process, based on the statuses of component hosts/service, accounting for dependencies and priority levels. The ‘Business Impact’ addon simulates the failure of one or more components to analyse the consequences for an overall business process. In Icinga Web, the ‘Business Process View’ is currently supported as a native cronk, boasting extra features.
Requisites: Icinga Core with IDOUtils, web server, Perl (with CGI, DBI and JSON::XS modules)
Features: ‘And / or’ process configurations, priorities, processes within processes configuration, component hosts and services drill down views, and comments. The Business Process cronk for Icinga Web also features drag n drop process configuration editor, event history sidebar, and dynamic tree views.
Version compatibility: All ‘Business Process Addons’ versions (v0.9.6 at time of writing) with all Icinga Core versions. The Business Process Icinga cronk is packaged with Icinga-Web v1.0.3 and newer.
More info & demo system: http://bp-addon.monitoringexchange.org
NagMapA simple little standalone addon, NagMap displays colour-coded, status information as pins and network links on Google Maps.
Requisites: Web server, PHP
Features: Network overlays on Google Maps, call outs with links to Icinga Classic or Web, MRTG and Smokeping pages for detailed status information.
Version compatibility: All NagMap versions (v 1.0 at time of writing) with all Icinga versions
More info & documentation: https://github.com/hecko/nagmap/
HeatmapForIcingaHeatmap is a tool that simulates and displays the thermal profile of a server room or data center as a colour-coded map. Using Icinga monitoring information, rack, sensor positions and airflow definitions, it generates a thermal model that simulates the distribution of heat to detect temperature problems early. It is a cronk built specifically for Icinga Web.
Requisites: Icinga Web (and IDOUtils), MySQL database, PHP (with CLI and gd, mysql libraries), optional ImageMagick image manipulation library
Features: Drag ‘n’ drop editor for mapping server rooms, heat flow simulation, dashboard, custom colour schemes and map generation scheduling.
Version compatibility: All Heatmap versions with all Icinga Web versions
More info & documentation: https://www.netways.org/projects/heatmap-for-icinga