Customize your visualizations with unit override

Overview

The unit override feature in visualizations allows you to customize how your data is labeled. This guide covers the configuration options for unit override and how these options help you analyze your graphs.

Note: Many of the examples in this guide use the Table widget, however, unit override is not exclusive to this widget.

To set a unit at the org level, see the following documentation:


Configuration

In your Notebooks and Dashboard widgets, find the graph editor of the cell or the widget. For Notebooks, click More Options and for Dashboards, find the Graph your data section.

Unit override option in the graph your data section for a Change widget

How unit and scale attribution works

When a unit is detected, Datadog automatically chooses the most readable unit scale depending on the magnitude of your data. For example, if the source data is nanoseconds, the widget could display readable values in minutes and seconds instead of millions of nanoseconds.

Table widget showing values scaled to minutes and seconds, alongside unit override configuration with Autoscale unit enabled

With unit override, you can choose a single fixed scale to compare values. In the example below, all values are configured to scale to minutes. This is to directly compare values in the same scale.

Table widget showing values all scaled to minute, alongside unit override configuration without Autoscale unit enabled

Assign custom units

Assign custom units to a widget to add context to unit-less metrics (like counts).

Unit override configuration highlighting the Unit dropdown menu to assign custom units

Define completely custom units that are not included in the provided list of units. Instead of a generic count of events, you can specify that you are visualizing 10,000 tests, or 100 sessions. This gives you immediate context for what data you are analyzing.

Note: Autoscaling is not available for custom units as the unit family is not recognized.

Further reading

Additional helpful documentation, links, and articles:

PREVIEWING: brett0000FF/node-compatibility