Risoluzione dei problemi Event Streams

Utilizza i suggerimenti per la risoluzione dei problemi per imparare a risolvere i problemi con IBM® Event Streams for IBM Cloud®.

Problemi relativi alla rete

Se disponi di un'applicazione Apache Kafka che non è in grado di connettersi a un argomento o di utilizzare o produrre da un argomento a causa di problemi di rete, potrebbe essere manifestata nei seguenti modi diversi.

Impossibile risolvere l'host. Utilizzare nslookup o dig per verificare se è possibile risolvere l'indirizzo del broker. Se nslookup o dig ha esito negativo, controlla il tuo server DNS. Normalmente, l'endpoint pubblico si risolve in tre IP pubblici, come nei seguenti esempi.

$ 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

L'endpoint privato viene risolto in tre IP privati che iniziano con 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

Timeout di connessione. Utilizzare netcat (nc) per verificare la connettività al 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!
```
Un timeout del comando nc indica che la rete in cui è in esecuzione l'applicazione client non è riuscita a connettersi agli indirizzi del broker. Potrebbe essere causato da una serie di motivi, come le regole del firewall, le politiche di rete calico e la configurazione della mesh del servizio. Rivolgersi all'amministratore di rete per ottenere il funzionamento di netcat. Se l'istanza del servizio si trova sul piano Enterprise e il cluster ha un endpoint del servizio solo privato, controlla se gli IP della tua applicazione client sono stati aggiunti all'elenco di IP consentiti o alle regole CBR. Per ulteriori informazioni, vedi Limitazione dell'accesso alla rete.
Reimpostazione della connessione o client disconnesso. Questo potrebbe non essere necessariamente un problema di rete, piuttosto che un problema a livello di applicazione.

Durante la finestra di manutenzione, i broker e i proxy vengono riavviati in modo continuativo e il client Kafka potrebbe visualizzare un'eccezione di disconnessione. Con la corretta configurazione, il client Kafka si riconnette immediatamente a un broker differente, in modo che la disponibilità non venga influenzata. Se la tua applicazione riscontra una disconnessione per un periodo di tempo prolungato, condividi la versione della libreria client Kafka, la configurazione client e i log con il debug abilitato e riesamineremo e suggeriremo i valori appropriati per configurare il client in modo che sia resiliente al riavvio del broker. Per le librerie client Kafka supportate, fai riferimento all'elenco di client consigliati.

Se il problema persiste ancora, genera un ticket di assistenza per ulteriori indagini.

Codici di errore HTTP per le API REST e come risolverli

I codici di errore HTTP si applicano alle API REST, comprese Admin REST, REST Producer e Schema Registry.

Codici di errore HTTP per le API REST e come risolverli
Codice errore HTTP	REST amministratore	Produttore REST	Registro schema
400	Richiesta errata - non è una richiesta valida. Correggere la richiesta.	Richiesta errata - non è una richiesta valida. Questo errore potrebbe essere causato da un payload non corretto, da un tipo di chiave non supportato o da una dimensione di chiave / messaggio superata.	Richiesta errata - non è una richiesta valida. Correggere la richiesta.
403	Non è autorizzato a eseguire l'operazione. Alla chiave API utilizzata manca un determinato ruolo. L'ID utilizzato per creare la chiave della risorsa non ha una politica IAM. Per ulteriori informazioni, vedi Gestione dell'autenticazione per le tue istanze Event Streams.	Non consentito. Il token fornito non dispone di autorizzazioni sufficienti per produrre un argomento. Verificare se il token è stato fornito con il ruolo di accesso richiesto. Per ulteriori informazioni, vedi Gestione dell'autenticazione per le tue istanze Event Streams.	Non consentito. Il cliente non è autorizzato a eseguire questa richiesta. L'ID servizio non è autorizzato ad accedere a una risorsa dello schema. Per ulteriori informazioni, vedi Gestione dell'autenticazione per le tue istanze Event Streams.
404	Non trovato. Impossibile trovare l'argomento con il nome specificato. Event Streams impostato `auto.create.topics.enable` su `false`, quindi l'argomento deve essere creato esplicitamente prima di utilizzarlo.	Non trovato. L'argomento non esiste. Event Streams impostato `auto.create.topics.enable` su `false`, quindi l'argomento deve essere esplicitamente creato prima di produrre un messaggio.	Non trovato. Il registro non contiene uno schema con l'ID schema specificato, oppure lo schema identificato dall'ID schema non contiene una versione corrispondente al numero di versione specificato, oppure lo schema non è configurato con il tipo di regola specificato.
415		Tipo media non supportato.
422	Richiesta semanticamente non valida. Si dispone di una richiesta non corretta. Se si riceve questo errore quando si tenta di creare un nuovo argomento, potrebbe essere dovuto al numero massimo di partizioni consentite per il piano. Per ulteriori informazioni, consultare In che modo Event Streams utilizza i limiti e le quote per la verifica dei limiti.
503	Servizio non disponibile. La richiesta ha avuto esito negativo perché i broker Event Streams non sono disponibili. Si è verificato un errore durante la gestione della richiesta. Il servizio non è disponibile. Se si riceve questo errore quando la creazione di un nuovo argomento non riesce, verificare i limiti e le quote.	Servizio non disponibile. La richiesta ha avuto esito negativo perché i broker Event Streams non sono disponibili.

L'API Kafka è un'API basata su TCP. Per ulteriori informazioni, consultare la relativa guida del protocollo relativa ai codici di errore.

Impossibile creare un topic Kafka

Se non è possibile creare argomenti, ciò potrebbe essere dovuto ai seguenti motivi:

Non si dispone del ruolo Amministrazione sul cluster.
Spazio su disco insufficiente. Verificare il modo in cui lo spazio su disco è riservato in base alla configurazione dell'argomento. Per risolvere questo problema, eliminare gli argomenti inutilizzati e aggiornare la configurazione dell'argomento retention.ms e retention.bytes in modo che siano più piccoli. Per l'istanza Enterprise, ridimensiona i cluster. Per ulteriori informazioni, vedi Ridimensionamento della capacità del piano Enterprise.

Errore "Fallito l'invio del messaggio"

Un target Event Streams restituisce un errore e non è possibile inviargli eventi. Quando si visualizzano i registri, l'errore è "Failed to send message" e la voce contiene informazioni come le seguenti:

"Fallito l'invio del messaggio", "errore": "Server kafka: La richiesta era per un argomento o una partizione che non esiste su questo broker", "motivo": "argomento_invalido_o_irraggiungibile"

L'errore può verificarsi se l'argomento non è stato creato o è stato cancellato, oppure se si stanno inviando dati a un broker che non è l'attuale leader della partizione dell'argomento. La leadership delle partizioni degli argomenti può cambiare nel tempo, perché se un broker è offline per qualsiasi motivo, la leadership delle sue partizioni viene spostata ad altri broker finché non si riprende.

Per risolvere il problema, verificare che l'argomento esista. Con la configurazione corretta, il client Kafka aggiorna i metadati o si ricollega rapidamente a un broker diverso, in modo che questo tipo di errore spesso si risolva da solo. Se il problema persiste, contattare l'Assistenza Cloud per un'analisi del problema.