From 5df06b43bd7eb145b5c548ca8692db121f644d44 Mon Sep 17 00:00:00 2001 From: DeForest Richards Date: Tue, 11 Mar 2025 16:15:10 -0600 Subject: [PATCH 1/6] Convert tabs to a table --- .../en/database_monitoring/recommendations.md | 105 ++---------------- 1 file changed, 9 insertions(+), 96 deletions(-) diff --git a/content/en/database_monitoring/recommendations.md b/content/en/database_monitoring/recommendations.md index e1153c63936..6fac4e3ac1f 100644 --- a/content/en/database_monitoring/recommendations.md +++ b/content/en/database_monitoring/recommendations.md @@ -17,102 +17,15 @@ Datadog analyzes metrics and sample data from DBM to identify your systems' high ## Recommendation types -Choose your database type to view the supported recommendations: - -{{< tabs >}} - -{{% tab "Postgres" %}} - -Missing Index -: The query's execution plan performs expensive sequential scans. When detected, Datadog recommends using an index to expedite the query. - -High Impact Blocker -: The query is causing a significant amount of waiting time for blocked queries. - -Function in Filter -: The query calls a function on columns being filtered, leading to expensive sequential scans that can’t take advantage of typical column-based indexes. - -High Row Count -: The query returns a large number of rows in its result set. - -Long Running Query -: The query has durations that have exceeded a threshold of 30 seconds. - -Unused Index -: The index has not been used in any execution plans recently. - -Low Disk Space -: The database instance is running low on disk space. - -**Note**: The Low Disk Space recommendation is only available for instances hosted on AWS RDS. - -{{% /tab %}} - -{{% tab "SQLServer" %}} - -Missing Index -: The query's execution plan performs expensive sequential scans. When detected, Datadog recommends using an index to expedite the query. - -High Impact Blocker -: The query is causing a significant amount of waiting time for blocked queries. - -High Row Count -: The query returns a large number of rows in its result set. - -Unused Index -: The index has not been used in any execution plans recently. - -Long Running Query -: The query has durations that have exceeded a threshold of 30 seconds. - -Low Disk Space -: The database instance is running low on disk space. - -**Note**: The Low Disk Space recommendation is only available for instances hosted on AWS RDS. - -{{% /tab %}} - -{{% tab "MySQL" %}} - -High Row Count -: The query returns a large number of rows in its result set. - -Long Running Query -: The query has durations that have exceeded a threshold of 30 seconds. - -Low Disk Space -: The database instance is running low on disk space. - -**Note**: The Low Disk Space recommendation is only available for instances hosted on AWS RDS. - -{{% /tab %}} - -{{% tab "Oracle" %}} - -High Impact Blocker -: The query is causing a significant amount of waiting time for blocked queries. - -High Row Count -: The query returns a large number of rows in its result set. - -Long Running Query -: The query has durations that have exceeded a threshold of 30 seconds. - -Low Disk Space -: The database instance is running low on disk space. - -**Note**: The Low Disk Space recommendation is only available for instances hosted on AWS RDS. - -{{% /tab %}} - -{{% tab "MongoDB" %}} - -Unused Index -: The index has not been used in any execution plans recently. - -{{% /tab %}} - -{{< /tabs>}} +| Recommendation Type | Description | MongoDB | MySQL | Oracle | PostgreSQL | SQL Server | +|-------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------|-----------------------------|-----------------------------|-----------------------------|-----------------------------| +| **Function in Filter** | The query calls a function on columns being filtered, leading to expensive sequential scans that can't take advantage of typical column-based indexes. | | | | | | +| **High Impact Blocker** | The query is causing a significant amount of waiting time for blocked queries. | | | | | | +| **High Row Count** | The query returns a large number of rows in its result set. | | | | | | +| **Long Running Query** | The query has durations that have exceeded a threshold of 30 seconds. | | | | | | +| **Low Disk Space** | The database instance is running low on disk space.

