

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# AWS 최종 사용자 메시징 SMS 모니터링
<a name="monitoring-overview"></a>

모니터링은 AWS End User Messaging SMS 및 기타 AWS 솔루션의 안정성, 가용성 및 성능을 유지하는 데 중요한 부분입니다.는 다음과 같은 모니터링 도구를 AWS 제공하여 AWS End User Messaging SMS를 모니터링하고, 이상이 있을 때 이를 보고하고, 적절한 경우 자동 조치를 취합니다.
+ **Amazon CloudWatch**는 AWS 리소스와 AWS 에서 실행하는 애플리케이션을 실시간으로 모니터링합니다. 지표를 수집 및 추적하고, 사용자 지정 대시보드를 생성할 수 있으며, 지정된 지표가 지정한 임곗값에 도달하면 사용자에게 알리거나 조치를 취하도록 경보를 설정할 수 있습니다. 예를 들어 CloudWatch에서 Amazon EC2 인스턴스의 CPU 사용량 또는 기타 지표를 추적하고 필요할 때 자동으로 새 인스턴스를 시작할 수 있습니다. 자세한 내용은 [Amazon CloudWatch 사용 설명서](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/)를 참조하세요.
+ **Amazon CloudWatch Logs**로 Amazon EC2 인스턴스, CloudTrail, 기타 소스의 로그 파일을 모니터링, 저장 및 액세스할 수 있습니다. CloudWatch는 로그 파일의 정보를 모니터링하고 특정 임곗값에 도달하면 사용자에게 알릴 수 있습니다. 또한 매우 내구성이 뛰어난 스토리지에 로그 데이터를 저장할 수 있습니다. 자세한 내용은 [Amazon CloudWatch Logs 사용자 안내서](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/)를 참조하세요.
+ **AWS CloudTrail**는 AWS 계정에서 또는 계정을 대신하여 수행한 API 호출 및 관련 이벤트를 캡처하고 사용자가 지정한 Amazon S3 버킷에 로그 파일을 전송합니다. 호출한 사용자 및 계정 AWS, 호출이 수행된 소스 IP 주소, 호출이 발생한 시기를 식별할 수 있습니다. 자세한 내용은 [AWS CloudTrail 사용 설명서](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/)를 참조하십시오.
+ **AWS Health 대시보드는** AWS End User Messaging SMS 환경의 상태를 확인하고 모니터링할 수 있습니다. AWS End User Messaging SMS 서비스의 상태를 전체적으로 확인하려면 AWS 서비스 상태 대시보드를 사용합니다. AWS 환경에 더 구체적으로 영향을 미칠 수 있는 이벤트 또는 문제에 대한 기록 데이터를 확인, 모니터링 및 보려면 AWS Personal Health Dashboard를 사용합니다. 이러한 대시보드에 관한 자세한 내용은 [AWS Health 사용 설명서](https://docs.aws.amazon.com/health/latest/ug/)를 참조하세요.
+ **AWS Trusted Advisor **는 AWS 환경을 검사하고 보안 격차를 해결하고, 시스템 가용성과 성능을 개선하고, 비용을 절감할 수 있는 기회에 대한 권장 사항을 제공합니다. 모든 AWS 고객은 핵심 Trusted Advisor 검사 세트에 액세스할 수 있습니다. 비즈니스 또는 엔터프라이즈 지원 플랜을 보유한 고객은 추가 Trusted Advisor 검사에 액세스할 수 있습니다.

  이러한 검사 중 다수는 전체 AWS 계정의 일부로 AWS End User Messaging SMS 리소스의 보안 태세를 평가하는 데 도움이 될 수 있습니다. 예를 들어, 핵심 Trusted Advisor 점검 항목에는 다음이 포함됩니다.
  + 지원되는 각에 대한 AWS 계정의 구성 로깅 AWS 리전 .
  + Amazon Simple Storage Service(Amazon S3) 버킷에 대한 액세스 권한. 여기에는 세그먼트를 빌드하기 위해 AWS End User Messaging SMS로 가져오는 파일이 포함될 수 있습니다.
  +  AWS Identity and Access Management 사용자, 그룹 및 역할을 사용하여 AWS End User Messaging SMS 리소스에 대한 액세스를 제어합니다.
  +  AWS 환경 및 AWS End User Messaging SMS 리소스의 보안을 손상시킬 수 있는 IAM 구성 및 정책 설정입니다.

  자세한 내용은 *지원 사용 설명서*의 [AWS Trusted Advisor](https://docs.aws.amazon.com/awssupport/latest/user/getting-started.html#trusted-advisor)을 참조하세요.

**Topics**
+ [CloudWatch를 사용하여 모니터링](monitoring-cloudwatch.md)
+ [CloudWatch 경보 생성](monitoring-sms-cw.md)
+ [지출 모니터링](monitor-spending.md)
+ [CloudTrail 로그](logging-using-cloudtrail.md)
+ [EventBridge 사용](monitor-event-bridge.md)

# Amazon CloudWatch를 사용하여 AWS 최종 사용자 메시징 SMS 모니터링
<a name="monitoring-cloudwatch"></a>

원시 데이터를 수집하여 읽기 가능하며 실시간에 가까운 지표로 처리하는 CloudWatch를 사용하여 AWS 최종 사용자 메시징 SMS를 모니터링할 수 있습니다. 이러한 통계는 15개월간 보관되므로 기록 정보에 액세스하고 웹 애플리케이션 또는 서비스가 어떻게 실행되고 있는지 전체적으로 더 잘 파악할 수 있습니다. 특정 임곗값을 주시하다가 해당 임곗값이 충족될 때 알림을 전송하거나 조치를 취하도록 경보를 설정할 수도 있습니다. 자세한 내용은 [Amazon CloudWatch 사용 설명서](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/)를 참조하세요.

AWS End User Messaging SMS는 AWS Identity and Access Management (IAM) [서비스 연결 역할을](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html#id_roles_terms-and-concepts) 사용합니다. 서비스 연결 역할은 AWS End User Messaging SMS에 직접 연결된 고유한 유형의 IAM 역할입니다. 서비스 연결 역할은 AWS End User Messaging SMS에서 사전 정의하며 서비스가 사용자를 대신하여 다른 AWS 서비스를 호출하는 데 필요한 모든 권한을 포함합니다. CloudWatch 지표를 수집하려면 [서비스 연결 역할](using-service-linked-roles.md#using-service-linked-roles.title)을 생성해야 합니다.

## AWS 최종 사용자 메시징 SMS에 대한 CloudWatch 지표
<a name="cw-metrics"></a>

다음 섹션에서는 AWS End User Messaging SMS의 지표와 차원을 나열합니다.

**중요**  
CloudWatch 지표를 수집하려면 [서비스 연결 역할](using-service-linked-roles.md#using-service-linked-roles.title)을 생성해야 합니다.

**참고**  
일부 지표의 경우, 서비스의 분산 특성으로 인해 결과가 근사치일 수 있습니다. 대부분의 경우, 그 수는 처리된 메시지의 실제 개수에 근접해야 합니다.

 AWS 최종 사용자 메시징 SMS의 경우 **TextMessageMonthlySpend**, **MediaMessageMonthlySpend** 및 **VoiceMessageMonthlySpend**를 감시하고 임계값보다 크거나 크거나 같을 때 경보를 트리거할 수 있습니다. AWS End User Messaging SMS의 네임스페이스는 입니다`AWS/SMSVoice`.

AWS 또한 End User Messaging SMS는 , `RCS.MessagesSent` `RCS.MessagesDelivered`및를 포함하여 `AWS/SMSVoice` 네임스페이스에 RCS 관련 지표를 게시합니다`RCS.MessagesFallenBackToSMS`. 이제 기존 지표에는 `PHONE_NUMBER`, `SENDER_ID`, `RCS_AGENT`, 등의 값이 있는 `OriginationIdentityType`차원이 포함됩니다`POOL`. RCS 지표 및 차원의 전체 목록은 섹션을 참조하세요[RCS CloudWatch 지표 및 모니터링](rcs-monitoring.md).

**Topics**
+ [메시지 지출 지표](#cw-metrics-message-spend)
+ [메시지 전달 지표](#cw-metrics-message-delivery)
+ [메시지 변환 지표](#cw-metrics-message-conversion)
+ [보호 지표](#filter-and-monitor-messages-metrics)
+ [측정 기준](#cw-metrics-message-dimensions)

### 메시지 지출 지표
<a name="cw-metrics-message-spend"></a>


**메시지 지출 지표**  

| 지표 | 설명 | 단위 |  의미 있는 통계  | 
| --- | --- | --- | --- | 
|  TextMessageMonthlySpend |  이번 달 SMS 메시지를 보내는 데 쓸 수 있는 최대 금액(단위: 미국 달러)입니다.  | 미국 달러 | 최대 | 
| VoiceMessageMonthlySpend |  이번 달 음성 메시지를 보내는 데 쓸 수 있는 최대 금액(단위: 미국 달러)입니다.  | 미국 달러 | 최대 | 
| MediaMessageMonthlySpend |  이번 달 MMS 메시지를 보내는 데 쓸 수 있는 최대 금액(단위: 미국 달러)입니다.  | 미국 달러 | 최대 | 

### 메시지 전달 지표
<a name="cw-metrics-message-delivery"></a>

`AWS/SMSVoice` 네임스페이스에는 다음과 같은 메시지 전달 지표가 포함되어 있습니다.


**메시지 전달 지표**  

| 지표 | 설명 | 단위 | 의미 있는 통계 | 
| --- | --- | --- | --- | 
| NumberOfTextMessagePartsSent | 전송된 문자 메시지 파트 수입니다. 보호 및 메시지 지출 한도와 같은 서비스 한도에 의해 차단된 메시지는 제외합니다. | 개수 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/sms-voice/latest/userguide/monitoring-cloudwatch.html)  | 
|  **NumberOfMediaMessagePartsSent**  | 전송된 미디어 메시지 파트 수입니다. 보호 및 메시지 지출 한도와 같은 서비스 한도에 의해 차단된 메시지는 제외합니다. | 개수 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/sms-voice/latest/userguide/monitoring-cloudwatch.html)  | 
| NumberOfTextMessagePartsDelivered | 수신자에게 전달된 문자 메시지 파트의 수입니다. | 개수 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/sms-voice/latest/userguide/monitoring-cloudwatch.html)  | 
| NumberOfMediaMessagePartsDelivered | 수신자에게 전달된 미디어 메시지 파트의 수입니다. | 개수 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/sms-voice/latest/userguide/monitoring-cloudwatch.html)  | 

### 메시지 피드백 지표
<a name="cw-metrics-message-conversion"></a>

`AWS/SMSVoice` 네임스페이스에는 다음과 같은 메시지 피드백 지표가 포함되어 있습니다.


**메시지 피드백 지표**  

| 지표 | 설명 | 단위 | 의미 있는 통계 | 
| --- | --- | --- | --- | 
| NumberOfTextMessagesExpectingFeedback | 피드백이 추적되는 총 텍스트 메시지 수입니다. MessageFeedbackEnabled가 활성화된 각 `SendTextMessage` 요청에 대해 **NumberOfTextMessagesExpectingFeedback**의 값은 1입니다. | 개수 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/sms-voice/latest/userguide/monitoring-cloudwatch.html)  | 
| NumberOfMediaMessagesExpectingFeedback | 피드백이 추적되는 총 미디어 메시지 수입니다.MessageFeedbackEnabled가 활성화된 각 `SendMediaMessage` 요청에 대해 **NumberOfMediaMessagesExpectingFeedback**의 값은 1입니다. | 개수 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/sms-voice/latest/userguide/monitoring-cloudwatch.html)  | 
| NumberOfTextMessagesWithFeedback | 피드백이 추적되고 피드백 응답이 수신된 총 문자 메시지 수입니다.**NumberOfTextMessagesWithFeedback**은 피드백을 수신하는 각 메시지에 대해 1의 값을 갖습니다. 피드백이 포함된 메시지의 백분율은 `100 * SUM(NumberOfTextMessagesWithFeedback) / SUM(NumberOfTextMessagesExpectingFeedback)`에서 확인할 수 있습니다. | 개수 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/sms-voice/latest/userguide/monitoring-cloudwatch.html)  | 
| NumberOfMediaMessagesWithFeedback | 피드백이 추적되고 피드백 응답이 수신된 총 미디어 메시지 수입니다.**NumberOfMediaMessagesWithFeedback**은 피드백을 수신하는 각 메시지에 대해 1의 값을 갖습니다. 피드백이 포함된 메시지의 백분율은 `100 * SUM(NumberOfMediaMessagesWithFeedback) / SUM(NumberOfMediaMessagesExpectingFeedback)`에서 확인할 수 있습니다. | 개수 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/sms-voice/latest/userguide/monitoring-cloudwatch.html)  | 

### AWS End User Messaging SMS에서 지표 보호
<a name="filter-and-monitor-messages-metrics"></a>

`AWS/SMSVoice` 네임스페이스에는 다음과 같은 보호 지표가 포함됩니다.


****  

| 지표 이름 | 설명 | 단위 | 의미 있는 통계 | 
| --- | --- | --- | --- | 
| TextMessagesBlockedByProtect |  국가 모드 차단 규칙으로 인해 차단된 문자 메시지 수입니다. **TextMessagesBlockedByProtect**는 메시지가 보호에 의해 차단된 경우 1, 메시지가 차단되지 않은 경우 0의 값을 갖습니다. 보호에 의해 차단된 SMS 메시지의 백분율은 `100 * AVG(TextMessagesBlockedByProtect)`에서 확인할 수 있습니다.  | 개수 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/sms-voice/latest/userguide/monitoring-cloudwatch.html)  | 
| MediaMessagesBlockedByProtect |  국가 모드 차단 규칙으로 인해 차단된 미디어 메시지 수입니다. **MediaMessagesBlockedByProtect**는 메시지가 보호에 의해 차단된 경우 1, 메시지가 차단되지 않은 경우 0의 값을 갖습니다. 보호에 의해 차단된 MMS 메시지의 백분율은 `100 * AVG(MediaMessagesBlockedByProtect)`에서 확인할 수 있습니다.  | 개수 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/sms-voice/latest/userguide/monitoring-cloudwatch.html)  | 

