Aangepaste metrische gegevens verzenden

  • Artikel

VAN TOEPASSING OP: Alle API Management-lagen

Het emit-metric beleid verzendt aangepaste metrische gegevens in de opgegeven indeling naar Application Insights.

Notitie

Notitie

Stel de elementen en onderliggende elementen van het beleid in de volgorde in die in de beleidsverklaring is opgegeven. Meer informatie over het instellen of bewerken van API Management-beleid.

Beleidsinstructie

<emit-metric name="name of custom metric" value="value of custom metric" namespace="metric namespace"> 
    <dimension name="dimension name" value="dimension value" /> 
</emit-metric>

Kenmerken

Kenmerk Beschrijving Vereist Default value
naam Een tekenreeks. Naam van aangepaste metrische gegevens. Beleidsexpressies zijn niet toegestaan. Ja N.v.t.
naamruimte Een tekenreeks. Naamruimte van aangepaste metrische gegevens. Beleidsexpressies zijn niet toegestaan. Nee API Management
waarde De waarde van aangepaste metrische gegevens uitgedrukt als een dubbele waarde. Beleidsexpressies zijn toegestaan. Nee 1

Elementen

Element Beschrijving Vereist
dimensie Voeg een of meer van deze elementen toe voor elke dimensie die is opgenomen in de aangepaste metrische waarde. Ja

dimensiekenmerken

Kenmerk Beschrijving Vereist Default value
naam Een tekenreeks of beleidsexpressie. Naam van dimensie. Ja N.v.t.
waarde Een tekenreeks of beleidsexpressie. Waarde van dimensie. Kan alleen worden weggelaten als deze overeenkomt met name een van de standaarddimensies. Als dat het zo is, wordt de waarde opgegeven volgens de dimensienaam. Nee N.v.t.

Standaarddimensienamen die zonder waarde kunnen worden gebruikt

  • API-id
  • Bewerkings-id
  • Product-id
  • Gebruikers-id
  • Abonnements-id
  • Locatie-ID
  • Gateway-id

Gebruik

Gebruiksnotities

  • U kunt maximaal 10 aangepaste dimensies voor dit beleid configureren.

  • Het aanroepen van het emit-metric beleid telt mee voor de gebruikslimieten voor aangepaste metrische gegevens per regio in een abonnement. Meer informatie

Opmerking

In het volgende voorbeeld wordt een aangepaste metrische waarde verzonden om het aantal API-aanvragen samen met de gebruikers-id, client-IP en API-id als aangepaste dimensies te tellen.

<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>

Gerelateerde inhoud

Zie voor meer informatie over het werken met beleid: