From ee85017b7556ba4ccaa66594138392dc4440cf8b Mon Sep 17 00:00:00 2001
From: Clayton Cornell <clayton.cornell@grafana.com>
Date: Thu, 30 Jul 2026 12:41:43 -0700
Subject: [PATCH 01/10] Clean up topic and add exported fields

---
 .../database_observability.mysql.md           | 19 ++++++++++++++-----
 1 file changed, 14 insertions(+), 5 deletions(-)

diff --git a/docs/sources/reference/components/database_observability/database_observability.mysql.md b/docs/sources/reference/components/database_observability/database_observability.mysql.md
index bc5083ad3e0..5f35e1f2ed2 100644
--- a/docs/sources/reference/components/database_observability/database_observability.mysql.md
+++ b/docs/sources/reference/components/database_observability/database_observability.mysql.md
@@ -6,6 +6,7 @@ labels:
   stage: general-availability
   products:
     - oss
+review_date: 2026-07-30
 ---
 
 # `database_observability.mysql`
@@ -35,7 +36,7 @@ You can use the following arguments with `database_observability.mysql`:
 | `disable_collectors`                       | `list(string)`       | A list of collectors to disable from the default set.                       |         | no       |
 | `enable_collectors`                        | `list(string)`       | A list of collectors to enable on top of the default set.                   |         | no       |
 | `exclude_schemas`                          | `list(string)`       | A list of schemas to exclude from monitoring.                               | `["alloydbadmin", "alloydbmetadata", "azure_maintenance", "azure_sys", "cloudsqladmin", "rdsadmin"]` | no       |
-| `allow_update_performance_schema_settings` | `boolean`            | Whether to allow updates to `performance_schema` settings in any collector. Enable this in conjunction with other collector-specific settings where required. | `false` | no       |
+| `allow_update_performance_schema_settings` | `bool`               | Whether to allow updates to `performance_schema` settings in any collector. Enable this in conjunction with other collector-specific settings where required. | `false` | no       |
 
 The following collectors are configurable:
 
@@ -143,7 +144,7 @@ The `gcp` block supplies the identifying information for the GCP Cloud SQL datab
 | Name               | Type       | Description                                                 | Default | Required |
 |--------------------|------------|-------------------------------------------------------------|---------|----------|
 | `collect_interval` | `duration` | How frequently to collect information from database.        | `"1m"`  | no       |
-| `cache_enabled`    | `boolean`  | Deprecated. Whether to enable caching of table definitions. | `true`  | no       |
+| `cache_enabled`    | `bool`     | Deprecated. Whether to enable caching of table definitions. | `true`  | no       |
 | `cache_size`       | `integer`  | Deprecated. Cache size.                                     | `256`   | no       |
 | `cache_ttl`        | `duration` | Deprecated. Cache TTL.                                      | `"10m"` | no       |
 
@@ -170,17 +171,17 @@ The `cache_enabled`, `cache_size`, and `cache_ttl` settings are deprecated: they
 |----------------------------------|------------|--------------------------------------------------------------------------------|---------|----------|
 | `collect_interval`               | `duration` | How frequently to collect information from database.                           | `"10s"` | no       |
 | `disable_query_redaction`        | `bool`     | Collect unredacted SQL query text (including query parameters) and query error messages. | `false` | no       |
-| `auto_enable_setup_consumers`    | `boolean`  | Enables specific `performance_schema.setup_consumers` options. You must also enable `allow_update_performance_schema_settings`. | `false` | no       |
+| `auto_enable_setup_consumers`    | `bool`     | Enables specific `performance_schema.setup_consumers` options. You must also enable `allow_update_performance_schema_settings`. | `false` | no       |
 | `setup_consumers_check_interval` | `duration` | How frequently to check if `setup_consumers` are correctly enabled.            | `"1h"`  | no       |
 | `sample_min_duration`            | `duration` | Minimum duration for query samples to be collected. Set to "0s" to disable filtering and collect all samples regardless of their duration.| `"0s"`  | no       |
 | `wait_event_min_duration`        | `duration` | Minimum duration for a wait event to be collected. Set to "0s" to disable filtering and collect all wait events regardless of their duration.  | `"1us"` | no       |
-| `enable_pre_classified_wait_events` | `boolean` | When `true`, emits telemetry data with pre-classified wait event information. | `false` | no       |
+| `enable_pre_classified_wait_events` | `bool`    | When `true`, emits telemetry data with pre-classified wait event information. | `false` | no       |
 
 ### `setup_actors`
 
 | Name                       | Type       | Description                                                            | Default | Required |
 | -------------------------- | ---------- | ---------------------------------------------------------------------- | ------- | -------- |
-| `auto_update_setup_actors` | `boolean`  | Enables updates to `performance_schema.setup_actors` settings. You must also enable `allow_update_performance_schema_settings`.| `false` | no       |
+| `auto_update_setup_actors` | `bool`     | Enables updates to `performance_schema.setup_actors` settings. You must also enable `allow_update_performance_schema_settings`.| `false` | no       |
 | `collect_interval`         | `duration` | How frequently to check if `setup_actors` are configured correctly.    | `"1h"`  | no       |
 
 
@@ -197,6 +198,14 @@ The `data_source_name` is inherited from the parent block.
 
 Refer to [`prometheus.exporter.mysql`](../../prometheus/prometheus.exporter.mysql/) docs for the full list of supported arguments and sub-blocks.
 
