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 요청에 사용되는 플랫폼 유형입니다.