Icinga

Introduction to Icinga-Web

Overview

This introduction takes you on a short tour showing some aspects of Icinga-Web. It is not complete so there will be things which aren't covered. We're working on this.

Due to constant development some things change over time resulting in different appearance and additional options. So far we offer three small introductions, one for the current version 1.5, one for version 1.3.x/1.4.x, and one for Icinga-Web up to version 1.2.x.

Introduction to Icinga-Web (>= 1.5.x)

If you followed the quickstart guides (IDOUtils and Icinga-Web) then please open your browser and enter http://<icinga server>/icinga-web. You will get the login screen

Figure6.1.Icinga-Web login screen

Icinga-Web login screen

You should be able to login using "root" and "password". This will take you to an overview page showing the state of the hosts and services being monitored

Figure6.2.Icinga-Web overview

Icinga-Web overview

Main Screen

This is where everything comes together: You can drag and drop new windows over here resulting in a new opened tab. The views are customisable for the current user (they remain persistent) by dragging the column heading to the new place. Rightclicking on the heading allows to change the sort order or to hide columns. Selected search results will be opened here too, next to opening available cronks.

Figure6.3.Icinga-Web main screen

Icinga-Web main screen

Status Cronk

The status cronk shows host and service counters for their respective states. If count is zero, the colour remains grey. Clicking on states opens a new tab in the main view showing the current clicked state only. Next to that, general process information is provided, just as

Figure6.4.Icinga-Web status cronk

Icinga-Web status cronk

Top menu

The top menu consists of general information about Icinga and the administration items for users, groups and logs. On the top right, you can see the user currently logged in and edit its preferences or log out of Icinga Web.

Figure6.5.Icinga-Web top menu

Icinga-Web top menu

Left menu

In the left (also hideable) menu you can select among different widgets (we call them "cronks"). You can either doubleclick on each cronk or drag it with the cursor into the main view. The categories are separated into

Search

The search form shows results while typing. The results will be shown in a separate inlay window. By clicking/selecting the results, a new tab in the main view opens with more information. Please note that the search is currently case sensitive ("ping" vs. "PING").

Figure6.10.Icinga-Web live search

Icinga-Web live search

Host Status

The HostStatus view shows the host status and below the number of warnings/critical of the services attached to the host.

Figure6.11.Icinga-Web host status

Icinga-Web host status

Service Status

The ServiceStatus view shows all services for each host.

Figure6.12.Icinga-Web service status

Icinga-Web service status

Hostgroup Status

The hostgroup view will show the status and the number of hosts grouped by hostgroup.

Figure6.13.Icinga-Web hostgroup status

Icinga-Web hostgroup status

Log

The log view shows the log messages.

Figure6.14.Icinga-Web log

Icinga-Web log

Cronks and Views

Icinga Web allows to open different cronks in order to view data, set filters for different views, send commands. The following list summarizes the possibilities in general (several Cronks can provide more, like sending commands).

Figure6.15.Icinga-Web cronk bar

Icinga-Web cronk bar

Figure6.16.Icinga-Web cronk bar

Icinga-Web cronk bar

Commands

There are different commands available (check the chapter External Commands for more information on commands). Select the items which should be affected and then select the command to be executed.

Filters

Icinga Web allows to set filters and create customised views which can be saved as own persistent cronk too. First, select "Filter" and "Modify". Add a restriction selected from the dropdown menu (this differs for various cronks). You can set more restrictions by repeating this procedure.

Figure6.19.Icinga-Web filter restriction

Icinga-Web filter restriction

Afterwards, specify on which condition the filter should match on the selected restriction (contain, does not contain, is, is not) and add a value into the form. Proposals are shown while you are typing.

Figure6.20.Icinga-Web filter condition

Icinga-Web filter condition

Apply the filter to the current cronk. If needed, you can modify the filter afterwards and add/remove restrictions and conditions. An active filter is marked red.

Figure6.21.Icinga-Web filter active

Icinga-Web filter active

Administration

Enter the administration panel by selecting "Admin" from the top menu, and select "Users", "Groups" or "Logs".

Figure6.22.Icinga-Web top menu admin

Icinga-Web top menu admin

Users

You can add, remove and edit users.

Figure6.23.Icinga-Web user admin

Icinga-Web user admin

Doubleclick a user to open a new inlay window which lets you edit very detailed options. The same options apply when adding a new user. You can modify the size by dragging the cursor in the corners.

Figure6.24.Icinga-Web edit user

Icinga-Web edit user

Groups

You can add, remove and edit groups. You can also modify group inheritance within the group tree on the right side.

Figure6.25.Icinga-Web group admin

Icinga-Web group admin

Doubleclick a group to open a new inlay window which lets you edit very detailed options. The same options apply when adding a new group. You can modify the size by dragging the cursor in the corners.

Figure6.26.Icinga-Web groups

Icinga-Web groups

Principals

Within the user and group administration panel, you can add/remove/edit principals. You can see default available principals in the picture:

Figure6.27.Icinga-Web principals

Icinga-Web principals

Logs

You can view several logs here, in order to catch up on possible errors.

Figure6.28.Icinga-Web logs

Icinga-Web logs

Task

Several changes require clearing the cache. Instead of using the command line you can issue the command via the "Tasks" menu.

Figure6.29.Icinga-Web Tasks

Icinga-Web Tasks

Well, that's it for now.

Introduction to Icinga-Web (>= 1.3.x)

If you followed the quickstart guides (IDOUtils and Icinga-Web) then please open your browser and enter http://<icinga server>/icinga-web. You will get the login screen

Figure6.30.Icinga-Web login screen

Icinga-Web login screen

You should be able to login using "root" and "password". This will take you to an overview page showing the state of the hosts and services being monitored

Figure6.31.Icinga-Web overview

Icinga-Web overview

Main Screen

This is where everything comes together: You can drag and drop new windows over here resulting in a new opened tab. The views are customisable for the current user (they remain persistent) by dragging the column heading to the new place. Rightclicking on the heading allows to change the sort order or to hide columns. Selected search results will be opened here too, next to opening available cronks.

Figure6.32.Icinga-Web main screen

Icinga-Web main screen

Status Cronk

The status cronk shows host and service counters for their respective states. If count is zero, the colour remains grey. Clicking on states opens a new tab in the main view showing the current clicked state only. Next to that, general process information is provided, just as

Figure6.33.Icinga-Web status cronk

Icinga-Web status cronk

Top menu

The top menu consists of general information about Icinga and the administration items for users, groups and logs. On the top right, you can see the user currently logged in and edit its preferences or log out of Icinga Web.

Figure6.34.Icinga-Web top menu

Icinga-Web top menu

Left menu

In the left (also hideable) menu you can select among different widgets (we call them "cronks"). You can either doubleclick on each cronk or drag it with the cursor into the main view. The categories are separated into

Search

The search form shows results while typing. The results will be shown in a separate inlay window. By clicking/selecting the results, a new tab in the main view opens with more information. Please note that the search is currently case sensitive ("ping" vs. "PING").

Figure6.38.Icinga-Web live search

Icinga-Web live search

Log

The log view has moved to an own cronk so it's not shown at the bottom anymore.

Figure6.39.Icinga-Web log

Icinga-Web log

Cronks and Views

Icinga Web allows to open different cronks in order to view data, set filters for different views, send commands. The following list summarizes the possibilities in general (several Cronks can provide more, like sending commands).

Figure6.40.Icinga-Web cronk bar

Icinga-Web cronk bar

Figure6.41.Icinga-Web cronk bar

Icinga-Web cronk bar

Commands

There are different commands available (check the chapter External Commands for more information on commands). Select the items which should be affected and then select the command to be executed.

Filters

Icinga Web allows to set filters and create customised views which can be saved as own persistent cronk too. First, select "Filter" and "Modify". Add a restriction selected from the dropdown menu (this differs for various cronks). You can set more restrictions by repeating this procedure.

Figure6.44.Icinga-Web filter restriction

Icinga-Web filter restriction

Afterwards, specify on which condition the filter should match on the selected restriction (contain, does not contain, is, is not) and add a value into the form. Proposals are shown while you are typing.

Figure6.45.Icinga-Web filter condition

Icinga-Web filter condition

Apply the filter to the current cronk. If needed, you can modify the filter afterwards and add/remove restrictions and conditions. An active filter is marked red.

Figure6.46.Icinga-Web filter active

Icinga-Web filter active

Administration

Enter the administration panel by selecting "Admin" from the top menu, and select "Users", "Groups" or "Logs".

Figure6.47.Icinga-Web top menu admin

Icinga-Web top menu admin

Users

You can add, remove and edit users.

Figure6.48.Icinga-Web user admin

Icinga-Web user admin

Doubleclick a user to open a new inlay window which lets you edit very detailed options. The same options apply when adding a new user. You can modify the size by dragging the cursor in the corners.

Figure6.49.Icinga-Web edit user

Icinga-Web edit user

Groups

You can add, remove and edit groups. You can also modify group inheritance within the group tree on the right side.

Figure6.50.Icinga-Web group admin

Icinga-Web group admin

Doubleclick a group to open a new inlay window which lets you edit very detailed options. The same options apply when adding a new group. You can modify the size by dragging the cursor in the corners.

Figure6.51.Icinga-Web groups

Icinga-Web groups

Principals

Within the user and group administration panel, you can add/remove/edit principals. You can see default available principals in the picture:

Figure6.52.Icinga-Web principals

