Livestatus API

Up To: Contents

See Also: Addons

Livestatus

Livestatus is one of the standard APIs for Naemon. It can be used to query live status and configuration information from the Naemon core. Detail description is available on mathias-kettner.de.

Module Options

The livestatus module is usually loaded from the /etc/naemon/module-conf.d/livestatus.cfg file:

broker_module=/usr/lib64/naemon/naemon-livestatus/livestatus.so debug=0 /var/cache/naemon/live
event_broker_options=-1

The module accepts a number of options:

data_encoding

Changes encoding style.

Possible values:

  • utf8 (Default)
  • latin1
  • mixed

ex.:

broker_module=.../livestatus.so data_encoding=utf8 ...

debug

Enable/disable debug logging.

Possible values:

  • 0 debug logging off (Default)
  • 1 debug logging on

ex.:

broker_module=.../livestatus.so debug=1 ...

group_authorization

Sets group authorization mode.

If GroupAuthorization is strict (default), a user must be a contact on all hosts in the hostgroup in able to see the hostgroup. If GroupAuthorization is loose it is sufficient for the user to be a contact on one of the hosts in the hostgroup.

This is only used for queries using the AuthUser header.

Possible values:

  • strict (Default)
  • loose

ex.:

broker_module=.../livestatus.so group_authorization=strict ...

hidden_custom_var_prefix

Set prefix to hide custom variables by prefix.

Possible values: any string value.

ex.:

broker_module=.../livestatus.so hidden_custom_var_prefix=SECRET ...

idle_timeout

Timeout value for keepalive connections in milliseconds. Defaults to 300000 (300sec).

Possible values: any positive integer value.

ex.:

broker_module=.../livestatus.so idle_timeout=300 ...

inet_addr

Make livestatus listen on tcp address.

Possible values: any socket description.

ex.:

broker_module=.../livestatus.so inet_addr=0.0.0.0:6666 ...

log_file

Change path to logfile.

Possible values: valid file locaton

ex.:

broker_module=.../livestatus.so log_file=/var/log/livestatus.log ...

max_backlog

Set maximum number of backlog connections. Defaults to 3.

Possible values: any positive integer value.

ex.:

broker_module=.../livestatus.so max_backlog=3 ...

max_cached_messages

Set maximum number of cached log messages. Defaults to 500000.

Possible values: any positive integer value.

ex.:

broker_module=.../livestatus.so max_cached_messages=1000000 ...

max_lines_per_logfile

Set maximum number of lines read from each logfile. Defaults to 1000000.

Possible values: any positive integer value.

ex.:

broker_module=.../livestatus.so max_lines_per_logfile=2000000 ...

max_response_size

Sets maximum final response size in bytes. Defaults to 524288000 (500MiB).

Possible values: any positive integer value.

ex.:

broker_module=.../livestatus.so max_response_size=1048576000 ...

num_client_threads

deprecated: There is no limit of concurrent threads anymore.

pnp_path

Sets path to pnp rrd files. This is used to fill the pnpgraph_present columns.

Possible values: any valid directory location.

ex.:

broker_module=.../livestatus.so pnp_path=/var/lib/pnp4nagios/perfdata ...

query_timeout

Sets read timeout for queries in milliseconds. Defaults to 10000 (10sec).

Possible values: any positive integer value.

ex.:

broker_module=.../livestatus.so query_timeout=30000 ...

service_authorization

Sets service authorization mode.

Naemon automatically regards a contact for a host also as a contact for all services of that host. We call this method loose. By setting it to strict, one must be an explicitly contact of a service in order to see it when using the AuthUser setting. Please note that Naemon makes all services that do not have any contact at all inherit all contacts of the host - regardless whether this option is set to strict or loose. The default option is loose.

This is only used for queries using the AuthUser header.

Possible values:

  • strict (Default)
  • loose

ex.:

broker_module=.../livestatus.so service_authorization=strict ...

thread_stack_size

Sets threads stack size in bytes. Defaults to 65536. Read more in man 3 pthread_attr_setstacksize. There is usually no reason to change this.

Possible values: any positive integer value.

ex.:

broker_module=.../livestatus.so thread_stack_size=65536 ...

Syntax

Detailed description about the query language itself is on mathias-kettner.de.

Extended Functionality

In addition, Naemon’s Livestatus has been improved by the following features:

Sort Support

Sort: <column name> <asc/desc>

Sorts the result set by the specified column in the given direction. Multiple Sort lines can be added. First sort line takes precedence.

Example:

GET services
Sort: host_name asc
Sort: description desc

Offset

Offset: <number of lines>

Lines to skip from the beginning of the result set. Useful for pagination in combination with Limit header.

Example:

GET services
Limit: 100
Offset: 300

OutputFormat: wrapped_json

An extension to the json output format. The result set is packed in a json object, with a couple of possible fields:

  • columns: an array of column names. (optional)
  • data: an array of arrays, describing the result set, in the same syntax common json output, without embedded column names.
  • total_count: The number of lines in the result set, except the limitation of Limit and Offset headers.

Example:

GET services
OutputFormat: wrapped_json

TCP support

New in version 1.2.0.

Support querying Livestatus over TCP instead of the default UNIX socket. This is enabled through a broker_module configure option.

Example configuring Livestatus to listen on TCP port 11621 on all available IPv4 interfaces:

broker_module=/usr/lib64/livestatus.so inet_addr=0.0.0.0:11621

Tables

The following tables are available for livestatus queries.

commands

Column Type Description
idintCommand id
linestringThe shell command line
namestringThe name of the command

comments

Column Type Description
_host_All columns from the hosts table are available via host_ prefix.
_service_All columns from the services table are available via service_ prefix.
authorstringThe contact that entered the comment
commentstringA comment text
entry_timetimeThe time the entry was made as UNIX timestamp
entry_typeintThe type of the comment: 1 is user, 2 is downtime, 3 is flap and 4 is acknowledgement
expire_timetimeThe time of expiry of this comment as a UNIX timestamp
expiresintWhether this comment expires
idintThe id of the comment
is_serviceint0, if this entry is for a host, 1 if it is for a service
persistentintWhether this comment is persistent (0/1)
sourceintThe source of the comment (0 is internal and 1 is external)
typeintThe type of the comment: 1 is host, 2 is service

contactgroups

Column Type Description
aliasstringThe alias of the contactgroup
idintContactgroup id
memberslistA list of all members of this contactgroup
namestringThe name of the contactgroup

contacts

Column Type Description
address1stringThe additional field address1
address2stringThe additional field address2
address3stringThe additional field address3
address4stringThe additional field address4
address5stringThe additional field address5
address6stringThe additional field address6
aliasstringThe full name of the contact
can_submit_commandsintWhether the contact is allowed to submit commands (0/1)
custom_variable_nameslistA list of all custom variables of the contact
custom_variable_valueslistA list of the values of all custom variables of the contact
custom_variablesdictA dictionary of the custom variables
emailstringThe email address of the contact
host_notification_periodstringThe time period in which the contact will be notified about host problems
host_notifications_enabledintWhether the contact will be notified about host problems in general (0/1)
idintContact id
in_host_notification_periodintWhether the contact is currently in his/her host notification period (0/1)
in_service_notification_periodintWhether the contact is currently in his/her service notification period (0/1)
modified_attributesintA bitmask specifying which attributes have been modified
modified_attributes_listlistA list of all modified attributes
namestringThe login name of the contact person
pagerstringThe pager address of the contact
service_notification_periodstringThe time period in which the contact will be notified about service problems
service_notifications_enabledintWhether the contact will be notified about service problems in general (0/1)

downtimes

Column Type Description
_host_All columns from the hosts table are available via host_ prefix.
_service_All columns from the services table are available via service_ prefix.
authorstringThe contact that scheduled the downtime
commentstringA comment text
durationintThe duration of the downtime in seconds
end_timetimeThe end time of the downtime as UNIX timestamp
entry_timetimeThe time the entry was made as UNIX timestamp
fixedintA 1 if the downtime is fixed, a 0 if it is flexible
idintThe id of the downtime
is_serviceint0, if this entry is for a host, 1 if it is for a service
start_timetimeThe start time of the downtime as UNIX timestamp
triggered_byintThe id of the downtime this downtime was triggered by or 0 if it was not triggered by another downtime
typeintThe type of the downtime: 0 if it is active, 1 if it is pending

hostgroups

