Справочник по мониторингу данных Служебной шины Azure
Сведения о сборе и анализе данных мониторинга для Служебной шины Azure см. на странице Мониторинг Служебной шины Azure.
Примечание.
Azure Monitor не содержит измерения в экспортированных данных метрик, которые отправляются в место назначения (например, в службу хранилища Azure, Центры событий Azure или Log Analytics).
Метрики
В этом разделе перечислены все метрики платформы, автоматически собираемые Служебной шиной Azure. Поставщик ресурсов для этих метрик — Microsoft.ServiceBus/namespaces.
Метрики запросов
Подсчитывают объем данных и количество запросов операций управления.
| Имя метрики | Экспортируется с помощью параметров диагностики. | Единица измерения | Тип агрегирования | Description | Измерения |
|---|---|---|---|---|---|
| Входящие запросы | Да | Count | Итог | Число запросов к службе служебной шины за указанный период. | EntityName |
| Выполненные запросы | No | Count | Итог | Число успешных запросов к службе служебной шины за указанный период. | Имя объекта OperationResult |
| Ошибки сервера | No | Count | Итог | Число запросов, которые не были обработаны из-за ошибки в службе служебной шины, за указанный период. | Имя объекта OperationResult |
| Пользовательские ошибки | No | Count | Итог | Количество запросов, не обработанных из-за ошибки пользователя, за указанный период. | Имя объекта |
| Регулируемые запросы | No | Count | Итог | Число запросов, которые были отрегулированы из-за превышения квоты использования. Измерение MessagingErrorSubCode имеет следующие возможные значения:
|
Имя объекта MessagingErrorSubCode |
| Число операций контрольных точек, ожидающих обработки | No | count | По средней | Число операций контрольной точки в пространстве имен, ожидающих обработки. Регулирование службы начинается, если количество ожидающих обработки контрольных точек превышает предел: 500 000 + (500 000 * единица обмена сообщениями). Эта метрика применяется только к пространствам имен цен. категории Премиум. | MessagingErrorSubCode |
| Задержка отправки на сервере | No | мс | По средней | Время, затраченное службой Служебной шины на выполнение запроса. | Имя объекта |
К ошибкам пользователей относятся следующие два типа ошибок.
- Ошибки на стороне клиента (в HTTP это ошибки с кодом 400).
- Ошибки, возникающие при обработке сообщений (например, MessageLockLostException).
Метрики использования
| Имя метрики | Экспортируется с помощью параметров диагностики. | Единица измерения | Тип агрегирования | Description | Измерения |
|---|---|---|---|---|---|
| Входящие сообщения | Да | Count | Итог | Количество событий или сообщений, отправленных в служебную шину, за указанный период. Для базовых и стандартных уровней входящие автоматически пересылаемые сообщения включаются в эту метрику. И, для уровня "Премиум", они не включены. | Имя объекта |
| Исходящие сообщения | Да | Count | Итог | Количество событий или сообщений, полученных из служебной шины, за указанный период. Исходящие автоматически пересылаемые сообщения не включаются в эту метрику. | Имя объекта |
| Сообщения | No | Count | По средней | Количество сообщений в очереди или разделе. Эта метрика содержит сообщения во всех различных состояниях, таких как активные, недоставленные, запланированные и т. д. | Имя объекта |
| Активные сообщения | No | Count | По средней | Количество активных сообщений в очереди или разделе. Активные сообщения — это сообщения в очереди или подписке, которые находятся в активном состоянии и готовы к доставке. Сообщения доступны для получения. | Имя объекта |
| Недоставленные сообщения | No | Count | По средней | Число недоставленных сообщений в очереди или разделе. | Имя объекта |
| Запланированные сообщения | No | Count | По средней | Число запланированных сообщений в очереди или разделе. | Имя объекта |
| Завершенные сообщения | Да | Count | Итог | Количество сообщений, выполненных за указанный период. | Имя объекта |
| Отброшенные сообщения | Да | Count | Итог | Количество сообщений, отправленных в Служебную шину за указанный период. | Имя объекта |
| Размер | No | Байт | По средней | Размер сущности (очереди или раздела) в байтах. | Имя объекта |
Внимание
Значения для активных, недоставленных, запланированных, завершенных и отброшенных сообщений являются значениями на момент времени. Входящие сообщения, которые были получены сразу после этого момента времени, могут не отражаться в этих метриках.
Примечание.
Когда клиент пытается получить сведения о очереди или разделе, служба служебная шина возвращает некоторые статические сведения, такие как имя, последнее обновление времени, время создания, требует сеанса или нет и т. д., а также некоторые динамические сведения, такие как счетчики сообщений. Если запрос будет регулироваться, служба возвращает статические сведения и пустую динамическую информацию. Поэтому количество сообщений отображается как 0 при регулировании пространства имен. Такое поведение предусмотрено программой.
Метрики подключения
| Имя метрики | Экспортируется с помощью параметров диагностики. | Единица измерения | Тип агрегирования | Description | Измерения |
|---|---|---|---|---|---|
| Активные подключения | No | Count | Итог | Число активных подключений для пространства имен и для сущности в пространстве имен. Значение для этой метрики является значением на момент времени. Подключения, которые были активны сразу после этого момента времени, могут не отражаться в метрике. | |
| Открытые подключения | No | Count | По средней | Количество открытых подключений. Значение для этой метрики — это агрегирование и включает все подключения, открытые в окне времени агрегирования. | Имя объекта |
| закрытые подключения | No | Count | По средней | Количество закрытых подключений. Значение для этой метрики — это агрегирование и включает все подключения, открытые в окне времени агрегирования. | Имя объекта |
Метрики использования ресурсов
Примечание.
Следующие метрики доступны только в ценовой категории Премиум.
Важные метрики для отслеживания любых сбоев пространства имен уровня "Премиум": использование ЦП для пространства имен и размера памяти для каждого пространства имен. Настройте оповещения для этих метрик с помощью Azure Monitor.
Вот еще одна метрика, которую стоит отслеживать: Регулируемые запросы. Но проблемы с ней маловероятны, если для пространства имен сохраняется нормальная загрузка памяти, ЦП и подключений через брокер. Дополнительные сведения можно найти в разделе Регулирование на уровне "Премиум" Служебной шины Azure.
| Имя метрики | Экспортируется с помощью параметров диагностики. | Единица измерения | Тип агрегирования | Description | Измерения |
|---|---|---|---|---|---|
| CPU usage per namespace | No | ЦП | Процент | Процент использования ЦП для пространства имен. | Реплика |
| Memory size usage per namespace | No | Использование памяти | Процент | Процент использования памяти для пространства имен. | Реплика |
Метрики с ошибками
| Имя метрики | Экспортируется с помощью параметров диагностики. | Единица измерения | Тип агрегирования | Description | Измерения |
|---|---|---|---|---|---|
| Server Errors | No | Count | Итог | Число запросов, которые не были обработаны из-за ошибки в службе служебной шины, за указанный период. | Имя объекта Результат операции |
| Ошибки пользователей | No | Count | Итог | Количество запросов, не обработанных из-за ошибки пользователя, за указанный период. | Имя объекта Результат операции |
Измерения метрик
Служебная шина Azure поддерживает следующие измерения метрик в Azure Monitor. Добавление измерений для метрик является необязательным. Если не добавить измерения, то метрики указываются на уровне пространства имен.
| Имя измерения | Description |
|---|---|
| Имя сущности | Служебная шина поддерживает сущности обмена сообщениями в пространстве имен. При использовании метрики "Входящие запросы" измерение "Имя сущности" будет иметь значение "-NamespaceOnlyMetric-" в дополнение ко всем очередям и темам. Это представляет запрос, который был сделан на уровне пространства имен. Примеры включают запрос на перечисление всех очередей и разделов в пространстве имен или запросах к сущностям, которые завершили проверку подлинности или авторизацию. |
Журналы ресурсов
В этом разделе перечислены типы журналов ресурсов, которые можно собирать для Служебной шины Azure.
- Операционные журналы
- Виртуальные сети и журналы фильтрации IP-адресов
- Журналы аудита среды выполнения
Служебная шина Azure теперь имеет возможность отправлять журналы в две целевые таблицы — диагностику Azure или Таблицы, относящиеся к ресурсам, в Log Analytics. Для выбора целевых таблиц можно использовать переключатель, доступный в портал Azure.
Операционные журналы
Записи операционного журнала содержат элементы, перечисленные в приведенной ниже таблице.
| Имя | Описание | Поддерживается в AzureDiagnostics | Поддерживается в AZMSOperationalLogs (таблица "Конкретный ресурс") |
|---|---|---|---|
ActivityId |
Внутренний идентификатор, используемый для идентификации указанного действия | Да | Да |
EventName |
Наименование операции | Да | Да |
ResourceId |
Идентификатор ресурса Azure Resource Manager | Да | Да |
SubscriptionId |
ИД подписки | Да | Да |
EventtimeString |
Операция (время) | Да | Нет |
TimeGenerated [UTC] |
Время выполнения операции (в формате UTC) | No | Да |
EventProperties |
Свойства операции | Да | Да |
Status |
Состояние операции | Да | Да |
Caller |
Объект, вызывающий операцию (портал Azure или клиент управления) | Да | Да |
Provider |
Имя службы, создающей журналы, например ServiceBus | No | Да |
Type |
Тип журналов, создаваемых | No | Да |
Category |
Категория журнала | Да | Нет |
Ниже приведен пример строки 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 |
| Queue | — создание очереди — Обновление очереди — Удаление очереди — очередь автоматического удаления — получение очереди |
| Раздел | — Создание раздела — Обновление раздела — Удаление раздела — Раздел автоматического удаления — получение раздела |
| Отток подписок | — создание подписки — обновление подписки — Удаление подписки — автоматическая удаление подписки — получение подписки |
Примечание.
В настоящее время операции чтения не регистрируются в журналах операций.
Виртуальные сети и журналы фильтрации 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 |
Категория журнала | Да | Нет |
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 |
Период агрегирования. | Да | Нет |
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 |
Категория журнала | Да | Нет |
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"
}
Журналы диагностических ошибок
Журналы диагностических ошибок фиксируют сообщения об ошибках для любой стороны клиента, регулирования и превышения квоты. Они предоставляют подробные диагностика для идентификации ошибок.
Журналы диагностических ошибок включают элементы, перечисленные в следующей таблице:
| Имя | Описание | Поддерживается в Диагностика Azure | Поддерживается в AZMSDiagnosticErrorLogs (таблица с определенными ресурсами) |
|---|---|---|---|
ActivityId |
Созданный случайным образом уникальный идентификатор обеспечивает уникальность действий аудита. | Да | Да |
ActivityName |
Наименование операции | Да | Да |
NamespaceName |
Имя пространства имен | Да | yes |
EntityType |
Тип сущности | Да | Да |
EntityName |
Имя сущности | Да | Да |
OperationResult |
Тип ошибки в операции (Clienterror или Serverbusy или квота) | Да | Да |
ErrorCount |
Количество идентичных ошибок за период агрегирования в 1 минуту. | Да | Да |
ErrorMessage |
Подробное сообщение об ошибке | Да | Да |
Provider |
Имя службы, издающей журналы. Возможные значения: eventhub, ретранслятор и servicebus | Да | Да |
Time Generated (UTC) |
Время операции | No | Да |
EventTimestamp |
Операция (время) | Да | Нет |
Category |
Категория журнала | Да | Нет |
Type |
Тип журналов, создаваемых | No | Да |
Ниже приведен пример записи журнала диагностики ошибок:
{
"ActivityId": "0000000000-0000-0000-0000-00000000000000",
"SubscriptionId": "<Azure Subscription Id",
"NamespaceName": "Name of Service Bus Namespace",
"EntityType": "Queue",
"EntityName": "Name of Service Bus Queue",
"ActivityName": "SendMessage",
"ResourceId": "/SUBSCRIPTIONS/xxx/RESOURCEGROUPS/<Resource Group Name>/PROVIDERS/MICROSOFT.SERVICEBUS/NAMESPACES/<service bus namespace name>",,
"OperationResult": "ClientError",
"ErrorCount": 1,
"EventTimestamp": "3/27/2024 1:02:29.126 PM +00:00",
"ErrorMessage": "the sessionid was not set on a message, and it cannot be sent to the entity. entities that have session support enabled can only receive messages that have the sessionid set to a valid value.",
"category": "DiagnosticErrorLogs"
}
Запись конкретной таблицы для конкретного ресурса:
{
"ActivityId": "0000000000-0000-0000-0000-00000000000000",
"NamespaceName": "Name of Service Bus Namespace",
"EntityType": "Queue",
"EntityName": "Name of Service Bus Queue",
"ActivityName": "SendMessage",
"ResourceId": "/SUBSCRIPTIONS/xxx/RESOURCEGROUPS/<Resource Group Name>/PROVIDERS/MICROSOFT.SERVICEBUS/NAMESPACES/<service bus namespace name>",,
"OperationResult": "ClientError",
"ErrorCount": 1,
"TimeGenerated [UTC]": "1/27/2024 4:02:29.126 PM +00:00",
"ErrorMessage": "the sessionid was not set on a message, and it cannot be sent to the entity. entities that have session support enabled can only receive messages that have the sessionid set to a valid value.",
"Type": "AZMSDiagnosticErrorLogs"
}
30 сентября 2026 года мы отставим от поддержки протокола SBMP для Служебная шина Azure, поэтому вы больше не сможете использовать этот протокол после 30 сентября 2026 года. Миграция на последние библиотеки пакета SDK Служебная шина Azure с помощью протокола AMQP, который предлагает критически важные обновления системы безопасности и улучшенные возможности до этой даты.
Дополнительные сведения см. в объявлении о выходе на пенсию в службу поддержки.
Таблицы журналов Azure Monitor
Служебная шина Azure использует таблицы Kusto из журналов Azure Monitor. Эти таблицы можно запрашивать с помощью Log Analytics. Список таблиц Kusto, используемых службой, см. в разделе Справочник по таблицам журналов Azure Monitor.
Следующие шаги
- Дополнительные сведения о мониторинге Служебной шины Azure см. в статье Мониторинг Служебной шины Azure.
- Подробные сведения о мониторинге ресурсов Azure см. в статье "Мониторинг ресурсов Azure с помощью Azure Monitor".