对 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 API，包括 Admin REST、REST Producer 和 Schema Registry。

REST API 的 HTTP 错误代码及修复方法
HTTP 错误代码	管理 REST	REST 生产者	模式注册表
400	请求错误-不是有效的请求。请更正您的请求。	请求错误-不是有效的请求。此错误可能是由格式不正确的有效内容，不受支持的密钥类型或超出的密钥/消息大小导致的。	请求错误-不是有效的请求。请更正您的请求。
403	无权执行操作。使用的 API 密钥缺少特定角色。用于创建资源密钥的标识没有 IAM 策略。有关更多信息，请参阅管理对 Event Streams 实例的认证。	已禁止您提供的令牌没有足够的许可权来生成主题。检查是否为令牌提供了必需的访问角色。有关更多信息，请参阅管理对 Event Streams 实例的认证。	已禁止客户无权执行此请求。未授权服务标识访问模式资源。有关更多信息，请参阅管理对 Event Streams 实例的认证。
404	找不到。找不到具有指定主题名称的主题。Event Streams 将 `auto.create.topics.enable` 设置为 `false`，因此必须在使用该主题之前显式创建该主题。	找不到。主题不存在。Event Streams 将 `auto.create.topics.enable` 设置为 `false`，因此在向其生成消息之前必须显式创建主题。	找不到。注册表不包含具有指定模式标识的模式，或者由模式标识标识的模式不包含对应于指定版本号的版本，或者未使用指定类型的规则配置模式。
415		媒体类型不受支持。
422	请求在语义上无效。您的请求格式不正确。如果在尝试创建新主题时收到此错误，那么可能是由于您的计划允许的最大分区数所致。有关更多信息，请参阅 Event Streams 如何使用限制和配额来验证限制。
503	服务不可用。由于 Event Streams 代理不可用，因此请求失败。处理请求时发生错误。该服务不可用。如果在创建新主题失败时接收到此错误，请验证限制和配额。	服务不可用。由于 Event Streams 代理不可用，因此请求失败。

Kafka API 是基于 TCP 的 API。有关更多信息，请参阅其协议指南以了解错误代码。

无法创建 Kafka 主题

如果您无法创建主题，那么可能是由于以下原因:

您没有集群上的管理角色。
磁盘空间不足。检查根据主题配置保留磁盘空间的方式。要解决此问题，请删除未使用的主题并将主题的配置 retention.ms 和 retention.bytes 更新为更小。对于企业实例，扩展集群。有关更多信息，请参阅缩放企业套餐容量。

错误“发送信息失败”

Event Streams目标返回错误，您无法向其发送事件。查看日志时，错误显示为“发送信息失败”，条目包含以下信息：

“发送消息失败”,“错误”:“kafka 服务器：请求的主题或分区在此代理上不存在”, "reason": "invalid_or_unreachable_topic"

如果主题尚未创建或已被删除，或者如果您正在向一个不是主题分区当前领导者的代理发送数据，则可能出现该错误。主题分区的领导权会随着时间的推移而改变，因为如果一个代理服务器因故离线，其分区的领导权就会转移到其他代理服务器，直到它恢复为止。

要解决问题，请确认主题是否存在。有了正确的配置，Kafka 客户端就能快速刷新元数据或重新连接到不同的代理，因此这类错误情况往往能自行恢复。如果问题持续存在，请联系云支持部门进行问题调查。