Generování vlastních metrik

  • Článek

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

Zásada emit-metric odesílá do Application Insights vlastní metriky v zadaném formátu.

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.

Omezení pro vlastní metriky

Azure Monitor ukládá limity využití pro vlastní metriky, které můžou ovlivnit vaši schopnost generovat metriky ze služby API Management. Azure Monitor například v současné době nastavuje limit 10 klíčů dimenzí na metriku a limit 50 000 celkového počtu aktivních časových řad na oblast v předplatném (v rámci 12hodinového období).

Tato omezení mají následující důsledky pro konfiguraci vlastních metrik v zásadách služby API Management, například emit-metric azure-openai-emit-token-metric:

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

  • Počet aktivních časových řad vygenerovaných zásadou během 12hodinového období je součinem počtu jedinečných hodnot jednotlivých nakonfigurovaných dimenzí během období. Pokud byly například v zásadách nakonfigurovány tři vlastní dimenze a každá dimenze měla v daném období 10 možných hodnot, zásada by přispěla 1 000 (10 x 10 x 10) aktivních časových řad.

  • Pokud zásadu nakonfigurujete v několika instancích služby API Management, které jsou ve stejné oblasti v předplatném, můžou všechny instance přispívat k limitu regionálních aktivních časových řad.

Přečtěte si další informace o omezeních a aspektech návrhu pro vlastní metriky ve službě Azure Monitor.

Požadavky

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
  • 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-host, workspace

Poznámky k využití

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

Příklad

Následující příklad odešle vlastní metriku pro počítání počtu požadavků rozhraní API spolu s ID rozhraní API jako vlastní dimenze.

<policies>
  <inbound>
    <emit-metric name="Request" value="1" namespace="my-metrics"> 
        <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: