Les endpoints de métriques vous permettent :

  • D’envoyer des données de métriques afin de les représenter graphiquement sur les dashboards de Datadog
  • D’interroger vos métriques sur l’intervalle de votre choix (séries temporelles et scalaires)
  • De modifier les configurations de tags pour les métriques
  • De visualiser les tags et les volumes pour les métriques

Remarque : un graphique ne peut contenir qu’un nombre défini de points. Lorsque l’intervalle d’affichage d’une métrique augmente, les points sont agrégés afin de ne pas dépasser ce nombre. Les méthodes Post, Patch et Delete de l’API manage_tags peuvent uniquement être utilisées par un utilisateur qui dispose de l’autorisation Manage Tags for Metrics.

Consultez la page relative aux métriques pour en savoir plus.

Create a tag configuration

POST https://api.ap1.datadoghq.com/api/v2/metrics/{metric_name}/tagshttps://api.ap2.datadoghq.com/api/v2/metrics/{metric_name}/tagshttps://api.datadoghq.eu/api/v2/metrics/{metric_name}/tagshttps://api.ddog-gov.com/api/v2/metrics/{metric_name}/tagshttps://api.us2.ddog-gov.com/api/v2/metrics/{metric_name}/tagshttps://api.datadoghq.com/api/v2/metrics/{metric_name}/tagshttps://api.us3.datadoghq.com/api/v2/metrics/{metric_name}/tagshttps://api.us5.datadoghq.com/api/v2/metrics/{metric_name}/tags

Get active metrics list

GET https://api.ap1.datadoghq.com/api/v1/metricshttps://api.ap2.datadoghq.com/api/v1/metricshttps://api.datadoghq.eu/api/v1/metricshttps://api.ddog-gov.com/api/v1/metricshttps://api.us2.ddog-gov.com/api/v1/metricshttps://api.datadoghq.com/api/v1/metricshttps://api.us3.datadoghq.com/api/v1/metricshttps://api.us5.datadoghq.com/api/v1/metrics

Get metric metadata

GET https://api.ap1.datadoghq.com/api/v1/metrics/{metric_name}https://api.ap2.datadoghq.com/api/v1/metrics/{metric_name}https://api.datadoghq.eu/api/v1/metrics/{metric_name}https://api.ddog-gov.com/api/v1/metrics/{metric_name}https://api.us2.ddog-gov.com/api/v1/metrics/{metric_name}https://api.datadoghq.com/api/v1/metrics/{metric_name}https://api.us3.datadoghq.com/api/v1/metrics/{metric_name}https://api.us5.datadoghq.com/api/v1/metrics/{metric_name}

List tag configuration by name

GET https://api.ap1.datadoghq.com/api/v2/metrics/{metric_name}/tagshttps://api.ap2.datadoghq.com/api/v2/metrics/{metric_name}/tagshttps://api.datadoghq.eu/api/v2/metrics/{metric_name}/tagshttps://api.ddog-gov.com/api/v2/metrics/{metric_name}/tagshttps://api.us2.ddog-gov.com/api/v2/metrics/{metric_name}/tagshttps://api.datadoghq.com/api/v2/metrics/{metric_name}/tagshttps://api.us3.datadoghq.com/api/v2/metrics/{metric_name}/tagshttps://api.us5.datadoghq.com/api/v2/metrics/{metric_name}/tags

Edit metric metadata

PUT https://api.ap1.datadoghq.com/api/v1/metrics/{metric_name}https://api.ap2.datadoghq.com/api/v1/metrics/{metric_name}https://api.datadoghq.eu/api/v1/metrics/{metric_name}https://api.ddog-gov.com/api/v1/metrics/{metric_name}https://api.us2.ddog-gov.com/api/v1/metrics/{metric_name}https://api.datadoghq.com/api/v1/metrics/{metric_name}https://api.us3.datadoghq.com/api/v1/metrics/{metric_name}https://api.us5.datadoghq.com/api/v1/metrics/{metric_name}

