Grafana Cloud Integrations

docs/resources/integration.md

@@ -0,0 +1,123 @@
+---
+# generated by https://github.com/hashicorp/terraform-plugin-docs
+page_title: "grafana_integration Resource - terraform-provider-grafana"
+subcategory: "Cloud"
+description: |-
+  Manages Grafana Cloud integrations.
+  Official documentation https://grafana.com/docs/grafana-cloud/data-configuration/integrations/
+  Required access policy scopes:
+  folders:readfolders:writedashboards:readdashboards:write
+  Note: This resource creates folders and dashboards as part of the integration installation process, which requires additional permissions beyond the basic integration scopes.
+---
+
+# grafana_integration (Resource)
+
+Manages Grafana Cloud integrations.
+
+* [Official documentation](https://grafana.com/docs/grafana-cloud/data-configuration/integrations/)
+
+Required access policy scopes:
+
+* folders:read
+* folders:write
+* dashboards:read
+* dashboards:write
+
+**Note:** This resource creates folders and dashboards as part of the integration installation process, which requires additional permissions beyond the basic integration scopes.
+
+## Example Usage
+
+```terraform
+# Install Docker integration with logs and alerts enabled
+resource "grafana_integration" "docker" {
+  slug = "docker"
+
+  configuration {
+    configurable_logs {
+      logs_disabled = false
+    }
+    configurable_alerts {
+      alerts_disabled = false
+    }
+  }
+}
+
+# Install Linux Node integration with logs enabled but alerts disabled
+resource "grafana_integration" "linux_node" {
+  slug = "linux-node"
+
+  configuration {
+    configurable_logs {
+      logs_disabled = false
+    }
+    configurable_alerts {
+      alerts_disabled = true
+    }
+  }
+}
+
+# Install Windows integration with minimal configuration
+resource "grafana_integration" "windows" {
+  slug = "windows-exporter"
+}
+
+# Output integration information
+output "docker_integration" {
+  value = {
+    name              = grafana_integration.docker.name
+    version           = grafana_integration.docker.version
+    installed         = grafana_integration.docker.installed
+    dashboard_folder  = grafana_integration.docker.dashboard_folder
+  }
+}
+```
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Required
+
+- `slug` (String) The slug of the integration to install (e.g., 'docker', 'linux-node').
+
+### Optional
+
+- `configuration` (Block List, Max: 1) Configuration options for the integration. (see [below for nested schema](#nestedblock--configuration))
+
+### Read-Only
+
+- `dashboard_folder` (String) The dashboard folder associated with this integration.
+- `id` (String) The ID of this resource.
+- `installed` (Boolean) Whether the integration is currently installed.
+- `name` (String) The display name of the integration.
+- `version` (String) The version of the installed integration.
+
+<a id="nestedblock--configuration"></a>
+### Nested Schema for `configuration`
+
+Optional:
+
+- `configurable_alerts` (Block List, Max: 1) Alerts configuration for the integration. (see [below for nested schema](#nestedblock--configuration--configurable_alerts))
+- `configurable_logs` (Block List, Max: 1) Logs configuration for the integration. (see [below for nested schema](#nestedblock--configuration--configurable_logs))
+
+<a id="nestedblock--configuration--configurable_alerts"></a>
+### Nested Schema for `configuration.configurable_alerts`
+
+Optional:
+
+- `alerts_disabled` (Boolean) Whether to disable alerts for this integration. Defaults to `false`.
+
+
+<a id="nestedblock--configuration--configurable_logs"></a>
+### Nested Schema for `configuration.configurable_logs`
+
+Optional:
+
+- `logs_disabled` (Boolean) Whether to disable logs collection for this integration. Defaults to `false`.
+
+## Import
+
+Import is supported using the following syntax:
+
+```shell
+terraform import grafana_integration.name "{{ slug }}"
+```

examples/resources/grafana_integration/import.sh

@@ -0,0 +1 @@
+terraform import grafana_integration.name "{{ slug }}"

examples/resources/grafana_integration/resource.tf

@@ -0,0 +1,42 @@
+# Install Docker integration with logs and alerts enabled
+resource "grafana_integration" "docker" {
+  slug = "docker"
+
+  configuration {
+    configurable_logs {
+      logs_disabled = false
+    }
+    configurable_alerts {
+      alerts_disabled = false
+    }
+  }
+}
+
+# Install Linux Node integration with logs enabled but alerts disabled
+resource "grafana_integration" "linux_node" {
+  slug = "linux-node"
+
+  configuration {
+    configurable_logs {
+      logs_disabled = false
+    }
+    configurable_alerts {
+      alerts_disabled = true
+    }
+  }
+}
+
+# Install Windows integration with minimal configuration
+resource "grafana_integration" "windows" {
+  slug = "windows-exporter"
+}
+
+# Output integration information
+output "docker_integration" {
+  value = {
+    name              = grafana_integration.docker.name
+    version           = grafana_integration.docker.version
+    installed         = grafana_integration.docker.installed
+    dashboard_folder  = grafana_integration.docker.dashboard_folder
+  }
+}

internal/common/resource.go

@@ -27,6 +27,7 @@ var (
 	CategoryFleetManagement     ResourceCategory = "Fleet Management"
 	CategoryFrontendO11y        ResourceCategory = "Frontend Observability"
 	CategoryK6                  ResourceCategory = "k6"
+	CategoryIntegration         ResourceCategory = "Integration"
 )
 
 type ResourceCommon struct {