+## Exported fields
+
+The following fields are exported and can be referenced by other components.
+
+| Name      | Type                | Description                                                                         |
+|-----------|---------------------|-------------------------------------------------------------------------------------|
+| `targets` | `list(map(string))` | The targets that can be used to collect metrics of instrumented services with Prometheus scraping. |
+
 ## Example
 
 ```alloy

From 13baaf8025d63004b8bec71969d571cd0260c381 Mon Sep 17 00:00:00 2001
From: Clayton Cornell <clayton.cornell@grafana.com>
Date: Thu, 30 Jul 2026 12:48:16 -0700
Subject: [PATCH 02/10] Strip the big example out of topic

---
 .../database_observability.mysql.md           | 75 +++----------------
 1 file changed, 9 insertions(+), 66 deletions(-)

diff --git a/docs/sources/reference/components/database_observability/database_observability.mysql.md b/docs/sources/reference/components/database_observability/database_observability.mysql.md
index 5f35e1f2ed2..6659f41227e 100644
--- a/docs/sources/reference/components/database_observability/database_observability.mysql.md
+++ b/docs/sources/reference/components/database_observability/database_observability.mysql.md
@@ -209,72 +209,15 @@ The following fields are exported and can be referenced by other components.
 ## Example
 
 ```alloy
