Datadog

Data SourcePREMIUM

Datadog datasource

Premium plugins, along with support and assistance from the core team behind Grafana, are available with Grafana Enterprise.

Please sign up or log in to get started.

Sign Up

Grafana Datadog Datasource Plugin

The Grafana Datadog Datasource allows you to visualize metrics from the Datadog monitoring service in Grafana.

Usage

Query Editor

query editor

It's easy - select aggregation and metric. If you want to filter result, select one or more tags.

The Datadog datasource supports all of the advanced functions that the Datadog query editor. Select it from dropdown and arrange by clicking function name.

Alias by field usage possibilities:

  • Type in the alias into the "Alias by" field.

  • Use scoped variables:

    • $__metric = replaced with metric name
    • $__display_name = replaced with metric name
    • $__expression = replaced with full metric expression
    • $__aggr = replaced with metric aggregation function (e.g. avg, max, min, sum)
    • $__scope = replaced with metric scope (e.g. region, site, env, host)

scoped_vars

  • Use regular expressions:
    • Type in your regular expression in /you regexp here/flags format.<br>Example with metric expression = datadog.dogstatsd.packet.count{*} :<br> Alias by field input: /DOGstatsd\.(.*)\.(.*)/i Result: packet,count{*}

regexp

Annotations

annotations editor

An annotation is an event that is overlaid on top of graphs - an example of an event is a deployment or an outage. With this datasource, you can fetch events from Datadog and overlay them on graphs in Grafana. Annotations events can be filtered by source, tag or priority.

Templating

There are a few options for getting values of template variable - metrics, tags and hosts. To fetch the list of available metrics leave the Query field blank or specify *. For tags of type tag and for hosts use host. Filter results by using the Regex field. Multi-value variables are supported when using tags - multiple selected tag values will be converted into a comma separated list of tags.

Ad-hoc filters

There is a new special type of template variable in Grafana called Ad-hoc filters. This variable will apply to all the Datadog queries in a dashboard. This allows using it like a quick filter. An ad-hoc variable for Datadog fetches all the key-value pairs from tags, for example, region:east, region:west, and uses them as query tags. To create this variable, select the Ad-hoc filters type and choose your Datadog datasource. You can set any name for this variable.

Changelog

v1.1.0

  • Metric arithmetic using an Integer (mulitply a metric value by 100 for example)
  • Adds three Datadog functions:
    • Arithmetic -> Log10 function
    • Smoothing -> Auto Smoother
    • Regression -> Trend Line

v1.0.0

  • Improved Legend Formatting - The Alias By field in the Query Editor now allows you to specify which part of the metric name you want to use. It also now supports regexp for full control over the legend item/alias format.
Install Plugin

Version

Dependencies:
  • Grafana 3.x.x