Generování vlastních metrik

  • Článek

PLATÍ PRO: Všechny úrovně služby API Management

Zásada emit-metric odesílá vlastní metriky v zadaném formátu do Přehledy aplikace.

Poznámka:

Poznámka:

Nastavte prvky zásad a podřízené prvky v pořadí uvedeném v prohlášení o zásadách. Přečtěte si další informace o tom, jak nastavit nebo upravit zásady služby API Management.

Prohlášení o zásadách

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

Atributy

Atribut Popis Povinní účastníci Default value
name Řetězec. Název vlastní metriky Výrazy zásad nejsou povolené. Yes –
namespace Řetězec. Obor názvů vlastní metriky Výrazy zásad nejsou povolené. No API Management
hodnota Hodnota vlastní metriky vyjádřená jako dvojitá. Výrazy zásad jsou povolené. No 0

Elementy

Element (Prvek) Popis Povinní účastníci
Dimenze Přidejte jeden nebo více těchto prvků pro každou dimenzi, která je součástí vlastní metriky. Ano

atributy dimenze

Atribut Popis Povinní účastníci Default value
name Řetězcový výraz nebo výraz zásad. Název dimenze. Yes –
hodnota Řetězcový výraz nebo výraz zásad. Hodnota dimenze Tuto možnost je možné vynechat, pouze pokud name odpovídá jedné z výchozích dimenzí. Pokud ano, je hodnota zadaná podle názvu dimenze. No –

Výchozí názvy dimenzí, které lze použít bez hodnoty

  • API ID
  • ID operace
  • ID produktu
  • ID uživatele
  • Subscription ID
  • ID umístění
  • ID brány

Využití

  • Oddíly zásad: příchozí, odchozí, back-end, on-error
  • Obory zásad: globální, pracovní prostor, produkt, rozhraní API, operace
  • Brány: Classic, v2, consumption, self-hosted

Poznámky k využití

  • Pro tuto zásadu můžete nakonfigurovat maximálně 10 vlastních dimenzí.

  • Vyvolání emit-metric zásad se započítává do limitů využití pro vlastní metriky v rámci předplatného. Další informace

Příklad

Následující příklad odešle vlastní metriku, která spočítá počet požadavků rozhraní API spolu s ID uživatele, IP adresou klienta a ID rozhraní API jako vlastní dimenze.

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

Související obsah

Další informace o práci se zásadami najdete v tématech: