Datadog Metrics API
The metrics endpoint allows you to:- Post metrics data so it can be graphed on Datadog’s dashboards- Query metrics from any time period (timeseries and scalar)- Modify tag configurations for metrics- View tags and volumes for metrics**Note**: A graph can only contain a set number of pointsand as the timeframe over which a metric is viewed increases,aggregation between points occurs to stay below that set number.The Post, Patch, and Delete `manage_tags` API methods can only be performed bya user who has the `Manage Tags for Metrics` permission.See the [Metrics page](https://docs.datadoghq.com/metrics/) for more information.
Datadog Metrics API is one of 290 APIs that Datadog publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
This API exposes 4 JSON Schema definitions.
Tagged areas include Metrics. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, authentication docs, an API reference, and 4 JSON Schemas.
This API exposes 26 operations across 16 paths, and defines 173 schemas. It is described by OpenAPI 3.0.0, at version 1.0.
Requests are made against 3 base URLs: https://{subdomain}.{site}, {protocol}://{name}, https://{subdomain}.{site}.
26 operations
16 paths
173 schemas
4 DELETE10 GET3 PATCH9 POST
Metadata
The identity and technical contract details declared by the specification.
Authentication & Security 4
Datadog Metrics API declares
4 security schemes
for authenticating requests.
It supports OAuth 2.0 (AuthZ) using the authorizationCode flow, exposing 68 scopes.
An API key is passed in the header as DD-API-KEY (apiKeyAuth).
An API key is passed in the header as DD-APPLICATION-KEY (appKeyAuth).
It accepts HTTP bearer tokens (bearerAuth).
By default, every request must be authenticated.
AuthZ— This API uses OAuth 2 with the implicit grant flow.apiKeyAuth— Your Datadog API Key.appKeyAuth— Your Datadog APP Key.
Paths & Operations 26
Across 16 paths, the API surfaces 26 operations — 4 DELETE, 10 GET, 3 PATCH, 9 POST. Each is listed below with its method, path, parameters, and response codes.
Metrics 26
The metrics endpoint allows you to: - Post metrics data so it can be graphed on Datadog’s dashboards - Query metrics from any time period (timeseries and scalar) - Modify tag conf…
GET
/api/v2/apm/config/metrics
Datadog Get All Span-based Metrics
POST
/api/v2/apm/config/metrics
Datadog Create a Span-based Metric
DELETE
/api/v2/apm/config/metrics/{metric_id}
Datadog Delete a Span-based Metric
GET
/api/v2/apm/config/metrics/{metric_id}
Datadog Get a Span-based Metric
PATCH
/api/v2/apm/config/metrics/{metric_id}
Datadog Update a Span-based Metric
POST
/api/v2/dora/deployment
Datadog Send a Deployment Event for Dora Metrics
POST
/api/v2/dora/incident
Datadog Send an Incident Event for Dora Metrics
GET
/api/v2/logs/config/metrics
Datadog Get All Log-based Metrics
POST
/api/v2/logs/config/metrics
Datadog Create a Log-based Metric
DELETE
/api/v2/logs/config/metrics/{metric_id}
Datadog Delete a Log-based Metric
GET
/api/v2/logs/config/metrics/{metric_id}
Datadog Get a Log-based Metric
PATCH
/api/v2/logs/config/metrics/{metric_id}
Datadog Update a Log-based Metric
GET
/api/v2/metrics
Datadog Get a List of Metrics
DELETE
/api/v2/metrics/config/bulk-tags
Datadog Delete Tags for Multiple Metrics
POST
/api/v2/metrics/config/bulk-tags
Datadog Configure Tags for Multiple Metrics
GET
/api/v2/metrics/{metric_name}/all-tags
Datadog List Tags by Metric Name
GET
/api/v2/metrics/{metric_name}/assets
Datadog Related Assets to a Metric
GET
/api/v2/metrics/{metric_name}/volumes
Datadog List Distinct Metric Volumes by Metric Name
GET
/api/v2/rum/config/metrics
Datadog Get All Rum-based Metrics
POST
/api/v2/rum/config/metrics
Datadog Create a Rum-based Metric
DELETE
/api/v2/rum/config/metrics/{metric_id}
Datadog Delete a Rum-based Metric
GET
/api/v2/rum/config/metrics/{metric_id}
Datadog Get a Rum-based Metric
PATCH
/api/v2/rum/config/metrics/{metric_id}
Datadog Update a Rum-based Metric
POST
/api/v2/series
Datadog Submit Metrics
POST
/api/v2/query/timeseries
Datadog Query Timeseries Data
POST
/api/v2/query/scalar
Datadog Query Scalar Data
Schemas 173
The contract defines 173 schemas that model the data the API accepts and returns. The most detailed are DORAIncidentRequestAttributes (10 properties), MetricSeries (9 properties), DORADeploymentRequestAttributes (8 properties), MetricTagConfigurationAttributes (7 properties). Each schema is shown below with its type and property counts.
LogsMetricResponseFilter
object
The log-based metric filter. Logs matching this filter will be aggregated in this metric.
1 property
GitCommitSHA
string
Git Commit SHA.
MetricScalarQuery
object
Request body for querying scalar metric data
1 property
1 required
MetricTimeseriesQuery
object
Request body for querying timeseries metric data
1 property
1 required
MetricMonitorType
string
Monitor resource type.
RumMetricUpdateRequest
object
The new rum-based metric body.
1 property
1 required
MetricDistinctVolume
object
Object for a single metric's distinct volume.
3 properties
JSONAPIErrorItem
object
API error response body
5 properties
SpansMetricComputeIncludePercentiles
boolean
Toggle to include or exclude percentile aggregations for distribution metrics. Only present when the aggregationtype is distribution.
MetricCustomAggregations
array
Deprecated. You no longer need to configure specific time and space aggregations for Metrics Without Limits.
APIErrorResponse_2
object
Standard API error response returned for failed requests
1 property
1 required
MetricBulkTagConfigDeleteRequest
object
Wrapper object for a single bulk tag deletion request.
1 property
1 required
MetricBulkTagConfigDelete
object
Request object to bulk delete all tag configurations for metrics matching the given prefix.
3 properties
2 required
MetricQueryDefinition
object
A metric query definition referencing a Datadog metrics query expression
3 properties
3 required
MetricScalarResponse
object
Response containing scalar metric values for the requested queries
1 property
MetricMetadata
object
Metadata for the metric.
1 property
MetricVolumes
Possible response objects for a metric's volume.
LogsMetricCreateAttributes
object
The object describing the Datadog log-based metric to create.
3 properties
1 required
LogsMetricResponseAttributes
object
The object describing a Datadog log-based metric.
3 properties
DORADeploymentRequestAttributes
object
Attributes to create a DORA deployment event.
8 properties
3 required
MetricCustomAggregation
object
A time and space aggregation combination for use in query.
2 properties
2 required
DORAGitInfo
object
Git info for DORA Metrics events.
2 properties
2 required
MetricAssetDashboardRelationship
object
An object of type dashboard that can be referenced in the included data.
2 properties
SpansMetricFilter
object
The span-based metric filter. Spans matching this filter will be aggregated in this metric.
1 property
RumMetricUniqueness
object
The rule to count updatable events. Is only set if eventtype is sessions or views.
1 property
1 required
MetricNotebookType
string
Notebook resource type.
MetricTagConfigurationType
string
The metric tag configuration resource type.
MetricResource
object
Metric resource.
2 properties
RumMetricType
string
The type of the resource. The value should always be rummetrics.
JSONAPIErrorResponse
object
API error response.
1 property
1 required
MetricDashboardAsset
object
A dashboard object with title and popularity.
3 properties
2 required
MetricPoint
object
A point object is of the form {POSIXtimestamp, numericvalue}.
2 properties
LogsMetricResponse
object
The log-based metric object.
1 property
DORAIncidentRequest
object
Request to create a DORA incident event.
1 property
1 required
SpansMetricUpdateCompute
object
The compute rule to compute the span-based metric.
1 property
SpansMetricResponseAttributes
object
The object describing a Datadog span-based metric.
3 properties
MetricIngestedIndexedVolume
object
Object for a single metric's ingested and indexed volume.
3 properties
MetricTagConfigurationMetricTypeCategory
string
The metric's type category.
MetricBulkTagConfigResponse
object
Wrapper for a single bulk tag configuration status response.
1 property
LogsMetricCreateRequest
object
The new log-based metric body.
1 property
1 required
RumMetricUpdateData
object
The new rum-based metric properties.
3 properties
2 required
SpansMetricGroupBy
object
A group by rule.
2 properties
1 required
DORAIncidentRequestAttributes
object
Attributes to create a DORA incident event.
10 properties
1 required
RumMetricComputeAggregationType
string
The type of aggregation to use.
MetricCustomSpaceAggregation
string
A space aggregation for use in query.
DORAIncidentResponseData
object
Response after receiving a DORA incident event.
2 properties
1 required
MetricPayload
object
The metrics' payload.
1 property
1 required
MetricIngestedIndexedVolumeType
string
The metric ingested and indexed volume type.
LogsMetricResponseGroupBy
object
A group by rule.
2 properties
MetricTagConfigurationMetricTypes
string
The metric's type.
SpansMetricUpdateRequest
object
The new span-based metric body.
1 property
1 required
MetricBulkTagConfigCreate
object
Request object to bulk configure tags for metrics matching the given prefix.
3 properties
2 required
SpansMetricCreateAttributes
object
The object describing the Datadog span-based metric to create.
3 properties
1 required
QueryFormula
object
A formula expression that combines one or more query results
3 properties
1 required
MetricMetaPage
object
Paging attributes. Only present if pagination query parameters were provided.
4 properties
MetricsListResponseLinks
object
Pagination links. Only present if pagination query parameters were provided.
5 properties
MetricAssetSLORelationship
object
An object of type slos that can be referenced in the included data.
2 properties
MetricBulkTagConfigNamePrefix
string
A text prefix to match against metric names.
LogsMetricUpdateCompute
object
The compute rule to compute the log-based metric.
1 property
MetricAssetDashboardRelationships
object
An object containing the list of dashboards that can be referenced in the included data.
1 property
MetricSLOAsset
object
A SLO object with title.
3 properties
2 required
MetricAssetAttributes
object
Assets related to the object, including title and url.
2 properties
MetricBulkTagConfigStatus
object
The status of a request to bulk configure metric tags. It contains the fields from the original request for reference.
3 properties
2 required
DORADeploymentType
string
JSON:API type for DORA deployment events.
MetricAssetResponseRelationships
object
Relationships to assets related to the metric.
4 properties
SpansMetricResponseCompute
object
The compute rule to compute the span-based metric.
3 properties
MetricTagConfigurationAttributes
object
Object containing the definition of a metric tag configuration attributes.
7 properties
LogsMetricsResponse
object
All the available log-based metric objects.
1 property
LogsMetricUpdateAttributes
object
The log-based metric properties that will be updated.
3 properties
JSONAPIErrorItemSource
object
References to the source of the error.
3 properties
MetricsAndMetricTagConfigurationsResponse
object
Response object that includes metrics and metric tag configurations.
3 properties
DORADeploymentRequest
object
Request to create a DORA deployment event.
1 property
1 required
MetricBulkTagConfigDeleteAttributes
object
Optional parameters for bulk deleting metric tag configurations.
1 property
MetricAssetNotebookRelationships
object
An object containing the list of notebooks that can be referenced in the included data.
1 property
MetricDistinctVolumeAttributes
object
Object containing the definition of a metric's distinct volume.
1 property
MetricBulkTagConfigTagNameList
array
A list of tag names to apply to the configuration.
MetricType
string
The metric resource type.
MetricNotebookAsset
object
A notebook object with title.
3 properties
2 required
MetricAssetNotebookRelationship
object
An object of type notebook that can be referenced in the included data.
2 properties
RumMetricID
string
The name of the rum-based metric.
MetricIngestedIndexedVolumeAttributes
object
Object containing the definition of a metric's ingested and indexed volume.
2 properties
DORAIncidentType
string
JSON:API type for DORA incident events.
RumMetricResponseGroupBy
object
A group by rule.
2 properties
TimeseriesResult
object
A single timeseries result for a query formula
4 properties
MetricAllTags
object
Object for a single metric's indexed tags.
3 properties
MetricBulkTagConfigStatusAttributes
object
Optional attributes for the status of a bulk tag configuration request.
4 properties
RumMetricComputeIncludePercentiles
boolean
Toggle to include or exclude percentile aggregations for distribution metrics. Only present when aggregationtype is distribution.
SpansMetricUpdateData
object
The new span-based metric properties.
2 properties
2 required
SpansMetricUpdateAttributes
object
The span-based metric properties that will be updated.
3 properties
DORADeploymentResponse
object
Response after receiving a DORA deployment event.
1 property
1 required
LogsMetricUpdateRequest
object
The new log-based metric body.
1 property
1 required
MetricsAndMetricTagConfigurations
Object for a metrics and metric tag configurations.
MetricAssetSLORelationships
object
An object containing a list of SLOs that can be referenced in the included data.
1 property
SpansMetricCreateRequest
object
The new span-based metric body.
1 property
1 required
APIErrorResponse
object
API error response.
1 property
1 required
LogsMetricID
string
The name of the log-based metric.
RumMetricResponseUniqueness
object
The rule to count updatable events. Is only set if eventtype is session or view.
1 property
MetricOrigin
object
Metric origin information.
3 properties
MetricSeries
object
A metric to submit to Datadog. See [Datadog metrics](https://docs.datadoghq.com/developers/metrics/custom-metrics-properties).
9 properties
2 required
SpansMetricResponseFilter
object
The span-based metric filter. Spans matching this filter will be aggregated in this metric.
1 property
MetricBulkConfigureTagsType
string
The metric bulk configure tags resource.
RumMetricResponseAttributes
object
The object describing a Datadog rum-based metric.
5 properties
RumMetricGroupBy
object
A group by rule.
2 properties
1 required
MetricMetaPageType
string
Type of metric pagination.
MetricAllTagsResponse
object
Response object that includes a single metric's indexed tags.
1 property
RumMetricEventType
string
The type of RUM events to filter on.
MetricDashboardID
string
The related dashboard's ID.
LogsMetricGroupBy
object
A group by rule.
2 properties
1 required
DORAIncidentRequestData
object
The JSON:API data.
1 property
1 required
SpansMetricCreateData
object
The new span-based metric properties.
3 properties
3 required
MetricAllTagsAttributes
object
Object containing the definition of a metric's tags.
1 property
MetricAssetMonitorRelationship
object
An object of type monitor that can be referenced in the included data.
2 properties
MetricMonitorID
string
The related monitor's ID.
RumMetricUniquenessWhen
string
When to count updatable events. match when the event is first seen, or end when the event is complete.
LogsMetricResponseCompute
object
The compute rule to compute the log-based metric.
3 properties
RumMetricCreateAttributes
object
The object describing the Datadog rum-based metric to create.
5 properties
2 required
SpansMetricResponseGroupBy
object
A group by rule.
2 properties
SpansMetricID
string
The name of the span-based metric.
IntakePayloadAccepted
object
The payload accepted for intake.
1 property
MetricBulkTagConfigEmailList
array
A list of account emails to notify when the configuration is applied.
RumMetricResponseCompute
object
The compute rule to compute the rum-based metric.
3 properties
MetricSLOID
string
The SLO ID.
SpansMetricsResponse
object
All the available span-based metric objects.
1 property
MetricTimeseriesResponse
object
Response containing timeseries metric data for the requested queries
1 property
DORADeploymentResponseData
object
The JSON:API data.
2 properties
1 required
MetricDashboardType
string
Dashboard resource type.
LogsMetricCompute
object
The compute rule to compute the log-based metric.
3 properties
1 required
GitRepositoryURL
string
Git Repository URL
MetricBulkTagConfigCreateRequest
object
Wrapper object for a single bulk tag configuration request.
1 property
1 required
RumMetricResponseData
object
The rum-based metric properties.
3 properties
LogsMetricComputeAggregationType
string
The type of aggregation to use.
Metric
object
Object for a single metric tag configuration.
2 properties
MetricIntakeType
integer
The type of metric. The available types are 0 (unspecified), 1 (count), 2 (rate), and 3 (gauge).
RumMetricResponse
object
The rum-based metric object.
1 property
MetricBulkTagConfigCreateAttributes
object
Optional parameters for bulk creating metric tag configurations.
5 properties
SpansMetricResponseData
object
The span-based metric properties.
3 properties
MetricName
string
The metric name for this resource.
RumMetricCompute
object
The compute rule to compute the rum-based metric.
3 properties
1 required
LogsMetricResponseComputeAggregationType
string
The type of aggregation to use.
MetricPaginationMeta
object
Response metadata object.
1 property
MetricDashboardAttributes
object
Attributes related to the dashboard, including title, popularity, and url.
3 properties
MetricMonitorAsset
object
A monitor object with title.
3 properties
2 required
LogsMetricCreateData
object
The new log-based metric properties.
3 properties
3 required
MetricTagConfiguration
object
Object for a single metric tag configuration.
3 properties
RumMetricsResponse
object
All the available rum-based metric objects.
1 property
MetricNotebookID
string
The related notebook's ID.
RumMetricUpdateAttributes
object
The rum-based metric properties that will be updated.
3 properties
MetricAssetResponseData
object
Metric assets response data.
3 properties
2 required
RumMetricResponseFilter
object
The rum-based metric filter. RUM events matching this filter will be aggregated in this metric.
1 property
LogsMetricFilter
object
The log-based metric filter. Logs matching this filter will be aggregated in this metric.
1 property
RumMetricFilter
object
The rum-based metric filter. Events matching this filter will be aggregated in this metric.
1 property
1 required
DORAIncidentResponse
object
Response after receiving a DORA incident event.
1 property
1 required
LogsMetricResponseData
object
The log-based metric properties.
3 properties
DORADeploymentRequestData
object
The JSON:API data.
1 property
1 required
RumMetricCreateData
object
The new rum-based metric properties.
3 properties
3 required
MetricAssetMonitorRelationships
object
A object containing the list of monitors that can be referenced in the included data.
1 property
MetricDistinctVolumeType
string
The metric distinct volume type.
MetricAssetsResponse
object
Response object that includes related dashboards, monitors, notebooks, and SLOs.
2 properties
SpansMetricType
string
The type of resource. The value should always be spansmetrics.
MetricVolumesResponse
object
Response object which includes a single metric's volume.
1 property
MetricContentEncoding
string
HTTP header used to compress the media-type.
ScalarColumn
object
A single column of scalar results from a query formula
3 properties
RumMetricUpdateCompute
object
The compute rule to compute the rum-based metric.
1 property
LogsMetricComputeIncludePercentiles
boolean
Toggle to include or exclude percentile aggregations for distribution metrics. Only present when the aggregationtype is distribution.
SpansMetricResponse
object
The span-based metric object.
1 property
SpansMetricCompute
object
The compute rule to compute the span-based metric.
3 properties
1 required
LogsMetricUpdateData
object
The new log-based metric properties.
2 properties
2 required
MetricAssetResponseIncluded
List of included assets with full set of attributes.
MetricSLOType
string
SLO resource type.
LogsMetricType
string
The type of the resource. The value should always be logsmetrics.
MetricCustomTimeAggregation
string
A time aggregation for use in query.
RumMetricCreateRequest
object
The new rum-based metric body.
1 property
1 required
SpansMetricComputeAggregationType
string
The type of aggregation to use.
Specification
The full machine-readable OpenAPI contract behind this narrative.
Source
More from Datadog 12
Other APIs Datadog publishes across the network.
Datadog Dashboards API
Datadog Synthetics API
Datadog Service Level Objectives API
Datadog Security Monitoring API
Datadog Service Definition API
Datadog Software Catalog API
Datadog Users API
Datadog Roles API
Datadog Key Management API
Datadog Organizations API
Datadog Downtimes API
Datadog RUM API
#Metrics
Where this information came from
This is an independent, third-party profile of Datadog Metrics API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.
The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.
Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.
info@apievangelist.com
·
Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and
you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.