다음을 통해 공유

Azure Event Grid 원본으로서의 Azure SignalR

  • 아티클

이 문서에서는 SignalR Service 이벤트의 속성과 스키마를 제공합니다. 이벤트 스키마에 대한 소개는 Azure Event Grid 이벤트 스키마를 참조하세요. 또한 이벤트 원본으로 Azure SignalR을 사용하기 위한 빠른 시작 및 자습서의 목록을 제공합니다.

사용할 수 있는 이벤트 유형

SignalR Service는 다음과 같은 이벤트 유형을 내보냅니다.

이벤트 유형 설명
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 string 이벤트 원본에 대한 전체 리소스 경로입니다. 이 필드는 쓸 수 없습니다. Event Grid는 이 값을 제공합니다.
subject string 게시자가 정의한 이벤트 주체의 경로입니다.
type string 이 이벤트 원본에 대해 등록된 이벤트 유형 중 하나입니다.
time string 공급자의 UTC 시간을 기준으로 이벤트가 생성되는 시간입니다.
id string 이벤트에 대한 고유 식별자입니다.
data 개체 SignalR Service 이벤트 데이터입니다.
specversion string CloudEvents 스키마 사양 버전입니다.

데이터 개체의 속성은 다음과 같습니다.

속성 Type 설명
timestamp string 공급자의 UTC 시간을 기준으로 이벤트가 생성되는 시간입니다.
hubName string 클라이언트 연결이 속한 허브입니다.
connectionId string 클라이언트 연결의 고유 식별자입니다.
userId string 클레임에 정의된 사용자 ID입니다.
errorMessage string 연결이 끊길 때 발생하는 오류입니다.

자습서 및 방법

제목 설명
Event Grid를 사용하여 Azure SignalR Service 이벤트에 대응 Azure SignalR Service를 Event Grid와 통합하는 방법에 대한 개요입니다.
Azure SignalR Service에서 Event Grid로 이벤트를 보내는 방법 Event Grid를 통해 Azure SignalR Service 이벤트를 애플리케이션으로 보내는 방법을 보여 줍니다.

다음 단계