Column Type Description
action_urlstringAn optional URL to custom actions or information about the hostgroup
aliasstringAn alias of the hostgroup
idintHostgroup id
memberslistA list of all host names that are members of the hostgroup
members_with_statelistA list of all host names that are members of the hostgroup together with state and has_been_checked
namestringName of the hostgroup
notesstringOptional notes to the hostgroup
notes_urlstringAn optional URL with further information about the hostgroup
num_hostsintThe total number of hosts in the group
num_hosts_downintThe number of hosts in the group that are down
num_hosts_pendingintThe number of hosts in the group that are pending
num_hosts_unreachintThe number of hosts in the group that are unreachable
num_hosts_upintThe number of hosts in the group that are up
num_servicesintThe total number of services of hosts in this group
num_services_critintThe total number of services with the state CRIT of hosts in this group
num_services_hard_critintThe total number of services with the state CRIT of hosts in this group
num_services_hard_okintThe total number of services with the state OK of hosts in this group
num_services_hard_unknownintThe total number of services with the state UNKNOWN of hosts in this group
num_services_hard_warnintThe total number of services with the state WARN of hosts in this group
num_services_okintThe total number of services with the state OK of hosts in this group
num_services_pendingintThe total number of services with the state Pending of hosts in this group
num_services_unknownintThe total number of services with the state UNKNOWN of hosts in this group
num_services_warnintThe total number of services with the state WARN of hosts in this group
worst_host_stateintThe worst state of all of the groups' hosts (UP <= UNREACHABLE <= DOWN)
worst_service_hard_stateintThe worst state of all services that belong to a host of this group (OK <= WARN <= UNKNOWN <= CRIT)
worst_service_stateintThe worst state of all services that belong to a host of this group (OK <= WARN <= UNKNOWN <= CRIT)

hosts

Column Type Description
accept_passive_checksintWhether passive host checks are accepted (0/1)
acknowledgedintWhether the current host problem has been acknowledged (0/1)
acknowledgement_typeintType of acknowledgement (0: none, 1: normal, 2: stick)
action_urlstringAn optional URL to custom actions or information about this host
action_url_expandedstringThe same as action_url, but with the most important macros expanded
active_checks_enabledintWhether active checks are enabled for the host (0/1)
addressstringIP address
aliasstringAn alias name for the host
check_commandstringNaemon command for active host check of this host
check_flapping_recovery_notificationintWhether to check to send a recovery notification when flapping stops (0/1)
check_freshnessintWhether freshness checks are activated (0/1)
check_intervalfloatNumber of basic interval lengths between two scheduled checks of the host
check_optionsintThe current check option, forced, normal, freshness... (0-2)
check_periodstringTime period in which this host will be checked. If empty then the host will always be checked.
check_sourcestringThe source of the check
check_typeintType of check (0: active, 1: passive)
checks_enabledintWhether checks of the host are enabled (0/1)
childslistA list of all direct children of the host
commentslistA list of the ids of all comments of this host
comments_with_infolistA list of all comments of the host with id, author and comment
contact_groupslistA list of all contact groups this host is in
contactslistA list of all contacts of this host, either direct or via a contact group
current_attemptintNumber of the current check attempts
current_notification_numberintNumber of the current notification
custom_variable_nameslistA list of the names of all custom variables
custom_variable_valueslistA list of the values of the custom variables
custom_variablesdictA dictionary of the custom variables
depends_execlistA list of all hosts this hosts depends on to execute
depends_exec_with_infolistA list of all hosts this hosts depends on to execute including information: host_name, failure_options, dependency_period and inherits_parent
depends_notifylistA list of all hosts this hosts depends on to notify
depends_notify_with_infolistA list of all hosts this hosts depends on to notify including information: host_name, failure_options, dependency_period and inherits_parent
display_namestringOptional display name of the host
downtimeslistA list of the ids of all scheduled downtimes of this host
downtimes_with_infolistA list of the all scheduled downtimes of the host with id, author and comment
event_handlerstringNaemon command used as event handler
event_handler_enabledintWhether event handling is enabled (0/1)
execution_timefloatTime the host check needed for execution
filenamestringThe value of the custom variable FILENAME
first_notification_delayfloatDelay before the first notification
flap_detection_enabledintWhether flap detection is enabled (0/1)
groupslistA list of all host groups this host is in
hard_stateintThe effective hard state of the host (eliminates a problem in hard_state)
has_been_checkedintWhether the host has already been checked (0/1)
high_flap_thresholdfloatHigh threshold of flap detection
hourly_valueintHourly Value
icon_imagestringThe name of an image file to be used in the web pages
icon_image_altstringAlternative text for the icon_image
icon_image_expandedstringThe same as icon_image, but with the most important macros expanded
idintHost id
in_check_periodintWhether this host is currently in its check period (0/1)
in_notification_periodintWhether this host is currently in its notification period (0/1)
initial_stateintInitial host state
is_executingintis there a host check currently running... (0/1)
is_flappingintWhether the host state is flapping (0/1)
last_checktimeTime of the last check (Unix timestamp)
last_hard_stateintLast hard state
last_hard_state_changetimeTime of the last hard state change (Unix timestamp)
last_notificationtimeTime of the last notification (Unix timestamp)
last_stateintState before last state change
last_state_changetimeTime of the last state change - soft or hard (Unix timestamp)
last_time_downtimeThe last time the host was DOWN (Unix timestamp)
last_time_unreachabletimeThe last time the host was UNREACHABLE (Unix timestamp)
last_time_uptimeThe last time the host was UP (Unix timestamp)
last_updatetimeTime of the last update of this host (Unix timestamp)
latencyfloatTime difference between scheduled check time and actual check time
long_plugin_outputstringComplete output from check plugin
low_flap_thresholdfloatLow threshold of flap detection
max_check_attemptsintMax check attempts for active host checks
modified_attributesintA bitmask specifying which attributes have been modified
modified_attributes_listlistA list of all modified attributes
namestringHost name
next_checktimeScheduled time for the next check (Unix timestamp)
next_notificationtimeTime of the next notification (Unix timestamp)
no_more_notificationsintWhether to stop sending notifications (0/1)
notesstringOptional notes for this host
notes_expandedstringThe same as notes, but with the most important macros expanded
notes_urlstringAn optional URL with further information about the host
notes_url_expandedstringSame as notes_url, but with the most important macros expanded
notification_intervalfloatInterval of periodic notification or 0 if its off
notification_periodstringTime period in which problems of this host will be notified. If empty then notification will be always
notifications_enabledintWhether notifications of the host are enabled (0/1)
notified_onintFlags determining which states have been notified on
num_servicesintThe total number of services of the host
num_services_critintThe number of the host's services with the soft state CRIT
num_services_hard_critintThe number of the host's services with the hard state CRIT
num_services_hard_okintThe number of the host's services with the hard state OK
num_services_hard_unknownintThe number of the host's services with the hard state UNKNOWN
num_services_hard_warnintThe number of the host's services with the hard state WARN
num_services_okintThe number of the host's services with the soft state OK
num_services_pendingintThe number of the host's services which have not been checked yet (pending)
num_services_unknownintThe number of the host's services with the soft state UNKNOWN
num_services_warnintThe number of the host's services with the soft state WARN
obsessintThe current obsess setting... (0/1)
obsess_over_hostintThe current obsess setting... (0/1)
parentslistA list of all direct parents of the host
pending_flex_downtimeintWhether a flex downtime is pending (0/1)
percent_state_changefloatPercent state change
perf_datastringOptional performance data of the last host check
plugin_outputstringOutput of the last host check
pnpgraph_presentintWhether there is a PNP4Nagios graph present for this host (0/1)
process_performance_dataintWhether processing of performance data is enabled (0/1)
retry_intervalfloatNumber of basic interval lengths between checks when retrying after a soft error
scheduled_downtime_depthintThe number of downtimes this host is currently in
serviceslistA list of all services of the host
services_with_infolistA list of all services including detailed information about each service
services_with_statelistA list of all services of the host together with state and has_been_checked
should_be_scheduledintWhether naemon still tries to run checks on this host (0/1)
stalenessfloatStaleness indicator for this host
stateintThe current state of the host (0: up, 1: down, 2: unreachable)
state_typeintType of the current state (0: soft, 1: hard)
statusmap_imagestringThe name of in image file for the status map
total_servicesintThe total number of services of the host
worst_service_hard_stateintThe worst hard state of all of the host's services (OK <= WARN <= UNKNOWN <= CRIT)
worst_service_stateintThe worst soft state of all of the host's services (OK <= WARN <= UNKNOWN <= CRIT)
x_3dfloat3D-Coordinates: X
y_3dfloat3D-Coordinates: Y
z_3dfloat3D-Coordinates: Z

hostsbygroup