Update a tag configuration

PATCH https://api.ap1.datadoghq.com/api/v2/metrics/{metric_name}/tagshttps://api.ap2.datadoghq.com/api/v2/metrics/{metric_name}/tagshttps://api.datadoghq.eu/api/v2/metrics/{metric_name}/tagshttps://api.ddog-gov.com/api/v2/metrics/{metric_name}/tagshttps://api.us2.ddog-gov.com/api/v2/metrics/{metric_name}/tagshttps://api.datadoghq.com/api/v2/metrics/{metric_name}/tagshttps://api.us3.datadoghq.com/api/v2/metrics/{metric_name}/tagshttps://api.us5.datadoghq.com/api/v2/metrics/{metric_name}/tags

Delete a tag configuration

DELETE https://api.ap1.datadoghq.com/api/v2/metrics/{metric_name}/tagshttps://api.ap2.datadoghq.com/api/v2/metrics/{metric_name}/tagshttps://api.datadoghq.eu/api/v2/metrics/{metric_name}/tagshttps://api.ddog-gov.com/api/v2/metrics/{metric_name}/tagshttps://api.us2.ddog-gov.com/api/v2/metrics/{metric_name}/tagshttps://api.datadoghq.com/api/v2/metrics/{metric_name}/tagshttps://api.us3.datadoghq.com/api/v2/metrics/{metric_name}/tagshttps://api.us5.datadoghq.com/api/v2/metrics/{metric_name}/tags

Search metrics deprecated

GET https://api.ap1.datadoghq.com/api/v1/searchhttps://api.ap2.datadoghq.com/api/v1/searchhttps://api.datadoghq.eu/api/v1/searchhttps://api.ddog-gov.com/api/v1/searchhttps://api.us2.ddog-gov.com/api/v1/searchhttps://api.datadoghq.com/api/v1/searchhttps://api.us3.datadoghq.com/api/v1/searchhttps://api.us5.datadoghq.com/api/v1/search

Get a list of metrics

GET https://api.ap1.datadoghq.com/api/v2/metricshttps://api.ap2.datadoghq.com/api/v2/metricshttps://api.datadoghq.eu/api/v2/metricshttps://api.ddog-gov.com/api/v2/metricshttps://api.us2.ddog-gov.com/api/v2/metricshttps://api.datadoghq.com/api/v2/metricshttps://api.us3.datadoghq.com/api/v2/metricshttps://api.us5.datadoghq.com/api/v2/metrics

Query timeseries points

GET https://api.ap1.datadoghq.com/api/v1/queryhttps://api.ap2.datadoghq.com/api/v1/queryhttps://api.datadoghq.eu/api/v1/queryhttps://api.ddog-gov.com/api/v1/queryhttps://api.us2.ddog-gov.com/api/v1/queryhttps://api.datadoghq.com/api/v1/queryhttps://api.us3.datadoghq.com/api/v1/queryhttps://api.us5.datadoghq.com/api/v1/query

List tags by metric name

GET https://api.ap1.datadoghq.com/api/v2/metrics/{metric_name}/all-tagshttps://api.ap2.datadoghq.com/api/v2/metrics/{metric_name}/all-tagshttps://api.datadoghq.eu/api/v2/metrics/{metric_name}/all-tagshttps://api.ddog-gov.com/api/v2/metrics/{metric_name}/all-tagshttps://api.us2.ddog-gov.com/api/v2/metrics/{metric_name}/all-tagshttps://api.datadoghq.com/api/v2/metrics/{metric_name}/all-tagshttps://api.us3.datadoghq.com/api/v2/metrics/{metric_name}/all-tagshttps://api.us5.datadoghq.com/api/v2/metrics/{metric_name}/all-tags

Submit metrics

