Merge pull request #289620 from dlepow/beid

[APIM] Backend ID dimension for custom metrics

Author: JamesJBarnett

articles/api-management/azure-openai-emit-token-metric-policy.md

@@ -6,7 +6,7 @@ author: dlepow
 
 ms.service: azure-api-management
 ms.topic: reference
-ms.date: 09/26/2024
+ms.date: 04/01/2025
 ms.author: danlep
 ms.collection: ce-skilling-ai-copilot
 ms.custom:
@@ -65,19 +65,11 @@ The `azure-openai-emit-token-metric` policy sends custom metrics to Application
 | name      | A string or policy expression. Name of dimension.      | Yes      |  N/A            |
 | value     | A string or policy expression. Value of dimension. Can only be omitted if `name` matches one of the default dimensions. If so, value is provided as per dimension name. | No        | N/A |
 
- ### Default dimension names that may be used without value
-
-* API ID
-* Operation ID
-* Product ID
-* User ID
-* Subscription ID
-* Location
-* Gateway ID
+[!INCLUDE [api-management-emit-metric-dimensions](../../includes/api-management-emit-metric-dimensions.md)]
 
 ## Usage
 
-- [**Policy sections:**](./api-management-howto-policies.md#sections) inbound
+- [**Policy sections:**](./api-management-howto-policies.md#sections) inbound, outbound
 - [**Policy scopes:**](./api-management-howto-policies.md#scopes) global, workspace, product, API, operation
 -  [**Gateways:**](api-management-gateways-overview.md) classic, v2, consumption, self-hosted, workspace
 
@@ -91,7 +83,7 @@ The `azure-openai-emit-token-metric` policy sends custom metrics to Application
 
 ## Example
 
-The following example sends Azure OpenAI token count metrics to Application Insights along with API ID as a custom dimension.
+The following example sends Azure OpenAI token count metrics to Application Insights along with API ID as a default dimension.
 
 ```xml
 <policies>

articles/api-management/emit-metric-policy.md

@@ -6,7 +6,7 @@ author: dlepow
 
 ms.service: azure-api-management
 ms.topic: reference
-ms.date: 09/25/2024
+ms.date: 04/01/2025
 ms.author: danlep
 ms.custom: engagement-fy23
 ---
@@ -59,15 +59,7 @@ The `emit-metric` policy sends custom metrics in the specified format to Applica
 | name      | A string or policy expression. Name of dimension.      | Yes      |  N/A            |
 | value     | A string or policy expression. Value of dimension. Can only be omitted if `name` matches one of the default dimensions. If so, value is provided as per dimension name. | No        | N/A |
 
- ### Default dimension names that may be used without value
-
-* API ID
-* Operation ID
-* Product ID
-* User ID
-* Subscription ID
-* Location
-* Gateway ID
+[!INCLUDE [api-management-emit-metric-dimensions](../../includes/api-management-emit-metric-dimensions.md)]
 
 ## Usage
 
@@ -81,7 +73,7 @@ The `emit-metric` policy sends custom metrics in the specified format to Applica
 
 ## Example
 
-The following example sends a custom metric to count the number of API requests along with API ID as a custom dimension.
+The following example sends a custom metric to count the number of API requests along with API ID as a default dimension.
 
 ```xml
 <policies>

articles/api-management/llm-emit-token-metric-policy.md

@@ -6,7 +6,7 @@ author: dlepow
 
 ms.service: azure-api-management
 ms.topic: reference
-ms.date: 09/26/2024
+ms.date: 04/01/2025
 ms.author: danlep
 ms.collection: ce-skilling-ai-copilot
 ms.custom:
@@ -67,19 +67,12 @@ The `llm-emit-token-metric` policy sends custom metrics to Application Insights
 | name      | A string or policy expression. Name of dimension.      | Yes      |  N/A            |
 | value     | A string or policy expression. Value of dimension. Can only be omitted if `name` matches one of the default dimensions. If so, value is provided as per dimension name. | No        | N/A |
 
- ### Default dimension names that may be used without value
+[!INCLUDE [api-management-emit-metric-dimensions](../../includes/api-management-emit-metric-dimensions.md)]
 
-* API ID
-* Operation ID
-* Product ID
-* User ID
-* Subscription ID
-* Location
-* Gateway ID
 
 ## Usage
 
-- [**Policy sections:**](./api-management-howto-policies.md#sections) inbound
+- [**Policy sections:**](./api-management-howto-policies.md#sections) inbound, outbound
 - [**Policy scopes:**](./api-management-howto-policies.md#scopes) global, workspace, product, API, operation
 -  [**Gateways:**](api-management-gateways-overview.md) classic, v2, consumption, self-hosted, workspace
 
@@ -92,7 +85,7 @@ The `llm-emit-token-metric` policy sends custom metrics to Application Insights
 
 ## Example
 
-The following example sends LLM token count metrics to Application Insights along with API ID as a custom dimension.
+The following example sends LLM token count metrics to Application Insights along with API ID as a default dimension.
 
 ```xml
 <policies>

includes/api-management-emit-metric-dimensions.md

@@ -0,0 +1,20 @@
+---
+author: dlepow
+ms.service: azure-api-management
+ms.custom:
+  - build-2024
+ms.topic: include
+ms.date: 10/31/2024
+ms.author: danlep
+---
+
+### Default dimension names that may be used without value
+
+* API ID
+* Operation ID
+* Product ID
+* User ID
+* Subscription ID
+* Location
+* Gateway ID
+* Backend ID (use only in outbound policy)