Get uptime metrics for an SLA data source

GET/v1/slas/{sla_urn}/data-sources/{data_source_urn}/uptime-metrics

Path ParametersExpand Collapse

sla_urn: string

data_source_urn: string

Query ParametersExpand Collapse

timeframe_end: optional string

Year and month landing within the last SLA evaluation period to include in the result, in the format YYYY-MM

timeframe_start: optional string

Year and month landing within the first SLA evaluation period to include in the result, in the format YYYY-MM

ReturnsExpand Collapse

data_source_urn: string

The unique identifier of the data source

downtime_events: array of object { duration_hours, end_time, name, start_time }

A list of downtime events that occurred during the timeframe

duration_hours: number

The duration of the downtime event in hours

end_time: string

The end time of the downtime event

formatdate-time

name: string

The display name of the downtime event

start_time: string

The start time of the downtime event

formatdate-time

downtime_hours: number

The total number of downtime hours during the timeframe

sla_urn: string

The unique identifier of the SLA

timeframe: object { end, start }

The timeframe for which the uptime metrics are calculated

end: string

The ISO-formatted end datetime of the timeframe for which the metrics are calculated

formatdate-time

start: string

The ISO-formatted start datetime of the timeframe for which the metrics are calculated

formatdate-time

uptime_percentage: number

The percentage of uptime during the timeframe

vendor_urn: string

The unique identifier of the vendor

Get uptime metrics for an SLA data source

curl https://developer.clarative.ai/v1/slas/$SLA_URN/data-sources/$DATA_SOURCE_URN/uptime-metrics \
    -H "Authorization: Bearer $CLARATIVE_API_KEY"

[
  {
    "data_source_urn": "data_source_urn",
    "downtime_events": [
      {
        "duration_hours": 0,
        "end_time": "2019-12-27T18:11:19.117Z",
        "name": "name",
        "start_time": "2019-12-27T18:11:19.117Z"
      }
    ],
    "downtime_hours": 0,
    "sla_urn": "sla_urn",
    "timeframe": {
      "end": "2019-12-27T18:11:19.117Z",
      "start": "2019-12-27T18:11:19.117Z"
    },
    "uptime_percentage": 0,
    "vendor_urn": "vendor_urn"
  }
]

Returns Examples

[
  {
    "data_source_urn": "data_source_urn",
    "downtime_events": [
      {
        "duration_hours": 0,
        "end_time": "2019-12-27T18:11:19.117Z",
        "name": "name",
        "start_time": "2019-12-27T18:11:19.117Z"
      }
    ],
    "downtime_hours": 0,
    "sla_urn": "sla_urn",
    "timeframe": {
      "end": "2019-12-27T18:11:19.117Z",
      "start": "2019-12-27T18:11:19.117Z"
    },
    "uptime_percentage": 0,
    "vendor_urn": "vendor_urn"
  }
]