Fehlerbehebung für Event Streams

Verwenden Sie die Tipps zur Fehlerbehebung, um zu erfahren, wie Sie Probleme mit IBM® Event Streams for IBM Cloud® beheben können.

Netzbezogene Probleme

Wenn Sie über eine Apache Kafka-Anwendung verfügen, die aufgrund von Netzproblemen keine Verbindung zu einem Topic herstellen kann oder nicht in der Lage ist, aus einem Topic zu konsumieren oder aufgrund von Netzproblemen ein Topic zu generieren, kann dies auf verschiedene Arten manifestiert werden.

Der Host kann nicht aufgelöst werden. Verwenden Sie nslookup oder dig, um zu prüfen, ob die Brokeradresse aufgelöst werden konnte. Wenn nslookup oder dig fehlschlägt, überprüfen Sie Ihren DNS-Server. Normalerweise wird der öffentliche Endpunkt wie in den folgenden Beispielen in drei öffentliche IP-Adressen aufgelöst.

$ 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

Der private Endpunkt wird in drei private IPs aufgelöst, die mit 166.9beginnen.

$ 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

Überschreitung des Verbindungszeitlimits Verwenden Sie netcat (nc), um die Konnektivität zum Broker zu überprüfen.
```
$ 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!
```
Ein nc-Befehlszeitlimit bedeutet, dass das Netz, in dem Ihre Clientanwendung ausgeführt wird, keine Verbindung zu den Brokeradressen herstellen konnte. Dies kann auf eine Reihe von Ursachen zurückzuführen sein, z. B. Firewallregeln, Calico-Netzrichtlinien und die Konfiguration von Servicenetzen. Arbeiten Sie mit Ihrem Netzadministrator zusammen, damit Netcat funktioniert. Wenn die Serviceinstanz im Enterprise-Plan enthalten ist und der Cluster einen reinen privaten Serviceendpunkt hat, überprüfen Sie, ob die IPs Ihrer Clientanwendung zur IP-Zulassungsliste oder zu den CBR-Regeln hinzugefügt wurden. Weitere Informationen finden Sie unter Netzzugriff einschränken.
Die Verbindung wurde zurückgesetzt oder der Client wurde getrennt. Dies ist möglicherweise nicht unbedingt ein Netzproblem, sondern ein Problem auf Anwendungsebene.

Während des Wartungsfensters werden Broker und Proxys auf rollierende Weise erneut gestartet und für den Kafka-Client wird möglicherweise eine Unterbrechungsausnahme angezeigt. Bei der richtigen Konfiguration stellt der Kafka-Client sofort eine Verbindung zu einem anderen Broker her, sodass die Verfügbarkeit nicht beeinträchtigt wird. Wenn die Verbindung Ihrer Anwendung über einen längeren Zeitraum unterbrochen wird, teilen Sie Ihre Kafka-Clientbibliotheksversion, Clientkonfiguration und Protokolle mit aktiviertem Debugging. Wir werden die entsprechenden Werte prüfen und vorschlagen, um den Client so zu konfigurieren, dass er für den Neustart des Brokers ausfallsicher ist. Informationen zu unterstützten Kafka-Clientbibliotheken finden Sie in der Liste der empfohlenen Clients.

Wenn das Problem weiterhin besteht, lösen Sie ein Support-Ticket zur weiteren Untersuchung aus.

HTTP für REST-APIs und wie man sie behebt

HTTP gelten für REST-APIs, einschließlich Admin REST, REST Producer und Schema Registry.

