skip to main content
The GUI : Listviews
   
Listviews
Listviews are all views that lists host, services, hostgroups etc.
The contents of the lists is defiend by filters, see Filters on page 25.
The listview is divided into two parts. One is the top banner that includes a summary of the content in the listview and the other one is the content itself.
The following views, or tables, uses listviews
Hosts Details
Services Details
Hostgroup Summary
Servicegroup Summary
Comments
Scheduled Downtime
Contacts
Notifications
Saved filters
Columns
The different columns in the content can be set under My Account in the Configuration menu.
The different tables can have its own set of columns.
To change what columns to show in a table change default to a list of the columns that you want to see.
For example if you would like to view only Status, Host name, Service name and the state in the service-view, you need to enter:
host_state,host_name,description, state
It is also possible to hide one column by using a “-” before the column that you would like to remove from the table. If you want to hide the attempts column enter:
default, -attempt
Column list
Hosts
Column
Description
select
The select checkbox for the host-object
state
The state of the host. UP, DOWN, UNREACHABLE or PENDING.
name
The hostname
alias
The alias of the host
status
The column where comments, graphs and notification status is shown
action
Links to configuration, extra host notes etc.
last_check
The date and time when the host was last checked
duration
Time for how long the host has been in it’s current state
status_information
The output from the last check command
services_num_all
Total number of services on the host
services_num_warning
Total number of services on the host in state WARNING
services_num_critical
Total number of services on the host in state CRITICAL
services_num_unknown
Total number of services on the host in state UNKNOWN
services_num_pending
Total number of services on the host in state PENDING
Services
Column
Description
host_state
The state of the host on which the service is located
host_name
The name of the host on which the service is located
select
The select checkbox for the service-object
state
The state of the service. OK, WARNING, CRITICAL, UNKNOWN or PENDING
description
The description (name) of the service-check
status
The column where comments, graphs and notification status is shown
action
Links to configuration, extra service notes etc.
last_check
The date and time when the service was last checked
duration
Time for how long the service has been in its current state
attempt
The number of attempts needed before a notification is sent out.
status_information
The output from the last check command
Host groups
Column
Description
name
The name of the hostgroup
actions
Links to hostgroup commands
host_status_summary
Shows the total number of hosts and its states in the hostgroup
service_status_summary
Shows the total number of services in the hostgroup and their states
Service groups
Column
Description
name
The name of the servicegroup
actions
Links to servicegroup commands
service_status_summary
Shows the total number of services in the servicegroup and it states
Comments
Column
Description
select
Select checkbox for the comment
id
ID of the comment
object_type
Show the object type for the comment. Host or Service
host_state
The state of the host on which the comment is located
host_name
The name of the host on which the comment is located
service_state
The state of the service on which the comment is located
service_description
The name of the service on which the comment is located
entry_time
The submisson date and time of the comment
author
Shows the author of the comment
comment
The comment it self.
persistent
Shows if the comment is persistent or not
expires
The time and date when the comment expires
actions
The action for the comment, delete comment
Downtimes
Column
Description
select
Select checkbox for the scheduled downtime entry
id
ID of the scheduled downtime entry
object_type
Show the object type affected by the scheduled downtime. Host or Service
host_state
The current state of the host on which the scheduled downtime is located
host_name
The name of the host on which the scheduled downtime is located
service_state
The current state of the service on which the scheduled downtime is located
service_description
The name of the service on which the scheduled downtime is located
entry_time
When the scheduled downtime was created
author
Shows by whom the scheduled downtime was created.
comment
The comment of the scheduled downtime.
start_time
Date and time for when the objects enters the scheduled downtime
end_time
Date and time for when the objects exits the scheduled downtime
actions
The action for the comment, delete comment
type
Shows if the scheduled downtime is fixed or flexible
duration
Shows how long the object will be in scheduled downtime if flexible schedule is used.
triggered_by
Shows if the scheduled downtime is triggered by another event.
actions
The action for the scheduled downtime. Remove is the only action available for scheduled downtime.
Contacts
Column
Description
name
The contacts name
alias
The contacts alias
Notifications
Column
Description
state
The state (OK, WARNING, DOWN etc.) of the object in the notification
host_name
The hosts name in the notification
service_description
The name of the service in the notification. Only valid for service notification
time
The date and time of the notification
contact
To which contact the notification was sent
notification_command
Shows which notification command that was used for the notification
status_information
The check command output from the check
Saved filters
Column
Description
icon
Shows the designated icon for the filter
scope
Shows if the filter is a global filter or a personal filter
name
The name of the filter
owner
Shows who created the filter
actions
Action for the filter, only delete is available
Custom columns
It is possible to create a custom column if the column isn’t available from the standard columns.
The format is “<label>” = <data> where <data> is the source of the data, for example if you would like to create a column that show the note of a host set in the configuration:
“Notes” = notes
It is also possible to fetch. For example the host notes on a service as well, by using the host.notes label.
Links in custom columns
It is also possible to add HTML code into the column. Let’s say that you have a note with an ID that corresponds to the system in your CMS database and you would like to create a link directly to that object.
"Asset ID" = "<a href=\"http://inventory.example.org/?asset=" + notes + "\">Asset " + notes + "</a>"
Custom variables
To show a custom variable in a column use the format custom_variable.<VARIABLE_NAME>. The custom variable should be used without the underscore prefix.
Using the same example as above, but this time we have the ID in a custom variable called ASSETID
"Asset ID" = "<a href=\"http://inventory.example.org/?asset=" + custom_variables.ASSETID + "\">Asset " + custom_variables.ASSETID + "</a>"
More information
List views support POSIX extended regular expressions as supported by MK Livestatus. For more information, see http://mathias-kettner.de/checkmk_livestatus.html#Regular%20expression%20matching