Column Type Description
accept_passive_checksintWhether passive host checks are accepted (0/1)
acknowledgedintWhether the current host problem has been acknowledged (0/1)
acknowledgement_typeintType of acknowledgement (0: none, 1: normal, 2: stick)
action_urlstringAn optional URL to custom actions or information about this host
action_url_expandedstringThe same as action_url, but with the most important macros expanded
active_checks_enabledintWhether active checks are enabled for the host (0/1)
addressstringIP address
aliasstringAn alias name for the host
check_commandstringNaemon command for active host check of this host
check_flapping_recovery_notificationintWhether to check to send a recovery notification when flapping stops (0/1)
check_freshnessintWhether freshness checks are activated (0/1)
check_intervalfloatNumber of basic interval lengths between two scheduled checks of the host
check_optionsintThe current check option, forced, normal, freshness... (0-2)
check_periodstringTime period in which this host will be checked. If empty then the host will always be checked.
check_sourcestringThe source of the check
check_typeintType of check (0: active, 1: passive)
checks_enabledintWhether checks of the host are enabled (0/1)
childslistA list of all direct children of the host
commentslistA list of the ids of all comments of this host
comments_with_infolistA list of all comments of the host with id, author and comment
contact_groupslistA list of all contact groups this host is in
contactslistA list of all contacts of this host, either direct or via a contact group
current_attemptintNumber of the current check attempts
current_notification_numberintNumber of the current notification
custom_variable_nameslistA list of the names of all custom variables
custom_variable_valueslistA list of the values of the custom variables
custom_variablesdictA dictionary of the custom variables
depends_execlistA list of all hosts this hosts depends on to execute
depends_exec_with_infolistA list of all hosts this hosts depends on to execute including information: host_name, failure_options, dependency_period and inherits_parent
depends_notifylistA list of all hosts this hosts depends on to notify
depends_notify_with_infolistA list of all hosts this hosts depends on to notify including information: host_name, failure_options, dependency_period and inherits_parent
display_namestringOptional display name of the host
downtimeslistA list of the ids of all scheduled downtimes of this host
downtimes_with_infolistA list of the all scheduled downtimes of the host with id, author and comment
event_handlerstringNaemon command used as event handler
event_handler_enabledintWhether event handling is enabled (0/1)
execution_timefloatTime the host check needed for execution
filenamestringThe value of the custom variable FILENAME
first_notification_delayfloatDelay before the first notification
flap_detection_enabledintWhether flap detection is enabled (0/1)
groupslistA list of all host groups this host is in
hard_stateintThe effective hard state of the host (eliminates a problem in hard_state)
has_been_checkedintWhether the host has already been checked (0/1)
high_flap_thresholdfloatHigh threshold of flap detection
hostgroup_action_urlstringAn optional URL to custom actions or information about the hostgroup
hostgroup_aliasstringAn alias of the hostgroup
hostgroup_idintHostgroup id
hostgroup_memberslistA list of all host names that are members of the hostgroup
hostgroup_members_with_statelistA list of all host names that are members of the hostgroup together with state and has_been_checked
hostgroup_namestringName of the hostgroup
hostgroup_notesstringOptional notes to the hostgroup
hostgroup_notes_urlstringAn optional URL with further information about the hostgroup
hostgroup_num_hostsintThe total number of hosts in the group
hostgroup_num_hosts_downintThe number of hosts in the group that are down
hostgroup_num_hosts_pendingintThe number of hosts in the group that are pending
hostgroup_num_hosts_unreachintThe number of hosts in the group that are unreachable
hostgroup_num_hosts_upintThe number of hosts in the group that are up
hostgroup_num_servicesintThe total number of services of hosts in this group
hostgroup_num_services_critintThe total number of services with the state CRIT of hosts in this group
hostgroup_num_services_hard_critintThe total number of services with the state CRIT of hosts in this group
hostgroup_num_services_hard_okintThe total number of services with the state OK of hosts in this group
hostgroup_num_services_hard_unknownintThe total number of services with the state UNKNOWN of hosts in this group
hostgroup_num_services_hard_warnintThe total number of services with the state WARN of hosts in this group
hostgroup_num_services_okintThe total number of services with the state OK of hosts in this group
hostgroup_num_services_pendingintThe total number of services with the state Pending of hosts in this group
hostgroup_num_services_unknownintThe total number of services with the state UNKNOWN of hosts in this group
hostgroup_num_services_warnintThe total number of services with the state WARN of hosts in this group
hostgroup_worst_host_stateintThe worst state of all of the groups' hosts (UP <= UNREACHABLE <= DOWN)
hostgroup_worst_service_hard_stateintThe worst state of all services that belong to a host of this group (OK <= WARN <= UNKNOWN <= CRIT)
hostgroup_worst_service_stateintThe worst state of all services that belong to a host of this group (OK <= WARN <= UNKNOWN <= CRIT)
hourly_valueintHourly Value
icon_imagestringThe name of an image file to be used in the web pages
icon_image_altstringAlternative text for the icon_image
icon_image_expandedstringThe same as icon_image, but with the most important macros expanded
idintHost id
in_check_periodintWhether this host is currently in its check period (0/1)
in_notification_periodintWhether this host is currently in its notification period (0/1)
initial_stateintInitial host state
is_executingintis there a host check currently running... (0/1)
is_flappingintWhether the host state is flapping (0/1)
last_checktimeTime of the last check (Unix timestamp)
last_hard_stateintLast hard state
last_hard_state_changetimeTime of the last hard state change (Unix timestamp)
last_notificationtimeTime of the last notification (Unix timestamp)
last_stateintState before last state change
last_state_changetimeTime of the last state change - soft or hard (Unix timestamp)
last_time_downtimeThe last time the host was DOWN (Unix timestamp)
last_time_unreachabletimeThe last time the host was UNREACHABLE (Unix timestamp)
last_time_uptimeThe last time the host was UP (Unix timestamp)
last_updatetimeTime of the last update of this host (Unix timestamp)
latencyfloatTime difference between scheduled check time and actual check time
long_plugin_outputstringComplete output from check plugin
low_flap_thresholdfloatLow threshold of flap detection
max_check_attemptsintMax check attempts for active host checks
modified_attributesintA bitmask specifying which attributes have been modified
modified_attributes_listlistA list of all modified attributes
namestringHost name
next_checktimeScheduled time for the next check (Unix timestamp)
next_notificationtimeTime of the next notification (Unix timestamp)
no_more_notificationsintWhether to stop sending notifications (0/1)
notesstringOptional notes for this host
notes_expandedstringThe same as notes, but with the most important macros expanded
notes_urlstringAn optional URL with further information about the host
notes_url_expandedstringSame as notes_url, but with the most important macros expanded
notification_intervalfloatInterval of periodic notification or 0 if its off
notification_periodstringTime period in which problems of this host will be notified. If empty then notification will be always
notifications_enabledintWhether notifications of the host are enabled (0/1)
notified_onintFlags determining which states have been notified on
num_servicesintThe total number of services of the host
num_services_critintThe number of the host's services with the soft state CRIT
num_services_hard_critintThe number of the host's services with the hard state CRIT
num_services_hard_okintThe number of the host's services with the hard state OK
num_services_hard_unknownintThe number of the host's services with the hard state UNKNOWN
num_services_hard_warnintThe number of the host's services with the hard state WARN
num_services_okintThe number of the host's services with the soft state OK
num_services_pendingintThe number of the host's services which have not been checked yet (pending)
num_services_unknownintThe number of the host's services with the soft state UNKNOWN
num_services_warnintThe number of the host's services with the soft state WARN
obsessintThe current obsess setting... (0/1)
obsess_over_hostintThe current obsess setting... (0/1)
parentslistA list of all direct parents of the host
pending_flex_downtimeintWhether a flex downtime is pending (0/1)
percent_state_changefloatPercent state change
perf_datastringOptional performance data of the last host check
plugin_outputstringOutput of the last host check
pnpgraph_presentintWhether there is a PNP4Nagios graph present for this host (0/1)
process_performance_dataintWhether processing of performance data is enabled (0/1)
retry_intervalfloatNumber of basic interval lengths between checks when retrying after a soft error
scheduled_downtime_depthintThe number of downtimes this host is currently in
serviceslistA list of all services of the host
services_with_infolistA list of all services including detailed information about each service
services_with_statelistA list of all services of the host together with state and has_been_checked
should_be_scheduledintWhether naemon still tries to run checks on this host (0/1)
stalenessfloatStaleness indicator for this host
stateintThe current state of the host (0: up, 1: down, 2: unreachable)
state_typeintType of the current state (0: soft, 1: hard)
statusmap_imagestringThe name of in image file for the status map
total_servicesintThe total number of services of the host
worst_service_hard_stateintThe worst hard state of all of the host's services (OK <= WARN <= UNKNOWN <= CRIT)
worst_service_stateintThe worst soft state of all of the host's services (OK <= WARN <= UNKNOWN <= CRIT)
x_3dfloat3D-Coordinates: X
y_3dfloat3D-Coordinates: Y
z_3dfloat3D-Coordinates: Z

log

Column Type Description
_host_All columns from the hosts table are available via current_host_ prefix.
_service_All columns from the services table are available via current_service_ prefix.
attemptintThe number of the check attempt
classintThe class of the message as integer (0:info, 1:state, 2:program, 3:notification, 4:passive, 5:command)
command_namestringThe name of the command of the log entry (e.g. for notifications)
commentstringA comment field used in various message types
contact_namestringThe name of the contact the log entry is about (might be empty)
host_namestringThe name of the host the log entry is about (might be empty)
linenointThe number of the line in the log file
messagestringThe complete message line including the timestamp
optionsstringThe part of the message after the ':'
plugin_outputstringThe output of the check, if any is associated with the message
service_descriptionstringThe description of the service log entry is about (might be empty)
stateintThe state of the host or service in question
state_typestringThe type of the state (varies on different log classes)
timetimeTime of the log event (UNIX timestamp)
typestringThe type of the message (text before the colon), the message itself for info messages

servicegroups

Column Type Description
action_urlstringAn optional URL to custom notes or actions on the service group
aliasstringAn alias of the service group
idintServicegroup id
memberslistA list of all members of the service group as host/service pairs
members_with_statelistA list of all members of the service group with state and has_been_checked
namestringThe name of the service group
notesstringOptional additional notes about the service group
notes_urlstringAn optional URL to further notes on the service group
num_servicesintThe total number of services in the group
num_services_critintThe number of services in the group that are CRIT
num_services_hard_critintThe number of services in the group that are CRIT
num_services_hard_okintThe number of services in the group that are OK
num_services_hard_unknownintThe number of services in the group that are UNKNOWN
num_services_hard_warnintThe number of services in the group that are WARN
num_services_okintThe number of services in the group that are OK
num_services_pendingintThe number of services in the group that are PENDING
num_services_unknownintThe number of services in the group that are UNKNOWN
num_services_warnintThe number of services in the group that are WARN
worst_service_stateintThe worst soft state of all of the groups services (OK <= WARN <= UNKNOWN <= CRIT)

services

Column Type Description
_host_All columns from the hosts table are available via host_ prefix.
accept_passive_checksintWhether the service accepts passive checks (0/1)
acknowledgedintWhether the current service problem has been acknowledged (0/1)
acknowledgement_typeintThe type of the acknowledgement (0: none, 1: normal, 2: sticky)
action_urlstringAn optional URL for actions or custom information about the service
action_url_expandedstringThe action_url with (the most important) macros expanded
active_checks_enabledintWhether active checks are enabled for the service (0/1)
check_commandstringNaemon command used for active checks
check_freshnessintWhether freshness checks are activated (0/1)
check_intervalfloatNumber of basic interval lengths between two scheduled checks of the service
check_optionsintThe current check option, forced, normal, freshness... (0/1)
check_periodstringThe name of the check period of the service. It this is empty, the service is always checked.
check_sourcestringThe source of the check
check_typeintThe type of the last check (0: active, 1: passive)
checks_enabledintWhether active checks are enabled for the service (0/1)
commentslistA list of all comment ids of the service
comments_with_infolistA list of all comments of the service with id, author and comment
contact_groupslistA list of all contact groups this service is in
contactslistA list of all contacts of the service, either direct or via a contact group
current_attemptintThe number of the current check attempt
current_notification_numberintThe number of the current notification
custom_variable_nameslistA list of the names of all custom variables of the service
custom_variable_valueslistA list of the values of all custom variable of the service
custom_variablesdictA dictionary of the custom variables
depends_execlistA list of all services this service depends on to execute
depends_exec_with_infolistA list of all services this service depends on to execute including information: host_name, service_description, failure_options, dependency_period and inherits_parent
depends_notifylistA list of all services this service depends on to notify
depends_notify_with_infolistA list of all services this service depends on to notify including information: host_name, service_description, failure_options, dependency_period and inherits_parent
descriptionstringDescription of the service (also used as key)
display_namestringAn optional display name
downtimeslistA list of all downtime ids of the service
downtimes_with_infolistA list of all downtimes of the service with id, author and comment
event_handlerstringNaemon command used as event handler
event_handler_enabledintWhether and event handler is activated for the service (0/1)
execution_timefloatTime the service check needed for execution
first_notification_delayfloatDelay before the first notification
flap_detection_enabledintWhether flap detection is enabled for the service (0/1)
groupslistA list of all service groups the service is in
has_been_checkedintWhether the service already has been checked (0/1)
high_flap_thresholdfloatHigh threshold of flap detection
hourly_valueintHourly Value
icon_imagestringThe name of an image to be used as icon in the web interface
icon_image_altstringAn alternative text for the icon_image for browsers not displaying icons
icon_image_expandedstringThe icon_image with (the most important) macros expanded
idintService id
in_check_periodintWhether the service is currently in its check period (0/1)
in_notification_periodintWhether the service is currently in its notification period (0/1)
initial_stateintThe initial state of the service
is_executingintis there a service check currently running... (0/1)
is_flappingintWhether the service is flapping (0/1)
last_checktimeThe time of the last check (Unix timestamp)
last_hard_stateintThe last hard state of the service
last_hard_state_changetimeThe time of the last hard state change (Unix timestamp)
last_notificationtimeThe time of the last notification (Unix timestamp)
last_stateintThe last state of the service
last_state_changetimeThe time of the last state change (Unix timestamp)
last_time_criticaltimeThe last time the service was CRITICAL (Unix timestamp)
last_time_oktimeThe last time the service was OK (Unix timestamp)
last_time_unknowntimeThe last time the service was UNKNOWN (Unix timestamp)
last_time_warningtimeThe last time the service was in WARNING state (Unix timestamp)
last_updatetimeTime of the last update of this service (Unix timestamp)
latencyfloatTime difference between scheduled check time and actual check time
long_plugin_outputstringUnabbreviated output of the last check plugin
low_flap_thresholdfloatLow threshold of flap detection
max_check_attemptsintThe maximum number of check attempts
modified_attributesintA bitmask specifying which attributes have been modified
modified_attributes_listlistA list of all modified attributes
next_checktimeThe scheduled time of the next check (Unix timestamp)
next_notificationtimeThe time of the next notification (Unix timestamp)
no_more_notificationsintWhether to stop sending notifications (0/1)
notesstringOptional notes about the service
notes_expandedstringThe notes with (the most important) macros expanded
notes_urlstringAn optional URL for additional notes about the service
notes_url_expandedstringThe notes_url with (the most important) macros expanded
notification_intervalfloatInterval of periodic notification or 0 if its off
notification_periodstringThe name of the notification period of the service. It this is empty, service problems are always notified.
notifications_enabledintWhether notifications are enabled for the service (0/1)
notified_onintFlags determining which states have been notified on
obsessintWhether 'obsess' is enabled for the service (0/1)
obsess_over_serviceintWhether 'obsess' is enabled for the service (0/1)
parentslistA list of all parent services (descriptions only, because they are all same-host)
percent_state_changefloatPercent state change
perf_datastringPerformance data of the last check plugin
plugin_outputstringOutput of the last check plugin
pnpgraph_presentintWhether there is a PNP4Nagios graph present for this service (0/1)
process_performance_dataintWhether processing of performance data is enabled for the service (0/1)
retry_intervalfloatNumber of basic interval lengths between checks when retrying after a soft error
scheduled_downtime_depthintThe number of scheduled downtimes the service is currently in
should_be_scheduledintWhether naemon still tries to run checks on this service (0/1)
stalenessfloatThe staleness indicator for this service
stateintThe current state of the service (0: OK, 1: WARN, 2: CRITICAL, 3: UNKNOWN)
state_typeintThe type of the current state (0: soft, 1: hard)

servicesbygroup

