Event Streams 문제점 해결

문제 해결 팁을 사용하여 IBM® Event Streams for IBM Cloud® 관련 문제를 해결하는 방법을 알아보세요.

네트워크 관련 문제

주제에 연결할 수 없거나 네트워크 문제로 인해 주제에서 이용하거나 주제로 생성할 수 없는 Apache Kafka 애플리케이션이 있는 경우 다음과 같은 다른 방법으로 명시될 수 있습니다.

호스트를 분석할 수 없습니다. nslookup 또는 dig를 사용하여 브로커 주소를 해석할 수 있는지 확인하십시오. nslookup 또는 dig가 실패하면 DNS 서버를 확인하십시오. 일반적으로 공용 엔드포인트는 다음 예제에서와 같이 세 개의 공용 IP로 해석됩니다.

$ nslookup broker-0-93g2bbjd0pz8ghkj.kafka.svc08.us-south.eventstreams.cloud.ibm.com
Server:		172.31.255.241
Address:	172.31.255.241#53
Non-authoritative answer:
broker-0-93g2bbjd0pz8ghkj.kafka.svc08.us-south.eventstreams.cloud.ibm.com	canonical name = kafka.svc08.us-south.eventstreams.cloud.ibm.com.
Name:	kafka.svc08.us-south.eventstreams.cloud.ibm.com
Address: 169.48.243.82
Name:	kafka.svc08.us-south.eventstreams.cloud.ibm.com
Address: 169.61.217.150
Name:	kafka.svc08.us-south.eventstreams.cloud.ibm.com
Address: 52.117.238.34

사설 엔드포인트는 166.9로 시작하는 세 개의 사설 IP로 해석됩니다.

$ nslookup kafka-0-mh-int-pipe-mzr-cse-kjh.private.us-south.messagehub.test.appdomain.cloud
Server:		172.31.255.241
Address:	172.31.255.241#53

연결 제한시간이 초과되었습니다. netcat (nc) 를 사용하여 브로커에 대한 연결을 점검하십시오.
```
$ nc -zv broker-0-93g2bbjd0pz8ghkj.kafka.svc08.us-south.eventstreams.cloud.ibm.com 9093
Connection to broker-0-93g2bbjd0pz8ghkj.kafka.svc08.us-south.eventstreams.cloud.ibm.com port 9093 [tcp/*] succeeded!
```
nc 명령 제한시간은 클라이언트 애플리케이션이 실행 중인 네트워크가 브로커 주소에 연결할 수 없음을 의미합니다. 방화벽 규칙, calico 네트워크 정책 및 서비스 메시 설정과 같은 여러 가지 이유로 인해 발생할 수 있습니다. 네트워크 관리자와 함께 작업하여 netcat이 작동하도록 하십시오. 서비스 인스턴스가 엔터프라이즈 플랜에 있고 클러스터에 개인 전용 서비스 엔드포인트가 있는 경우 클라이언트 애플리케이션의 IP가 IP 허용 목록 또는 CBR 규칙에 추가되었는지 확인하십시오. 자세한 정보는 네트워크 액세스 제한 을 참조하십시오.
연결 재설정 또는 클라이언트의 연결이 끊어졌습니다. 이는 애플리케이션 레벨 문제가 아니라 네트워크 문제일 수 있습니다.

유지보수 창에서 브로커 및 프록시가 롤링 방식으로 다시 시작되고 Kafka 클라이언트에 연결 끊기 예외가 표시될 수 있습니다. 올바른 구성을 사용하면 Kafka 클라이언트가 즉시 다른 브로커에 다시 연결하므로 가용성에 영향을 주지 않습니다. 애플리케이션에서 오랜 기간 동안 연결이 끊어진 경우, 디버그가 사용 가능한 Kafka 클라이언트 라이브러리 버전, 클라이언트 구성 및 로그를 공유하십시오. 클라이언트가 브로커 재시작에 대해 복원성을 갖도록 구성하기 위해 적절한 값을 검토하고 제안합니다. 지원되는 Kafka 클라이언트 라이브러리는 권장 클라이언트 목록 을 참조하십시오.

문제가 여전히 지속되는 경우 추가 조사를 위해 지원 티켓 을 제기하십시오.

REST API의 HTTP 오류 코드 및 해결 방법

HTTP 오류 코드는 관리자 REST, REST 프로듀서 및 스키마 레지스트리를 포함한 REST API에 적용됩니다.

