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 dell'utilizzo di Amazon Quick tramite CloudWatch log

Puoi utilizzare Amazon CloudWatch Logs per fornire conversazioni in chat, feedback degli utenti e agent/research orari di utilizzo in Amazon Quick da analizzare. Questi log possono essere consegnati a più destinazioni CloudWatch, ad esempio Amazon S3 o Amazon Data Firehose (si applicano le tariffe standard). Ti consigliamo di configurare i vended log subito dopo aver abilitato le funzionalità di Amazon Quick AI.

Di seguito sono riportati alcuni esempi di attività che puoi completare con i log di Amazon Quick:

Destinazioni di log supportate

Amazon Quick può consegnare log alle seguenti destinazioni:

Prerequisiti

Prima di abilitare la registrazione, assicurati di avere:

Configurazione della registrazione

Per abilitare la registrazione per Amazon Quick chat e feedback, devi configurare le autorizzazioni IAM, creare una fonte e una destinazione di consegna e verificare che i log vengano consegnati correttamente.

Impostare autorizzazioni IAM

Per configurare CloudWatch Logs for 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 includere il responsabile del delivery.logs.amazonaws.com servizio nella politica delle AWS KMS chiavi gestite dai clienti.

{
    "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:*"
        }
    }
}

Configura l'abbonamento al registro

Ad esempio, le politiche IAM con tutte le autorizzazioni richieste per la tua destinazione di registrazione specifica, consulta Enable logging from AWS services nella Amazon CloudWatch Logs User Guide.

Crea una fonte di distribuzione con l'operazione dell'PutDeliverySource CloudWatch API Logs. Assegna un nome all’origine di consegna e per resourceArn specifica l’ARN dell’applicazione. PerlogType, specifica CHAT_LOGS o AGENT_HOURS_LOGS FEEDBACK_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"
}

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

Verifica la consegna dei log

Una volta configurato, verifica che i log vengano consegnati a destinazione:

Schema e formato del registro

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

Campi comuni

Tutti gli eventi di registro includono questi campi comuni:

Registri delle chat

I registri delle chat registrano le interazioni delle conversazioni e contengono i seguenti campi:

Di seguito è riportato un esempio di log delle chat:

{
    "status_code": "success",
    "namespace": "default",
    "user_type": "ADMIN_PRO",
    "conversation_id": "a11b2bbc-c123-3abc-a12b-12a34b5c678d",
    "system_message_id": "a11b2bbc-c123-3abc-a12b-12a34b5c678d",
    "latency": "10000", 
    "time_to_first_token": "10000",
    "message_scope": "all_resources",
    "user_message_id": "a11b2bbc-c123-3abc-a12b-12a34b5c678d",
    "user_message": "Hi chat",
    "agent_id": "a11b2bbc-c123-3abc-a12b-12a34b5c678d",
    "flow_id": "a11b2bbc-c123-3abc-a12b-12a34b5c678d?",
    "system_text_message": "Hello user",
    "surface_type": "WEB_EXPERIENCE",
    "web_search": "true"
    "user_selected_resources": [{"resource_type": "Dashboard","resource_id": "146abs-1222-534894"},{"resource_type": "Space","resource_id": "123abs-1234-534894"}],
    "action_connectors": [{"action_connector_id": "quicksight-website"},{"action_connector_id": "123abs-1234-534894"}]
    "cited_resource": [{"cited_resource_name": "Dashboard","cited_resource_id": "146abs-1222-534894","cited_resource_name": "ds1"},{"cited_resource_name": "Space","cited_resource_id": "123abs-1234-534894","cited_resource_name": "space1"}],
    "file_attachment": [{"file_attachmet_type": "pdf","file_attachment_name": "file1.pdf"},{"file_attachmet_type": "txt","file_attachment_name": "file2.txt"}]
}

Registri di feedback

I registri di feedback raccolgono il feedback degli utenti sulla chat e contengono i seguenti campi:

Di seguito è riportato un esempio di log di feedback:

{
    "status_code": "success",
    "namespace": "default",
    "user_type": "ADMIN_PRO",
    "conversation_id": "a11b2bbc-c123-3abc-a12b-12a34b5c678d",
    "system_message_id": "a11b2bbc-c123-3abc-a12b-12a34b5c678d",
    "user_message_id" : "a11b2bbc-c123-3abc-a12b-12a34b5c678d",
    "feedback_type" :"Not Useful / Useful"
    "feedback_reason" : "Too wordy,Issue with sources,Other etc."
    "feedback_details" : "additional text shared by user"
}

Registri delle ore di agente/ricerca

Questo tipo di registro raccoglie i registri di utilizzo dei diversi agenti all'interno dell'account Quick utilizzato per la determinazione dei prezzi:

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

{
    "subscription_type": "ENTERPRISE",
    "reporting_service": "RESEARCH",
    "usage_group": "Included",
    "usage_hours": 0.3333,
    "service_resource_arn": "arn:aws:quicksight:eu-west-1:111222333444:research/a11b2bbc-c123-3abc-a12b-12a34b5c678d"
}

Considerazioni relative alla sicurezza