Generera anpassade mått

GÄLLER FÖR: Alla API Management-nivåer

Principen emit-metric skickar anpassade mått i det angivna formatet till Application Insights.

Kommentar

• Anpassade mått är en förhandsversionsfunktion i Azure Monitor och omfattas av begränsningar.
• Mer information om API Management-data som lagts till i Application Insights finns i Integrera Azure API Management med Azure Application Insights.

Kommentar

Ange principens element och underordnade element i den ordning som anges i principbeskrivningen. Läs mer om hur du anger eller redigerar API Management-principer.

Principuttryck

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

Attribut

Attribut	beskrivning	Obligatoriskt	Standardvärde
name	En sträng. Namn på anpassat mått. Principuttryck tillåts inte.	Ja	Ej tillämpligt
namnområde	En sträng. Namnområde för anpassat mått. Principuttryck tillåts inte.	Nej	API Management
värde	Värdet för det anpassade måttet uttryckt som en dubbel. Principuttryck tillåts.	Nej	1

Element

Element	Description	Obligatoriskt
dimension	Lägg till ett eller flera av dessa element för varje dimension som ingår i det anpassade måttet.	Ja

dimensionsattribut

Attribut	beskrivning	Obligatoriskt	Standardvärde
name	Ett sträng- eller principuttryck. Dimensionens namn.	Ja	Ej tillämpligt
värde	Ett sträng- eller principuttryck. Dimensionens värde. Kan bara utelämnas om name matchar en av standarddimensionerna. I så fall anges värdet enligt dimensionsnamnet.	Nej	Ej tillämpligt

Standarddimensionsnamn som kan användas utan värde

• API-ID
• Åtgärds-ID
• Produkt-ID
• Användar-ID
• Prenumerations-ID:t
• Plats-id
• Gateway-ID

Användning

• Principavsnitt: inkommande, utgående, serverdel, on-error
• Principomfattningar: global, arbetsyta, produkt, API, åtgärd
• Gatewayer: klassisk, v2, förbrukning, lokalt installerad

Användningsanteckningar

• Du kan konfigurera högst 10 anpassade dimensioner för den här principen.

• emit-metric Att anropa principen räknas mot användningsgränserna för anpassade mått per region i en prenumeration. Läs mer

Exempel

I följande exempel skickas ett anpassat mått för att räkna antalet API-begäranden tillsammans med användar-ID, klient-IP och API-ID som anpassade dimensioner.

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

Relaterade principer

• Loggning

Relaterat innehåll

Mer information om hur du arbetar med principer finns i:

• Självstudie: Transformera och skydda ditt API
• Principreferens för en fullständig lista över principinstruktioner och deras inställningar
• Principuttryck
• Ange eller redigera principer
• Återanvända principkonfigurationer
• Lagringsplats för principfragment
• Skapa principer med Hjälp av Microsoft Copilot för Azure