Condividi tramite

Accedi a hub eventi

  • Articolo

SI APPLICA A: Tutti i livelli di Gestione API

Il criterio log-to-eventhub invia messaggi nel formato specificato a un hub eventi definito da un'entità Logger. Come suggerisce il nome, il criterio viene usato per salvare le informazioni sul contesto della richiesta o della risposta selezionate per l'analisi online o offline.

Nota

Per una guida dettagliata sulla configurazione di un hub eventi e la registrazione di eventi, vedere Come registrare eventi nell'Hub eventi di Azure in Gestione API di Azure.

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

<log-to-eventhub logger-id="id of the logger entity" partition-id="index of the partition where messages are sent" partition-key="value used for partition assignment">
  Expression returning a string to be logged
</log-to-eventhub>

Attributi

Attributo Descrizione Richiesto Valore predefinito
logger-id L’ID del Logger registrato con il servizio Gestione API. Le espressioni di criteri non sono consentite. Sì N/D
partition-id Specifica l'indice della partizione a cui i messaggi vengono inviati. Le espressioni di criteri non sono consentite. Facoltativo. Non usare se partition-key è in uso. N/D
partition-key Specifica il valore usato per l'assegnazione della partizione quando vengono inviati i messaggi. Le espressioni di criteri sono consentite. Facoltativo. Non usare se partition-id è in uso. N/D

Utilizzo

Note sull'utilizzo

  • Il criterio non è interessato dal campionamento di Application Insights. Tutte le chiamate dei criteri verranno registrate.
  • La dimensione massima supportata di messaggi che può essere inviata a un hub eventi da questo criterio è di 200 kilobyte (KB). Un messaggio di dimensioni maggiori verrà automaticamente troncato a 200 KB prima del trasferimento a un hub eventi.

Esempio

È possibile usare qualsiasi stringa come valore da registrare in Hub eventi. In questo esempio la data e l'ora, il nome del servizio di distribuzione, l'ID della richiesta, l'indirizzo IP e il nome dell'operazione di tutte le chiamate in entrata vengono registrati nel Logger dell'hub eventi registrato con l'ID contoso-logger.

<policies>
  <inbound>
    <log-to-eventhub logger-id ='contoso-logger'>
      @( string.Join(",", DateTime.UtcNow, context.Deployment.ServiceName, context.RequestId, context.Request.IpAddress, context.Operation.Name) )
    </log-to-eventhub>
  </inbound>
  <outbound>
  </outbound>
</policies>

Contenuto correlato

Per ulteriori informazioni sull'utilizzo dei criteri, vedere: