Hey! These docs are for version 6.3, which is no longer officially supported. Click here for the latest version, 6.7!

Endpoint to list graphing data


  • end - expected as number of epoch seconds. Defaults to now.

  • start - epoch seconds. Defaults to end subtract 1 day duration. This has priority over duration.

  • duration - specify duration. Use h, d, w for hours, days, weeks respectively. m is assumed to be minutes - use months and minutes for clarity. (Note: This parameter used to be based on RRDtool format, but is now a custom format to Opsview). Default: 1d. Examples:

    • 3145h - 3145 hours
    • 131d1h - 131 days and 1 hour
    • 18w5d1h - 18 weeks, 5 days and 1 hour
  • hsm - in the format of hostname::servicename::metricname. Can be repeated. If the performance metric is not found, it is ignored from the response.

  • keyword - search for all hsms related to the specified keyword. Can be repeated. Be aware this could return a large amount of data if there are matches to lots of hsms

  • hostname - search for all hsms related with this host name. Can have wildcards. Can be repeated.

  • servicename - search for all hsms related with this service name. Can have wildcards. Can be repeated.

  • metricname - search for all hsms with this metric name. Can have wildcards. Can be repeated.

  • include_offset_timezone. Defaults to 0. Set this to 1 to adjust the time value so that the current timezone offset from UTC (based on the Opsview server) is included in the time value. This is not required in most cases.

Example response:

  list => [
      data => [
        [1242849600, 517],  // Time in Unix epoch seconds and value at this time
        [1242936000, 517],  // Note: The value could be null/empty string to mean "no value at this time" - this should be represented as a gap in any graphs
        [1254168000, 505],
      description => "Min: 505.000<br />Max: 517.000<br />Average: 511.305",
      label => "opsview::Opsview HTTP::size",
      uom => "bytes",

The time parameter is the number of seconds since epoch. This time is returned back in UTC format. See the include_offset_timezone parameter if you want this value adjusted based on the timezone. Note, it is not possible to return this value as a date time formatted string.