

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à.

# Monitoraggio di Amazon Quick tramite CloudWatch log
<a name="monitoring-cloudwatch-logs"></a>

Puoi utilizzare [ Amazon CloudWatch Logs ](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AWS-logs-and-resource-policy.html) per fornire conversazioni in chat, feedback degli utenti, utilizzo delle ore degli agenti e indicizzare l'utilizzo dello spazio di archiviazione in Amazon Quick da analizzare. Questi log possono essere inviati a più destinazioni CloudWatch, come Amazon S3 o Amazon Data Firehose (si applicano le tariffe standard).

**Importante**  
Configura la distribuzione dei log venduti subito dopo aver abilitato le funzionalità di Amazon Quick AI. I log non sono retroattivi: ricevi solo gli eventi che si verificano dopo la configurazione della consegna.

Di seguito sono riportati alcuni esempi di attività che puoi completare con i log di Amazon Quick:
+ Identificare le query e i punti critici più comuni degli utenti esaminando il contenuto dei messaggi di chat.
+ Monitorare la qualità delle risposte esaminando metriche quali `feedbackReason`.
+ Comprendere il sentiment e la soddisfazione degli utenti analizzando i dati del feedback, inclusi commenti e valutazioni dell’utilità.
+ Generare dashboard e report personalizzati per monitorare le metriche e le tendenze chiave nel tempo.
+ Identifica e analizza i casi in cui la chat non ha dato risposta o la richiesta dell'utente è stata bloccata.
+ Monitora l'utilizzo delle ore degli agenti.
+ Tieni traccia dell'utilizzo dello storage degli indici nelle knowledge base e negli Spaces.
+ Tieni traccia delle operazioni di sincronizzazione della knowledge base e identifica gli errori di indicizzazione o di indicizzazione dei documenti.

**Importante**  
I log delle conversazioni possono includere dati di identificazione personale o sensibili trasmessi nelle chat. Puoi filtrare queste informazioni dai tuoi log quando configuri la sottoscrizione ai log. Oppure puoi mascherare questi dati nei tuoi log utilizzando le politiche di mascheramento CloudWatch dei log. Per ulteriori informazioni, consulta [Incremento della protezione dei dati di log sensibili con il mascheramento](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/mask-sensitive-log-data.html).

## Destinazioni di log supportate
<a name="quicksuite-chat-feedback-supported-log-destinations"></a>

Amazon Quick è in grado di inviare i log alle seguenti destinazioni:
+ **Amazon CloudWatch Logs**: per il monitoraggio e l'analisi in tempo reale
+ **Amazon S3**: per l'archiviazione a lungo termine e l'elaborazione in batch
+ **Amazon Data Firehose**: per l'analisi in streaming e la trasformazione dei dati

## Prerequisiti
<a name="quicksuite-chat-feedback-logging-prerequisites"></a>

Prima di poter abilitare la registrazione, assicurati di avere quanto segue:
+ Un'istanza Amazon Quick attiva con abbonamenti Enterprise o Professional
+ Autorizzazioni IAM appropriate per configurare la distribuzione dei log
+ Una destinazione configurata per i tuoi CloudWatch log (Logs, bucket Amazon S3 o Firehose)

## Configurazione della registrazione
<a name="quicksuite-chat-feedback-configure-logging"></a>

Per abilitare la registrazione per Amazon Quick chat and feedback, configura le autorizzazioni IAM, crea una fonte e una destinazione di consegna e verifica la consegna dei log.