-database_observability.mysql "orders_db" {
-  data_source_name = "user:pass@tcp(mysql:3306)/"
-  forward_to       = [loki.relabel.orders_db.receiver]
-  targets          = prometheus.exporter.mysql.orders_db.targets
+database_observability.mysql "<LABEL>" {
+  data_source_name = "<DATA_SOURCE_NAME>"
+  forward_to       = [loki.relabel.<LABEL>.receiver]
 
   enable_collectors = ["query_samples", "explain_plans"]
 
   cloud_provider {
     aws {
-      arn = "your-rds-db-arn"
-    }
-  }
-}
-
-prometheus.exporter.mysql "orders_db" {
-  data_source_name  = "user:pass@tcp(mysql:3306)/"
-  enable_collectors = ["perf_schema.eventsstatements"]
-}
-
-loki.relabel "orders_db" {
-  forward_to = [loki.write.logs_service.receiver]
-  rule {
-    target_label = "job"
-    replacement  = "integrations/db-o11y"
-  }
-  rule {
-    target_label = "instance"
-    replacement  = "orders_db"
-  }
-}
-
-discovery.relabel "orders_db" {
-  targets = database_observability.mysql.orders_db.targets
-
-  rule {
-    target_label = "job"
-    replacement  = "integrations/db-o11y"
-  }
-  rule {
-    target_label = "instance"
-    replacement  = "orders_db"
-  }
-}
-
-prometheus.scrape "orders_db" {
-  targets    = discovery.relabel.orders_db.targets
-  job_name   = "integrations/db-o11y"
-  forward_to = [prometheus.remote_write.metrics_service.receiver]
-}
-
-prometheus.remote_write "metrics_service" {
-  endpoint {
-    url = sys.env("<GRAFANA_CLOUD_HOSTED_METRICS_URL>")
-    basic_auth {
-      username = sys.env("<GRAFANA_CLOUD_HOSTED_METRICS_ID>")
-      password = sys.env("<GRAFANA_CLOUD_RW_API_KEY>")
-    }
-  }
-}
-
-loki.write "logs_service" {
-  endpoint {
-    url = sys.env("<GRAFANA_CLOUD_HOSTED_LOGS_URL>")
-    basic_auth {
-      username = sys.env("<GRAFANA_CLOUD_HOSTED_LOGS_ID>")
-      password = sys.env("<GRAFANA_CLOUD_RW_API_KEY>")
+      arn = "<AWS_RDS_ARN>"
     }
   }
 }
@@ -282,11 +225,11 @@ loki.write "logs_service" {
 
 Replace the following:
 
-* _`<GRAFANA_CLOUD_HOSTED_METRICS_URL>`_: The URL for your Grafana Cloud hosted metrics.
-* _`<GRAFANA_CLOUD_HOSTED_METRICS_ID>`_: The user ID for your Grafana Cloud hosted metrics.
-* _`<GRAFANA_CLOUD_RW_API_KEY>`_: Your Grafana Cloud API key.
-* _`<GRAFANA_CLOUD_HOSTED_LOGS_URL>`_: The URL for your Grafana Cloud hosted logs.
-* _`<GRAFANA_CLOUD_HOSTED_LOGS_ID>`_: The user ID for your Grafana Cloud hosted logs.
+* _`<LABEL>`_: The Alloy component label (for example, `prod-mysql`).
+* _`<DATA_SOURCE_NAME>`_: The MySQL connection [Data Source Name] (for example, `user:pass@tcp(mysql:3306)/`).
+* _`<AWS_RDS_ARN>`_: The ARN of your AWS RDS database (for example, `arn:aws:rds:us-east-1:123456789:db/prod-mysql`).
+
+For a complete end-to-end example that demonstrates sending database observability metrics to Grafana Cloud, refer to the [`collect-mysql-database-metrics`](../../../tasks/collect/collect-mysql-database-metrics/) task topic.
 
 [Data Source Name]: https://github.com/go-sql-driver/mysql#dsn-data-source-name
 

From 4f6f28000641bfc974b3b294e3cdf02bbf57c955 Mon Sep 17 00:00:00 2001
From: Clayton Cornell <clayton.cornell@grafana.com>
Date: Thu, 30 Jul 2026 12:48:35 -0700
Subject: [PATCH 03/10] Add the skeleton task topic

---
 .../collect/collect-mysql-database-metrics.md | 92 +++++++++++++++++++
 1 file changed, 92 insertions(+)
 create mode 100644 docs/sources/tasks/collect/collect-mysql-database-metrics.md

diff --git a/docs/sources/tasks/collect/collect-mysql-database-metrics.md b/docs/sources/tasks/collect/collect-mysql-database-metrics.md
new file mode 100644
index 00000000000..c196a0bc607
--- /dev/null
+++ b/docs/sources/tasks/collect/collect-mysql-database-metrics.md
@@ -0,0 +1,92 @@
+---
+canonical: https://grafana.com/docs/alloy/latest/tasks/collect/collect-mysql-database-metrics/
+description: Learn how to collect MySQL database metrics and logs with Grafana Alloy.
+title: Collect MySQL database metrics and logs
+labels:
+  stage: experimental
+---
+
+# Collect MySQL database metrics and logs
+
+[SCAFFOLD PLACEHOLDER: This topic is a scaffold. The following example is complete and functional, but narrative explanation and step-by-step guidance are pending. See the `develop-task-topic` skill for the next step in completing this scaffold.]
+
+```alloy
+// MySQL database observability with Loki and Prometheus
+database_observability.mysql "example" {
+  data_source_name = "user:pass@tcp(mysql:3306)/"
+  forward_to       = [loki.relabel.example.receiver]
+  targets          = prometheus.exporter.mysql.example.targets
+
+  enable_collectors = ["query_samples", "explain_plans"]
+
+  cloud_provider {
+    aws {
+      arn = "your-rds-db-arn"
+    }
+  }
+}
+
+prometheus.exporter.mysql "example" {
+  data_source_name  = "user:pass@tcp(mysql:3306)/"
+  enable_collectors = ["perf_schema.eventsstatements"]
+}
+
+loki.relabel "example" {
+  forward_to = [loki.write.logs_service.receiver]
+  rule {
+    target_label = "job"
+    replacement  = "integrations/db-o11y"
+  }
+  rule {
+    target_label = "instance"
+    replacement  = "example"
+  }
+}
+
+discovery.relabel "example" {
+  targets = database_observability.mysql.example.targets
+
+  rule {
+    target_label = "job"
+    replacement  = "integrations/db-o11y"
+  }
+  rule {
+    target_label = "instance"
+    replacement  = "example"
+  }
+}
+
+prometheus.scrape "example" {
+  targets    = discovery.relabel.example.targets
+  job_name   = "integrations/db-o11y"
+  forward_to = [prometheus.remote_write.metrics_service.receiver]
+}
+
+prometheus.remote_write "metrics_service" {
+  endpoint {
+    url = sys.env("<GRAFANA_CLOUD_HOSTED_METRICS_URL>")
+    basic_auth {
+      username = sys.env("<GRAFANA_CLOUD_HOSTED_METRICS_ID>")
+      password = sys.env("<GRAFANA_CLOUD_RW_API_KEY>")
+    }
+  }
+}
+
+loki.write "logs_service" {
+  endpoint {
+    url = sys.env("<GRAFANA_CLOUD_HOSTED_LOGS_URL>")
+    basic_auth {
+      username = sys.env("<GRAFANA_CLOUD_HOSTED_LOGS_ID>")
+      password = sys.env("<GRAFANA_CLOUD_RW_API_KEY>")
+    }
+  }
+}
+```
+
+Replace the following:
+
+* _`<GRAFANA_CLOUD_HOSTED_METRICS_URL>`_: The URL for your Grafana Cloud hosted metrics.
+* _`<GRAFANA_CLOUD_HOSTED_METRICS_ID>`_: The user ID for your Grafana Cloud hosted metrics.
+* _`<GRAFANA_CLOUD_RW_API_KEY>`_: Your Grafana Cloud API key.
+* _`<GRAFANA_CLOUD_HOSTED_LOGS_URL>`_: The URL for your Grafana Cloud hosted logs.
+* _`<GRAFANA_CLOUD_HOSTED_LOGS_ID>`_: The user ID for your Grafana Cloud hosted logs.

From f8c7caca9bd9e55e605701d10ca60f5c66aa932d Mon Sep 17 00:00:00 2001
From: Clayton Cornell <clayton.cornell@grafana.com>
Date: Thu, 30 Jul 2026 12:55:50 -0700
Subject: [PATCH 04/10] Correct filename and location

---
 .../mysql-database-metrics.md}                                  | 2 +-
 .../database_observability/database_observability.mysql.md      | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)
 rename docs/sources/{tasks/collect/collect-mysql-database-metrics.md => collect/mysql-database-metrics.md} (96%)

diff --git a/docs/sources/tasks/collect/collect-mysql-database-metrics.md b/docs/sources/collect/mysql-database-metrics.md
similarity index 96%
rename from docs/sources/tasks/collect/collect-mysql-database-metrics.md
rename to docs/sources/collect/mysql-database-metrics.md
index c196a0bc607..74e7e426a23 100644
--- a/docs/sources/tasks/collect/collect-mysql-database-metrics.md
+++ b/docs/sources/collect/mysql-database-metrics.md
@@ -1,5 +1,5 @@
 ---
