Megosztás a következőn keresztül:

Egyéni metrikák kibocsátása

  • Cikk

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

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

Egyéni metrikák korlátai

Az Azure Monitor használati korlátozásokat szab ki az egyéni metrikákra, amelyek befolyásolhatják a metrikák API Managementből való kibocsáthatóságát. Az Azure Monitor például jelenleg 10 dimenziókulcs-korlátot állít be metrika szerint, és egy előfizetésben régiónként 50 000 aktív idősorra vonatkozó korlátot (12 órán belül).

Ezek a korlátok az alábbi következményekkel járnak az egyéni metrikák API Management-szabályzatokban való konfigurálására, példáulemit-metric:azure-openai-emit-token-metric

  • Szabályzatonként legfeljebb 10 egyéni dimenziót konfigurálhat.

  • A szabályzat által 12 órán belül létrehozott aktív idősorok száma az egyes konfigurált dimenziók egyedi értékeinek szorzata az időszak során. Ha például három egyéni dimenzió van konfigurálva a szabályzatban, és minden dimenzió 10 lehetséges értékkel rendelkezik az időszakon belül, a szabályzat 1000 (10 x 10 x 10) aktív idősort adna hozzá.

  • Ha a szabályzatot több olyan API Management-példányban konfigurálja, amelyek ugyanabban a régióban vannak egy előfizetésben, minden példány hozzájárulhat a regionális aktív idősorkorláthoz.

További információ az egyéni metrikákra vonatkozó tervezési korlátozásokról és szempontokról az Azure Monitorban.

Előfeltételek

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

Használati megjegyzések

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

Példa

Az alábbi példa egy egyéni metrikát küld az API-kérések számának megszámlálásához, valamint az API-azonosítót egyéni dimenzióként.

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

Kapcsolódó tartalom

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