Amazon Q Developer가 Amazon SNS로부터 메시지를 수신하지 못하는 이유는 무엇입니까?

간략한 설명

다음 이유 중 하나로 인해 Amazon SNS 주제 알림이 Amazon Q Developer에게 전달되지 않았습니다.

• Amazon Q Developer와 Slack 채널 간의 커뮤니케이션 채널이 잘못 구성되었습니다.
• SNS 주제와 Amazon Q Developer 간의 커뮤니케이션 채널이 잘못 구성되었습니다.

해결 방법

Amazon Q Developer를 위한 CloudWatch Logs 활성화

아직 활성화하지 않았다면 채팅 애플리케이션에서 Amazon Q Developer용 Amazon CloudWatch Logs를 활성화하여 오류 메시지를 검토하십시오.

Amazon Q Developer와 Slack 채널 간의 커뮤니케이션 채널을 올바르게 구성했는지 확인

Slack 채널이 보관 또는 삭제되지 않았는지 확인

Slack 채널이 보관되거나 삭제되면 채널에서 메시지를 수신할 수 없으며 Slack이 모든 앱을 비활성화합니다.

채널 보관을 취소하려면 Slack 웹 사이트에서 Archive or delete a channel을 참조하십시오.

참고: 삭제한 Slack 채널은 복원할 수 없습니다. 구독한 Slack 채널이 삭제된 경우 새 Slack 채널을 생성한 다음 주제의 알림을 수신하도록 새 채널을 구성하십시오.

Slack 워크스페이스에 채팅 애플리케이션을 설치했는지 확인

채팅 애플리케이션 CloudWatch Logs에서 "account_inactive" 오류 메시지를 검토하십시오. "account_inactive" 오류 메시지가 있다면 Slack 워크스페이스에 채팅 애플리케이션이 설치되지 않은 것입니다.

Slack 워크스페이스에 채팅 애플리케이션을 설치하려면 튜토리얼: Slack 시작하기의 지침을 따르십시오.

(프라이빗 Slack 채널만 해당) Slack 채널에 채팅 애플리케이션을 추가했는지 확인

채팅 애플리케이션 CloudWatch Logs에서 "channel_not_found" 오류 메시지를 검토하십시오. 채팅 애플리케이션을 프라이빗 채널에 추가하지 않은 경우 이 오류 메시지가 표시됩니다.

프라이빗 Slack 채널에 Amazon Q Developer를 추가하려면 프라이빗 채널에서 /invite @Amazon Q 명령을 실행합니다.

(Slack, Amazon Chime 및 Microsoft Teams의 경우)

SNS 주제와 Amazon Q Developer 간의 커뮤니케이션 채널을 올바르게 구성했는지 확인하십시오.

Amazon Q Developer에서 Amazon SNS 주제 구독을 등록했는지 확인

다음 단계를 완료합니다.

1. Amazon Q Developer 콘솔을 엽니다.
2. 탐색 창의 구성된 클라이언트에서 Slack, Amazon Chime 또는 Microsoft Teams를 선택합니다.
3. Slack 워크스페이스 구성에서 Slack 채널을 선택하거나, Amazon Chime 웹후크 목록에서 웹후크를 선택하거나, Microsoft Teams 채널을 선택합니다.
4. 편집을 선택합니다.
5. 세부 정보 창의 주제 아래에서 SNS 주제를 찾아보십시오. 주제가 목록에 없는 경우 Amazon Q Developer에 SNS 주제 구독을 등록하십시오.

Amazon Q Developer 엔드포인트를 Amazon SNS 주제의 주제 구독으로 등록했는지 확인

다음 단계를 완료합니다.

1. Amazon SNS 콘솔을 엽니다.
2. 탐색 창에서 주제를 선택한 다음 SNS 주제의 이름을 선택합니다.
3. 구독에서 Amazon Q Developer 엔드포인트 https://global.sns-api.chatbot.amazonaws.com을 찾으십시오. Amazon Q Developer 엔드포인트가 주제 구독으로 나열되지 않는 경우 Amazon Q Developer에 SNS 주제 구독을 등록해야 합니다.
   참고: Amazon Q Developer 구성을 사용하여 테스트 알림을 전송하십시오.

SNS 주제의 메시지를 지원되지 않는 형식으로 Amazon Q Developer에 수동으로 게시하지 않음

Amazon Q Developer는 SNS 주제에 수동으로 게시되는 메시지를 지원합니다. 하지만 메시지 형식은 Amazon Q Developer와 호환되어야 합니다. 메시지를 전송하도록 구성된 모든 서비스는 Amazon Q Developer가 지원하는 서비스를 통해서만 Amazon Q Developer로 Amazon SNS 알림을 전송해야 합니다.

Amazon Q Developer가 Amazon SNS 주제에 게시된 AWS 서비스 메시지를 지원하는지 확인

