Справочник по мониторингу данных Служебной шины Azure

Сведения о сборе и анализе данных мониторинга для Служебной шины Azure см. на странице Мониторинг Служебной шины Azure.

Примечание.

Azure Monitor не содержит измерения в экспортированных данных метрик, которые отправляются в место назначения (например, в службу хранилища Azure, Центры событий Azure или Log Analytics).

Метрики

В этом разделе перечислены все метрики платформы, автоматически собираемые Служебной шиной Azure. Поставщик ресурсов для этих метрик — Microsoft.ServiceBus/namespaces.

Метрики запросов

Подсчитывают объем данных и количество запросов операций управления.

Имя метрики Экспортируется с помощью параметров диагностики. Единица измерения Тип агрегирования Description Измерения
Входящие запросы Да Count Всего Число запросов к службе служебной шины за указанный период. EntityName
Выполненные запросы Нет Count Всего Число успешных запросов к службе служебной шины за указанный период. Имя сущности
OperationResult
Ошибки сервера Нет Count Всего Число запросов, которые не были обработаны из-за ошибки в службе служебной шины, за указанный период. Имя сущности
OperationResult
Пользовательские ошибки Нет Count Всего Количество запросов, не обработанных из-за ошибки пользователя, за указанный период. Имя сущности
Регулируемые запросы Нет Count Всего

Число запросов, которые были отрегулированы из-за превышения квоты использования.

Измерение MessagingErrorSubCode имеет следующие возможные значения:

  • ЦП: регулировка ЦП
  • Служба хранилища: регулирование из-за ожидающих выполнения операций контрольной точки
  • Пространство имен: регулирование операций пространства имен.
  • Неизвестно: регулирование других ресурсов.
Имя сущности
MessagingErrorSubCode
Число операций контрольных точек, ожидающих обработки Нет count Average Число операций контрольной точки в пространстве имен, ожидающих обработки. Регулирование службы начинается, если количество ожидающих обработки контрольных точек превышает предел: 500 000 + (500 000 * единица обмена сообщениями). Эта метрика применяется только к пространствам имен цен. категории Премиум. MessagingErrorSubCode
Задержка отправки на сервере Нет мс Average Время, затраченное службой Служебной шины на выполнение запроса. Имя сущности

К ошибкам пользователей относятся следующие два типа ошибок.

  1. Ошибки на стороне клиента (в HTTP это ошибки с кодом 400).
  2. Ошибки, возникающие при обработке сообщений (например, MessageLockLostException).

Метрики использования

Имя метрики Экспортируется с помощью параметров диагностики. Единица измерения Тип агрегирования Description Измерения
Входящие сообщения Да Count Всего Количество событий или сообщений, отправленных в служебную шину, за указанный период. Для базовых и стандартных уровней входящие автоматически пересылаемые сообщения включаются в эту метрику. И, для уровня "Премиум", они не включены. Имя сущности
Исходящие сообщения Да Count Всего Количество событий или сообщений, полученных из служебной шины, за указанный период. Исходящие автоматически пересылаемые сообщения не включаются в эту метрику. Имя сущности
Сообщения Нет Count Average Количество сообщений в очереди или разделе. Эта метрика содержит сообщения во всех различных состояниях, таких как активные, недоставленные, запланированные и т. д. Имя сущности
Активные сообщения Нет Count Average Количество активных сообщений в очереди или разделе. Активные сообщения — это сообщения в очереди или подписке, которые находятся в активном состоянии и готовы к доставке. Сообщения доступны для получения. Имя сущности
Недоставленные сообщения Нет Count Average Число недоставленных сообщений в очереди или разделе. Имя сущности
Запланированные сообщения Нет Count Average Число запланированных сообщений в очереди или разделе. Имя сущности
Завершенные сообщения Да Count Всего Количество сообщений, выполненных за указанный период. Имя сущности
Отброшенные сообщения Да Count Всего Количество сообщений, отправленных в Служебную шину за указанный период. Имя сущности
Size Нет Байт Average Размер сущности (очереди или раздела) в байтах. Имя сущности

