메트릭 개요
Azure Communication Services는 현재 모든 Azure 통신 서비스의 기본 형식에 대한 메트릭을 제공합니다. Azure 메트릭 탐색기를 사용하면 사용자 고유의 차트를 만들고, 비정상적인 메트릭 값을 조사하고, 이메일 요청에서 내보내는 메트릭 데이터를 사용하여 API 트래픽을 이해할 수 있습니다.
메트릭을 찾을 수 있는 위치
Azure Communication Services의 기본 요소는 API 요청에 대한 메트릭을 내보냅니다. 이러한 메트릭은 Communication Services 리소스 아래의 메트릭 탭에서 찾을 수 있습니다. Communication Services 리소스 아래의 통합 문서 탭을 사용하여 영구 대시보드를 만들 수도 있습니다.
메트릭 정의
모든 API 요청 메트릭에는 메트릭 데이터를 필터링하는 데 사용할 수 있는 세 가지 차원이 포함되어 있습니다. 이러한 차원은 Count 집계 유형을 사용하여 함께 집계할 수 있으며 Sum, Average, Min 및 Max를 비롯한 모든 표준 Azure 집계 시계열을 지원합니다.
지원되는 집계 유형 및 시계열 집계에 대한 자세한 내용은 Azure 메트릭 탐색기의 고급 기능에서 찾을 수 있습니다.
- 작업 - Azure Communication Services 채팅 게이트웨이에서 호출할 수 있는 모든 작업 또는 경로입니다.
- 상태 코드 - 요청 후에 전송된 상태 코드 응답입니다.
- StatusSubClass - 응답 후에 전송된 상태 코드 시리즈입니다.
고급 메시징 API 요청
고급 메시징 API 요청 메트릭에서는 다음 작업을 사용할 수 있습니다.
| 작업/경로 | 설명 | 시나리오 |
|---|---|---|
| DownloadMedia | 미디어 페이로드 요청을 다운로드합니다. | 기업에서 미디어 페이로드 다운로드를 요청했습니다. |
| ListTemplates | 목록 템플릿 요청입니다. | 특정 채널에 대한 템플릿을 나열하도록 기업에서 요청했습니다. |
| ReceiveMessage | 수신된 메시지 | 사용자가 업체에 메시지를 보냈습니다. |
| SendMessage | 메시지 알림 요청을 보냅니다. | 사용자에게 메시지 전송을 요청하는 비즈니스입니다. |
| SendMessageDeliveryStatus | 제공 상태를 받았습니다. | 기업이 사용자에게 보내도록 요청한 메시지에 대한 응답을 받았습니다. |
인증 API 요청
인증 API 요청 메트릭에는 다음과 같은 작업을 사용할 수 있습니다.
| 작업/경로 | 설명 |
|---|---|
| CreateIdentity | 단일 사용자를 나타내는 ID를 만듭니다. |
| DeleteIdentity | ID를 삭제합니다. |
| CreateToken | 액세스 토큰을 만듭니다. |
| RevokeToken | 지정된 시간 전에 ID에 대해 만들어진 모든 액세스 토큰을 취소합니다. |
| ExchangeTeamsUserAccessToken | 만료 시간이 일치하는 새 통신 ID 액세스 토큰에 대한 Teams 사용자의 Microsoft Entra 액세스 토큰을 교환합니다. |
통화 자동화 API 요청
통화 자동화 API 요청 메트릭에서 다음 작업을 사용할 수 있습니다.
| 작업/경로 | 설명 |
|---|---|
| 호출 만들기 | 사용자에 대한 아웃바운드 호출을 만듭니다. |
| 통화 응답 | 인바운드 통화에 응답합니다. |
| 통화 리디렉션 | 인바운드 통화를 다른 사용자에게 리디렉션합니다. |
| 호출 거부 | 인바운드 통화를 거부합니다. |
| 통화를 참가자에게 전달 | 1:1 통화를 다른 사용자에게 전달합니다. |
| 재생 | 오디오를 재생하여 참가자에게 전화를 겁니다. |
| PlayPrompt | 인식 작업의 일부로 사용자에게 프롬프트를 재생합니다. |
| 인식 | 통화 참가자의 사용자 입력을 인식합니다. |
| 참가자 추가 | 통화에 참가자 추가 |
| 참가자 제거 | 통화에서 참가자 제거 |
| 통화 끊기 | 통화를 끊습니다. |
| 통화 종료 | 모든 참가자의 통화를 종료합니다. |
| 통화 가져오기 | 통화에 대한 세부 정보를 가져옵니다. |
| 참가자 가져오기 | 통화 참가자에 대한 세부 정보를 가져옵니다. |
| 참가자 가져오기 | 통화에 참여한 모든 참가자를 통화를 가져옵니다. |
| 통화 삭제 | 통화를 삭제합니다. |
| 모든 미디어 작업 취소 | 통화가 진행 중이거나 대기 중인 모든 미디어 작업을 취소합니다. |
채팅 API 요청 메트릭 작업
채팅 API 요청 메트릭에는 다음과 같은 작업을 사용할 수 있습니다.
| 작업/경로 | 설명 |
|---|---|
| GetChatMessage | 메시지 ID별로 메시지를 가져옵니다. |
| ListChatMessages | 스레드의 채팅 메시지 목록을 가져옵니다. |
| SendChatMessage | 스레드에 채팅 메시지를 보냅니다. |
| UpdateChatMessage | 채팅 메시지를 업데이트합니다. |
| DeleteChatMessage | 채팅 메시지를 삭제합니다. |
| GetChatThread | 채팅 스레드를 가져옵니다. |
| ListChatThreads | 사용자의 채팅 스레드 목록을 가져옵니다. |
| UpdateChatThread | 채팅 스레드의 속성을 업데이트합니다. |
| CreateChatThread | 채팅 스레드를 만듭니다. |
| DeleteChatThread | 스레드를 삭제합니다. |
| GetReadReceipts | 스레드의 읽음 확인을 가져옵니다. |
| SendReadReceipt | 사용자를 대신하여 읽음 확인 이벤트를 스레드로 보냅니다. |
| SendTypingIndicator | 사용자를 대신하여 입력 이벤트를 스레드에 게시합니다. |
| ListChatThreadParticipants | 스레드의 멤버를 가져옵니다. |
| AddChatThreadParticipants | 스레드에 스레드 멤버를 추가합니다. 멤버가 이미 있는 경우 변경되지 않습니다. |
| RemoveChatThreadParticipant | 스레드에서 멤버를 제거합니다. |
인식되지 않는 작업에 대한 요청이 발생하면 "잘못된 경로" 값 응답을 받게 됩니다.
작업 라우터 API 요청
작업 라우터 API 요청 메트릭에는 다음과 같은 작업을 사용할 수 있습니다.
| 작업/경로 | 설명 |
|---|---|
| UpsertClassificationPolicy | 분류 정책을 만들거나 업데이트합니다. |
| GetClassificationPolicy | ID를 기준으로 기존 분류 정책을 검색합니다. |
| ListClassificationPolicies | 기존 분류 정책을 검색합니다. |
| DeleteDistributionPolicy | ID를 기준으로 분류 정책을 삭제합니다. |
| UpsertDistributionPolicy | 배포 정책을 만들거나 업데이트합니다. |
| GetDistributionPolicy | ID를 기준으로 기존 배포 정책을 검색합니다. |
| ListDistributionPolicies | 기존 배포 정책을 검색합니다. |
| DeleteDistributionPolicy | ID를 기준으로 배포 정책을 삭제합니다. |
| UpsertExceptionPolicy | 예외 정책을 만들거나 업데이트합니다. |
| GetExceptionPolicy | ID를 기준으로 기존 예외 정책을 검색합니다. |
| ListExceptionPolicies | 기존 예외 정책을 검색합니다. |
| DeleteExceptionPolicy | ID를 기준으로 예외 정책을 삭제합니다. |
| UpsertQueue | 큐를 만들거나 업데이트합니다. |
| GetQueue | ID를 기준으로 기존 큐를 검색합니다. |
| GetQueues | 기존 큐를 검색합니다. |
| DeleteQueue | ID를 기준으로 큐를 삭제합니다. |
| GetQueueStatistics | 큐의 통계를 검색합니다. |
| UpsertJob | 작업을 만들거나 업데이트합니다. |
| GetJob | ID를 기준으로 기존 작업을 검색합니다. |
| GetJobs | 기존 작업을 검색합니다. |
| DeleteJob | ID를 기준으로 큐 정책을 삭제합니다. |
| ReclassifyJob | 작업을 재분류합니다. |
| CancelJob | 자유 형식 취소 이유를 제공하는 동시에 ID를 기준으로 기존 작업을 취소하라는 요청을 제출합니다. |
| CompleteJob | 할당된 작업을 완료합니다. |
| CloseJob | 완료된 작업을 닫습니다. |
| AcceptJobOffer | 작업 제안을 수락하고 다른 에이전트가 이미 해당 작업을 수락한 경우 409/충돌을 반환합니다. |
| DeclineJobOffer | 작업 제안을 거절합니다. |
| UpsertWorker | 작업자를 만들거나 업데이트합니다. |
| GetWorker | ID를 기준으로 기존 작업자를 검색합니다. |
| GetWorkers | 기존 작업자를 검색합니다. |
| DeleteWorker | 작업자와 해당 작업자의 모든 추적을 삭제합니다. |
Network Traversal API 요청
Network Traversal API 요청 메트릭에서 다음 작업을 사용할 수 있습니다.
| 작업/경로 | 설명 |
|---|---|
| IssueRelayConfiguration | STUN/TURN 서버에 대한 구성을 발급합니다. |
Rooms API 요청
Rooms API 요청 메트릭에는 다음과 같은 작업을 사용할 수 있습니다.
| 작업/경로 | 설명 |
|---|---|
| CreateRoom | Room을 만듭니다. |
| DeleteRoom | Room을 삭제합니다. |
| GetRoom | Room by Room ID를 가져옵니다. |
| PatchRoom | Room by Room ID를 업데이트합니다. |
| ListRooms | Azure Communication Services 리소스의 모든 Room을 나열합니다. |
| AddParticipants | Room에 참가자를 추가합니다. |
| RemoveParticipants | Room에서 참가자를 제거합니다. |
| GetParticipants | Room의 참가자 목록을 가져옵니다. |
| UpdateParticipants | Room의 참가자 목록을 업데이트합니다. |
SMS API 요청
SMS API 요청 메트릭에는 다음과 같은 작업을 사용할 수 있습니다.
| 작업/경로 | 설명 |
|---|---|
| SMSMessageSent | SMS 메시지를 보냅니다. |
| SMSDeliveryReportsReceived | SMS 배달 보고서를 가져옵니다. |
| SMSMessagesReceived | SMS 메시지를 가져옵니다. |
다음 단계
- 데이터 플랫폼 메트릭에 대한 자세한 정보