Column Type Description
accept_passive_checksintWhether the service accepts passive checks (0/1)
acknowledgedintWhether the current service problem has been acknowledged (0/1)
acknowledgement_typeintThe type of the acknowledgement (0: none, 1: normal, 2: sticky)
action_urlstringAn optional URL for actions or custom information about the service
action_url_expandedstringThe action_url with (the most important) macros expanded
active_checks_enabledintWhether active checks are enabled for the service (0/1)
check_commandstringNaemon command used for active checks
check_freshnessintWhether freshness checks are activated (0/1)
check_intervalfloatNumber of basic interval lengths between two scheduled checks of the service
check_optionsintThe current check option, forced, normal, freshness... (0/1)
check_periodstringThe name of the check period of the service. It this is empty, the service is always checked.
check_sourcestringThe source of the check
check_typeintThe type of the last check (0: active, 1: passive)
checks_enabledintWhether active checks are enabled for the service (0/1)
commentslistA list of all comment ids of the service
comments_with_infolistA list of all comments of the service with id, author and comment
contact_groupslistA list of all contact groups this service is in
contactslistA list of all contacts of the service, either direct or via a contact group
current_attemptintThe number of the current check attempt
current_notification_numberintThe number of the current notification
custom_variable_nameslistA list of the names of all custom variables of the service
custom_variable_valueslistA list of the values of all custom variable of the service
custom_variablesdictA dictionary of the custom variables
depends_execlistA list of all services this service depends on to execute
depends_exec_with_infolistA list of all services this service depends on to execute including information: host_name, service_description, failure_options, dependency_period and inherits_parent
depends_notifylistA list of all services this service depends on to notify
depends_notify_with_infolistA list of all services this service depends on to notify including information: host_name, service_description, failure_options, dependency_period and inherits_parent
descriptionstringDescription of the service (also used as key)
display_namestringAn optional display name
downtimeslistA list of all downtime ids of the service
downtimes_with_infolistA list of all downtimes of the service with id, author and comment
event_handlerstringNaemon command used as event handler
event_handler_enabledintWhether and event handler is activated for the service (0/1)
execution_timefloatTime the service check needed for execution
first_notification_delayfloatDelay before the first notification
flap_detection_enabledintWhether flap detection is enabled for the service (0/1)
groupslistA list of all service groups the service is in
has_been_checkedintWhether the service already has been checked (0/1)
high_flap_thresholdfloatHigh threshold of flap detection
host_accept_passive_checksintWhether passive host checks are accepted (0/1)
host_acknowledgedintWhether the current host problem has been acknowledged (0/1)
host_acknowledgement_typeintType of acknowledgement (0: none, 1: normal, 2: stick)
host_action_urlstringAn optional URL to custom actions or information about this host
host_action_url_expandedstringThe same as action_url, but with the most important macros expanded
host_active_checks_enabledintWhether active checks are enabled for the host (0/1)
host_addressstringIP address
host_aliasstringAn alias name for the host
host_check_commandstringNaemon command for active host check of this host
host_check_flapping_recovery_notificationintWhether to check to send a recovery notification when flapping stops (0/1)
host_check_freshnessintWhether freshness checks are activated (0/1)
host_check_intervalfloatNumber of basic interval lengths between two scheduled checks of the host
host_check_optionsintThe current check option, forced, normal, freshness... (0-2)
host_check_periodstringTime period in which this host will be checked. If empty then the host will always be checked.
host_check_sourcestringThe source of the check
host_check_typeintType of check (0: active, 1: passive)
host_checks_enabledintWhether checks of the host are enabled (0/1)
host_childslistA list of all direct children of the host
host_commentslistA list of the ids of all comments of this host
host_comments_with_infolistA list of all comments of the host with id, author and comment
host_contact_groupslistA list of all contact groups this host is in
host_contactslistA list of all contacts of this host, either direct or via a contact group
host_current_attemptintNumber of the current check attempts
host_current_notification_numberintNumber of the current notification
host_custom_variable_nameslistA list of the names of all custom variables
host_custom_variable_valueslistA list of the values of the custom variables
host_custom_variablesdictA dictionary of the custom variables
host_depends_execlistA list of all hosts this hosts depends on to execute
host_depends_exec_with_infolistA list of all hosts this hosts depends on to execute including information: host_name, failure_options, dependency_period and inherits_parent
host_depends_notifylistA list of all hosts this hosts depends on to notify
host_depends_notify_with_infolistA list of all hosts this hosts depends on to notify including information: host_name, failure_options, dependency_period and inherits_parent
host_display_namestringOptional display name of the host
host_downtimeslistA list of the ids of all scheduled downtimes of this host
host_downtimes_with_infolistA list of the all scheduled downtimes of the host with id, author and comment
host_event_handlerstringNaemon command used as event handler
host_event_handler_enabledintWhether event handling is enabled (0/1)
host_execution_timefloatTime the host check needed for execution
host_filenamestringThe value of the custom variable FILENAME
host_first_notification_delayfloatDelay before the first notification
host_flap_detection_enabledintWhether flap detection is enabled (0/1)
host_groupslistA list of all host groups this host is in
host_hard_stateintThe effective hard state of the host (eliminates a problem in hard_state)
host_has_been_checkedintWhether the host has already been checked (0/1)
host_high_flap_thresholdfloatHigh threshold of flap detection
host_hourly_valueintHourly Value
host_icon_imagestringThe name of an image file to be used in the web pages
host_icon_image_altstringAlternative text for the icon_image
host_icon_image_expandedstringThe same as icon_image, but with the most important macros expanded
host_idintHost id
host_in_check_periodintWhether this host is currently in its check period (0/1)
host_in_notification_periodintWhether this host is currently in its notification period (0/1)
host_initial_stateintInitial host state
host_is_executingintis there a host check currently running... (0/1)
host_is_flappingintWhether the host state is flapping (0/1)
host_last_checktimeTime of the last check (Unix timestamp)
host_last_hard_stateintLast hard state
host_last_hard_state_changetimeTime of the last hard state change (Unix timestamp)
host_last_notificationtimeTime of the last notification (Unix timestamp)
host_last_stateintState before last state change
host_last_state_changetimeTime of the last state change - soft or hard (Unix timestamp)
host_last_time_downtimeThe last time the host was DOWN (Unix timestamp)
host_last_time_unreachabletimeThe last time the host was UNREACHABLE (Unix timestamp)
host_last_time_uptimeThe last time the host was UP (Unix timestamp)
host_last_updatetimeTime of the last update of this host (Unix timestamp)
host_latencyfloatTime difference between scheduled check time and actual check time
host_long_plugin_outputstringComplete output from check plugin
host_low_flap_thresholdfloatLow threshold of flap detection
host_max_check_attemptsintMax check attempts for active host checks
host_modified_attributesintA bitmask specifying which attributes have been modified
host_modified_attributes_listlistA list of all modified attributes
host_namestringHost name
host_next_checktimeScheduled time for the next check (Unix timestamp)
host_next_notificationtimeTime of the next notification (Unix timestamp)
host_no_more_notificationsintWhether to stop sending notifications (0/1)
host_notesstringOptional notes for this host
host_notes_expandedstringThe same as notes, but with the most important macros expanded
host_notes_urlstringAn optional URL with further information about the host
host_notes_url_expandedstringSame as notes_url, but with the most important macros expanded
host_notification_intervalfloatInterval of periodic notification or 0 if its off
host_notification_periodstringTime period in which problems of this host will be notified. If empty then notification will be always
host_notifications_enabledintWhether notifications of the host are enabled (0/1)
host_notified_onintFlags determining which states have been notified on
host_num_servicesintThe total number of services of the host
host_num_services_critintThe number of the host's services with the soft state CRIT
host_num_services_hard_critintThe number of the host's services with the hard state CRIT
host_num_services_hard_okintThe number of the host's services with the hard state OK
host_num_services_hard_unknownintThe number of the host's services with the hard state UNKNOWN
host_num_services_hard_warnintThe number of the host's services with the hard state WARN
host_num_services_okintThe number of the host's services with the soft state OK
host_num_services_pendingintThe number of the host's services which have not been checked yet (pending)
host_num_services_unknownintThe number of the host's services with the soft state UNKNOWN
host_num_services_warnintThe number of the host's services with the soft state WARN
host_obsessintThe current obsess setting... (0/1)
host_obsess_over_hostintThe current obsess setting... (0/1)
host_parentslistA list of all direct parents of the host
host_pending_flex_downtimeintWhether a flex downtime is pending (0/1)
host_percent_state_changefloatPercent state change
host_perf_datastringOptional performance data of the last host check
host_plugin_outputstringOutput of the last host check
host_pnpgraph_presentintWhether there is a PNP4Nagios graph present for this host (0/1)
host_process_performance_dataintWhether processing of performance data is enabled (0/1)
host_retry_intervalfloatNumber of basic interval lengths between checks when retrying after a soft error
host_scheduled_downtime_depthintThe number of downtimes this host is currently in
host_serviceslistA list of all services of the host
host_services_with_infolistA list of all services including detailed information about each service
host_services_with_statelistA list of all services of the host together with state and has_been_checked
host_should_be_scheduledintWhether naemon still tries to run checks on this host (0/1)
host_stalenessfloatStaleness indicator for this host
host_stateintThe current state of the host (0: up, 1: down, 2: unreachable)
host_state_typeintType of the current state (0: soft, 1: hard)
host_statusmap_imagestringThe name of in image file for the status map
host_total_servicesintThe total number of services of the host
host_worst_service_hard_stateintThe worst hard state of all of the host's services (OK <= WARN <= UNKNOWN <= CRIT)
host_worst_service_stateintThe worst soft state of all of the host's services (OK <= WARN <= UNKNOWN <= CRIT)
host_x_3dfloat3D-Coordinates: X
host_y_3dfloat3D-Coordinates: Y
host_z_3dfloat3D-Coordinates: Z
hourly_valueintHourly Value
icon_imagestringThe name of an image to be used as icon in the web interface
icon_image_altstringAn alternative text for the icon_image for browsers not displaying icons
icon_image_expandedstringThe icon_image with (the most important) macros expanded
idintService id
in_check_periodintWhether the service is currently in its check period (0/1)
in_notification_periodintWhether the service is currently in its notification period (0/1)
initial_stateintThe initial state of the service
is_executingintis there a service check currently running... (0/1)
is_flappingintWhether the service is flapping (0/1)
last_checktimeThe time of the last check (Unix timestamp)
last_hard_stateintThe last hard state of the service
last_hard_state_changetimeThe time of the last hard state change (Unix timestamp)
last_notificationtimeThe time of the last notification (Unix timestamp)
last_stateintThe last state of the service
last_state_changetimeThe time of the last state change (Unix timestamp)
last_time_criticaltimeThe last time the service was CRITICAL (Unix timestamp)
last_time_oktimeThe last time the service was OK (Unix timestamp)
last_time_unknowntimeThe last time the service was UNKNOWN (Unix timestamp)
last_time_warningtimeThe last time the service was in WARNING state (Unix timestamp)
last_updatetimeTime of the last update of this service (Unix timestamp)
latencyfloatTime difference between scheduled check time and actual check time
long_plugin_outputstringUnabbreviated output of the last check plugin
low_flap_thresholdfloatLow threshold of flap detection
max_check_attemptsintThe maximum number of check attempts
modified_attributesintA bitmask specifying which attributes have been modified
modified_attributes_listlistA list of all modified attributes
next_checktimeThe scheduled time of the next check (Unix timestamp)
next_notificationtimeThe time of the next notification (Unix timestamp)
no_more_notificationsintWhether to stop sending notifications (0/1)
notesstringOptional notes about the service
notes_expandedstringThe notes with (the most important) macros expanded
notes_urlstringAn optional URL for additional notes about the service
notes_url_expandedstringThe notes_url with (the most important) macros expanded
notification_intervalfloatInterval of periodic notification or 0 if its off
notification_periodstringThe name of the notification period of the service. It this is empty, service problems are always notified.
notifications_enabledintWhether notifications are enabled for the service (0/1)
notified_onintFlags determining which states have been notified on
obsessintWhether 'obsess' is enabled for the service (0/1)
obsess_over_serviceintWhether 'obsess' is enabled for the service (0/1)
parentslistA list of all parent services (descriptions only, because they are all same-host)
percent_state_changefloatPercent state change
perf_datastringPerformance data of the last check plugin
plugin_outputstringOutput of the last check plugin
pnpgraph_presentintWhether there is a PNP4Nagios graph present for this service (0/1)
process_performance_dataintWhether processing of performance data is enabled for the service (0/1)
retry_intervalfloatNumber of basic interval lengths between checks when retrying after a soft error
scheduled_downtime_depthintThe number of scheduled downtimes the service is currently in
servicegroup_action_urlstringAn optional URL to custom notes or actions on the service group
servicegroup_aliasstringAn alias of the service group
servicegroup_idintServicegroup id
servicegroup_memberslistA list of all members of the service group as host/service pairs
servicegroup_members_with_statelistA list of all members of the service group with state and has_been_checked
servicegroup_namestringThe name of the service group
servicegroup_notesstringOptional additional notes about the service group
servicegroup_notes_urlstringAn optional URL to further notes on the service group
servicegroup_num_servicesintThe total number of services in the group
servicegroup_num_services_critintThe number of services in the group that are CRIT
servicegroup_num_services_hard_critintThe number of services in the group that are CRIT
servicegroup_num_services_hard_okintThe number of services in the group that are OK
servicegroup_num_services_hard_unknownintThe number of services in the group that are UNKNOWN
servicegroup_num_services_hard_warnintThe number of services in the group that are WARN
servicegroup_num_services_okintThe number of services in the group that are OK
servicegroup_num_services_pendingintThe number of services in the group that are PENDING
servicegroup_num_services_unknownintThe number of services in the group that are UNKNOWN
servicegroup_num_services_warnintThe number of services in the group that are WARN
servicegroup_worst_service_stateintThe worst soft state of all of the groups services (OK <= WARN <= UNKNOWN <= CRIT)
should_be_scheduledintWhether naemon still tries to run checks on this service (0/1)
stalenessfloatThe staleness indicator for this service
stateintThe current state of the service (0: OK, 1: WARN, 2: CRITICAL, 3: UNKNOWN)
state_typeintThe type of the current state (0: soft, 1: hard)

servicesbyhostgroup

Column Type Description
accept_passive_checksintWhether the service accepts passive checks (0/1)
acknowledgedintWhether the current service problem has been acknowledged (0/1)
acknowledgement_typeintThe type of the acknowledgement (0: none, 1: normal, 2: sticky)
action_urlstringAn optional URL for actions or custom information about the service
action_url_expandedstringThe action_url with (the most important) macros expanded
active_checks_enabledintWhether active checks are enabled for the service (0/1)
check_commandstringNaemon command used for active checks
check_freshnessintWhether freshness checks are activated (0/1)
check_intervalfloatNumber of basic interval lengths between two scheduled checks of the service
check_optionsintThe current check option, forced, normal, freshness... (0/1)
check_periodstringThe name of the check period of the service. It this is empty, the service is always checked.
check_sourcestringThe source of the check
check_typeintThe type of the last check (0: active, 1: passive)
checks_enabledintWhether active checks are enabled for the service (0/1)
commentslistA list of all comment ids of the service
comments_with_infolistA list of all comments of the service with id, author and comment
contact_groupslistA list of all contact groups this service is in
contactslistA list of all contacts of the service, either direct or via a contact group
current_attemptintThe number of the current check attempt
current_notification_numberintThe number of the current notification
custom_variable_nameslistA list of the names of all custom variables of the service
custom_variable_valueslistA list of the values of all custom variable of the service
custom_variablesdictA dictionary of the custom variables
depends_execlistA list of all services this service depends on to execute
depends_exec_with_infolistA list of all services this service depends on to execute including information: host_name, service_description, failure_options, dependency_period and inherits_parent
depends_notifylistA list of all services this service depends on to notify
depends_notify_with_infolistA list of all services this service depends on to notify including information: host_name, service_description, failure_options, dependency_period and inherits_parent
descriptionstringDescription of the service (also used as key)
display_namestringAn optional display name
downtimeslistA list of all downtime ids of the service
downtimes_with_infolistA list of all downtimes of the service with id, author and comment
event_handlerstringNaemon command used as event handler
event_handler_enabledintWhether and event handler is activated for the service (0/1)
execution_timefloatTime the service check needed for execution
first_notification_delayfloatDelay before the first notification
flap_detection_enabledintWhether flap detection is enabled for the service (0/1)
groupslistA list of all service groups the service is in
has_been_checkedintWhether the service already has been checked (0/1)
high_flap_thresholdfloatHigh threshold of flap detection
host_accept_passive_checksintWhether passive host checks are accepted (0/1)
host_acknowledgedintWhether the current host problem has been acknowledged (0/1)
host_acknowledgement_typeintType of acknowledgement (0: none, 1: normal, 2: stick)
host_action_urlstringAn optional URL to custom actions or information about this host
host_action_url_expandedstringThe same as action_url, but with the most important macros expanded
host_active_checks_enabledintWhether active checks are enabled for the host (0/1)
host_addressstringIP address
host_aliasstringAn alias name for the host
host_check_commandstringNaemon command for active host check of this host
host_check_flapping_recovery_notificationintWhether to check to send a recovery notification when flapping stops (0/1)
host_check_freshnessintWhether freshness checks are activated (0/1)
host_check_intervalfloatNumber of basic interval lengths between two scheduled checks of the host
host_check_optionsintThe current check option, forced, normal, freshness... (0-2)
host_check_periodstringTime period in which this host will be checked. If empty then the host will always be checked.
host_check_sourcestringThe source of the check
host_check_typeintType of check (0: active, 1: passive)
host_checks_enabledintWhether checks of the host are enabled (0/1)
host_childslistA list of all direct children of the host
host_commentslistA list of the ids of all comments of this host
host_comments_with_infolistA list of all comments of the host with id, author and comment
host_contact_groupslistA list of all contact groups this host is in
host_contactslistA list of all contacts of this host, either direct or via a contact group
host_current_attemptintNumber of the current check attempts
host_current_notification_numberintNumber of the current notification
host_custom_variable_nameslistA list of the names of all custom variables
host_custom_variable_valueslistA list of the values of the custom variables
host_custom_variablesdictA dictionary of the custom variables
host_depends_execlistA list of all hosts this hosts depends on to execute
host_depends_exec_with_infolistA list of all hosts this hosts depends on to execute including information: host_name, failure_options, dependency_period and inherits_parent
host_depends_notifylistA list of all hosts this hosts depends on to notify
host_depends_notify_with_infolistA list of all hosts this hosts depends on to notify including information: host_name, failure_options, dependency_period and inherits_parent
host_display_namestringOptional display name of the host
host_downtimeslistA list of the ids of all scheduled downtimes of this host
host_downtimes_with_infolistA list of the all scheduled downtimes of the host with id, author and comment
host_event_handlerstringNaemon command used as event handler
host_event_handler_enabledintWhether event handling is enabled (0/1)
host_execution_timefloatTime the host check needed for execution
host_filenamestringThe value of the custom variable FILENAME
host_first_notification_delayfloatDelay before the first notification
host_flap_detection_enabledintWhether flap detection is enabled (0/1)
host_groupslistA list of all host groups this host is in
host_hard_stateintThe effective hard state of the host (eliminates a problem in hard_state)
host_has_been_checkedintWhether the host has already been checked (0/1)
host_high_flap_thresholdfloatHigh threshold of flap detection
host_hourly_valueintHourly Value
host_icon_imagestringThe name of an image file to be used in the web pages
host_icon_image_altstringAlternative text for the icon_image
host_icon_image_expandedstringThe same as icon_image, but with the most important macros expanded
host_idintHost id
host_in_check_periodintWhether this host is currently in its check period (0/1)
host_in_notification_periodintWhether this host is currently in its notification period (0/1)
host_initial_stateintInitial host state
host_is_executingintis there a host check currently running... (0/1)
host_is_flappingintWhether the host state is flapping (0/1)
host_last_checktimeTime of the last check (Unix timestamp)
host_last_hard_stateintLast hard state
host_last_hard_state_changetimeTime of the last hard state change (Unix timestamp)
host_last_notificationtimeTime of the last notification (Unix timestamp)
host_last_stateintState before last state change
host_last_state_changetimeTime of the last state change - soft or hard (Unix timestamp)
host_last_time_downtimeThe last time the host was DOWN (Unix timestamp)
host_last_time_unreachabletimeThe last time the host was UNREACHABLE (Unix timestamp)
host_last_time_uptimeThe last time the host was UP (Unix timestamp)
host_last_updatetimeTime of the last update of this host (Unix timestamp)
host_latencyfloatTime difference between scheduled check time and actual check time
host_long_plugin_outputstringComplete output from check plugin
host_low_flap_thresholdfloatLow threshold of flap detection
host_max_check_attemptsintMax check attempts for active host checks
host_modified_attributesintA bitmask specifying which attributes have been modified
host_modified_attributes_listlistA list of all modified attributes
host_namestringHost name
host_next_checktimeScheduled time for the next check (Unix timestamp)
host_next_notificationtimeTime of the next notification (Unix timestamp)
host_no_more_notificationsintWhether to stop sending notifications (0/1)
host_notesstringOptional notes for this host
host_notes_expandedstringThe same as notes, but with the most important macros expanded
host_notes_urlstringAn optional URL with further information about the host
host_notes_url_expandedstringSame as notes_url, but with the most important macros expanded
host_notification_intervalfloatInterval of periodic notification or 0 if its off
host_notification_periodstringTime period in which problems of this host will be notified. If empty then notification will be always
host_notifications_enabledintWhether notifications of the host are enabled (0/1)
host_notified_onintFlags determining which states have been notified on
host_num_servicesintThe total number of services of the host
host_num_services_critintThe number of the host's services with the soft state CRIT
host_num_services_hard_critintThe number of the host's services with the hard state CRIT
host_num_services_hard_okintThe number of the host's services with the hard state OK
host_num_services_hard_unknownintThe number of the host's services with the hard state UNKNOWN
host_num_services_hard_warnintThe number of the host's services with the hard state WARN
host_num_services_okintThe number of the host's services with the soft state OK
host_num_services_pendingintThe number of the host's services which have not been checked yet (pending)
host_num_services_unknownintThe number of the host's services with the soft state UNKNOWN
host_num_services_warnintThe number of the host's services with the soft state WARN
host_obsessintThe current obsess setting... (0/1)
host_obsess_over_hostintThe current obsess setting... (0/1)
host_parentslistA list of all direct parents of the host
host_pending_flex_downtimeintWhether a flex downtime is pending (0/1)
host_percent_state_changefloatPercent state change
host_perf_datastringOptional performance data of the last host check
host_plugin_outputstringOutput of the last host check
host_pnpgraph_presentintWhether there is a PNP4Nagios graph present for this host (0/1)
host_process_performance_dataintWhether processing of performance data is enabled (0/1)
host_retry_intervalfloatNumber of basic interval lengths between checks when retrying after a soft error
host_scheduled_downtime_depthintThe number of downtimes this host is currently in
host_serviceslistA list of all services of the host
host_services_with_infolistA list of all services including detailed information about each service
host_services_with_statelistA list of all services of the host together with state and has_been_checked
host_should_be_scheduledintWhether naemon still tries to run checks on this host (0/1)
host_stalenessfloatStaleness indicator for this host
host_stateintThe current state of the host (0: up, 1: down, 2: unreachable)
host_state_typeintType of the current state (0: soft, 1: hard)
host_statusmap_imagestringThe name of in image file for the status map
host_total_servicesintThe total number of services of the host
host_worst_service_hard_stateintThe worst hard state of all of the host's services (OK <= WARN <= UNKNOWN <= CRIT)
host_worst_service_stateintThe worst soft state of all of the host's services (OK <= WARN <= UNKNOWN <= CRIT)
host_x_3dfloat3D-Coordinates: X
host_y_3dfloat3D-Coordinates: Y
host_z_3dfloat3D-Coordinates: Z
hostgroup_action_urlstringAn optional URL to custom actions or information about the hostgroup
hostgroup_aliasstringAn alias of the hostgroup
hostgroup_idintHostgroup id
hostgroup_memberslistA list of all host names that are members of the hostgroup
hostgroup_members_with_statelistA list of all host names that are members of the hostgroup together with state and has_been_checked
hostgroup_namestringName of the hostgroup
hostgroup_notesstringOptional notes to the hostgroup
hostgroup_notes_urlstringAn optional URL with further information about the hostgroup
hostgroup_num_hostsintThe total number of hosts in the group
hostgroup_num_hosts_downintThe number of hosts in the group that are down
hostgroup_num_hosts_pendingintThe number of hosts in the group that are pending
hostgroup_num_hosts_unreachintThe number of hosts in the group that are unreachable
hostgroup_num_hosts_upintThe number of hosts in the group that are up
hostgroup_num_servicesintThe total number of services of hosts in this group
hostgroup_num_services_critintThe total number of services with the state CRIT of hosts in this group
hostgroup_num_services_hard_critintThe total number of services with the state CRIT of hosts in this group
hostgroup_num_services_hard_okintThe total number of services with the state OK of hosts in this group
hostgroup_num_services_hard_unknownintThe total number of services with the state UNKNOWN of hosts in this group
hostgroup_num_services_hard_warnintThe total number of services with the state WARN of hosts in this group
hostgroup_num_services_okintThe total number of services with the state OK of hosts in this group
hostgroup_num_services_pendingintThe total number of services with the state Pending of hosts in this group
hostgroup_num_services_unknownintThe total number of services with the state UNKNOWN of hosts in this group
hostgroup_num_services_warnintThe total number of services with the state WARN of hosts in this group
hostgroup_worst_host_stateintThe worst state of all of the groups' hosts (UP <= UNREACHABLE <= DOWN)
hostgroup_worst_service_hard_stateintThe worst state of all services that belong to a host of this group (OK <= WARN <= UNKNOWN <= CRIT)
hostgroup_worst_service_stateintThe worst state of all services that belong to a host of this group (OK <= WARN <= UNKNOWN <= CRIT)
hourly_valueintHourly Value
icon_imagestringThe name of an image to be used as icon in the web interface
icon_image_altstringAn alternative text for the icon_image for browsers not displaying icons
icon_image_expandedstringThe icon_image with (the most important) macros expanded
idintService id
in_check_periodintWhether the service is currently in its check period (0/1)
in_notification_periodintWhether the service is currently in its notification period (0/1)
initial_stateintThe initial state of the service
is_executingintis there a service check currently running... (0/1)
is_flappingintWhether the service is flapping (0/1)
last_checktimeThe time of the last check (Unix timestamp)
last_hard_stateintThe last hard state of the service
last_hard_state_changetimeThe time of the last hard state change (Unix timestamp)
last_notificationtimeThe time of the last notification (Unix timestamp)
last_stateintThe last state of the service
last_state_changetimeThe time of the last state change (Unix timestamp)
last_time_criticaltimeThe last time the service was CRITICAL (Unix timestamp)
last_time_oktimeThe last time the service was OK (Unix timestamp)
last_time_unknowntimeThe last time the service was UNKNOWN (Unix timestamp)
last_time_warningtimeThe last time the service was in WARNING state (Unix timestamp)
last_updatetimeTime of the last update of this service (Unix timestamp)
latencyfloatTime difference between scheduled check time and actual check time
long_plugin_outputstringUnabbreviated output of the last check plugin
low_flap_thresholdfloatLow threshold of flap detection
max_check_attemptsintThe maximum number of check attempts
modified_attributesintA bitmask specifying which attributes have been modified
modified_attributes_listlistA list of all modified attributes
next_checktimeThe scheduled time of the next check (Unix timestamp)
next_notificationtimeThe time of the next notification (Unix timestamp)
no_more_notificationsintWhether to stop sending notifications (0/1)
notesstringOptional notes about the service
notes_expandedstringThe notes with (the most important) macros expanded
notes_urlstringAn optional URL for additional notes about the service
notes_url_expandedstringThe notes_url with (the most important) macros expanded
notification_intervalfloatInterval of periodic notification or 0 if its off
notification_periodstringThe name of the notification period of the service. It this is empty, service problems are always notified.
notifications_enabledintWhether notifications are enabled for the service (0/1)
notified_onintFlags determining which states have been notified on
obsessintWhether 'obsess' is enabled for the service (0/1)
obsess_over_serviceintWhether 'obsess' is enabled for the service (0/1)
parentslistA list of all parent services (descriptions only, because they are all same-host)
percent_state_changefloatPercent state change
perf_datastringPerformance data of the last check plugin
plugin_outputstringOutput of the last check plugin
pnpgraph_presentintWhether there is a PNP4Nagios graph present for this service (0/1)
process_performance_dataintWhether processing of performance data is enabled for the service (0/1)
retry_intervalfloatNumber of basic interval lengths between checks when retrying after a soft error
scheduled_downtime_depthintThe number of scheduled downtimes the service is currently in
should_be_scheduledintWhether naemon still tries to run checks on this service (0/1)
stalenessfloatThe staleness indicator for this service
stateintThe current state of the service (0: OK, 1: WARN, 2: CRITICAL, 3: UNKNOWN)
state_typeintThe type of the current state (0: soft, 1: hard)