POST https://api.ap1.datadoghq.com/api/v2/serieshttps://api.ap2.datadoghq.com/api/v2/serieshttps://api.datadoghq.eu/api/v2/serieshttps://api.ddog-gov.com/api/v2/serieshttps://api.us2.ddog-gov.com/api/v2/serieshttps://api.datadoghq.com/api/v2/serieshttps://api.us3.datadoghq.com/api/v2/serieshttps://api.us5.datadoghq.com/api/v2/series

List active tags and aggregations

GET https://api.ap1.datadoghq.com/api/v2/metrics/{metric_name}/active-configurationshttps://api.ap2.datadoghq.com/api/v2/metrics/{metric_name}/active-configurationshttps://api.datadoghq.eu/api/v2/metrics/{metric_name}/active-configurationshttps://api.ddog-gov.com/api/v2/metrics/{metric_name}/active-configurationshttps://api.us2.ddog-gov.com/api/v2/metrics/{metric_name}/active-configurationshttps://api.datadoghq.com/api/v2/metrics/{metric_name}/active-configurationshttps://api.us3.datadoghq.com/api/v2/metrics/{metric_name}/active-configurationshttps://api.us5.datadoghq.com/api/v2/metrics/{metric_name}/active-configurations

Submit distribution points

POST https://api.ap1.datadoghq.com/api/v1/distribution_pointshttps://api.ap2.datadoghq.com/api/v1/distribution_pointshttps://api.datadoghq.eu/api/v1/distribution_pointshttps://api.ddog-gov.com/api/v1/distribution_pointshttps://api.us2.ddog-gov.com/api/v1/distribution_pointshttps://api.datadoghq.com/api/v1/distribution_pointshttps://api.us3.datadoghq.com/api/v1/distribution_pointshttps://api.us5.datadoghq.com/api/v1/distribution_points

List distinct metric volumes by metric name

GET https://api.ap1.datadoghq.com/api/v2/metrics/{metric_name}/volumeshttps://api.ap2.datadoghq.com/api/v2/metrics/{metric_name}/volumeshttps://api.datadoghq.eu/api/v2/metrics/{metric_name}/volumeshttps://api.ddog-gov.com/api/v2/metrics/{metric_name}/volumeshttps://api.us2.ddog-gov.com/api/v2/metrics/{metric_name}/volumeshttps://api.datadoghq.com/api/v2/metrics/{metric_name}/volumeshttps://api.us3.datadoghq.com/api/v2/metrics/{metric_name}/volumeshttps://api.us5.datadoghq.com/api/v2/metrics/{metric_name}/volumes

Configure tags for multiple metrics deprecated

POST https://api.ap1.datadoghq.com/api/v2/metrics/config/bulk-tagshttps://api.ap2.datadoghq.com/api/v2/metrics/config/bulk-tagshttps://api.datadoghq.eu/api/v2/metrics/config/bulk-tagshttps://api.ddog-gov.com/api/v2/metrics/config/bulk-tagshttps://api.us2.ddog-gov.com/api/v2/metrics/config/bulk-tagshttps://api.datadoghq.com/api/v2/metrics/config/bulk-tagshttps://api.us3.datadoghq.com/api/v2/metrics/config/bulk-tagshttps://api.us5.datadoghq.com/api/v2/metrics/config/bulk-tags

Delete tags for multiple metrics deprecated

DELETE https://api.ap1.datadoghq.com/api/v2/metrics/config/bulk-tagshttps://api.ap2.datadoghq.com/api/v2/metrics/config/bulk-tagshttps://api.datadoghq.eu/api/v2/metrics/config/bulk-tagshttps://api.ddog-gov.com/api/v2/metrics/config/bulk-tagshttps://api.us2.ddog-gov.com/api/v2/metrics/config/bulk-tagshttps://api.datadoghq.com/api/v2/metrics/config/bulk-tagshttps://api.us3.datadoghq.com/api/v2/metrics/config/bulk-tagshttps://api.us5.datadoghq.com/api/v2/metrics/config/bulk-tags

Tag Configuration Cardinality Estimator

