How to graph percentiles in Datadog

Dogstatsd implementation

It's possible to get percentiles in Datadog by submitting data as a histogram metric through dogstatsd. The datadog-agent embeds a dogstatsd server that will receive dogstatsd packets, perform data aggregation, and send final percentile metrics to Datadog.

Since this aggregation is taken care of on the collection side, this isn't currently available as a graphing function in the GUI.

Out of your histogram data you'll get: 95th percentile, 50th percentile, avg, max, count. 

Additional percentiles

Via the "histogram_percentiles" line of the configuration file of the agent, you can get extra percentiles, e.g.:

histogram_percentiles: 0.95, 0.75

Local Aggregations

Histograms are computed every 10 seconds on a host per host basis by the datadog-agents. This collection model comes with its advantages and its limitations. 


  • Raw datapoints used to compute histogram metrics are not exposed nor relayed to our site.
  • Statsd handles the relevant aggregations and submits the calculated data package to our server directly.


  • If you have two reporting streams of aggregated data, it is not possible today to aggregate across the raw datapoints from both streams, only aggregate across the aggregates.
    • EX: Averaging across METRIC_NAME.Avg for all regions, takes the average stream values for each region and produces an average of averages.
  • Making a change to increase tag complexity (adding additional tags to be more specific) will lead to changes in the behavior of a rolled up metric visualization
    • EX: Whereas before the change METRIC_NAME.avg (without any tags) would be aggregating across all raw points (statsd takes all the raw datapoints, aggregates it and then ships over a single metric stream), adding a tag like region (US, EU) tag causes statsd to bin raw datapoints into two region bins, aggregate them, and ship over two streams. This means when graphing METRIC_NAME.avg AVG by * means an aggregate across the two streams rather than a single one

Read more about that here:

Have more questions? Submit a request


Please sign in to leave a comment.
Powered by Zendesk