**Note**: Only available on AWS RDS. | | | | | | +| **Missing Index** | The query's execution plan performs expensive sequential scans. When detected, Datadog recommends using an index to expedite the query. | | | | | | +| **Unused Index** | The index has not been used in any execution plans recently. | | | | | | ## Further reading From df4ad99045a318d359f9ad246fbb53d54b8d22bf Mon Sep 17 00:00:00 2001 From: DeForest Richards Date: Wed, 12 Mar 2025 10:23:17 -0600 Subject: [PATCH 2/6] Update heading --- content/en/database_monitoring/recommendations.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/en/database_monitoring/recommendations.md b/content/en/database_monitoring/recommendations.md index 6fac4e3ac1f..37828f021d9 100644 --- a/content/en/database_monitoring/recommendations.md +++ b/content/en/database_monitoring/recommendations.md @@ -15,7 +15,7 @@ Database Monitoring (DBM) Recommendations draw attention to potential optimizati Datadog analyzes metrics and sample data from DBM to identify your systems' highest-priority issues. A severity indicator is calculated for each recommendation, highlighting the most impactful areas to focus on. High-severity recommendations may indicate immediate or impending problems, while lower-severity recommendations can be addressed asynchronously to proactively maintain database health. -## Recommendation types +## Supported recommendation types | Recommendation Type | Description | MongoDB | MySQL | Oracle | PostgreSQL | SQL Server | |-------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------|-----------------------------|-----------------------------|-----------------------------|-----------------------------| @@ -23,7 +23,7 @@ Datadog analyzes metrics and sample data from DBM to identify your systems' high | **High Impact Blocker** | The query is causing a significant amount of waiting time for blocked queries. | | | | | | | **High Row Count** | The query returns a large number of rows in its result set. | | | | | | | **Long Running Query** | The query has durations that have exceeded a threshold of 30 seconds. | | | | | | -| **Low Disk Space** | The database instance is running low on disk space.

**Note**: Only available on AWS RDS. | | | | | | +| **Low Disk Space** | The database instance is running low on disk space.

**Note**: Only available on AWS RDS. | | | | | | | **Missing Index** | The query's execution plan performs expensive sequential scans. When detected, Datadog recommends using an index to expedite the query. | | | | | | | **Unused Index** | The index has not been used in any execution plans recently. | | | | | | From d597f6527e2cb633b81aa20bc0d0b2d02baaff08 Mon Sep 17 00:00:00 2001 From: DeForest Richards Date: Wed, 12 Mar 2025 10:28:31 -0600 Subject: [PATCH 3/6] Fix Vale error for RDS --- content/en/database_monitoring/recommendations.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/en/database_monitoring/recommendations.md b/content/en/database_monitoring/recommendations.md index 37828f021d9..a097af9c560 100644 --- a/content/en/database_monitoring/recommendations.md +++ b/content/en/database_monitoring/recommendations.md @@ -23,7 +23,7 @@ Datadog analyzes metrics and sample data from DBM to identify your systems' high | **High Impact Blocker** | The query is causing a significant amount of waiting time for blocked queries. | | | | | | | **High Row Count** | The query returns a large number of rows in its result set. | | | | | | | **Long Running Query** | The query has durations that have exceeded a threshold of 30 seconds. | | | | | | -| **Low Disk Space** | The database instance is running low on disk space.

**Note**: Only available on AWS RDS. | | | | | | +| **Low Disk Space** | The database instance is running low on disk space.

