Azure Communication Services 회의실 로그
Azure Communication Services는 Communication Services 솔루션을 모니터링하고 디버깅하는 데 사용할 수 있는 로깅 기능을 제공합니다. 이러한 기능은 Azure Portal을 통해 구성할 수 있습니다.
Important
다음은 Azure Monitor를 통해 사용하도록 설정된 로그를 참조합니다(FAQ 참조). Communications Services에 이러한 로그를 사용하도록 설정하려면 진단 설정에서 로깅 사용을 참조하세요.
필수 구성 요소
Azure Communications Services는 Azure Monitor 로그 개요 및 Azure Monitor 메트릭을 통해 모니터링 및 분석 기능을 제공합니다. 각 Azure 리소스에는 다음 기준을 정의하는 자체 진단 설정이 필요합니다.
- 설정에 정의된 대상으로 전송된 로그 및 메트릭 데이터의 범주입니다. 사용 가능한 범주는 리소스 종류에 따라 달라집니다.
- 로그를 보낼 하나 이상의 대상입니다. 현재 대상에는 Log Analytics 작업 영역, Event Hubs 및 Azure Storage가 포함됩니다.
- 단일 진단 설정으로 각 대상 중 하나만 정의할 수 있습니다. 데이터를 2개 이상의 특정 대상 유형(예: 두 개의 다른 Log Analytics 작업 영역)으로 보내려면 여러 개의 설정을 만듭니다. 각 리소스에는 최대 5개의 진단 설정이 있을 수 있습니다.
다음은 Communications Services에 대한 로그 및 메트릭 만들기를 시작하도록 Azure Monitor 리소스를 구성하기 위한 지침입니다. 모든 Azure 리소스에서 진단 설정 사용에 대한 자세한 설명은 진단 설정에서 로깅 사용을 참조하세요.
참고 항목
진단 설정 이름 아래에서 "운영 회의실 로그"를 선택하여 회의실에 대한 로그를 사용하도록 설정합니다.
개요
회의실 운영 로그는 Rooms API 요청에 대한 인사이트를 제공하는 이벤트 및 활동의 레코드입니다. 각 회의실 요청의 상태와 추가 속성을 포함하여 회의실 기본 형식의 성능 및 기능에 대한 세부 정보를 캡처합니다. 회의실 운영 로그에는 회의실 사용량의 추세와 패턴을 식별하는 데 도움이 되는 정보가 포함되어 있습니다.
로그 범주
Communication Services는 사용할 수 있는 다음 유형의 로그를 제공합니다.
- 운영 회의실 로그 - 회의실 서비스와 관련된 기본 정보를 제공합니다.
운영 회의실 로그 스키마
| 속성 | 설명 |
|---|---|
Correlation ID |
요청의 고유 ID |
Level |
이벤트의 심각도 수준입니다. |
Operation Name |
로그 레코드와 연결된 작업입니다. 예: CreateRoom, PatchRoom, GetRoom, ListRooms, DeleteRoom, GetParticipants, UpdateParticipants |
Operation Version |
작업과 연결된 api-version |
ResultType |
작업의 상태입니다. |
ResultSignature |
작업의 하위 상태입니다. 이 작업이 REST API 호출에 해당하는 경우 이 필드는 해당 REST 호출의 HTTP 상태 코드입니다. |
.RoomId |
회의실의 ID |
RoomLifeSpan |
회의실 수명(분) |
AddedRoomParticipantsCount |
회의실에 추가된 참가자 수 |
UpsertedRoomParticipantsCount |
회의실에서 upsert된 참가자 수 |
RemovedRoomParticipantsCount |
회의실에서 제거된 참가자 수 |
TimeGenerated |
로그가 생성된 시간의 타임스탬프(UTC)입니다. |
PstnDialOutEnabled |
회의실에서 모임에 사용자를 초대하기 위해 PSTN을 호출할 수 있는지 여부를 나타냅니다. |
CreateRoom 로그 예제
[
{
"CorrelationId": "Y4x6ZabFE0+E8ERwMpd68w",
"Level": "Informational",
"OperationName": "CreateRoom",
"OperationVersion": "2023-10-30-preview",
"ResultType": "Succeeded",
"ResultSignature": 201,
"RoomId": "99466898241024408",
"RoomLifespan": 61,
"AddedRoomParticipantsCount": 4,
"TimeGenerated": "5/25/2023, 4:32:49.469 AM",
"PstnDialOutEnabled": false,
}
]
GetRoom 로그 예제
[
{
"CorrelationId": "CNiZIX7fvkumtBSpFq7fxg",
"Level": "Informational",
"OperationName": "GetRoom",
"OperationVersion": "2023-10-30-preview",
"ResultType": "Succeeded",
"ResultSignature": "200",
"RoomId": "99466387192310000",
"RoomLifespan": 61,
"TimeGenerated": "2022-08-19T17:07:30.2400300Z",
},
]
UpdateRoom 로그 예제
[
{
"CorrelationId": "Bwqzh0pdnkGPDwNcMnBkng",
"Level": "Informational",
"OperationName": "UpdateRoom",
"OperationVersion": "2023-10-30-preview",
"ResultType": "Succeeded",
"ResultSignature": "200",
"RoomId": "99466387192310000",
"RoomLifespan": 121,
"TimeGenerated": "2022-08-19T17:07:30.3543160Z",
"PstnDialOutEnabled": false,
},
]
DeleteRoom 로그 예제
[
{
"CorrelationId": "x7rMXmihYEe3GFho9T/H2w",
"Level": "Informational",
"OperationName": "DeleteRoom",
"OperationVersion": "2023-10-30-preview",
"ResultType": "Succeeded",
"ResultSignature": "204",
"RoomId": "99466387192310000",
"RoomLifespan": 121,
"TimeGenerated": "2022-08-19T17:07:30.5393800Z",
},
]
ListRooms 로그 예제
[
{
"CorrelationId": "KibM39CaXkK+HTInfsiY2w",
"Level": "Informational",
"OperationName": "ListRooms",
"OperationVersion": "2023-10-30-preview",
"ResultType": "Succeeded",
"ResultSignature": "200",
"TimeGenerated": "2022-08-19T17:07:30.5393800Z",
},
]
UpdateParticipants 로그 예제
[
{
"CorrelationId": "zHT8snnUMkaXCRDFfjQDJw",
"Level": "Informational",
"OperationName": "UpdateParticipants",
"OperationVersion": "2023-10-30-preview",
"ResultType": "Succeeded",
"ResultSignature": "200",
"RoomId": "99466387192310000",
"RoomLifespan": 121,
"UpsertedRoomParticipantsCount": 5,
"RemovedRoomParticipantsCount": 1,
"TimeGenerated": "2023-04-14T17:07:30.5393800Z",
},
]
(FAQ도 참조)