Схема событий службы "Сетка событий Azure" для службы SignalR

В этой статье рассматриваются свойства и схема для событий Службы SignalR. Общие сведения о схемах событий см. в статье Схема событий службы "Сетка событий Azure". Здесь также приводится список кратких руководств и учебников по использованию Azure SignalR в качестве источника событий.

Доступные типы событий

Служба SignalR выдает указанные ниже типы событий.

Тип события Описание
Microsoft.SignalRService.ClientConnectionConnected Возникает при установке клиентского соединения.
Microsoft.SignalRService.ClientConnectionDisconnected Возникает при отключении клиентского соединения.

Пример события

В следующем примере показана схема события установки клиентского соединения:

[{
  "topic": "/subscriptions/{subscription-id}/resourceGroups/signalr-rg/providers/Microsoft.SignalRService/SignalR/signalr-resource",
  "subject": "/hub/chat",
  "eventType": "Microsoft.SignalRService.ClientConnectionConnected",
  "eventTime": "2019-06-10T18:41:00.9584103Z",
  "id": "831e1650-001e-001b-66ab-eeb76e069631",
  "data": {
    "timestamp": "2019-06-10T18:41:00.9584103Z",
    "hubName": "chat",
    "connectionId": "crH0uxVSvP61p5wkFY1x1A",
    "userId": "user-eymwyo23"
  },
  "dataVersion": "1.0",
  "metadataVersion": "1"
}]

Схема для события отключения клиентского соединения аналогична:

[{
  "topic": "/subscriptions/{subscription-id}/resourceGroups/signalr-rg/providers/Microsoft.SignalRService/SignalR/signalr-resource",
  "subject": "/hub/chat",
  "eventType": "Microsoft.SignalRService.ClientConnectionDisconnected",
  "eventTime": "2019-06-10T18:41:00.9584103Z",
  "id": "831e1650-001e-001b-66ab-eeb76e069631",
  "data": {
    "timestamp": "2019-06-10T18:41:00.9584103Z",
    "hubName": "chat",
    "connectionId": "crH0uxVSvP61p5wkFY1x1A",
    "userId": "user-eymwyo23",
    "errorMessage": "Internal server error."
  },
  "dataVersion": "1.0",
  "metadataVersion": "1"
}]

Свойства события

Событие содержит следующие высокоуровневые данные:

Свойство Тип Описание
topic строка Полный путь к ресурсу для источника событий. Это поле защищено от записи. Это значение предоставляет служба "Сетка событий".
subject строка Определенный издателем путь к субъекту событий.
eventType строка Один из зарегистрированных типов событий для этого источника событий.
eventTime строка Время создания события с учетом времени поставщика в формате UTC.
id строка Уникальный идентификатор события.
data object Данные события службы SignalR.
dataVersion строка Версия схемы для объекта данных. Версию схемы определяет издатель.
metadataVersion строка Версия схемы для метаданных события. Служба "Сетка событий" определяет схему свойств верхнего уровня. Это значение предоставляет служба "Сетка событий".

Объект данных имеет следующие свойства:

Свойство Тип Описание
timestamp строка Время создания события с учетом времени поставщика в формате UTC.
hubName строка Концентратор, к которому относится клиентское соединение.
connectionId строка Уникальный идентификатор клиентского подключения.
userId строка Идентификатор пользователя, заданный в утверждении.
errorMessage строка Ошибка, вызывающая отключение соединения.

Руководства и учебные материалы

Заголовок Описание
Реагирование на события службы Azure SignalR с помощью Сетки событий Общие сведения об интеграции Службы Azure SignalR со службой "Сетка событий".
Отправка событий службы Azure SignalR в службу "Сетка событий" Здесь объясняется, как отправлять события службы Azure SignalR в приложение через службу "Сетка событий".

Дальнейшие действия