Icinga-Web principals

Logs

You can view several logs here, in order to catch up on possible errors.

Figure6.53.Icinga-Web logs

Icinga-Web logs

Task

Several changes require clearing the cache. Instead of using the command line you can issue the command via the "Tasks" menu.

Figure6.54.Icinga-Web Tasks

Icinga-Web Tasks

Well, that's it for now.

Introduction to Icinga-Web (up to 1.2.x)

If you followed the quickstart guides (IDOUtils and Icinga-Web) then please open your browser and enter http://<icinga server>/icinga-web. You will get the login screen

Figure6.55.Icinga-Web login screen

Icinga-Web login screen

You should be able to login using "root" and "password". This will take you to an overview page showing the state of the hosts and services being monitored

Figure6.56.Icinga-Web overview

Icinga-Web overview

Main Screen

This is where everything comes together: You can drag and drop new windows over here resulting in a new opened tab. The views are customisable for the current user (they remain persistent) by dragging the column heading to the new place. Rightclicking on the heading allows to change the sort order or to hide columns. Selected search results will be opened here too, next to opening available cronks.

Figure6.57.Icinga-Web main screen

Icinga-Web main screen

Status Cronk

The status cronk shows host and service counters for their respective states. If count is zero, the colour remains grey. Clicking on states opens a new tab in the main view showing the current clicked state only. Next to that, general process information is provided, just as

Figure6.58.Icinga-Web status cronk

Icinga-Web status cronk

Top menu

The top menu consists of general information about Icinga and the administration items for users, groups and logs. On the top right, you can see the user currently logged in and edit its preferences or log out of Icinga Web.

Figure6.59.Icinga-Web top menu

Icinga-Web top menu

Left menu

In the left (also hideable) menu you can select among different widgets (we call them "cronks"). You can either doubleclick on each cronk or drag it with the cursor into the main view. The categories are separated into

Search

The search form shows results while typing. The results will be shown in a separate inlay window. By clicking/selecting the results, a new tab in the main view opens with more information. Please note that the search is currently case sensitive ("ping" vs. "PING").

Figure6.63.Icinga-Web live search

Icinga-Web live search

Log

At the bottom, the current Icinga log is being shown. The log is refreshed automatically and can be hidden in order to allocate more space for the main view.

Figure6.64.Icinga-Web log

Icinga-Web log

Cronks and Views

Icinga Web allows to open different cronks in order to view data, set filters for different views, send commands. The following list summarizes the possibilities in general (several Cronks can provide more, like sending commands).

Figure6.65.Icinga-Web cronk bar

Icinga-Web cronk bar

Figure6.66.Icinga-Web cronk bar

Icinga-Web cronk bar

Commands

There are different commands available (check the chapter External Commands for more information on commands). Select the items which should be affected and then select the command to be executed.

Filters

Icinga Web allows to set filters and create customised views which can be saved as own persistent cronk too. First, select "Filter" and "Modify". Add a restriction selected from the dropdown menu (this differs for various cronks). You can set more restrictions by repeating this procedure.

Figure6.69.Icinga-Web filter restriction

Icinga-Web filter restriction

Afterwards, specify on which condition the filter should match on the selected restriction (contain, does not contain, is, is not) and add a value into the form. Proposals are shown while you are typing.

Figure6.70.Icinga-Web filter condition

Icinga-Web filter condition

Apply the filter to the current cronk. If needed, you can modify the filter afterwards and add/remove restrictions and conditions. An active filter is marked red.

Figure6.71.Icinga-Web filter active

Icinga-Web filter active

Administration

Enter the administration panel by selecting "Admin" from the top menu, and select "Users", "Groups" or "Logs".

Figure6.72.Icinga-Web top menu admin

Icinga-Web top menu admin

Users

You can add, remove and edit users.

Figure6.73.Icinga-Web user admin

Icinga-Web user admin

Doubleclick a user to open a new inlay window which lets you edit very detailed options. The same options apply when adding a new user. You can modify the size by dragging the cursor in the corners.

Figure6.74.Icinga-Web edit user

Icinga-Web edit user

Groups

You can add, remove and edit groups. You can also modify group inheritance within the group tree on the right side.

Figure6.75.Icinga-Web group admin

Icinga-Web group admin

Doubleclick a group to open a new inlay window which lets you edit very detailed options. The same options apply when adding a new group. You can modify the size by dragging the cursor in the corners.

Figure6.76.Icinga-Web groups

Icinga-Web groups

Principals

Within the user and group administration panel, you can add/remove/edit principals. You can see default available principals in the picture:

Figure6.77.Icinga-Web principals

Icinga-Web principals

Logs

You can view several logs here, in order to catch up on possible errors.

Figure6.78.Icinga-Web logs

Icinga-Web logs