-canonical: https://grafana.com/docs/alloy/latest/tasks/collect/collect-mysql-database-metrics/
+canonical: https://grafana.com/docs/alloy/latest/collect/mysql-database-metrics/
 description: Learn how to collect MySQL database metrics and logs with Grafana Alloy.
 title: Collect MySQL database metrics and logs
 labels:
diff --git a/docs/sources/reference/components/database_observability/database_observability.mysql.md b/docs/sources/reference/components/database_observability/database_observability.mysql.md
index 6659f41227e..3cdb58afaab 100644
--- a/docs/sources/reference/components/database_observability/database_observability.mysql.md
+++ b/docs/sources/reference/components/database_observability/database_observability.mysql.md
@@ -229,7 +229,7 @@ Replace the following:
 * _`<DATA_SOURCE_NAME>`_: The MySQL connection [Data Source Name] (for example, `user:pass@tcp(mysql:3306)/`).
 * _`<AWS_RDS_ARN>`_: The ARN of your AWS RDS database (for example, `arn:aws:rds:us-east-1:123456789:db/prod-mysql`).
 
-For a complete end-to-end example that demonstrates sending database observability metrics to Grafana Cloud, refer to the [`collect-mysql-database-metrics`](../../../tasks/collect/collect-mysql-database-metrics/) task topic.
+For a complete end-to-end example that demonstrates sending database observability metrics to Grafana Cloud, refer to the [`mysql-database-metrics`](../../../collect/mysql-database-metrics/) task topic.
 
 [Data Source Name]: https://github.com/go-sql-driver/mysql#dsn-data-source-name
 

From 69d3564f875c5e47632a9ed5c8a7a3d2d344ff59 Mon Sep 17 00:00:00 2001
From: Clayton Cornell <clayton.cornell@grafana.com>
Date: Thu, 30 Jul 2026 12:58:50 -0700
Subject: [PATCH 05/10] Fix critical error in config file

---
 docs/sources/collect/mysql-database-metrics.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/sources/collect/mysql-database-metrics.md b/docs/sources/collect/mysql-database-metrics.md
index 74e7e426a23..6753941e7bc 100644
--- a/docs/sources/collect/mysql-database-metrics.md
+++ b/docs/sources/collect/mysql-database-metrics.md
@@ -57,7 +57,7 @@ discovery.relabel "example" {
 }
 
 prometheus.scrape "example" {
-  targets    = discovery.relabel.example.targets
+  targets    = discovery.relabel.example.output
   job_name   = "integrations/db-o11y"
   forward_to = [prometheus.remote_write.metrics_service.receiver]
 }

From 369c6902e94bbac06672373863019f7f04a5c43b Mon Sep 17 00:00:00 2001
From: Clayton Cornell <clayton.cornell@grafana.com>
Date: Thu, 30 Jul 2026 13:01:29 -0700
Subject: [PATCH 06/10] Cleanup link text

---
 .../database_observability/database_observability.mysql.md      | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/sources/reference/components/database_observability/database_observability.mysql.md b/docs/sources/reference/components/database_observability/database_observability.mysql.md
index 3cdb58afaab..4b399e5fbdc 100644
--- a/docs/sources/reference/components/database_observability/database_observability.mysql.md
+++ b/docs/sources/reference/components/database_observability/database_observability.mysql.md
@@ -229,7 +229,7 @@ Replace the following:
 * _`<DATA_SOURCE_NAME>`_: The MySQL connection [Data Source Name] (for example, `user:pass@tcp(mysql:3306)/`).
 * _`<AWS_RDS_ARN>`_: The ARN of your AWS RDS database (for example, `arn:aws:rds:us-east-1:123456789:db/prod-mysql`).
 
-For a complete end-to-end example that demonstrates sending database observability metrics to Grafana Cloud, refer to the [`mysql-database-metrics`](../../../collect/mysql-database-metrics/) task topic.
+For a complete end-to-end example that demonstrates sending database observability metrics to Grafana Cloud, refer to [Collect MySQL database metrics and logs](../../../collect/mysql-database-metrics/).
 
 [Data Source Name]: https://github.com/go-sql-driver/mysql#dsn-data-source-name
 

From c47ee2c12242d5e5397e56b07dac20c8c38b6026 Mon Sep 17 00:00:00 2001
From: Clayton Cornell <clayton.cornell@grafana.com>
Date: Thu, 30 Jul 2026 13:01:51 -0700
Subject: [PATCH 07/10] Add new task topic tto repalce example

---
 .../sources/collect/mysql-database-metrics.md | 240 ++++++++++++++++--
 1 file changed, 223 insertions(+), 17 deletions(-)

diff --git a/docs/sources/collect/mysql-database-metrics.md b/docs/sources/collect/mysql-database-metrics.md
index 6753941e7bc..94dd6f6f3e5 100644
--- a/docs/sources/collect/mysql-database-metrics.md
+++ b/docs/sources/collect/mysql-database-metrics.md
@@ -2,41 +2,232 @@
 canonical: https://grafana.com/docs/alloy/latest/collect/mysql-database-metrics/
 description: Learn how to collect MySQL database metrics and logs with Grafana Alloy.
 title: Collect MySQL database metrics and logs
