Přihlášení k centru událostí

  • Článek

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

Zásada log-to-eventhub odesílá zprávy v zadaném formátu do centra událostí definovaného entitou Logger . Jak už název napovídá, zásada se používá k ukládání vybraných informací o kontextu požadavku nebo odpovědi pro online nebo offline analýzu.

Poznámka:

Podrobný průvodce konfigurací centra událostí a protokolování událostí najdete v tématu Protokolování událostí pomocí služby Azure Event Hubs.

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

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

Atributy

Atribut Popis Požaduje se Výchozí
logger-id ID loggeru zaregistrovaného ve službě API Management. Výrazy zásad nejsou povolené. Yes –
ID oddílu Určuje index oddílu, ve kterém se odesílají zprávy. Výrazy zásad nejsou povolené. Nepovinné. Nepoužívejte, pokud partition-key se používá. –
partition-key Určuje hodnotu použitou pro přiřazení oddílu při odesílání zpráv. Výrazy zásad jsou povolené. Nepovinné. Nepoužívejte, pokud partition-id se používá. –

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í

  • Zásady nejsou ovlivněny vzorkováním Přehledy aplikací. Zaprotokolují se všechna vyvolání zásad.
  • Maximální podporovaná velikost zprávy, kterou lze odeslat do centra událostí z této zásady, je 200 kilobajtů (KB). Větší zpráva se před přenosem do centra událostí automaticky zkrátí na 200 kB.

Příklad

Libovolný řetězec lze použít jako hodnotu, která se má protokolovat ve službě Event Hubs. V tomto příkladu se název služby nasazení, ID požadavku, IP adresa a název operace pro všechna příchozí volání zaprotokolují do loggeru centra událostí zaregistrovaného s contoso-logger ID.

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

Související obsah

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