Важно!

Значения для активных, недоставленных, запланированных, завершенных и отброшенных сообщений являются значениями на момент времени. Входящие сообщения, которые были получены сразу после этого момента времени, могут не отражаться в этих метриках.

Примечание.

Когда клиент пытается получить сведения о очереди или разделе, служба служебная шина возвращает некоторые статические сведения, такие как имя, последнее обновление времени, время создания, требует сеанса или нет и т. д., а также некоторые динамические сведения, такие как счетчики сообщений. Если запрос будет регулироваться, служба возвращает статические сведения и пустую динамическую информацию. Поэтому количество сообщений отображается как 0 при регулировании пространства имен. В этом весь замысел.

Метрики подключения

Имя метрики Экспортируется с помощью параметров диагностики. Единица измерения Тип агрегирования Description Измерения
Активные подключения Нет Count Всего Число активных подключений для пространства имен и для сущности в пространстве имен. Значение для этой метрики является значением на момент времени. Подключения, которые были активны сразу после этого момента времени, могут не отражаться в метрике.
Открытые подключения Нет Count Average Количество открытых подключений. Значение для этой метрики — это агрегирование и включает все подключения, открытые в окне времени агрегирования. Имя сущности
закрытые подключения Нет Count Average Количество закрытых подключений. Значение для этой метрики — это агрегирование и включает все подключения, открытые в окне времени агрегирования. Имя сущности

Метрики использования ресурсов

Примечание.

Следующие метрики доступны только в ценовой категории Премиум.

Важные метрики для отслеживания любых сбоев пространства имен уровня "Премиум": использование ЦП для пространства имен и размера памяти для каждого пространства имен. Настройте оповещения для этих метрик с помощью Azure Monitor.

Вот еще одна метрика, которую стоит отслеживать: Регулируемые запросы. Но проблемы с ней маловероятны, если для пространства имен сохраняется нормальная загрузка памяти, ЦП и подключений через брокер. Дополнительные сведения можно найти в разделе Регулирование на уровне "Премиум" Служебной шины Azure.

Имя метрики Экспортируется с помощью параметров диагностики. Единица измерения Тип агрегирования Description Измерения
CPU usage per namespace Нет ЦП Процент Процент использования ЦП для пространства имен. Реплика
Memory size usage per namespace Нет Использование памяти Процент Процент использования памяти для пространства имен. Реплика

Метрики с ошибками

Имя метрики Экспортируется с помощью параметров диагностики. Единица измерения Тип агрегирования Description Измерения
Server Errors Нет Count Всего Число запросов, которые не были обработаны из-за ошибки в службе служебной шины, за указанный период. Имя сущности

Результат операции
Ошибки пользователей Нет Count Всего Количество запросов, не обработанных из-за ошибки пользователя, за указанный период. Имя сущности

Результат операции

Измерения метрик

Служебная шина Azure поддерживает следующие измерения метрик в Azure Monitor. Добавление измерений для метрик является необязательным. Если не добавить измерения, то метрики указываются на уровне пространства имен.

Имя измерения Description
Имя сущности Служебная шина поддерживает сущности обмена сообщениями в пространстве имен. При использовании метрики "Входящие запросы" измерение "Имя сущности" будет иметь значение "-NamespaceOnlyMetric-" в дополнение ко всем очередям и темам. Это представляет запрос, который был сделан на уровне пространства имен. Примеры включают запрос на перечисление всех очередей и разделов в пространстве имен или запросах к сущностям, которые завершили проверку подлинности или авторизацию.

Журналы ресурсов

В этом разделе перечислены типы журналов ресурсов, которые можно собирать для Служебной шины Azure.

  • Операционные журналы
  • Виртуальные сети и журналы фильтрации IP-адресов
  • Журналы аудита среды выполнения

