Resolução de problemas do Event Streams

Use as dicas de solução de problemas para saber como solucionar problemas com IBM® Event Streams for IBM Cloud®.

Problemas relacionados à rede

Se você tiver um aplicativo Apache Kafka que não pode se conectar a um tópico ou não pode consumir ou produzir para um tópico devido a problemas de rede, ele poderá ser manifestado de maneiras diferentes.

Não é possível resolver o host Use nslookup ou dig para verificar se o endereço do broker pôde ser resolvido Se nslookup ou dig falhar, verifique o servidor DNS. Normalmente, o terminal público é resolvido para três IPs públicos, como nos exemplos a seguir:

$ 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

O terminal privado é resolvido para três IPs privados que começam com 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

Tempo limite de conexão. Use netcat (nc) para verificar a conectividade com o broker.
```
$ 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!
```
Um tempo limite do comando nc significa que a rede na qual seu aplicativo cliente está em execução não pôde se conectar aos endereços do broker Isso pode ser causado por vários motivos, como regras de firewall, políticas de rede do Calico e configuração de malha de serviço. Trabalhe com o administrador da rede para que o netcat funcione Se a instância de serviço estiver no plano Enterprise e o cluster tiver um terminal em serviço somente privado, verifique se os IPs do aplicativo cliente foram incluídos na lista de permissões de IP ou regras CBR. Para obter mais informações, consulte Restringindo o Acesso à Redes
Reconfiguração de conexão ou desconexão do cliente Isso pode não ser necessariamente um problema de rede, em vez de um problema de nível de aplicativo

Durante a janela de manutenção, os brokers e proxies são reiniciados de maneira contínua e o cliente Kafka pode ver uma exceção de desconexão. Com a configuração correta, o cliente Kafka se reconecta a um broker diferente imediatamente, para que a disponibilidade não seja afetada. Se o seu aplicativo tiver uma desconexão por um longo período de tempo, compartilhe a versão da biblioteca do cliente Kafka, a configuração do cliente e os logs com a depuração ativada e nós revisaremos e sugeriremos valores apropriados para configurar o cliente para ser resiliente à reinicialização do broker. Para bibliotecas do cliente Kafka suportadas, consulte a lista de clientes recomendados.

Se o problema ainda persistir, levante um chamado de suporte para uma investigação adicional

Códigos de erro HTTP para APIs REST e como corrigi-los

Os códigos de erro HTTP se aplicam às APIs REST, incluindo Admin REST, REST Producer e Schema Registry.

Códigos de erro HTTP para APIs REST e como corrigi-los
Código de erro de HTTP	REST do administrador	Produtor REST	Registro de esquema
400	Solicitação inválida-não é uma solicitação válida Corrija a sua solicitação	Solicitação inválida-não é uma solicitação válida Esse erro pode ser causado por uma carga útil malformada ou um tipo de chave não suportado ou um tamanho de chave / mensagem excedido.	Solicitação inválida-não é uma solicitação válida Corrija a sua solicitação
403	Não autorizado a realizar a operação. A chave API usada não possui uma determinada função. O ID usado para criar a chave de recursos não tem uma política do IAM. Para obter mais informações, consulte Gerenciando a autenticação para suas instâncias do Event Streams	Proibido. O token fornecido não tem permissões suficientes para produzir para um tópico. Verifique se você forneceu o token com a função de acesso necessária Para obter mais informações, consulte Gerenciando a autenticação para suas instâncias do Event Streams	Proibido. O cliente não está autorizado a realizar essa solicitação. O ID de serviço não está autorizado a acessar um recurso de esquema Para obter mais informações, consulte Gerenciando a autenticação para suas instâncias do Event Streams
404	Não localizado. Não é possível localizar o tópico com o nome do tópico especificado. Event Streams configurado `auto.create.topics.enable` como `false`, portanto, o tópico deve ser criado explicitamente antes de usá-lo.	Não localizado. O tópico não existe.. Event Streams configurado `auto.create.topics.enable` como `false`, portanto, o tópico deve ser criado explicitamente antes de produzir a mensagem para ele.	Não localizado. O registro não contém um esquema com o ID de esquema especificado ou o esquema identificado pelo ID de esquema não contém uma versão correspondente ao número da versão especificado ou o esquema não está configurado com o tipo especificado de regra..
415		Tipo de mídia não suportado.
422	Solicitação semântica inválida Você tem uma solicitação malformada Se você receber esse erro ao tentar criar um novo tópico, ele poderá ser devido ao número máximo de partições permitidas para seu plano Para obter mais informações, consulte Como o Event Streams usa limites e quotas para verificar os limites.
503	Serviço indisponível. A solicitação falhou porque os brokers Event Streams estão indisponíveis. Ocorreu um erro ao processar a solicitação. O serviço está indisponível. Se você receber esse erro ao criar um novo tópico falhar, verifique os limites e cotas.	Serviço indisponível. A solicitação falhou porque os brokers Event Streams estão indisponíveis.

A API do Kafka é uma API baseada em TCP Para obter mais informações, consulte seu guia de protocolo em relação aos códigos de erros

Não é possível criar um tópico Kafka

Se não for possível criar tópicos, isso pode ser devido às seguintes razões:

Você não tem a função de Administração no cluster
O espaço em disco é insuficiente Verifique como o espaço em disco do é reservado de acordo com a configuração do tópico Para resolver esse problema, exclua tópicos não utilizados e atualize a configuração do tópico retention.ms e retention.bytes para ser menor. Para a instância Enterprise, escale os clusters. Para obter mais informações, consulte Capacidade do plano Enterprise de ajuste de escala

Erro "Falha ao enviar mensagem"

Um alvo Event Streams retorna um erro e você não consegue enviar eventos para ele. Quando você visualiza os logs, o erro é "Failed to send message" (Falha ao enviar mensagem) e a entrada contém informações como as seguintes:

"Falha ao enviar mensagem", "error": "servidor kafka: A solicitação era para um tópico ou partição que não existe neste corretor", "reason": "invalid_or_unreachable_topic"

O erro pode ocorrer se o tópico não tiver sido criado ou tiver sido excluído, ou se você estiver enviando dados para um corretor que não seja o líder atual da partição do tópico. A liderança das partições de tópicos pode mudar ao longo do tempo, pois se um broker estiver off-line por qualquer motivo, a liderança de suas partições será transferida para outros brokers até que ele se recupere.

Para resolver o problema, verifique se o tópico existe. Com a configuração correta, o cliente Kafka atualiza os metadados ou se reconecta a um corretor diferente rapidamente, de modo que esse tipo de situação de erro geralmente se recupera por conta própria. Se o problema persistir, entre em contato com o Cloud Support para investigar o problema.