feat(cloud_stack): add cloud_provider_url, connections_api_url, and sm_url outputs

Duologic · Duologic · commit 2b0729c671bc · 2026-04-10T20:10:54.000+02:00
Add computed URL attributes to the grafana_cloud_stack resource and data
source so users can wire them directly to the provider config without
manual URL construction:

- cloud_provider_url: derived from cluster_slug
- connections_api_url: derived from cluster_slug
- sm_url: read from GCOM API (RegionSyntheticMonitoringApiUrl)

Update provider docs to show the Terraform-native approach and remove
the manual curl/jq alternatives.
diff --git a/docs/data-sources/cloud_stack.md b/docs/data-sources/cloud_stack.md
@@ -40,8 +40,10 @@ available at “https://<stack_slug>.grafana.net".
 - `alertmanager_status` (String) Status of the Alertmanager instance configured for this stack.
 - `alertmanager_url` (String) Base URL of the Alertmanager instance configured for this stack.
 - `alertmanager_user_id` (Number) User ID of the Alertmanager instance configured for this stack.
+- `cloud_provider_url` (String) Base URL of the Cloud Provider API for this stack's cluster. This can be used with the `cloud_provider_url` provider config option to manage Cloud Provider resources for this stack.
 - `cluster_name` (String) Name of the cluster where this stack resides.
 - `cluster_slug` (String) Slug of the cluster where this stack resides.
+- `connections_api_url` (String) Base URL of the Connections API for this stack's cluster. This can be used with the `connections_api_url` provider config option to manage Connections resources for this stack.
 - `delete_protection` (Boolean) Whether to enable delete protection for the stack, preventing accidental deletion.
 - `description` (String) Description of stack.
 - `fleet_management_name` (String) Name of the Fleet Management instance configured for this stack.
@@ -121,6 +123,7 @@ available at “https://<stack_slug>.grafana.net".
 - `prometheus_url` (String) Prometheus url for this instance.
 - `prometheus_user_id` (Number) Prometheus user ID. Used for e.g. remote_write.
 - `region_slug` (String) The region this stack is deployed to.
+- `sm_url` (String) Base URL of the Synthetic Monitoring API for this stack's region. This can be used with the `sm_url` provider config option. Note: Synthetic Monitoring requires activation either via the `grafana_synthetic_monitoring_installation` resource or manually in the Grafana Cloud UI before it can be used.
 - `status` (String) Status of the stack.
 - `traces_ip_allow_list_cname` (String) Comma-separated list of CNAMEs that can be whitelisted to access the Traces instance (Optional)
 - `traces_name` (String)
diff --git a/docs/index.md b/docs/index.md
@@ -161,6 +161,18 @@ data "grafana_synthetic_monitoring_probes" "main" {
 }
 ```
 
+The Synthetic Monitoring API URL for a stack's region is available as an output of the `grafana_cloud_stack` resource or data source via the `sm_url` attribute. This can be used with the `sm_url` provider config option:
+
+```hcl
+provider "grafana" {
+  alias           = "sm"
+  sm_access_token = grafana_synthetic_monitoring_installation.sm_stack.sm_access_token
+  sm_url          = grafana_cloud_stack.my_stack.sm_url
+}
+```
+
+~> **Note:** Synthetic Monitoring must be activated before it can be used. Use the `grafana_synthetic_monitoring_installation` resource or activate it manually in the Grafana Cloud UI.
+
 ### Managing Grafana OnCall
 
 Note that you may need to set the `oncall_api_url` in the provider block
@@ -343,35 +355,12 @@ the in-screen instructions, of following [this guide](https://grafana.com/docs/g
 
 #### Obtaining Cloud Provider API hostname
 
-Having created the token, we can find the correct Cloud Provider API hostname by running the following script, that requires `curl` and [`jq`](https://jqlang.org/) installed:
-
-```bash
-curl -sH "Authorization: Bearer <Access Token from previous step>" "https://grafana.com/api/instances" | \
-  jq '[.items[]|{stackName: .slug, clusterName:.clusterSlug, cloudProviderAPIURL: "https://cloud-provider-api-\(.clusterSlug).grafana.net"}]'
-```
-
-This script will return a list of all the Grafana Cloud stacks you own, with the Cloud Provider API hostname for each one. Choose the correct hostname for the stack you want to manage.
-For example, in the following response, the correct hostname for the `herokublogpost` stack is `https://cloud-provider-api-prod-us-central-0.grafana.net`.
-
-```json
-[
-  {
-    "stackName": "herokublogpost",
-    "clusterName": "prod-us-central-0",
-    "cloudProviderAPIURL": "https://cloud-provider-api-prod-us-central-0.grafana.net"
-  }
-]
-```
-
-#### Configuring the Provider to use the Cloud Provider API
-
-Once you have the token and Cloud Provider API hostanme, you can configure the provider as follows:
+The Cloud Provider API URL is available as an output of the `grafana_cloud_stack` resource or data source via the `cloud_provider_url` attribute:
 
 ```hcl
 provider "grafana" {
-  // ...
-  cloud_provider_url = <Cloud Provider API URL from previous step>
-  cloud_provider_access_token = <Access Token from previous step>
+  cloud_provider_url          = grafana_cloud_stack.my_stack.cloud_provider_url
+  cloud_provider_access_token = "<Access Token from previous step>"
 }
 ```
 
@@ -476,33 +465,11 @@ the in-screen instructions, of following [this guide](https://grafana.com/docs/g
 
 #### Obtaining Connections API hostname
 
-Having created the token, we can find the correct Connections API hostname by running the following script, that requires `curl` and [`jq`](https://jqlang.org/) installed:
-
-```bash
-curl -sH "Authorization: Bearer <Access Token from previous step>" "https://grafana.com/api/instances" | \
-  jq '[.items[]|{stackName: .slug, clusterName:.clusterSlug, connectionsAPIURL: "https://connections-api-\(.clusterSlug).grafana.net"}]'
-```
-
-This script will return a list of all the Grafana Cloud stacks you own, with the Connections API hostname for each one. Choose the correct hostname for the stack you want to manage.
-For example, in the following response, the correct hostname for the `examplestackname` stack is `https://connections-api-prod-eu-west-0.grafana.net`.
-
-```json
-[
-  {
-    "stackName": "examplestackname",
-    "clusterName": "prod-eu-west-0",
-    "connectionsAPIURL": "https://connections-api-prod-eu-west-0.grafana.net"
-  }
-]
-```
-
-#### Configuring the Provider to use the Connections API
-
-Once you have the token and Connections API hostname, you can configure the provider as follows:
+The Connections API URL is available as an output of the `grafana_cloud_stack` resource or data source via the `connections_api_url` attribute:
 
 ```hcl
 provider "grafana" {
-  connections_api_url          = "<Connections API URL from previous step>"
+  connections_api_url          = grafana_cloud_stack.my_stack.connections_api_url
   connections_api_access_token = "<Access Token from previous step>"
 }
 ```
diff --git a/docs/resources/cloud_stack.md b/docs/resources/cloud_stack.md
@@ -54,8 +54,10 @@ resource "grafana_cloud_stack" "test" {
 - `alertmanager_status` (String) Status of the Alertmanager instance configured for this stack.
 - `alertmanager_url` (String) Base URL of the Alertmanager instance configured for this stack.
 - `alertmanager_user_id` (Number) User ID of the Alertmanager instance configured for this stack.
+- `cloud_provider_url` (String) Base URL of the Cloud Provider API for this stack's cluster. This can be used with the `cloud_provider_url` provider config option to manage Cloud Provider resources for this stack.
 - `cluster_name` (String) Name of the cluster where this stack resides.
 - `cluster_slug` (String) Slug of the cluster where this stack resides.
+- `connections_api_url` (String) Base URL of the Connections API for this stack's cluster. This can be used with the `connections_api_url` provider config option to manage Connections resources for this stack.
 - `fleet_management_name` (String) Name of the Fleet Management instance configured for this stack.
 - `fleet_management_private_connectivity_info_availability_zone_ids` (List of String) Availability Zone IDs for Fleet Management when using AWS PrivateLink (only for AWS stacks)
 - `fleet_management_private_connectivity_info_availability_zones` (List of String) Availability Zones for Fleet Management when using AWS PrivateLink (only for AWS stacks)
@@ -130,6 +132,7 @@ resource "grafana_cloud_stack" "test" {
 - `prometheus_status` (String) Prometheus status for this instance.
 - `prometheus_url` (String) Prometheus url for this instance.
 - `prometheus_user_id` (Number) Prometheus user ID. Used for e.g. remote_write.
+- `sm_url` (String) Base URL of the Synthetic Monitoring API for this stack's region. This can be used with the `sm_url` provider config option. Note: Synthetic Monitoring requires activation either via the `grafana_synthetic_monitoring_installation` resource or manually in the Grafana Cloud UI before it can be used.
 - `status` (String) Status of the stack.
 - `traces_ip_allow_list_cname` (String) Comma-separated list of CNAMEs that can be whitelisted to access the Traces instance (Optional)
 - `traces_name` (String)
diff --git a/internal/resources/cloud/data_source_cloud_stack_test.go b/internal/resources/cloud/data_source_cloud_stack_test.go
@@ -36,6 +36,9 @@ func TestAccDataSourceStack_Basic(t *testing.T) {
 					resource.TestCheckResourceAttrSet("data.grafana_cloud_stack.test", "prometheus_user_id"),
 					resource.TestCheckResourceAttrSet("data.grafana_cloud_stack.test", "alertmanager_user_id"),
 					resource.TestCheckResourceAttrSet("data.grafana_cloud_stack.test", "cluster_slug"),
+					resource.TestCheckResourceAttrSet("data.grafana_cloud_stack.test", "cloud_provider_url"),
+					resource.TestCheckResourceAttrSet("data.grafana_cloud_stack.test", "connections_api_url"),
+					resource.TestCheckResourceAttrSet("data.grafana_cloud_stack.test", "sm_url"),
 					resource.TestCheckResourceAttrSet("data.grafana_cloud_stack.test", "fleet_management_user_id"),
 					resource.TestCheckResourceAttrSet("data.grafana_cloud_stack.test", "fleet_management_name"),
 					resource.TestCheckResourceAttrSet("data.grafana_cloud_stack.test", "fleet_management_url"),
diff --git a/internal/resources/cloud/resource_cloud_stack.go b/internal/resources/cloud/resource_cloud_stack.go
@@ -196,6 +196,9 @@ Required access policy scopes:
 			"alertmanager_status":              common.ComputedStringWithDescription("Status of the Alertmanager instance configured for this stack."),
 			"alertmanager_ip_allow_list_cname": ipAllowListCNAMEDescription("the Alertmanager instances"),
 
+			// Synthetic Monitoring
+			"sm_url": common.ComputedStringWithDescription("Base URL of the Synthetic Monitoring API for this stack's region. This can be used with the `sm_url` provider config option. Note: Synthetic Monitoring requires activation either via the `grafana_synthetic_monitoring_installation` resource or manually in the Grafana Cloud UI before it can be used."),
+
 			// OnCall
 			"oncall_api_url": common.ComputedStringWithDescription("Base URL of the OnCall API instance configured for this stack."),
 
@@ -258,9 +261,13 @@ Required access policy scopes:
 			"fleet_management_private_connectivity_info_availability_zones":    privateConnectivityArrayDescription("Availability Zones", "Fleet Management"),
 			"fleet_management_private_connectivity_info_availability_zone_ids": privateConnectivityArrayDescription("Availability Zone IDs", "Fleet Management"),
 
+			// Cloud Provider
+			"cloud_provider_url": common.ComputedStringWithDescription("Base URL of the Cloud Provider API for this stack's cluster. This can be used with the `cloud_provider_url` provider config option to manage Cloud Provider resources for this stack."),
+
 			// Connections
-			"influx_url": common.ComputedStringWithDescription("Base URL of the InfluxDB instance configured for this stack. The username is the same as the metrics' (`prometheus_user_id` attribute of this resource). See https://grafana.com/docs/grafana-cloud/send-data/metrics/metrics-influxdb/push-from-telegraf/ for docs on how to use this."),
-			"otlp_url":   common.ComputedStringWithDescription("Base URL of the OTLP instance configured for this stack. The username is the stack's ID (`id` attribute of this resource). See https://grafana.com/docs/grafana-cloud/send-data/otlp/send-data-otlp/ for docs on how to use this."),
+			"connections_api_url": common.ComputedStringWithDescription("Base URL of the Connections API for this stack's cluster. This can be used with the `connections_api_url` provider config option to manage Connections resources for this stack."),
+			"influx_url":          common.ComputedStringWithDescription("Base URL of the InfluxDB instance configured for this stack. The username is the same as the metrics' (`prometheus_user_id` attribute of this resource). See https://grafana.com/docs/grafana-cloud/send-data/metrics/metrics-influxdb/push-from-telegraf/ for docs on how to use this."),
+			"otlp_url":            common.ComputedStringWithDescription("Base URL of the OTLP instance configured for this stack. The username is the stack's ID (`id` attribute of this resource). See https://grafana.com/docs/grafana-cloud/send-data/otlp/send-data-otlp/ for docs on how to use this."),
 			"otlp_private_connectivity_info_private_dns":           privateConnectivityDescription("Private DNS", "OTLP"),
 			"otlp_private_connectivity_info_service_name":          privateConnectivityDescription("Service Name", "OTLP"),
 			"otlp_private_connectivity_info_regions":               privateConnectivityArrayDescription("Regions", "OTLP"),
@@ -565,6 +572,8 @@ func flattenStack(d *schema.ResourceData, stack *gcom.FormattedApiInstance, conn
 		addIPAllowListIfPresent(d, "alertmanager", tenant)
 	})
 
+	d.Set("sm_url", stack.RegionSyntheticMonitoringApiUrl)
+
 	if oncallURL := connections.OncallApiUrl; oncallURL.IsSet() {
 		d.Set("oncall_api_url", oncallURL.Get())
 	}
@@ -624,6 +633,9 @@ func flattenStack(d *schema.ResourceData, stack *gcom.FormattedApiInstance, conn
 		d.Set("influx_url", influxURL.Get())
 	}
 
+	d.Set("cloud_provider_url", fmt.Sprintf("https://cloud-provider-api-%s.grafana.net", stack.ClusterSlug))
+	d.Set("connections_api_url", fmt.Sprintf("https://connections-api-%s.grafana.net", stack.ClusterSlug))
+
 	return nil
 }
 
diff --git a/internal/resources/cloud/resource_cloud_stack_test.go b/internal/resources/cloud/resource_cloud_stack_test.go
@@ -94,6 +94,10 @@ func TestResourceStack_Basic(t *testing.T) {
 		resource.TestCheckResourceAttrSet("grafana_cloud_stack.test", "otlp_private_connectivity_info_availability_zones"),
 		resource.TestCheckResourceAttrSet("grafana_cloud_stack.test", "otlp_private_connectivity_info_availability_zone_ids"),
 		resource.TestCheckResourceAttrSet("grafana_cloud_stack.test", "influx_url"),
+		resource.TestCheckResourceAttrSet("grafana_cloud_stack.test", "cloud_provider_url"),
+		resource.TestMatchResourceAttr("grafana_cloud_stack.test", "cloud_provider_url", regexp.MustCompile(`^https://cloud-provider-api-.+\.grafana\.net$`)),
+		resource.TestCheckResourceAttrSet("grafana_cloud_stack.test", "connections_api_url"),
+		resource.TestMatchResourceAttr("grafana_cloud_stack.test", "connections_api_url", regexp.MustCompile(`^https://connections-api-.+\.grafana\.net$`)),
 		resource.TestCheckResourceAttrSet("grafana_cloud_stack.test", "cluster_slug"),
 		resource.TestCheckResourceAttrSet("grafana_cloud_stack.test", "cluster_name"),
 		resource.TestCheckResourceAttrSet("grafana_cloud_stack.test", "pdc_api_private_connectivity_info_private_dns"),
@@ -107,6 +111,8 @@ func TestResourceStack_Basic(t *testing.T) {
 		resource.TestCheckResourceAttrSet("grafana_cloud_stack.test", "pdc_gateway_private_connectivity_info_availability_zones"),
 		resource.TestCheckResourceAttrSet("grafana_cloud_stack.test", "pdc_gateway_private_connectivity_info_availability_zone_ids"),
 		resource.TestCheckResourceAttrSet("grafana_cloud_stack.test", "oncall_api_url"),
+		resource.TestCheckResourceAttrSet("grafana_cloud_stack.test", "sm_url"),
+		resource.TestMatchResourceAttr("grafana_cloud_stack.test", "sm_url", regexp.MustCompile(`^https://synthetic-monitoring-api.*\.grafana\.net$`)),
 		resource.TestCheckResourceAttrSet("grafana_cloud_stack.test", "delete_protection"),
 	)
 
diff --git a/templates/index.md.tmpl b/templates/index.md.tmpl
@@ -26,6 +26,18 @@ The changelog for this provider can be found here: <https://github.com/grafana/t
 
 {{ tffile "examples/resources/grafana_synthetic_monitoring_installation/resource.tf" }}
 
+The Synthetic Monitoring API URL for a stack's region is available as an output of the `grafana_cloud_stack` resource or data source via the `sm_url` attribute. This can be used with the `sm_url` provider config option:
+
+```hcl
+provider "grafana" {
+  alias           = "sm"
+  sm_access_token = grafana_synthetic_monitoring_installation.sm_stack.sm_access_token
+  sm_url          = grafana_cloud_stack.my_stack.sm_url
+}
+```
+
+~> **Note:** Synthetic Monitoring must be activated before it can be used. Use the `grafana_synthetic_monitoring_installation` resource or activate it manually in the Grafana Cloud UI.
+
 ### Managing Grafana OnCall
 
 Note that you may need to set the `oncall_api_url` in the provider block
@@ -103,35 +115,12 @@ the in-screen instructions, of following [this guide](https://grafana.com/docs/g
 
 #### Obtaining Cloud Provider API hostname
 
-Having created the token, we can find the correct Cloud Provider API hostname by running the following script, that requires `curl` and [`jq`](https://jqlang.org/) installed:
-
-```bash
-curl -sH "Authorization: Bearer <Access Token from previous step>" "https://grafana.com/api/instances" | \
-  jq '[.items[]|{stackName: .slug, clusterName:.clusterSlug, cloudProviderAPIURL: "https://cloud-provider-api-\(.clusterSlug).grafana.net"}]'
-```
-
-This script will return a list of all the Grafana Cloud stacks you own, with the Cloud Provider API hostname for each one. Choose the correct hostname for the stack you want to manage.
-For example, in the following response, the correct hostname for the `herokublogpost` stack is `https://cloud-provider-api-prod-us-central-0.grafana.net`.
-
-```json
-[
-  {
-    "stackName": "herokublogpost",
-    "clusterName": "prod-us-central-0",
-    "cloudProviderAPIURL": "https://cloud-provider-api-prod-us-central-0.grafana.net"
-  }
-]
-```
-
-#### Configuring the Provider to use the Cloud Provider API
-
-Once you have the token and Cloud Provider API hostanme, you can configure the provider as follows:
+The Cloud Provider API URL is available as an output of the `grafana_cloud_stack` resource or data source via the `cloud_provider_url` attribute:
 
 ```hcl
 provider "grafana" {
-  // ...
-  cloud_provider_url = <Cloud Provider API URL from previous step>
-  cloud_provider_access_token = <Access Token from previous step>
+  cloud_provider_url          = grafana_cloud_stack.my_stack.cloud_provider_url
+  cloud_provider_access_token = "<Access Token from previous step>"
 }
 ```
 
@@ -161,33 +150,11 @@ the in-screen instructions, of following [this guide](https://grafana.com/docs/g
 
 #### Obtaining Connections API hostname
 
-Having created the token, we can find the correct Connections API hostname by running the following script, that requires `curl` and [`jq`](https://jqlang.org/) installed:
-
-```bash
-curl -sH "Authorization: Bearer <Access Token from previous step>" "https://grafana.com/api/instances" | \
-  jq '[.items[]|{stackName: .slug, clusterName:.clusterSlug, connectionsAPIURL: "https://connections-api-\(.clusterSlug).grafana.net"}]'
-```
-
-This script will return a list of all the Grafana Cloud stacks you own, with the Connections API hostname for each one. Choose the correct hostname for the stack you want to manage.
-For example, in the following response, the correct hostname for the `examplestackname` stack is `https://connections-api-prod-eu-west-0.grafana.net`.
-
-```json
-[
-  {
-    "stackName": "examplestackname",
-    "clusterName": "prod-eu-west-0",
-    "connectionsAPIURL": "https://connections-api-prod-eu-west-0.grafana.net"
-  }
-]
-```
-
-#### Configuring the Provider to use the Connections API
-
-Once you have the token and Connections API hostname, you can configure the provider as follows:
+The Connections API URL is available as an output of the `grafana_cloud_stack` resource or data source via the `connections_api_url` attribute:
 
 ```hcl
 provider "grafana" {
-  connections_api_url          = "<Connections API URL from previous step>"
+  connections_api_url          = grafana_cloud_stack.my_stack.connections_api_url
   connections_api_access_token = "<Access Token from previous step>"
 }
 ```