**Topics**
+ [Impostare autorizzazioni IAM](#quicksuite-chat-feedback-setup-iam-permissions)
+ [Configurare la sottoscrizione ai log](#quicksuite-chat-feedback-configure-log-subscription)
+ [Verifica la consegna dei log](#quicksuite-chat-feedback-verify-log-delivery)

### Impostare autorizzazioni IAM
<a name="quicksuite-chat-feedback-setup-iam-permissions"></a>

Per configurare CloudWatch Logs per Amazon Quick, utilizza i seguenti esempi di policy IAM per concedere le autorizzazioni necessarie.

```
{
    "Version": "2012-10-17"		 	 	 ,
    "Statement": [{
        "Sid": "QuicksightLogDeliveryPermissions",
        "Effect": "Allow",
        "Action": "quicksight:AllowVendedLogDeliveryForResource",
        "Resource": "arn:aws:quicksight:region:account-id:account/account-id"
    }]
}
```

È inoltre necessario inserire l'indirizzo principale del `delivery.logs.amazonaws.com` servizio nella policy relativa alle AWS KMS chiavi gestite dal cliente.

```
{
    "Effect": "Allow"		 	 	 ,
    "Principal": {
        "Service": "delivery.logs.amazonaws.com"
    },
    "Action": [
        "kms:GenerateDataKey",
        "kms:Decrypt"
    ],
    "Resource": "*",
    "Condition": {
        "StringEquals": {
            "kms:EncryptionContext:SourceArn": "arn:partition:logs:region:account-id:*"
        }
    }
}
```

### Configurare la sottoscrizione ai log
<a name="quicksuite-chat-feedback-configure-log-subscription"></a>

Ad esempio, politiche IAM con tutte le autorizzazioni richieste per la destinazione di registrazione specifica, consulta [ Enable logging from AWS services ](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AWS-logs-and-resource-policy.html) nella * Amazon CloudWatch Logs User Guide. *

Crea una fonte di consegna con l'operazione [ PutDeliverySource ](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliverySource.html) CloudWatch Logs API. Assegna un nome all’origine di consegna e per `resourceArn` specifica l’ARN dell’applicazione. Per`logType`, specificare `CHAT_LOGS``AGENT_HOURS_LOGS`,`AGENT_METADATA_LOGS`,`FEEDBACK_LOGS`,`INDEX_USAGE_LOGS`, o`KB_FILE_SYNC_LOGS`.

```
{
    "logType": "CHAT_LOGS",
    "name": "my-quick-suite-delivery-source",
    "resourceArn": "arn:aws:quicksight:your-region:your-account-id:account/account-id"
}
```

```
{
    "logType": "FEEDBACK_LOGS",
    "name": "my-quick-suite-delivery-source",
    "resourceArn": "arn:aws:quicksight:your-region:your-account-id:account/account-id"
}
```

```
{
    "logType": "AGENT_HOURS_LOGS",
    "name": "my-quick-suite-delivery-source",
    "resourceArn": "arn:aws:quicksight:your-region:your-account-id:account/account-id"
}
```

```
{
    "logType": "INDEX_USAGE_LOGS",
    "name": "my-quick-index-usage-delivery-source",
    "resourceArn": "arn:aws:quicksight:your-region:your-account-id:account/account-id"
}
```

```
{
    "logType": "KB_FILE_SYNC_LOGS",
    "name": "my-quick-kb-file-sync-delivery-source",
    "resourceArn": "arn:aws:quicksight:your-region:your-account-id:account/account-id"
}
```

```
{
    "logType": "AGENT_METADATA_LOGS",
    "name": "my-quick-agent-metadata-delivery-source",
    "resourceArn": "arn:aws:quicksight:your-region:your-account-id:account/account-id"
}
```

Per abilitare la registrazione delle conversazioni degli utenti con le operazioni dell'API CloudWatch Logs, chiamate le operazioni `PutDeliverySource``PutDeliveryDestination`,, e `CreateDelivery` API.

**Nota**  
Vended-log la consegna è per regione. Ogni spedizione registra solo l'attività che si verifica nella regione specificata dall'`resourceArn`in`PutDeliverySource`. Per ricevere i log da più regioni, configura una consegna separata in ciascuna regione.

### Verifica la consegna dei log
<a name="quicksuite-chat-feedback-verify-log-delivery"></a>

Dopo aver configurato la consegna dei log, verifica che i log vengano recapitati a destinazione:
+ **Verifica la configurazione: ** verifica l'elenco delle consegne che sono state create nell'account utilizzando l'`DescribeDeliveries`API in CloudWatch Logs.
+ **CloudWatch Log**: controlla il gruppo di log specificato per i nuovi flussi di log.
+ **Amazon S3**: monitora il bucket alla ricerca di nuovi file di registro.
+ **Firehose**: verifica che i dati fluiscano nel flusso di consegna.

## Schema e formato del registro
<a name="quicksuite-chat-feedback-log-schema-format"></a>

I log di Amazon Quick seguono uno schema strutturato con campi comuni condivisi per tutti i tipi di log e campi specifici per i log delle chat e dei feedback.

### Campi comuni
<a name="quicksuite-chat-feedback-common-fields"></a>

Tutti gli eventi di registro includono questi campi comuni:
+ `resource_arn`— ARN delle risorse del tuo account Amazon Quick (ad esempio,`arn:aws:quicksight:us-east-1:111122223333:account/111122223333:`)
+ `event_timestamp`— Tempo di epoca Unix in millisecondi (ad esempio,) `1763532110061`
+ `logType`— Tipo di registro (ad esempio, o) `CHAT_LOGS` `FEEDBACK_LOGS`
+ `accountId`— ID AWS dell'account (ad esempio,`123456789012`)
+ `user_arn`— ARN utente Amazon Quick associato all'evento (ad esempio,`"arn:aws:quicksight:us-west-2:111122223333:user/default/user"`)

### Registri delle chat
<a name="quicksuite-chat-logs"></a>

I registri delle chat registrano le interazioni delle conversazioni:

**Nota**  
Le conversazioni temporanee escluse dalla cronologia e dalla memoria vengono comunque inserite nei registri delle chat. Ogni record include `user_arn` la fine `user_type` dell'utente che ha avviato la conversazione.
+ `user_arn`— ARN utente Amazon Quick associato all'evento
+ `user_type`— Tipo di utente Amazon Quick associato all'evento (ad esempio,`ADMIN_PRO`)
+ `status_code`— Stato della richiesta di chat (ad esempio`success`,`request_blocked`,`no_answer_found`)
+ `conversation_id`— ID univoco per la conversazione con l'utente
+ `system_message_id`— ID System-generated del messaggio
+ `message_scope`— Ambito del messaggio (ad esempio`all_resources`,`specific_resources`,`no_resources`)
+ `user_message_id`— ID univoco del messaggio utente
+ `user_message`— Messaggio utente nella conversazione
+ `agent_id`— ID univoco dell'agente di chat o `SYSTEM` dell'agente predefinito
+ `flow_id`— ID univoco di Amazon Quick Flow o, in `-` caso contrario, una chiamata al flusso
+ `system_text_message`— Risposta del sistema nella conversazione
+ `user_selected_resources`— Elenco delle risorse selezionate dall'utente
+ `action_connectors`— Elenco dei connettori di azione disponibili nella conversazione
+ `cited_resource`— Elenco delle risorse citate
+ `file_attachment`— Elenco dei file allegati dall'utente
+ `resource_arn`— ARN delle risorse del tuo account Amazon Quick
+ `event_timestamp`— Timestamp dell'evento
+ `logType` – `CHAT_LOGS`
+ `accountId`— ID AWS dell'account

Di seguito è riportato un esempio di log delle chat:

```
{
    "user_arn": "arn:aws:quicksight:us-east-1:111122223333:user/default/johndoe",
    "user_type": "ADMIN_PRO",
    "status_code": "success",
    "conversation_id": "c11ba72c-ff18-4213-9686-1952bb547c19",
    "system_message_id": "42a37690-1804-442b-8368-3d34570dd2cd",
    "message_scope": "all_resources",
    "user_message_id": "5ec45e03-bf22-40c7-b32a-d69eb015f86b",
    "user_message": "What is in this document?",
    "agent_id": "SYSTEM",
    "flow_id": "-",
    "system_text_message": "Here is a summary of the attached document.",
    "user_selected_resources": [{"resourceId": "ALL", "resourceType": "space"}],
    "action_connectors": [{"actionConnectorId": "quicksuite-documentation"}, {"actionConnectorId": "quicksuite-websearch"}],
    "cited_resource": [{"citedResourceType": "document", "citedResourceId": null, "citedResourceName": "example-document.html"}],
    "file_attachment": [{"fileAttachmentType": "html", "fileAttachmentName": "example-document.html"}],
    "resource_arn": "arn:aws:quicksight:us-east-1:111122223333:account/111122223333",
    "event_timestamp": 1787185484508,
    "logType": "CHAT_LOGS",
    "accountId": "111122223333"
}
```

### Log di feedback
<a name="quicksuite-chat-feedback-logs"></a>

I registri di feedback raccolgono il feedback degli utenti sulle risposte alla chat:
+ `user_arn`— ARN utente Amazon Quick associato all'evento
+ `user_type`— Tipo di utente Amazon Quick associato all'evento (ad esempio,`ADMIN_PRO`)
+ `status_code`— Stato della consegna dell'evento
+ `conversation_id`— ID univoco della conversazione
+ `system_message_id`— ID del messaggio generato dal sistema
+ `user_message_id`— ID univoco del messaggio utente
+ `feedback_type`— Tipo di feedback (ad esempio`Not Useful`,`Useful`)
+ `feedback_reason`— Motivo del feedback selezionato dall'utente
+ `feedback_details`— (Facoltativo) Dettagli aggiuntivi forniti dall'utente
+ `resource_arn`— ARN della risorsa del tuo account Amazon Quick
+ `event_timestamp`— Timestamp dell'evento
+ `logType` – `FEEDBACK_LOGS`
+ `accountId`— ID AWS dell'account

Di seguito è riportato un esempio di log di feedback:

```
{
    "user_arn": "arn:aws:quicksight:us-east-1:111122223333:user/default/johndoe",
    "user_type": "ADMIN_PRO",
    "status_code": "success",
    "conversation_id": "c11ba72c-ff18-4213-9686-1952bb547c19",
    "system_message_id": "42a37690-1804-442b-8368-3d34570dd2cd",
    "user_message_id": "5ec45e03-bf22-40c7-b32a-d69eb015f86b",
    "feedback_type": "Not Useful",
    "feedback_reason": "Too wordy",
    "feedback_details": "The answer included too much background information.",
    "resource_arn": "arn:aws:quicksight:us-east-1:111122223333:account/111122223333",
    "event_timestamp": 1787185500123,
    "logType": "FEEDBACK_LOGS",
    "accountId": "111122223333"
}
```

## Registri delle ore degli agenti
<a name="quicksuite-agent-hours-logs"></a>

Questo tipo di registro raccoglie i log di utilizzo dei diversi agenti all'interno dell'account Quick utilizzati per la determinazione dei prezzi:
+ `user_arn`— ARN utente Amazon Quick associato all'evento
+ `subscription_type`— Livello di abbonamento dell'utente. Valori:`ENTERPRISE`,`PROFESSIONAL`.
+ `reporting_service`— La superficie Quick che ha consumato ore di agente. I valori correnti includono`FLOW`,`AUTOMATION`, e`RESEARCH`. I nuovi valori potrebbero apparire quando le funzioni rapide aggiuntive iniziano a misurare le ore degli agenti.
+ `usage_group`— Se l'utilizzo è coperto dal diritto all'abbonamento o fatturato come eccedenza. Valori:
  + `Included`— Utilizzo nell'ambito della concessione giornaliera dei diritti per il livello di abbonamento. Nessun addebito incrementale.
  + `Extra`— Eccedenza oltre la sovvenzione giornaliera. Fatturato in base al consumo.
+ `usage_hours`— Valore decimale che indica le ore impiegate dall'agente per questo record
+ `service_resource_arn`— ARN della risorsa che ha consumato le ore (ad esempio, un flusso, un'automazione o una sessione di ricerca)
+ `resource_arn`— ARN della risorsa del tuo account Amazon Quick
+ `event_timestamp`— Timestamp dell'evento
+ `logType` – `AGENT_HOURS_LOGS`
+ `accountId`— ID AWS dell'account

Di seguito è riportato un esempio di log di Agent Hours:

```
{
    "user_arn": "arn:aws:quicksight:us-east-1:111122223333:user/default/johndoe",
    "subscription_type": "ENTERPRISE",
    "reporting_service": "RESEARCH",
    "usage_group": "Included",
    "usage_hours": 0.0928,
    "service_resource_arn": "arn:aws:quicksight::111122223333:research/a11b2bbc-c123-3abc-a12b-12a34b5c678d",
    "resource_arn": "arn:aws:quicksight:us-east-1:111122223333:account/111122223333",
    "event_timestamp": 1787183715000,
    "logType": "AGENT_HOURS_LOGS",
    "accountId": "111122223333"
}
```

## Registri dei metadati degli agenti
<a name="quicksuite-agent-metadata-logs"></a>

I registri dei metadati degli agenti registrano gli eventi del ciclo di vita degli agenti di chat, tra cui creazione, aggiornamenti, modifiche alle autorizzazioni ed eliminazione. Viene emesso un record per operazione dell'agente:
+ `user_arn`— ARN utente Amazon Quick associato all'evento.
+ `event_name`— Il funzionamento del ciclo di vita dell'agente. I valori includono `CreateAgent``UpdateAgent`, `DeleteAgent``UpdateAgentPermissions`, e altri quando vengono aggiunte nuove operazioni.
+ `event_version`— Versione dello schema del record di registro.
+ `agent_id`— UUID dell'agente.
+ `agent_arn`— ARN completo dell'agente.
+ `agent_name`— Visualizza il nome dell'agente.
+ `agent_status`— Stato attuale dell'agente (ad esempio,`ACTIVE`).
+ `request_id`— Identificatore della richiesta per l'operazione.
+ `description`— Testo descrittivo dell'agente.
+ `spaces`— Matrice JSON di spazi collegati all'agente.
+ `permissions_granted`— Autorizzazioni aggiunte in questa operazione.
+ `permissions_revoked`— Autorizzazioni rimosse in questa operazione.
+ `permissions_state`— Autorizzazioni correnti dopo l'operazione.
+ `update_action`— L'azione di aggiornamento eseguita.
+ `version`— Numero di versione dell'agente.
+ `icon_id`— Icona identificativa dell'agente.
+ `magic_builder_query`— L'interrogazione in linguaggio naturale utilizzata per creare l'agente tramite il generatore.
+ `instructions`— Istruzioni per l'agente.
+ `failed_to_add_spaces`— Spazi che non è stato possibile allegare.
+ `failed_to_remove_spaces`— Spazi che non possono essere staccati.
+ `draft_discarded`— Se una bozza è stata scartata.
+ `custom_prompt_input`— Input di prompt personalizzato configurato per l'agente.
+ `welcome_message`— Messaggio di benvenuto mostrato agli utenti dell'agente.
+ `starter_prompts`— Richieste iniziali suggerite agli utenti dell'agente.
+ `resource_arn`— ARN delle risorse del tuo account Amazon Quick.
+ `event_timestamp`— Timestamp dell'evento.
+ `log_type` – `AGENT_METADATA_LOGS`.
+ `account_id`— ID AWS dell'account.

**Nota**  
I `starter_prompts` campi `custom_prompt_input``welcome_message`, e contengono contenuti sensibili. Quando si configura una AWS KMS chiave gestita dal cliente per la consegna, questi campi sono crittografati. Senza una chiave, vengono consegnati in chiaro.

Di seguito è riportato un esempio di registro dei metadati dell'agente per un evento: `CreateAgent`

```
{
    "user_arn": "arn:aws:quicksight:us-east-1:111122223333:user/default/johndoe",
    "event_version": "1.0",
    "event_name": "CreateAgent",
    "agent_id": "12345678-90ab-cdef-1234-567890abcdef",
    "request_id": "fedcba98-7654-3210-fedc-ba9876543210",
    "agent_arn": "arn:aws:quicksight:us-east-1:111122223333:agent/12345678-90ab-cdef-1234-567890abcdef",
    "agent_name": "Project Status Assistant",
    "agent_status": "ACTIVE",
    "description": "An agent that helps track project status and find relevant documentation.",
    "spaces": "[{\"Arn\": \"arn:aws:quicksight:us-east-1:111122223333:space/11112222-3333-4444-5555-666677778888\"}]",
    "resource_arn": "arn:aws:quicksight:us-east-1:111122223333:account/111122223333",
    "event_timestamp": 1787185396000,
    "log_type": "AGENT_METADATA_LOGS",
    "account_id": "111122223333"
}
```

## Registri di utilizzo dell'indice
<a name="quicksuite-index-usage-logs"></a>

I log di utilizzo dell'indice acquisiscono le metriche di archiviazione per fonte per le knowledge base e gli Spaces. Gli eventi vengono pubblicati ogni volta che si verifica una modifica (creata, aggiornata, sincronizzata o eliminata):
+ `user_arn`— ARN utente Amazon Quick associato all'evento
+ `consumed_index_size`— Dimensione totale (in byte) consumata dall'intero indice
+ `source_type`— Tipo di fonte: `SPACE` o `KB`
+ `source_name`— Visualizza il nome dello spazio o della knowledge base
+ `source_arn`— ARN completo della fonte
+ `consumed_source_size`— Dimensione (in byte) consumata da questa singola fonte
+ `consumed_source_doc_count`— Numero di documenti in questa fonte
+ `resource_arn`— ARN della risorsa del tuo account Amazon Quick
+ `event_timestamp`— Timestamp dell'evento
+ `log_type` – `INDEX_USAGE_LOGS`
+ `account_id`— ID AWS dell'account

Di seguito è riportato un esempio di log di utilizzo degli indici:

```
{
    "account_id": "111122223333",
    "event_timestamp": 1774911984257,
    "log_type": "INDEX_USAGE_LOGS",
    "user_arn": "arn:aws:quicksight::111122223333:user/default/user",
    "resource_arn": "arn:aws:quicksight:us-west-2:111122223333:account/111122223333",
    "consumed_index_size": 500000,
    "source_type": "SPACE",
    "source_name": "my-space",
    "source_arn": "arn:aws:quicksight:us-west-2:111122223333:space/2744af89-31b2-423b-93a2-69b0cd0d7fa1",
    "consumed_source_size": 244436,
    "consumed_source_doc_count": 2
}
```

**Nota**  
Gli eventi vengono pubblicati per fonte al momento della modifica. Non tutte le fonti emettono eventi ogni giorno. Per ricostruire lo stato corrente, usa l'evento più recente per. `source_arn`

Per informazioni sulla creazione di dashboard e sull'esecuzione di query sui log di utilizzo degli indici, vedere. [Monitora l'utilizzo dello storage degli indici](index-usage-monitoring.md)

## Base di conoscenza: registri di sincronizzazione dei file
<a name="quicksuite-kb-file-sync-logs"></a>

I registri di sincronizzazione dei file della Knowledge Base acquisiscono gli eventi di stato di sincronizzazione per documento. Viene emesso un record di registro per documento per esecuzione di sincronizzazione:
+ `document_id`— Identificatore del documento originale, ad esempio un URL o un percorso di file.
+ `document_title`— Titolo del documento.
+ `document_status`— Stato del documento del terminale. Valori: `ADDED``MODIFIED`,`UNMODIFIED`,`DELETED`,`SKIPPED`,`FAILED`.
+ `sync_result`— risultato della High-level disponibilità. Valori: `AVAILABLE` o`UNAVAILABLE`.
+ `sync_id`— ID di esecuzione del lavoro di sincronizzazione.
+ `data_source_id`— Identificatore della fonte di dati a cui è connessa la knowledge base.
+ `source_uri`— URL di origine del documento.
+ `error_message`— Descrizione dell'errore quando lo stato è `FAILED` o`SKIPPED`.
+ `error_mitigation`— Guida pratica per la risoluzione dell'errore.
+ `error_type`— Codice di errore quando lo stato è o. `FAILED` `SKIPPED`
+ `knowledge_base_id`— UUID della knowledge base che ha prodotto il registro.

La tabella seguente descrive `document_status` i valori e i loro corrispondenti. `sync_result`


| document\_status | risultato\_sincronizzazione | Significato | 
| --- | --- | --- | 
| ADDED | AVAILABLE | Nuovo documento indicizzato con successo | 
| MODIFIED | AVAILABLE | Documento esistente reindicizzato con modifiche | 
| UNMODIFIED | AVAILABLE | Contenuto del documento invariato, non è necessaria la reindicizzazione | 
| DELETED | UNAVAILABLE | Documento rimosso dall'indice | 
| SKIPPED | UNAVAILABLE | Documento filtrato durante la scansione, ad esempio in base al file robots.txt o al limite di dimensione | 
| FAILED | UNAVAILABLE | Documento non riuscito durante la scansione o l'indicizzazione | 

L'esempio seguente mostra un registro di sincronizzazione dei file della knowledge base in cui è stato aggiunto un documento alla knowledge base:

```
{
    "resource_arn": "arn:aws:quicksight:us-west-2:111122223333:account/111122223333",
    "event_timestamp": 1781296858575,
    "log_type": "KB_FILE_SYNC_LOGS",
    "account_id": "111122223333",
    "document_id": "https://docs.aws.amazon.com/quick/latest/userguide/monitoring-cloudwatch-logs.html",
    "document_title": "Monitoring Amazon QuickSight usage using CloudWatch Logs",
    "document_status": "ADDED",
    "sync_result": "AVAILABLE",
    "sync_id": "86a70a9a-cad9-4fc6-8881-e3909c8954d2",
    "data_source_id": "56225744-18bc-4373-a91f-861dd1c3d566",
    "source_uri": "https://docs.aws.amazon.com/quick/latest/userguide/monitoring-cloudwatch-logs.html",
    "knowledge_base_id": "b0bd0a47-8095-439d-9dff-c64bd5fe3fa3"
}
```

L'esempio seguente mostra un registro del documento ignorato in cui la scansione è stata ignorata a causa di un errore di convalida:

```
{
    "resource_arn": "arn:aws:quicksight:us-west-2:111122223333:account/111122223333",
    "event_timestamp": 1781296492951,
    "log_type": "KB_FILE_SYNC_LOGS",
    "account_id": "111122223333",
    "document_id": "https://docs.aws.amazon.com/quick/latest/userguide/blocked-page.html",
    "document_title": "Blocked Page",
    "document_status": "SKIPPED",
    "sync_result": "UNAVAILABLE",
    "sync_id": "86a70a9a-cad9-4fc6-8881-e3909c8954d2",
    "data_source_id": "56225744-18bc-4373-a91f-861dd1c3d566",
    "source_uri": "https://docs.aws.amazon.com/quick/latest/userguide/blocked-page.html",
    "error_message": "This URL wasn't crawled because crawling isn't allowed by its robots.txt file.",
    "error_mitigation": "Contact the website administrator for assistance.",
    "error_type": "VALIDATION_ERROR",
    "knowledge_base_id": "b0bd0a47-8095-439d-9dff-c64bd5fe3fa3"
}
```

## Considerazioni relative alla sicurezza
<a name="quicksuite-chat-feedback-security-considerations"></a>
+ **Crittografia**: utilizza chiavi gestite dal cliente AWS KMS per i dati sensibili.
+ **Controllo degli accessi**: implementa politiche IAM con privilegi minimi.
+ **Conservazione dei dati**: configura le politiche di conservazione appropriate per i tuoi requisiti di conformità.