Azure Communication Services 채팅 로그
Azure Communication Services는 Communication Services 솔루션을 모니터링하고 디버깅하는 데 사용할 수 있는 로깅 기능을 제공합니다. 이러한 기능은 Azure Portal을 통해 구성할 수 있습니다.
Important
다음은 Azure Monitor를 통해 사용하도록 설정된 로그를 참조합니다(FAQ 참조). Communications Services에 이러한 로그를 사용하도록 설정하려면 진단 설정에서 로깅 사용을 참조하세요.
리소스 로그 범주
Communication Services는 사용할 수 있는 다음 유형의 로그를 제공합니다.
- 사용량 로그 - 요금이 청구된 각 서비스 제품과 연결된 사용량 데이터를 제공합니다.
- 인증 작업 로그 - 인증 서비스와 관련된 기본 정보를 제공합니다.
- 채팅 작업 로그 - 채팅 서비스와 관련된 기본 정보를 제공합니다.
사용량 로그 스키마
| 속성 | 설명 |
|---|---|
Timestamp |
로그가 생성된 시간의 타임스탬프(UTC)입니다. |
Operation Name |
로그 레코드와 연결된 작업입니다. |
Operation Version |
operationName이 API를 사용하여 수행된 경우 작업과 연결된 api-version입니다. 이 작업에 해당하는 API가 없으면, 버전은 작업과 연결된 속성이 나중에 변경될 경우, 해당 작업의 버전을 나타냅니다. |
Category |
이벤트의 로그 범주입니다. 범주는 특정 리소스에 대해 로그를 사용하거나 사용하지 않도록 설정할 수 있는 세분성입니다. 이벤트의 속성 Blob에 표시되는 속성은 특정 로그 범주 및 리소스 종류 내에서 동일합니다. |
Correlation ID |
상관 관계가 있는 이벤트의 ID입니다. 여러 테이블 간의 상관 관계가 지정된 이벤트를 식별하는 데 사용할 수 있습니다. |
Properties |
다양한 Communication Services 모드에 적용 가능한 기타 데이터입니다. |
Record ID |
지정된 사용량 레코드의 고유 ID입니다. |
Usage Type |
사용 모드입니다. (예: 채팅, PSTN, NAT 등) |
Unit Type |
지정된 사용 모드의 사용량 기준이 되는 단위 유형입니다 (예: 분, 메가바이트, 메시지 등). |
Quantity |
이 레코드에 사용된 단위 수입니다. |
인증 작업 로그
| 속성 | 설명 |
|---|---|
TimeGenerated |
로그가 생성된 시간의 타임스탬프(UTC)입니다. |
OperationName |
로그 레코드와 연결된 작업입니다. |
CorrelationID |
상관 관계가 있는 이벤트의 ID입니다. 여러 테이블 간의 상관 관계가 지정된 이벤트를 식별하는 데 사용할 수 있습니다. |
OperationVersion |
operationName이 API를 사용하여 수행된 경우 작업과 연결된 api-version입니다. 이 작업에 해당하는 API가 없으면, 버전은 작업과 연결된 속성이 나중에 변경될 경우, 해당 작업의 버전을 나타냅니다. |
Category |
이벤트의 로그 범주입니다. 범주는 특정 리소스에 대해 로그를 사용하거나 사용하지 않도록 설정할 수 있는 세분성입니다. 이벤트의 속성 Blob에 표시되는 속성은 특정 로그 범주 및 리소스 종류 내에서 동일합니다. |
ResultType |
작업의 상태입니다. |
ResultSignature |
작업의 하위 상태입니다. 이 작업이 REST API 호출에 해당하는 경우 이 필드는 해당 REST 호출의 HTTP 상태 코드입니다. |
DurationMs |
밀리초 단위의 작업 기간입니다. |
CallerIpAddress |
작업이 공용 IP 주소를 사용하는 엔터티에서 시작되는 API 호출에 해당하는 경우 호출자 IP 주소입니다. |
Level |
이벤트의 심각도 수준입니다. |
URI |
요청의 URI입니다. |
SdkType |
요청에 사용되는 SDK 유형입니다. |
PlatformType |
요청에 사용되는 플랫폼 유형입니다. |
Identity |
작업과 관련된 Azure Communication Services 또는 Teams 사용자의 ID입니다. |
Scopes |
액세스 토큰에 있는 Communication Services 범위입니다. |
채팅 작업 로그
| 속성 | 설명 |
|---|---|
| TimeGenerated | 로그가 생성된 시간의 타임스탬프(UTC)입니다. |
| OperationName | 로그 레코드와 연결된 작업입니다. |
| CorrelationID | 상관 관계가 있는 이벤트의 ID입니다. 여러 테이블 간의 상관 관계가 지정된 이벤트를 식별하는 데 사용할 수 있습니다. |
| OperationVersion | operationName이 API를 사용하여 수행된 경우 작업과 연결된 api-version입니다. 이 작업에 해당하는 API가 없으면, 버전은 작업과 연결된 속성이 나중에 변경될 경우, 해당 작업의 버전을 나타냅니다. |
| 범주 | 이벤트의 로그 범주입니다. 범주는 특정 리소스에 대해 로그를 사용하거나 사용하지 않도록 설정할 수 있는 세분성입니다. 이벤트의 속성 Blob에 표시되는 속성은 특정 로그 범주 및 리소스 종류 내에서 동일합니다. |
| ResultType | 작업의 상태입니다. |
| ResultSignature | 작업의 하위 상태입니다. 이 작업이 REST API 호출에 해당하는 경우 이 필드는 해당 REST 호출의 HTTP 상태 코드입니다. |
| ResultDescription | 이 작업에 대한 정적 텍스트 설명입니다. |
| DurationMs | 밀리초 단위의 작업 기간입니다. |
| callerIpAddress | 작업이 공용 IP 주소를 사용하는 엔터티에서 시작되는 API 호출에 해당하는 경우 호출자 IP 주소입니다. |
| 수준 | 이벤트의 심각도 수준입니다. |
| URI | 요청의 URI입니다. |
| 사용자 ID | 요청을 보낸 사람의 사용자 ID입니다. |
| ChatThreadId | 요청과 연관된 채팅 스레드 ID입니다. |
| ChatMessageId | 요청과 연관된 채팅 메시지 ID입니다. |
| SdkType | 요청에 사용되는 Sdk 유형입니다. |
| PlatformType | 요청에 사용되는 플랫폼 유형입니다. |