

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Configurazione di origini eventi Apache Kafka autogestito per Lambda

Per utilizzare un cluster Apache Kafka autogestito come origine di eventi per la tua Lambda Event Function, crei un [mappatura dell'origine degli eventi](invocation-eventsourcemapping.md) che collega le due risorse. Questa pagina descrive come creare una mappatura dell'origine degli eventi per Apache Kafka autogestito.

Questa pagina presuppone che tu abbia già configurato correttamente il cluster Kafka e la rete in cui risiede. Se devi configurare il tuo cluster o la tua rete, consulta [Configurazione del cluster e della rete Apache Kafka autogestiti per Lambda](with-kafka-cluster-network.md).

**Topics**
+ [Utilizzo di un cluster Apache Kafka autogestito come origine di eventi](#kafka-esm-overview)
+ [Configurazione dei metodi di autenticazione del cluster in Lambda](kafka-cluster-auth.md)
+ [Creazione di una mappatura della sorgente di eventi Lambda per una sorgente di eventi Apache Kafka autogestita](kafka-esm-create.md)
+ [Tutti i parametri di configurazione dell'origine degli eventi di Apache Kafka autogestiti in Lambda](kafka-esm-parameters.md)

## Utilizzo di un cluster Apache Kafka autogestito come origine di eventi
<a name="kafka-esm-overview"></a>

Quando aggiungi il tuo cluster Apache Kafka o Amazon MSK come trigger per la tua Lambda Event Function, il cluster viene utilizzato come [fonte dell'evento](invocation-eventsourcemapping.md).

Lambda legge i dati degli eventi dagli argomenti di Kafka specificati come `Topics` in un [CreateEventSourceMapping](https://docs.aws.amazon.com/lambda/latest/api/API_CreateEventSourceMapping.html) richiesta, in base alla [posizione di partenza](kafka-starting-positions.md) che specifichi. Dopo che l'elaborazione è avvenuta con successo, l'argomento Kafka viene salvato nel cluster Kafka.

Lambda legge i messaggi in sequenza per ogni partizione dell'argomento Kafka. Un singolo payload Lambda può contenere messaggi provenienti da più partizioni. Quando sono disponibili più record, Lambda continua a elaborare i record in batch, in base a BatchSize valore specificato in a [CreateEventSourceMapping](https://docs.aws.amazon.com/lambda/latest/api/API_CreateEventSourceMapping.html) richiesta, finché la tua funzione non raggiungerà l'argomento.

Dopo che Lambda ha elaborato ogni batch, esegue il commit degli offset dei messaggi in quel batch. Se la funzione restituisce un errore per uno qualsiasi dei messaggi di un batch, Lambda ritenta l'intero batch di messaggi fino a quando l'elaborazione non riesce o i messaggi scadono. È possibile inviare i record per i quali tutti i nuovi tentativi falliscono a una destinazione in errore per un'elaborazione successiva.

**Nota**  
Mentre le Lambda Event Functions hanno in genere un limite massimo di timeout di 15 minuti, le mappature delle sorgenti di eventi per Amazon MSK, Apache Kafka, Amazon DocumentDB e Amazon MQ autogestiti per ActiveMQ e RabbitMQ supportano solo funzioni con limiti di timeout massimi di 14 minuti.