Skip to content
Branch: master
Find file Copy path
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
64 lines (38 sloc) 2.56 KB

OpenMetrics Integration


Extract custom metrics from any OpenMetrics endpoints.

Note: All the metrics retrieved by this integration are considered as custom metrics.


Find below instructions to install and configure the check when running the Agent on a host. See the Autodiscovery Integration Templates documentation to learn how to apply those instructions to a containerized environment.


The OpenMetrics check is packaged with the Datadog Agent starting version 6.6.0.


Edit the openmetrics.d/conf.yaml file at the root of your Agent's configuration directory to add the different OpenMetrics instances you want to retrieve metrics from.

Each instance is at least composed of the following parameters:

  • prometheus_url: Points to the metric route (Note: it must be unique)
  • namespace: Namespace to be prepended to all metrics (allows to avoid metrics name collision)
  • metrics: A list of metrics that you want to retrieve as custom metrics, for each metric you can either simply add it to the list - metric_name or renaming it like - metric_name: renamed. It's also possible to use a * wildcard such as - metric* that fetches all matching metrics (to use with caution as it can potentially send a lot of custom metrics).

There is also a couple of more advanced settings (ssl, labels joining, tags,...) that are documented in the conf.yaml example configuration


Run the Agent's status subcommand and look for openmetrics under the Checks section.

Data Collected


All metrics collected by the OpenMetrics check are forwarded to Datadog as custom metrics.


The OpenMetrics check does not include any events.

Service Checks

The OpenMetrics check does not include any service checks.


Need help? Contact Datadog support.

Further Reading

You can’t perform that action at this time.