**Note**: Only available on Amazon RDS. | | | | | | | **Missing Index** | The query's execution plan performs expensive sequential scans. When detected, Datadog recommends using an index to expedite the query. | | | | | | | **Unused Index** | The index has not been used in any execution plans recently. | | | | | | From a77b910b752c86052d6c3aaa89f15a04ae692b20 Mon Sep 17 00:00:00 2001 From: DeForest Richards Date: Wed, 12 Mar 2025 10:29:02 -0600 Subject: [PATCH 4/6] Fix heading capitalization --- content/en/database_monitoring/recommendations.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/en/database_monitoring/recommendations.md b/content/en/database_monitoring/recommendations.md index a097af9c560..b58cf9dec03 100644 --- a/content/en/database_monitoring/recommendations.md +++ b/content/en/database_monitoring/recommendations.md @@ -11,7 +11,7 @@ Database Monitoring (DBM) Recommendations draw attention to potential optimizati {{< img src="database_monitoring/recommendations-page.png" alt="The Recommendations page in Datadog" style="width:90%;" >}} -## How it Works +## How it works Datadog analyzes metrics and sample data from DBM to identify your systems' highest-priority issues. A severity indicator is calculated for each recommendation, highlighting the most impactful areas to focus on. High-severity recommendations may indicate immediate or impending problems, while lower-severity recommendations can be addressed asynchronously to proactively maintain database health. From b61323e745d35c60bde7d71665dfcb0c07ae6ce7 Mon Sep 17 00:00:00 2001 From: DeForest Richards Date: Wed, 12 Mar 2025 11:08:58 -0600 Subject: [PATCH 5/6] Update table supported values --- content/en/database_monitoring/recommendations.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/content/en/database_monitoring/recommendations.md b/content/en/database_monitoring/recommendations.md index b58cf9dec03..842be46b4fa 100644 --- a/content/en/database_monitoring/recommendations.md +++ b/content/en/database_monitoring/recommendations.md @@ -20,9 +20,9 @@ Datadog analyzes metrics and sample data from DBM to identify your systems' high | Recommendation Type | Description | MongoDB | MySQL | Oracle | PostgreSQL | SQL Server | |-------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------|-----------------------------|-----------------------------|-----------------------------|-----------------------------| | **Function in Filter** | The query calls a function on columns being filtered, leading to expensive sequential scans that can't take advantage of typical column-based indexes. | | | | | | -| **High Impact Blocker** | The query is causing a significant amount of waiting time for blocked queries. | | | | | | -| **High Row Count** | The query returns a large number of rows in its result set. | | | | | | -| **Long Running Query** | The query has durations that have exceeded a threshold of 30 seconds. | | | | | | +| **High Impact Blocker** | The query is causing a significant amount of waiting time for blocked queries. | | | | | | +| **High Row Count** | The query returns a large number of rows in its result set. | | | | | | +| **Long Running Query** | The query has durations that have exceeded a threshold of 30 seconds. | | | | | | | **Low Disk Space** | The database instance is running low on disk space.

**Note**: Only available on Amazon RDS. | | | | | | | **Missing Index** | The query's execution plan performs expensive sequential scans. When detected, Datadog recommends using an index to expedite the query. | | | | | | | **Unused Index** | The index has not been used in any execution plans recently. | | | | | | From 74b1981db0c2bd4766fff943f07ba9bab62cb1e2 Mon Sep 17 00:00:00 2001 From: DeForest Richards Date: Wed, 12 Mar 2025 14:32:24 -0600 Subject: [PATCH 6/6] Remove missing index for MongoDB --- content/en/database_monitoring/recommendations.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/en/database_monitoring/recommendations.md b/content/en/database_monitoring/recommendations.md index 842be46b4fa..0e148b663ec 100644 --- a/content/en/database_monitoring/recommendations.md +++ b/content/en/database_monitoring/recommendations.md @@ -24,7 +24,7 @@ Datadog analyzes metrics and sample data from DBM to identify your systems' high | **High Row Count** | The query returns a large number of rows in its result set. | | | | | | | **Long Running Query** | The query has durations that have exceeded a threshold of 30 seconds. | | | | | | | **Low Disk Space** | The database instance is running low on disk space.

**Note**: Only available on Amazon RDS. | | | | | | -| **Missing Index** | The query's execution plan performs expensive sequential scans. When detected, Datadog recommends using an index to expedite the query. | | | | | | +| **Missing Index** | The query's execution plan performs expensive sequential scans. When detected, Datadog recommends using an index to expedite the query. | | | | | | | **Unused Index** | The index has not been used in any execution plans recently. | | | | | | ## Further reading