Skip to main content

slo_statuses

Creates, updates, deletes, gets or lists a slo_statuses resource.

Overview

Nameslo_statuses
TypeResource
Iddatadog.service_management.slo_statuses

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
idstringThe ID of the SLO. (example: 00000000-0000-0000-0000-000000000000)
attributesobjectThe attributes of the SLO status.
typestringThe type of the SLO status resource. (slo_status) (example: slo_status)

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
get_slo_statusselectslo_id, from_ts, to_tsdisable_correctionsGet the status of a Service Level Objective (SLO) for a given time period.<br /><br />This endpoint returns the current SLI value, error budget remaining, and other status information for the specified SLO.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
from_tsinteger (int64)The starting timestamp for the SLO status query in epoch seconds.
sitestringThe Datadog site (region) for your organization, for example datadoghq.com, us3.datadoghq.com, us5.datadoghq.com, ap1.datadoghq.com, ap2.datadoghq.com, datadoghq.eu, ddog-gov.com. Resolved from the DD_SITE environment variable when set. Optional: defaults to datadoghq.com, or the value of the DD_SITE environment variable when set; a WHERE value overrides both.
slo_idstringThe ID of the SLO.
to_tsinteger (int64)The ending timestamp for the SLO status query in epoch seconds.
disable_correctionsbooleanWhether to exclude correction windows from the SLO status calculation. Defaults to false.

SELECT examples

Get the status of a Service Level Objective (SLO) for a given time period.<br /><br />This endpoint returns the current SLI value, error budget remaining, and other status information for the specified SLO.

SELECT
id,
attributes,
type
FROM datadog.service_management.slo_statuses
WHERE slo_id = '{{ slo_id }}' -- required
AND from_ts = '{{ from_ts }}' -- required
AND to_ts = '{{ to_ts }}' -- required
AND disable_corrections = '{{ disable_corrections }}'
;