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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AWS-logs-and-resource-policy.html) 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:
+ Identifikasi kueri pengguna umum dan titik nyeri dengan meninjau konten pesan obrolan.
+ Pantau kualitas respons dengan melihat metrik seperti`feedbackReason`.
+ Memahami sentimen dan kepuasan pengguna dengan menganalisis data umpan balik, termasuk komentar dan peringkat kegunaan.
+ Buat dasbor dan laporan khusus untuk melacak metrik dan tren utama dari waktu ke waktu.
+ Identifikasi dan Analisis kasus di mana obrolan tidak mengembalikan jawaban atau kueri pengguna diblokir
+ Memantau penggunaan agen dan jam penelitian
**penting**
Log dari percakapan mungkin mencakup data sensitif atau dapat diidentifikasi secara pribadi yang diteruskan dalam obrolan. Anda dapat memfilter informasi ini dari log Anda saat menyiapkan langganan log. Atau Anda dapat menutupi data ini di log Anda menggunakan kebijakan penyembunyian CloudWatch Log. Untuk informasi selengkapnya, lihat [Membantu melindungi data log sensitif dengan masking](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/mask-sensitive-log-data.html).
## Tujuan log yang didukung
Amazon Quick dapat mengirimkan log ke tujuan berikut:
+ **Amazon CloudWatch Logs** - Untuk pemantauan dan analisis real-time
+ **Amazon S3** - Untuk penyimpanan jangka panjang dan pemrosesan batch
+ **Amazon Data Firehose** - Untuk analisis streaming dan transformasi data
## Prasyarat
Sebelum Anda dapat mengaktifkan logging, pastikan Anda memiliki:
+ Instans Amazon Quick aktif dengan langganan Enterprise atau Professional
+ Izin IAM yang sesuai untuk mengonfigurasi pengiriman log
+ Tujuan yang dikonfigurasi untuk log Anda (CloudWatch Log, bucket Amazon S3, atau Firehose)
## 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.
**Topics**
+ [Siapkan izin IAM](#quicksuite-chat-feedback-setup-iam-permissions)
+ [Konfigurasikan langganan log](#quicksuite-chat-feedback-configure-log-subscription)
+ [Verifikasi pengiriman log](#quicksuite-chat-feedback-verify-log-delivery)
### 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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AWS-logs-and-resource-policy.html) di *Panduan Pengguna CloudWatch Log Amazon*.
Buat sumber pengiriman dengan operasi [PutDeliverySource](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliverySource.html) CloudWatch Logs API. Beri nama sumber pengiriman dan untuk`resourceArn`, tentukan ARN aplikasi Anda. Untuk`logType`, tentukan`CHAT_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 `PutDeliverySource``PutDeliveryDestination`,, dan `CreateDelivery` API.
**catatan**
Log akan tersedia untuk wilayah yang disebutkan dalam ARN sumber daya di `PutDeliverySource` input.
### Verifikasi pengiriman log
Setelah dikonfigurasi, verifikasi bahwa log sedang dikirim ke tujuan Anda:
+ **Verifikasi penyiapan:** Verifikasi daftar pengiriman yang telah dibuat di akun dengan menggunakan `DescribeDeliveries` API di CloudWatch Log.
+ **CloudWatch Log**: Periksa grup log yang ditentukan untuk aliran log baru.
+ **Amazon S3**: Pantau bucket Anda untuk file log baru.
+ **Firehose**: Verifikasi data mengalir melalui aliran pengiriman 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:
+ `resource_arn`- Sumber daya ARN dari akun Amazon Quick Anda (misalnya,) `arn:aws:quicksight:us-east-1:111122223333:account/111122223333:`
+ `event_timestamp`- Stempel waktu ISO 8601 acara (misalnya,) `1763532110061`
+ `logType`- Jenis log (misalnya, `Chat` atau`Feedback`)
+ `accountId`- ID AWS akun (misalnya,`123456789012`)
+ `user_arn`- Amazon Quick user ARN terkait dengan acara (misalnya,) `"arn:aws:quicksight:us-west-2:111122223333:user/default/user"`
### Log obrolan
Log obrolan menangkap interaksi percakapan dan berisi bidang di bawah ini:
+ `status_code`- Status permintaan obrolan (misalnya,`Success, request_blocked, no_answer_found`)
+ `namespace*`- Amazon Quick namespace untuk acara tersebut (misalnya,) `default`
+ `user_type`- Jenis pengguna Amazon Quick yang terkait dengan acara (misalnya,`ADMIN_PRO`)
+ `conversation_id`- ID unik untuk percakapan pengguna
+ `system_message_id`- ID pesan yang dihasilkan sistem
+ `latency*`- Latensi pesan obrolan dalam milidetik
+ `time_to_first_token*`- Waktu dalam milidetik token respons pertama
+ `message_scope`- Lingkup pesan (misalnya,`all_resources, specific_resources, no_resources`)
+ `user_message_id`- ID unik dari pesan pengguna
+ `user_message`- pesan pengguna dalam percakapan
+ `agent_id`- ID unik agen obrolan
+ `flow_id`- ID Unik dari Amazon Quick Flow
+ `system_text_message`- Respon sistem dalam percakapan
+ `surface_type*`- Aplikasi yang digunakan untuk percakapan
+ `web_search*`- Pencarian web diaktifkan atau tidak
+ `user_selected_resources`- Daftar sumber daya yang dipilih oleh pengguna
+ `action_connectors`- Daftar konektor aksi
+ `cited_resource`- Daftar sumber daya yang dikutip
+ `file_attachment`- Daftar file yang dilampirkan oleh pengguna
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:
+ `status_code`- Status pengiriman acara
+ `namespace*`- Amazon Quick namespace untuk acara tersebut (misalnya,) `default`
+ `user_type`- Jenis pengguna Amazon Quick yang terkait dengan acara (misalnya,`ADMIN_PRO`)
+ `conversation_id`- ID unik percakapan
+ `system_message_id`- ID pesan yang dihasilkan sistem
+ `user_message_id`- ID unik pesan pengguna
+ `feedback_type`- Jenis umpan balik (misalnya,`Not Useful, Useful`)
+ `feedback_reason`- Alasan umpan balik yang dipilih oleh pengguna
+ `feedback_details`- (Opsional) Detail tambahan yang disediakan oleh pengguna
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:
+ `subscription_type`- PERUSAHAAN atau PROFESIONAL
+ `reporting_service`- Layanan yang sesuai dengan agen: PENELITIAN, ALIRAN ATAU OTOMATISASI
+ `usage_group`- `Included or Extra` berdasarkan jenis langganan dan penggunaan sejauh ini
+ `usage_hours`- Nilai desimal yang menunjukkan jam penggunaan untuk instance log tertentu
+ `service_resource_arn`- ARN dari layanan Agen terkait
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"
}
```
**catatan**
\$1 Bidang yang ditandai dengan '\$1' tidak ditambahkan secara default ke langganan log Anda. Ini perlu ditentukan secara eksplisit saat menelepon CreateDelivery jika diperlukan.
## Pertimbangan keamanan
+ **Enkripsi**: Gunakan AWS KMS kunci yang dikelola pelanggan untuk data sensitif
+ **Kontrol akses**: Menerapkan kebijakan IAM dengan hak istimewa paling rendah
+ **Penyimpanan data**: Konfigurasikan kebijakan retensi yang sesuai untuk persyaratan kepatuhan Anda