Traitement des incidents liés à Event Streams

Utilisez les conseils de dépannage pour apprendre comment résoudre les problèmes avec IBM® Event Streams for IBM Cloud®

Problèmes liés au réseau

Si vous disposez d'une application Apache Kafka qui ne parvient pas à se connecter à une rubrique ou qui ne peut pas être utilisée ou produite à partir d'une rubrique en raison de problèmes réseau, elle peut se manifester de différentes manières.

Impossible de résoudre l'hôte. Utilisez nslookup ou dig pour vérifier si l'adresse du courtier peut être résolue. Si nslookup ou dig échoue, vérifiez votre serveur DNS. Normalement, le noeud final public se résout en trois adresses IP publiques, comme dans les exemples suivants.

$ 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

Le noeud final privé se résout en trois adresses IP privées qui commencent par 166.9.

$ 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

Expiration de connexion. Utilisez netcat (nc) pour vérifier la connectivité au courtier.
```
$ 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!
```
Un délai d'attente de commande nc signifie que le réseau sur lequel votre application client est en cours d'exécution n'a pas pu se connecter aux adresses de courtier. Cela peut être dû à un certain nombre de raisons, telles que les règles de pare-feu, les règles réseau calico et la configuration du maillage de service. Travaillez avec votre administrateur réseau pour que netcat fonctionne. Si l'instance de service se trouve dans le plan Enterprise et que le cluster possède un noeud final de service privé uniquement, vérifiez si les adresses IP de votre application client ont été ajoutées à la liste autorisée d'adresses IP ou aux règles CBR. Pour plus d'informations, voir Restriction de l'accès au réseau.
Réinitialisation de la connexion ou client déconnecté. Il ne s'agit pas nécessairement d'un problème réseau, mais d'un problème au niveau de l'application.

Pendant la fenêtre de maintenance, les courtiers et les proxys sont redémarrés en continu et le client Kafka peut voir une exception de déconnexion. Avec la configuration correcte, le client Kafka se reconnecte immédiatement à un autre courtier, de sorte que la disponibilité n'est pas affectée. Si votre application est déconnectée pendant une période prolongée, partagez la version de la bibliothèque client Kafka, la configuration du client et les journaux avec le débogage activé. Nous allons examiner et suggérer les valeurs appropriées pour configurer le client de sorte qu'il soit résilient au redémarrage du courtier. Pour les bibliothèques client Kafka prises en charge, reportez-vous à la liste des clients recommandés.

Si le problème persiste, générez un ticket de demande de service pour un examen plus approfondi.

Codes d'erreur HTTP pour les API REST et comment les corriger

Les codes d'erreur HTTP s'appliquent aux API REST, y compris Admin REST, REST Producer et Schema Registry.

Codes d'erreur HTTP pour les API REST et comment les corriger
Code d'erreur HTTP	REST d'administration	Producteur REST	Registre de schémas
400	Demande incorrecte-demande non valide. Corrigez votre demande.	Demande incorrecte-demande non valide. Cette erreur peut être due à un contenu syntaxiquement incorrect, à un type de clé non pris en charge ou à un dépassement de la taille de la clé / du message.	Demande incorrecte-demande non valide. Corrigez votre demande.
403	Non autorisé à effectuer l'opération. Un certain rôle est manquant dans la clé d'API utilisée. L'ID qui a été utilisé pour créer la clé de ressource ne possède pas de règle IAM. Pour plus d'informations, voir Gestion de l'authentification auprès de vos instances Event Streams.	Interdit. Le jeton que vous avez fourni ne dispose pas des droits suffisants pour générer une rubrique. Vérifiez si vous avez fourni le jeton avec le rôle d'accès requis. Pour plus d'informations, voir Gestion de l'authentification auprès de vos instances Event Streams.	Interdit. Le client n'est pas autorisé à effectuer cette demande. L'ID de service n'est pas autorisé à accéder à une ressource de schéma. Pour plus d'informations, voir Gestion de l'authentification auprès de vos instances Event Streams.
404	Introuvable. Impossible de trouver la rubrique avec le nom de rubrique que vous avez spécifié. Event Streams a pour valeur `auto.create.topics.enable` `false`; par conséquent, la rubrique doit être explicitement créée avant de l'utiliser.	Introuvable. La rubrique n'existe pas. Event Streams a pour valeur `auto.create.topics.enable` `false`; par conséquent, la rubrique doit être explicitement créée avant de générer un message.	Introuvable. Soit le registre ne contient pas de schéma avec l'ID de schéma spécifié, soit le schéma identifié par l'ID de schéma ne contient pas de version correspondant au numéro de version spécifié, soit le schéma n'est pas configuré avec le type de règle spécifié.
415		Type de la valeur Media non valide.
422	Demande non valide d'un point de vue sémantique. Votre demande est syntaxiquement incorrecte. Si vous recevez cette erreur lorsque vous tentez de créer une nouvelle rubrique, cela peut être dû au nombre maximal de partitions autorisées pour votre plan. Pour plus d'informations, voir Comment Event Streams utilise les limites et les quotas pour vérifier les limites.
503	Service indisponible. La demande a échoué en raison de l'indisponibilité des courtiers Event Streams. Une erreur s'est produite lors du traitement de la demande. Le service n'est pas disponible. Si vous recevez cette erreur lors de l'échec de la création d'une rubrique, vérifiez les limites et les quotas.	Service indisponible. La demande a échoué en raison de l'indisponibilité des courtiers Event Streams.

L'API Kafka est une API TCP. Pour plus d'informations, reportez-vous à son guide de protocole concernant les codes d'erreur.

Impossible de créer une rubrique Kafka

Si vous ne parvenez pas à créer des rubriques, cela peut être dû aux raisons suivantes:

Vous ne disposez pas du rôle Administration sur le cluster.
L'espace disque est insuffisant. Vérifiez comment l'espace disque est réservé en fonction de la configuration de rubrique. Pour résoudre ce problème, supprimez les rubriques inutilisées et mettez à jour la configuration de rubrique retention.ms et retention.bytes pour qu'elles soient plus petites. Pour l'instance Enterprise, mettez à l'échelle les clusters. Pour plus d'informations, voir Mise à l'échelle de la capacité du plan Enterprise.

Erreur "Échec de l'envoi du message"

Une cible Event Streams renvoie une erreur et vous ne pouvez pas lui envoyer d'événements. Lorsque vous consultez les journaux, l'erreur est "Échec de l'envoi du message" et l'entrée contient des informations telles que les suivantes :

"Échec de l'envoi du message", "error" : "serveur kafka : Request was for a topic or partition that does not exist on this broker", "reason" : "invalid_or_unreachable_topic"

L'erreur peut se produire si le sujet n'a pas été créé ou a été supprimé, ou si vous envoyez des données à un courtier qui n'est pas le leader actuel de la partition du sujet. La direction des partitions d'un thème peut changer au fil du temps, car si un courtier est hors ligne pour une raison quelconque, la direction de ses partitions est confiée à d'autres courtiers jusqu'à ce qu'il se rétablisse.

Pour résoudre le problème, vérifiez que le sujet existe. Avec une configuration correcte, le client Kafka rafraîchit les métadonnées ou se reconnecte rapidement à un autre courtier, de sorte que ce type d'erreur se résorbe souvent de lui-même. Si le problème persiste, contactez le service d'assistance Cloud pour qu'il étudie le problème.