Skip to content

add more information on how cluster grouping work on DBM #30476

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: master
Choose a base branch
from
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 8 additions & 3 deletions content/en/database_monitoring/database_hosts.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,9 +6,6 @@

{{< img src="database_monitoring/databases-list-3.png" alt="The Databases page in Datadog" style="width:100%;" >}}

<div class="alert alert-info">
If you are using Amazon RDS with the <a href="https://docs.datadoghq.com/integrations/amazon_rds/?tab=standard">RDS integration</a> enabled, Datadog automatically receives the <code>dbclusteridentifier</code> tag from AWS. When this tag is present, a <strong>Group my RDS clusters</strong> toggle appears, grouping related RDS instances into clusters based on the identifier. No additional setup or manual tagging is required.</div>

On the [Databases page][1], you can assess the health and activity of your database hosts. Sort and filter the list to prioritize hosts with triggered alerts, high query volume, and other criteria. Click on any host in the list to open a details panel:

{{< img src="database_monitoring/db-list-details-panel-cropped-2.png" alt="The details panel for a single database host on the Databases page" style="width:90%;" >}}
Expand All @@ -26,6 +23,14 @@
| [Calling services](#calling-services) | {{< X >}} | {{< X >}} | {{< X >}} | |
| [Configuration details](#configuration-details) | {{< X >}} | {{< X >}} | {{< X >}} | |

## Cluster grouping
When you view the list of database hosts, a **Group into clusters** toggle might appear if we detect some cluster topologies. This is powered by the tagging information done by an integration or the agent.

Check warning on line 27 in content/en/database_monitoring/database_hosts.md

View workflow job for this annotation

GitHub Actions / vale

Datadog.pronouns

Avoid first-person pronouns such as 'we'.
Currently, here are the supported cluster topologies:

Check warning on line 28 in content/en/database_monitoring/database_hosts.md

View workflow job for this annotation

GitHub Actions / vale

Datadog.tense

Avoid temporal words like 'Currently'.

- Amazon RDS with the <a href="https://docs.datadoghq.com/integrations/amazon_rds/?tab=standard">RDS integration</a> enabled. Datadog uses the <code>dbclusteridentifier</code> and <code>region</code> tags to group hosts into clusters.
- PostgreSQL's physical replication. Agent 7.58+ uses the <code>system_identifier</code> tag to group hosts into clusters.
- MySQL's traditional replication. Agent 7.68+ uses the <code>cluster_uuid</code> tag to group hosts into clusters.

## Top queries

On the **Top Queries** tab of the host details panel, you can sort the most common queries by maximum duration, average latency, and more.
Expand Down
Loading