Logging is here!


To create a TimeBoard or a ScreenBoard Select which of these you would prefer to create after clicking ‘New Dashboard’ in the ‘Dashboards’ dropdown.

Board selection

What is the difference between a ScreenBoard and a TimeBoard?

At Datadog we give you the capability to create and customize two types of dashboards; ScreenBoards and TimeBoards. To more clearly understand the differences between the two, consider the following:

Time ScopeAll graphs share same time scopeAll graphs can have individual time scope
LayoutGraphs appear in a fixed gridGraphs are placed anywhere you like on the canvas
Can Share Graphs IndividuallyYesNo
Can Share the Entire DashboardNoYes
Sharing can be Read-OnlyYesYes

Editing template variables

Dashboard templating allows you to create dashboards that use variables like $scope or $redis in place of specific tags or hosts. You can then dynamically explore the metrics across different sets of tags. Select a new variable value in the dropdown menu, and that value applies across the dashboard.

To create, edit, and delete template variables click the gear icon at the upper right-hand side of the screen, then select ‘Edit Template Variables’ from the actions menu.

edit template variable

This open the template variable editing panel.

Redis template var

A template variable is defined by a name and optional parameters for ‘Tag Group’ and ‘Default Tag.’ A tag group is a prefix shared among several tags, like redis_port for the tags redis_port:6379 and redis_port:6380. Setting a tag group eliminates irrelevant tags from the variable’s scope selector, and removes the prefix from the listed values for clarity - so you’ll see 6379 and 6380 in the ‘Default Tag’ dropdown instead. The ‘Default Tag’ option determines the initial value for the variable on dashboard load.

Using template variables in graph editors

Redis-tpl graph editor

Once defined, template variables appear alongside normal tag and host options in graph editors. If you set 6379 as the value of $redis, all graphs defined with $redis is scoped to redis_port:6379.

Redis tpl selected

Event Correlation at Design Time

Event Correlation refers to overlaying events on top of a dashboard graph and is an important feature of the Datadog platform. You can setup correlation at two different times: either when you setup the dashboard or adhoc at the time you view the dashboard.


Setup event correlation at design time by editing any graph on both Time Boards and Screen Boards and adding events to the graph. To learn more about this, visit the Graphing Primer. You can find details about adding events using the UI or via the JSON interface further down the page.

Event Correlation at View Time

guides event correlation

Setup event correlation at view time by adding a query in the Search box at the top left of any Time Board dashboard window. This replaces any events added at design time, but applies the events to all graphs on that particular dashboard.