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.6.
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
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
Top menu
The top menu consists of general information about Icinga and the administration items for users, groups, logs, and tasks. The live-search opens when you click on the magnifying glass next to the clock. On the top right, you can see the user currently logged in and edit its preferences or log out of Icinga Web.
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.
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)
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
"Data" for getting status, historical and configuration data. New in Icinga 1.6 are two cronks showing information about instances and the "tackle view".
"Tactical Overview" keeps general charts and customized ones (custom variables)
"Reporting" enables to create reports
"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.
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.
Host Status
The HostStatus view shows the host status and below the number of warnings/critical of the services attached to the host.
Service Status
The ServiceStatus view shows all services for each host.
Hostgroup Status
The hostgroup view will show the status and the number of hosts grouped by hostgroup.
Log
The log view shows the log messages.
Tackle
The brand new tackle cronk gives fast access to all information regarding hosts and services. "Batch commands" opens a new windows enabling you to limit the scope of the objects before issuing a command for a number of hosts or services. Toggling the status buttons ("Up", "Down", etc.) limits the view to the hosts with the states activated.
Selecting one object in the upper half shows more information about it in the lower half. The "Default" tab displays the associated directives without checking several config or status files.
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).
Manual Refresh
Settings
Enable/Disable Auto-Refresh
Get this <item> by url
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 |
Service Commands |
Filters
Icinga Web allows to set filters and create customized views which can be saved as own persistent cronks, 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.
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.
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.
Enter the administration panel by selecting "Admin" from the top menu, and select "Users", "Groups", "Logs", or "Tasks".
Users
You can add, remove and edit users.
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
Roles
You can add, remove and edit roles. You can also modify role inheritance within the group tree in the lower half.
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.
Logs
You can view several logs here, in order to catch up on possible errors.
Tasks
Several changes require clearing the cache. Instead of using the command line you can issue the command via the "Tasks" menu.
© 2009-2011 Icinga Development Team, http://www.icinga.org