Event Streams のトラブルシューティング

トラブルシューティングのヒントを使用して、 IBM® Event Streams for IBM Cloud®の問題のトラブルシューティング方法を学んでください。

ネットワーク関連の問題

ネットワークの問題が原因で、トピックに接続できないか、トピックから取り込んだり、トピックを作成したりできない Apache Kafka アプリケーションがある場合は、以下の異なる方法で表示される可能性があります。

ホストを解決できません。 nslookup または dig を使用して、ブローカー・アドレスを解決できるかどうかを確認します。 nslookup または dig が失敗した場合は、DNS サーバーを確認してください。通常、以下の例のように、パブリック・エンドポイントは 3 つのパブリック 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で始まる 3 つのプライベート 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 エラーコードは、 Admin REST、 REST Producer、 Schema Registry を含む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 set `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 ターゲットがエラーを返し、そのターゲットにイベントを送信できません。ログを見ると、エラーは "Failed to send message "で、エントリーには以下のような情報が含まれている：

"メッセージの送信に失敗しました", "error": "kafkaサーバー：リクエストは、このブローカに存在しないトピックまたはパーティションに対するものです", "reason": "invalid_or_unreachable_topic"

このエラーは、トピックが作成されていないか削除されている場合、またはトピック・パーティションの現在のリーダーではないブローカーにデータを送信している場合に発生する可能性があります。ブローカーが何らかの理由でオフラインになると、そのパーティションのリーダーシップは回復するまで他のブローカーに移るからだ。

問題を解決するには、トピックが存在することを確認する。正しい設定をすれば、 Kafka クライアントはメタデータをリフレッシュしたり、別のブローカーに素早く再接続したりするため、この種のエラー状況は自力で回復することが多い。問題が解決しない場合は、クラウド・サポートに連絡して問題を調査してください。