Nagios Status Reference

down_list()

Get Nagios page which lists DOWN hosts

Returns:set of station number of stations that are DOWN.

get_station_status(station_number, down, problem, up)

Check if station is in down, problem or up list.

Parameters:

• station_number – station for which you want the status.
• down – list of stations that are DOWN.
• problem – list of stations that have a service CRITICAL (but are UP).
• up – list of stations that are UP.

Returns:

string denoting the current status of requested station, if the station occurs in multiple lists, the worst case is returned.

get_status_counts(down, problem, up)

Get the lengths of the status lists

Parameters:

• down – set of stations that are DOWN.
• problem – set of stations that have a service CRITICAL (but are UP).
• up – set of stations that are UP and have no services CRITICAL.

Returns:

dictionary containing the counts of stations with a status.

pc_name_to_station_number(shortnames)

Convert list of pc names to station numbers

Parameters:shortnames – list of pc names. Returns:station numbers that have a pc with name in the shortnames.

problem_list()

Get Nagios page which lists hosts with a problem

Returns:set containing station number of stations for which the host has status OK, but some services are CRITICAL.

retrieve_station_status(query)

Get station list from Nagios page which lists hosts of certain level

Parameters:query – query to filter stations on Nagios. Returns:list of station short names on the given page.

status_lists()

Get various station status lists from Nagios

Returns:down, problem, up. lists containing station short names that have the status the variable name implies.

up_list()

Get Nagios page which lists UP hosts

Returns:set of station numbers of stations that are OK.

Contents: