Delen via

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

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.

Limieten voor aangepaste metrische gegevens

Azure Monitor legt gebruikslimieten op voor aangepaste metrische gegevens die van invloed kunnen zijn op uw mogelijkheid om metrische gegevens uit API Management te verzenden. Azure Monitor stelt bijvoorbeeld momenteel een limiet van 10 dimensiesleutels per metrische waarde in en een limiet van 50.000 totale actieve tijdreeksen per regio in een abonnement (binnen een periode van 12 uur).

Deze limieten hebben de volgende gevolgen voor het configureren van aangepaste metrische gegevens in een API Management-beleid, zoals emit-metric of azure-openai-emit-token-metric:

  • U kunt maximaal 10 aangepaste dimensies per beleid configureren.

  • Het aantal actieve tijdreeksen dat door het beleid binnen een periode van 12 uur wordt gegenereerd, is het product van het aantal unieke waarden van elke geconfigureerde dimensie gedurende de periode. Als er bijvoorbeeld drie aangepaste dimensies zijn geconfigureerd in het beleid en elke dimensie 10 mogelijke waarden binnen de periode had, zou het beleid 1000 (10 x 10 x 10) actieve tijdreeksen bijdragen.

  • Als u het beleid configureert in meerdere API Management-exemplaren die zich in dezelfde regio in een abonnement bevinden, kunnen alle exemplaren bijdragen aan de regionale limiet voor actieve tijdreeksen.

Meer informatie over ontwerpbeperkingen en overwegingen voor aangepaste metrische gegevens in Azure Monitor.

Vereisten

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
  • Gateway-id

Gebruik

Gebruiksnotities

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

Opmerking

In het volgende voorbeeld wordt een aangepaste metrische waarde verzonden om het aantal API-aanvragen samen met de API-id als een aangepaste dimensie te tellen.

<policies>
  <inbound>
    <emit-metric name="Request" value="1" namespace="my-metrics"> 
        <dimension name="API ID" /> 
    </emit-metric> 
  </inbound>
  <outbound>
  </outbound>
</policies>

Gerelateerde inhoud

Zie voor meer informatie over het werken met beleid: