Crear un objeto SLO
POST
https://api.datadoghq.com/api/v1/slohttps://api.us3.datadoghq.com/api/v1/slohttps://api.us5.datadoghq.com/api/v1/slohttps://api.datadoghq.eu/api/v1/slohttps://api.ap1.datadoghq.com/api/v1/slohttps://api.ap2.datadoghq.com/api/v1/slohttps://api.uk1.datadoghq.com/api/v1/slohttps://api.ddog-gov.com/api/v1/slohttps://api.us2.ddog-gov.com/api/v1/sloDescripción general
Crea un objeto objetivo de nivel de servicio (SLO).
OAuth apps require the slos_write authorization scope to access this endpoint.
Solicitud
Body Data (required)
Objeto de solicitud de objetivos de nivel de servicio.
Campo
Type
Descripción
descriptionstring
Un objeto de solicitud de objetivo de nivel de servicio incluye un indicador de nivel servicio, umbrales
para uno o varios periodos de tiempo y metadatos (nombre, descripción, etiquetas, etc.).
groups[string]
A list of (up to 100) monitor groups that narrow the scope of a monitor service level objective.
Included in service level objective responses if it is not empty. Optional in
create/update requests for monitor service level objectives, but may only be
used when then length of the monitor_ids field is one.
monitor_ids[integer]
A list of monitor IDs that defines the scope of a monitor service level
objective. Required if type is monitor.
name [required]string
The name of the service level objective object.
queryobject
A count-based (metric) SLO query. This field is superseded by sli_specification but is retained for backwards compatibility. Note that Datadog only allows the sum by aggregator
to be used because this will sum up all request counts instead of averaging them, or taking the max or
min of all of those requests.
denominator [required]string
A Datadog metric query for total (valid) events.
numerator [required]string
A Datadog metric query for good events.
sli_specification<oneOf>
A generic SLI specification. This is used for time-slice and count-based (metric) SLOs only.
Object 1object
A time-slice SLI specification.
time_slice [required]object
The time-slice condition, composed of 3 parts: 1. the metric timeseries query, 2. the comparator, and 3. the threshold. Optionally, a fourth part, the query interval, can be provided.
comparator [required]enum
The comparator used to compare the SLI value to the threshold.
Allowed enum values:
>, >=, <, <=query [required]object
The queries and formula used to calculate the SLI value.
formulas [required][object]
A list that contains exactly one formula, as only a single formula may be used in a time-slice SLO.
formula [required]string
The formula string, which is an expression involving named queries.
queries [required][<oneOf>]
A list of queries that are used to calculate the SLI value.
<data_source=metrics>object
A formula and functions metrics query.
aggregatorenum
The aggregation methods available for metrics queries.
Allowed enum values:
avg, min, max, sum, last, area, l2norm, percentilecross_org_uuids[string]
The source organization UUID for cross organization queries. Feature in Private Beta.
data_source [required]enum
Data source for metrics queries.
Allowed enum values:
metricsname [required]string
Name of the query for use in formulas.
query [required]string
Metrics query definition.
semantic_modeenum
Semantic mode for metrics queries. This determines how metrics from different sources are combined or displayed.
Allowed enum values:
combined, nativequery_interval_secondsenum
The interval used when querying data, which defines the size of a time slice. Two values are allowed: 60 (1 minute) and 300 (5 minutes). If not provided, the value defaults to 300 (5 minutes).
Allowed enum values:
60, 300threshold [required]double
The threshold value to which each SLI value will be compared.
Object 2object
A metric SLI specification.
count [required]<oneOf>
A count-based (metric) SLI specification, composed of three parts: the good events formula,
the bad or total events formula, and the underlying queries.
Exactly one of total_events_formula or bad_events_formula must be provided.
Object 1object
SLO count definition using a total events formula alongside a good events formula.
good_events_formula [required]object
A formula that specifies how to combine the results of multiple queries.
formula [required]string
The formula string, which is an expression involving named queries.
queries [required][<oneOf>]
<data_source=metrics>object
A formula and functions metrics query.
aggregatorenum
The aggregation methods available for metrics queries.
Allowed enum values:
avg, min, max, sum, last, area, l2norm, percentilecross_org_uuids[string]
The source organization UUID for cross organization queries. Feature in Private Beta.
data_source [required]enum
Data source for metrics queries.
Allowed enum values:
metricsname [required]string
Name of the query for use in formulas.
query [required]string
Metrics query definition.
semantic_modeenum
Semantic mode for metrics queries. This determines how metrics from different sources are combined or displayed.
Allowed enum values:
combined, nativetotal_events_formula [required]object
The total events formula. Bad events queries can be defined using the bad_events_formula field as an alternative. Only one of total_events_formula or bad_events_formula must be provided.
formula [required]string
The formula string, which is an expression involving named queries.
Object 2object
SLO count definition using a bad events formula alongside a good events formula.
bad_events_formula [required]object
The bad events formula (recommended). Total events queries can be defined using the total_events_formula field as an alternative. Only one of total_events_formula or bad_events_formula must be provided.
formula [required]string
The formula string, which is an expression involving named queries.
good_events_formula [required]object
A formula that specifies how to combine the results of multiple queries.
formula [required]string
The formula string, which is an expression involving named queries.
queries [required][<oneOf>]
<data_source=metrics>object
A formula and functions metrics query.
aggregatorenum
The aggregation methods available for metrics queries.
Allowed enum values:
avg, min, max, sum, last, area, l2norm, percentilecross_org_uuids[string]
The source organization UUID for cross organization queries. Feature in Private Beta.
data_source [required]enum
Data source for metrics queries.
Allowed enum values:
metricsname [required]string
Name of the query for use in formulas.
query [required]string
Metrics query definition.
semantic_modeenum
Semantic mode for metrics queries. This determines how metrics from different sources are combined or displayed.
Allowed enum values:
combined, nativetags[string]
A list of tags associated with this service level objective. Always included in service level objective responses (but may be empty). Optional in create/update requests.
target_thresholddouble
The target threshold such that when the service level indicator is above this threshold over the given timeframe, the objective is being met.
thresholds [required][object]
The thresholds (timeframes and associated targets) for this service level objective object.
target [required]double
The target value for the service level indicator within the corresponding timeframe.
target_displaystring
A string representation of the target that indicates its precision.
It uses trailing zeros to show significant decimal places (for example 98.00).
Always included in service level objective responses. Ignored in create/update requests.
timeframe [required]enum
The SLO time window options. Note that "custom" is not a valid option for creating or updating SLOs. It is only used when querying SLO history over custom timeframes.
Allowed enum values:
7d, 30d, 90d, customwarningdouble
The warning value for the service level objective.
warning_displaystring
A string representation of the warning target (see the description of
the target_display field for details).
Included in service level objective responses if a warning target exists. Ignored in create/update requests.
timeframeenum
The SLO time window options. Note that "custom" is not a valid option for creating or updating SLOs. It is only used when querying SLO history over custom timeframes.
Allowed enum values:
7d, 30d, 90d, customtype [required]enum
The type of the service level objective.
Allowed enum values:
metric, monitor, time_slicewarning_thresholddouble
The optional warning threshold such that when the service level indicator is below this value for the given threshold, but above the target threshold, the objective appears in a "warning" state. This value must be greater than the target threshold.
Create a new metric SLO object using bad events formula returns "OK" response
{
"type": "metric",
"description": "Metric SLO using sli_specification",
"name": "Example-Service-Level-Objective",
"sli_specification": {
"count": {
"good_events_formula": {
"formula": "query1 - query2"
},
"bad_events_formula": {
"formula": "query2"
},
"queries": [
{
"data_source": "metrics",
"name": "query1",
"query": "sum:httpservice.hits{*}.as_count()"
},
{
"data_source": "metrics",
"name": "query2",
"query": "sum:httpservice.errors{*}.as_count()"
}
]
}
},
"tags": [
"env:prod",
"type:count"
],
"thresholds": [
{
"target": 99.0,
"target_display": "99.0",
"timeframe": "7d",
"warning": 99.5,
"warning_display": "99.5"
}
],
"timeframe": "7d",
"target_threshold": 99.0,
"warning_threshold": 99.5
}Create a new metric SLO object using sli_specification returns "OK" response
{
"type": "metric",
"description": "Metric SLO using sli_specification",
"name": "Example-Service-Level-Objective",
"sli_specification": {
"count": {
"good_events_formula": {
"formula": "query1 - query2"
},
"total_events_formula": {
"formula": "query1"
},
"queries": [
{
"data_source": "metrics",
"name": "query1",
"query": "sum:httpservice.hits{*}.as_count()"
},
{
"data_source": "metrics",
"name": "query2",
"query": "sum:httpservice.errors{*}.as_count()"
}
]
}
},
"tags": [
"env:prod",
"type:count"
],
"thresholds": [
{
"target": 99.0,
"target_display": "99.0",
"timeframe": "7d",
"warning": 99.5,
"warning_display": "99.5"
}
],
"timeframe": "7d",
"target_threshold": 99.0,
"warning_threshold": 99.5
}Create a time-slice SLO object returns "OK" response
{
"type": "time_slice",
"description": "string",
"name": "Example-Service-Level-Objective",
"sli_specification": {
"time_slice": {
"query": {
"formulas": [
{
"formula": "query1"
}
],
"queries": [
{
"data_source": "metrics",
"name": "query1",
"query": "trace.servlet.request{env:prod}"
}
]
},
"comparator": ">",
"threshold": 5
}
},
"tags": [
"env:prod"
],
"thresholds": [
{
"target": 97.0,
"target_display": "97.0",
"timeframe": "7d",
"warning": 98,
"warning_display": "98.0"
}
],
"timeframe": "7d",
"target_threshold": 97.0,
"warning_threshold": 98
}Respuesta
OK
A response with one or more service level objective.
Campo
Type
Descripción
data[object]
An array of service level objective objects.
created_atint64
Creation timestamp (UNIX time in seconds)
Always included in service level objective responses.
creatorobject
Object describing the creator of the shared element.
emailstring
Email of the creator.
handlestring
Handle of the creator.
namestring
Name of the creator.
descriptionstring
A user-defined description of the service level objective.
Always included in service level objective responses (but may be null).
Optional in create/update requests.
groups[string]
A list of (up to 100) monitor groups that narrow the scope of a monitor service level objective.
Included in service level objective responses if it is not empty. Optional in
create/update requests for monitor service level objectives, but may only be
used when then length of the monitor_ids field is one.
idstring
A unique identifier for the service level objective object.
Always included in service level objective responses.
modified_atint64
Modification timestamp (UNIX time in seconds)
Always included in service level objective responses.
monitor_ids[integer]
A list of monitor ids that defines the scope of a monitor service level
objective. Required if type is monitor.
monitor_tags[string]
The union of monitor tags for all monitors referenced by the monitor_ids
field.
Always included in service level objective responses for monitor-based service level
objectives (but may be empty). Ignored in create/update requests. Does not
affect which monitors are included in the service level objective (that is
determined entirely by the monitor_ids field).
name [required]string
The name of the service level objective object.
queryobject
A count-based (metric) SLO query. This field is superseded by sli_specification but is retained for backwards compatibility. Note that Datadog only allows the sum by aggregator
to be used because this will sum up all request counts instead of averaging them, or taking the max or
min of all of those requests.
denominator [required]string
A Datadog metric query for total (valid) events.
numerator [required]string
A Datadog metric query for good events.
sli_specification<oneOf>
A generic SLI specification. This is used for time-slice and count-based (metric) SLOs only.
Object 1object
A time-slice SLI specification.
time_slice [required]object
The time-slice condition, composed of 3 parts: 1. the metric timeseries query, 2. the comparator, and 3. the threshold. Optionally, a fourth part, the query interval, can be provided.
comparator [required]enum
The comparator used to compare the SLI value to the threshold.
Allowed enum values:
>, >=, <, <=query [required]object
The queries and formula used to calculate the SLI value.
formulas [required][object]
A list that contains exactly one formula, as only a single formula may be used in a time-slice SLO.
formula [required]string
The formula string, which is an expression involving named queries.
queries [required][<oneOf>]
A list of queries that are used to calculate the SLI value.
<data_source=metrics>object
A formula and functions metrics query.
aggregatorenum
The aggregation methods available for metrics queries.
Allowed enum values:
avg, min, max, sum, last, area, l2norm, percentilecross_org_uuids[string]
The source organization UUID for cross organization queries. Feature in Private Beta.
data_source [required]enum
Data source for metrics queries.
Allowed enum values:
metricsname [required]string
Name of the query for use in formulas.
query [required]string
Metrics query definition.
semantic_modeenum
Semantic mode for metrics queries. This determines how metrics from different sources are combined or displayed.
Allowed enum values:
combined, nativequery_interval_secondsenum
The interval used when querying data, which defines the size of a time slice. Two values are allowed: 60 (1 minute) and 300 (5 minutes). If not provided, the value defaults to 300 (5 minutes).
Allowed enum values:
60, 300threshold [required]double
The threshold value to which each SLI value will be compared.
Object 2object
A metric SLI specification.
count [required]<oneOf>
A count-based (metric) SLI specification, composed of three parts: the good events formula,
the bad or total events formula, and the underlying queries.
Exactly one of total_events_formula or bad_events_formula must be provided.
Object 1object
SLO count definition using a total events formula alongside a good events formula.
good_events_formula [required]object
A formula that specifies how to combine the results of multiple queries.
formula [required]string
The formula string, which is an expression involving named queries.
queries [required][<oneOf>]
<data_source=metrics>object
A formula and functions metrics query.
aggregatorenum
The aggregation methods available for metrics queries.
Allowed enum values:
avg, min, max, sum, last, area, l2norm, percentilecross_org_uuids[string]
The source organization UUID for cross organization queries. Feature in Private Beta.
data_source [required]enum
Data source for metrics queries.
Allowed enum values:
metricsname [required]string
Name of the query for use in formulas.
query [required]string
Metrics query definition.
semantic_modeenum
Semantic mode for metrics queries. This determines how metrics from different sources are combined or displayed.
Allowed enum values:
combined, nativetotal_events_formula [required]object
The total events formula. Bad events queries can be defined using the bad_events_formula field as an alternative. Only one of total_events_formula or bad_events_formula must be provided.
formula [required]string
The formula string, which is an expression involving named queries.
Object 2object
SLO count definition using a bad events formula alongside a good events formula.
bad_events_formula [required]object
The bad events formula (recommended). Total events queries can be defined using the total_events_formula field as an alternative. Only one of total_events_formula or bad_events_formula must be provided.
formula [required]string
The formula string, which is an expression involving named queries.
good_events_formula [required]object
A formula that specifies how to combine the results of multiple queries.
formula [required]string
The formula string, which is an expression involving named queries.
queries [required][<oneOf>]
<data_source=metrics>object
A formula and functions metrics query.
aggregatorenum
The aggregation methods available for metrics queries.
Allowed enum values:
avg, min, max, sum, last, area, l2norm, percentilecross_org_uuids[string]
The source organization UUID for cross organization queries. Feature in Private Beta.
data_source [required]enum
Data source for metrics queries.
Allowed enum values:
metricsname [required]string
Name of the query for use in formulas.
query [required]string
Metrics query definition.
semantic_modeenum
Semantic mode for metrics queries. This determines how metrics from different sources are combined or displayed.
Allowed enum values:
combined, nativetags[string]
A list of tags associated with this service level objective. Always included in service level objective responses (but may be empty). Optional in create/update requests.
target_thresholddouble
The target threshold such that when the service level indicator is above this threshold over the given timeframe, the objective is being met.
thresholds [required][object]
The thresholds (timeframes and associated targets) for this service level objective object.
target [required]double
The target value for the service level indicator within the corresponding timeframe.
target_displaystring
A string representation of the target that indicates its precision.
It uses trailing zeros to show significant decimal places (for example 98.00).
Always included in service level objective responses. Ignored in create/update requests.
timeframe [required]enum
The SLO time window options. Note that "custom" is not a valid option for creating or updating SLOs. It is only used when querying SLO history over custom timeframes.
Allowed enum values:
7d, 30d, 90d, customwarningdouble
The warning value for the service level objective.
warning_displaystring
A string representation of the warning target (see the description of
the target_display field for details).
Included in service level objective responses if a warning target exists. Ignored in create/update requests.
timeframeenum
The SLO time window options. Note that "custom" is not a valid option for creating or updating SLOs. It is only used when querying SLO history over custom timeframes.
Allowed enum values:
7d, 30d, 90d, customtype [required]enum
The type of the service level objective.
Allowed enum values:
metric, monitor, time_slicewarning_thresholddouble
The optional warning threshold such that when the service level indicator is below this value for the given threshold, but above the target threshold, the objective appears in a "warning" state. This value must be greater than the target threshold.
errors[string]
An array of error messages. Each endpoint documents how/whether this field is used.
metadataobject
The metadata object containing additional information about the list of SLOs.
pageobject
The object containing information about the pages of the list of SLOs.
total_countint64
The total number of resources that could be retrieved ignoring the parameters and filters in the request.
total_filtered_countint64
The total number of resources that match the parameters and filters in the request. This attribute can be used by a client to determine the total number of pages.
{
"data": [
{
"created_at": "integer",
"creator": {
"email": "string",
"handle": "string",
"name": "string"
},
"description": "string",
"groups": [
"env:prod",
"role:mysql"
],
"id": "string",
"modified_at": "integer",
"monitor_ids": [],
"monitor_tags": [],
"name": "Custom Metric SLO",
"query": {
"denominator": "sum:my.custom.metric{*}.as_count()",
"numerator": "sum:my.custom.metric{type:good}.as_count()"
},
"sli_specification": {
"time_slice": {
"comparator": ">",
"query": {
"formulas": [
{
"formula": "query1 - default_zero(query2)"
}
],
"queries": [
[]
]
},
"query_interval_seconds": 300,
"threshold": 5
}
},
"tags": [
"env:prod",
"app:core"
],
"target_threshold": 99.9,
"thresholds": [
{
"target": 99.9,
"target_display": "99.9",
"timeframe": "30d",
"warning": 90,
"warning_display": "90.0"
}
],
"timeframe": "30d",
"type": "metric",
"warning_threshold": 99.95
}
],
"errors": [],
"metadata": {
"page": {
"total_count": "integer",
"total_filtered_count": "integer"
}
}
}Bad Request
Error response object.
Campo
Type
Descripción
errors [required][string]
Array of errors returned by the API.
{
"errors": [
"Bad Request"
]
}Forbidden
Error response object.
Campo
Type
Descripción
errors [required][string]
Array of errors returned by the API.
{
"errors": [
"Bad Request"
]
}Too many requests
Error response object.
Campo
Type
Descripción
errors [required][string]
Array of errors returned by the API.
{
"errors": [
"Bad Request"
]
}Ejemplo de código
Create a new metric SLO object using bad events formula returns "OK" response
# Set your Datadog site and credentials
export DD_SITE="datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"
curl -X POST "https://api.${DD_SITE}/api/v1/slo" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
"type": "metric",
"description": "Metric SLO using sli_specification",
"name": "Example-Service-Level-Objective",
"sli_specification": {
"count": {
"good_events_formula": {
"formula": "query1 - query2"
},
"bad_events_formula": {
"formula": "query2"
},
"queries": [
{
"data_source": "metrics",
"name": "query1",
"query": "sum:httpservice.hits{*}.as_count()"
},
{
"data_source": "metrics",
"name": "query2",
"query": "sum:httpservice.errors{*}.as_count()"
}
]
}
},
"tags": [
"env:prod",
"type:count"
],
"thresholds": [
{
"target": 99.0,
"target_display": "99.0",
"timeframe": "7d",
"warning": 99.5,
"warning_display": "99.5"
}
],
"timeframe": "7d",
"target_threshold": 99.0,
"warning_threshold": 99.5
}
EOF# Set your Datadog site and credentials
export DD_SITE="us3.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"
curl -X POST "https://api.${DD_SITE}/api/v1/slo" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
"type": "metric",
"description": "Metric SLO using sli_specification",
"name": "Example-Service-Level-Objective",
"sli_specification": {
"count": {
"good_events_formula": {
"formula": "query1 - query2"
},
"bad_events_formula": {
"formula": "query2"
},
"queries": [
{
"data_source": "metrics",
"name": "query1",
"query": "sum:httpservice.hits{*}.as_count()"
},
{
"data_source": "metrics",
"name": "query2",
"query": "sum:httpservice.errors{*}.as_count()"
}
]
}
},
"tags": [
"env:prod",
"type:count"
],
"thresholds": [
{
"target": 99.0,
"target_display": "99.0",
"timeframe": "7d",
"warning": 99.5,
"warning_display": "99.5"
}
],
"timeframe": "7d",
"target_threshold": 99.0,
"warning_threshold": 99.5
}
EOF# Set your Datadog site and credentials
export DD_SITE="us5.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"
curl -X POST "https://api.${DD_SITE}/api/v1/slo" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
"type": "metric",
"description": "Metric SLO using sli_specification",
"name": "Example-Service-Level-Objective",
"sli_specification": {
"count": {
"good_events_formula": {
"formula": "query1 - query2"
},
"bad_events_formula": {
"formula": "query2"
},
"queries": [
{
"data_source": "metrics",
"name": "query1",
"query": "sum:httpservice.hits{*}.as_count()"
},
{
"data_source": "metrics",
"name": "query2",
"query": "sum:httpservice.errors{*}.as_count()"
}
]
}
},
"tags": [
"env:prod",
"type:count"
],
"thresholds": [
{
"target": 99.0,
"target_display": "99.0",
"timeframe": "7d",
"warning": 99.5,
"warning_display": "99.5"
}
],
"timeframe": "7d",
"target_threshold": 99.0,
"warning_threshold": 99.5
}
EOF# Set your Datadog site and credentials
export DD_SITE="datadoghq.eu"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"
curl -X POST "https://api.${DD_SITE}/api/v1/slo" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
"type": "metric",
"description": "Metric SLO using sli_specification",
"name": "Example-Service-Level-Objective",
"sli_specification": {
"count": {
"good_events_formula": {
"formula": "query1 - query2"
},
"bad_events_formula": {
"formula": "query2"
},
"queries": [
{
"data_source": "metrics",
"name": "query1",
"query": "sum:httpservice.hits{*}.as_count()"
},
{
"data_source": "metrics",
"name": "query2",
"query": "sum:httpservice.errors{*}.as_count()"
}
]
}
},
"tags": [
"env:prod",
"type:count"
],
"thresholds": [
{
"target": 99.0,
"target_display": "99.0",
"timeframe": "7d",
"warning": 99.5,
"warning_display": "99.5"
}
],
"timeframe": "7d",
"target_threshold": 99.0,
"warning_threshold": 99.5
}
EOF# Set your Datadog site and credentials
export DD_SITE="ap1.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"
curl -X POST "https://api.${DD_SITE}/api/v1/slo" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
"type": "metric",
"description": "Metric SLO using sli_specification",
"name": "Example-Service-Level-Objective",
"sli_specification": {
"count": {
"good_events_formula": {
"formula": "query1 - query2"
},
"bad_events_formula": {
"formula": "query2"
},
"queries": [
{
"data_source": "metrics",
"name": "query1",
"query": "sum:httpservice.hits{*}.as_count()"
},
{
"data_source": "metrics",
"name": "query2",
"query": "sum:httpservice.errors{*}.as_count()"
}
]
}
},
"tags": [
"env:prod",
"type:count"
],
"thresholds": [
{
"target": 99.0,
"target_display": "99.0",
"timeframe": "7d",
"warning": 99.5,
"warning_display": "99.5"
}
],
"timeframe": "7d",
"target_threshold": 99.0,
"warning_threshold": 99.5
}
EOF# Set your Datadog site and credentials
export DD_SITE="ap2.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"
curl -X POST "https://api.${DD_SITE}/api/v1/slo" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
"type": "metric",
"description": "Metric SLO using sli_specification",
"name": "Example-Service-Level-Objective",
"sli_specification": {
"count": {
"good_events_formula": {
"formula": "query1 - query2"
},
"bad_events_formula": {
"formula": "query2"
},
"queries": [
{
"data_source": "metrics",
"name": "query1",
"query": "sum:httpservice.hits{*}.as_count()"
},
{
"data_source": "metrics",
"name": "query2",
"query": "sum:httpservice.errors{*}.as_count()"
}
]
}
},
"tags": [
"env:prod",
"type:count"
],
"thresholds": [
{
"target": 99.0,
"target_display": "99.0",
"timeframe": "7d",
"warning": 99.5,
"warning_display": "99.5"
}
],
"timeframe": "7d",
"target_threshold": 99.0,
"warning_threshold": 99.5
}
EOF# Set your Datadog site and credentials
export DD_SITE="uk1.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"
curl -X POST "https://api.${DD_SITE}/api/v1/slo" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
"type": "metric",
"description": "Metric SLO using sli_specification",
"name": "Example-Service-Level-Objective",
"sli_specification": {
"count": {
"good_events_formula": {
"formula": "query1 - query2"
},
"bad_events_formula": {
"formula": "query2"
},
"queries": [
{
"data_source": "metrics",
"name": "query1",
"query": "sum:httpservice.hits{*}.as_count()"
},
{
"data_source": "metrics",
"name": "query2",
"query": "sum:httpservice.errors{*}.as_count()"
}
]
}
},
"tags": [
"env:prod",
"type:count"
],
"thresholds": [
{
"target": 99.0,
"target_display": "99.0",
"timeframe": "7d",
"warning": 99.5,
"warning_display": "99.5"
}
],
"timeframe": "7d",
"target_threshold": 99.0,
"warning_threshold": 99.5
}
EOF# Set your Datadog site and credentials
export DD_SITE="ddog-gov.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"
curl -X POST "https://api.${DD_SITE}/api/v1/slo" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
"type": "metric",
"description": "Metric SLO using sli_specification",
"name": "Example-Service-Level-Objective",
"sli_specification": {
"count": {
"good_events_formula": {
"formula": "query1 - query2"
},
"bad_events_formula": {
"formula": "query2"
},
"queries": [
{
"data_source": "metrics",
"name": "query1",
"query": "sum:httpservice.hits{*}.as_count()"
},
{
"data_source": "metrics",
"name": "query2",
"query": "sum:httpservice.errors{*}.as_count()"
}
]
}
},
"tags": [
"env:prod",
"type:count"
],
"thresholds": [
{
"target": 99.0,
"target_display": "99.0",
"timeframe": "7d",
"warning": 99.5,
"warning_display": "99.5"
}
],
"timeframe": "7d",
"target_threshold": 99.0,
"warning_threshold": 99.5
}
EOF# Set your Datadog site and credentials
export DD_SITE="us2.ddog-gov.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"
curl -X POST "https://api.${DD_SITE}/api/v1/slo" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
"type": "metric",
"description": "Metric SLO using sli_specification",
"name": "Example-Service-Level-Objective",
"sli_specification": {
"count": {
"good_events_formula": {
"formula": "query1 - query2"
},
"bad_events_formula": {
"formula": "query2"
},
"queries": [
{
"data_source": "metrics",
"name": "query1",
"query": "sum:httpservice.hits{*}.as_count()"
},
{
"data_source": "metrics",
"name": "query2",
"query": "sum:httpservice.errors{*}.as_count()"
}
]
}
},
"tags": [
"env:prod",
"type:count"
],
"thresholds": [
{
"target": 99.0,
"target_display": "99.0",
"timeframe": "7d",
"warning": 99.5,
"warning_display": "99.5"
}
],
"timeframe": "7d",
"target_threshold": 99.0,
"warning_threshold": 99.5
}
EOFCreate a new metric SLO object using sli_specification returns "OK" response
# Set your Datadog site and credentials
export DD_SITE="datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"
curl -X POST "https://api.${DD_SITE}/api/v1/slo" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
"type": "metric",
"description": "Metric SLO using sli_specification",
"name": "Example-Service-Level-Objective",
"sli_specification": {
"count": {
"good_events_formula": {
"formula": "query1 - query2"
},
"total_events_formula": {
"formula": "query1"
},
"queries": [
{
"data_source": "metrics",
"name": "query1",
"query": "sum:httpservice.hits{*}.as_count()"
},
{
"data_source": "metrics",
"name": "query2",
"query": "sum:httpservice.errors{*}.as_count()"
}
]
}
},
"tags": [
"env:prod",
"type:count"
],
"thresholds": [
{
"target": 99.0,
"target_display": "99.0",
"timeframe": "7d",
"warning": 99.5,
"warning_display": "99.5"
}
],
"timeframe": "7d",
"target_threshold": 99.0,
"warning_threshold": 99.5
}
EOF# Set your Datadog site and credentials
export DD_SITE="us3.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"
curl -X POST "https://api.${DD_SITE}/api/v1/slo" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
"type": "metric",
"description": "Metric SLO using sli_specification",
"name": "Example-Service-Level-Objective",
"sli_specification": {
"count": {
"good_events_formula": {
"formula": "query1 - query2"
},
"total_events_formula": {
"formula": "query1"
},
"queries": [
{
"data_source": "metrics",
"name": "query1",
"query": "sum:httpservice.hits{*}.as_count()"
},
{
"data_source": "metrics",
"name": "query2",
"query": "sum:httpservice.errors{*}.as_count()"
}
]
}
},
"tags": [
"env:prod",
"type:count"
],
"thresholds": [
{
"target": 99.0,
"target_display": "99.0",
"timeframe": "7d",
"warning": 99.5,
"warning_display": "99.5"
}
],
"timeframe": "7d",
"target_threshold": 99.0,
"warning_threshold": 99.5
}
EOF# Set your Datadog site and credentials
export DD_SITE="us5.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"
curl -X POST "https://api.${DD_SITE}/api/v1/slo" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
"type": "metric",
"description": "Metric SLO using sli_specification",
"name": "Example-Service-Level-Objective",
"sli_specification": {
"count": {
"good_events_formula": {
"formula": "query1 - query2"
},
"total_events_formula": {
"formula": "query1"
},
"queries": [
{
"data_source": "metrics",
"name": "query1",
"query": "sum:httpservice.hits{*}.as_count()"
},
{
"data_source": "metrics",
"name": "query2",
"query": "sum:httpservice.errors{*}.as_count()"
}
]
}
},
"tags": [
"env:prod",
"type:count"
],
"thresholds": [
{
"target": 99.0,
"target_display": "99.0",
"timeframe": "7d",
"warning": 99.5,
"warning_display": "99.5"
}
],
"timeframe": "7d",
"target_threshold": 99.0,
"warning_threshold": 99.5
}
EOF# Set your Datadog site and credentials
export DD_SITE="datadoghq.eu"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"
curl -X POST "https://api.${DD_SITE}/api/v1/slo" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
"type": "metric",
"description": "Metric SLO using sli_specification",
"name": "Example-Service-Level-Objective",
"sli_specification": {
"count": {
"good_events_formula": {
"formula": "query1 - query2"
},
"total_events_formula": {
"formula": "query1"
},
"queries": [
{
"data_source": "metrics",
"name": "query1",
"query": "sum:httpservice.hits{*}.as_count()"
},
{
"data_source": "metrics",
"name": "query2",
"query": "sum:httpservice.errors{*}.as_count()"
}
]
}
},
"tags": [
"env:prod",
"type:count"
],
"thresholds": [
{
"target": 99.0,
"target_display": "99.0",
"timeframe": "7d",
"warning": 99.5,
"warning_display": "99.5"
}
],
"timeframe": "7d",
"target_threshold": 99.0,
"warning_threshold": 99.5
}
EOF# Set your Datadog site and credentials
export DD_SITE="ap1.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"
curl -X POST "https://api.${DD_SITE}/api/v1/slo" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
"type": "metric",
"description": "Metric SLO using sli_specification",
"name": "Example-Service-Level-Objective",
"sli_specification": {
"count": {
"good_events_formula": {
"formula": "query1 - query2"
},
"total_events_formula": {
"formula": "query1"
},
"queries": [
{
"data_source": "metrics",
"name": "query1",
"query": "sum:httpservice.hits{*}.as_count()"
},
{
"data_source": "metrics",
"name": "query2",
"query": "sum:httpservice.errors{*}.as_count()"
}
]
}
},
"tags": [
"env:prod",
"type:count"
],
"thresholds": [
{
"target": 99.0,
"target_display": "99.0",
"timeframe": "7d",
"warning": 99.5,
"warning_display": "99.5"
}
],
"timeframe": "7d",
"target_threshold": 99.0,
"warning_threshold": 99.5
}
EOF# Set your Datadog site and credentials
export DD_SITE="ap2.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"
curl -X POST "https://api.${DD_SITE}/api/v1/slo" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
"type": "metric",
"description": "Metric SLO using sli_specification",
"name": "Example-Service-Level-Objective",
"sli_specification": {
"count": {
"good_events_formula": {
"formula": "query1 - query2"
},
"total_events_formula": {
"formula": "query1"
},
"queries": [
{
"data_source": "metrics",
"name": "query1",
"query": "sum:httpservice.hits{*}.as_count()"
},
{
"data_source": "metrics",
"name": "query2",
"query": "sum:httpservice.errors{*}.as_count()"
}
]
}
},
"tags": [
"env:prod",
"type:count"
],
"thresholds": [
{
"target": 99.0,
"target_display": "99.0",
"timeframe": "7d",
"warning": 99.5,
"warning_display": "99.5"
}
],
"timeframe": "7d",
"target_threshold": 99.0,
"warning_threshold": 99.5
}
EOF# Set your Datadog site and credentials
export DD_SITE="uk1.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"
curl -X POST "https://api.${DD_SITE}/api/v1/slo" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
"type": "metric",
"description": "Metric SLO using sli_specification",
"name": "Example-Service-Level-Objective",
"sli_specification": {
"count": {
"good_events_formula": {
"formula": "query1 - query2"
},
"total_events_formula": {
"formula": "query1"
},
"queries": [
{
"data_source": "metrics",
"name": "query1",
"query": "sum:httpservice.hits{*}.as_count()"
},
{
"data_source": "metrics",
"name": "query2",
"query": "sum:httpservice.errors{*}.as_count()"
}
]
}
},
"tags": [
"env:prod",
"type:count"
],
"thresholds": [
{
"target": 99.0,
"target_display": "99.0",
"timeframe": "7d",
"warning": 99.5,
"warning_display": "99.5"
}
],
"timeframe": "7d",
"target_threshold": 99.0,
"warning_threshold": 99.5
}
EOF# Set your Datadog site and credentials
export DD_SITE="ddog-gov.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"
curl -X POST "https://api.${DD_SITE}/api/v1/slo" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
"type": "metric",
"description": "Metric SLO using sli_specification",
"name": "Example-Service-Level-Objective",
"sli_specification": {
"count": {
"good_events_formula": {
"formula": "query1 - query2"
},
"total_events_formula": {
"formula": "query1"
},
"queries": [
{
"data_source": "metrics",
"name": "query1",
"query": "sum:httpservice.hits{*}.as_count()"
},
{
"data_source": "metrics",
"name": "query2",
"query": "sum:httpservice.errors{*}.as_count()"
}
]
}
},
"tags": [
"env:prod",
"type:count"
],
"thresholds": [
{
"target": 99.0,
"target_display": "99.0",
"timeframe": "7d",
"warning": 99.5,
"warning_display": "99.5"
}
],
"timeframe": "7d",
"target_threshold": 99.0,
"warning_threshold": 99.5
}
EOF# Set your Datadog site and credentials
export DD_SITE="us2.ddog-gov.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"
curl -X POST "https://api.${DD_SITE}/api/v1/slo" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
"type": "metric",
"description": "Metric SLO using sli_specification",
"name": "Example-Service-Level-Objective",
"sli_specification": {
"count": {
"good_events_formula": {
"formula": "query1 - query2"
},
"total_events_formula": {
"formula": "query1"
},
"queries": [
{
"data_source": "metrics",
"name": "query1",
"query": "sum:httpservice.hits{*}.as_count()"
},
{
"data_source": "metrics",
"name": "query2",
"query": "sum:httpservice.errors{*}.as_count()"
}
]
}
},
"tags": [
"env:prod",
"type:count"
],
"thresholds": [
{
"target": 99.0,
"target_display": "99.0",
"timeframe": "7d",
"warning": 99.5,
"warning_display": "99.5"
}
],
"timeframe": "7d",
"target_threshold": 99.0,
"warning_threshold": 99.5
}
EOFCreate a time-slice SLO object returns "OK" response
# Set your Datadog site and credentials
export DD_SITE="datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"
curl -X POST "https://api.${DD_SITE}/api/v1/slo" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
"type": "time_slice",
"description": "string",
"name": "Example-Service-Level-Objective",
"sli_specification": {
"time_slice": {
"query": {
"formulas": [
{
"formula": "query1"
}
],
"queries": [
{
"data_source": "metrics",
"name": "query1",
"query": "trace.servlet.request{env:prod}"
}
]
},
"comparator": ">",
"threshold": 5
}
},
"tags": [
"env:prod"
],
"thresholds": [
{
"target": 97.0,
"target_display": "97.0",
"timeframe": "7d",
"warning": 98,
"warning_display": "98.0"
}
],
"timeframe": "7d",
"target_threshold": 97.0,
"warning_threshold": 98
}
EOF# Set your Datadog site and credentials
export DD_SITE="us3.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"
curl -X POST "https://api.${DD_SITE}/api/v1/slo" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
"type": "time_slice",
"description": "string",
"name": "Example-Service-Level-Objective",
"sli_specification": {
"time_slice": {
"query": {
"formulas": [
{
"formula": "query1"
}
],
"queries": [
{
"data_source": "metrics",
"name": "query1",
"query": "trace.servlet.request{env:prod}"
}
]
},
"comparator": ">",
"threshold": 5
}
},
"tags": [
"env:prod"
],
"thresholds": [
{
"target": 97.0,
"target_display": "97.0",
"timeframe": "7d",
"warning": 98,
"warning_display": "98.0"
}
],
"timeframe": "7d",
"target_threshold": 97.0,
"warning_threshold": 98
}
EOF# Set your Datadog site and credentials
export DD_SITE="us5.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"
curl -X POST "https://api.${DD_SITE}/api/v1/slo" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
"type": "time_slice",
"description": "string",
"name": "Example-Service-Level-Objective",
"sli_specification": {
"time_slice": {
"query": {
"formulas": [
{
"formula": "query1"
}
],
"queries": [
{
"data_source": "metrics",
"name": "query1",
"query": "trace.servlet.request{env:prod}"
}
]
},
"comparator": ">",
"threshold": 5
}
},
"tags": [
"env:prod"
],
"thresholds": [
{
"target": 97.0,
"target_display": "97.0",
"timeframe": "7d",
"warning": 98,
"warning_display": "98.0"
}
],
"timeframe": "7d",
"target_threshold": 97.0,
"warning_threshold": 98
}
EOF# Set your Datadog site and credentials
export DD_SITE="datadoghq.eu"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"
curl -X POST "https://api.${DD_SITE}/api/v1/slo" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
"type": "time_slice",
"description": "string",
"name": "Example-Service-Level-Objective",
"sli_specification": {
"time_slice": {
"query": {
"formulas": [
{
"formula": "query1"
}
],
"queries": [
{
"data_source": "metrics",
"name": "query1",
"query": "trace.servlet.request{env:prod}"
}
]
},
"comparator": ">",
"threshold": 5
}
},
"tags": [
"env:prod"
],
"thresholds": [
{
"target": 97.0,
"target_display": "97.0",
"timeframe": "7d",
"warning": 98,
"warning_display": "98.0"
}
],
"timeframe": "7d",
"target_threshold": 97.0,
"warning_threshold": 98
}
EOF# Set your Datadog site and credentials
export DD_SITE="ap1.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"
curl -X POST "https://api.${DD_SITE}/api/v1/slo" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
"type": "time_slice",
"description": "string",
"name": "Example-Service-Level-Objective",
"sli_specification": {
"time_slice": {
"query": {
"formulas": [
{
"formula": "query1"
}
],
"queries": [
{
"data_source": "metrics",
"name": "query1",
"query": "trace.servlet.request{env:prod}"
}
]
},
"comparator": ">",
"threshold": 5
}
},
"tags": [
"env:prod"
],
"thresholds": [
{
"target": 97.0,
"target_display": "97.0",
"timeframe": "7d",
"warning": 98,
"warning_display": "98.0"
}
],
"timeframe": "7d",
"target_threshold": 97.0,
"warning_threshold": 98
}
EOF# Set your Datadog site and credentials
export DD_SITE="ap2.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"
curl -X POST "https://api.${DD_SITE}/api/v1/slo" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
"type": "time_slice",
"description": "string",
"name": "Example-Service-Level-Objective",
"sli_specification": {
"time_slice": {
"query": {
"formulas": [
{
"formula": "query1"
}
],
"queries": [
{
"data_source": "metrics",
"name": "query1",
"query": "trace.servlet.request{env:prod}"
}
]
},
"comparator": ">",
"threshold": 5
}
},
"tags": [
"env:prod"
],
"thresholds": [
{
"target": 97.0,
"target_display": "97.0",
"timeframe": "7d",
"warning": 98,
"warning_display": "98.0"
}
],
"timeframe": "7d",
"target_threshold": 97.0,
"warning_threshold": 98
}
EOF# Set your Datadog site and credentials
export DD_SITE="uk1.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"
curl -X POST "https://api.${DD_SITE}/api/v1/slo" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
"type": "time_slice",
"description": "string",
"name": "Example-Service-Level-Objective",
"sli_specification": {
"time_slice": {
"query": {
"formulas": [
{
"formula": "query1"
}
],
"queries": [
{
"data_source": "metrics",
"name": "query1",
"query": "trace.servlet.request{env:prod}"
}
]
},
"comparator": ">",
"threshold": 5
}
},
"tags": [
"env:prod"
],
"thresholds": [
{
"target": 97.0,
"target_display": "97.0",
"timeframe": "7d",
"warning": 98,
"warning_display": "98.0"
}
],
"timeframe": "7d",
"target_threshold": 97.0,
"warning_threshold": 98
}
EOF# Set your Datadog site and credentials
export DD_SITE="ddog-gov.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"
curl -X POST "https://api.${DD_SITE}/api/v1/slo" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
"type": "time_slice",
"description": "string",
"name": "Example-Service-Level-Objective",
"sli_specification": {
"time_slice": {
"query": {
"formulas": [
{
"formula": "query1"
}
],
"queries": [
{
"data_source": "metrics",
"name": "query1",
"query": "trace.servlet.request{env:prod}"
}
]
},
"comparator": ">",
"threshold": 5
}
},
"tags": [
"env:prod"
],
"thresholds": [
{
"target": 97.0,
"target_display": "97.0",
"timeframe": "7d",
"warning": 98,
"warning_display": "98.0"
}
],
"timeframe": "7d",
"target_threshold": 97.0,
"warning_threshold": 98
}
EOF# Set your Datadog site and credentials
export DD_SITE="us2.ddog-gov.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"
curl -X POST "https://api.${DD_SITE}/api/v1/slo" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
"type": "time_slice",
"description": "string",
"name": "Example-Service-Level-Objective",
"sli_specification": {
"time_slice": {
"query": {
"formulas": [
{
"formula": "query1"
}
],
"queries": [
{
"data_source": "metrics",
"name": "query1",
"query": "trace.servlet.request{env:prod}"
}
]
},
"comparator": ">",
"threshold": 5
}
},
"tags": [
"env:prod"
],
"thresholds": [
{
"target": 97.0,
"target_display": "97.0",
"timeframe": "7d",
"warning": 98,
"warning_display": "98.0"
}
],
"timeframe": "7d",
"target_threshold": 97.0,
"warning_threshold": 98
}
EOFCreate a new metric SLO object using bad events formula returns "OK" response
// Create a new metric SLO object using bad events formula returns "OK" response
package main
import (
"context"
"encoding/json"
"fmt"
"os"
"github.com/DataDog/datadog-api-client-go/v2/api/datadog"
"github.com/DataDog/datadog-api-client-go/v2/api/datadogV1"
)
func main() {
body := datadogV1.ServiceLevelObjectiveRequest{
Type: datadogV1.SLOTYPE_METRIC,
Description: *datadog.NewNullableString(datadog.PtrString("Metric SLO using sli_specification")),
Name: "Example-Service-Level-Objective",
SliSpecification: &datadogV1.SLOSliSpec{
SLOCountSpec: &datadogV1.SLOCountSpec{
Count: datadogV1.SLOCountDefinition{
SLOCountDefinitionWithBadEventsFormula: &datadogV1.SLOCountDefinitionWithBadEventsFormula{
GoodEventsFormula: datadogV1.SLOFormula{
Formula: "query1 - query2",
},
BadEventsFormula: datadogV1.SLOFormula{
Formula: "query2",
},
Queries: []datadogV1.SLODataSourceQueryDefinition{
datadogV1.SLODataSourceQueryDefinition{
FormulaAndFunctionMetricQueryDefinition: &datadogV1.FormulaAndFunctionMetricQueryDefinition{
DataSource: datadogV1.FORMULAANDFUNCTIONMETRICDATASOURCE_METRICS,
Name: "query1",
Query: "sum:httpservice.hits{*}.as_count()",
}},
datadogV1.SLODataSourceQueryDefinition{
FormulaAndFunctionMetricQueryDefinition: &datadogV1.FormulaAndFunctionMetricQueryDefinition{
DataSource: datadogV1.FORMULAANDFUNCTIONMETRICDATASOURCE_METRICS,
Name: "query2",
Query: "sum:httpservice.errors{*}.as_count()",
}},
},
}},
}},
Tags: []string{
"env:prod",
"type:count",
},
Thresholds: []datadogV1.SLOThreshold{
{
Target: 99.0,
TargetDisplay: datadog.PtrString("99.0"),
Timeframe: datadogV1.SLOTIMEFRAME_SEVEN_DAYS,
Warning: datadog.PtrFloat64(99.5),
WarningDisplay: datadog.PtrString("99.5"),
},
},
Timeframe: datadogV1.SLOTIMEFRAME_SEVEN_DAYS.Ptr(),
TargetThreshold: datadog.PtrFloat64(99.0),
WarningThreshold: datadog.PtrFloat64(99.5),
}
ctx := datadog.NewDefaultContext(context.Background())
ctx = context.WithValue(ctx, datadog.ContextAccessToken, os.Getenv("DD_BEARER_TOKEN"))
configuration := datadog.NewConfiguration()
apiClient := datadog.NewAPIClient(configuration)
api := datadogV1.NewServiceLevelObjectivesApi(apiClient)
resp, r, err := api.CreateSLO(ctx, body)
if err != nil {
fmt.Fprintf(os.Stderr, "Error when calling `ServiceLevelObjectivesApi.CreateSLO`: %v\n", err)
fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
}
responseContent, _ := json.MarshalIndent(resp, "", " ")
fmt.Fprintf(os.Stdout, "Response from `ServiceLevelObjectivesApi.CreateSLO`:\n%s\n", responseContent)
}
Create a new metric SLO object using sli_specification returns "OK" response
// Create a new metric SLO object using sli_specification returns "OK" response
package main
import (
"context"
"encoding/json"
"fmt"
"os"
"github.com/DataDog/datadog-api-client-go/v2/api/datadog"
"github.com/DataDog/datadog-api-client-go/v2/api/datadogV1"
)
func main() {
body := datadogV1.ServiceLevelObjectiveRequest{
Type: datadogV1.SLOTYPE_METRIC,
Description: *datadog.NewNullableString(datadog.PtrString("Metric SLO using sli_specification")),
Name: "Example-Service-Level-Objective",
SliSpecification: &datadogV1.SLOSliSpec{
SLOCountSpec: &datadogV1.SLOCountSpec{
Count: datadogV1.SLOCountDefinition{
SLOCountDefinitionWithTotalEventsFormula: &datadogV1.SLOCountDefinitionWithTotalEventsFormula{
GoodEventsFormula: datadogV1.SLOFormula{
Formula: "query1 - query2",
},
TotalEventsFormula: datadogV1.SLOFormula{
Formula: "query1",
},
Queries: []datadogV1.SLODataSourceQueryDefinition{
datadogV1.SLODataSourceQueryDefinition{
FormulaAndFunctionMetricQueryDefinition: &datadogV1.FormulaAndFunctionMetricQueryDefinition{
DataSource: datadogV1.FORMULAANDFUNCTIONMETRICDATASOURCE_METRICS,
Name: "query1",
Query: "sum:httpservice.hits{*}.as_count()",
}},
datadogV1.SLODataSourceQueryDefinition{
FormulaAndFunctionMetricQueryDefinition: &datadogV1.FormulaAndFunctionMetricQueryDefinition{
DataSource: datadogV1.FORMULAANDFUNCTIONMETRICDATASOURCE_METRICS,
Name: "query2",
Query: "sum:httpservice.errors{*}.as_count()",
}},
},
}},
}},
Tags: []string{
"env:prod",
"type:count",
},
Thresholds: []datadogV1.SLOThreshold{
{
Target: 99.0,
TargetDisplay: datadog.PtrString("99.0"),
Timeframe: datadogV1.SLOTIMEFRAME_SEVEN_DAYS,
Warning: datadog.PtrFloat64(99.5),
WarningDisplay: datadog.PtrString("99.5"),
},
},
Timeframe: datadogV1.SLOTIMEFRAME_SEVEN_DAYS.Ptr(),
TargetThreshold: datadog.PtrFloat64(99.0),
WarningThreshold: datadog.PtrFloat64(99.5),
}
ctx := datadog.NewDefaultContext(context.Background())
ctx = context.WithValue(ctx, datadog.ContextAccessToken, os.Getenv("DD_BEARER_TOKEN"))
configuration := datadog.NewConfiguration()
apiClient := datadog.NewAPIClient(configuration)
api := datadogV1.NewServiceLevelObjectivesApi(apiClient)
resp, r, err := api.CreateSLO(ctx, body)
if err != nil {
fmt.Fprintf(os.Stderr, "Error when calling `ServiceLevelObjectivesApi.CreateSLO`: %v\n", err)
fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
}
responseContent, _ := json.MarshalIndent(resp, "", " ")
fmt.Fprintf(os.Stdout, "Response from `ServiceLevelObjectivesApi.CreateSLO`:\n%s\n", responseContent)
}
Create a time-slice SLO object returns "OK" response
// Create a time-slice SLO object returns "OK" response
package main
import (
"context"
"encoding/json"
"fmt"
"os"
"github.com/DataDog/datadog-api-client-go/v2/api/datadog"
"github.com/DataDog/datadog-api-client-go/v2/api/datadogV1"
)
func main() {
body := datadogV1.ServiceLevelObjectiveRequest{
Type: datadogV1.SLOTYPE_TIME_SLICE,
Description: *datadog.NewNullableString(datadog.PtrString("string")),
Name: "Example-Service-Level-Objective",
SliSpecification: &datadogV1.SLOSliSpec{
SLOTimeSliceSpec: &datadogV1.SLOTimeSliceSpec{
TimeSlice: datadogV1.SLOTimeSliceCondition{
Query: datadogV1.SLOTimeSliceQuery{
Formulas: []datadogV1.SLOFormula{
{
Formula: "query1",
},
},
Queries: []datadogV1.SLODataSourceQueryDefinition{
datadogV1.SLODataSourceQueryDefinition{
FormulaAndFunctionMetricQueryDefinition: &datadogV1.FormulaAndFunctionMetricQueryDefinition{
DataSource: datadogV1.FORMULAANDFUNCTIONMETRICDATASOURCE_METRICS,
Name: "query1",
Query: "trace.servlet.request{env:prod}",
}},
},
},
Comparator: datadogV1.SLOTIMESLICECOMPARATOR_GREATER,
Threshold: 5,
},
}},
Tags: []string{
"env:prod",
},
Thresholds: []datadogV1.SLOThreshold{
{
Target: 97.0,
TargetDisplay: datadog.PtrString("97.0"),
Timeframe: datadogV1.SLOTIMEFRAME_SEVEN_DAYS,
Warning: datadog.PtrFloat64(98),
WarningDisplay: datadog.PtrString("98.0"),
},
},
Timeframe: datadogV1.SLOTIMEFRAME_SEVEN_DAYS.Ptr(),
TargetThreshold: datadog.PtrFloat64(97.0),
WarningThreshold: datadog.PtrFloat64(98),
}
ctx := datadog.NewDefaultContext(context.Background())
ctx = context.WithValue(ctx, datadog.ContextAccessToken, os.Getenv("DD_BEARER_TOKEN"))
configuration := datadog.NewConfiguration()
apiClient := datadog.NewAPIClient(configuration)
api := datadogV1.NewServiceLevelObjectivesApi(apiClient)
resp, r, err := api.CreateSLO(ctx, body)
if err != nil {
fmt.Fprintf(os.Stderr, "Error when calling `ServiceLevelObjectivesApi.CreateSLO`: %v\n", err)
fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
}
responseContent, _ := json.MarshalIndent(resp, "", " ")
fmt.Fprintf(os.Stdout, "Response from `ServiceLevelObjectivesApi.CreateSLO`:\n%s\n", responseContent)
}
Instructions
First install the library and its dependencies and then save the example to main.go and run following commands:
DD_SITE="datadoghq.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" go run "main.go"DD_SITE="us3.datadoghq.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" go run "main.go"DD_SITE="us5.datadoghq.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" go run "main.go"DD_SITE="datadoghq.eu" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" go run "main.go"DD_SITE="ap1.datadoghq.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" go run "main.go"DD_SITE="ap2.datadoghq.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" go run "main.go"DD_SITE="uk1.datadoghq.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" go run "main.go"DD_SITE="ddog-gov.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" go run "main.go"DD_SITE="us2.ddog-gov.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" go run "main.go"Create a new metric SLO object using bad events formula returns "OK" response
// Create a new metric SLO object using bad events formula returns "OK" response
import com.datadog.api.client.ApiClient;
import com.datadog.api.client.ApiException;
import com.datadog.api.client.v1.api.ServiceLevelObjectivesApi;
import com.datadog.api.client.v1.model.FormulaAndFunctionMetricDataSource;
import com.datadog.api.client.v1.model.FormulaAndFunctionMetricQueryDefinition;
import com.datadog.api.client.v1.model.SLOCountDefinition;
import com.datadog.api.client.v1.model.SLOCountDefinitionWithBadEventsFormula;
import com.datadog.api.client.v1.model.SLOCountSpec;
import com.datadog.api.client.v1.model.SLODataSourceQueryDefinition;
import com.datadog.api.client.v1.model.SLOFormula;
import com.datadog.api.client.v1.model.SLOListResponse;
import com.datadog.api.client.v1.model.SLOSliSpec;
import com.datadog.api.client.v1.model.SLOThreshold;
import com.datadog.api.client.v1.model.SLOTimeframe;
import com.datadog.api.client.v1.model.SLOType;
import com.datadog.api.client.v1.model.ServiceLevelObjectiveRequest;
import java.util.Arrays;
import java.util.Collections;
public class Example {
public static void main(String[] args) {
ApiClient defaultClient = ApiClient.getDefaultApiClient();
defaultClient.setAccessToken(System.getenv("DD_BEARER_TOKEN"));
ServiceLevelObjectivesApi apiInstance = new ServiceLevelObjectivesApi(defaultClient);
ServiceLevelObjectiveRequest body =
new ServiceLevelObjectiveRequest()
.type(SLOType.METRIC)
.description("Metric SLO using sli_specification")
.name("Example-Service-Level-Objective")
.sliSpecification(
new SLOSliSpec(
new SLOCountSpec()
.count(
new SLOCountDefinition(
new SLOCountDefinitionWithBadEventsFormula()
.goodEventsFormula(new SLOFormula().formula("query1 - query2"))
.badEventsFormula(new SLOFormula().formula("query2"))
.queries(
Arrays.asList(
new SLODataSourceQueryDefinition(
new FormulaAndFunctionMetricQueryDefinition()
.dataSource(
FormulaAndFunctionMetricDataSource.METRICS)
.name("query1")
.query("sum:httpservice.hits{*}.as_count()")),
new SLODataSourceQueryDefinition(
new FormulaAndFunctionMetricQueryDefinition()
.dataSource(
FormulaAndFunctionMetricDataSource.METRICS)
.name("query2")
.query(
"sum:httpservice.errors{*}.as_count()"))))))))
.tags(Arrays.asList("env:prod", "type:count"))
.thresholds(
Collections.singletonList(
new SLOThreshold()
.target(99.0)
.targetDisplay("99.0")
.timeframe(SLOTimeframe.SEVEN_DAYS)
.warning(99.5)
.warningDisplay("99.5")))
.timeframe(SLOTimeframe.SEVEN_DAYS)
.targetThreshold(99.0)
.warningThreshold(99.5);
try {
SLOListResponse result = apiInstance.createSLO(body);
System.out.println(result);
} catch (ApiException e) {
System.err.println("Exception when calling ServiceLevelObjectivesApi#createSLO");
System.err.println("Status code: " + e.getCode());
System.err.println("Reason: " + e.getResponseBody());
System.err.println("Response headers: " + e.getResponseHeaders());
e.printStackTrace();
}
}
}
Create a new metric SLO object using sli_specification returns "OK" response
// Create a new metric SLO object using sli_specification returns "OK" response
import com.datadog.api.client.ApiClient;
import com.datadog.api.client.ApiException;
import com.datadog.api.client.v1.api.ServiceLevelObjectivesApi;
import com.datadog.api.client.v1.model.FormulaAndFunctionMetricDataSource;
import com.datadog.api.client.v1.model.FormulaAndFunctionMetricQueryDefinition;
import com.datadog.api.client.v1.model.SLOCountDefinition;
import com.datadog.api.client.v1.model.SLOCountDefinitionWithTotalEventsFormula;
import com.datadog.api.client.v1.model.SLOCountSpec;
import com.datadog.api.client.v1.model.SLODataSourceQueryDefinition;
import com.datadog.api.client.v1.model.SLOFormula;
import com.datadog.api.client.v1.model.SLOListResponse;
import com.datadog.api.client.v1.model.SLOSliSpec;
import com.datadog.api.client.v1.model.SLOThreshold;
import com.datadog.api.client.v1.model.SLOTimeframe;
import com.datadog.api.client.v1.model.SLOType;
import com.datadog.api.client.v1.model.ServiceLevelObjectiveRequest;
import java.util.Arrays;
import java.util.Collections;
public class Example {
public static void main(String[] args) {
ApiClient defaultClient = ApiClient.getDefaultApiClient();
defaultClient.setAccessToken(System.getenv("DD_BEARER_TOKEN"));
ServiceLevelObjectivesApi apiInstance = new ServiceLevelObjectivesApi(defaultClient);
ServiceLevelObjectiveRequest body =
new ServiceLevelObjectiveRequest()
.type(SLOType.METRIC)
.description("Metric SLO using sli_specification")
.name("Example-Service-Level-Objective")
.sliSpecification(
new SLOSliSpec(
new SLOCountSpec()
.count(
new SLOCountDefinition(
new SLOCountDefinitionWithTotalEventsFormula()
.goodEventsFormula(new SLOFormula().formula("query1 - query2"))
.totalEventsFormula(new SLOFormula().formula("query1"))
.queries(
Arrays.asList(
new SLODataSourceQueryDefinition(
new FormulaAndFunctionMetricQueryDefinition()
.dataSource(
FormulaAndFunctionMetricDataSource.METRICS)
.name("query1")
.query("sum:httpservice.hits{*}.as_count()")),
new SLODataSourceQueryDefinition(
new FormulaAndFunctionMetricQueryDefinition()
.dataSource(
FormulaAndFunctionMetricDataSource.METRICS)
.name("query2")
.query(
"sum:httpservice.errors{*}.as_count()"))))))))
.tags(Arrays.asList("env:prod", "type:count"))
.thresholds(
Collections.singletonList(
new SLOThreshold()
.target(99.0)
.targetDisplay("99.0")
.timeframe(SLOTimeframe.SEVEN_DAYS)
.warning(99.5)
.warningDisplay("99.5")))
.timeframe(SLOTimeframe.SEVEN_DAYS)
.targetThreshold(99.0)
.warningThreshold(99.5);
try {
SLOListResponse result = apiInstance.createSLO(body);
System.out.println(result);
} catch (ApiException e) {
System.err.println("Exception when calling ServiceLevelObjectivesApi#createSLO");
System.err.println("Status code: " + e.getCode());
System.err.println("Reason: " + e.getResponseBody());
System.err.println("Response headers: " + e.getResponseHeaders());
e.printStackTrace();
}
}
}
Create a time-slice SLO object returns "OK" response
// Create a time-slice SLO object returns "OK" response
import com.datadog.api.client.ApiClient;
import com.datadog.api.client.ApiException;
import com.datadog.api.client.v1.api.ServiceLevelObjectivesApi;
import com.datadog.api.client.v1.model.FormulaAndFunctionMetricDataSource;
import com.datadog.api.client.v1.model.FormulaAndFunctionMetricQueryDefinition;
import com.datadog.api.client.v1.model.SLODataSourceQueryDefinition;
import com.datadog.api.client.v1.model.SLOFormula;
import com.datadog.api.client.v1.model.SLOListResponse;
import com.datadog.api.client.v1.model.SLOSliSpec;
import com.datadog.api.client.v1.model.SLOThreshold;
import com.datadog.api.client.v1.model.SLOTimeSliceComparator;
import com.datadog.api.client.v1.model.SLOTimeSliceCondition;
import com.datadog.api.client.v1.model.SLOTimeSliceQuery;
import com.datadog.api.client.v1.model.SLOTimeSliceSpec;
import com.datadog.api.client.v1.model.SLOTimeframe;
import com.datadog.api.client.v1.model.SLOType;
import com.datadog.api.client.v1.model.ServiceLevelObjectiveRequest;
import java.util.Collections;
public class Example {
public static void main(String[] args) {
ApiClient defaultClient = ApiClient.getDefaultApiClient();
defaultClient.setAccessToken(System.getenv("DD_BEARER_TOKEN"));
ServiceLevelObjectivesApi apiInstance = new ServiceLevelObjectivesApi(defaultClient);
ServiceLevelObjectiveRequest body =
new ServiceLevelObjectiveRequest()
.type(SLOType.TIME_SLICE)
.description("string")
.name("Example-Service-Level-Objective")
.sliSpecification(
new SLOSliSpec(
new SLOTimeSliceSpec()
.timeSlice(
new SLOTimeSliceCondition()
.query(
new SLOTimeSliceQuery()
.formulas(
Collections.singletonList(
new SLOFormula().formula("query1")))
.queries(
Collections.singletonList(
new SLODataSourceQueryDefinition(
new FormulaAndFunctionMetricQueryDefinition()
.dataSource(
FormulaAndFunctionMetricDataSource
.METRICS)
.name("query1")
.query(
"trace.servlet.request{env:prod}")))))
.comparator(SLOTimeSliceComparator.GREATER)
.threshold(5.0))))
.tags(Collections.singletonList("env:prod"))
.thresholds(
Collections.singletonList(
new SLOThreshold()
.target(97.0)
.targetDisplay("97.0")
.timeframe(SLOTimeframe.SEVEN_DAYS)
.warning(98.0)
.warningDisplay("98.0")))
.timeframe(SLOTimeframe.SEVEN_DAYS)
.targetThreshold(97.0)
.warningThreshold(98.0);
try {
SLOListResponse result = apiInstance.createSLO(body);
System.out.println(result);
} catch (ApiException e) {
System.err.println("Exception when calling ServiceLevelObjectivesApi#createSLO");
System.err.println("Status code: " + e.getCode());
System.err.println("Reason: " + e.getResponseBody());
System.err.println("Response headers: " + e.getResponseHeaders());
e.printStackTrace();
}
}
}
Instructions
First install the library and its dependencies and then save the example to Example.java and run following commands:
DD_SITE="datadoghq.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" java "Example.java"DD_SITE="us3.datadoghq.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" java "Example.java"DD_SITE="us5.datadoghq.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" java "Example.java"DD_SITE="datadoghq.eu" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" java "Example.java"DD_SITE="ap1.datadoghq.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" java "Example.java"DD_SITE="ap2.datadoghq.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" java "Example.java"DD_SITE="uk1.datadoghq.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" java "Example.java"DD_SITE="ddog-gov.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" java "Example.java"DD_SITE="us2.ddog-gov.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" java "Example.java"Create a new metric SLO object using bad events formula returns "OK" response
"""
Create a new metric SLO object using bad events formula returns "OK" response
"""
from os import environ
from datadog_api_client import ApiClient, Configuration
from datadog_api_client.v1.api.service_level_objectives_api import ServiceLevelObjectivesApi
from datadog_api_client.v1.model.formula_and_function_metric_data_source import FormulaAndFunctionMetricDataSource
from datadog_api_client.v1.model.formula_and_function_metric_query_definition import (
FormulaAndFunctionMetricQueryDefinition,
)
from datadog_api_client.v1.model.service_level_objective_request import ServiceLevelObjectiveRequest
from datadog_api_client.v1.model.slo_count_definition_with_bad_events_formula import (
SLOCountDefinitionWithBadEventsFormula,
)
from datadog_api_client.v1.model.slo_count_spec import SLOCountSpec
from datadog_api_client.v1.model.slo_formula import SLOFormula
from datadog_api_client.v1.model.slo_threshold import SLOThreshold
from datadog_api_client.v1.model.slo_timeframe import SLOTimeframe
from datadog_api_client.v1.model.slo_type import SLOType
body = ServiceLevelObjectiveRequest(
type=SLOType.METRIC,
description="Metric SLO using sli_specification",
name="Example-Service-Level-Objective",
sli_specification=SLOCountSpec(
count=SLOCountDefinitionWithBadEventsFormula(
good_events_formula=SLOFormula(
formula="query1 - query2",
),
bad_events_formula=SLOFormula(
formula="query2",
),
queries=[
FormulaAndFunctionMetricQueryDefinition(
data_source=FormulaAndFunctionMetricDataSource.METRICS,
name="query1",
query="sum:httpservice.hits{*}.as_count()",
),
FormulaAndFunctionMetricQueryDefinition(
data_source=FormulaAndFunctionMetricDataSource.METRICS,
name="query2",
query="sum:httpservice.errors{*}.as_count()",
),
],
),
),
tags=[
"env:prod",
"type:count",
],
thresholds=[
SLOThreshold(
target=99.0,
target_display="99.0",
timeframe=SLOTimeframe.SEVEN_DAYS,
warning=99.5,
warning_display="99.5",
),
],
timeframe=SLOTimeframe.SEVEN_DAYS,
target_threshold=99.0,
warning_threshold=99.5,
)
configuration = Configuration()
configuration.access_token = environ["DD_BEARER_TOKEN"]
with ApiClient(configuration) as api_client:
api_instance = ServiceLevelObjectivesApi(api_client)
response = api_instance.create_slo(body=body)
print(response)
Create a new metric SLO object using sli_specification returns "OK" response
"""
Create a new metric SLO object using sli_specification returns "OK" response
"""
from os import environ
from datadog_api_client import ApiClient, Configuration
from datadog_api_client.v1.api.service_level_objectives_api import ServiceLevelObjectivesApi
from datadog_api_client.v1.model.formula_and_function_metric_data_source import FormulaAndFunctionMetricDataSource
from datadog_api_client.v1.model.formula_and_function_metric_query_definition import (
FormulaAndFunctionMetricQueryDefinition,
)
from datadog_api_client.v1.model.service_level_objective_request import ServiceLevelObjectiveRequest
from datadog_api_client.v1.model.slo_count_definition_with_total_events_formula import (
SLOCountDefinitionWithTotalEventsFormula,
)
from datadog_api_client.v1.model.slo_count_spec import SLOCountSpec
from datadog_api_client.v1.model.slo_formula import SLOFormula
from datadog_api_client.v1.model.slo_threshold import SLOThreshold
from datadog_api_client.v1.model.slo_timeframe import SLOTimeframe
from datadog_api_client.v1.model.slo_type import SLOType
body = ServiceLevelObjectiveRequest(
type=SLOType.METRIC,
description="Metric SLO using sli_specification",
name="Example-Service-Level-Objective",
sli_specification=SLOCountSpec(
count=SLOCountDefinitionWithTotalEventsFormula(
good_events_formula=SLOFormula(
formula="query1 - query2",
),
total_events_formula=SLOFormula(
formula="query1",
),
queries=[
FormulaAndFunctionMetricQueryDefinition(
data_source=FormulaAndFunctionMetricDataSource.METRICS,
name="query1",
query="sum:httpservice.hits{*}.as_count()",
),
FormulaAndFunctionMetricQueryDefinition(
data_source=FormulaAndFunctionMetricDataSource.METRICS,
name="query2",
query="sum:httpservice.errors{*}.as_count()",
),
],
),
),
tags=[
"env:prod",
"type:count",
],
thresholds=[
SLOThreshold(
target=99.0,
target_display="99.0",
timeframe=SLOTimeframe.SEVEN_DAYS,
warning=99.5,
warning_display="99.5",
),
],
timeframe=SLOTimeframe.SEVEN_DAYS,
target_threshold=99.0,
warning_threshold=99.5,
)
configuration = Configuration()
configuration.access_token = environ["DD_BEARER_TOKEN"]
with ApiClient(configuration) as api_client:
api_instance = ServiceLevelObjectivesApi(api_client)
response = api_instance.create_slo(body=body)
print(response)
Create a time-slice SLO object returns "OK" response
"""
Create a time-slice SLO object returns "OK" response
"""
from os import environ
from datadog_api_client import ApiClient, Configuration
from datadog_api_client.v1.api.service_level_objectives_api import ServiceLevelObjectivesApi
from datadog_api_client.v1.model.formula_and_function_metric_data_source import FormulaAndFunctionMetricDataSource
from datadog_api_client.v1.model.formula_and_function_metric_query_definition import (
FormulaAndFunctionMetricQueryDefinition,
)
from datadog_api_client.v1.model.service_level_objective_request import ServiceLevelObjectiveRequest
from datadog_api_client.v1.model.slo_formula import SLOFormula
from datadog_api_client.v1.model.slo_threshold import SLOThreshold
from datadog_api_client.v1.model.slo_time_slice_comparator import SLOTimeSliceComparator
from datadog_api_client.v1.model.slo_time_slice_condition import SLOTimeSliceCondition
from datadog_api_client.v1.model.slo_time_slice_query import SLOTimeSliceQuery
from datadog_api_client.v1.model.slo_time_slice_spec import SLOTimeSliceSpec
from datadog_api_client.v1.model.slo_timeframe import SLOTimeframe
from datadog_api_client.v1.model.slo_type import SLOType
body = ServiceLevelObjectiveRequest(
type=SLOType.TIME_SLICE,
description="string",
name="Example-Service-Level-Objective",
sli_specification=SLOTimeSliceSpec(
time_slice=SLOTimeSliceCondition(
query=SLOTimeSliceQuery(
formulas=[
SLOFormula(
formula="query1",
),
],
queries=[
FormulaAndFunctionMetricQueryDefinition(
data_source=FormulaAndFunctionMetricDataSource.METRICS,
name="query1",
query="trace.servlet.request{env:prod}",
),
],
),
comparator=SLOTimeSliceComparator.GREATER,
threshold=5.0,
),
),
tags=[
"env:prod",
],
thresholds=[
SLOThreshold(
target=97.0,
target_display="97.0",
timeframe=SLOTimeframe.SEVEN_DAYS,
warning=98.0,
warning_display="98.0",
),
],
timeframe=SLOTimeframe.SEVEN_DAYS,
target_threshold=97.0,
warning_threshold=98.0,
)
configuration = Configuration()
configuration.access_token = environ["DD_BEARER_TOKEN"]
with ApiClient(configuration) as api_client:
api_instance = ServiceLevelObjectivesApi(api_client)
response = api_instance.create_slo(body=body)
print(response)
Instructions
First install the library and its dependencies and then save the example to example.py and run following commands:
DD_SITE="datadoghq.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" python3 "example.py"DD_SITE="us3.datadoghq.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" python3 "example.py"DD_SITE="us5.datadoghq.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" python3 "example.py"DD_SITE="datadoghq.eu" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" python3 "example.py"DD_SITE="ap1.datadoghq.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" python3 "example.py"DD_SITE="ap2.datadoghq.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" python3 "example.py"DD_SITE="uk1.datadoghq.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" python3 "example.py"DD_SITE="ddog-gov.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" python3 "example.py"DD_SITE="us2.ddog-gov.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" python3 "example.py"Create a new metric SLO object using bad events formula returns "OK" response
# Create a new metric SLO object using bad events formula returns "OK" response
require "datadog_api_client"
DatadogAPIClient.configure do |config|
config.access_token = ENV["DD_BEARER_TOKEN"]
end
api_instance = DatadogAPIClient::V1::ServiceLevelObjectivesAPI.new
body = DatadogAPIClient::V1::ServiceLevelObjectiveRequest.new({
type: DatadogAPIClient::V1::SLOType::METRIC,
description: "Metric SLO using sli_specification",
name: "Example-Service-Level-Objective",
sli_specification: DatadogAPIClient::V1::SLOCountSpec.new({
count: DatadogAPIClient::V1::SLOCountDefinitionWithBadEventsFormula.new({
good_events_formula: DatadogAPIClient::V1::SLOFormula.new({
formula: "query1 - query2",
}),
bad_events_formula: DatadogAPIClient::V1::SLOFormula.new({
formula: "query2",
}),
queries: [
DatadogAPIClient::V1::FormulaAndFunctionMetricQueryDefinition.new({
data_source: DatadogAPIClient::V1::FormulaAndFunctionMetricDataSource::METRICS,
name: "query1",
query: "sum:httpservice.hits{*}.as_count()",
}),
DatadogAPIClient::V1::FormulaAndFunctionMetricQueryDefinition.new({
data_source: DatadogAPIClient::V1::FormulaAndFunctionMetricDataSource::METRICS,
name: "query2",
query: "sum:httpservice.errors{*}.as_count()",
}),
],
}),
}),
tags: [
"env:prod",
"type:count",
],
thresholds: [
DatadogAPIClient::V1::SLOThreshold.new({
target: 99.0,
target_display: "99.0",
timeframe: DatadogAPIClient::V1::SLOTimeframe::SEVEN_DAYS,
warning: 99.5,
warning_display: "99.5",
}),
],
timeframe: DatadogAPIClient::V1::SLOTimeframe::SEVEN_DAYS,
target_threshold: 99.0,
warning_threshold: 99.5,
})
p api_instance.create_slo(body)
Create a new metric SLO object using sli_specification returns "OK" response
# Create a new metric SLO object using sli_specification returns "OK" response
require "datadog_api_client"
DatadogAPIClient.configure do |config|
config.access_token = ENV["DD_BEARER_TOKEN"]
end
api_instance = DatadogAPIClient::V1::ServiceLevelObjectivesAPI.new
body = DatadogAPIClient::V1::ServiceLevelObjectiveRequest.new({
type: DatadogAPIClient::V1::SLOType::METRIC,
description: "Metric SLO using sli_specification",
name: "Example-Service-Level-Objective",
sli_specification: DatadogAPIClient::V1::SLOCountSpec.new({
count: DatadogAPIClient::V1::SLOCountDefinitionWithTotalEventsFormula.new({
good_events_formula: DatadogAPIClient::V1::SLOFormula.new({
formula: "query1 - query2",
}),
total_events_formula: DatadogAPIClient::V1::SLOFormula.new({
formula: "query1",
}),
queries: [
DatadogAPIClient::V1::FormulaAndFunctionMetricQueryDefinition.new({
data_source: DatadogAPIClient::V1::FormulaAndFunctionMetricDataSource::METRICS,
name: "query1",
query: "sum:httpservice.hits{*}.as_count()",
}),
DatadogAPIClient::V1::FormulaAndFunctionMetricQueryDefinition.new({
data_source: DatadogAPIClient::V1::FormulaAndFunctionMetricDataSource::METRICS,
name: "query2",
query: "sum:httpservice.errors{*}.as_count()",
}),
],
}),
}),
tags: [
"env:prod",
"type:count",
],
thresholds: [
DatadogAPIClient::V1::SLOThreshold.new({
target: 99.0,
target_display: "99.0",
timeframe: DatadogAPIClient::V1::SLOTimeframe::SEVEN_DAYS,
warning: 99.5,
warning_display: "99.5",
}),
],
timeframe: DatadogAPIClient::V1::SLOTimeframe::SEVEN_DAYS,
target_threshold: 99.0,
warning_threshold: 99.5,
})
p api_instance.create_slo(body)
Create a time-slice SLO object returns "OK" response
# Create a time-slice SLO object returns "OK" response
require "datadog_api_client"
DatadogAPIClient.configure do |config|
config.access_token = ENV["DD_BEARER_TOKEN"]
end
api_instance = DatadogAPIClient::V1::ServiceLevelObjectivesAPI.new
body = DatadogAPIClient::V1::ServiceLevelObjectiveRequest.new({
type: DatadogAPIClient::V1::SLOType::TIME_SLICE,
description: "string",
name: "Example-Service-Level-Objective",
sli_specification: DatadogAPIClient::V1::SLOTimeSliceSpec.new({
time_slice: DatadogAPIClient::V1::SLOTimeSliceCondition.new({
query: DatadogAPIClient::V1::SLOTimeSliceQuery.new({
formulas: [
DatadogAPIClient::V1::SLOFormula.new({
formula: "query1",
}),
],
queries: [
DatadogAPIClient::V1::FormulaAndFunctionMetricQueryDefinition.new({
data_source: DatadogAPIClient::V1::FormulaAndFunctionMetricDataSource::METRICS,
name: "query1",
query: "trace.servlet.request{env:prod}",
}),
],
}),
comparator: DatadogAPIClient::V1::SLOTimeSliceComparator::GREATER,
threshold: 5,
}),
}),
tags: [
"env:prod",
],
thresholds: [
DatadogAPIClient::V1::SLOThreshold.new({
target: 97.0,
target_display: "97.0",
timeframe: DatadogAPIClient::V1::SLOTimeframe::SEVEN_DAYS,
warning: 98,
warning_display: "98.0",
}),
],
timeframe: DatadogAPIClient::V1::SLOTimeframe::SEVEN_DAYS,
target_threshold: 97.0,
warning_threshold: 98,
})
p api_instance.create_slo(body)
Instructions
First install the library and its dependencies and then save the example to example.rb and run following commands:
DD_SITE="datadoghq.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" rb "example.rb"DD_SITE="us3.datadoghq.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" rb "example.rb"DD_SITE="us5.datadoghq.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" rb "example.rb"DD_SITE="datadoghq.eu" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" rb "example.rb"DD_SITE="ap1.datadoghq.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" rb "example.rb"DD_SITE="ap2.datadoghq.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" rb "example.rb"DD_SITE="uk1.datadoghq.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" rb "example.rb"DD_SITE="ddog-gov.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" rb "example.rb"DD_SITE="us2.ddog-gov.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" rb "example.rb"Create a new metric SLO object using bad events formula returns "OK" response
// Create a new metric SLO object using bad events formula returns "OK" response
use datadog_api_client::datadog;
use datadog_api_client::datadogV1::api_service_level_objectives::ServiceLevelObjectivesAPI;
use datadog_api_client::datadogV1::model::FormulaAndFunctionMetricDataSource;
use datadog_api_client::datadogV1::model::FormulaAndFunctionMetricQueryDefinition;
use datadog_api_client::datadogV1::model::SLOCountDefinition;
use datadog_api_client::datadogV1::model::SLOCountDefinitionWithBadEventsFormula;
use datadog_api_client::datadogV1::model::SLOCountSpec;
use datadog_api_client::datadogV1::model::SLODataSourceQueryDefinition;
use datadog_api_client::datadogV1::model::SLOFormula;
use datadog_api_client::datadogV1::model::SLOSliSpec;
use datadog_api_client::datadogV1::model::SLOThreshold;
use datadog_api_client::datadogV1::model::SLOTimeframe;
use datadog_api_client::datadogV1::model::SLOType;
use datadog_api_client::datadogV1::model::ServiceLevelObjectiveRequest;
#[tokio::main]
async fn main() {
let body = ServiceLevelObjectiveRequest::new(
"Example-Service-Level-Objective".to_string(),
vec![SLOThreshold::new(99.0, SLOTimeframe::SEVEN_DAYS)
.target_display("99.0".to_string())
.warning(99.5 as f64)
.warning_display("99.5".to_string())],
SLOType::METRIC,
)
.description(Some("Metric SLO using sli_specification".to_string()))
.sli_specification(SLOSliSpec::SLOCountSpec(Box::new(SLOCountSpec::new(
SLOCountDefinition::SLOCountDefinitionWithBadEventsFormula(Box::new(
SLOCountDefinitionWithBadEventsFormula::new(
SLOFormula::new("query2".to_string()),
SLOFormula::new("query1 - query2".to_string()),
vec![
SLODataSourceQueryDefinition::FormulaAndFunctionMetricQueryDefinition(
Box::new(FormulaAndFunctionMetricQueryDefinition::new(
FormulaAndFunctionMetricDataSource::METRICS,
"query1".to_string(),
"sum:httpservice.hits{*}.as_count()".to_string(),
)),
),
SLODataSourceQueryDefinition::FormulaAndFunctionMetricQueryDefinition(
Box::new(FormulaAndFunctionMetricQueryDefinition::new(
FormulaAndFunctionMetricDataSource::METRICS,
"query2".to_string(),
"sum:httpservice.errors{*}.as_count()".to_string(),
)),
),
],
),
)),
))))
.tags(vec!["env:prod".to_string(), "type:count".to_string()])
.target_threshold(99.0 as f64)
.timeframe(SLOTimeframe::SEVEN_DAYS)
.warning_threshold(99.5 as f64);
let configuration = datadog::Configuration::new();
let api = ServiceLevelObjectivesAPI::with_config(configuration);
let resp = api.create_slo(body).await;
if let Ok(value) = resp {
println!("{:#?}", value);
} else {
println!("{:#?}", resp.unwrap_err());
}
}
Create a new metric SLO object using sli_specification returns "OK" response
// Create a new metric SLO object using sli_specification returns "OK" response
use datadog_api_client::datadog;
use datadog_api_client::datadogV1::api_service_level_objectives::ServiceLevelObjectivesAPI;
use datadog_api_client::datadogV1::model::FormulaAndFunctionMetricDataSource;
use datadog_api_client::datadogV1::model::FormulaAndFunctionMetricQueryDefinition;
use datadog_api_client::datadogV1::model::SLOCountDefinition;
use datadog_api_client::datadogV1::model::SLOCountDefinitionWithTotalEventsFormula;
use datadog_api_client::datadogV1::model::SLOCountSpec;
use datadog_api_client::datadogV1::model::SLODataSourceQueryDefinition;
use datadog_api_client::datadogV1::model::SLOFormula;
use datadog_api_client::datadogV1::model::SLOSliSpec;
use datadog_api_client::datadogV1::model::SLOThreshold;
use datadog_api_client::datadogV1::model::SLOTimeframe;
use datadog_api_client::datadogV1::model::SLOType;
use datadog_api_client::datadogV1::model::ServiceLevelObjectiveRequest;
#[tokio::main]
async fn main() {
let body = ServiceLevelObjectiveRequest::new(
"Example-Service-Level-Objective".to_string(),
vec![SLOThreshold::new(99.0, SLOTimeframe::SEVEN_DAYS)
.target_display("99.0".to_string())
.warning(99.5 as f64)
.warning_display("99.5".to_string())],
SLOType::METRIC,
)
.description(Some("Metric SLO using sli_specification".to_string()))
.sli_specification(SLOSliSpec::SLOCountSpec(Box::new(SLOCountSpec::new(
SLOCountDefinition::SLOCountDefinitionWithTotalEventsFormula(Box::new(
SLOCountDefinitionWithTotalEventsFormula::new(
SLOFormula::new("query1 - query2".to_string()),
vec![
SLODataSourceQueryDefinition::FormulaAndFunctionMetricQueryDefinition(
Box::new(FormulaAndFunctionMetricQueryDefinition::new(
FormulaAndFunctionMetricDataSource::METRICS,
"query1".to_string(),
"sum:httpservice.hits{*}.as_count()".to_string(),
)),
),
SLODataSourceQueryDefinition::FormulaAndFunctionMetricQueryDefinition(
Box::new(FormulaAndFunctionMetricQueryDefinition::new(
FormulaAndFunctionMetricDataSource::METRICS,
"query2".to_string(),
"sum:httpservice.errors{*}.as_count()".to_string(),
)),
),
],
SLOFormula::new("query1".to_string()),
),
)),
))))
.tags(vec!["env:prod".to_string(), "type:count".to_string()])
.target_threshold(99.0 as f64)
.timeframe(SLOTimeframe::SEVEN_DAYS)
.warning_threshold(99.5 as f64);
let configuration = datadog::Configuration::new();
let api = ServiceLevelObjectivesAPI::with_config(configuration);
let resp = api.create_slo(body).await;
if let Ok(value) = resp {
println!("{:#?}", value);
} else {
println!("{:#?}", resp.unwrap_err());
}
}
Create a time-slice SLO object returns "OK" response
// Create a time-slice SLO object returns "OK" response
use datadog_api_client::datadog;
use datadog_api_client::datadogV1::api_service_level_objectives::ServiceLevelObjectivesAPI;
use datadog_api_client::datadogV1::model::FormulaAndFunctionMetricDataSource;
use datadog_api_client::datadogV1::model::FormulaAndFunctionMetricQueryDefinition;
use datadog_api_client::datadogV1::model::SLODataSourceQueryDefinition;
use datadog_api_client::datadogV1::model::SLOFormula;
use datadog_api_client::datadogV1::model::SLOSliSpec;
use datadog_api_client::datadogV1::model::SLOThreshold;
use datadog_api_client::datadogV1::model::SLOTimeSliceComparator;
use datadog_api_client::datadogV1::model::SLOTimeSliceCondition;
use datadog_api_client::datadogV1::model::SLOTimeSliceQuery;
use datadog_api_client::datadogV1::model::SLOTimeSliceSpec;
use datadog_api_client::datadogV1::model::SLOTimeframe;
use datadog_api_client::datadogV1::model::SLOType;
use datadog_api_client::datadogV1::model::ServiceLevelObjectiveRequest;
#[tokio::main]
async fn main() {
let body = ServiceLevelObjectiveRequest::new(
"Example-Service-Level-Objective".to_string(),
vec![SLOThreshold::new(97.0, SLOTimeframe::SEVEN_DAYS)
.target_display("97.0".to_string())
.warning(98.0 as f64)
.warning_display("98.0".to_string())],
SLOType::TIME_SLICE,
)
.description(Some("string".to_string()))
.sli_specification(SLOSliSpec::SLOTimeSliceSpec(Box::new(
SLOTimeSliceSpec::new(SLOTimeSliceCondition::new(
SLOTimeSliceComparator::GREATER,
SLOTimeSliceQuery::new(
vec![SLOFormula::new("query1".to_string())],
vec![
SLODataSourceQueryDefinition::FormulaAndFunctionMetricQueryDefinition(
Box::new(FormulaAndFunctionMetricQueryDefinition::new(
FormulaAndFunctionMetricDataSource::METRICS,
"query1".to_string(),
"trace.servlet.request{env:prod}".to_string(),
)),
),
],
),
5.0,
)),
)))
.tags(vec!["env:prod".to_string()])
.target_threshold(97.0 as f64)
.timeframe(SLOTimeframe::SEVEN_DAYS)
.warning_threshold(98.0 as f64);
let configuration = datadog::Configuration::new();
let api = ServiceLevelObjectivesAPI::with_config(configuration);
let resp = api.create_slo(body).await;
if let Ok(value) = resp {
println!("{:#?}", value);
} else {
println!("{:#?}", resp.unwrap_err());
}
}
Instructions
First install the library and its dependencies and then save the example to src/main.rs and run following commands:
DD_SITE="datadoghq.com" DD_API_KEY="<DD_API_KEY>" DD_APP_KEY="<DD_APP_KEY>" cargo runDD_SITE="us3.datadoghq.com" DD_API_KEY="<DD_API_KEY>" DD_APP_KEY="<DD_APP_KEY>" cargo runDD_SITE="us5.datadoghq.com" DD_API_KEY="<DD_API_KEY>" DD_APP_KEY="<DD_APP_KEY>" cargo runDD_SITE="datadoghq.eu" DD_API_KEY="<DD_API_KEY>" DD_APP_KEY="<DD_APP_KEY>" cargo runDD_SITE="ap1.datadoghq.com" DD_API_KEY="<DD_API_KEY>" DD_APP_KEY="<DD_APP_KEY>" cargo runDD_SITE="ap2.datadoghq.com" DD_API_KEY="<DD_API_KEY>" DD_APP_KEY="<DD_APP_KEY>" cargo runDD_SITE="uk1.datadoghq.com" DD_API_KEY="<DD_API_KEY>" DD_APP_KEY="<DD_APP_KEY>" cargo runDD_SITE="ddog-gov.com" DD_API_KEY="<DD_API_KEY>" DD_APP_KEY="<DD_APP_KEY>" cargo runDD_SITE="us2.ddog-gov.com" DD_API_KEY="<DD_API_KEY>" DD_APP_KEY="<DD_APP_KEY>" cargo runCreate a new metric SLO object using bad events formula returns "OK" response
/**
* Create a new metric SLO object using bad events formula returns "OK" response
*/
import { client, v1 } from "@datadog/datadog-api-client";
const configuration = client.createConfiguration({
authMethods: {
AuthZ: {
accessToken: process.env.DD_BEARER_TOKEN as string,
},
},
});
const apiInstance = new v1.ServiceLevelObjectivesApi(configuration);
const params: v1.ServiceLevelObjectivesApiCreateSLORequest = {
body: {
type: "metric",
description: "Metric SLO using sli_specification",
name: "Example-Service-Level-Objective",
sliSpecification: {
count: {
goodEventsFormula: {
formula: "query1 - query2",
},
badEventsFormula: {
formula: "query2",
},
queries: [
{
dataSource: "metrics",
name: "query1",
query: "sum:httpservice.hits{*}.as_count()",
},
{
dataSource: "metrics",
name: "query2",
query: "sum:httpservice.errors{*}.as_count()",
},
],
},
},
tags: ["env:prod", "type:count"],
thresholds: [
{
target: 99.0,
targetDisplay: "99.0",
timeframe: "7d",
warning: 99.5,
warningDisplay: "99.5",
},
],
timeframe: "7d",
targetThreshold: 99.0,
warningThreshold: 99.5,
},
};
apiInstance
.createSLO(params)
.then((data: v1.SLOListResponse) => {
console.log(
"API called successfully. Returned data: " + JSON.stringify(data)
);
})
.catch((error: any) => console.error(error));
Create a new metric SLO object using sli_specification returns "OK" response
/**
* Create a new metric SLO object using sli_specification returns "OK" response
*/
import { client, v1 } from "@datadog/datadog-api-client";
const configuration = client.createConfiguration({
authMethods: {
AuthZ: {
accessToken: process.env.DD_BEARER_TOKEN as string,
},
},
});
const apiInstance = new v1.ServiceLevelObjectivesApi(configuration);
const params: v1.ServiceLevelObjectivesApiCreateSLORequest = {
body: {
type: "metric",
description: "Metric SLO using sli_specification",
name: "Example-Service-Level-Objective",
sliSpecification: {
count: {
goodEventsFormula: {
formula: "query1 - query2",
},
totalEventsFormula: {
formula: "query1",
},
queries: [
{
dataSource: "metrics",
name: "query1",
query: "sum:httpservice.hits{*}.as_count()",
},
{
dataSource: "metrics",
name: "query2",
query: "sum:httpservice.errors{*}.as_count()",
},
],
},
},
tags: ["env:prod", "type:count"],
thresholds: [
{
target: 99.0,
targetDisplay: "99.0",
timeframe: "7d",
warning: 99.5,
warningDisplay: "99.5",
},
],
timeframe: "7d",
targetThreshold: 99.0,
warningThreshold: 99.5,
},
};
apiInstance
.createSLO(params)
.then((data: v1.SLOListResponse) => {
console.log(
"API called successfully. Returned data: " + JSON.stringify(data)
);
})
.catch((error: any) => console.error(error));
Create a time-slice SLO object returns "OK" response
/**
* Create a time-slice SLO object returns "OK" response
*/
import { client, v1 } from "@datadog/datadog-api-client";
const configuration = client.createConfiguration({
authMethods: {
AuthZ: {
accessToken: process.env.DD_BEARER_TOKEN as string,
},
},
});
const apiInstance = new v1.ServiceLevelObjectivesApi(configuration);
const params: v1.ServiceLevelObjectivesApiCreateSLORequest = {
body: {
type: "time_slice",
description: "string",
name: "Example-Service-Level-Objective",
sliSpecification: {
timeSlice: {
query: {
formulas: [
{
formula: "query1",
},
],
queries: [
{
dataSource: "metrics",
name: "query1",
query: "trace.servlet.request{env:prod}",
},
],
},
comparator: ">",
threshold: 5,
},
},
tags: ["env:prod"],
thresholds: [
{
target: 97.0,
targetDisplay: "97.0",
timeframe: "7d",
warning: 98,
warningDisplay: "98.0",
},
],
timeframe: "7d",
targetThreshold: 97.0,
warningThreshold: 98,
},
};
apiInstance
.createSLO(params)
.then((data: v1.SLOListResponse) => {
console.log(
"API called successfully. Returned data: " + JSON.stringify(data)
);
})
.catch((error: any) => console.error(error));
Instructions
First install the library and its dependencies and then save the example to example.ts and run following commands:
DD_SITE="datadoghq.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" tsc "example.ts"DD_SITE="us3.datadoghq.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" tsc "example.ts"DD_SITE="us5.datadoghq.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" tsc "example.ts"DD_SITE="datadoghq.eu" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" tsc "example.ts"DD_SITE="ap1.datadoghq.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" tsc "example.ts"DD_SITE="ap2.datadoghq.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" tsc "example.ts"DD_SITE="uk1.datadoghq.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" tsc "example.ts"DD_SITE="ddog-gov.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" tsc "example.ts"DD_SITE="us2.ddog-gov.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" tsc "example.ts"Create an SLO object returns "OK" response
from datadog import initialize, api
options = {
'api_key': '<DATADOG_API_KEY>',
'app_key': '<DATADOG_APPLICATION_KEY>'
}
initialize(**options)
# Create a new SLO
thresholds = [
{"timeframe": "7d", "target": 95},
{"timeframe": "30d", "target": 95, "warning": 97},
]
tags = ["app:webserver", "frontend"]
api.ServiceLevelObjective.create(
type="metric",
name="Custom Metric SLO",
description="SLO tracking custom service SLO",
query={
"numerator": "sum:my.custom.metric{type:good}.as_count()",
"denominator": "sum:my.custom.metric{*}.as_count()"
},
tags=tags,
thresholds=thresholds
)
Instructions
First install the library and its dependencies and then save the example to example.py and run following commands:
DD_SITE="datadoghq.com" DD_API_KEY="<DD_API_KEY>" DD_APP_KEY="<DD_APP_KEY>" python "example.py"DD_SITE="us3.datadoghq.com" DD_API_KEY="<DD_API_KEY>" DD_APP_KEY="<DD_APP_KEY>" python "example.py"DD_SITE="us5.datadoghq.com" DD_API_KEY="<DD_API_KEY>" DD_APP_KEY="<DD_APP_KEY>" python "example.py"DD_SITE="datadoghq.eu" DD_API_KEY="<DD_API_KEY>" DD_APP_KEY="<DD_APP_KEY>" python "example.py"DD_SITE="ap1.datadoghq.com" DD_API_KEY="<DD_API_KEY>" DD_APP_KEY="<DD_APP_KEY>" python "example.py"DD_SITE="ap2.datadoghq.com" DD_API_KEY="<DD_API_KEY>" DD_APP_KEY="<DD_APP_KEY>" python "example.py"DD_SITE="uk1.datadoghq.com" DD_API_KEY="<DD_API_KEY>" DD_APP_KEY="<DD_APP_KEY>" python "example.py"DD_SITE="ddog-gov.com" DD_API_KEY="<DD_API_KEY>" DD_APP_KEY="<DD_APP_KEY>" python "example.py"DD_SITE="us2.ddog-gov.com" DD_API_KEY="<DD_API_KEY>" DD_APP_KEY="<DD_APP_KEY>" python "example.py"Create an SLO object returns "OK" response
require 'dogapi'
api_key = '<DATADOG_API_KEY>'
app_key = '<DATADOG_APPLICATION_KEY>'
dog = Dogapi::Client.new(api_key, app_key)
# Create a new SLO
thresholds = [
{ timeframe: '7d', target: 95 },
{ timeframe: '30d', target: 95, warning: 97 }
]
tags = ['app:webserver', 'frontend']
dog.create_service_level_objective(
type: 'metric',
name: 'Custom Metric SLO',
description: 'SLO tracking custom service SLO',
numerator: 'sum:my.custom.metric{type:good}.as_count()',
denominator: 'sum:my.custom.metric{*}.as_count()',
tags: tags,
thresholds: thresholds
)
Instructions
First install the library and its dependencies and then save the example to example.rb and run following commands:
DD_SITE="datadoghq.com" DD_API_KEY="<DD_API_KEY>" DD_APP_KEY="<DD_APP_KEY>" rb "example.rb"DD_SITE="us3.datadoghq.com" DD_API_KEY="<DD_API_KEY>" DD_APP_KEY="<DD_APP_KEY>" rb "example.rb"DD_SITE="us5.datadoghq.com" DD_API_KEY="<DD_API_KEY>" DD_APP_KEY="<DD_APP_KEY>" rb "example.rb"DD_SITE="datadoghq.eu" DD_API_KEY="<DD_API_KEY>" DD_APP_KEY="<DD_APP_KEY>" rb "example.rb"DD_SITE="ap1.datadoghq.com" DD_API_KEY="<DD_API_KEY>" DD_APP_KEY="<DD_APP_KEY>" rb "example.rb"DD_SITE="ap2.datadoghq.com" DD_API_KEY="<DD_API_KEY>" DD_APP_KEY="<DD_APP_KEY>" rb "example.rb"DD_SITE="uk1.datadoghq.com" DD_API_KEY="<DD_API_KEY>" DD_APP_KEY="<DD_APP_KEY>" rb "example.rb"DD_SITE="ddog-gov.com" DD_API_KEY="<DD_API_KEY>" DD_APP_KEY="<DD_APP_KEY>" rb "example.rb"DD_SITE="us2.ddog-gov.com" DD_API_KEY="<DD_API_KEY>" DD_APP_KEY="<DD_APP_KEY>" rb "example.rb"