GET https://api.ap1.datadoghq.com/api/v2/metrics/{metric_name}/estimatehttps://api.ap2.datadoghq.com/api/v2/metrics/{metric_name}/estimatehttps://api.datadoghq.eu/api/v2/metrics/{metric_name}/estimatehttps://api.ddog-gov.com/api/v2/metrics/{metric_name}/estimatehttps://api.us2.ddog-gov.com/api/v2/metrics/{metric_name}/estimatehttps://api.datadoghq.com/api/v2/metrics/{metric_name}/estimatehttps://api.us3.datadoghq.com/api/v2/metrics/{metric_name}/estimatehttps://api.us5.datadoghq.com/api/v2/metrics/{metric_name}/estimate

GET https://api.ap1.datadoghq.com/api/v2/metrics/{metric_name}/assetshttps://api.ap2.datadoghq.com/api/v2/metrics/{metric_name}/assetshttps://api.datadoghq.eu/api/v2/metrics/{metric_name}/assetshttps://api.ddog-gov.com/api/v2/metrics/{metric_name}/assetshttps://api.us2.ddog-gov.com/api/v2/metrics/{metric_name}/assetshttps://api.datadoghq.com/api/v2/metrics/{metric_name}/assetshttps://api.us3.datadoghq.com/api/v2/metrics/{metric_name}/assetshttps://api.us5.datadoghq.com/api/v2/metrics/{metric_name}/assets

Get tag key cardinality details

GET https://api.ap1.datadoghq.com/api/v2/metrics/{metric_name}/tag-cardinalitieshttps://api.ap2.datadoghq.com/api/v2/metrics/{metric_name}/tag-cardinalitieshttps://api.datadoghq.eu/api/v2/metrics/{metric_name}/tag-cardinalitieshttps://api.ddog-gov.com/api/v2/metrics/{metric_name}/tag-cardinalitieshttps://api.us2.ddog-gov.com/api/v2/metrics/{metric_name}/tag-cardinalitieshttps://api.datadoghq.com/api/v2/metrics/{metric_name}/tag-cardinalitieshttps://api.us3.datadoghq.com/api/v2/metrics/{metric_name}/tag-cardinalitieshttps://api.us5.datadoghq.com/api/v2/metrics/{metric_name}/tag-cardinalities

Query timeseries data across multiple products

POST https://api.ap1.datadoghq.com/api/v2/query/timeserieshttps://api.ap2.datadoghq.com/api/v2/query/timeserieshttps://api.datadoghq.eu/api/v2/query/timeserieshttps://api.ddog-gov.com/api/v2/query/timeserieshttps://api.us2.ddog-gov.com/api/v2/query/timeserieshttps://api.datadoghq.com/api/v2/query/timeserieshttps://api.us3.datadoghq.com/api/v2/query/timeserieshttps://api.us5.datadoghq.com/api/v2/query/timeseries

Query scalar data across multiple products

POST https://api.ap1.datadoghq.com/api/v2/query/scalarhttps://api.ap2.datadoghq.com/api/v2/query/scalarhttps://api.datadoghq.eu/api/v2/query/scalarhttps://api.ddog-gov.com/api/v2/query/scalarhttps://api.us2.ddog-gov.com/api/v2/query/scalarhttps://api.datadoghq.com/api/v2/query/scalarhttps://api.us3.datadoghq.com/api/v2/query/scalarhttps://api.us5.datadoghq.com/api/v2/query/scalar

List tag indexing rules

GET https://api.ap1.datadoghq.com/api/v2/metrics/tag-indexing-ruleshttps://api.ap2.datadoghq.com/api/v2/metrics/tag-indexing-ruleshttps://api.datadoghq.eu/api/v2/metrics/tag-indexing-ruleshttps://api.ddog-gov.com/api/v2/metrics/tag-indexing-ruleshttps://api.us2.ddog-gov.com/api/v2/metrics/tag-indexing-ruleshttps://api.datadoghq.com/api/v2/metrics/tag-indexing-ruleshttps://api.us3.datadoghq.com/api/v2/metrics/tag-indexing-ruleshttps://api.us5.datadoghq.com/api/v2/metrics/tag-indexing-rules

