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à.
# Utilizzare i log di flusso per monitorare gli eventi nei flussi di Amazon Connect
Amazon Connect i log di flusso forniscono dettagli in tempo reale sugli eventi nei flussi man mano che i clienti interagiscono con essi. È possibile utilizzare questi log di flusso anche per eseguire il debug dei flussi durante la fase di creazione. Se necessario, è sempre possibile eseguire il [rollback ](flow-version-control.md#rollback)a una versione precedente di un flusso.
Di seguito è riportata una panoramica della registrazione di log per i flussi e delle interazioni con i bot.
+ **Registri di flusso archiviati in un CloudWatch gruppo**. Utilizza questi log per identificare i colli di bottiglia nella progettazione dei flussi, risolvere i problemi relativi ai flussi in tempo reale e analizzare i modelli di percorso dei clienti.
I log di flusso consentono di monitorare i clienti tra flussi diversi includendo l’ID del contatto in ogni voce di log. È possibile interrogare i log per l'ID di contatto e rintracciare l'interazione del cliente attraverso ogni flusso di contatto.
Il log di CloudWatch gruppo viene creato automaticamente quando viene selezionata l'opzione [Abilita registrazione del flusso](contact-flow-logs.md#enable-contact-flow-logs) per la tua istanza sulla console Amazon Connect. Per abilitare la registrazione di log, tuttavia, è necessario anche aggiungere un blocco **Imposta comportamento log**. Per istruzioni, consulta [Abilita i log di flusso di Amazon Connect in un gruppo di CloudWatch log Amazon](contact-flow-logs.md).
+ **Log di interazione automatica**. Utilizza questi log per analizzare la qualità delle conversazioni tra clienti e bot, comprendere le domande più comuni dei clienti e migliorare le risposte del bot.
Questi log vengono salvati in un bucket S3 che viene creato quando [selezioni](monitor-automated-interaction-logs.md) le seguenti opzioni per la tua istanza nella console Amazon Connect:
+ **Abilita registrazione chiamata** e crea o seleziona un bucket S3 nella pagina **Archiviazione dei dati**. Il log delle interazioni automatiche viene archiviato nella stessa posizione in S3 in cui si trova la registrazione della chiamata.
+ **Abilita log di interazione automatica** nella pagina **Flussi**. Questa opzione consente la registrazione di log per i punti di interazione chiave come flussi, prompt, menu e selezioni da tastiera. Questo registro automatico è disponibile nello storage S3 e nella pagina dei **dettagli di contatto** sul sito Web di Amazon Connect amministrazione.
+ **Abilita l’analisi e le trascrizioni dei bot** in Amazon Connect nella pagina **Flussi**. Questa opzione assicura che il log includa la trascrizione del bot di Amazon Lex.
**Topics**
+ [Archiviazione per i log di flusso](contact-flow-logs-stored-in-cloudwatch.md)
+ [Abilitazione di log di flusso](contact-flow-logs.md)
+ [Ricerca di log di flusso](search-contact-flow-logs.md)
+ [Dati nei log di flusso](contact-flow-log-data.md)
+ [Tenere traccia dei clienti tra più flussi nel contact center](contact-flow-log-multiple-flows.md)
+ [Creare avvisi per eventi di log di flusso](contact-flow-log-alerts.md)
+ [Monitorare le interazioni automatiche (IVR)](monitor-automated-interaction-logs.md)
# Registri di flusso archiviati in un gruppo di Amazon CloudWatch log
I log di flusso vengono archiviati in un gruppo di Amazon CloudWatch log, nella stessa AWS regione dell'istanza. Amazon Connect Questo gruppo di log viene creato automaticamente quando l'opzione [Abilita registrazione di log di flusso](contact-flow-logs.md#enable-contact-flow-logs) è attivata per l'istanza.
Ad esempio, l'immagine seguente mostra i gruppi di CloudWatch log per due istanze di test.
![\[La CloudWatch console Amazon, i gruppi di log,/aws/connect/mytest88 e mytest89.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/cloudwatch-log-group.png)
Una voce di log viene aggiunta ogni volta che viene attivato un blocco nel flusso. Puoi configurare l'invio CloudWatch di avvisi quando si verificano eventi imprevisti durante i flussi attivi.
**Cosa succede se il mio gruppo di log viene eliminato?** È necessario ricreare manualmente il gruppo di CloudWatch log. Altrimenti, Amazon Connect non pubblicherà altri registri.
## Prezzi per la registrazione di log di flusso
Non vengono applicati addebiti per la generazione di log di flusso, ma vengono addebitati per l'utilizzo di CloudWatch per generare e archiviare i log. Ai clienti del piano gratuito viene addebitato solo l'importo per l'utilizzo che supera le Service Quotas. Per informazioni dettagliate sui Amazon CloudWatch prezzi, consulta [Amazon CloudWatch Prezzi](https://aws.amazon.com/cloudwatch/pricing/).
# Abilita i log di flusso di Amazon Connect in un gruppo di CloudWatch log Amazon
Per impostazione predefinita, quando crei una nuova istanza Amazon Connect, viene creato automaticamente un gruppo di CloudWatch log Amazon per archiviare i log dell'istanza.
**Suggerimento**
Amazon Connect fornisce i log di flusso almeno una volta. Possono essere nuovamente consegnati per diversi motivi. Ad esempio, un nuovo tentativo di assistenza a causa di un errore inevitabile.
## Passaggio 1: abilitazione della registrazione di log per l'istanza
Utilizza la procedura seguente per verificare che la registrazione di log sia abilitata per l'istanza in uso.
1. Apri la console Amazon Connect all'indirizzo [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/).
1. Nella pagina delle istanze, seleziona l'alias dell'istanza. L'alias dell'istanza è anche il **nome dell'istanza** che appare nell'URL Amazon Connect. L'immagine seguente mostra la pagina **Istanze di contact center virtuali di Amazon Connect**, con un riquadro attorno all'alias dell'istanza.
![\[La pagina delle istanze del contact center virtuale di Amazon Connect, l'alias dell'istanza.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/instance.png)
1. Nel riquadro di navigazione, scegli **Flussi**.
1. Seleziona **Abilita i log di flusso** e scegli **Salva**.
## Passaggio 2: Aggiunta del blocco Impostazione comportamento registrazione di log
I log vengono generati solo per i flussi che includono un blocco [Imposta il comportamento di registrazione](set-logging-behavior.md) con la registrazione di log impostata su abilitata.
È possibile controllare per quali flussi, o parti di flussi, vengono generati i log includendo più blocchi **Set logging behavior (Impostazione comportamento registrazione di log)** e configurandoli in base alle esigenze.
Quando si utilizza un blocco **Set logging behavior (Impostazione comportamento registrazione di log)** per abilitare o disabilitare la registrazione di log di un flusso, la registrazione è anche abilitata o disabilitata per qualsiasi flusso successivo a cui viene trasferito un contatto, anche se il flusso non include un blocco **Set logging behavior (Impostazione comportamento registrazione di log)**. Per evitare la registrazione di log persistente tra i flussi, abilitare o disabilitare un blocco **Set logging behavior (Impostazione comportamento registrazione di log)** come necessario per quel flusso specifico.
**Attivazione o disattivazione dei log di flusso per un flusso**
1. Nel designer del flusso, aggiungi un blocco [Imposta il comportamento di registrazione](set-logging-behavior.md) e collegalo a un altro blocco nel flusso.
1. Apri le proprietà del blocco. Scegli **Enable (Abilita)** o **Disable (Disabilita)**.
1. Scegli **Save** (Salva).
1. Se aggiungi un blocco **Impostazione comportamento registrazione di log** a un flusso già pubblicato, è necessario pubblicarlo nuovamente per avviare la generazione di log.
# Registri del flusso di ricerca archiviati in un gruppo di CloudWatch log Amazon
Prima di poter cercare i log di flusso, è necessario prima [abilitare la registrazione di log di flusso](contact-flow-logs.md).
I log verranno creati per le conversazioni che avvengono dopo l'abilitazione della registrazione di log.
**Per cercare log di flusso**
1. Apri la Amazon CloudWatch console, vai a **Registri, Gruppi** di **registro**. L'immagine seguente mostra un gruppo di log di esempio denominato **mytest88**.
![\[La CloudWatch console Amazon, sezione dei gruppi di log.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/cloudwatch-log-group.png)
1. Scegli il gruppo di log per l'istanza.
Verrà visualizzato un elenco di flussi di log.
1. Per cercare tutti i flussi di log nell'istanza, scegli **Cerca gruppo di log**, come mostrato nell'immagine seguente.
![\[Il pulsante di ricerca del gruppo di log nella pagina/aws/connect/mytest88.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/contact-flow-logs-choose-search.png)
1. Nella casella di ricerca, inserisci la stringa che desideri cercare, ad esempio, tutto o parte dell'ID del contatto.
1. Dopo un paio di istanti (più a lungo a seconda della dimensione del registro), Amazon CloudWatch restituisce i risultati. L'immagine seguente mostra un esempio di contatto ID **fb3304c2** e il risultato.
![\[Gli eventi di log elencati per mytest88.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/contact-flow-logs-search-results.png)
1. È possibile aprire ogni evento per vedere cosa è successo. L'immagine seguente mostra l'evento che si verifica quando un blocco di **Riproduci prompt** viene eseguito in un flusso.
![\[L'evento per un blocco Riproduci prompt.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/contact-flow-logs-example-event.png)
# Dati nei log di flusso archiviati in un gruppo di CloudWatch log Amazon
Le voci di log per i flussi includono dettagli sul blocco associato alla voce di log, all'ID del contatto e all'azione intrapresa quando la procedura nel blocco è stata completata. Qualsiasi interazione dei contatti che si verifica al di fuori del flusso non viene registrata in un log, ad esempio il tempo trascorso in una coda o le interazioni con un agente.
È possibile impostare le proprietà del blocco per disabilitare la registrazione di log durante le parti del flusso che interagiscono o acquisiscono dati sensibili o informazioni personali dei clienti.
Se utilizzi Amazon Lex o AWS Lambda nei tuoi flussi, i log mostrano l'entrata e l'uscita del flusso verso di essi e includono tutte le informazioni sull'interazione che viene inviata o ricevuta durante l'ingresso o l'uscita.
Poiché i log includono anche l'ID del flusso e l'ID del flusso rimane invariato quando si modifica un flusso, è possibile utilizzare i log per confrontare le interazioni con diverse versioni del flusso.
La seguente voce di log di esempio mostra un blocco **Imposta coda lavoro** di un flusso in entrata.
```
{
"ContactId": "11111111-2222-3333-4444-555555555555",
"ContactFlowId": "arn:aws:connect:us-west-2:0123456789012:instance/nnnnnnnnnnn-3333-4444-5555-111111111111/contact-flow/123456789000-aaaa-bbbbbbbbb-cccccccccccc",
"ContactFlowModuleType": "SetQueue",
"Timestamp": "2021-04-13T00:14:31.581Z",
"Parameters": {
"Queue": "arn:aws:connect:us-west-2:0123456789012:instance/nnnnnnnnnnn-3333-4444-5555-111111111111/queue/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee"
}
}
```
# Tenere traccia dei clienti tra più flussi nel contact center
In molti casi, i clienti interagiscono con più flussi all'interno del contact center, poiché vengono trasferiti da un flusso a un altro per essere assistiti con il loro problema specifico nel migliore dei modi. I log di flusso consentono di monitorare i clienti tra flussi diversi, includendo l'ID del contatto in ogni voce di log.
Quando un cliente viene trasferito a un altro flusso, l'ID del contatto associato alla interazione è incluso con il log per il nuovo flusso. È possibile interrogare i log per l'ID di contatto e rintracciare l'interazione del cliente attraverso ogni flusso di contatto.
In contact center più grandi e con volumi alti di chiamate, possono essere presenti più flussi per i log di flusso. Se un contatto viene trasferito a un altro flusso, il log può essere in uno flusso diverso. Per assicurarti di trovare tutti i dati di registro per un contatto specifico, devi cercare l'ID del contatto nell'intero gruppo di CloudWatch log anziché in uno specifico flusso di log.
Per un diagramma che mostra quando viene creato un nuovo record di contatto, consulta [Eventi nel record di contatto](about-contact-states.md#ctr-events).
# Crea avvisi per eventi nei tuoi log di flusso archiviati in un gruppo di log Amazon CloudWatch
Puoi configurare in modo CloudWatch da definire uno schema di filtro che cerchi eventi specifici nei log di flusso e quindi crei un avviso quando viene aggiunta al registro una voce relativa a quell'evento.
Ad esempio, è possibile impostare un avviso per quando un blocco del flusso si imposta su un percorso di errore mentre un cliente interagisce con il flusso. Le voci di registro sono in genere disponibili in CloudWatch breve tempo e offrono una notifica quasi in tempo reale degli eventi nei flussi.
# Monitorare le interazioni automatiche (IVR) in Amazon Connect
Puoi utilizzare i log di interazione automatica per esaminare la parte automatizzata dell’esperienza Amazon Connect dei tuoi clienti. I log delle interazioni vengono visualizzati nella pagina **Dettagli di contatto**. Includono le seguenti informazioni:
+ Punti di interazione chiave, ovvero flussi, prompt, menu, selezioni da tastiera.
+ Una trascrizione completa del bot.
Puoi utilizzare i log per monitorare e migliorare le interazioni automatiche con i clienti e conservare i record audio e dell’esecuzione di sistema relativi all’interazione per scopi di conformità.
## Abilitare i log di interazione automatica
Completa le fasi seguenti per verificare che i log di interazione automatica siano abilitati per l’istanza Amazon Connect.
**Nota**
Attualmente, Amazon Connect non supporta i bucket S3 con [Object Lock](https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lock.html) abilitato.
1. Apri la console Amazon Connect all'indirizzo [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/).
1. I log di interazione automatica vengono salvati nel **bucket S3 che hai configurato per le registrazioni delle chiamate**. Se la funzionalità di registrazione delle chiamate non è ancora abilitata per la tua istanza, abilitala ora.
1. Nel riquadro di navigazione, scegli **Archiviazione dei dati**, **Registrazioni chiamate**, **Modifica**, **Abilita registrazione chiamata** e crea o seleziona un bucket S3.
1. Nel riquadro di navigazione, scegli **Flussi**.
1. Seleziona **Abilita l’analisi e le trascrizioni dei bot in Amazon Connect**. Scegli questa opzione per registrare un log di una trascrizione completa della parte Amazon Lex dell’esperienza del cliente. La trascrizione è quindi disponibile per la lettura nella pagina **Dettagli di contatto**.
1. Seleziona **Abilita i log di interazione automatica**. Scegli questa opzione per registrare log per i punti di interazione chiave come flussi, prompt, menu e selezioni da tastiera. È possibile visualizzare il log delle interazioni e ascoltare la registrazione audio, se disponibile, nella pagina **Dettagli di contatto**.
## Autorizzazioni per i log di interazione automatica
Per proteggere i dati dei clienti, puoi impostare le autorizzazioni in modo da avere un controllo granulare su chi può accedere ai log di interazione automatica. L’accesso ai log di interazione automatica è limitato dalle seguenti autorizzazioni nel profilo di sicurezza:
+ Autorizzazioni **Flussi** e **Moduli di flusso - Visualizza**: queste autorizzazioni sono necessarie per visualizzare i dati specifici del flusso e del modulo nei log delle interazioni automatiche.
+ Autorizzazioni **Analisi e ottimizzazione** - **Trascrizioni vocali di interazione automatica (IVR) (non redatte)**: queste autorizzazioni sono necessarie per accedere ai log dell’interazione IVR, come gli input da tastiera in risposta a prompt IVR, le trascrizioni delle interazioni di Lex e così via.
## Navigare nei log di interazione automatica e nelle registrazioni audio
L'immagine seguente mostra un esempio di registro delle interazioni automatizzato nella pagina dei **dettagli di contatto** del sito Web di Amazon Connect amministrazione.
![\[Un esempio di log di interazione automatica.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/automated-interaction-log.png)
**Per navigare nel log**
1. Utilizza le schede per passare dall'interazione automatica all'interazione con l'agente e visualizzare l' end-to-endinterazione del cliente.
1. Scegli **Mostra i dettagli del flusso** per nascondere i dettagli di sistema relativi ai flussi e ai blocchi di flusso.
1. Scegli il flusso e blocca i collegamenti ipertestuali per aprire il designer di flusso in una nuova scheda, per seguire rapidamente il flusso.
1. Scegli **Riproduci** per riprodurre il prompt specifico all’interno del file di registrazione audio.
**Nota**
Se non è disponibile alcuna registrazione audio, non è possibile riprodurre il prompt.
1. Scopri rapidamente dove si sono verificati gli errori, inclusi i timeout dei clienti o gli errori della funzione Lambda.
1. Scopri dove vengono rilevati e risolti gli intenti del bot.