### 측정 기준
<a name="cw-metrics-message-dimensions"></a>

다음 차원을 사용하여 이전 표에 열거된 지표를 구체화할 수 있습니다. 이러한 차원을 사용하면 SMS 및 음성 메시지의 특정 속성을 기반으로 지표를 필터링하고 그룹화할 수 있습니다.


****  

| 차원 | 설명 | 
| --- | --- | 
| 없음 | 필터링 안 함 | 
| IsoCountryCode |  이 차원은 ISO 국가 코드로 요청한 데이터를 필터링합니다.  | 
| MessageFeedbackStatus | 이 차원은 RECEIVED 또는 FAILED의 메시지 피드백 상태를 기준으로 요청한 데이터를 필터링합니다. | 
| ProtectConfigurationId | 이 차원은 구성 보호를 통해 요청한 데이터를 필터링합니다. | 
| [IsoCountryCode, MessageFeedbackStatus] | 이 차원은 ISO 국가 코드 및 메시지 피드백 상태를 기준으로 요청한 데이터를 필터링합니다. | 
| [ProtectConfigurationId, IsoCountryCode] | 이 차원은 보호 구성 및 ISO 국가 코드를 통해 요청한 데이터를 필터링합니다. | 
| OriginationIdentityType | 이 차원은 발신 자격 증명 유형별로 요청하는 데이터를 필터링합니다. 값에는 PHONE\$1NUMBER, SENDER\$1IDRCS\$1AGENT, 및가 포함됩니다POOL. 자세한 내용은 [RCS CloudWatch 지표 및 모니터링](rcs-monitoring.md) 단원을 참조하십시오. | 