Create a tag indexing rule

POST https://api.ap1.datadoghq.com/api/v2/metrics/tag-indexing-ruleshttps://api.ap2.datadoghq.com/api/v2/metrics/tag-indexing-ruleshttps://api.datadoghq.eu/api/v2/metrics/tag-indexing-ruleshttps://api.ddog-gov.com/api/v2/metrics/tag-indexing-ruleshttps://api.us2.ddog-gov.com/api/v2/metrics/tag-indexing-ruleshttps://api.datadoghq.com/api/v2/metrics/tag-indexing-ruleshttps://api.us3.datadoghq.com/api/v2/metrics/tag-indexing-ruleshttps://api.us5.datadoghq.com/api/v2/metrics/tag-indexing-rules

Reorder tag indexing rules

POST https://api.ap1.datadoghq.com/api/v2/metrics/tag-indexing-rules/orderhttps://api.ap2.datadoghq.com/api/v2/metrics/tag-indexing-rules/orderhttps://api.datadoghq.eu/api/v2/metrics/tag-indexing-rules/orderhttps://api.ddog-gov.com/api/v2/metrics/tag-indexing-rules/orderhttps://api.us2.ddog-gov.com/api/v2/metrics/tag-indexing-rules/orderhttps://api.datadoghq.com/api/v2/metrics/tag-indexing-rules/orderhttps://api.us3.datadoghq.com/api/v2/metrics/tag-indexing-rules/orderhttps://api.us5.datadoghq.com/api/v2/metrics/tag-indexing-rules/order

Get a tag indexing rule

GET https://api.ap1.datadoghq.com/api/v2/metrics/tag-indexing-rules/{id}https://api.ap2.datadoghq.com/api/v2/metrics/tag-indexing-rules/{id}https://api.datadoghq.eu/api/v2/metrics/tag-indexing-rules/{id}https://api.ddog-gov.com/api/v2/metrics/tag-indexing-rules/{id}https://api.us2.ddog-gov.com/api/v2/metrics/tag-indexing-rules/{id}https://api.datadoghq.com/api/v2/metrics/tag-indexing-rules/{id}https://api.us3.datadoghq.com/api/v2/metrics/tag-indexing-rules/{id}https://api.us5.datadoghq.com/api/v2/metrics/tag-indexing-rules/{id}

Update a tag indexing rule

PUT https://api.ap1.datadoghq.com/api/v2/metrics/tag-indexing-rules/{id}https://api.ap2.datadoghq.com/api/v2/metrics/tag-indexing-rules/{id}https://api.datadoghq.eu/api/v2/metrics/tag-indexing-rules/{id}https://api.ddog-gov.com/api/v2/metrics/tag-indexing-rules/{id}https://api.us2.ddog-gov.com/api/v2/metrics/tag-indexing-rules/{id}https://api.datadoghq.com/api/v2/metrics/tag-indexing-rules/{id}https://api.us3.datadoghq.com/api/v2/metrics/tag-indexing-rules/{id}https://api.us5.datadoghq.com/api/v2/metrics/tag-indexing-rules/{id}

Delete a tag indexing rule

DELETE https://api.ap1.datadoghq.com/api/v2/metrics/tag-indexing-rules/{id}https://api.ap2.datadoghq.com/api/v2/metrics/tag-indexing-rules/{id}https://api.datadoghq.eu/api/v2/metrics/tag-indexing-rules/{id}https://api.ddog-gov.com/api/v2/metrics/tag-indexing-rules/{id}https://api.us2.ddog-gov.com/api/v2/metrics/tag-indexing-rules/{id}https://api.datadoghq.com/api/v2/metrics/tag-indexing-rules/{id}https://api.us3.datadoghq.com/api/v2/metrics/tag-indexing-rules/{id}https://api.us5.datadoghq.com/api/v2/metrics/tag-indexing-rules/{id}

