Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Memantau Amazon Penggunaan Cepat menggunakan CloudWatch Log

Anda dapat menggunakan Amazon CloudWatch Logs untuk menyampaikan percakapan obrolan, umpan balik pengguna, dan penggunaan agent/research jam di Amazon Quick untuk Anda analisis. Log ini dapat dikirimkan ke beberapa tujuan CloudWatch, seperti Amazon S3, atau Amazon Data Firehose (tarif standar berlaku). Kami menyarankan Anda menyiapkan log vended segera setelah mengaktifkan fitur Amazon Quick AI.

Berikut ini adalah contoh tugas yang dapat Anda selesaikan dengan log dari Amazon Quick:

Tujuan log yang didukung

Amazon Quick dapat mengirimkan log ke tujuan berikut:

Prasyarat

Sebelum Anda dapat mengaktifkan logging, pastikan Anda memiliki:

Mengonfigurasikan pencatatan log

Untuk mengaktifkan pencatatan untuk obrolan dan umpan balik Amazon Cepat, Anda perlu mengonfigurasi izin IAM, membuat sumber dan tujuan pengiriman, dan memverifikasi bahwa log berhasil dikirim.

Siapkan izin IAM

Untuk menyiapkan CloudWatch Log untuk Amazon Quick, gunakan contoh kebijakan IAM berikut untuk memberikan izin yang diperlukan.

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

Anda juga harus mengizinkan prinsip delivery.logs.amazonaws.com layanan dalam kebijakan AWS KMS kunci yang dikelola pelanggan Anda.

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

Konfigurasikan langganan log

Misalnya kebijakan IAM dengan semua izin yang diperlukan untuk tujuan pencatatan tertentu, lihat Mengaktifkan pencatatan dari AWS layanan di Panduan Pengguna CloudWatch Log Amazon.

Buat sumber pengiriman dengan operasi PutDeliverySource CloudWatch Logs API. Beri nama sumber pengiriman dan untukresourceArn, tentukan ARN aplikasi Anda. UntuklogType, tentukanCHAT_LOGS, AGENT_HOURS_LOGS atau 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"
}

Untuk mengaktifkan pencatatan percakapan pengguna dengan operasi CloudWatch Logs API, Anda memanggil operasi PutDeliverySourcePutDeliveryDestination,, dan CreateDelivery API.

Verifikasi pengiriman log

Setelah dikonfigurasi, verifikasi bahwa log sedang dikirim ke tujuan Anda:

Skema log dan format

Amazon Log cepat mengikuti skema terstruktur dengan bidang umum yang dibagikan di semua jenis log dan bidang tertentu untuk log obrolan dan umpan balik.

Bidang umum

Semua peristiwa log mencakup bidang umum ini:

Log obrolan

Log obrolan menangkap interaksi percakapan dan berisi bidang di bawah ini:

Berikut ini adalah contoh log obrolan:

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

Log umpan balik

Log umpan balik menangkap umpan balik pengguna pada obrolan dan berisi bidang di bawah ini:

Berikut ini adalah contoh log umpan balik:

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

Agen/Jam Penelitian Log

Jenis log ini menangkap log penggunaan untuk agen yang berbeda dalam akun Cepat Anda yang digunakan untuk penetapan harga:

Berikut ini adalah contoh log Jam Agen:

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

Pertimbangan keamanan