HTTP für REST-APIs und wie man sie behebt
HTTP-Fehlercode	Admin-REST	REST-Produzent	Schemaregistry
400	Ungültige Anforderung-keine gültige Anforderung. Korrigieren Sie Ihre Anforderung.	Ungültige Anforderung-keine gültige Anforderung. Dieser Fehler kann durch fehlerhafte Nutzdaten, einen nicht unterstützten Schlüsseltyp oder eine Überschreitung der Schlüssel-/Nachrichtengröße verursacht werden.	Ungültige Anforderung-keine gültige Anforderung. Korrigieren Sie Ihre Anforderung.
403	Nicht berechtigt, die Operation durchzuführen. Dem verwendeten API-Schlüssel fehlt eine bestimmte Rolle. Die ID, die zum Erstellen des Ressourcenschlüssels verwendet wurde, hat keine IAM-Richtlinie. Weitere Informationen finden Sie unter Authentifizierung für Event Streams.	Verboten. Das Token, das Sie angegeben haben, verfügt nicht über ausreichende Berechtigungen zum Erstellen eines Themas. Überprüfen Sie, ob Sie das Token mit der erforderlichen Zugriffsrolle angegeben haben. Weitere Informationen finden Sie unter Authentifizierung für Event Streams.	Verboten. Der Client ist nicht berechtigt, diese Anfrage auszuführen. Die Service-ID ist nicht berechtigt, auf eine Schemaressource zuzugreifen. Weitere Informationen finden Sie unter Authentifizierung für Event Streams.
404	Nicht gefunden. Das Thema mit dem angegebenen Themennamen wurde nicht gefunden. Event Streams setzen `auto.create.topics.enable` auf `false`. Daher muss das Thema explizit erstellt werden, bevor es verwendet wird.	Nicht gefunden. Das Thema ist nicht vorhanden. Event Streams setzen `auto.create.topics.enable` auf `false`, daher muss das Thema explizit erstellt werden, bevor eine Nachricht für es erzeugt wird.	Nicht gefunden. Entweder enthält die Registry kein Schema mit der angegebenen Schema-ID oder das durch die Schema-ID angegebene Schema enthält keine Version, die der angegebenen Versionsnummer entspricht, oder das Schema ist nicht mit dem angegebenen Regeltyp konfiguriert.
415		Nicht unterstützter Medientyp.
422	Semantisch ungültige Anforderung. Sie haben eine fehlerhafte Anforderung. Wenn Sie diesen Fehler empfangen, wenn Sie versuchen, ein neues Thema zu erstellen, kann dies auf die maximale Anzahl zulässiger Partitionen für Ihren Plan zurückzuführen sein. Weitere Informationen finden Sie unter Wie Event Streams Grenzwerte und Kontingente zum Überprüfen der Grenzwerte verwendet.
503	Service nicht verfügbar. Die Anforderung ist fehlgeschlagen, weil Event Streams-Broker nicht verfügbar sind. Bei der Bearbeitung der Anfrage ist ein Fehler aufgetreten. Der Service ist nicht verfügbar. Wenn dieser Fehler beim Erstellen eines neuen Themas fehlschlägt, überprüfen Sie die Grenzwerte und Kontingente.	Service nicht verfügbar. Die Anforderung ist fehlgeschlagen, weil Event Streams-Broker nicht verfügbar sind.

Die Kafka-API ist eine TCP-basierte API. Weitere Informationen zu den Fehlercodes finden Sie im Protokoll.

Kafka-Topic kann nicht erstellt werden

Wenn Sie keine Themen erstellen können, kann dies folgende Ursachen haben:

Sie verfügen nicht über die Verwaltungsrolle für den Cluster.
Es ist nicht genügend Plattenspeicherplatz verfügbar. Überprüfen Sie, wie der -Plattenspeicherplatz gemäß der Topickonfiguration reserviert ist. Um dieses Problem zu beheben, löschen Sie nicht verwendete Themen und aktualisieren Sie die Konfiguration retention.ms und retention.bytes des Themas, sodass sie kleiner sind. Skalieren Sie für die Enterprise-Instanz die Cluster. Weitere Informationen finden Sie unter Kapazität des Plans "Scaling Enterprise".

Fehler "Nachricht konnte nicht gesendet werden"

Ein Event Streams gibt einen Fehler zurück, und Sie können keine Ereignisse an es senden. Wenn Sie die Protokolle einsehen, lautet der Fehler "Nachricht konnte nicht gesendet werden", und der Eintrag enthält Informationen wie die folgende:

"Failed to send message", "error": "kafka server: Request was for a topic or partition that does not exist on this broker", "reason": "invalid_or_unreachable_topic"

Der Fehler kann auftreten, wenn das Thema nicht erstellt oder gelöscht wurde, oder wenn Sie Daten an einen Broker senden, der nicht der aktuelle Leader für die Themenpartition ist. Die Führung von Themenbereichen kann sich im Laufe der Zeit ändern, denn wenn ein Makler aus irgendeinem Grund offline ist, wird die Führung seiner Bereiche auf andere Makler übertragen, bis er sich wieder erholt.

Um das Problem zu lösen, überprüfen Sie, ob das Thema existiert. Bei korrekter Konfiguration aktualisiert der Kafka die Metadaten oder stellt die Verbindung zu einem anderen Broker schnell wieder her, so dass sich diese Art von Fehlersituation oft von selbst wieder einstellt. Wenn das Problem weiterhin besteht, wenden Sie sich an den Cloud-Support, um das Problem zu untersuchen.