發出自訂計量
適用於:所有 APIM 層
emit-metric
原則會將自訂計量以指定的格式傳送至 Application Insights。
注意
- 自訂計量是 Azure 監視器的預覽功能,有其相關限制。
- 如需與新增至 Application Insights 的 API 管理資料有關的詳細資訊,請參閱如何整合 Azure API 管理與 Azure Application Insights。
注意
請依照原則陳述式中提供的順序,來設定原則的元素和子元素。 深入了解如何設定或編輯 APIM 原則。
原則陳述式
<emit-metric name="name of custom metric" value="value of custom metric" namespace="metric namespace">
<dimension name="dimension name" value="dimension value" />
</emit-metric>
屬性
屬性 | 描述 | 必要 | 預設值 |
---|---|---|---|
NAME | 字串。 自訂計量的名稱。 不允許使用原則運算式。 | Yes | N/A |
命名空間 | 字串。 自訂計量的命名空間。 不允許使用原則運算式。 | No | API 管理 |
value | 以雙精度浮點數表示的自訂計量值。 允許使用原則運算式。 | No | 1 |
元素
元素 | 描述 | 必要 |
---|---|---|
維度 | 為自訂計量中包含的每個維度新增一或多個這些元素。 | Yes |
維度屬性
屬性 | 描述 | 必要 | 預設值 |
---|---|---|---|
NAME | 字串或原則運算式。 維度的名稱。 | Yes | N/A |
value | 字串或原則運算式。 維度的值。 只有在 name 符合其中一個預設維度時,才能省略。 若是如此,則會根據維度名稱提供值。 |
No | N/A |
無需值即可使用的預設維度名稱
- API 識別碼
- 作業識別碼
- 產品識別碼
- 使用者識別碼
- 訂用帳戶識別碼
- Location
- 閘道識別碼
使用方式
使用注意事項
您最多可以為此原則設定10 個自訂維度。
叫用
emit-metric
原則會計入訂用帳戶中每個區域的自訂計量使用限制。 深入了解
範例
下列範例會傳送自訂計量,將 API 要求數目以及使用者識別碼、用戶端 IP 和 API 識別碼計為自訂維度。
<policies>
<inbound>
<emit-metric name="Request" value="1" namespace="my-metrics">
<dimension name="User ID" />
<dimension name="Client IP" value="@(context.Request.IpAddress)" />
<dimension name="API ID" />
</emit-metric>
</inbound>
<outbound>
</outbound>
</policies>
相關原則
相關內容
如需使用原則的詳細資訊,請參閱:
- 教學課程:轉換及保護 API
- 原則參考,取得原則陳述式及其設定的完整清單
- 原則運算式
- 設定或編輯原則
- 重複使用原則設定
- 原則程式碼片段存放庫 (英文)
- 使用 Microsoft Azure Copilot 撰寫原則