**지원 종료 공지:** 2026년 10월 30일에 AWS 는 Amazon Pinpoint에 대한 지원을 종료합니다. 2026년 10월 30일 이후에는 Amazon Pinpoint 콘솔 또는 Amazon Pinpoint 리소스(엔드포인트, 세그먼트, 캠페인, 여정, 분석)에 더 이상 액세스할 수 없습니다. 자세한 내용은 [Amazon Pinpoint 지원 종료](https://docs.aws.amazon.com/console/pinpoint/migration-guide)를 참조하세요. **참고:** SMS, 음성, 모바일 푸시, OTP 및 전화번호 검증과 관련된 APIs는이 변경의 영향을 받지 않으며 AWS 최종 사용자 메시징에서 지원됩니다.
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 문제 해결
**참고**
다음 문제 해결 주제가 이동되었습니다.
[세그먼트 문제 해결](segments-troubleshooting.md)
[캠페인 문제 해결](campaigns-troubleshooting.md)
[여정 문제 해결](journeys-troubleshooting.md)
[SMS 채널 문제 해결](channels-sms-troubleshooting.md)
[음성 채널 문제 해결](channels-voice-troubleshooting.md)
[푸시 채널 문제 해결](channels-push-troubleshooting.md)
[이메일 채널 문제 해결](channels-email-troubleshooting.md)
Amazon Pinpoint를 사용할 때의 문제 해결 정보와 문제 해결에 도움이 되는 가능한 해결책을 알아봅니다.
**모니터링 및 로깅**
모범 사례로서 다음과 같은 방법으로 Amazon Pinpoint에서 이벤트를 로깅하는 것이 좋습니다.
+ 의 지침에 Amazon Kinesis Data Streams 따라를 통해 이벤트 스트림 켜기[Amazon Pinpoint를 사용한 이벤트 스트리밍](analytics-streaming.md).
+ 사용자 지정 로깅 솔루션 사용. 자세한 내용은 [Digital User Engagement Events Database](https://aws.amazon.com/solutions/implementations/digital-user-engagement-events-database/)를 참조하세요. 여러 서비스가 포함되며 추가 비용이 발생합니다.
+ Amazon Pinpoint에서 지원하는 Amazon CloudWatch 지표 사용. 자세한 내용은 [Amazon CloudWatch를 사용한 Amazon Pinpoint 모니터링](monitoring.md) 단원을 참조하십시오.
+ CloudTrail에 로깅된 Amazon Pinpoint API 호출 사용. 자세한 내용은 *Amazon Pinpoint 개발자 안내서*의 [Logging Amazon Pinpoint API calls with AWS CloudTrail](https://docs.aws.amazon.com/pinpoint/latest/developerguide/logging-using-cloudtrail.html)을 참조하세요.
**Topics**
+ [일반적인 작업의 CLI 예제](#troubleshooting-cli-examples)
## 일반적인 작업의 CLI 예제
다음 예제는 Amazon Pinpoint에 대한 일반적인 CLI 명령입니다.
+ 엔드포인트 데이터 가져오기: [get-endpoint](https://docs.aws.amazon.com/cli/latest/reference/pinpoint/get-endpoint.html) CLI
```
aws pinpoint get-endpoint —application-id {{AppId}} —endpoint-id {{EndpointId}}
```
**위의 명령에서 다음과 같이 변경합니다.**
+ {{AppId}}를 엔드포인트가 포함된 Amazon Pinpoint 프로젝트의 ID로 바꿉니다.
+ {{EndpointId}}를 검색하려는 기존 엔드포인트의 ID로 바꿉니다.
+ 사용자 데이터 가져오기: [get-user-endpoints](https://docs.aws.amazon.com/cli/latest/reference/pinpoint/get-user-endpoints.html) CLI
```
aws pinpoint get-user-endpoints —application-id {{AppId}} —user-id {{UserId}}
```
**위의 명령에서 다음과 같이 변경합니다.**
+ {{AppId}}를 엔드포인트가 포함된 Amazon Pinpoint 프로젝트의 ID로 바꿉니다.
+ {{UserId}}를 사용자의 ID로 바꿉니다.
+ 엔드포인트 업데이트 또는 새 엔드포인트 생성: [update-endpoint](https://docs.aws.amazon.com/cli/latest/reference/pinpoint/update-endpoint.html) CLI
```
aws pinpoint update-endpoint —application-id {{AppId}} —endpoint-id {{EndpointId}} —endpoint-request '{"ChannelType":"SMS","Address":"+12345678","Location":{"Country":"USA"},"User":{"UserId":"{{UserId}}"}}'
```
**위의 명령에서 다음과 같이 변경합니다.**
+ {{AppId}}를 엔드포인트가 포함된 Amazon Pinpoint 프로젝트의 ID로 바꿉니다.
+ {{EndpointId}}를 생성 또는 업데이트하는 기존 엔드포인트의 ID로 바꿉니다.
+ {{UserId}}를 사용자의 ID로 바꿉니다.
+ 엔드포인트 삭제: [delete-endpoint](https://docs.aws.amazon.com/cli/latest/reference/pinpoint/delete-endpoint.html) CLI
```
aws pinpoint delete-endpoint —application-id {{AppId}} —endpoint-id {{EndpointId}}
```
**위의 명령에서 다음과 같이 변경합니다.**
+ {{AppId}}를 엔드포인트가 포함된 Amazon Pinpoint 프로젝트의 ID로 바꿉니다.
+ {{EndpointId}}를 삭제하려는 기존 엔드포인트의 ID로 바꿉니다.
+ 전화번호 확인: [phone-number-validate](https://docs.aws.amazon.com/cli/latest/reference/pinpoint/phone-number-validate.html) CLI
```
aws pinpoint phone-number-validate —number-validate-request PhoneNumber={{+12065550100}}
```
**위의 명령에서 다음과 같이 변경합니다.**
+ {{\+12065550100}}을 확인하려는 전화번호로 바꿉니다.
+ [send-messages](https://docs.aws.amazon.com/cli/latest/reference/pinpoint/send-messages.html) 예제 CLI: 번호로 SMS
```
aws pinpoint send-messages --application-id {{AppID}} --message-request '{"MessageConfiguration": {"SMSMessage":{"Body":"This is a test message"}},"Addresses": {"{{DestinationPhoneNumber}}": {"ChannelType":"SMS"}}}‘
```
**위의 명령에서 다음과 같이 변경합니다.**
+ {{AppId}}를 엔드포인트가 포함된 Amazon Pinpoint 프로젝트의 ID로 바꿉니다.
+ {{DestinationPhoneNumber}}를 전송하려는 전화번호로 바꿉니다.
+ [send-messages](https://docs.aws.amazon.com/cli/latest/reference/pinpoint/send-messages.html) 예제 CLI: SMS로 발신 번호
```
aws pinpoint send-messages --application-id {{AppID}} --message-request '{"MessageConfiguration": {"SMSMessage":{"Body":"hello, how are you?","OriginationNumber": "{{OriginPhoneNumber}}"}},"Addresses": {"{{DestinationPhoneNumber}}": {"ChannelType":"SMS"}}}‘
```
**위의 명령에서 다음과 같이 변경합니다.**
+ {{AppId}}를 엔드포인트가 포함된 Amazon Pinpoint 프로젝트의 ID로 바꿉니다.
+ {{OriginPhoneNumber}}를 메시지가 발신될 전화번호로 바꿉니다.
+ {{DestinationPhoneNumber}}를 전송하려는 전화번호로 바꿉니다.
+ [send-messages](https://docs.aws.amazon.com/cli/latest/reference/pinpoint/send-messages.html) 예제 CLI: 엔드포인트로 SMS
```
aws pinpoint send-messages —application-id {{AppID}} —message-request '{"MessageConfiguration": {"SMSMessage":{"Body":"This is a test message"}},"Endpoints": {"{{EndPointId}}": {}}}'
```
**위의 명령에서 다음과 같이 변경합니다.**
+ {{AppId}}를 엔드포인트가 포함된 Amazon Pinpoint 프로젝트의 ID로 바꿉니다.
+ {{EndPointId}}를 전송할 기존 엔드포인트의 ID로 바꿉니다.
+ [send-messages](https://docs.aws.amazon.com/cli/latest/reference/pinpoint/send-messages.html) 예제 CLI: userId로 SMS
```
aws pinpoint send-users-messages —application-id {{AppID}} —send-users-message-request '{"MessageConfiguration": {"SMSMessage":{"Body":"This is a test"}},"Users": {"{{UserId}}": {}}}'
```
**위의 명령에서 다음과 같이 변경합니다.**
+ {{AppId}}를 엔드포인트가 포함된 Amazon Pinpoint 프로젝트의 ID로 바꿉니다.
+ {{UserId}}를 사용자의 ID로 바꿉니다.
+ [Amazon Pinpoint 메시지 템플릿](messages-templates.md) [create-campaign](https://docs.aws.amazon.com/cli/latest/reference/pinpoint/create-campaign.html) CLI로 캠페인 생성
```
aws pinpoint create-campaign —application-id {{AppId}} —write-campaign-request file://campaignclirequest.json
file://campaignclirequest.json
{
"Description": "CLITestCampaign",
"HoldoutPercent": 0,
"MessageConfiguration":
{
"DefaultMessage":
{
"Body": "TestFromCLI"
}
},
"Name": "TestingCLICampaign",
"Schedule":
{
"StartTime": "IMMEDIATE"
},
"TemplateConfiguration":
{
"EmailTemplate":
{
"Name": "{{TemplateName}}",
"Version": "{{Version}}"
}
},
"SegmentId": "{{SegmentID}}",
"SegmentVersion": 1
}
```
**위의 명령과 파일에서 다음과 같이 변경하세요.**
+ {{AppId}}를 엔드포인트가 포함된 Amazon Pinpoint 프로젝트의 ID로 바꿉니다.
+ {{TemplateName}}을 템플릿의 이름으로 바꿉니다.
+ {{Version}}을 템플릿의 버전으로 바꿉니다.
+ {{SegmentID}}를 대상 지정할 세그먼트의 ID로 바꿉니다.