채팅 애플리케이션 CloudWatch Logs에서 "Event Received is not supported" 오류 메시지를 검토하십시오. "Event Received is not supported" 오류 메시지가 표시되면 Amazon Q Developer가 주제에 게시된 AWS 서비스 메시지를 지원하지 않는 것입니다.

Amazon Q Developer가 지원하는 AWS 서비스 목록은 채팅 애플리케이션에서 Amazon Q Developer를 사용하여 AWS 서비스 모니터링을 참조하십시오.

다른 AWS 서비스가 메시지를 게시하는 데 필요한 권한을 Amazon SNS 주제가 부여하는지 확인

다음 단계를 완료합니다.

1. Amazon SNS 콘솔을 엽니다.
2. 탐색 창에서 주제를 선택합니다.
3. Amazon Q Developer에 구독을 등록한 SNS 주제를 선택합니다.
4. 액세스 정책 탭을 선택합니다.
5. 액세스 정책의 스테이트먼트 섹션을 검토합니다. 정책이 올바른 AWS 서비스에서 SNS:Publish API 작업을 실행하도록 허용하는지 확인하십시오.
6. Amazon SNS 액세스 정책이 올바른 AWS 서비스에서 주제에 이벤트를 게시하도록 허용하지 않는 경우 정책을 업데이트하십시오.
   주제 페이지의 세부 정보 섹션에서 편집을 선택합니다.
   액세스 정책 섹션을 확장한 다음 올바른 액세스 제어를 추가합니다.

참고: Amazon SNS 액세스 정책의 예는 Amazon SNS 주제 알림 구성을 참조하십시오.

Amazon SNS 주제에 원시 메시지 전송이 활성화되어 있지 않은지 확인

Amazon Q Developer는 원시 메시지 전송을 허용하지 않습니다. SNS 주제에 원시 메시지 전송이 활성화되어 있지 않은지 확인하려면 다음 단계를 완료하십시오.

1. Amazon SNS 콘솔을 엽니다.
2. 탐색 창에서 주제를 선택한 다음 SNS 주제의 이름을 선택합니다.
3. 세부 정보 창의 원시 메시지 전송에서 상태가 활성화됨인지 비활성화됨인지 확인합니다.
4. 상태가 활성화됨인 경우 다음 조치를 취하십시오.
   편집을 선택합니다.
   원시 메시지 전송을 끄려면 원시 메시지 전송 활성화를 해제합니다.
   변경 사항 저장을 선택합니다.

필수 AWS KMS 키 정책 권한을 포함했는지 확인

참고: 이 확인은 서버 측 암호화가 활성화된 SNS 주제에만 적용됩니다.

AWS Key Management Service(AWS KMS) 키 정책에서 메시지를 보내는 서비스가 암호화된 SNS 주제에 게시하도록 허용해야 합니다.

AWS KMS 키 정책에는 다음 섹션이 포함되어야 합니다.

{  
  "Sid": "Allow CWE to use the key",  
  "Effect": "Allow",  
  "Principal": {  
    "Service": "service.amazonaws.com"  
  },  
  "Action": [  
    "kms:Decrypt",  
    "kms:GenerateDataKey"  
  ],  
  "Resource": "*"  
}

중요: events.amazonaws.com을 암호화된 SNS 주제를 게시하는 서비스의 AWS 서비스 위탁자로 바꾸십시오.

AWS 서비스가 Amazon SNS 주제에 초당 10개 알림을 초과하는 속도로 메시지를 게시하지 않는지 확인

Amazon Q Developer는 초당 10개의 이벤트를 허용합니다. Amazon Q Developer가 초당 10개를 초과하는 이벤트를 수신하면 추가 메시지가 제한됩니다.

제한된 이벤트가 있는지 확인하려면 Amazon Q Developer용 CloudWatch Logs에서 EventsThrottled 지표를 검토하십시오.

(Amazon EventBridge의 경우) AWS 서비스가 Amazon Q Developer 클라이언트 대상으로 전송하는 이벤트 알림을 EventBridg가 지원하는지 확인

EventBridge 입력 변환기를 사용하여 사용자 지정 알림을 생성한 다음 SNS 주제에 알림을 전달합니다. Amazon Q Developer를 통해 SNS 주제를 모니터링하고 구성된 Microsoft Teams, Amazon Chime 또는 Slack 채널에 알림을 전송합니다. Amazon Q Developer 사용자 지정 알림은 이벤트 스키마 형식을 따라야 합니다.

자세한 내용은 채팅 애플리케이션에서 Amazon Q Developer에 지원되는 서비스를 참조하십시오.

관련 정보

채팅 채널에서 Amazon Q Developer 문제 해결

웹후크를 사용하여 Amazon Chime, Slack 또는 Microsoft Teams에 Amazon SNS 메시지를 게시하려면 어떻게 해야 합니까?