# AWS 최종 사용자 메시징 SMS 지표에 대한 CloudWatch 경보 생성
<a name="monitoring-sms-cw"></a>

CloudWatch를 사용하면 AWS End User Messaging SMS 지표에 대한 지표 임계값을 기반으로 트리거되는 경보를 생성할 수 있습니다. 예를 들어, `NumberOfTextMessagePartsSent` 지표에 대한 경보를 생성할 수 있습니다. 1시간에 1,000개 이상의 문자 메시지 파트가 전송되는 경우, 이메일 알림을 보낼 수 있습니다. 자세한 내용은 *Amazon CloudWatch 사용 설명서*의 [Amazon CloudWatch 경보 사용](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html)을 참조하세요.

**한 시간에 1,000개의 문자 메시지 파트가 전송되었을 때 이메일을 보내는 경보를 생성하려면**

1. [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)에서 CloudWatch 콘솔을 엽니다.

1. 탐색 창에서 **Alarms**를 선택한 다음, **경보 생성**을 선택합니다.

1. **지표 선택** 섹션에서 **지표 찾아보기**를 선택한 다음, `AWS/SMSVoice` 네임스페이스를 선택합니다.

1. `AWS/SMSVoice` 지표에서 경보를 설정할 지표를 선택한 후 **다음**을 선택합니다. 사용 가능한 지표 목록은 [CloudWatch를 사용하여 모니터링](monitoring-cloudwatch.md) 섹션을 참조하세요.

1. 전송된 문자 메시지 파트 수에 대한 경보를 설정하려면:

   1. **메시지 전달 지표**를 선택

   1. **NumberOfTextMessagePartsSent** 지표를 선택

1. **지표 및 조건 지정** 섹션에서는 다음을 수행합니다.

   1. 통계를 합계(Sum)로 설정

   1. 기간을 1시간으로 설정

   1. **조건**에서 **정적**을 선택

   1. "**NumberOfTextMessagePartsSent가 ...일 때마다**"를 "**보다 큼(초과)**"으로 설정합니다.

   1. 1000의 임곗값을 입력합니다.

1. **작업 구성** 섹션에서는 다음을 수행합니다.

   1. **경보 상태 트리거**에서 **경보 중**을 선택합니다.

   1. 알림을 위해 기존 Amazon SNS 주제를 선택하거나 새 주제를 생성합니다.

   1. 새 주제를 생성하는 경우, 이메일 주소를 쉼표로 구분하여 입력합니다.
**참고**  
새 Amazon SNS 주제를 생성하는 경우, 알림을 받기 전에 이메일 주소를 검증해야 합니다.

1. **이름 및 설명 추가** 섹션에서 다음을 수행합니다.

   1. 경보의 이름을 입력합니다(예: **대량 문자 메시지**).

   1. 설명을 추가할 수도 있습니다.

1. **미리 보기 및 생성** 섹션에서 경보 설정을 미리 본 다음 **경보 생성**을 클릭합니다.

이제 경보가 생성되며 지정한 조건에 따라 트리거됩니다.

다음과 같은 다른 AWS End User Messaging SMS 지표에 대해 유사한 경보를 생성할 수 있습니다.
+ `NumberOfMediaMessagePartsSent`
+ `NumberOfTextMessagePartsDelivered`
+ `TextMessagesBlockedByProtect`

특정 사용 사례에 따라 지표, 임곗값 및 기타 설정을 조정합니다.

# AWS End User Messaging SMS를 사용하여 SMS, MMS 및 음성 지출 활동 모니터링
<a name="monitor-spending"></a>

이 주제에서는 Amazon CloudWatch에서 SMS, MMS 및 음성 지출 지표를 확인하는 방법에 관한 정보를 제공합니다. 또한 월별 SMS, MMS 또는 음성 지출이 일정 금액을 초과하면 알림을 전송하도록 CloudWatch 경보를 설정하는 방법도 설명합니다.

사용한 금액을 포함하여 AWS End User Messaging SMS 사용에 대한 월별 요금만 보려면 AWS 결제 및 비용 관리 콘솔을 사용해야 합니다. 결제 및 비용 관리(Billing and Cost Management) 콘솔은 이번 달 예상 요금과 이전 달의 최종 요금을 제공합니다. 자세한 내용은 *AWS Billing 사용 설명서*의 [월별 요금 보기](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/getting-viewing-bill.html)를 참조하세요.

