Egyéni metrikák kibocsátása

A KÖVETKEZŐRE VONATKOZIK: Minden API Management-szint

A emit-metric szabályzat a megadott formátumban küld egyéni metrikákat az Application Insightsnak.

Feljegyzés

• Az egyéni metrikák az Azure Monitor előzetes verziója, és korlátozások vonatkoznak gombra.
• Az Application Insightshoz hozzáadott API Management-adatokról további információt az Azure API Management integrálása a Azure-alkalmazás Insights szolgáltatással című témakörben talál.

Feljegyzés

Állítsa be a szabályzat elemeit és gyermekelemeit a szabályzatutasításban megadott sorrendben. További információ az API Management-szabályzatok beállításáról és szerkesztéséről.

Szabályzatutasítás

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

Attribútumok

Attribútum	Leírás	Kötelező	Alapértelmezett érték
név	Egy sztring. Az egyéni metrikák neve. A szabályzatkifejezések nem engedélyezettek.	Igen	n/a
névtér	Egy sztring. Egyéni metrika névtere. A szabályzatkifejezések nem engedélyezettek.	Nem	API Management
Érték	Az egyéni metrikák értéke dupla értékben kifejezve. A szabályzatkifejezések engedélyezettek.	Nem	0

Elemek

Elem	Leírás	Kötelező
dimenzió	Adjon hozzá egy vagy több ilyen elemet az egyéni metrikában szereplő dimenziókhoz.	Igen

dimenzióattribútumok

Attribútum	Leírás	Kötelező	Alapértelmezett érték
név	Sztring vagy szabályzatkifejezés. Dimenzió neve.	Igen	n/a
Érték	Sztring vagy szabályzatkifejezés. A dimenzió értéke. Csak akkor hagyható ki, ha name egyezik az alapértelmezett dimenziók egyikével. Ha igen, az érték dimenziónév szerint van megadva.	Nem	N.A.

Alapértelmezett dimenziónevek, amelyek érték nélkül is használhatók

• API-azonosító
• Műveletazonosító
• Termékazonosító
• Felhasználói azonosító
• Előfizetés azonosítója
• Hely
• Átjáró azonosítója

Használat

• Szabályzatszakaszok: bejövő, kimenő, háttérrendszer, hiba
• Szabályzathatókörök: globális, munkaterület, termék, API, művelet
• Átjárók: klasszikus, v2, használat, saját üzemeltetésű

Használati megjegyzések

• Ehhez a szabályzathoz legfeljebb 10 egyéni dimenziót konfigurálhat.

• A szabályzat meghívása az emit-metric előfizetésben régiónkénti egyéni metrikák használati korlátaira vonatkozó számba. További információ

Példa

Az alábbi példa egy egyéni metrikát küld az API-kérelmek számának megszámlálásához, valamint a felhasználói azonosítót, az ügyfél IP-címét és az API-azonosítót egyéni dimenzióként.

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

Kapcsolódó szabályzatok

• Logging

Kapcsolódó tartalom

A szabályzatok használatával kapcsolatos további információkért lásd:

• Oktatóanyag: AZ API átalakítása és védelme
• Szabályzathivatkozás a szabályzatutasságok és azok beállításainak teljes listájához
• Házirend-kifejezések
• Házirendek beállítása vagy szerkesztése
• Szabályzatkonfigurációk újrafelhasználása
• Szabályzatrészletek adattára
• Szabályzatok létrehozása a Microsoft Copilot használatával az Azure-ban