Settings API - Service-level objective definitions schema table
Service-level objective definitions (builtin:monitoring.slo
)
Define custom Service-level objectives (SLOs) to assist in fulfilling your organization’s service-level agreements. Create up to 10000 custom SLOs for this Dynatrace environment.
Schema ID | Schema groups | Scope |
---|---|---|
builtin:monitoring.slo |
| environment |
Parameters
Property | Label | Type | Description | Required |
---|---|---|---|---|
enabled | Enabled | boolean | - | required |
name | SLO name | text | - | required |
customDescription | Description | text | The description of the SLO | optional |
metricName | Metric name | text | - | required |
metricExpression | Define the metric expression that measures the success rate of this SLO | text | For details, see the Metrics page ( | required |
evaluationType | Evaluation type | enum | Select "Aggregate" to have the measurements of this success metric aggregated into a single percentage-rate metric. | required |
filter | Entity selector | text | Set a filter parameter (entitySelector) on any GET call to evaluate this SLO against specific services only (for example, type("SERVICE")). For details, see the Entity Selector documentation. | required |
evaluationWindow | Timeframe during which the SLO is to be evaluated | text | Define the timeframe during which the SLO is to be evaluated. For the timeframe you can enter expressions like -1h (last hour), -1w (last week) or complex expressions like -2d to now (last two days), -1d/d to now/d (beginning of yesterday to beginning of today). | required |
targetSuccess | Target percentage | float | Set the target value of the SLO. A percentage below this value indicates a failure. | required |
targetWarning | Warning percentage | float | Set the warning value of the SLO. At the warning state the SLO is fulfilled. However, it is getting close to a failure. | required |
errorBudgetBurnRate | - | ErrorBudgetBurnRate | - | required |
Request body objects
The FlagDefaultTrue
object
Property | Label | Type | Description | Required |
---|---|---|---|---|
enabled | Enabled | boolean | - | required |
The ErrorBudgetBurnRate
object
Property | Label | Type | Description | Required |
---|---|---|---|---|
burnRateVisualizationEnabled | Burn rate visualization enabled | boolean | - | required |
fastBurnThreshold | Fast-burn threshold | float | The threshold defines when a burn rate is marked as fast-burning (high-emergency). Burn rates lower than this threshold (and greater than 1) are highlighted as slow-burn (low-emergency). | required |