이 문서에서는 Apache Kafka용 Amazon Managed Streaming (Amazon MSK) 가져오기 주제에 대한 일반적인 문제 해결 팁을 제공합니다.
가져오기 주제를 구성하고 메시지 수집을 시작한 후 관련 Cloud Monitoring 측정항목을 확인하여 데이터가 수집되었는지 확인할 수 있습니다. 다음 단계를 수행합니다.
Console에서 주제 페이지로 이동합니다.
문제를 해결하려는 Amazon MSK 가져오기 주제를 클릭합니다.
주제 세부정보 페이지에서 측정항목 탭을 클릭합니다.
차트에서 수집 바이트 수 측정항목을 확인합니다.
처리 중인 데이터가 없으면 주제 세부정보 페이지에서 주제 상태 필드에 오류가 있는지 확인합니다.
수집 데이터 소스 상태 측정항목을 확인할 수도 있습니다. 이렇게 하려면 주제 세부정보 페이지에서 측정항목 탭을 클릭합니다.
다음은 발생할 수 있는 오류 목록입니다.
오류 코드 설명 수정 MSK_PERMISSION_DENIED권한 문제로 인해 Amazon MSK 데이터를 사용하는 중에 오류가 발생했습니다. AWS 역할 ARN이 정확한지 확인하고 AWS 역할에 필요한 읽기 권한이 있는지 확인합니다. 자세한 내용은 AWS에서 정책 만들기를 참고하세요. 서비스 계정이 있고 커스텀 트러스트 정책을 사용하여 AWS에서 역할 만들기 절차에 설명된 대로 올바르게 구성되었는지 확인합니다. 서비스 계정을 만드는 방법에 관한 자세한 내용은 Google Cloud에서 서비스 계정 만들기를 참고하세요. Pub/Sub 서비스 계정에 iam.serviceAccounts.getOpenIdToken권한이 있는지 확인합니다. 자세한 내용은 Pub/Sub 서비스 계정에 서비스 계정 토큰 생성자 역할 추가를 참고하세요.서비스 계정에 서비스 계정 사용자 역할을 추가했는지 확인합니다. 자세한 내용은 서비스 계정에 서비스 계정 사용자 역할 추가를 참조하세요. PUBLISH_PERMISSION_DENIED권한 문제로 인해 Pub/Sub 주제에 게시하는 중에 오류가 발생했습니다. Pub/Sub 서비스 계정에 필요한 게시 권한을 부여합니다. 자세한 내용은 Pub/Sub 서비스 계정에 Pub/Sub 게시자 역할 추가를 참고하세요. CLUSTER_NOT_FOUND제공된 클러스터를 찾을 수 없습니다. 클러스터 ARN이 정확한지 확인합니다. 클러스터가 존재하고 액세스할 수 있는지 확인합니다. TOPIC_NOT_FOUND제공된 Kafka 주제를 찾을 수 없습니다. 주제 이름이 정확한지 확인합니다. 주제가 지정된 클러스터 내에 있는지 확인합니다.
이 시점까지 오류가 없으면 정상 게시자 유지의 권장사항을 확인하세요.
가져오기 주제에 플랫폼 로그를 사용 설정할 수도 있습니다. 이러한 로그는 Pub/Sub 가져오기 주제에 객체를 처리하는 데 문제가 있을 때 문제를 해결하는 데 도움이 됩니다.
Apache Kafka®는 미국 및/또는 다른 국가에서 사용되는 Apache Software Foundation 또는 해당 계열사의 등록 상표입니다.