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

  • Статья

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

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

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

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

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

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

[{
  "source": "/subscriptions/{subscription-id}/resourceGroups/signalr-rg/providers/Microsoft.SignalRService/SignalR/signalr-resource",
  "subject": "/hub/chat",
  "type": "Microsoft.SignalRService.ClientConnectionConnected",
  "time": "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"
  },
  "specversion": "1.0"
}]

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

[{
  "source": "/subscriptions/{subscription-id}/resourceGroups/signalr-rg/providers/Microsoft.SignalRService/SignalR/signalr-resource",
  "subject": "/hub/chat",
  "type": "Microsoft.SignalRService.ClientConnectionDisconnected",
  "time": "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."
  },
  "specversion": "1.0"
}]

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

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

Свойство Type Описание:
source строка Полный путь к ресурсу источника событий. Это поле защищено от записи. Это значение предоставляет Сетка событий.
subject строка Определенный издателем путь к субъекту события.
type строка Один из зарегистрированных типов событий для этого источника событий.
time строка Время создания события с учетом времени поставщика в формате UTC.
id строка Уникальный идентификатор события.
data объект Данные события службы SignalR.
specversion строка Версия спецификации схемы CloudEvents.

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

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

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

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

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