Resolución de problemas de Event Streams

Utilice los consejos de solución de problemas para aprender a solucionar problemas con IBM® Event Streams for IBM Cloud®.

Problemas relacionados con la red

Si tiene una aplicación Apache Kafka que no puede conectarse a un tema o no puede consumir desde o producir en un tema debido a problemas de red, podría manifestarse de diferentes maneras.

No se puede resolver el host. Utilice nslookup o dig para comprobar si se ha podido resolver la dirección del intermediario. Si nslookup o dig falla, compruebe el servidor DNS. Normalmente, el punto final público se resuelve en tres IP públicas, como en los ejemplos siguientes.

$ 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

El punto final privado se resuelve en tres IP privadas que empiezan por 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

Tiempo de espera excedido de la conexión. Utilice netcat (nc) para comprobar la conectividad con el intermediario.
```
$ 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 tiempo de espera de mandato nc significa que la red en la que se ejecuta la aplicación cliente no se ha podido conectar a las direcciones de intermediario. Puede deberse a una serie de razones, como las reglas de cortafuegos, las políticas de red de calico y la configuración de malla de servicios. Trabaje con el administrador de red para que funcione netcat. Si la instancia de servicio está en el plan Enterprise y el clúster tiene un punto final de servicio solo privado, compruebe si las IP de la aplicación cliente se han añadido a la lista de IP permitidas o a las reglas CBR. Para obtener más información, consulte Restricción del acceso a la red.
Se ha restablecido la conexión o se ha desconectado el cliente. Esto puede no ser necesariamente un problema de red, en lugar de un problema de nivel de aplicación.

Durante la ventana de mantenimiento, los intermediarios y proxies se reinician de forma continua y el cliente Kafka puede ver la excepción de desconexión. Con la configuración correcta, el cliente Kafka se vuelve a conectar a un intermediario diferente inmediatamente, para que la disponibilidad no se vea afectada. Si la aplicación experimenta una desconexión durante un periodo de tiempo prolongado, comparta la versión de biblioteca de cliente Kafka, la configuración de cliente y los registros con la depuración habilitada, y revisaremos y sugeriremos los valores adecuados para configurar el cliente para que sea resistente al reinicio del intermediario. Para las bibliotecas de cliente Kafka soportadas, consulte la lista de clientes recomendados.

Si el problema persiste, emita una incidencia de soporte para realizar una investigación adicional.

Códigos de error HTTP de las API REST y cómo solucionarlos

Los códigos de error HTTP se aplican a las API REST, incluidas Admin REST, REST Producer y Schema Registry.

Códigos de error HTTP de las API REST y cómo solucionarlos
Código de error HTTP	REST de administrador	Productor REST	Registro de esquemas
400	Solicitud errónea-no es una solicitud válida. Corrija la solicitud.	Solicitud errónea-no es una solicitud válida. Este error puede deberse a una carga útil mal formada o a un tipo de clave no soportado o a un tamaño de clave/mensaje excedido.	Solicitud errónea-no es una solicitud válida. Corrija la solicitud.
403	No autorizado para realizar la operación. A la clave de API utilizada le falta un rol determinado. El ID que se ha utilizado para crear la clave de recurso no tiene una política de IAM. Para obtener más información, consulte Gestión de la autenticación en las instancias de Event Streams.	Prohibido. La señal que ha proporcionado no tiene permisos suficientes para producir en un tema. Compruebe si ha proporcionado la señal con el rol de acceso necesario. Para obtener más información, consulte Gestión de la autenticación en las instancias de Event Streams.	Prohibido. El cliente no está autorizado a realizar esta solicitud. El ID de servicio no está autorizado para acceder a un recurso de esquema. Para obtener más información, consulte Gestión de la autenticación en las instancias de Event Streams.
404	No encontrado. No se ha podido encontrar el tema con el nombre de tema que ha especificado. Event Streams establezca `auto.create.topics.enable` en `false`, por lo tanto, el tema se debe crear explícitamente antes de utilizarlo.	No encontrado. El tema no existe. Event Streams establezca `auto.create.topics.enable` en `false`, por lo que el tema se debe crear explícitamente antes de generar un mensaje en él.	No encontrado. El registro no contiene un esquema con el ID de esquema especificado, o el esquema identificado por el ID de esquema no contiene una versión correspondiente al número de versión especificado, o el esquema no está configurado con el tipo de regla especificado.
415		Tipo de soporte no soportado.
422	Solicitud no válida semánticamente. Tiene una solicitud mal formada. Si recibe este error al intentar crear un tema nuevo, puede deberse al número máximo de particiones permitidas para el plan. Para obtener más información, consulte Cómo Event Streams utiliza límites y cuotas para verificar los límites.
503	Servicio no disponible. La solicitud ha fallado debido a que los intermediarios de Event Streams no están disponibles. Se ha producido un error al procesar la solicitud. El servicio no está disponible. Si recibe este error al crear un nuevo tema falla, verifique los límites y cuotas.	Servicio no disponible. La solicitud ha fallado debido a que los intermediarios de Event Streams no están disponibles.

La API Kafka es una API basada en TCP. Para obtener más información, consulte su guía de protocolo en relación con los códigos de error.

No se puede crear un tema Kafka

Si no puede crear temas, puede deberse a las razones siguientes:

No tiene el rol de administración de en el clúster.
No hay suficiente espacio de disco. Compruebe cómo se reserva el espacio de disco de de acuerdo con la configuración del tema. Para resolver este problema, suprima los temas no utilizados y actualice la configuración del tema retention.ms y retention.bytes para que sea más pequeña. Para la instancia Enterprise, escale los clústeres. Para obtener más información, consulte Scaling Enterprise plan capacity.

Error "Error al enviar el mensaje"

Un destino Event Streams devuelve un error y no puedes enviarle eventos. Al ver los registros, el error es "Error al enviar mensaje", y la entrada contiene información como la siguiente:

"No se ha podido enviar el mensaje", "error": "servidor kafka: Request was for a topic or partition that does not exist on this broker", "reason": "tema_no_válido_o_no_alcanzable"

El error puede producirse si el tema no se ha creado o se ha eliminado, o si está enviando datos a un agente que no es el líder actual de la partición del tema. El liderazgo de las particiones temáticas puede cambiar con el tiempo, ya que si un corredor se desconecta por cualquier motivo, el liderazgo de sus particiones se traslada a otros corredores hasta que se recupere.

Para resolver el problema, compruebe que el tema existe. Con la configuración correcta, el cliente Kafka refresca los metadatos o se reconecta a un broker diferente rápidamente, de modo que este tipo de situación de error suele recuperarse por sí sola. Si el problema persiste, póngase en contacto con Cloud Support para investigar el problema.