{ "opencollection": "1.0.0", "info": { "name": "Datadog Account Metrics API", "version": "1.0" }, "request": { "auth": { "type": "apikey", "key": "DD-API-KEY", "value": "{{DD-API-KEY}}", "placement": "header" } }, "items": [ { "info": { "name": "Metrics", "type": "folder" }, "items": [ { "info": { "name": "Datadog Get All Span-based Metrics", "type": "http" }, "http": { "method": "GET", "url": "https://{subdomain}.{site}/api/v2/apm/config/metrics" }, "docs": "Get the list of configured span-based metrics with their definitions." }, { "info": { "name": "Datadog Create a Span-based Metric", "type": "http" }, "http": { "method": "POST", "url": "https://{subdomain}.{site}/api/v2/apm/config/metrics", "body": { "type": "json", "data": "{}" } }, "docs": "Create a metric based on your ingested spans in your organization.\nReturns the span-based metric object from the request body when the request is successful." }, { "info": { "name": "Datadog Get a Span-based Metric", "type": "http" }, "http": { "method": "GET", "url": "https://{subdomain}.{site}/api/v2/apm/config/metrics/:metric_id", "params": [ { "name": "metric_id", "value": "", "type": "path", "description": "The name of the span-based metric." } ] }, "docs": "Get a specific span-based metric from your organization." }, { "info": { "name": "Datadog Update a Span-based Metric", "type": "http" }, "http": { "method": "PATCH", "url": "https://{subdomain}.{site}/api/v2/apm/config/metrics/:metric_id", "params": [ { "name": "metric_id", "value": "", "type": "path", "description": "The name of the span-based metric." } ], "body": { "type": "json", "data": "{}" } }, "docs": "Update a specific span-based metric from your organization.\nReturns the span-based metric object from the request body when the request is successful." }, { "info": { "name": "Datadog Delete a Span-based Metric", "type": "http" }, "http": { "method": "DELETE", "url": "https://{subdomain}.{site}/api/v2/apm/config/metrics/:metric_id", "params": [ { "name": "metric_id", "value": "", "type": "path", "description": "The name of the span-based metric." } ] }, "docs": "Delete a specific span-based metric from your organization." }, { "info": { "name": "Datadog Send a Deployment Event for Dora Metrics", "type": "http" }, "http": { "method": "POST", "url": "https://{subdomain}.{site}/api/v2/dora/deployment", "body": { "type": "json", "data": "{}" }, "auth": { "type": "apikey", "key": "DD-API-KEY", "value": "{{DD-API-KEY}}", "placement": "header" } }, "docs": "Use this API endpoint to provide data about deployments for DORA metrics.\n\nThis is necessary for:\n- Deployment Frequency\n- Change Lead Time\n- Change Failure Rate" }, { "info": { "name": "Datadog Send an Incident Event for Dora Metrics", "type": "http" }, "http": { "method": "POST", "url": "https://{subdomain}.{site}/api/v2/dora/incident", "body": { "type": "json", "data": "{}" }, "auth": { "type": "apikey", "key": "DD-API-KEY", "value": "{{DD-API-KEY}}", "placement": "header" } }, "docs": "Use this API endpoint to provide failure data for DORA metrics.\n\nThis is necessary for:\n- Change Failure Rate\n- Time to Restore" }, { "info": { "name": "Datadog Get All Log-based Metrics", "type": "http" }, "http": { "method": "GET", "url": "https://{subdomain}.{site}/api/v2/logs/config/metrics" }, "docs": "Get the list of configured log-based metrics with their definitions." }, { "info": { "name": "Datadog Create a Log-based Metric", "type": "http" }, "http": { "method": "POST", "url": "https://{subdomain}.{site}/api/v2/logs/config/metrics", "body": { "type": "json", "data": "{}" } }, "docs": "Create a metric based on your ingested logs in your organization.\nReturns the log-based metric object from the request body when the request is successful." }, { "info": { "name": "Datadog Get a Log-based Metric", "type": "http" }, "http": { "method": "GET", "url": "https://{subdomain}.{site}/api/v2/logs/config/metrics/:metric_id", "params": [ { "name": "metric_id", "value": "", "type": "path", "description": "The name of the log-based metric." } ] }, "docs": "Get a specific log-based metric from your organization." }, { "info": { "name": "Datadog Update a Log-based Metric", "type": "http" }, "http": { "method": "PATCH", "url": "https://{subdomain}.{site}/api/v2/logs/config/metrics/:metric_id", "params": [ { "name": "metric_id", "value": "", "type": "path", "description": "The name of the log-based metric." } ], "body": { "type": "json", "data": "{}" } }, "docs": "Update a specific log-based metric from your organization.\nReturns the log-based metric object from the request body when the request is successful." }, { "info": { "name": "Datadog Delete a Log-based Metric", "type": "http" }, "http": { "method": "DELETE", "url": "https://{subdomain}.{site}/api/v2/logs/config/metrics/:metric_id", "params": [ { "name": "metric_id", "value": "", "type": "path", "description": "The name of the log-based metric." } ] }, "docs": "Delete a specific log-based metric from your organization." }, { "info": { "name": "Datadog Get a List of Metrics", "type": "http" }, "http": { "method": "GET", "url": "https://{subdomain}.{site}/api/v2/metrics", "params": [ { "name": "filter[configured]", "value": "true", "type": "query", "description": "Filter custom metrics that have configured tags." }, { "name": "filter[tags_configured]", "value": "app", "type": "query", "description": "Filter tag configurations by configured tags." }, { "name": "filter[metric_type]", "value": "metric alert", "type": "query", "description": "Filter metrics by metric type." }, { "name": "filter[include_percentiles]", "value": "true", "type": "query", "description": "Filter distributions with additional percentile\naggregations enabled or disabled." }, { "name": "filter[queried]", "value": "true", "type": "query", "description": "(Preview) Filter custom metrics that have or have not been queried in the specified window[seconds].\nIf no window is provided or the window is less than 2 hours, a default of 2 hours will be applied." }, { "name": "filter[tags]", "value": "env IN (staging,test) AND service:web", "type": "query", "description": "Filter metrics that have been submitted with the given tags. Supports boolean and wildcard expressions.\nCan only be combined with the filter[queried] filter." }, { "name": "filter[related_assets]", "value": "true", "type": "query", "description": "(Preview) Filter metrics that are used in dashboards, monitors, notebooks, SLOs." }, { "name": "window[seconds]", "value": "3600", "type": "query", "description": "The number of seconds of look back (from now) to apply to a filter[tag] or filter[queried] query.\nDefault value is 3600 (1 hour), maximum value is 2,592,000 (30 days)." }, { "name": "page[size]", "value": "42", "type": "query", "description": "Maximum number of results returned." }, { "name": "page[cursor]", "value": "example_value", "type": "query", "description": "String to query the next page of results.\nThis key is provided with each valid response from the API in `meta.pagination.next_cursor`.\nOnce the `meta.pagination.next_cursor` key is null, all pages have been retrieved." } ], "auth": { "type": "apikey", "key": "DD-API-KEY", "value": "{{DD-API-KEY}}", "placement": "header" } }, "docs": "Returns all metrics that can be configured in the Metrics Summary page or with Metrics without Limits™ (matching additional filters if specified).\nOptionally, paginate by using the `page[cursor]` and/or `page[size]` query parameters.\nTo fetch the first page, pass in a query parameter with either a valid `page[size]` or an empty cursor like `page[cursor]=`. To fetch the next page, pass in the `next_cursor` value from the response as the new `page[cursor]` value.\nOnce the `meta.pagination.next_cur" }, { "info": { "name": "Datadog Configure Tags for Multiple Metrics", "type": "http" }, "http": { "method": "POST", "url": "https://{subdomain}.{site}/api/v2/metrics/config/bulk-tags", "body": { "type": "json", "data": "{}" } }, "docs": "Create and define a list of queryable tag keys for a set of existing count, gauge, rate, and distribution metrics.\nMetrics are selected by passing a metric name prefix. Use the Delete method of this API path to remove tag configurations.\nResults can be sent to a set of account email addresses, just like the same operation in the Datadog web app.\nIf multiple calls include the same metric, the last configuration applied (not by submit order) is used, do not\nexpect deterministic ordering of concurr" }, { "info": { "name": "Datadog Delete Tags for Multiple Metrics", "type": "http" }, "http": { "method": "DELETE", "url": "https://{subdomain}.{site}/api/v2/metrics/config/bulk-tags", "body": { "type": "json", "data": "{}" } }, "docs": "Delete all custom lists of queryable tag keys for a set of existing count, gauge, rate, and distribution metrics.\nMetrics are selected by passing a metric name prefix.\nResults can be sent to a set of account email addresses, just like the same operation in the Datadog web app.\nCan only be used with application keys of users with the `Manage Tags for Metrics` permission." }, { "info": { "name": "Datadog List Tags by Metric Name", "type": "http" }, "http": { "method": "GET", "url": "https://{subdomain}.{site}/api/v2/metrics/:metric_name/all-tags", "params": [ { "name": "metric_name", "value": "dist.http.endpoint.request", "type": "path", "description": "The name of the metric." } ], "auth": { "type": "apikey", "key": "DD-API-KEY", "value": "{{DD-API-KEY}}", "placement": "header" } }, "docs": "View indexed tag key-value pairs for a given metric name over the previous hour." }, { "info": { "name": "Datadog Related Assets to a Metric", "type": "http" }, "http": { "method": "GET", "url": "https://{subdomain}.{site}/api/v2/metrics/:metric_name/assets", "params": [ { "name": "metric_name", "value": "dist.http.endpoint.request", "type": "path", "description": "The name of the metric." } ], "auth": { "type": "apikey", "key": "DD-API-KEY", "value": "{{DD-API-KEY}}", "placement": "header" } }, "docs": "Returns dashboards, monitors, notebooks, and SLOs that a metric is stored in, if any. Updated every 24 hours." }, { "info": { "name": "Datadog List Distinct Metric Volumes by Metric Name", "type": "http" }, "http": { "method": "GET", "url": "https://{subdomain}.{site}/api/v2/metrics/:metric_name/volumes", "params": [ { "name": "metric_name", "value": "dist.http.endpoint.request", "type": "path", "description": "The name of the metric." } ] }, "docs": "View distinct metrics volumes for the given metric name.\n\nCustom metrics generated in-app from other products will return `null` for ingested volumes." }, { "info": { "name": "Datadog Get All Rum-based Metrics", "type": "http" }, "http": { "method": "GET", "url": "https://{subdomain}.{site}/api/v2/rum/config/metrics" }, "docs": "Get the list of configured rum-based metrics with their definitions." }, { "info": { "name": "Datadog Create a Rum-based Metric", "type": "http" }, "http": { "method": "POST", "url": "https://{subdomain}.{site}/api/v2/rum/config/metrics", "body": { "type": "json", "data": "{}" } }, "docs": "Create a metric based on your organization's RUM data.\nReturns the rum-based metric object from the request body when the request is successful." }, { "info": { "name": "Datadog Get a Rum-based Metric", "type": "http" }, "http": { "method": "GET", "url": "https://{subdomain}.{site}/api/v2/rum/config/metrics/:metric_id", "params": [ { "name": "metric_id", "value": "", "type": "path", "description": "The name of the rum-based metric." } ] }, "docs": "Get a specific rum-based metric from your organization." }, { "info": { "name": "Datadog Update a Rum-based Metric", "type": "http" }, "http": { "method": "PATCH", "url": "https://{subdomain}.{site}/api/v2/rum/config/metrics/:metric_id", "params": [ { "name": "metric_id", "value": "", "type": "path", "description": "The name of the rum-based metric." } ], "body": { "type": "json", "data": "{}" } }, "docs": "Update a specific rum-based metric from your organization.\nReturns the rum-based metric object from the request body when the request is successful." }, { "info": { "name": "Datadog Delete a Rum-based Metric", "type": "http" }, "http": { "method": "DELETE", "url": "https://{subdomain}.{site}/api/v2/rum/config/metrics/:metric_id", "params": [ { "name": "metric_id", "value": "", "type": "path", "description": "The name of the rum-based metric." } ] }, "docs": "Delete a specific rum-based metric from your organization." }, { "info": { "name": "Datadog Submit Metrics", "type": "http" }, "http": { "method": "POST", "url": "https://{subdomain}.{site}/api/v2/series", "headers": [ { "name": "Content-Encoding", "value": "example_value" } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "apikey", "key": "DD-API-KEY", "value": "{{DD-API-KEY}}", "placement": "header" } }, "docs": "The metrics end-point allows you to post time-series data that can be graphed on Datadog’s dashboards.\nThe maximum payload size is 500 kilobytes (512000 bytes). Compressed payloads must have a decompressed size of less than 5 megabytes (5242880 bytes).\n\nIf you’re submitting metrics directly to the Datadog API without using DogStatsD, expect:\n\n- 64 bits for the timestamp\n- 64 bits for the value\n- 20 bytes for the metric names\n- 50 bytes for the timeseries\n- The full payload is approximately 100 b" }, { "info": { "name": "Datadog Query Timeseries Data", "type": "http" }, "http": { "method": "POST", "url": "https://{subdomain}.{site}/api/v2/query/timeseries", "body": { "type": "json", "data": "{}" } }, "docs": "Queries timeseries metric data for the specified time range and metric queries. Supports multiple metric queries in a single request. Returns time series data including timestamps, values, and associated metadata. The query uses Datadog's metrics query language supporting rollup, aggregation, and arithmetic operations." }, { "info": { "name": "Datadog Query Scalar Data", "type": "http" }, "http": { "method": "POST", "url": "https://{subdomain}.{site}/api/v2/query/scalar", "body": { "type": "json", "data": "{}" } }, "docs": "Queries scalar metric data for the specified time range and returns a single aggregated value per query formula. Useful for computing summary statistics such as averages, sums, or percentiles over a time window. Supports multiple formulas and metric queries in a single request." } ] } ], "bundled": true }