SLO: Implements SLO Datasource and SLO Resource

docs/data-sources/slo.md

@@ -0,0 +1,146 @@
+---
+# generated by https://github.com/hashicorp/terraform-plugin-docs
+page_title: "grafana_slo Data Source - terraform-provider-grafana"
+subcategory: "SLO"
+description: |-
+  Datasource for retrieving all SLOs.
+  Official documentation https://grafana.com/docs/grafana-cloud/slo/API documentation https://grafana.com/docs/grafana-cloud/slo/api/
+---
+
+# grafana_slo (Data Source)
+
+Datasource for retrieving all SLOs.
+
+* [Official documentation](https://grafana.com/docs/grafana-cloud/slo/)
+* [API documentation](https://grafana.com/docs/grafana-cloud/slo/api/)
+
+## Example Usage
+
+```terraform
+data "grafana_slo" "slos" {}
+```
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Read-Only
+
+- `id` (String) The ID of this resource.
+- `slos` (List of Object) Returns a list of all SLOs" (see [below for nested schema](#nestedatt--slos))
+
+<a id="nestedatt--slos"></a>
+### Nested Schema for `slos`
+
+Read-Only:
+
+- `alerting` (List of Object) (see [below for nested schema](#nestedobjatt--slos--alerting))
+- `dashboard_uid` (String)
+- `description` (String)
+- `labels` (List of Object) (see [below for nested schema](#nestedobjatt--slos--labels))
+- `name` (String)
+- `objectives` (List of Object) (see [below for nested schema](#nestedobjatt--slos--objectives))
+- `query` (String)
+- `uuid` (String)
+
+<a id="nestedobjatt--slos--alerting"></a>
+### Nested Schema for `slos.alerting`
+
+Read-Only:
+
+- `annotations` (List of Object) (see [below for nested schema](#nestedobjatt--slos--alerting--annotations))
+- `fastburn` (List of Object) (see [below for nested schema](#nestedobjatt--slos--alerting--fastburn))
+- `labels` (List of Object) (see [below for nested schema](#nestedobjatt--slos--alerting--labels))
+- `name` (String)
+- `slowburn` (List of Object) (see [below for nested schema](#nestedobjatt--slos--alerting--slowburn))
+
+<a id="nestedobjatt--slos--alerting--annotations"></a>
+### Nested Schema for `slos.alerting.annotations`
+
+Read-Only:
+
+- `key` (String)
+- `value` (String)
+
+
+<a id="nestedobjatt--slos--alerting--fastburn"></a>
+### Nested Schema for `slos.alerting.fastburn`
+
+Read-Only:
+
+- `annotations` (List of Object) (see [below for nested schema](#nestedobjatt--slos--alerting--fastburn--annotations))
+- `labels` (List of Object) (see [below for nested schema](#nestedobjatt--slos--alerting--fastburn--labels))
+
+<a id="nestedobjatt--slos--alerting--fastburn--annotations"></a>
+### Nested Schema for `slos.alerting.fastburn.labels`
+
+Read-Only:
+
+- `key` (String)
+- `value` (String)
+
+
+<a id="nestedobjatt--slos--alerting--fastburn--labels"></a>
+### Nested Schema for `slos.alerting.fastburn.labels`
+
+Read-Only:
+
+- `key` (String)
+- `value` (String)
+
+
+
+<a id="nestedobjatt--slos--alerting--labels"></a>
+### Nested Schema for `slos.alerting.labels`
+
+Read-Only:
+
+- `key` (String)
+- `value` (String)
+
+
+<a id="nestedobjatt--slos--alerting--slowburn"></a>
+### Nested Schema for `slos.alerting.slowburn`
+
+Read-Only:
+
+- `annotations` (List of Object) (see [below for nested schema](#nestedobjatt--slos--alerting--slowburn--annotations))
+- `labels` (List of Object) (see [below for nested schema](#nestedobjatt--slos--alerting--slowburn--labels))
+
+<a id="nestedobjatt--slos--alerting--slowburn--annotations"></a>
+### Nested Schema for `slos.alerting.slowburn.labels`
+
+Read-Only:
+
+- `key` (String)
+- `value` (String)
+
+
+<a id="nestedobjatt--slos--alerting--slowburn--labels"></a>
+### Nested Schema for `slos.alerting.slowburn.labels`
+
+Read-Only:
+
+- `key` (String)
+- `value` (String)
+
+
+
+
+<a id="nestedobjatt--slos--labels"></a>
+### Nested Schema for `slos.labels`
+
+Read-Only:
+
+- `key` (String)
+- `value` (String)
+
+
+<a id="nestedobjatt--slos--objectives"></a>
+### Nested Schema for `slos.objectives`
+
+Read-Only:
+
+- `objective_value` (Number)
+- `objective_window` (String)
+
+

docs/resources/slo.md

@@ -0,0 +1,183 @@
+---
+# generated by https://github.com/hashicorp/terraform-plugin-docs
+page_title: "grafana_slo Resource - terraform-provider-grafana"
+subcategory: "SLO"
+description: |-
+  Resource manages Grafana SLOs.
+  Official documentation https://grafana.com/docs/grafana-cloud/slo/API documentation https://grafana.com/docs/grafana-cloud/slo/api/
+---
+
+# grafana_slo (Resource)
+
+Resource manages Grafana SLOs. 
+
+* [Official documentation](https://grafana.com/docs/grafana-cloud/slo/)
+* [API documentation](https://grafana.com/docs/grafana-cloud/slo/api/)
+
+## Example Usage
+
+```terraform
+resource "grafana_slo" "test" {
+  name        = "Terraform Testing"
+  description = "Terraform Description"
+  query       = "sum(rate(apiserver_request_total{code!=\"500\"}[$__rate_interval])) / sum(rate(apiserver_request_total[$__rate_interval]))"
+  objectives {
+    objective_value  = 0.995
+    objective_window = "30d"
+  }
+  labels {
+    key   = "custom"
+    value = "value"
+  }
+  alerting {
+    fastburn {
+      annotations {
+        key   = "name"
+        value = "Critical - SLO Burn Rate Alert"
+      }
+      labels {
+        key   = "type"
+        value = "slo"
+      }
+    }
+
+    slowburn {
+      annotations {
+        key   = "name"
+        value = "Warning - SLO Burn Rate Alert"
+      }
+      labels {
+        key   = "type"
+        value = "slo"
+      }
+    }
+  }
+}
+```
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Required
+
+- `description` (String) Description is a free-text field that can provide more context to an SLO.
+- `name` (String) Name should be a short description of your indicator. Consider names like "API Availability"
+- `objectives` (Block List, Min: 1, Max: 1) Over each rolling time window, the remaining error budget will be calculated, and separate alerts can be generated for each time window based on the SLO burn rate or remaining error budget. (see [below for nested schema](#nestedblock--objectives))
+- `query` (String) Query describes the indicator that will be measured against the objective. Freeform Query types are currently supported.
+
+### Optional
+
+- `alerting` (Block List) Configures the alerting rules that will be generated for each
+				time window associated with the SLO. Grafana SLOs can generate
+				alerts when the short-term error budget burn is very high, the
+				long-term error budget burn rate is high, or when the remaining
+				error budget is below a certain threshold. (see [below for nested schema](#nestedblock--alerting))
+- `labels` (Block List) Additional labels that will be attached to all metrics generated from the query. These labels are useful for grouping SLOs in dashboard views that you create by hand. (see [below for nested schema](#nestedblock--labels))
+
+### Read-Only
+
+- `dashboard_uid` (String) A reference to a dashboard that the plugin has installed in Grafana based on this SLO. This field is read-only, it is generated by the Grafana SLO Plugin.
+- `id` (String) The ID of this resource.
+
+<a id="nestedblock--objectives"></a>
+### Nested Schema for `objectives`
+
+Required:
+
+- `objective_value` (Number) Value between 0 and 1. If the value of the query is above the objective, the SLO is met.
+- `objective_window` (String) A Prometheus-parsable time duration string like 24h, 60m. This is the time window the objective is measured over.
+
+
+<a id="nestedblock--alerting"></a>
+### Nested Schema for `alerting`
+
+Optional:
+
+- `annotations` (Block List) Annotations will be attached to all alerts generated by any of these rules. (see [below for nested schema](#nestedblock--alerting--annotations))
+- `fastburn` (Block List) Alerting Rules generated for Fast Burn alerts (see [below for nested schema](#nestedblock--alerting--fastburn))
+- `labels` (Block List) Labels will be attached to all alerts generated by any of these rules. (see [below for nested schema](#nestedblock--alerting--labels))
+- `name` (String)
+- `slowburn` (Block List) Alerting Rules generated for Slow Burn alerts (see [below for nested schema](#nestedblock--alerting--slowburn))
+
+<a id="nestedblock--alerting--annotations"></a>
+### Nested Schema for `alerting.annotations`
+
+Required:
+
+- `key` (String)
+- `value` (String)
+
+
+<a id="nestedblock--alerting--fastburn"></a>
+### Nested Schema for `alerting.fastburn`
+
+Optional:
+
+- `annotations` (Block List) Annotations to attach only to Fast Burn alerts. (see [below for nested schema](#nestedblock--alerting--fastburn--annotations))
+- `labels` (Block List) Labels to attach only to Fast Burn alerts. (see [below for nested schema](#nestedblock--alerting--fastburn--labels))
+
+<a id="nestedblock--alerting--fastburn--annotations"></a>
+### Nested Schema for `alerting.fastburn.annotations`
+
+Required:
+
+- `key` (String)
+- `value` (String)
+
+
+<a id="nestedblock--alerting--fastburn--labels"></a>
+### Nested Schema for `alerting.fastburn.labels`
+
+Required:
+
+- `key` (String)
+- `value` (String)
+
+
+
+<a id="nestedblock--alerting--labels"></a>
+### Nested Schema for `alerting.labels`
+
+Required:
+
+- `key` (String)
+- `value` (String)
+
+
+<a id="nestedblock--alerting--slowburn"></a>
+### Nested Schema for `alerting.slowburn`
+
+Optional:
+
+- `annotations` (Block List) Annotations to attach only to Slow Burn alerts. (see [below for nested schema](#nestedblock--alerting--slowburn--annotations))
+- `labels` (Block List) Labels to attach only to Slow Burn alerts. (see [below for nested schema](#nestedblock--alerting--slowburn--labels))
+
+<a id="nestedblock--alerting--slowburn--annotations"></a>
+### Nested Schema for `alerting.slowburn.annotations`
+
+Required:
+
+- `key` (String)
+- `value` (String)
+
+
+<a id="nestedblock--alerting--slowburn--labels"></a>
+### Nested Schema for `alerting.slowburn.labels`
+
+Required:
+
+- `key` (String)
+- `value` (String)
+
+
+
+
+<a id="nestedblock--labels"></a>
+### Nested Schema for `labels`
+
+Required:
+
+- `key` (String)
+- `value` (String)
+
+

examples/data-sources/grafana_slo/data-source.tf

@@ -0,0 +1 @@
+data "grafana_slo" "slos" {}

examples/resources/grafana_slo/resource.tf

@@ -0,0 +1,36 @@
+resource "grafana_slo" "test" {
+  name        = "Terraform Testing"
+  description = "Terraform Description"
+  query       = "sum(rate(apiserver_request_total{code!=\"500\"}[$__rate_interval])) / sum(rate(apiserver_request_total[$__rate_interval]))"
+  objectives {
+    objective_value  = 0.995
+    objective_window = "30d"
+  }
+  labels {
+    key   = "custom"
+    value = "value"
+  }
+  alerting {
+    fastburn {
+      annotations {
+        key   = "name"
+        value = "Critical - SLO Burn Rate Alert"
+      }
+      labels {
+        key   = "type"
+        value = "slo"
+      }
+    }
+
+    slowburn {
+      annotations {
+        key   = "name"
+        value = "Warning - SLO Burn Rate Alert"
+      }
+      labels {
+        key   = "type"
+        value = "slo"
+      }
+    }
+  }
+}