Datadog metrics supported features
Every metric type except
DISTRIBUTION is supported. Some visualization representations will look different when a dashboard is imported to Grafana Cloud.
COUNT: Converted into a Prometheus gauge instead of a Prometheus counter. Prometheus counters cannot handle decreases.
RATE: Multiplied by the flush interval and then converted into a Prometheus gauge. The rate is transformed into its count equivalent.
GAUGE: Converted to a Prometheus gauge.
SET: Converted to a Prometheus gauge.
HISTOGRAM: The server receives a set of
RATEmetrics that are converted.
Internally, Datadog metrics are translated into Prometheus ones. Because of incompatibilities between the Datadog and Prometheus metric data formats, translating a metric between requires some special transformations. In addition to the translation tables below, some internal labels are also added to the Prometheus version of the metric. The original version of the metric can be queried using the Datadog datasource.
- Metric names: Because Prometheus metric names have different character restrictions than Datadog, the translation might look different.
- Tags: Called
labelsin Prometheus. Since Prometheus labels have different character restrictions than Datadog, the translation might look different.
Metric name mappings
|Datadog character||Prometheus mapping||Example Datadog metric||Example translated to Prometheus metric|
|Datadog tag component||Prometheus mapping||Example Datadog metric||Example translated to Prometheus metric|
|Tag values||Quotes around tag values|
|Multiple tag values||Comma separators between tag values|
|Unnamed tag||Prepended with |
|Data Retention||Yes||Grafana Cloud retains metrics for 13 months. This is customizable.|
|Out of Order Metrics||Yes||Mimir has experimental support for out of order metrics.|
|Metric Type Modifiers||Yes|
|Multiple query metrics||Yes|
|Time Aggregation (Rollup)||Partially||Multiple rollup intervals for a single metric are not supported.|
top(): partially, “area” and “l2norm” aggregation methods are not supported. The convenience functions (e.g.
bottom10_min()) are supported
dt(): no but agent sends metrics every 10s anyway.
rollup(): partially, see “Time Aggregation (Rollup)” in previous section
This section describes the Datadog features that the Datadog Dashboard Translator supports. Unknown widgets are shown as text panels in the converted dashboard.
Timeboards are supported and automatically snap to a fixed grid.
screenboards have free-form layouts and different graphs can have different time scopes, they are partially supported. The Grafana migration tool transforms a
screenboard into a
- Alert Graph: no
- Alert Value: no
- Change: no
- Check Status: yes, that status checks are converted into Prometheus metrics in the background.
- Distribution : no
- Event Stream: no
- Event Timeline: no
- Free Text: no
- Geomap: no
- Group: yes
- HeatMap: no
- Hostmap: no
- Iframe: no
- Image: yes
- Links: no
- Log Stream: no
- Monitor Summary: no
- Network: no
- Notes : yes
- Query value: partial; each widget can only have a single query.
- Scatter Plot: no
- Service Level Objective (SLO): no
- Service Map: no
- Service Summary: no
- Table: partial; each widget can only have a single query and a basic attempt is made for splitting fields into their own columns.
- Timeseries: yes
- Top List: partial; each widget can only have a single query.
- Template Variables: yes
- Colors: no
- Events Overlay: no