statehist

Column Type Description
_host_All columns from the hosts table are available via current_host_ prefix.
_service_All columns from the services table are available via current_service_ prefix.
debug_infostringDebug information
durationintDuration of state (until - from)
duration_criticalintCRITICAL duration of state (until - from)
duration_okintOK duration of state ( until - from )
duration_partfloatDuration part in regard to the query timeframe
duration_part_criticalfloatCRITICAL duration part in regard to the query timeframe
duration_part_okfloatOK duration part in regard to the query timeframe
duration_part_unknownfloatUNKNOWN duration part in regard to the query timeframe
duration_part_unmonitoredfloatUNMONITORED duration part in regard to the query timeframe
duration_part_warningfloatWARNING duration part in regard to the query timeframe
duration_unknownintUNKNOWN duration of state (until - from)
duration_unmonitoredintUNMONITORED duration of state (until - from)
duration_warningintWARNING duration of state (until - from)
fromtimeStart time of state (seconds since 1/1/1970)
host_downintShows if the host of this service is down
host_namestringHost name
in_downtimeintShows if the host or service is in downtime
in_host_downtimeintShows if the host of this service is in downtime
in_notification_periodintShows if the host or service is within its notification period
in_service_periodintShows if the host or service is within its service period
is_flappingintShows if the host or service is flapping
linenointThe number of the line in the log file
log_outputstringLogfile output relevant for this state
notification_periodstringThe notification period of the host or service in question
service_descriptionstringDescription of the service
service_periodstringThe service period of the host or service in question
stateintThe state of the host or service in question - OK(0) / WARNING(1) / CRITICAL(2) / UNKNOWN(3) / UNMONITORED(-1)
timetimeTime of the log event (seconds since 1/1/1970)
untiltimeEnd time of state (seconds since 1/1/1970)

status

Column Type Description
accept_passive_host_checksintWhether passive host checks are accepted in general (0/1)
accept_passive_service_checksintWhether passive service checks are activated in general (0/1)
cached_log_messagesintThe current number of log messages Naemon Livestatus keeps in memory
check_external_commandsintWhether Naemon checks for external commands at its command pipe (0/1)
check_host_freshnessintWhether host freshness checking is activated in general (0/1)
check_service_freshnessintWhether service freshness checking is activated in general (0/1)
connectionsintThe number of client connections to Livestatus since program start
connections_ratefloatThe averaged number of new client connections to Livestatus per second
enable_event_handlersintWhether event handlers are activated in general (0/1)
enable_flap_detectionintWhether flap detection is activated in general (0/1)
enable_notificationsintWhether notifications are enabled in general (0/1)
execute_host_checksintWhether host checks are executed in general (0/1)
execute_service_checksintWhether active service checks are activated in general (0/1)
forksintThe number of process creations since program start
forks_ratefloatthe averaged number of forks checks per second
host_checksintThe number of host checks since program start
host_checks_ratefloatthe averaged number of host checks per second
interval_lengthintThe default interval length from naemon.cfg
last_command_checktimeThe time of the last check for a command as UNIX timestamp (deprecated)
last_log_rotationtimeTime time of the last log file rotation
livecheck_overflowsintThe number of times a check could not be executed because now livecheck helper was free
livecheck_overflows_ratefloatThe number of livecheck overflows per second
livechecksintThe number of checks executed via livecheck
livechecks_ratefloatThe averaged number of livechecks executed per second
livestatus_versionstringThe version of the Naemon Livestatus module
log_messagesintThe number of new log messages since program start
log_messages_ratefloatthe averaged number of new log messages per second
nagios_pidintThe process ID of the Naemon main process
neb_callbacksintThe number of NEB call backs since program start
neb_callbacks_ratefloatThe averaged number of NEB call backs per second
num_hostsintThe total number of hosts
num_servicesintThe total number of services
obsess_over_hostsintWhether Naemon will obsess over host checks (0/1)
obsess_over_servicesintWhether Naemon will obsess over service checks and run the ocsp_command (0/1)
process_performance_dataintWhether processing of performance data is activated in general (0/1)
program_starttimeThe time of the last program start as UNIX timestamp
program_versionstringThe version of the monitoring daemon
requestsintThe number of requests to Livestatus since program start
requests_ratefloatThe averaged number of request to Livestatus per second
service_checksintThe number of completed service checks since program start
service_checks_ratefloatThe averaged number of service checks per second

timeperiods

Column Type Description
aliasstringThe alias of the timeperiod
dayslistTime per days, as 7 lists (sun-sat) of a list of even number of elements, representing start,stop,start,stop... in seconds since midnight
exceptions_calendar_dateslistList of objects representing exceptions for DATERANGE_CALENDAR_DATE. For time ranges, see "days" column.
exceptions_month_datelistList of objects representing exceptions for DATERANGE_MONTH_DATE. For time ranges, see "days" column.
exceptions_month_daylistList of objects representing exceptions for DATERANGE_MONTH_DAY. For time ranges, see "days" column.
exceptions_month_week_daylistList of objects representing exceptions for DATERANGE_MONTH_WEEK_DAY. For time ranges, see "days" column.
exceptions_week_daylistList of objects representing exceptions for DATERANGE_WEEK_DAY. For time ranges, see "days" column.
exclusionslistExclusions for this timeperiod
idintTimeperiod id
inintWhether we are currently in this period (0/1)
namestringThe name of the timeperiod