Зарегистрировать в центре событий

ОБЛАСТЬ ПРИМЕНЕНИЯ: все уровни Управление API

Политика log-to-eventhub отправляет сообщения в указанном формате в концентратор событий, определенный сущностью Logger . Как и предполагает ее имя, эта политика используется для сохранения контекстных сведений выбранного запроса или ответа для сетевого или автономного анализа.

Примечание.

Пошаговое руководство по настройке концентратора событий и ведению журнала событий см. в статье Как регистрировать события службы управления API в Центрах событий Azure.

Примечание.

Задайте элементы политики и дочерние элементы в порядке, указанном в правиле политики. Узнайте, как устанавливать или изменять политики службы управления API.

Правило политики

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

Атрибуты

Атрибут Описание Обязательное поле По умолчанию.
идентификатор средства ведения журнала Идентификатор средства ведения журнала, зарегистрированного в службе Управление API. Выражения политики не допускаются. Да Н/П
идентификатор секции Указывает индекс раздела, куда должны отправляться сообщения. Выражения политики не допускаются. Необязательно. Не используйте, если partition-key используется. Н/П
ключ секции Указывает значение, используемое для назначения секции при отправке сообщений. Допустимы выражения политики. Необязательно. Не используйте, если partition-id используется. Н/П

Important

Связанный доступ не проверяется, когда логгер ссылается с помощью logger-id. Пользователь, имеющий разрешение на написание политики, может ссылаться на любой доступный логгер и заставить API Management отправлять выбранные запросы, ответы или данные, полученные от выражения, на его настроенный Event Hub, даже если у пользователя нет доступа к ресурсу логера. Это не даёт доступа к просмотру конфигурации логера или учетных данных, а также для чтения данных из хаба событий.

Использование

Примечания об использовании

  • На политику не влияет выборка Application Insights. Все вызовы политики регистрируются в журнале.
  • Максимальный поддерживаемый размер сообщения, который можно отправить в концентратор событий из этой политики, составляет 200 килобайт (КБ). Большее сообщение будет автоматически усечено до 200 КБ перед передачей в концентратор событий.

Пример

Любую строку можно использовать как значение для регистрации в Центрах событий. В этом примере имя и время службы развертывания, идентификатор запроса, IP-адрес и имя операции для всех входящих вызовов регистрируются в средство ведения журнала событий, зарегистрированного с идентификатором 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>

Связанный контент

Дополнительные сведения о работе с политиками см. в нижеуказанных статьях.

  • Last updated on