Sign in

v1

latestOpenAPI 3.0.02026-07-142351,1971.3 MB
Service Level Objectives

Get an SLO's history

Get a specific SLO’s history, regardless of its SLO type.

The detailed history data is structured according to the source data type. For example, metric data is included for event SLOs that use the metric source, and monitor SLO types include the monitor transition history.

Note: There are different response formats for event based and time based SLOs. Examples of both are shown.

get/api/v1/slo/{slo_id}/history

Path parameters

slo_idstring required

The ID of the service level objective object.

Query parameters

from_tsinteger required

The from timestamp for the query window in epoch seconds.

to_tsinteger required

The to timestamp for the query window in epoch seconds.

targetnumber double

The SLO target. If target is passed in, the response will include the remaining error budget and a timeframe value of custom.

apply_correctionboolean

Defaults to true. If any SLO corrections are applied and this parameter is set to false, then the corrections will not be applied and the SLI values will not be affected.

Response

OK

Example response

{
  "data": {
    "from_ts": 1615323990,
    "groups": [
      {
        "error_budget_remaining": {
          "7d": 100
        },
        "group": "name",
        "history": [
          [
            1579212382,
            0
          ]
        ],
        "monitor_modified": 1615867200,
        "monitor_type": "string",
        "name": "string",
        "precision": 2,
        "preview": true,
        "sli_value": 99.99,
        "span_precision": 2,
        "uptime": 99.99
      }
    ],
    "monitors": [
      {
        "error_budget_remaining": {
          "7d": 100
        },
        "group": "name",
        "history": [
          [
            1579212382,
            0
          ]
        ],
        "monitor_modified": 1615867200,
        "monitor_type": "string",
        "name": "string",
        "precision": 2,
        "preview": true,
        "sli_value": 99.99,
        "span_precision": 2,
        "uptime": 99.99
      }
    ],
    "overall": {
      "error_budget_remaining": {
        "7d": 100
      },
      "group": "name",
      "history": [
        [
          1579212382,
          0
        ]
      ],
      "monitor_modified": 1615867200,
      "monitor_type": "string",
      "name": "string",
      "precision": {
        "30d": 1,
        "7d": 2
      },
      "preview": true,
      "sli_value": 99.99,
      "span_precision": 2,
      "uptime": 99.99
    },
    "series": {
      "denominator": {
        "metadata": {},
        "values": []
      },
      "numerator": {
        "metadata": {},
        "values": []
      },
      "times": []
    },
    "thresholds": {
      "my_service": {
        "target": 95,
        "timeframe": "7d"
      }
    },
    "to_ts": 1615928790,
    "type": "metric"
  }
}