-labels:
-  stage: experimental
+weight: 410
 ---
 
 # Collect MySQL database metrics and logs
 
-[SCAFFOLD PLACEHOLDER: This topic is a scaffold. The following example is complete and functional, but narrative explanation and step-by-step guidance are pending. See the `develop-task-topic` skill for the next step in completing this scaffold.]
+You can configure {{< param "PRODUCT_NAME" >}} to collect database observability data from MySQL servers including metrics, logs, and performance schema statistics.
+Forward this data to Grafana Cloud, Prometheus, Loki, or any compatible observability backend.
+
+You can accomplish the following with {{< param "PRODUCT_NAME" >}}:
+
+* Collect query performance data, explain plans, and lock information from MySQL.
+* Monitor schema and table statistics.
+* Forward database observability logs to Loki.
+* Scrape MySQL metrics with Prometheus.
+
+## Components used in this topic
+
+* [`database_observability.mysql`][database_observability.mysql]
+* [`prometheus.exporter.mysql`][prometheus.exporter.mysql]
+* [`loki.relabel`][loki.relabel]
+* [`discovery.relabel`][discovery.relabel]
+* [`prometheus.scrape`][prometheus.scrape]
+* [`prometheus.remote_write`][prometheus.remote_write]
+* [`loki.write`][loki.write]
+
+## Before you begin
+
+* Ensure you have a running MySQL server with access credentials.
+* Enable the MySQL `performance_schema` on your MySQL server.
+  Refer to the [MySQL performance_schema documentation](https://dev.mysql.com/doc/refman/8.0/en/performance-schema.html) for setup instructions.
+* Have write access to a Prometheus-compatible endpoint or Grafana Cloud for storing metrics.
+* Have write access to a Loki-compatible endpoint or Grafana Cloud for storing logs.
+* Be familiar with the concept of [Components][] in {{< param "PRODUCT_NAME" >}}.
+
+## Collect MySQL database observability data
+
+The `database_observability.mysql` component connects to a MySQL database and collects performance schema data.
+This data includes query details, execution plans, and lock information forwarded as logs to Loki.
+The component also exports targets that can be scraped with Prometheus to collect MySQL metrics.
+
+To collect MySQL observability data and forward it to Grafana Cloud, complete the following steps:
+
+1. Add a `database_observability.mysql` component to your configuration file.
+
+   ```alloy
+   database_observability.mysql "<LABEL>" {
+     data_source_name = "<MYSQL_DSN>"
+     forward_to       = [loki.relabel.<LABEL>.receiver]
+
+     enable_collectors = ["query_samples", "explain_plans"]
+
+     cloud_provider {
+       aws {
+         arn = "<AWS_RDS_ARN>"
+       }
+     }
+   }
+   ```
+
+   Replace the following:
+
+   * _`<LABEL>`_: The Alloy component label, such as `prod-mysql`.
+   * _`<MYSQL_DSN>`_: The MySQL Data Source Name, such as `user:pass@tcp(mysql:3306)/`.
+     Refer to the [go-sql-driver/mysql documentation](https://github.com/go-sql-driver/mysql#dsn-data-source-name) for the full DSN format.
+   * _`<AWS_RDS_ARN>`_: The ARN of your AWS RDS database instance, such as `arn:aws:rds:us-east-1:123456789:db/prod-mysql`.
+     If using Azure or GCP, use the corresponding cloud provider block instead.
+
+   For more information, refer to the [`database_observability.mysql`][database_observability.mysql] documentation.
+
+2. Add a `prometheus.exporter.mysql` component to export MySQL metrics.
+
+   ```alloy
+   prometheus.exporter.mysql "<LABEL>" {
+     data_source_name  = "<MYSQL_DSN>"
+     enable_collectors = ["perf_schema.eventsstatements"]
+   }
+   ```
+
+   Replace the following:
+
+   * _`<LABEL>`_: Must match the label used for the `database_observability.mysql` component.
+   * _`<MYSQL_DSN>`_: The same MySQL Data Source Name as the `database_observability.mysql` component.
+
+   For more information, refer to the [`prometheus.exporter.mysql`][prometheus.exporter.mysql] documentation.
+
+3. Add a `loki.relabel` component to standardize labels on database logs.
+
+   ```alloy
+   loki.relabel "<LABEL>" {
+     forward_to = [loki.write.logs_service.receiver]
+
+     rule {
+       target_label = "job"
+       replacement  = "integrations/db-o11y"
+     }
+
+     rule {
+       target_label = "instance"
+       replacement  = "<LABEL>"
+     }
+   }
+   ```
+
+   Replace the following:
+
+   * _`<LABEL>`_: Must match the label used for the `database_observability.mysql` component.
+
+   For more information, refer to the [`loki.relabel`][loki.relabel] documentation.
+
+4. Add a `discovery.relabel` component to standardize labels on Prometheus targets.
+
+   ```alloy
+   discovery.relabel "<LABEL>" {
+     targets = database_observability.mysql.<LABEL>.targets
+
+     rule {
+       target_label = "job"
+       replacement  = "integrations/db-o11y"
+     }
+
+     rule {
+       target_label = "instance"
+       replacement  = "<LABEL>"
+     }
+   }
+   ```
+
+   Replace the following:
+
+   * _`<LABEL>`_: Must match the label used for the `database_observability.mysql` component.
+
+   For more information, refer to the [`discovery.relabel`][discovery.relabel] documentation.
+
+5. Add a `prometheus.scrape` component to scrape the MySQL metrics exported by both the `database_observability.mysql` and `prometheus.exporter.mysql` components.
+
+   ```alloy
+   prometheus.scrape "<LABEL>" {
+     targets    = discovery.relabel.<LABEL>.output
+     job_name   = "integrations/db-o11y"
+     forward_to = [prometheus.remote_write.metrics_service.receiver]
+   }
+   ```
+
+   Replace the following:
+
+   * _`<LABEL>`_: Must match the label used for the `database_observability.mysql` component.
+
+   For more information, refer to the [`prometheus.scrape`][prometheus.scrape] documentation.
+
+6. Add a `prometheus.remote_write` component to send metrics to Grafana Cloud or Prometheus.
+
+   ```alloy
+   prometheus.remote_write "metrics_service" {
+     endpoint {
+       url = "<GRAFANA_CLOUD_HOSTED_METRICS_URL>"
+
+       basic_auth {
+         username = "<GRAFANA_CLOUD_HOSTED_METRICS_ID>"
+         password = "<GRAFANA_CLOUD_RW_API_KEY>"
+       }
+     }
+   }
+   ```
+
+   Replace the following:
+
+   * _`<GRAFANA_CLOUD_HOSTED_METRICS_URL>`_: The URL for your Grafana Cloud hosted metrics endpoint.
+   * _`<GRAFANA_CLOUD_HOSTED_METRICS_ID>`_: The user ID for your Grafana Cloud hosted metrics.
+   * _`<GRAFANA_CLOUD_RW_API_KEY>`_: Your Grafana Cloud API key.
+
+   For more information, refer to the [`prometheus.remote_write`][prometheus.remote_write] documentation.
+
+7. Add a `loki.write` component to send logs to Grafana Cloud or Loki.
+
+   ```alloy
+   loki.write "logs_service" {
+     endpoint {
+       url = "<GRAFANA_CLOUD_HOSTED_LOGS_URL>"
+
+       basic_auth {
+         username = "<GRAFANA_CLOUD_HOSTED_LOGS_ID>"
+         password = "<GRAFANA_CLOUD_RW_API_KEY>"
+       }
+     }
+   }
+   ```
+
+   Replace the following:
+
+   * _`<GRAFANA_CLOUD_HOSTED_LOGS_URL>`_: The URL for your Grafana Cloud hosted logs endpoint.
+   * _`<GRAFANA_CLOUD_HOSTED_LOGS_ID>`_: The user ID for your Grafana Cloud hosted logs.
+   * _`<GRAFANA_CLOUD_RW_API_KEY>`_: Your Grafana Cloud API key.
+
+   For more information, refer to the [`loki.write`][loki.write] documentation.
+
+## Complete configuration
+
+The following is a complete configuration that collects MySQL database observability data and forwards it to Grafana Cloud.
 
 ```alloy
-// MySQL database observability with Loki and Prometheus
 database_observability.mysql "example" {
-  data_source_name = "user:pass@tcp(mysql:3306)/"
+  data_source_name = "<MYSQL_DSN>"
   forward_to       = [loki.relabel.example.receiver]
-  targets          = prometheus.exporter.mysql.example.targets
 
   enable_collectors = ["query_samples", "explain_plans"]
 
   cloud_provider {
     aws {
-      arn = "your-rds-db-arn"
+      arn = "<AWS_RDS_ARN>"
     }
   }
 }
 
 prometheus.exporter.mysql "example" {
-  data_source_name  = "user:pass@tcp(mysql:3306)/"
+  data_source_name  = "<MYSQL_DSN>"
   enable_collectors = ["perf_schema.eventsstatements"]
 }
 
 loki.relabel "example" {
   forward_to = [loki.write.logs_service.receiver]
+
   rule {
     target_label = "job"
     replacement  = "integrations/db-o11y"
   }
+
   rule {
     target_label = "instance"
     replacement  = "example"
@@ -50,6 +241,7 @@ discovery.relabel "example" {
     target_label = "job"
     replacement  = "integrations/db-o11y"
   }
+
   rule {
     target_label = "instance"
     replacement  = "example"
@@ -64,20 +256,22 @@ prometheus.scrape "example" {
 
 prometheus.remote_write "metrics_service" {
   endpoint {
-    url = sys.env("<GRAFANA_CLOUD_HOSTED_METRICS_URL>")
+    url = "<GRAFANA_CLOUD_HOSTED_METRICS_URL>"
+
     basic_auth {
-      username = sys.env("<GRAFANA_CLOUD_HOSTED_METRICS_ID>")
-      password = sys.env("<GRAFANA_CLOUD_RW_API_KEY>")
+      username = "<GRAFANA_CLOUD_HOSTED_METRICS_ID>"
+      password = "<GRAFANA_CLOUD_RW_API_KEY>"
     }
   }
 }
 
 loki.write "logs_service" {
   endpoint {
-    url = sys.env("<GRAFANA_CLOUD_HOSTED_LOGS_URL>")
+    url = "<GRAFANA_CLOUD_HOSTED_LOGS_URL>"
+
     basic_auth {
-      username = sys.env("<GRAFANA_CLOUD_HOSTED_LOGS_ID>")
-      password = sys.env("<GRAFANA_CLOUD_RW_API_KEY>")
+      username = "<GRAFANA_CLOUD_HOSTED_LOGS_ID>"
+      password = "<GRAFANA_CLOUD_RW_API_KEY>"
     }
   }
 }
@@ -85,8 +279,20 @@ loki.write "logs_service" {
 
 Replace the following:
 
-* _`<GRAFANA_CLOUD_HOSTED_METRICS_URL>`_: The URL for your Grafana Cloud hosted metrics.
+* _`<MYSQL_DSN>`_: The MySQL Data Source Name for your MySQL server.
+* _`<AWS_RDS_ARN>`_: The ARN of your AWS RDS database instance.
+* _`<GRAFANA_CLOUD_HOSTED_METRICS_URL>`_: The URL for your Grafana Cloud hosted metrics endpoint.
 * _`<GRAFANA_CLOUD_HOSTED_METRICS_ID>`_: The user ID for your Grafana Cloud hosted metrics.
-* _`<GRAFANA_CLOUD_RW_API_KEY>`_: Your Grafana Cloud API key.
-* _`<GRAFANA_CLOUD_HOSTED_LOGS_URL>`_: The URL for your Grafana Cloud hosted logs.
+* _`<GRAFANA_CLOUD_HOSTED_LOGS_URL>`_: The URL for your Grafana Cloud hosted logs endpoint.
 * _`<GRAFANA_CLOUD_HOSTED_LOGS_ID>`_: The user ID for your Grafana Cloud hosted logs.
+* _`<GRAFANA_CLOUD_RW_API_KEY>`_: Your Grafana Cloud API key.
+
+[database_observability.mysql]: ../../reference/components/database_observability.mysql/
+[prometheus.exporter.mysql]: ../../reference/components/prometheus/prometheus.exporter.mysql/
+[loki.relabel]: ../../reference/components/loki/loki.relabel/
+[discovery.relabel]: ../../reference/components/discovery/discovery.relabel/
+[prometheus.scrape]: ../../reference/components/prometheus/prometheus.scrape/
+[prometheus.remote_write]: ../../reference/components/prometheus/prometheus.remote_write/
+[loki.write]: ../../reference/components/loki/loki.write/
+[Components]: ../../get-started/components/
+[Prometheus]: https://prometheus.io/

From 5db571dff15d64c936d58deaa6414d5be9300268 Mon Sep 17 00:00:00 2001
From: Clayton Cornell <clayton.cornell@grafana.com>
Date: Thu, 30 Jul 2026 13:06:52 -0700
Subject: [PATCH 08/10] Add missing metadata

---
 docs/sources/collect/mysql-database-metrics.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/sources/collect/mysql-database-metrics.md b/docs/sources/collect/mysql-database-metrics.md
index 94dd6f6f3e5..a29bca64609 100644
--- a/docs/sources/collect/mysql-database-metrics.md
+++ b/docs/sources/collect/mysql-database-metrics.md
@@ -3,6 +3,10 @@ canonical: https://grafana.com/docs/alloy/latest/collect/mysql-database-metrics/
 description: Learn how to collect MySQL database metrics and logs with Grafana Alloy.
 title: Collect MySQL database metrics and logs
 weight: 410
+labels:
+  products:
+    - oss
+review_date: 2026-07-30
 ---
 
 # Collect MySQL database metrics and logs

From a41879fd919158f1dd84541484f27038da0f9854 Mon Sep 17 00:00:00 2001
From: Clayton Cornell <clayton.cornell@grafana.com>
Date: Thu, 30 Jul 2026 13:26:56 -0700
Subject: [PATCH 09/10] Fix links

---
 docs/sources/collect/mysql-database-metrics.md                | 4 ++--
 .../database_observability/database_observability.mysql.md    | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/sources/collect/mysql-database-metrics.md b/docs/sources/collect/mysql-database-metrics.md
index a29bca64609..2c24b9b190e 100644
--- a/docs/sources/collect/mysql-database-metrics.md
+++ b/docs/sources/collect/mysql-database-metrics.md
@@ -69,7 +69,7 @@ To collect MySQL observability data and forward it to Grafana Cloud, complete th
 
    * _`<LABEL>`_: The Alloy component label, such as `prod-mysql`.
    * _`<MYSQL_DSN>`_: The MySQL Data Source Name, such as `user:pass@tcp(mysql:3306)/`.
-     Refer to the [go-sql-driver/mysql documentation](https://github.com/go-sql-driver/mysql#dsn-data-source-name) for the full DSN format.
+     Refer to the [DSN](https://github.com/go-sql-driver/mysql#dsn-data-source-name) documentation for the full DSN format.
    * _`<AWS_RDS_ARN>`_: The ARN of your AWS RDS database instance, such as `arn:aws:rds:us-east-1:123456789:db/prod-mysql`.
      If using Azure or GCP, use the corresponding cloud provider block instead.
 
@@ -291,7 +291,7 @@ Replace the following:
 * _`<GRAFANA_CLOUD_HOSTED_LOGS_ID>`_: The user ID for your Grafana Cloud hosted logs.
 * _`<GRAFANA_CLOUD_RW_API_KEY>`_: Your Grafana Cloud API key.
 
-[database_observability.mysql]: ../../reference/components/database_observability.mysql/
+[database_observability.mysql]: ../../reference/components/database_observability/database_observability.mysql/
 [prometheus.exporter.mysql]: ../../reference/components/prometheus/prometheus.exporter.mysql/
 [loki.relabel]: ../../reference/components/loki/loki.relabel/
 [discovery.relabel]: ../../reference/components/discovery/discovery.relabel/
diff --git a/docs/sources/reference/components/database_observability/database_observability.mysql.md b/docs/sources/reference/components/database_observability/database_observability.mysql.md
index 4b399e5fbdc..a14faf71cd4 100644
--- a/docs/sources/reference/components/database_observability/database_observability.mysql.md
+++ b/docs/sources/reference/components/database_observability/database_observability.mysql.md
@@ -229,7 +229,7 @@ Replace the following:
 * _`<DATA_SOURCE_NAME>`_: The MySQL connection [Data Source Name] (for example, `user:pass@tcp(mysql:3306)/`).
 * _`<AWS_RDS_ARN>`_: The ARN of your AWS RDS database (for example, `arn:aws:rds:us-east-1:123456789:db/prod-mysql`).
 
-For a complete end-to-end example that demonstrates sending database observability metrics to Grafana Cloud, refer to [Collect MySQL database metrics and logs](../../../collect/mysql-database-metrics/).
+For a complete end-to-end example that demonstrates sending database observability metrics to Grafana Cloud, refer to [Collect MySQL database metrics and logs](../../../../collect/mysql-database-metrics/).
 
 [Data Source Name]: https://github.com/go-sql-driver/mysql#dsn-data-source-name
 

From 413d288027d609d693ccfa9f99e5b2de51d84d11 Mon Sep 17 00:00:00 2001
From: Clayton Cornell <clayton.cornell@grafana.com>
Date: Thu, 30 Jul 2026 13:33:53 -0700
Subject: [PATCH 10/10] Include CoPilot suggestions

---
 docs/sources/collect/mysql-database-metrics.md              | 6 ++++--
 .../database_observability/database_observability.mysql.md  | 2 +-
 2 files changed, 5 insertions(+), 3 deletions(-)

diff --git a/docs/sources/collect/mysql-database-metrics.md b/docs/sources/collect/mysql-database-metrics.md
index 2c24b9b190e..d501c153765 100644
--- a/docs/sources/collect/mysql-database-metrics.md
+++ b/docs/sources/collect/mysql-database-metrics.md
@@ -54,6 +54,7 @@ To collect MySQL observability data and forward it to Grafana Cloud, complete th
    database_observability.mysql "<LABEL>" {
      data_source_name = "<MYSQL_DSN>"
      forward_to       = [loki.relabel.<LABEL>.receiver]
+     targets          = prometheus.exporter.mysql.<LABEL>.targets
 
      enable_collectors = ["query_samples", "explain_plans"]
 
@@ -67,7 +68,7 @@ To collect MySQL observability data and forward it to Grafana Cloud, complete th
 
    Replace the following:
 
-   * _`<LABEL>`_: The Alloy component label, such as `prod-mysql`.
+   * _`<LABEL>`_: The Alloy component label, such as `prod_mysql`.
    * _`<MYSQL_DSN>`_: The MySQL Data Source Name, such as `user:pass@tcp(mysql:3306)/`.
      Refer to the [DSN](https://github.com/go-sql-driver/mysql#dsn-data-source-name) documentation for the full DSN format.
    * _`<AWS_RDS_ARN>`_: The ARN of your AWS RDS database instance, such as `arn:aws:rds:us-east-1:123456789:db/prod-mysql`.
@@ -139,7 +140,7 @@ To collect MySQL observability data and forward it to Grafana Cloud, complete th
 
    For more information, refer to the [`discovery.relabel`][discovery.relabel] documentation.
 
-5. Add a `prometheus.scrape` component to scrape the MySQL metrics exported by both the `database_observability.mysql` and `prometheus.exporter.mysql` components.
+5. Add a `prometheus.scrape` component to scrape the relabeled targets from `discovery.relabel`, which are sourced from the `database_observability.mysql` component's exported targets.
 
    ```alloy
    prometheus.scrape "<LABEL>" {
@@ -209,6 +210,7 @@ The following is a complete configuration that collects MySQL database observabi
 database_observability.mysql "example" {
   data_source_name = "<MYSQL_DSN>"
   forward_to       = [loki.relabel.example.receiver]
+  targets          = prometheus.exporter.mysql.example.targets
 
   enable_collectors = ["query_samples", "explain_plans"]
 
diff --git a/docs/sources/reference/components/database_observability/database_observability.mysql.md b/docs/sources/reference/components/database_observability/database_observability.mysql.md
index a14faf71cd4..6de89ab6779 100644
--- a/docs/sources/reference/components/database_observability/database_observability.mysql.md
+++ b/docs/sources/reference/components/database_observability/database_observability.mysql.md
@@ -225,7 +225,7 @@ database_observability.mysql "<LABEL>" {
 
 Replace the following:
 
-* _`<LABEL>`_: The Alloy component label (for example, `prod-mysql`).
+* _`<LABEL>`_: The Alloy component label (for example, `prod_mysql`).
 * _`<DATA_SOURCE_NAME>`_: The MySQL connection [Data Source Name] (for example, `user:pass@tcp(mysql:3306)/`).
 * _`<AWS_RDS_ARN>`_: The ARN of your AWS RDS database (for example, `arn:aws:rds:us-east-1:123456789:db/prod-mysql`).