Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Supervisión del uso de Amazon Quick mediante CloudWatch registros

Puede usar Amazon CloudWatch Logs para ofrecer conversaciones de chat, comentarios de los usuarios, uso de agent/research horas y uso de almacenamiento indexado en Amazon Quick para que pueda analizarlos. Estos registros se pueden entregar a varios destinos CloudWatch, como Amazon S3 o Amazon Data Firehose (se aplican tarifas estándar). Le recomendamos que configure los registros de venta poco después de activar las funciones de Amazon Quick AI.

Los siguientes son ejemplos de tareas que puede realizar con los registros de Amazon Quick:

Destinos de registro compatibles

Amazon Quick puede entregar registros a los siguientes destinos:

Requisitos previos

Antes de poder habilitar el registro, asegúrese de que dispone de lo siguiente:

Configuración de registros de

Para habilitar el registro del chat rápido y los comentarios de Amazon, debe configurar los permisos de IAM, crear una fuente y un destino de entrega y comprobar que los registros se están entregando correctamente.

Configurar permisos de IAM

Para configurar CloudWatch Logs para Amazon Quick, utilice los siguientes ejemplos de políticas de IAM para conceder los permisos necesarios.

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

También debes incluir el principio de delivery.logs.amazonaws.com servicio en tu política de AWS KMS claves gestionadas por el 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:*"
        }
    }
}

Configure la suscripción de registros

Por ejemplo, políticas de IAM con todos los permisos necesarios para su destino de registro específico, consulte Habilitar el registro desde AWS los servicios en la Guía del usuario de Amazon CloudWatch Logs.

Cree una fuente de entrega con la operación de la API PutDeliverySource CloudWatch Logs. Asigne un nombre al origen de entrega y para resourceArn, especifique el ARN de la aplicación. ParalogType, especifique CHAT_LOGSAGENT_HOURS_LOGS,FEEDBACK_LOGS, oINDEX_USAGE_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"
}

Para habilitar el registro de las conversaciones de los usuarios con las operaciones de la API de CloudWatch registros, debe llamar a las PutDeliverySource operaciones de la CreateDelivery APIPutDeliveryDestination, y.

Verifique la entrega de registros

Una vez configurado, compruebe que los registros se entreguen a su destino:

Esquema y formato del registro

Los registros rápidos de Amazon siguen un esquema estructurado con campos comunes compartidos en todos los tipos de registro y campos específicos para los registros de chat y comentarios.

Campos comunes

Todos los eventos de registro incluyen los siguientes campos comunes:

Registros de chat

Los registros de chat capturan las interacciones de las conversaciones y contienen los siguientes campos:

El siguiente es un ejemplo de registros de 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"}]
}

Registros de comentarios

Los registros de comentarios recopilan los comentarios de los usuarios en el chat y contienen los siguientes campos:

El siguiente es un ejemplo de registros de comentarios:

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

Agent/Research registros de horas

Este tipo de registro captura los registros de uso de los diferentes agentes de tu cuenta Quick que se utilizan para fijar los precios:

El siguiente es un ejemplo de los registros de las horas de los agentes:

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

Registros de uso del índice

Los registros de uso de índices recopilan métricas de almacenamiento por fuente para las bases de conocimiento y los Spaces. Los eventos se publican cada vez que se produce un cambio (se crea, actualiza, sincroniza o elimina).

El siguiente es un ejemplo de registros de uso de índices:

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

Para obtener información sobre la creación de paneles y la ejecución de consultas en los registros de uso de índices, consulte. Supervise el uso del almacenamiento de índices

Consideraciones de seguridad