發出自訂計量

  • 發行項

適用於：所有 API 管理 層

emit-metric 原則會將自訂計量以指定的格式傳送至 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 識別碼
  • 作業識別碼
  • 產品識別碼
  • 使用者識別碼
  • 訂用帳戶識別碼
  • 位置識別碼
  • 閘道識別碼

使用方式

使用注意事項

  • 您最多可以為此原則設定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>

相關內容

如需使用原則的詳細資訊，請參閱：