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: