Type to search.

Update an SLO

Base URL
https://{kibana_url}
Auth

You must have the write privileges for the SLOs feature in the Observability section of the Kibana feature privileges.

Path parameters

spaceId string required

An identifier for the space. If /s/ and the identifier are omitted from the path, the default space is used.

Example: default
sloId string required

An identifier for the slo.

Example: 9c235211-6834-11ea-a78c-6feb38a34414

Header parameters

kbn-xsrf string required

Cross-site request forgery protection

Request body

budgetingMethod enum

The budgeting method to use when computing the rollup data.

Values: occurrences timeslices
description string

A description for the SLO.

groupBy union oneOf

optional group by field or fields to use to generate an SLO per distinct value

One of: string[] or string
indicator union oneOf
One of:

Defines properties for a custom query indicator type

params object required

An object containing the indicator parameters.

dataViewId string

The kibana data view id to use, primarily used to include data view runtime mappings. Make sure to save SLO again if you add/update run time fields to the data view and if those fields are being used in slo queries.

filter union oneOf

Defines properties for a filter

One of:

the KQL query to filter the documents with.

good union oneOf required

The KQL query used to define the good events.

Same options as filter in params
index string required

The index or index pattern to use

timestampField string required

The timestamp field used in the source indice.

total union oneOf required

The KQL query used to define all events.

Same options as filter in params
type string required

The type of indicator.

name string

A name for the SLO.

tags string[]

List of tags

Responses

Successful request

application/json
budgetingMethod enum required

The budgeting method to use when computing the rollup data.

Values: occurrences timeslices
createdAt string required

The creation date

description string required

The description of the SLO.

enabled boolean required

Indicate if the SLO is enabled

groupBy union oneOf required

optional group by field or fields to use to generate an SLO per distinct value

One of: string[] or string
id string required

The identifier of the SLO.

indicator union oneOf required
One of: (determined by type)
type: sli.kql.custom

Defines properties for a custom query indicator type

type string required

The type of indicator.

params object required

An object containing the indicator parameters.

dataViewId string

The kibana data view id to use, primarily used to include data view runtime mappings. Make sure to save SLO again if you add/update run time fields to the data view and if those fields are being used in slo queries.

filter union oneOf

Defines properties for a filter

Same options as filter in params
good union oneOf required

The KQL query used to define the good events.

Same options as filter in params
index string required

The index or index pattern to use

timestampField string required

The timestamp field used in the source indice.

total union oneOf required

The KQL query used to define all events.

Same options as filter in params
name string required

The name of the SLO.

objective object required

Defines properties for the SLO objective

target number · > 0 · < 100 required

the target objective between 0 and 1 excluded

timesliceTarget number · min: 0 · max: 100

the target objective for each slice when using a timeslices budgeting method

timesliceWindow string

the duration of each slice when using a timeslices budgeting method, as {duraton}{unit}

revision number required

The SLO revision

settings object required

Defines properties for SLO settings.

frequency string · default: 1m

The interval between checks for changes in the source data. The minimum value is 1m and the maximum is 59m. The default value is 1 minute.

preventInitialBackfill boolean · default: false

Start aggregating data from the time the SLO is created, instead of backfilling data from the beginning of the time window.

syncDelay string · default: 1m

The time delay in minutes between the current time and the latest source data time. Increasing the value will delay any alerting. The default value is 1 minute. The minimum value is 1m and the maximum is 359m. It should always be greater then source index refresh interval.

syncField string

The date field that is used to identify new documents in the source. It is strongly recommended to use a field that contains the ingest timestamp. If you use a different field, you might need to set the delay such that it accounts for data transmission delays. When unspecified, we use the indicator timestamp field.

tags string[] required

List of tags

timeWindow object required

Defines properties for the SLO time window

duration string required

the duration formatted as {duration}{unit}. Accepted values for rolling: 7d, 30d, 90d. Accepted values for calendar aligned: 1w (weekly) or 1M (monthly)

type enum required

Indicates weither the time window is a rolling or a calendar aligned time window.

Values: rolling calendarAligned
updatedAt string required

The last update date

version number required

The internal SLO version