Usługa Azure SignalR jako źródło usługi Azure Event Grid

Ten artykuł zawiera właściwości i schemat zdarzeń usługi SignalR Service. Aby zapoznać się ze schematami zdarzeń, zobacz Schemat zdarzeń usługi Azure Event Grid. Zawiera również listę przewodników Szybki start i samouczków dotyczących używania usługi Azure SignalR jako źródła zdarzeń.

Dostępne typy zdarzeń

Usługa SignalR Service emituje następujące typy zdarzeń:

Typ zdarzenia	opis
Microsoft.SignalRService.ClientConnectionConnectionConnected	Zgłaszane, gdy połączenie klienta jest połączone.
Microsoft.SignalRService.ClientConnectionDisconnected	Zgłaszane po rozłączeniu połączenia klienta.

Przykładowe zdarzenie

Schemat zdarzeń w chmurze

W poniższym przykładzie przedstawiono schemat zdarzenia połączonego połączenia klienta:

[{
  "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"
}]

Schemat zdarzenia rozłączonego połączenia klienta jest podobny:

[{
  "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"
}]

Schemat zdarzeń usługi Event Grid

W poniższym przykładzie przedstawiono schemat zdarzenia połączonego połączenia klienta:

[{
  "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"
}]

Schemat zdarzenia rozłączonego połączenia klienta jest podobny:

[{
  "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"
}]

Właściwości zdarzenia

Schemat zdarzeń w chmurze

Zdarzenie ma następujące dane najwyższego poziomu:

Właściwość	Type	opis
source	string	Pełna ścieżka zasobu do źródła zdarzeń. To pole nie jest możliwe do zapisu. Ta wartość jest podawana przez usługę Event Grid.
subject	string	Zdefiniowana przez wydawcę ścieżka do tematu zdarzenia.
type	string	Jeden z zarejestrowanych typów zdarzeń dla tego źródła zdarzeń.
time	string	Czas generowania zdarzenia na podstawie czasu UTC dostawcy.
id	string	Unikatowy identyfikator zdarzenia.
data	obiekt	Dane zdarzeń usługi SignalR Service.
specversion	string	Wersja specyfikacji schematu CloudEvents.

Schemat zdarzeń usługi Event Grid

Zdarzenie ma następujące dane najwyższego poziomu:

Właściwość	Type	opis
topic	string	Pełna ścieżka zasobu do źródła zdarzeń. To pole nie jest możliwe do zapisu. Ta wartość jest podawana przez usługę Event Grid.
subject	string	Zdefiniowana przez wydawcę ścieżka do tematu zdarzenia.
eventType	string	Jeden z zarejestrowanych typów zdarzeń dla tego źródła zdarzeń.
eventTime	string	Czas generowania zdarzenia na podstawie czasu UTC dostawcy.
id	string	Unikatowy identyfikator zdarzenia.
data	obiekt	Dane zdarzeń usługi SignalR Service.
dataVersion	string	Wersja schematu obiektu danych. Wydawca definiuje wersję schematu.
metadataVersion	string	Wersja schematu metadanych zdarzenia. Usługa Event Grid definiuje schemat właściwości najwyższego poziomu. Ta wartość jest podawana przez usługę Event Grid.

Obiekt danych ma następujące właściwości:

Właściwość	Type	opis
timestamp	string	Czas generowania zdarzenia na podstawie czasu UTC dostawcy.
hubName	string	Koncentrator, do którego należy połączenie klienta.
connectionId	string	Unikatowy identyfikator połączenia klienta.
userId	string	Identyfikator użytkownika zdefiniowany w oświadczeniu.
errorMessage	string	Błąd powodujący rozłączenie połączenia.

Samouczki i poradniki

Nazwa	opis
Reagowanie na zdarzenia usługi Azure SignalR Service przy użyciu usługi Event Grid	Omówienie integracji usługi Azure SignalR Service z usługą Event Grid.
Jak wysyłać zdarzenia usługi Azure SignalR Service do usługi Event Grid	Przedstawia sposób wysyłania zdarzeń usługi Azure SignalR Service do aplikacji za pośrednictwem usługi Event Grid.

Następne kroki

• Aby zapoznać się z wprowadzeniem do usługi Azure Event Grid, zobacz Co to jest usługa Event Grid?
• Aby uzyskać więcej informacji na temat tworzenia subskrypcji usługi Azure Event Grid, zobacz Schemat subskrypcji usługi Event Grid.