# Registrazione Chat IVS
<a name="chat-logging"></a>

La funzione Registrazione di chat consente di registrare tutti i messaggi in una stanza in una delle tre posizioni standard: un bucket Amazon S3, Amazon CloudWatch Logs o Amazon Kinesis Data Firehose. Successivamente utilizza i log per l'analisi o per creare un riproduzione della chat che si collega a una sessione video dal vivo.

## Abilitazione della registrazione delle chat per una stanza
<a name="chat-logging-enable"></a>

La registrazione delle chat è un'opzione avanzata che può essere abilitata associando una configurazione di registrazione a una stanza. Una configurazione di registrazione è una risorsa che consente di specificare un tipo di posizione (bucket Amazon S3, Amazon CloudWatch Logs o Amazon Kinesis Data Firehose) in cui vengono registrati i messaggi di una stanza. Per informazioni dettagliate sulla creazione e la gestione delle configurazioni di registrazione, consulta [Guida introduttiva ad Amazon IVS Chat](getting-started-chat.md) e [Documentazione di riferimento delle API di Amazon IVS Chat](https://docs.aws.amazon.com//ivs/latest/ChatAPIReference/Welcome.html). 

È possibile associare fino a tre configurazioni di registrazione a ciascuna stanza, quando si crea una nuova stanza ([CreateRoom](https://docs.aws.amazon.com//ivs/latest/ChatAPIReference/API_CreateRoom.html)) o si aggiorna una stanza esistente ([UpdateRoom](https://docs.aws.amazon.com//ivs/latest/ChatAPIReference/API_UpdateRoom.html)). È possibile associare più stanze alla stessa configurazione di registrazione.

Quando almeno una configurazione di registrazione attiva è associata a una stanza, ogni richiesta di messaggistica inviata a quella stanza tramite l'[API di messaggistica di Amazon IVS Chat](https://docs.aws.amazon.com//ivs/latest/chatmsgapireference/welcome.html) viene registrata automaticamente nelle posizioni specificate. Questi sono i ritardi di propagazione medi (da quando viene inviata una richiesta di messaggistica a quando diventa disponibile nelle posizioni specificate):
+ Bucket Amazon S3: 5 minuti
+ Amazon CloudWatch Logs o Amazon Kinesis Data Firehose: 10 secondi

## Contenuto del messaggio
<a name="chat-logging-message-content"></a>

### Formato
<a name="message-content-format"></a>

```
{
   "event_timestamp": "string",
   "type": "string",
   "version": "string",
   "payload": { "string": "string" }
}
```

### Campi
<a name="message-content-fields"></a>


| Campo | Descrizione | 
| --- | --- | 
| `event_timestamp` | Timestamp UTC di quando il messaggio è stato ricevuto da Amazon IVS Chat. | 
| `payload` | Il payload JSON del [messaggio (sottoscrizione)](https://docs.aws.amazon.com//ivs/latest/chatmsgapireference/actions-message-subscribe.html) o dell'[evento (sottoscrizione)](https://docs.aws.amazon.com//ivs/latest/chatmsgapireference/actions-event-subscribe.html) che i clienti riceveranno dal servizio Amazon IVS Chat. | 
| `type` | Tipo di messaggio della chat. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/ivs/latest/ChatUserGuide/chat-logging.html)  | 
| `version` | La versione del formato del contenuto del messaggio. | 

## Bucket Amazon S3
<a name="chat-logging-s3-bucket"></a>

### Formato
<a name="s3-bucket-format"></a>

I log dei messaggi sono organizzati e archiviati con il seguente prefisso S3 e formato di file:

```
AWSLogs/<account_id>/IVSChatLogs/<version>/<region>/room_<resource_id>/<year>/<month>/<day>/<hours>/<account_id>_IVSChatLogs_<version>_<region>_room_<resource_id>_<year><month><day><hours><minutes>_<hash>.log.gz
```

### Campi
<a name="s3-bucket-fields"></a>


| Campo | Descrizione | 
| --- | --- | 
| `<account_id>` | ID dell'account AWS da cui viene creata la stanza. | 
| `<hash>` | Un valore hash generato dal sistema per garantire l'unicità. | 
| `<region>` | La regione di servizio AWS in cui è stata creata la stanza. | 
| `<resource_id>` | L'ID della risorsa parte dell'ARN della stanza. | 
| `<version>` | La versione del formato del contenuto del messaggio. | 
| `<year> / <month> / <day> / <hours> / <minute>` | Timestamp UTC di quando il messaggio è stato ricevuto da Amazon IVS Chat. | 

### Esempio
<a name="s3-bucket-example"></a>

```
AWSLogs/123456789012/IVSChatLogs/1.0/us-west-2/room_abc123DEF456/2022/10/14/17/123456789012_IVSChatLogs_1.0_us-west-2_room_abc123DEF456_20221014T1740Z_1766dcbc.log.gz
```

## Amazon CloudWatch Logs
<a name="chat-logging-cloudwatch-logs"></a>

### Formato
<a name="cloudwatch-logs-format"></a>

I log dei messaggi sono organizzati e archiviati con il seguente formato di nome del flusso di log:

```
aws/IVSChatLogs/<version>/room_<resource_id>
```

### Campi
<a name="cloudwatch-logs-fields"></a>


| Campo | Descrizione | 
| --- | --- | 
| `<resource_id>` | L'ID della risorsa parte dell'ARN della stanza. | 
| `<version>` | La versione del formato del contenuto del messaggio. | 

### Esempio
<a name="cloudwatch-logs-example"></a>

```
aws/IVSChatLogs/1.0/room_abc123DEF456
```

## Amazon Kinesis Data Firehose
<a name="chat-logging-kinesis-firehose"></a>

I log dei messaggi vengono inviati al flusso di consegna come dati di streaming in tempo reale a destinazioni come Amazon Redshift, il servizio OpenSearch di Amazon, Splunk e qualsiasi endpoint HTTP personalizzato o endpoint HTTP di proprietà di provider di servizi di terze parti supportati. Per ulteriori informazioni, consulta [Cos'è Amazon Kinesis Data Firehose?](https://docs.aws.amazon.com/firehose/latest/dev/what-is-this-service.html?icmpid=docs_console_unmapped).

## Vincoli
<a name="chat-logging-constraints"></a>
+ È necessario essere il proprietario della posizione di registrazione in cui verranno archiviati i messaggi.
+ La stanza, la configurazione di registrazione e la posizione di registrazione devono trovarsi nella stessa regione AWS.
+ Per la registrazione delle chat sono disponibili solo le configurazioni di registrazione attive.
+ È possibile eliminare una configurazione di registrazione che non è più associata ad alcuna stanza.

La registrazione di messaggi in una posizione di proprietà dell'utente richiede l'autorizzazione con le credenziali AWS. Per fornire a IVS Chat l'accesso richiesto, al momento della creazione della configurazione di registrazione sono generati automaticamente una policy di risorse (per un bucket Amazon S3 o CloudWatch Logs) o un [ruolo collegato ai servizi](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html) (SLR) di AWS IAM (per Amazon Kinesis Data Firehose). *Prestare attenzione a qualsiasi modifica al ruolo o alle policy, poiché ciò può influire sull'autorizzazione per la registrazione delle chat.*

## Monitoraggio degli errori con Amazon CloudWatch
<a name="chat-logging-monitor-errors"></a>

Puoi monitorare gli errori che si verificano nella registrazione dei messaggi con Amazon CloudWatch e creare allarmi o pannelli di controllo per indicare o rispondere alle modifiche di errori specifici.

Esistono diversi tipi di errori. Per maggiori informazioni, consulta la pagina [Monitoraggio di Chat Amazon IVS](chat-health.md).