Создание пользовательских метрик
ОБЛАСТЬ ПРИМЕНЕНИЯ: все уровни Управление API
Политика emit-metric
отправляет пользовательские метрики определенного формата в Application Insights.
Примечание.
- Пользовательские метрики — это предварительная версия функции Azure Monitor, которая имеет ограничения.
- Дополнительные сведения о данных Управления API, добавленных в Application Insights, см. в статье Интеграция Управления API Azure в Azure Application Insights.
Примечание.
Задайте элементы политики и дочерние элементы в порядке, указанном в правиле политики. Узнайте, как устанавливать или изменять политики службы управления API.
Правило политики
<emit-metric name="name of custom metric" value="value of custom metric" namespace="metric namespace">
<dimension name="dimension name" value="dimension value" />
</emit-metric>
Атрибуты
Атрибут | Description | Обязательное поле | Default value |
---|---|---|---|
name | Строка . Имя пользовательской метрики. Выражения политики не допускаются. | Да | Н/П |
пространство имен | Строка . Пространство имен пользовательской метрики. Выражения политики не допускаются. | No | Управление API |
значение | Значение пользовательской метрики, выраженное как двойное. Допустимы выражения политики. | No | 1 |
Элементы
Элемент | Description | Обязательное поле |
---|---|---|
измерение | Добавьте один или несколько этих элементов для каждого измерения, входящего в настраиваемую метрику. | Да |
Атрибуты измерения
Атрибут | Description | Обязательное поле | Default value |
---|---|---|---|
name | Строковое выражение или выражение политики. Имя измерения. | Да | Н/П |
значение | Строковое выражение или выражение политики. Значение измерения. Можно опустить, только если name соответствует одному из измерений по умолчанию. Если это так, значение указывается в соответствии с именем измерения. |
No | Н/П |
Имена измерений по умолчанию, которые могут использоваться без значения
- Идентификатор API
- Идентификатор операции
- Код продукта
- Идентификатор пользователя
- ИД подписки
- Расположение
- Идентификатор шлюза
Использование
- Разделы политики: inbound, outbound, backend, on-error.
- Области политики: глобальная, рабочая область, продукт, API, операция
- Шлюзы: классическая, версия 2, потребление, локальное размещение, рабочая область
Примечания об использовании
Для этой политики можно настроить не более 10 пользовательских измерений.
emit-metric
Вызов политики учитывает ограничения использования пользовательских метрик для каждого региона в подписке. Подробнее
Пример
В следующем примере пользовательская метрика отправляется для подсчета количества запросов API вместе с идентификатором пользователя, IP-адресом клиента и идентификатором API в качестве пользовательских измерений.
<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>
Связанные политики
Связанный контент
Дополнительные сведения о работе с политиками см. в нижеуказанных статьях.
- Руководство. Преобразование и защита API
- Полный перечень операторов политик и их параметров см. в справочнике по политикам.
- Выражения политики
- Настройка или изменение политик
- Повторное использование конфигураций политик
- Репозиторий фрагментов политик
- Создание политик с помощью Microsoft Copilot в Azure