Azure SignalR als een Azure Event Grid-bron

Dit artikel bevat de eigenschappen en het schema voor SignalR Service-gebeurtenissen. Zie het Gebeurtenisschema van Azure Event Grid voor een inleiding tot gebeurtenisschema's. U krijgt ook een lijst met quickstarts en zelfstudies voor het gebruik van Azure SignalR als gebeurtenisbron.

Beschikbare gebeurtenistypen

SignalR Service verzendt de volgende gebeurtenistypen:

Gebeurtenistype	Beschrijving
Microsoft.SignalRService.ClientConnectionConnected	Wordt gegenereerd wanneer een clientverbinding is verbonden.
Microsoft.SignalRService.ClientConnectionDisconnected	Wordt gegenereerd wanneer de verbinding met de client is verbroken.

Voorbeeld van een gebeurtenis

Cloud-gebeurtenisschema

In het volgende voorbeeld ziet u het schema van een verbonden gebeurtenis voor een clientverbinding:

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

Het schema voor een niet-verbonden clientverbinding is vergelijkbaar:

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

Event Grid-gebeurtenisschema

In het volgende voorbeeld ziet u het schema van een verbonden gebeurtenis voor een clientverbinding:

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

Het schema voor een niet-verbonden clientverbinding is vergelijkbaar:

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

Eigenschappen van gebeurtenis

Cloud-gebeurtenisschema

Een gebeurtenis bevat de volgende gegevens op het hoogste niveau:

Eigenschap	Type	Omschrijving
source	tekenreeks	Volledig resourcepad naar de gebeurtenisbron. Dit veld kan niet worden geschreven. Event Grid biedt deze waarde.
subject	tekenreeks	Het door de uitgever gedefinieerde pad naar het gebeurtenisonderwerp.
type	tekenreeks	Een van de geregistreerde gebeurtenistypen voor deze gebeurtenisbron.
time	tekenreeks	Het tijdstip waarop de gebeurtenis wordt gegenereerd op basis van de UTC-tijd van de provider.
id	tekenreeks	Unieke id voor de gebeurtenis.
data	object	Gebeurtenisgegevens van SignalR Service.
specversion	tekenreeks	CloudEvents schemaspecificatieversie.

Event Grid-gebeurtenisschema

Een gebeurtenis bevat de volgende gegevens op het hoogste niveau:

Eigenschap	Type	Omschrijving
topic	tekenreeks	Volledig resourcepad naar de gebeurtenisbron. Dit veld kan niet worden geschreven. Event Grid biedt deze waarde.
subject	tekenreeks	Het door de uitgever gedefinieerde pad naar het gebeurtenisonderwerp.
eventType	tekenreeks	Een van de geregistreerde gebeurtenistypen voor deze gebeurtenisbron.
eventTime	tekenreeks	Het tijdstip waarop de gebeurtenis wordt gegenereerd op basis van de UTC-tijd van de provider.
id	tekenreeks	Unieke id voor de gebeurtenis.
data	object	Gebeurtenisgegevens van SignalR Service.
dataVersion	tekenreeks	De schemaversie van het gegevensobject. De uitgever definieert de schemaversie.
metadataVersion	tekenreeks	De schemaversie van de metagegevens van de gebeurtenis. Event Grid definieert het schema voor de eigenschappen op het hoogste niveau. Event Grid biedt deze waarde.

Het gegevensobject heeft de volgende eigenschappen:

Eigenschap	Type	Omschrijving
timestamp	tekenreeks	Het tijdstip waarop de gebeurtenis wordt gegenereerd op basis van de UTC-tijd van de provider.
hubName	tekenreeks	De hub waartoe de clientverbinding behoort.
connectionId	tekenreeks	De unieke id voor de clientverbinding.
userId	tekenreeks	De gebruikers-id die is gedefinieerd in de claim.
errorMessage	tekenreeks	De fout waardoor de verbinding is verbroken.

Zelfstudies en handleidingen

Title	Beschrijving
Reageren op Azure SignalR Service-gebeurtenissen met behulp van Event Grid	Overzicht van de integratie van Azure SignalR Service met Event Grid.
Azure SignalR Service-gebeurtenissen verzenden naar Event Grid	Laat zien hoe u Azure SignalR Service-gebeurtenissen naar een toepassing verzendt via Event Grid.

Volgende stappen

• Zie Wat is Event Grid? voor een inleiding tot Azure Event Grid.
• Zie het Event Grid-abonnementsschema voor meer informatie over het maken van een Azure Event Grid-abonnement.