List tag indexing rules for a metric

GET https://api.ap1.datadoghq.com/api/v2/metrics/{metric_name}/tag-indexing-ruleshttps://api.ap2.datadoghq.com/api/v2/metrics/{metric_name}/tag-indexing-ruleshttps://api.datadoghq.eu/api/v2/metrics/{metric_name}/tag-indexing-ruleshttps://api.ddog-gov.com/api/v2/metrics/{metric_name}/tag-indexing-ruleshttps://api.us2.ddog-gov.com/api/v2/metrics/{metric_name}/tag-indexing-ruleshttps://api.datadoghq.com/api/v2/metrics/{metric_name}/tag-indexing-ruleshttps://api.us3.datadoghq.com/api/v2/metrics/{metric_name}/tag-indexing-ruleshttps://api.us5.datadoghq.com/api/v2/metrics/{metric_name}/tag-indexing-rules

Get a tag indexing rule exemption

GET https://api.ap1.datadoghq.com/api/v2/metrics/{metric_name}/tag-indexing-rule-exemptionshttps://api.ap2.datadoghq.com/api/v2/metrics/{metric_name}/tag-indexing-rule-exemptionshttps://api.datadoghq.eu/api/v2/metrics/{metric_name}/tag-indexing-rule-exemptionshttps://api.ddog-gov.com/api/v2/metrics/{metric_name}/tag-indexing-rule-exemptionshttps://api.us2.ddog-gov.com/api/v2/metrics/{metric_name}/tag-indexing-rule-exemptionshttps://api.datadoghq.com/api/v2/metrics/{metric_name}/tag-indexing-rule-exemptionshttps://api.us3.datadoghq.com/api/v2/metrics/{metric_name}/tag-indexing-rule-exemptionshttps://api.us5.datadoghq.com/api/v2/metrics/{metric_name}/tag-indexing-rule-exemptions

Create a tag indexing rule exemption

POST https://api.ap1.datadoghq.com/api/v2/metrics/{metric_name}/tag-indexing-rule-exemptionshttps://api.ap2.datadoghq.com/api/v2/metrics/{metric_name}/tag-indexing-rule-exemptionshttps://api.datadoghq.eu/api/v2/metrics/{metric_name}/tag-indexing-rule-exemptionshttps://api.ddog-gov.com/api/v2/metrics/{metric_name}/tag-indexing-rule-exemptionshttps://api.us2.ddog-gov.com/api/v2/metrics/{metric_name}/tag-indexing-rule-exemptionshttps://api.datadoghq.com/api/v2/metrics/{metric_name}/tag-indexing-rule-exemptionshttps://api.us3.datadoghq.com/api/v2/metrics/{metric_name}/tag-indexing-rule-exemptionshttps://api.us5.datadoghq.com/api/v2/metrics/{metric_name}/tag-indexing-rule-exemptions

Delete a tag indexing rule exemption

DELETE https://api.ap1.datadoghq.com/api/v2/metrics/{metric_name}/tag-indexing-rule-exemptionshttps://api.ap2.datadoghq.com/api/v2/metrics/{metric_name}/tag-indexing-rule-exemptionshttps://api.datadoghq.eu/api/v2/metrics/{metric_name}/tag-indexing-rule-exemptionshttps://api.ddog-gov.com/api/v2/metrics/{metric_name}/tag-indexing-rule-exemptionshttps://api.us2.ddog-gov.com/api/v2/metrics/{metric_name}/tag-indexing-rule-exemptionshttps://api.datadoghq.com/api/v2/metrics/{metric_name}/tag-indexing-rule-exemptionshttps://api.us3.datadoghq.com/api/v2/metrics/{metric_name}/tag-indexing-rule-exemptionshttps://api.us5.datadoghq.com/api/v2/metrics/{metric_name}/tag-indexing-rule-exemptions