REST API의 HTTP 오류 코드 및 해결 방법
HTTP 오류 코드	관리 REST	REST 프로듀서	스키마 레지스트리
400	잘못된 요청-올바른 요청이 아닙니다. 요청을 정정하십시오.	잘못된 요청-올바른 요청이 아닙니다. 이 오류는 잘못된 형식의 페이로드 또는 지원되지 않는 키 유형으로 인해 발생하거나 키/메시지 크기를 초과했기 때문에 발생할 수 있습니다.	잘못된 요청-올바른 요청이 아닙니다. 요청을 정정하십시오.
403	작업을 수행할 권한이 없습니다. 사용된 API키에 특정 역할이 누락되었습니다. 리소스 키를 작성하는 데 사용된 ID에 IAM 정책이 없습니다. 자세한 정보는 Event Streams 인스턴스에 대한 인증 관리 를 참조하십시오.	금지되었습니다. 제공한 토큰에 토픽을 생성할 수 있는 충분한 권한이 없습니다. 토큰에 필수 액세스 역할을 제공했는지 확인하십시오. 자세한 정보는 Event Streams 인스턴스에 대한 인증 관리 를 참조하십시오.	금지되었습니다. 클라이언트는 이 요청을 수행할 권한이 없습니다. 서비스 ID에 스키마 자원에 액세스할 수 있는 권한이 부여되지 않았습니다. 자세한 정보는 Event Streams 인스턴스에 대한 인증 관리 를 참조하십시오.
404	찾을 수 없습니다. 지정한 주제 이름을 가진 주제를 찾을 수 없습니다. Event Streams 가 `auto.create.topics.enable` 를 `false` 로 설정하므로 토픽을 사용하기 전에 명시적으로 작성해야 합니다.	찾을 수 없습니다. 주제가 존재하지 않습니다. Event Streams 가 `auto.create.topics.enable` 를 `false` 로 설정하므로, 메시지를 생성하기 전에 토픽을 명시적으로 작성해야 합니다.	찾을 수 없습니다. 레지스트리에 지정된 스키마 ID의 스키마가 포함되어 있지 않거나, 스키마 ID로 식별된 스키마에 지정된 버전 번호에 해당하는 버전이 포함되어 있지 않거나, 스키마가 지정된 규칙 유형으로 구성되어 있지 않습니다.
415		지원되지 않은 매체 유형입니다.
422	의미상 올바르지 않은 요청입니다. 잘못된 형식의 요청이 있습니다. 새 토픽을 작성하려고 할 때 이 오류를 수신하는 경우, 플랜에 허용되는 최대 파티션 수 때문일 수 있습니다. 자세한 정보는 Event Streams 가 한계 및 할당량을 사용하여 한계를 확인하는 방법 을 참조하십시오.
503	서비스를 사용할 수 없습니다. Event Streams 브로커가 사용 불가능하므로 요청이 실패했습니다. 요청을 처리하는 동안 오류가 발생했습니다. 서비스를 사용할 수 없습니다. 새 토픽 작성에 실패할 때 이 오류를 수신하면 한계 및 할당량 을 확인하십시오.	서비스를 사용할 수 없습니다. Event Streams 브로커가 사용 불가능하므로 요청이 실패했습니다.

Kafka API는 TCP 기반 API입니다. 자세한 정보는 오류 코드에 관한 프로토콜 안내서 를 참조하십시오.

Kafka 주제를 작성할 수 없음

토픽을 작성할 수 없는 경우 다음과 같은 이유 때문일 수 있습니다.

클러스터에 대한 관리 역할 이 없습니다.
디스크 공간이 충분하지 않습니다. 주제 구성에 따라 디스크 공간이 예약되는 방법 을 확인하십시오. 이 문제를 해결하려면 사용하지 않는 주제를 삭제하고 주제의 구성 retention.ms 및 retention.bytes 를 더 작게 업데이트하십시오. 엔터프라이즈 인스턴스의 경우 클러스터를 스케일링합니다. 자세한 정보는 엔터프라이즈 플랜 용량 스케일링 을 참조하십시오.

"메시지를 보내지 못했습니다" 오류

Event Streams 대상에서 오류를 반환하여 이벤트를 보낼 수 없습니다. 로그를 보면 오류는 "메시지를 보내지 못함"이며 항목에는 다음과 같은 정보가 포함되어 있습니다:

"메시지를 보내지 못했습니다","error":"kafka 서버입니다: 이 브로커에 존재하지 않는 토픽 또는 파티션에 대한 요청이었습니다.","reason":"invalid_or_unreachable_topic"

토픽이 만들어지지 않았거나 삭제된 경우 또는 토픽 파티션의 현재 리더가 아닌 브로커에게 데이터를 전송하는 경우 이 오류가 발생할 수 있습니다. 토픽 파티션의 리더십은 시간이 지나면서 바뀔 수 있는데, 어떤 이유로든 브로커가 오프라인 상태가 되면 복구될 때까지 해당 파티션의 리더십이 다른 브로커로 이동되기 때문입니다.

문제를 해결하려면 해당 토픽이 존재하는지 확인합니다. 올바른 구성을 사용하면 Kafka 클라이언트가 메타데이터를 새로 고치거나 다른 브로커에 빠르게 다시 연결하므로 이러한 유형의 오류 상황은 종종 저절로 복구됩니다. 문제가 지속되면 Cloud 지원팀에 문의하여 문제 조사를 요청하세요.