**중요**  
CloudWatch 지표를 수집하려면 [서비스 연결 역할](using-service-linked-roles.md#using-service-linked-roles.title)을 생성해야 합니다.

## CloudWatch를 사용하여 월별 SMS, MMS 및 음성 지출 보기
<a name="monitor-spending-metrics"></a>

CloudWatch 콘솔의 지표 섹션을 사용하면 이번 달에 SMS, MMS 및 음성 메시지를 보내는 데 사용한 금액을 빠르게 확인할 수 있습니다. CloudWatch는 지표 데이터를 15개월 동안 보관하므로 실시간 데이터를 보고 과거 추세를 분석할 수 있습니다.

CloudWatch 지표 보기에 관한 자세한 내용은 *Amazon CloudWatch 사용 설명서*의 [Amazon CloudWatch 지표 사용](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/working_with_metrics.html)을 참조하세요.

**CloudWatch에서 SMS, MMS 및 음성 지출 지표를 보려면**

1. [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)에서 CloudWatch 콘솔을 엽니다.

1. 탐색 창에서 **지표**를 선택합니다.

1. **모든 지표** 탭에서 **SMSVoice**를 선택합니다.

1. **계정 지표**를 선택합니다.

1. **TextMessageMonthlySpend**, **MediaMessageMonthlySpend** 및 **VoiceMessageMonthlySpend** 옵션 중에서 선택합니다. 선택한 항목에 따라 그래프가 업데이트되어 AWS End User Messaging SMS를 사용하여 이번 달에 지출한 금액이 표시됩니다.
**참고**  
 AWS 최종 사용자 메시징 SMS를 사용하여 메시지를 하나 이상 전송할 때까지 **TextMessageMonthlySpend**, **MediaMessageMonthlySpend** 및 **VoiceMessageMonthlySpend** 지표가 표시되지 않습니다.

## CloudWatch를 사용하여 SMS, MMS 또는 음성 지출 경보 생성
<a name="monitor-spending-alarms"></a>

월별 SMS, MMS 및 음성 지출 지표를 확인하는 것 외에도 SMS, MMS 또는 음성 지출이 일정 금액을 초과하면 알림을 전송하는 CloudWatch 경보를 생성할 수 있습니다. CloudWatch가 이러한 알림을 Amazon SNS 주제로 보내 알림을 전달하도록 설정할 수 있습니다.

CloudWatch에서 경보 생성에 관한 자세한 내용은 *Amazon CloudWatch 사용 설명서*의 [Amazon CloudWatch 경보 사용](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html)을 참조하세요.

**CloudWatch에서 SMS 또는 음성 지출 경보를 생성하려면**

1. 아직 생성하지 않았다면 Amazon SNS 주제를 생성하고 엔드포인트를 이 주제에 구독 설정합니다. 해당 주제에 대해 구독 설정하는 엔드포인트는 지출 알림을 받고자 하는 위치에 있어야 합니다. 예를 들어 지출 알림을 이메일로 수신하고자 하는 경우, 이메일 주소를 Amazon SNS 주제에 구독 설정합니다. 문자 메시지로 지출 알림을 수신하고자 하는 경우 SMS 엔드포인트를 주제에 구독 설정합니다.

   주제 생성과 구독에 대한 자세한 내용은 *Amazon Simple Notification Service 개발자 안내서*의 [Amazon SNS 시작하기](https://docs.aws.amazon.com/sns/latest/dg/sns-getting-started.html)를 참조하세요.

1. [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)에서 CloudWatch 콘솔을 엽니다.

1. 
**중요**  
결제 경보를 생성하기 전에를 미국 동부(버지니아 북부) AWS 리전 로 설정해야 합니다. 결제 지표 데이터는이에 저장 AWS 리전 되며 전 세계 요금을 나타냅니다. 또한 계정 또는 관리/지급인 계정(통합 결제를 사용하는 경우)에 대한 결제 알림을 활성화해야 합니다. 자세한 내용은 [결제 알림 활성화](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/monitor_estimated_charges_with_cloudwatch.html#turning_on_billing_metrics)를 참조하세요.

   탐색 창의 **경보**에서 **결제**를 선택합니다.

1. **결제 경보** 옆의 **경보 생성**을 선택합니다.

1. **지표 선택**을 선택하세요.

1. **모든 지표** 탭에서 **SMSVoice**를 선택한 다음, **계정 지표**를 선택합니다.

1. **TextMessageMonthlySpend**, **MediaMessageMonthlySpend** 또는 **VoiceMessageMonthlySpend**를 선택합니다.
**참고**  
 AWS 최종 사용자 메시징 SMS를 통해 메시지를 하나 이상 전송할 때까지 **TextMessageMonthlySpend**, **MediaMessageMonthlySpend** 및 **VoiceMessageMonthlySpend** 지표가 표시되지 않습니다.

1. **그래프로 표시된 지표** 탭을 선택하고 다음 단계를 완료합니다.
   + **통계**에서 모니터링하려는 통계 또는 사전 정의된 백분위수를 선택하거나, 사용자 지정 백분위수(예: **p99** 또는 **p45**)를 지정합니다.
   + **기간**에서 경보에 대한 평가 기간을 선택합니다. 경보를 평가할 때 각 기간이 하나의 데이터 포인트로 집계됩니다.

1. **지표 선택**을 선택하세요. 경보와 관련된 지표 및 통계에 대한 그래프와 기타 정보가 표시된 **지표 및 조건 지정** 페이지가 나타납니다.

1. **조건**에서 다음 단계를 완료합니다.
   + **임곗값 유형**에서 **정적**을 선택합니다.
   + **(**TextMessageMonthlySpend**, **MediaMessageMonthlySpend** 또는 **VoiceMessageMonthlySpend**)가 **일 때마다 경보를 트리거할 조건으로 지표가 임곗값보다 큰지, 크거나 같은지 아니면 같은지 여부를 지정합니다. 그런 다음, **than(기준)**에 임곗값을 입력합니다. 임곗값은 경보를 트리거하려는 금액(단위: 미국 달러)입니다.

1. **추가 구성**에서 다음 단계를 완료합니다.
   + **경고할 데이터 포인트**에서 경보를 트리거하기 위해 지출액이 임곗값을 초과해야 하는 평가 기간(데이터 포인트)을 입력합니다.
   + **데이터 처리 누락**에서 **누락 데이터를 무시로 처리(경보 상태 유지)**를 선택합니다.

1. **다음**을 선택합니다.

1. **알림**에서 다음 단계를 완료합니다.
   + **이 경보 상태가 다음과 같은 경우 항상**에 **경보**를 선택합니다.
   + **SNS 주제 선택**에서 경보 알림을 전송할 Amazon SNS 주제를 선택합니다.

1. **다음**을 선택합니다.

1. 경보의 이름과 설명(선택 사항)을 입력하고 **다음**을 선택합니다.

1. **미리 보기 및 생성**에서 경보가 원하는 대로 설정되었는지 검토하여 확인한 다음, **경보 생성**을 선택합니다.

# 를 사용하여 AWS End User Messaging SMS API 호출 로깅 AWS CloudTrail
<a name="logging-using-cloudtrail"></a>

AWS End User Messaging SMS는 사용자[AWS CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-user-guide.html), 역할 또는가 수행한 작업에 대한 레코드를 제공하는 서비스인와 통합됩니다 AWS 서비스. CloudTrail은 AWS End User Messaging SMS에 대한 모든 API 호출을 이벤트로 캡처합니다. 캡처되는 호출에는 AWS End User Messaging SMS 콘솔의 호출과 AWS End User Messaging SMS API 작업에 대한 코드 호출이 포함됩니다. CloudTrail에서 수집한 정보를 사용하여 AWS 최종 사용자 메시징 SMS에 수행된 요청, 요청이 수행된 IP 주소, 요청이 수행된 시간 및 추가 세부 정보를 확인할 수 있습니다.

모든 이벤트 또는 로그 항목에는 요청을 생성했던 사용자에 관한 정보가 포함됩니다. 자격 증명을 이용하면 다음을 쉽게 판단할 수 있습니다.
+ 요청을 루트 사용자로 했는지 사용자 보안 인증으로 했는지 여부.
+ IAM Identity Center 사용자를 대신하여 요청이 이루어졌는지 여부입니다.
+ 역할 또는 페더레이션 사용자의 임시 자격 증명을 사용하여 요청이 생성되었는지 여부.
+ 다른 AWS 서비스에서 요청했는지 여부

CloudTrail은 계정을 생성할 AWS 계정 때에서 활성화되며 CloudTrail **이벤트 기록에** 자동으로 액세스할 수 있습니다. CloudTrail **이벤트 기록**은 지난 90일 간 AWS 리전의 관리 이벤트에 대해 보기, 검색 및 다운로드가 가능하고, 수정이 불가능한 레코드를 제공합니다. 자세한 설명은 *AWS CloudTrail 사용 설명서*의 [CloudTrail 이벤트 기록 작업](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html)을 참조하세요. **이벤트 기록** 보기는 CloudTrail 요금이 부과되지 않습니다.

 AWS 계정 지난 90일 동안의 이벤트를 지속적으로 기록하려면 추적 또는 [CloudTrail Lake](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake.html) 이벤트 데이터 스토어를 생성합니다.

**CloudTrail 추적**  
CloudTrail은 *추적*을 사용하여 Amazon S3 버킷으로 로그 파일을 전송할 수 있습니다. 를 사용하여 생성된 모든 추적 AWS Management Console 은 다중 리전입니다. AWS CLI를 사용하여 단일 리전 또는 다중 리전 추적을 생성할 수 있습니다. 계정 AWS 리전 의 모든에서 활동을 캡처하므로 다중 리전 추적을 생성하는 것이 좋습니다. 단일 리전 추적을 생성하는 경우 추적의 AWS 리전에 로깅된 이벤트만 볼 수 있습니다. 추적에 대한 자세한 내용은 *AWS CloudTrail 사용 설명서*의 [AWS 계정에 대한 추적 생성](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html) 및 [조직에 대한 추적 생성](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/creating-trail-organization.html)을 참조하세요.  
CloudTrail에서 추적을 생성하여 진행 중인 관리 이벤트의 사본 하나를 Amazon S3 버킷으로 무료로 전송할 수는 있지만, Amazon S3 스토리지 요금이 부과됩니다. CloudTrail 요금에 관한 자세한 내용은 [AWS CloudTrail 요금](https://aws.amazon.com/cloudtrail/pricing/)을 참조하세요. Amazon S3 요금에 관한 자세한 내용은 [Amazon S3 요금](https://aws.amazon.com/s3/pricing/)을 참조하세요.

**CloudTrail Lake 이벤트 데이터 스토어**  
*CloudTrail Lake*를 사용하면 이벤트에 대해 SQL 기반 쿼리를 실행할 수 있습니다. CloudTrail Lake는 행 기반 JSON 형식의 기존 이벤트를 [ Apache ORC](https://orc.apache.org/) 형식으로 변환합니다. ORC는 빠른 데이터 검색에 최적화된 열 기반 스토리지 형식입니다. 이벤트는 *이벤트 데이터 스토어*로 집계되며, 이벤트 데이터 스토어는 [고급 이벤트 선택기](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake-concepts.html#adv-event-selectors)를 적용하여 선택한 기준을 기반으로 하는 변경 불가능한 이벤트 컬렉션입니다. 이벤트 데이터 스토어에 적용하는 선택기는 어떤 이벤트가 지속되고 쿼리에 사용 가능한지를 제어합니다. CloudTrail Lake에 대한 자세한 내용은 *AWS CloudTrail 사용 설명서*의 [AWS CloudTrail Lake 작업을](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake.html) 참조하세요.  
CloudTrail Lake 이벤트 데이터 스토어 및 쿼리에는 비용이 발생합니다. 이벤트 데이터 스토어를 생성할 때 이벤트 데이터 스토어에 사용할 [요금 옵션](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake-manage-costs.html#cloudtrail-lake-manage-costs-pricing-option)을 선택합니다. 요금 옵션에 따라 이벤트 모으기 및 저장 비용과 이벤트 데이터 스토어의 기본 및 최대 보존 기간이 결정됩니다. CloudTrail 요금에 관한 자세한 내용은 [AWS CloudTrail 요금](https://aws.amazon.com/cloudtrail/pricing/)을 참조하세요.

## AWS CloudTrail의 End User Messaging SMS 데이터 이벤트
<a name="cloudtrail-data-events"></a>

[데이터 이벤트](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-data-events-with-cloudtrail.html#logging-data-events)는 리소스 기반 또는 리소스에서 수행된 리소스 작업에 대한 정보를 제공합니다(예: Amazon S3 객체 읽기 또는 쓰기). 이를 데이터 플레인 작업이라고도 합니다. 데이터 이벤트는 흔히 대량 활동입니다. 기본적으로 CloudTrail은 데이터 이벤트를 로깅하지 않습니다. CloudTrail **이벤트 기록**은 데이터 이벤트를 기록하지 않습니다.

데이터 이벤트에는 추가 요금이 적용됩니다. CloudTrail 요금에 관한 자세한 내용은 [AWS CloudTrail 요금](https://aws.amazon.com/cloudtrail/pricing/)을 참조하세요.

CloudTrail 콘솔 AWS CLI또는 CloudTrail API 작업을 사용하여 AWS End User Messaging SMS 리소스 유형에 대한 데이터 이벤트를 로깅할 수 있습니다. 데이터 이벤트를 로깅하는 방법에 관한 자세한 내용은 *AWS CloudTrail 사용 설명서*의 [AWS Management Console을 사용한 데이터 이벤트 로깅](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-data-events-with-cloudtrail.html#logging-data-events-console) 및 [AWS Command Line Interface를 사용한 이벤트 데이터 로깅](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-data-events-with-cloudtrail.html#creating-data-event-selectors-with-the-AWS-CLI)을 참조하세요.

다음 표에는 데이터 이벤트를 로깅할 수 있는 AWS End User Messaging SMS 리소스 유형이 나열되어 있습니다. **데이터 이벤트 유형(콘솔)** 열에는 CloudTrail 콘솔의 **데이터 이벤트 유형** 목록에서 선택할 값이 표시됩니다. **resources.type 값** 열에는 AWS CLI 또는 CloudTrail APIs를 사용하여 고급 이벤트 선택기를 구성할 때 지정하는 `resources.type` 값이 표시됩니다. **CloudTrail에 로깅되는 데이터 API** 열에는 리소스 유형에 대해 CloudTrail에 로깅된 API 직접 호출이 표시됩니다.


| 데이터 이벤트 유형(콘솔) | resources.type 값 | CloudTrail에 로깅되는 데이터 API | 
| --- | --- | --- | 
| SMS 음성 발신 자격 증명 |  AWS::SMSVoice::OriginationIdentity  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/sms-voice/latest/userguide/logging-using-cloudtrail.html)  | 
| SMS 음성 알림 구성 |  AWS::SMSVoice::NotifyConfiguration  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/sms-voice/latest/userguide/logging-using-cloudtrail.html)  | 

`eventName`, `readOnly` 및 `resources.ARN` 필드를 필터링하여 중요한 이벤트만 로깅하도록 고급 이벤트 선택기를 구성할 수 있습니다. 이러한 필드에 관한 자세한 내용은 *AWS CloudTrail API 참조*의 [https://docs.aws.amazon.com/awscloudtrail/latest/APIReference/API_AdvancedFieldSelector.html](https://docs.aws.amazon.com/awscloudtrail/latest/APIReference/API_AdvancedFieldSelector.html) 섹션을 참조하세요.

## AWS CloudTrail의 End User Messaging SMS 관리 이벤트
<a name="cloudtrail-management-events"></a>

[관리 이벤트](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-management-events-with-cloudtrail.html#logging-management-events)는의 리소스에서 수행되는 관리 작업에 대한 정보를 제공합니다 AWS 계정. 이를 컨트롤 플레인 작업이라고도 합니다. 기본적으로 CloudTrail은 관리 이벤트를 로깅합니다.

AWS End User Messaging SMS는 모든 AWS End User Messaging SMS 컨트롤 플레인 작업을 관리 이벤트로 로깅합니다. AWS End User Messaging SMS가 CloudTrail에 로그하는 AWS End User Messaging SMS 컨트롤 플레인 작업 목록은 [AWS End User Messaging SMS and Voice V2 API 참조](https://docs.aws.amazon.com//pinpoint/latest/apireference_smsvoicev2/Welcome.html)를 참조하세요.

## AWS End User Messaging SMS 이벤트 예제
<a name="cloudtrail-event-examples"></a>

이벤트는 모든 소스로부터의 단일 요청을 나타내며 요청된 API 작업, 작업 날짜와 시간, 요청 파라미터 등에 관한 정보가 들어 있습니다. CloudTrail 로그 파일은 퍼블릭 API 직접 호출의 주문 스택 추적이 아니므로 이벤트가 특정 순서로 표시되지 않습니다.

다음은 `CreateConfigurationSet` 및 `CreateEventDestination` 작업을 보여 주는 CloudTrail 로그 항목을 나타낸 예제입니다.

```
{
  "Records": [
    {
      "eventVersion":"1.05",
      "userIdentity":{
        "type":"IAMUser",
        "principalId":"AIDAIHTHRCDA62EXAMPLE",
        "arn":"arn:aws:iam::111122223333:user/SampleUser",
        "accountId":"111122223333",
        "accessKeyId":"AKIAIOSFODNN7EXAMPLE",
        "userName":"SampleUser"
      },
      "eventTime":"2018-11-06T21:45:55Z",
      "eventSource":"sms-voice.amazonaws.com",
      "eventName":"CreateConfigurationSet",
      "awsRegion":"us-east-1",
      "sourceIPAddress":"192.0.0.1",
      "userAgent":"PostmanRuntime/7.3.0",
      "requestParameters":{
        "ConfigurationSetName":"MyConfigurationSet"
      },
      "responseElements":null,
      "requestID":"56dcc091-e20d-11e8-87d2-9994aexample",
      "eventID":"725843fc-8846-41f4-871a-7c52dexample",
      "readOnly":false,
      "eventType":"AwsApiCall",
      "recipientAccountId":"123456789012"
    },
    {
      "eventVersion":"1.05",
      "userIdentity":{
        "type":"IAMUser",
        "principalId":"AIDAIHTHRCDA62EXAMPLE",
        "arn":"arn:aws:iam::111122223333:user/SampleUser",
        "accountId":"111122223333",
        "accessKeyId":"AKIAIOSFODNN7EXAMPLE",
        "userName":"SampleUser"
      },
      "eventTime":"2018-11-06T21:47:08Z",
      "eventSource":"sms-voice.amazonaws.com",
      "eventName":"CreateEventDestination",
      "awsRegion":"us-east-1",
      "sourceIPAddress":"192.0.0.1",
      "userAgent":"PostmanRuntime/7.3.0",
      "requestParameters":{
        "EventDestinationName":"CloudWatchEventDestination",
        "ConfigurationSetName":"MyConfigurationSet",
        "EventDestination":{
          "Enabled":true,
          "MatchingEventTypes":[
            "INITIATED_CALL",
            "INITIATED_CALL"
          ],
          "CloudWatchLogsDestination":{
            "IamRoleArn":"arn:aws:iam::111122223333:role/iamrole-01",
            "LogGroupArn":"arn:aws:logs:us-east-1:111122223333:log-group:clientloggroup-01"
          }
        }
      },
      "responseElements":null,
      "requestID":"81de1e73-e20d-11e8-b158-d5536example",
      "eventID":"fcafc21f-7c93-4a3f-9e72-fca2dexample",
      "readOnly":false,
      "eventType":"AwsApiCall",
      "recipientAccountId":"111122223333"
    }
  ]
}
```

다음은 `SendTextMessage` 작업을 설명하는 CloudTrail 로그 항목을 보여 주는 예시입니다.

```
{
        "eventVersion": "1.10",
        "userIdentity": {
            "type": "AssumedRole",
            "principalId": "QWERTYUIOPASDFGHJKLZXCVBNM:EXAMPLE",
            "arn": "arn:aws:sts::111122223333:assumed-role/ASDFGHJKL/QWERTYUIOP",
            "accountId": "111122223333",
            "accessKeyId": "AKIAIOSFODNN7EXAMPLE",
            "sessionContext": {
                "sessionIssuer": {
                    "type": "Role",
                    "principalId": "ASDFGHJKLQWERTYUIOP",
                    "arn": "arn:aws:iam::123456789123:role/QWERTYUIOP",
                    "accountId": "111122223333",
                    "userName": "QWERTYUIOP"
                },
                "attributes": {
                    "creationDate": "2024-10-02T22:39:11Z",
                    "mfaAuthenticated": "false"
                }
            }
        },
        "eventTime": "2024-10-02T23:52:08Z",
        "eventSource": "sms-voice.amazonaws.com",
        "eventName": "SendTextMessage",
        "awsRegion": "us-east-1",
        "sourceIPAddress": "192.0.2.1",
        "userAgent": "aws-cli/1.18.147 Python/2.7.18 Linux/5.10.218-186.862.amzn2int.x86_64 botocore/1.18.6",
        "requestParameters": {
            "destinationPhoneNumber": "+11235550123",
            "originationIdentity": "phone-aa012345678901234567890123456789",
            "messageBody": "HIDDEN_DUE_TO_SECURITY_REASONS",
        },
        "responseElements": {
            "messageId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"
        },
        "requestID": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
        "eventID": "a1b2c3d4-5678-90ab-cdef-EXAMPLE33333",
        "readOnly": false,
        "resources": [{
            "accountId": "111122223333",
            "type": "AWS::SMSVoice::OriginationIdentity",
            "ARN": "arn:aws:sms-voice:us-east-1:111122223333:phone-number/phone-aa012345678901234567890123456789"
        }],
        "eventType": "AwsApiCall",
        "managementEvent": false,
        "recipientAccountId": "111122223333",
        "eventCategory": "Data",
        "tlsDetails": {
            "clientProvidedHostHeader": "sms-voice.us-east-1.amazonaws.com"
        }
}
```

다음은 `SendVoiceMessage` 작업을 설명하는 CloudTrail 로그 항목을 보여 주는 예시입니다.

```
{
        "eventVersion": "1.10",
        "userIdentity": {
            "type": "AssumedRole",
            "principalId": "QWERTYUIOPASDFGHJKLZXCVBNM:EXAMPLE",
            "arn": "arn:aws:sts::111122223333:assumed-role/ASDFGHJKL/QWERTYUIOP",
            "accountId": "111122223333",
            "accessKeyId": "AKIAIOSFODNN7EXAMPLE",
            "sessionContext": {
                "sessionIssuer": {
                    "type": "Role",
                    "principalId": "ASDFGHJKLQWERTYUIOP",
                    "arn": "arn:aws:iam::123456789123:role/QWERTYUIOP",
                    "accountId": "111122223333",
                    "userName": "QWERTYUIOP"
                },
                "attributes": {
                    "creationDate": "2024-10-02T22:39:11Z",
                    "mfaAuthenticated": "false"
                }
            }
        },
        "eventTime": "2024-10-02T23:52:08Z",
        "eventSource": "sms-voice.amazonaws.com",
        "eventName": "SendVoiceMessage",
        "awsRegion": "us-east-1",
        "sourceIPAddress": "192.0.2.1",
        "userAgent": "aws-cli/1.18.147 Python/2.7.18 Linux/5.10.218-186.862.amzn2int.x86_64 botocore/1.18.6",
        "requestParameters": {
            "destinationPhoneNumber": "+11235550123",
            "originationIdentity": "phone-aa012345678901234567890123456789",
            "messageBody": "HIDDEN_DUE_TO_SECURITY_REASONS",
        },
        "responseElements": {
            "messageId": "a1b2c3d4-5678-90ab-cdef-EXAMPLEaaaaa"
        },
        "requestID": "a1b2c3d4-5678-90ab-cdef-EXAMPLEbbbbb",
        "eventID": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
        "readOnly": false,
        "resources": [{
            "accountId": "111122223333",
            "type": "AWS::SMSVoice::OriginationIdentity",
            "ARN": "arn:aws:sms-voice:us-east-1:111122223333:phone-number/phone-aa012345678901234567890123456789"
        }],
        "eventType": "AwsApiCall",
        "managementEvent": false,
        "recipientAccountId": "111122223333",
        "eventCategory": "Data",
        "tlsDetails": {
            "clientProvidedHostHeader": "sms-voice.us-east-1.amazonaws.com"
        }
}
```

다음은 `SendMediaMessage` 작업을 설명하는 CloudTrail 로그 항목을 보여 주는 예시입니다.

```
{
        "eventVersion": "1.10",
        "userIdentity": {
            "type": "AssumedRole",
            "principalId": "QWERTYUIOPASDFGHJKLZXCVBNM:EXAMPLE",
            "arn": "arn:aws:sts::111122223333:assumed-role/ASDFGHJKL/QWERTYUIOP",
            "accountId": "111122223333",
            "accessKeyId": "AKIAIOSFODNN7EXAMPLE",
            "sessionContext": {
                "sessionIssuer": {
                    "type": "Role",
                    "principalId": "ASDFGHJKLQWERTYUIOP",
                    "arn": "arn:aws:iam::377392627227:role/QWERTYUIOP",
                    "accountId": "111122223333",
                    "userName": "QWERTYUIOP"
                },
                "attributes": {
                    "creationDate": "2024-10-02T22:39:11Z",
                    "mfaAuthenticated": "false"
                }
            }
        },
        "eventTime": "2024-10-02T23:52:08Z",
        "eventSource": "sms-voice.amazonaws.com",
        "eventName": "SendMediaMessage",
        "awsRegion": "us-east-1",
        "sourceIPAddress": "192.0.2.1",
        "userAgent": "aws-cli/1.18.147 Python/2.7.18 Linux/5.10.218-186.862.amzn2int.x86_64 botocore/1.18.6",
        "requestParameters": {
            "destinationPhoneNumber": "+11235550123",
            "originationIdentity": "phone-aa012345678901234567890123456789",
            "messageBody": "HIDDEN_DUE_TO_SECURITY_REASONS",
        },
        "responseElements": {
            "messageId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222"
        },
        "requestID": "a1b2c3d4-5678-90ab-cdef-EXAMPLE33333",
        "eventID": "a1b2c3d4-5678-90ab-cdef-EXAMPLEaaaaa",
        "readOnly": false,
        "resources": [{
            "accountId": "111122223333",
            "type": "AWS::SMSVoice::OriginationIdentity",
            "ARN": "arn:aws:sms-voice:us-east-1:111122223333:phone-number/phone-aa012345678901234567890123456789"
        }],
        "eventType": "AwsApiCall",
        "managementEvent": false,
        "recipientAccountId": "111122223333",
        "eventCategory": "Data",
        "tlsDetails": {
            "clientProvidedHostHeader": "sms-voice.us-east-1.amazonaws.com"
        }
}
```

CloudTrail 레코드 콘텐츠에 관한 자세한 내용은 *AWS CloudTrail 사용 설명서*의 [CloudTrail 레코드 콘텐츠](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-record-contents.html)를 참조하세요.

# EventBridge로 모니터링
<a name="monitor-event-bridge"></a>

AWS End User Messaging SMS는 등록, SMS, MMS 및 음성 이벤트를 위해 EventBridge로 이벤트를 전송합니다. EventBridge를 사용하여 특정 이벤트 유형이 수신될 때 알림과 같은 작업을 수행하는 규칙을 작성할 수 있습니다. 자세한 내용은 Amazon EventBridge 사용 설명서의 다음 주제를 참조하세요.
+ [Amazon EventBridge란 무엇인가요?](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html)
+ [Amazon EventBridge 이벤트](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html)
+ [Amazon EventBridge 이벤트 패턴](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns.html)
+ [Amazon EventBridge 규칙](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html)

AWS 최종 사용자 메시징 SMS 는 다음 이벤트를 EventBridge로 직접 전송합니다.
+ 문자 메시지 전송 상태 업데이트됨
+ 미디어 메시지 전송 상태 업데이트됨
+ 음성 메시지 전송 상태 업데이트됨
+ 등록 상태 변경

문자(SMS), 미디어(MMS) 및 음성 메시지 이벤트의 경우, 다음 예제의 `detail` 섹션은 [이벤트 데이터 예제](configuration-sets-event-format.md)와(과) 유사합니다.

## 전달된 SMS 메시지에 대한 이벤트
<a name="event-delivered-sms-message"></a>

```
{
    "version": "0",
    "id": "5c0fa4f8-e4ba-ed02-6101-c795472fccd0",
    "detail-type": "Text Message Delivery Status Updated",
    "source": "aws.sms-voice",
    "account": "111122223333",
    "time": "2025-10-01T18:20:41Z",
    "region": "us-east-1",
    "resources": [],
    "detail": {
        "eventType": "TEXT_SUCCESSFUL",
        "eventVersion": "1.0",
        "eventTimestamp": 1759342841377,
        "isFinal": true,
        "originationPhoneNumber": "VAJZNBLLDX",
        "isoCountryCode": "ES",
        "isInternationalSend": false,
        "mcc": "214",
        "mnc": "05",
        "carrierName": "Movistar",
        "messageId": "ed23196c-75ce-4727-93ee-7bf72b64998f",
        "messageRequestTimestamp": 1759342840978,
        "messageEncoding": "GSM",
        "messageType": "TRANSACTIONAL",
        "messageStatus": "SUCCESSFUL",
        "messageStatusDescription": "Message has been accepted by phone carrier",
        "totalMessageParts": 1,
        "totalMessagePrice": 0.06087,
        "totalCarrierFee": 0.0,
        "protectConfiguration": {
            "protectConfigurationId": "protect-e06e5d722c31455286262a108e7d863d",
            "protectStatus": "ALLOW"
        }
    }
}
```

## 전송된 SMS 메시지에 대한 이벤트
<a name="event-sent-sms-message"></a>

```
{
    "version": "0",
    "id": "4111946b-816c-e73a-9ea0-a8367b9d57e4",
    "detail-type": "Text Message Delivery Status Updated",
    "source": "aws.sms-voice",
    "account": "555555555555",
    "time": "2024-10-16T17:20:24Z",
    "region": "eu-west-2",
    "resources": [],
    "detail": {
        "eventType": "TEXT_SUCCESSFUL",
        "eventVersion": "1.0",
        "eventTimestamp": 1729099224788,
        "isFinal": true,
        "originationPhoneNumber": "+18445550123",
        "isoCountryCode": "US",
        "isInternationalSend": false,
        "messageId": "9539975a-e71f-45f3-b496-8d98dc098a77",
        "messageRequestTimestamp": 1729099224438,
        "messageEncoding": "GSM",
        "messageType": "PROMOTIONAL",
        "messageStatus": "SUCCESSFUL",
        "messageStatusDescription": "Message has been accepted by phone carrier",
        "totalMessageParts": 1,
        "totalMessagePrice": 0.00581,
        "totalCarrierFee": 0.00302,
        "protectConfiguration": {
            "protectConfigurationId": "protect-e06e5d722c31455286262a108e7d863d",
            "protectStatus": "ALLOW"
        }
    }
}
```

## 전송된 음성 메시지에 대한 이벤트
<a name="event-sent-voice-message"></a>

```
{
    "version": "0",
    "id": "3bd18839-b5b4-79c5-1b18-bd6545f40566",
    "detail-type": "Voice Message Delivery Status Updated",
    "source": "aws.sms-voice",
    "account": "444455556666",
    "time": "2024-10-16T17:18:50Z",
    "region": "eu-west-2",
    "resources": [],
    "detail": {
        "eventType": "VOICE_INITIATED",
        "eventVersion": "1.0",
        "eventTimestamp": 1729099130226,
        "isFinal": false,
        "originationPhoneNumber": "+18445550123",
        "isoCountryCode": "US",
        "messageId": "1d2295bd-ac9b-4517-821f-7c6d95d789a1",
        "messageRequestTimestamp": 1729099129845,
        "messageStatus": "INITIATED"
    }
}
```

## 등록 상태 변경에 대한 이벤트
<a name="event-registration-status-change"></a>

AWS 최종 사용자 메시징 SMS 는 Amazon EventBridge에 다음과 같은 등록 상태 변경을 전송합니다.

`CLOSED`, `CREATED`, `COMPLETE`, `DELETED`, `PROVISIONING`, `REQUIRES_AUTHENTICATION`, `REQUIRES_UPDATES`, `REVIEWING`, `SUBMITTED`

이러한 상태 값에 대한 정의는 AWS 최종 사용자 메시징 SMS API 참조의 [RegistrationInformation](https://docs.aws.amazon.com/pinpoint/latest/apireference_smsvoicev2/API_RegistrationInformation.html)을 참조하세요.

```
{
    "version": "0",
    "id": "d2e8812b-d34c-90f9-a8a9-3f18e15d1db9",
    "detail-type": "Registration Status Change",
    "source": "aws.sms-voice",
    "account": "111122223333",
    "time": "2025-09-26T17:42:25Z",
    "region": "us-east-1",
    "resources": ["arn:aws:sms-voice:us-east-1:111122223333:registration/registration-30a16a8b7cec478a8e37febbb9005348"],
    "detail": {
        "registrationDetails": {
            "registrationId": "registration-30a16a8b7cec478a8e37febbb9005348",
            "registrationVersionNumber": 1,
            "registrationType": "ZZ_LONG_CODE_REGISTRATION",
            "registrationStatusChangeTimestamp": 1758908543000,
            "currentStatus": "SUBMITTED"
        },
        "registrationArn": "arn:aws:sms-voice:us-east-1:111122223333:registration/registration-30a16a8b7cec478a8e37febbb9005348"
    }
}
```