Risoluzione degli errori relativi allo strumento di mappatura dell'origine degli eventi di Apache Kafka autogestito
Negli argomenti seguenti vengono forniti suggerimenti per la risoluzione dei problemi relativi a errori e problemi che potrebbero verificarsi durante l'utilizzo di Amazon MSK o Apache Kafka autogestito con Lambda.
Per ulteriori informazioni sulla risoluzione dei problemi, visita il Knowledge Center AWS
Errori di autenticazione e autorizzazione
Se manca una delle autorizzazioni necessarie per l'utilizzo dei dati dal cluster Kafka, Lambda visualizza un messaggio di errore nella mappatura della fonte evento in LastProcessingResult.
Messaggi di errore
Il cluster non è riuscito ad autorizzare Lambda
Per SASL/SCRAM o mTLS, questo errore indica che l'utente fornito non dispone di tutte le seguenti autorizzazioni della lista di controllo accessi Kafka (ACL) richieste:
-
Cluster DescribeConfigs
-
Descrivi il gruppo
-
Leggi il gruppo
-
Descrivi l'argomento
-
Leggi l'argomento
Quando si crea ACL Kafka con le autorizzazioni kafka-cluster richieste, è necessario specificare l'argomento e il gruppo come risorse. Il nome dell'argomento deve corrispondere all'argomento nella mappatura dell'origine eventi. Il nome del gruppo deve corrispondere all'UUID della mappatura dell'origine eventi.
Dopo avere aggiunto le autorizzazioni richieste al ruolo di esecuzione, potrebbero essere necessari alcuni minuti affinché le modifiche entrino in vigore.
Autenticazione SASL non riuscita
Per SASL/SCRAM o SASL/PLAIN, questo errore indica che le credenziali di accesso fornite non sono valide.
Per il controllo accessi IAM, al ruolo di esecuzione manca l'autorizzazione kafka-cluster:Connect per il cluster MSK. Aggiungi questa autorizzazione al ruolo e specifica l'Amazon Resource Name (ARN) del cluster come risorsa.
Potresti visualizzare questo errore in modo intermittente. Il cluster rifiuta le connessioni dopo che il numero di connessioni TCP supera la quota del servizio Amazon MSK. Lambda cessa e ritenta finché una connessione non ha esito positivo. Dopo che Lambda si connette al cluster e ha eseguito il polling dei registri, l'ultimo risultato di elaborazione cambia in OK.
Il server non è riuscito ad autenticare Lambda
Questo errore indica che il broker Kafka non è riuscito ad autenticare Lambda. Questo errore può verificarsi per uno dei seguenti motivi:
Non è stato fornito un certificato client per l'autenticazione mTLS.
È stato fornito un certificato client, ma i broker Kafka non sono configurati per l'utilizzo dell'autenticazione mTLS.
Un certificato client non è attendibile per i broker Kafka.
Lambda non è riuscita ad autenticare il server
Questo errore indica che Lambda non è riuscita ad autenticare il broker Kafka. Questo errore può verificarsi per uno dei seguenti motivi:
I broker Kafka utilizzano certificati autofirmati o una CA privata, ma non hanno fornito il certificato CA root del server.
Il certificato CA root del server non corrisponde alla CA root che ha firmato il certificato del broker.
La convalida del nome host non è riuscita perché il certificato del broker non contiene il nome DNS o l'indirizzo IP del broker come nome alternativo dell'oggetto.
Il certificato o la chiave privata forniti non sono validi
Questo errore indica che il consumatore Kafka non ha potuto utilizzare il certificato o la chiave privata fornita. Assicurati che il certificato e la chiave utilizzino il formato PEM e che la crittografia della chiave privata utilizzi un algoritmo PBES1.
Errori della mappatura dell'origine eventi
Quando aggiungi il cluster Apache Kafka come origine eventi per la funzione Lambda, se la funzione rileva un errore, il consumer Kafka arresta l'elaborazione dei record. I consumatori di uno shard dell'argomento sono quelli che sottoscrivono, leggono ed elaborano i record. Gli altri consumatori Kafka possono continuare a elaborare i record, a condizione che non riscontrino lo stesso errore.
Per determinare la causa di un consumatore interrotto, controlla il campo StateTransitionReason nella risposta di EventSourceMapping. Nell'elenco seguente vengono descritti gli errori dell'origine eventi che è possibile ricevere:
ESM_CONFIG_NOT_VALID-
La configurazione della mappatura della fonte evento non è valida.
EVENT_SOURCE_AUTHN_ERROR-
Lambda non ha potuto autenticare la fonte evento.
EVENT_SOURCE_AUTHZ_ERROR-
Lambda non dispone delle autorizzazioni necessarie per accedere alla fonte evento.
FUNCTION_CONFIG_NOT_VALID-
La configurazione della funzione non è valida.
Nota
Se i record degli eventi Lambda superano il limite di dimensione consentito di 6 MB, potrebbero non venire elaborati.
