Skip to content

Conversation

@bonnierhee
Copy link
Contributor

@bonnierhee bonnierhee commented Oct 24, 2025

What does this PR do? What is the motivation?

Update the dashboards template variables page to provide more information on how template variable values are populated, and the differences users might see as a result of certain data sources.

Merge instructions

Merge readiness:

  • Ready for merge

For Datadog employees:

Your branch name MUST follow the <name>/<description> convention and include the forward slash (/). Without this format, your pull request will not pass CI, the GitLab pipeline will not run, and you won't get a branch preview. Getting a branch preview makes it easier for us to check any issues with your PR, such as broken links.

If your branch doesn't follow this format, rename it or create a new branch and PR.

[6/5/2025] Merge queue has been disabled on the documentation repo. If you have write access to the repo, the PR has been reviewed by a Documentation team member, and all of the required checks have passed, you can use the Squash and Merge button to merge the PR. If you don't have write access, or you need help, reach out in the #documentation channel in Slack.

Additional notes

N/A

@bonnierhee bonnierhee requested a review from a team as a code owner October 24, 2025 17:48
@github-actions
Copy link
Contributor

Preview links (active after the build_preview check completes)

Modified Files

Copy link
Contributor

@maycmlee maycmlee left a comment

Choose a reason for hiding this comment

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

A couple of suggestions and a question

### Template Variable Values
Template variable values (values available via the template variable dropdowns) are populated based on what sources the widgets in the dashboard are using. For example, if your dashboard has widgets querying logs, you will only see values from logs. If your dashboard has widgets querying logs, metrics, and RUM, you will see values from logs, metrics, and RUM.

For most sources, template variable values will be relevant to your dashboard's global timeframe. If your dashboard's timeframe is set to the last 15 minutes, you will only see template variable values from the last 15 minutes. If your dashboard timeframe is set to a 24 hour period from last August, it will only show you values from that timeframe.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
For most sources, template variable values will be relevant to your dashboard's global timeframe. If your dashboard's timeframe is set to the last 15 minutes, you will only see template variable values from the last 15 minutes. If your dashboard timeframe is set to a 24 hour period from last August, it will only show you values from that timeframe.
For most sources, template variable values are relevant to your dashboard's global timeframe. If your dashboard's timeframe is set to the last 15 minutes, only template variable values from the last 15 minutes are shown. If your dashboard timeframe is set to a 24 hour period from last August, only values from that timeframe are shown.

Copy link
Contributor

Choose a reason for hiding this comment

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

What does "24 hour period from last August" mean? I don't understand how that timeframe works.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

I was trying to give the example of a random day last August as an example. Would it be clearer to say "Last August 15 from 12 AM to 11:59 PM" ?

Copy link
Contributor

Choose a reason for hiding this comment

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

Ah, yes, saying that specifically would be clearer. Thanks!

Copy link
Contributor Author

Choose a reason for hiding this comment

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

updated!

bonnierhee and others added 2 commits October 24, 2025 14:37
Co-authored-by: May Lee <may.lee@datadoghq.com>
Co-authored-by: May Lee <may.lee@datadoghq.com>
@bonnierhee bonnierhee requested a review from maycmlee October 24, 2025 18:41
Copy link
Contributor

@maycmlee maycmlee left a comment

Choose a reason for hiding this comment

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

Thanks for updating! I formatted it as two examples and also left a couple of edits I missed.

bonnierhee and others added 2 commits October 24, 2025 15:13
Co-authored-by: May Lee <may.lee@datadoghq.com>
Co-authored-by: May Lee <may.lee@datadoghq.com>
@bonnierhee bonnierhee requested a review from maycmlee October 24, 2025 19:18
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants