Generare metriche personalizzate

  • Articolo

SI APPLICA A: Tutti i livelli di Gestione API

Il criterio emit-metric invia metriche personalizzate nel formato specificato ad Application Insights.

Nota

Nota

Impostare gli elementi e gli elementi figlio del criterio nell'ordine specificato nell'istruzione del criterio. Altre informazioni su come impostare o modificare i criteri di API Management.

Istruzione del criterio

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

Attributi

Attributo Descrizione Richiesto Valore predefinito
name Stringa . Nome della metrica personalizzata. Le espressioni di criteri non sono consentite. Sì N/D
namespace Stringa . Spazio dei nomi della metrica personalizzata. Le espressioni di criteri non sono consentite. No Gestione API
value Valore della metrica personalizzata espressa come double. Le espressioni di criteri sono consentite. No 1

Elementi

Elemento Descrizione Richiesto
dimension Aggiungere uno o più di questi elementi per ogni dimensione inclusa nella metrica personalizzata. Sì

attributi dimensione

Attributo Descrizione Richiesto Valore predefinito
name Una stringa o espressione di criteri. Nome della dimensione. Sì N/D
value Una stringa o espressione di criteri. Valore della dimensione. Può essere omesso solo se name corrisponde a una delle dimensioni predefinite. In tal caso, il valore viene fornito in base al nome della dimensione. No N/D

Nomi di dimensione predefiniti che possono essere usati senza valore

  • ID API
  • ID operazione
  • ID prodotto
  • ID utente
  • ID sottoscrizione
  • Ufficio
  • ID gateway

Utilizzo

Note sull'utilizzo

  • È possibile configurare al massimo 10 dimensioni personalizzate per questo criterio.

  • Richiamare i criteri emit-metric per i limiti di utilizzo per le metriche personalizzate per area in una sottoscrizione. Ulteriori informazioni

Esempio

L'esempio seguente invia una metrica personalizzata per contare il numero di richieste API insieme a ID utente, IP client e ID API come dimensioni personalizzate.

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

Contenuto correlato

Per ulteriori informazioni sull'utilizzo dei criteri, vedere: