Skip to content

[DOCS] Add custom metrics documentation for Database Monitoring#35923

Open
michaelperalta wants to merge 8 commits intomasterfrom
mike.peralta/dbm-postgres-custom-metrics-docs
Open

[DOCS] Add custom metrics documentation for Database Monitoring#35923
michaelperalta wants to merge 8 commits intomasterfrom
mike.peralta/dbm-postgres-custom-metrics-docs

Conversation

@michaelperalta
Copy link
Copy Markdown

What does this PR do? What is the motivation?

Adds a new database_monitoring/custom_metrics/ section with two pages:

Collecting Custom Metrics (_index.md)

  • Explains the custom_queries configuration option for the PostgreSQL, MySQL, and SQL Server integrations
  • Shared reference table for metric_prefix, query, columns, and tags options
  • Per-database examples using tabs, all using a consistent sample table for easy comparison
  • SQL Server tab covers both custom_queries and the custom_metrics performance counter approach
  • Links to the existing per-database full reference pages in integrations/

Exploring Custom Metrics (exploring_custom_metrics.md)

  • Documents the Custom Metrics section of the database instance detail page in the DBM UI
  • Covers column types, collection interval display, and the View SQL query button
  • Includes a full PostgreSQL example tracking table size and row counts

Navigation and landing page

  • Added "Collecting Custom Metrics" to the sidebar at weight 11, directly under "Connecting DBM and Traces"
  • Added a "Collect custom metrics" entry to the DBM landing page Explore section

Merge instructions

Merge readiness:

  • Ready for merge

Additional notes

- Add database_monitoring/custom_metrics/_index.md: explains custom_queries
  config for PostgreSQL, MySQL, and SQL Server with shared reference table
  and per-database examples using tabs
- Add database_monitoring/custom_metrics/exploring_custom_metrics.md: covers
  the Custom Metrics section in the instance detail page UI, including column
  types, collection interval, and the View SQL query button
- Add Collecting Custom Metrics to sidebar nav (weight 11, under Connecting DBM and Traces)
- Add link to custom metrics section from DBM landing page

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@michaelperalta michaelperalta requested review from a team as code owners April 10, 2026 18:39
@github-actions github-actions bot added the Architecture Everything related to the Doc backend label Apr 10, 2026
@jeff-morgan-dd jeff-morgan-dd self-assigned this Apr 10, 2026
@jeff-morgan-dd jeff-morgan-dd added the editorial review Waiting on a more in-depth review label Apr 10, 2026
Copy link
Copy Markdown
Contributor

@jeff-morgan-dd jeff-morgan-dd left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you for the PR! A couple of notes and edits for your consideration and review here, will re-review once ready.

michaelperalta and others added 6 commits April 12, 2026 14:25
…_metrics.md

Co-authored-by: jeff-morgan-dd <jeff.morgan@datadoghq.com>
Co-authored-by: jeff-morgan-dd <jeff.morgan@datadoghq.com>
…_metrics.md

Co-authored-by: jeff-morgan-dd <jeff.morgan@datadoghq.com>
…_metrics.md

Co-authored-by: jeff-morgan-dd <jeff.morgan@datadoghq.com>
…_metrics.md

Co-authored-by: jeff-morgan-dd <jeff.morgan@datadoghq.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Architecture Everything related to the Doc backend editorial review Waiting on a more in-depth review

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants