Logowanie do centrum zdarzeń

  • Artykuł

DOTYCZY: Wszystkie warstwy usługi API Management

Zasady log-to-eventhub wysyła komunikaty w określonym formacie do centrum zdarzeń zdefiniowanego przez jednostkę rejestratora. Jak wskazuje jego nazwa, zasady są używane do zapisywania wybranych informacji o kontekście żądania lub odpowiedzi na potrzeby analizy online lub offline.

Uwaga

Aby zapoznać się z przewodnikiem krok po kroku dotyczącym konfigurowania centrum zdarzeń i rejestrowania zdarzeń, zobacz Jak rejestrować zdarzenia usługi API Management za pomocą usługi Azure Event Hubs.

Uwaga

Ustaw elementy zasad i elementy podrzędne w kolejności podanej w instrukcji zasad. Dowiedz się więcej na temat ustawiania lub edytowania zasad usługi API Management.

Instrukcja zasad

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

Atrybuty

Atrybut opis Wymagani Wartość domyślna
logger-id Identyfikator rejestratora zarejestrowanego w usłudze API Management. Wyrażenia zasad nie są dozwolone. Tak Nie dotyczy
identyfikator partycji Określa indeks partycji, w której są wysyłane komunikaty. Wyrażenia zasad nie są dozwolone. Opcjonalny. Nie używaj, jeśli partition-key jest używany. Nie dotyczy
klucz partycji Określa wartość używaną do przypisania partycji podczas wysyłania komunikatów. Wyrażenia zasad są dozwolone. Opcjonalny. Nie używaj, jeśli partition-id jest używany. Nie dotyczy

Użycie

  • Sekcje zasad: ruch przychodzący, wychodzący, zaplecze, błąd
  • Zakresy zasad: globalny, obszar roboczy, produkt, interfejs API, operacja
  • Bramy: klasyczne, v2, zużycie, self-hosted

Uwagi dotyczące użycia

  • Zasady nie mają wpływu na próbkowanie aplikacji Szczegółowe informacje. Wszystkie wywołania zasad zostaną zarejestrowane.
  • Maksymalny obsługiwany rozmiar komunikatu, który można wysłać do centrum zdarzeń z tych zasad, to 200 kilobajtów (KB). Większy komunikat zostanie automatycznie obcięty do 200 KB przed przeniesieniem do centrum zdarzeń.

Przykład

Dowolny ciąg może służyć jako wartość do zalogowania w usłudze Event Hubs. W tym przykładzie data i godzina, nazwa usługi wdrażania, identyfikator żądania, adres IP i nazwa operacji dla wszystkich wywołań przychodzących są rejestrowane w rejestratorze zdarzeń zarejestrowanym przy użyciu identyfikatora 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>

Powiązana zawartość

Aby uzyskać więcej informacji na temat pracy z zasadami, zobacz: