Opsview 6.8.x End of Support

With the release of Opsview 6.11.0 on February 2025, versions 6.8.x have reached their End of Support (EOS) status, according to our Support policy. This means that versions 6.8.x will no longer receive code fixes or security updates.

The documentation for version 6.8.9 and earlier versions will remain accessible for the time being, but it will no longer be updated or receive backports. We strongly recommend upgrading to the latest version of Opsview to ensure continued support and access to the latest features and security enhancements.

Event - Listing

Parameters Copied

• cols — defines which columns of data to return. Acceptable values: hostname, time, objectid, servicename, state, state_type, output, eventid, host_group, host_group_id, markdown_filter, htid, bcid, bsid. Some some columns will always be returned. For multiple columns use: cols=state&cols=hostname.
• startTime — filter by start time, eg. 2011-11-01 18:43:22. Time is based on the server’s timezone.
• endTime — filter by end time.
• rows — the number of rows to return.
• page — which page of data to return.
• sortby — a json structure to describe the ordering of results. Defaults to [{“col”:“time”,”order”:“desc”}].
• host_state — host states to filter on. Can be repeated. Acceptable values: up/0, down/1, unreachable/2.
• service_state — service states to filter on. Can be repeated. Acceptable values: ok/0, warning/1, critical/2, unknown/3.
• host — host names to filter on. Can be repeated.
• service - service — service names to filter on. Can be repeated. Note: there is a limitation that if you filter by service name only, you will get results for all hosts, whether they have the specified service or not.
• serviceonly — if set, will only return services. Otherwise returns host as well as service events. Default unset.
• state_type — state type to filter on. Acceptable values: soft/0, hard/1.
• host_group — host group to filter on. Can be anywhere in the hierarchy. Can be repeated.
• keyword — keyword to filter on. Can be repeated.
• htid — host template ID. Can be repeated.
• bsid — business service ID. Can be repeated.
• bcid — business component ID. Can be repeated.
• search — search terms. Will search in host name, service name or output. Can be repeated to produce an AND effect.
• saved_maxeventid — if set with the value of the last max event id, an extra attribute will be in the result to signify the number of new events since the last max event id (based on the filtering parameters).
• eventtype — there are 4 types of events: 0 = state change event; 1 = acknowledgements event; 2 = downtime start event; 3 = downtime end event. If no eventtype is specified, only eventtype=0 is returned, otherwise specify multiple times to get different types added.
• include_max — if set to 0, will not include the max id data. This can be much quicker on the database to not run this query. Defaults to 1.
• include_page_summary — if set to 0, will not include the page number data. This can be much quicker on the database to not run this query. Defaults to 1.

Example response Copied

The time, downtime_start and downtime_end parameters are the number of seconds since epoch which by definition is in the UTC time zone.

Note

Some fields are conditional and will only be displayed if appropriate.