---
title: Spans Metrics
description: Manage configuration of span-based metrics for your organization. See Generate Metrics from Spans for more information.
breadcrumbs: Docs > API > Spans Metrics
---

> For the complete documentation index, see [llms.txt](https://dnd37xeb23o8n.cloudfront.net/jen.gilbert/astro-base/llms.txt).

# Spans Metrics

Manage configuration of [span-based metrics](https://app.datadoghq.com/apm/traces/generate-metrics) for your organization. See [Generate Metrics from Spans](https://docs.datadoghq.com/tracing/trace_pipeline/generate_metrics.md) for more information.

## [Get all span-based metrics](https://dnd37xeb23o8n.cloudfront.net/jen.gilbert/astro-base/api/latest/spans-metrics/get-all-span-based-metrics.md)

| Datadog site      | API endpoint                                                |
| ----------------- | ----------------------------------------------------------- |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v2/apm/config/metrics     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/apm/config/metrics |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/apm/config/metrics |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/apm/config/metrics      |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/apm/config/metrics |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/apm/config/metrics |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/apm/config/metrics |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v2/apm/config/metrics      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v2/apm/config/metrics  |

## [Create a span-based metric](https://dnd37xeb23o8n.cloudfront.net/jen.gilbert/astro-base/api/latest/spans-metrics/create-a-span-based-metric.md)

| Datadog site      | API endpoint                                                 |
| ----------------- | ------------------------------------------------------------ |
| app.datadoghq.com | POST https://api.datadoghq.com/api/v2/apm/config/metrics     |
| us3.datadoghq.com | POST https://api.us3.datadoghq.com/api/v2/apm/config/metrics |
| us5.datadoghq.com | POST https://api.us5.datadoghq.com/api/v2/apm/config/metrics |
| app.datadoghq.eu  | POST https://api.datadoghq.eu/api/v2/apm/config/metrics      |
| ap1.datadoghq.com | POST https://api.ap1.datadoghq.com/api/v2/apm/config/metrics |
| ap2.datadoghq.com | POST https://api.ap2.datadoghq.com/api/v2/apm/config/metrics |
| uk1.datadoghq.com | POST https://api.uk1.datadoghq.com/api/v2/apm/config/metrics |
| app.ddog-gov.com  | POST https://api.ddog-gov.com/api/v2/apm/config/metrics      |
| us2.ddog-gov.com  | POST https://api.us2.ddog-gov.com/api/v2/apm/config/metrics  |

## [Get a span-based metric](https://dnd37xeb23o8n.cloudfront.net/jen.gilbert/astro-base/api/latest/spans-metrics/get-a-span-based-metric.md)

| Datadog site      | API endpoint                                                            |
| ----------------- | ----------------------------------------------------------------------- |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v2/apm/config/metrics/{metric_id}     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/apm/config/metrics/{metric_id} |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/apm/config/metrics/{metric_id} |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/apm/config/metrics/{metric_id}      |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/apm/config/metrics/{metric_id} |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/apm/config/metrics/{metric_id} |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/apm/config/metrics/{metric_id} |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v2/apm/config/metrics/{metric_id}      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v2/apm/config/metrics/{metric_id}  |

## [Update a span-based metric](https://dnd37xeb23o8n.cloudfront.net/jen.gilbert/astro-base/api/latest/spans-metrics/update-a-span-based-metric.md)

| Datadog site      | API endpoint                                                              |
| ----------------- | ------------------------------------------------------------------------- |
| app.datadoghq.com | PATCH https://api.datadoghq.com/api/v2/apm/config/metrics/{metric_id}     |
| us3.datadoghq.com | PATCH https://api.us3.datadoghq.com/api/v2/apm/config/metrics/{metric_id} |
| us5.datadoghq.com | PATCH https://api.us5.datadoghq.com/api/v2/apm/config/metrics/{metric_id} |
| app.datadoghq.eu  | PATCH https://api.datadoghq.eu/api/v2/apm/config/metrics/{metric_id}      |
| ap1.datadoghq.com | PATCH https://api.ap1.datadoghq.com/api/v2/apm/config/metrics/{metric_id} |
| ap2.datadoghq.com | PATCH https://api.ap2.datadoghq.com/api/v2/apm/config/metrics/{metric_id} |
| uk1.datadoghq.com | PATCH https://api.uk1.datadoghq.com/api/v2/apm/config/metrics/{metric_id} |
| app.ddog-gov.com  | PATCH https://api.ddog-gov.com/api/v2/apm/config/metrics/{metric_id}      |
| us2.ddog-gov.com  | PATCH https://api.us2.ddog-gov.com/api/v2/apm/config/metrics/{metric_id}  |

## [Delete a span-based metric](https://dnd37xeb23o8n.cloudfront.net/jen.gilbert/astro-base/api/latest/spans-metrics/delete-a-span-based-metric.md)

| Datadog site      | API endpoint                                                               |
| ----------------- | -------------------------------------------------------------------------- |
| app.datadoghq.com | DELETE https://api.datadoghq.com/api/v2/apm/config/metrics/{metric_id}     |
| us3.datadoghq.com | DELETE https://api.us3.datadoghq.com/api/v2/apm/config/metrics/{metric_id} |
| us5.datadoghq.com | DELETE https://api.us5.datadoghq.com/api/v2/apm/config/metrics/{metric_id} |
| app.datadoghq.eu  | DELETE https://api.datadoghq.eu/api/v2/apm/config/metrics/{metric_id}      |
| ap1.datadoghq.com | DELETE https://api.ap1.datadoghq.com/api/v2/apm/config/metrics/{metric_id} |
| ap2.datadoghq.com | DELETE https://api.ap2.datadoghq.com/api/v2/apm/config/metrics/{metric_id} |
| uk1.datadoghq.com | DELETE https://api.uk1.datadoghq.com/api/v2/apm/config/metrics/{metric_id} |
| app.ddog-gov.com  | DELETE https://api.ddog-gov.com/api/v2/apm/config/metrics/{metric_id}      |
| us2.ddog-gov.com  | DELETE https://api.us2.ddog-gov.com/api/v2/apm/config/metrics/{metric_id}  |