Keywords: Supervision, Icinga, Nagios, Linux

6.7. Introduction to Icinga Web
Prev | Chapter 6. User Interfaces | Next

## 6.7. 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. Please have a look at the current version 1.10.

### 6.7.1. Introduction to Icinga Web (>= 1.10.0)

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

Figure 6.2. 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

Figure 6.3. Icinga Web overview

Top menu

The top menu consists of general information about Icinga and the administration items for users, groups, logs, and tasks. The live-search is accessible using the field next to the magnifying glass. On the top right, you can see the user currently logged in and edit its preferences or log out of Icinga Web.

Figure 6.4. Icinga Web top menu

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. The search starts at the beginning of the string but you can use wildcards as well.

Figure 6.5. Icinga Web live search

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 selected state only. Next to that, the number and state of the Icinga instances is shown. In the remaining space general process information is provided, just as

- Hosts|Services (active/passive)

- Host|Service execution time (min/avg/max)

- Host|Services latency (min/avg/max)

Figure 6.6. Icinga Web status cronk

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

  Figure 6.7. Icinga Web data cronks

- "Tactical Overview" keeps general charts and customized ones (custom variables)

  Figure 6.8. Icinga Web tactical overview cronks

- "Reporting" enables to create reports

  Figure 6.9. Icinga Web reporting cronk

- "Misc" contains several useful cronks, just as iframes for external websites or the 1,2,3 columns for main view and links to the documentation.

  Figure 6.10. Icinga Web misc cronks

Within the settings menu, you can switch back to the old view with the bigger icons. Within `userpreferences.xml` config file you may set a global default value.

Figure 6.11. Icinga Web Cronk Menu Style Change

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 customizable 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.

Figure 6.12. Icinga Web main screen

Host Status

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

Figure 6.13. Icinga Web host status

Use the expanded view to change to ServiceStatus- view for this host, to look for history informations or to locate the host in statusmap. If you use PNP4Nagios you can also switch to the performance data.

On the left you will see the expander icon. Clicking on it will open a bar below the icon.

Figure 6.14. Expander icon / icon bar

Right-clicking on any of the new icons and selecting "Move into grid" will move the appropriate icon into the grid.

Figure 6.15. Move icon into grid

Selecting the new icon opens a small window or it will create a new tab showing the desired information.

Figure 6.16. Icinga Web New icons in grid

Clicking on "Setting" and selecting "Reset grid action icons" will remove the inserted icons restoring the default view.

Figure 6.17. Icinga Web Reset icon view

Host Object Informations

Use Details to see more detailed object informations like status, relations and external references.

Figure 6.18. Icinga Web host object information

Service Status

The ServiceStatus view shows all services for each host.

Figure 6.19. Icinga Web service status

Service Object Informations

Use the expanded view to look at the service object and history informations, the host object informations or to change to HostStatus view.

Figure 6.20. Icinga Web service object Information

Hostgroup Status

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

Figure 6.21. Icinga Web hostgroup status

Log

The log view shows the log messages.

Figure 6.22. 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).

Figure 6.23. Icinga Web cronk bar

- Manual Refresh

- Settings

  Enable/Disable Auto-Refresh

  Get this <item> by url

Figure 6.24. Icinga Web cronk bar

- Filter

  Modify/Remove

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.

Host Commands Figure 6.25. Icinga Web host commands | Service Commands Figure 6.26. Icinga Web service commands

Filters

Icinga Web allows to set filters and create customized views which can be saved as own persistent cronks, too. First, select "View Filter". On the left side on top of the cronk menu, you'll see the attributes and condition to select at the bottom. At the top the current selected filter is shown.

Figure 6.27. Icinga Web filter restriction

Afterwards, specify on which condition the filter should match by moving the conditions and selected attributes using drag and drop.

drag filters Figure 6.28. Icinga Web drag filters | drop filters Figure 6.29. Icinga Web drop filters

Once you have dropped an attribute filter onto a condition, you can specify its values (depending on the attribute, the screenshot shows only the state selection). Click "Add filter" when done.

Figure 6.30. Icinga Web filter attribute selection

The active filter now shows only the filtered entries.

Figure 6.31. Icinga Web filter active

You can combine multiple filters of the same type at once, as well as combine conditions. The example below shows an OR condition for the filter on critical and warning states.

Figure 6.32. Icinga Web filter advanced filters

Administration

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

Figure 6.33. Icinga Web top menu admin

Users

You can add, remove and edit users. You can also search for users.

Figure 6.34. 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.

- General information

- Change password (and optional AuthKey for API)

- Permissions e.g. which group membership

- Principals for special roles

Figure 6.35. Icinga Web edit user

Roles

You can add, remove and edit roles. You can also modify role inheritance within the group tree in the lower half. You can also search for groups.

Figure 6.36. Icinga Web group admin

Doubleclick a role to activate the window on the right side which lets you edit very detailed options (see below). The same options apply when adding a new role. You can modify the size by dragging the cursor in the corners.

Figure 6.37. Icinga Web groups

| Note
Please visit the wiki for further information about roles and credentials.

Logs

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

Figure 6.38. Icinga Web logs

Tasks

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

Figure 6.39. Icinga Web Tasks

Prev | Up | Next
6.6. Configuration Overview of Icinga Web | Home | 6.8. Integration of PNP4Nagios into Icinga Web

© 1999-2009 Ethan Galstad, 2009-2013 Icinga Development Team, http://www.icinga.org