-
Notifications
You must be signed in to change notification settings - Fork 1.2k
Update template_variables.md #32390
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
base: master
Are you sure you want to change the base?
Update template_variables.md #32390
Conversation
Preview links (active after the
|
There was a problem hiding this 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. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
| 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. |
There was a problem hiding this comment.
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.
There was a problem hiding this comment.
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" ?
There was a problem hiding this comment.
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!
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
updated!
Co-authored-by: May Lee <may.lee@datadoghq.com>
Co-authored-by: May Lee <may.lee@datadoghq.com>
There was a problem hiding this 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.
Co-authored-by: May Lee <may.lee@datadoghq.com>
Co-authored-by: May Lee <may.lee@datadoghq.com>
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:
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