Служебная шина Azure теперь имеет возможность отправлять журналы в две целевые таблицы — диагностику Azure или Таблицы, относящиеся к ресурсам, в Log Analytics. Для выбора целевых таблиц можно использовать переключатель, доступный в портал Azure.

Screenshot of dialog box to set destination table.

Операционные журналы

Записи операционного журнала содержат элементы, перечисленные в приведенной ниже таблице.

Имя Описание Поддерживается в AzureDiagnostics Поддерживается в AZMSOperationalLogs (таблица "Конкретный ресурс")
ActivityId Внутренний идентификатор, используемый для идентификации указанного действия Да Да
EventName Наименование операции Да Да
ResourceId Идентификатор ресурса Azure Resource Manager Да Да
SubscriptionId ИД подписки Да Да
EventtimeString Операция (время) Да No
TimeGenerated [UTC] Время выполнения операции (в формате UTC) No Да
EventProperties Свойства операции Да Да
Status Состояние операции Да Да
Caller Объект, вызывающий операцию (портал Azure или клиент управления) Да Да
Provider Имя службы, создающей журналы, например ServiceBus No Да
Type Тип журналов, создаваемых No Да
Category Категория журнала Да No

Ниже приведен пример строки JSON операционного журнала.

AzureDiagnostics:


{
  "ActivityId": "0000000000-0000-0000-0000-00000000000000",
  "EventName": "Create Queue",
  "resourceId": "/SUBSCRIPTIONS/<AZURE SUBSCRPTION ID>/RESOURCEGROUPS/<RESOURCE GROUP NAME>/PROVIDERS/MICROSOFT.SERVICEBUS/NAMESPACES/<SERVICE BUS NAMESPACE NAME>",
  "SubscriptionId": "0000000000-0000-0000-0000-00000000000000",
  "EventTimeString": "9/28/2016 8:40:06 PM +00:00",
  "EventProperties": "{\"SubscriptionId\":\"0000000000-0000-0000-0000-00000000000000\",\"Namespace\":\"mynamespace\",\"Via\":\"https://mynamespace.servicebus.windows.net/f8096791adb448579ee83d30e006a13e/?api-version=2016-07\",\"TrackingId\":\"5ee74c9e-72b5-4e98-97c4-08a62e56e221_G1\"}",
  "Status": "Succeeded",
  "Caller": "ServiceBus Client",
  "category": "OperationalLogs"
}


Запись конкретной таблицы для конкретного ресурса:


{

  "ActivityId": "0000000000-0000-0000-0000-00000000000000",
  "EventName": "Retrieve Queue",
  "resourceId": "/SUBSCRIPTIONS/<AZURE SUBSCRPTION ID>/RESOURCEGROUPS/<RESOURCE GROUP NAME>/PROVIDERS/MICROSOFT.SERVICEBUS/NAMESPACES/<SERVICE BUS NAMESPACE NAME>",
  "SubscriptionId": "0000000000-0000-0000-0000-00000000000000",
  "TimeGenerated(UTC)": "9/28/2023 8:40:06 PM +00:00",
  "EventProperties": "{\"SubscriptionId\":\"0000000000-0000-0000-0000-00000000000000\",\"Namespace\":\"mynamespace\",\"Via\":\"https://mynamespace.servicebus.windows.net/f8096791adb448579ee83d30e006a13e/?api-version=2016-07\",\"TrackingId\":\"5ee74c9e-72b5-4e98-97c4-08a62e56e221_G1\"}",
  "Status": "Succeeded",
  "Caller": "ServiceBus Client",
  "type": "AZMSOperationalLogs",
  "Provider" : "SERVICEBUS"

}

События и операции, регистрируемые в журналах операций

В журналах операций регистрируются все операции управления, выполняемые в пространстве имен служебной шины Azure. Операции с данными не регистрируются из-за большого количества операций с данными, выполняемых в Служебной шине Azure.

Примечание.

Чтобы лучше отслеживать операции с данными, рекомендуется использовать трассировку на стороне клиента.

В журналах операций регистрируются следующие операции управления.

Область Операция
Пространство имен — создание пространства имен
— Обновление пространства имен
— удаление пространства имен
— Обновление пространства имен
— получение пространства имен
— Политика SharedAccess
Очередь — создание очереди
— Обновление очереди
— Удаление очереди
— очередь автоматического удаления
— получение очереди
Тема — Создание раздела
— Обновление раздела
— Удаление раздела
— Раздел автоматического удаления
— получение раздела
Подписка — создание подписки
— обновление подписки
— Удаление подписки
— автоматическая удаление подписки
— получение подписки

Примечание.

В настоящее время операции чтения не регистрируются в журналах операций.

Виртуальные сети и журналы фильтрации IP-адресов

JSON события подключения к виртуальной сети служебной шины (VNet) включает элементы, перечисленные в следующей таблице.

Имя Описание Поддерживается в Диагностика Azure Поддерживается в AZMSVnet Подключение ionEvents (таблица с конкретным ресурсом)
SubscriptionId Идентификатор подписки Azure Да Да
NamespaceName Имя пространства имен Да Да
IPAddress IP-адрес клиента, подключающегося к службе служебной шины Да Да
AddressIP IP-адрес клиента, подключающегося к служебной шине Да Да
TimeGenerated [UTC] Время выполнения операции (в формате UTC) Да Да
Action Действие, выполняемое службой служебной шины при оценке запросов на подключение. Поддерживаемые действия: Accept Connection (Принять подключение) и Deny Connection (Отклонить подключение). Да Да
Reason Предоставляет причину выполнения действия. Да Да
Count Количество повторений для данного действия. Да Да
ResourceId Идентификатор ресурса Azure Resource Manager. Да Да
Category Категория журнала Да No
Provider Имя службы, создающей журналы, например ServiceBus No Да
Type Тип созданных журналов No Да

Примечание.

Журналы виртуальной сети создаются только в том случае, если пространство имен разрешает доступ из выбранных сетей или конкретных IP-адресов (правила фильтрации IP-адресов).

Вот пример строки JSON журнала виртуальной сети.

AzureDiagnostics;

{
    "SubscriptionId": "0000000-0000-0000-0000-000000000000",
    "NamespaceName": "namespace-name",
    "IPAddress": "1.2.3.4",
    "Action": "Accept Connection",
    "Reason": "IP is accepted by IPAddress filter.",
    "Count": 1,
    "ResourceId": "/SUBSCRIPTIONS/<AZURE SUBSCRIPTION ID>/RESOURCEGROUPS/<RESOURCE GROUP NAME>/PROVIDERS/MICROSOFT.SERVICEBUS/NAMESPACES/<SERVICE BUS NAMESPACE NAME>",
    "Category": "ServiceBusVNetConnectionEvent"
}

Запись конкретной таблицы для конкретного ресурса:

{
    "SubscriptionId": "0000000-0000-0000-0000-000000000000",
    "NamespaceName": "namespace-name",
    "AddressIp": "1.2.3.4",
    "Action": "Accept Connection",
    "Message": "IP is accepted by IPAddress filter.",
    "Count": 1,
    "ResourceId": "/SUBSCRIPTIONS/<AZURE SUBSCRIPTION ID>/RESOURCEGROUPS/<RESOURCE GROUP NAME>/PROVIDERS/MICROSOFT.SERVICEBUS/NAMESPACES/<SERVICE BUS NAMESPACE NAME>",
    "Provider" : "SERVICEBUS",
    "Type": "AZMSVNetConnectionEvents"
}

Журналы аудита среды выполнения

Журналы аудита среды выполнения собирают агрегированные диагностические сведения по различным операциям плоскости данных (например, по отправке и получению сообщений) в Служебной шине.

Примечание.

Журналы аудита среды выполнения в настоящее время доступны только на уровне служб Премиум.

Журналы аудита среды событий включают элементы, перечисленные в следующей таблице.

Имя Описание Поддерживается в Диагностика Azure Поддерживается в AZMSRuntimeAuditLogs (таблица с конкретным ресурсом)
ActivityId Созданный случайным образом уникальный идентификатор обеспечивает уникальность действий аудита. Да Да
ActivityName Имя операции среды выполнения. Да Да
ResourceId Ресурс, связанный с этим действием. Да Да
Timestamp Период агрегирования. Да No
time Generated (UTC) Агрегированное время No Да
Status Состояние действия (успех или неудача). Да Да
Protocol Тип протокола, связанный с этой операцией. Да Да
AuthType Тип проверки подлинности (идентификатор Microsoft Entra или политика SAS). Да Да
AuthKey Идентификатор приложения Microsoft Entra или имя политики SAS, используемое для проверки подлинности в ресурсе. Да Да
NetworkType Тип сетевого доступа: Public или Private. yes Да
ClientIP IP-адрес клиентского приложения. Да Да
Count Общее количество операций, выполненных за период агрегирования (1 минуту). Да Да
Properties Метаданные, относящиеся к операции плоскости данных. yes Да
Category Категория журнала Да No
Provider Имя службы, создающей журналы, например ServiceBus No Да
Type Тип журналов, создаваемых No Да

Ниже представлен пример записи журнала аудита среды выполнения.

AzureDiagnostics:

{
    "ActivityId": "<activity id>",
    "ActivityName": "ConnectionOpen | Authorization | SendMessage | ReceiveMessage | PeekLockMessage",
    "ResourceId": "/SUBSCRIPTIONS/xxx/RESOURCEGROUPS/<Resource Group Name>/PROVIDERS/MICROSOFT.SERVICEBUS/NAMESPACES/<Service Bus namespace>/servicebus/<service bus name>",
    "Time": "1/1/2021 8:40:06 PM +00:00",
    "Status": "Success | Failure",
    "Protocol": "AMQP | HTTP | SBMP", 
    "AuthType": "SAS | AAD", 
    "AuthKey": "<AAD Application Name| SAS policy name>",
    "NetworkType": "Public | Private", 
    "ClientIp": "x.x.x.x",
    "Count": 1, 
    "Category": "RuntimeAuditLogs"
 }

Запись конкретной таблицы для конкретного ресурса:

{
    "ActivityId": "<activity id>",
    "ActivityName": "ConnectionOpen | Authorization | SendMessage | ReceiveMessage | PeekLockMessage",
    "ResourceId": "/SUBSCRIPTIONS/xxx/RESOURCEGROUPS/<Resource Group Name>/PROVIDERS/MICROSOFT.SERVICEBUS/NAMESPACES/<Service Bus namespace>/servicebus/<service bus name>",
    "TimeGenerated (UTC)": "1/1/2021 8:40:06 PM +00:00",
    "Status": "Success | Failure",
    "Protocol": "AMQP | HTTP | SBMP", 
    "AuthType": "SAS | AAD", 
    "AuthKey": "<AAD Application Name| SAS policy name>",
    "NetworkType": "Public | Private", 
    "ClientIp": "x.x.x.x",
    "Count": 1, 
    "Provider": "SERVICEBUS",
    "Type"   : "AZMSRuntimeAuditLogs"
 }

30 сентября 2026 года мы отставим от поддержки протокола SBMP для Служебная шина Azure, поэтому вы больше не сможете использовать этот протокол после 30 сентября 2026 года. Миграция на последние библиотеки пакета SDK Служебная шина Azure с помощью протокола AMQP, который предлагает критически важные обновления системы безопасности и улучшенные возможности до этой даты.

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

Таблицы журналов Azure Monitor

Служебная шина Azure использует таблицы Kusto из журналов Azure Monitor. Эти таблицы можно запрашивать с помощью Log Analytics. Список таблиц Kusto, используемых службой, см. в разделе Справочник по таблицам журналов Azure Monitor.

Следующие шаги