Esquema de eventos da Grade de Eventos do Azure para o Serviço SignalR

  • Artigo

Este artigo fornece as propriedades e o esquema para eventos do Serviço SignalR. Para obter uma introdução aos esquemas de eventos, consulte Esquema de eventos da Grade de Eventos do Azure. Ele também fornece uma lista de inícios rápidos e tutoriais para usar o Azure SignalR como uma fonte de eventos.

Tipos de eventos disponíveis

O Serviço SignalR emite os seguintes tipos de eventos:

Tipo de evento Description
Microsoft.SignalRService.ClientConnectionConnected Gerado quando uma conexão de cliente se conecta.
Microsoft.SignalRService.ClientConnectionDesconectado Gerado quando uma conexão de cliente é desconectada.

Exemplo de evento

O exemplo a seguir mostra o esquema de um evento conectado à conexão do cliente:

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

O esquema para um evento de conexão de cliente desconectado é semelhante:

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

Propriedades do evento

Um evento tem os seguintes dados de nível superior:

Propriedade Type Description
source string Caminho completo do recurso para a origem do evento. Este campo não pode ser gravado. O Event Grid fornece este valor.
subject string Caminho definido pelo publicador para o assunto do evento.
type string Um dos tipos de eventos registados para esta origem de evento.
time string A hora em que o evento é gerado com base na hora UTC do provedor.
id string Identificador exclusivo do evento.
data objeto Dados de eventos do Serviço SignalR.
specversion string Versão da especificação do esquema CloudEvents.

O objeto de dados tem as seguintes propriedades:

Propriedade Type Description
timestamp string A hora em que o evento é gerado com base na hora UTC do provedor.
hubName string O hub ao qual a conexão do cliente pertence.
connectionId string O identificador exclusivo para a conexão do cliente.
userId string O identificador de usuário definido na declaração.
errorMessage string O erro que faz com que a conexão seja desconectada.

Tutorials and how-tos (Tutoriais e procedimentos)

Title Description
Reagir a eventos do Serviço SignalR do Azure usando a Grade de Eventos Visão geral da integração do Serviço Azure SignalR com a Grade de Eventos.
Como enviar eventos do Serviço Azure SignalR para a Grade de Eventos Mostra como enviar eventos do Serviço Azure SignalR para um aplicativo por meio da Grade de Eventos.

Próximos passos

  • Para obter uma introdução à Grade de Eventos do Azure, consulte O que é a Grade de Eventos?
  • Para obter mais informações sobre como criar uma assinatura da Grade de Eventos do Azure, consulte Esquema de assinatura da Grade de Eventos.