Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris. # `AWSSupport-CollectAmazonConnectContactFlowLog` **Deskripsi** Runbook `AWSSupport-CollectAmazonConnectContactFlowLog` otomatisasi digunakan untuk mengumpulkan log alur kontak Amazon Connect untuk ID kontak tertentu. Dengan memberikan ID instans Amazon Connect dan ID kontak, runbook akan mencari log alur kontak untuk kontak dari grup CloudWatch log Amazon dan mengunggahnya ke bucket Amazon Simple Storage Service (Amazon S3) yang ditentukan dalam parameter permintaan. Runbook menghasilkan output yang menyediakan URL konsol Amazon S3 dan perintah AWS CLI bagi Anda untuk mengunduh log. **Bagaimana cara kerjanya?** Runbook `AWSSupport-CollectAmazonConnectContactFlowLog` otomatisasi membantu mengumpulkan log alur kontak Amazon Connect untuk ID kontak tertentu yang disimpan dalam grup CloudWatch log yang dikonfigurasi dan mengunggahnya ke bucket Amazon S3 yang ditentukan. Untuk membantu keamanan log yang dikumpulkan dari alur kontak Amazon Connect, otomatisasi mengevaluasi konfigurasi bucket Amazon S3 untuk menentukan apakah bucket memberikan izin `read` publik `write` atau akses dan dimiliki oleh akun yang ditentukan AWS dalam parameter. `S3BucketOwnerAccountId` Jika bucket Amazon S3 Anda menggunakan enkripsi sisi server dengan AWS Key Management Service kunci (SSE-KMS), pastikan bahwa peran pengguna atau AWS Identity and Access Management (IAM) yang menjalankan otomatisasi ini memiliki izin pada kunci. `kms:GenerateDataKey` AWS KMS Untuk informasi selengkapnya tentang log yang dihasilkan oleh instans Amazon Connect, lihat [Log aliran yang disimpan dalam grup CloudWatch log Amazon](https://docs.aws.amazon.com/connect/latest/adminguide/contact-flow-logs-stored-in-cloudwatch.html). **penting** Kueri Wawasan CloudWatch Log dikenakan biaya berdasarkan jumlah data yang ditanyakan. Pelanggan tingkat gratis hanya dikenakan biaya untuk penggunaan yang melebihi kuota layanan. Untuk informasi lebih lanjut, lihat [Amazon CloudWatch Harga](https://aws.amazon.com/cloudwatch/pricing/). [Jalankan Otomasi ini (konsol)](https://console.aws.amazon.com/systems-manager/automation/execute/AWSSupport-CollectAmazonConnectContactFlowLog) **Jenis dokumen** Otomatisasi **Pemilik** Amazon **Platform** Linux,macOS, Windows **Parameter** **Izin IAM yang diperlukan** `AutomationAssumeRole`Parameter memerlukan tindakan berikut untuk menggunakan runbook dengan sukses. ``` { "Statement": [ { "Action": [ "s3:GetBucketPublicAccessBlock", "s3:GetBucketPolicyStatus", "s3:GetBucketAcl", "s3:GetObject", "s3:GetObjectAttributes", "s3:PutObject", "s3:PutObjectAcl" ], "Resource": [ "arn:aws:s3:::amzn-s3-demo-bucket/*", "arn:aws:s3:::amzn-s3-demo-bucket" ], "Effect": "Allow" }, { "Action": [ "connect:DescribeInstance", "connect:DescribeContact", "ds:DescribeDirectories" ], "Resource": "*", "Effect": "Allow" }, { "Action": [ "logs:StartQuery", "logs:GetQueryResults" "Resource": "*", "Effect": "Allow" } ] } ``` **Instruksi** Ikuti langkah-langkah ini untuk mengonfigurasi otomatisasi: 1. Arahkan ke [https://console.aws.amazon.com/systems-manager/documents/AWSSupport-CollectAmazonConnectContactFlowLog/description](https://console.aws.amazon.com/systems-manager/documents/AWSSupport-CollectAmazonConnectContactFlowLog/description)Systems Manager di bawah Dokumen. 1. Pilih Jalankan otomatisasi. 1. Untuk parameter input, masukkan yang berikut ini: + **AutomationAssumeRole (Opsional):** Nama Sumber Daya Amazon (ARN) dari peran AWS Identity and Access Management (IAM) yang memungkinkan Otomasi Systems Manager untuk melakukan tindakan atas nama Anda. Jika tidak ada peran yang ditentukan, Systems Manager Automation menggunakan izin pengguna yang memulai runbook ini. + **ConnectInstanceId (Diperlukan):** ID instans Amazon Connect Anda. + **ContactId (Diperlukan):** ID kontak yang ingin Anda kumpulkan log alur kontak. + **S3 BucketName (Diperlukan):** Nama bucket Amazon S3 di akun tempat Anda ingin mengunggah log alur kontak. Pastikan kebijakan bucket tidak memberikan izin baca/tulis yang tidak perlu kepada pihak yang tidak memerlukan akses ke log yang dikumpulkan. + **S3 ObjectPrefix (Opsional):** Jalur objek Amazon S3 di bucket Amazon S3 untuk log alur kontak yang diunggah. Misalnya, jika Anda menentukan`CollectedLogs`, log akan diunggah sebagai`s3://your-s3-bucket/CollectedLogs/ContactFlowLog_[ContactId][AWSAccountId].gz`. Jika Anda tidak menentukan parameter ini, ID eksekusi Systems Manager Automation digunakan, misalnya:`s3://your-s3-bucket/[automation:EXECUTION_ID]/ContactFlowLog[ContactId]_[AWSAccountId].gz`. Catatan: jika Anda menentukan nilai untuk `S3ObjectPrefix` dan menjalankan otomatisasi ini menggunakan [ContactId] yang sama, log alur kontak akan ditimpa. + **S3 BucketOwnerAccount (Opsional):** Nomor AWS akun yang memiliki bucket Amazon S3 tempat Anda ingin mengunggah log alur kontak. Jika Anda tidak menentukan parameter ini, runbook menggunakan ID AWS akun pengguna atau peran di mana otomatisasi berjalan. + **S3 BucketOwnerRoleArn (Opsional):** ARN peran IAM dengan izin untuk mendapatkan bucket Amazon S3 dan pengaturan pemblokiran akun akses publik, konfigurasi enkripsi bucket, bucket, status kebijakan bucket ACLs, dan mengunggah objek ke bucket. Jika parameter ini tidak ditentukan, runbook menggunakan `AutomationAssumeRole` (jika ditentukan) atau pengguna yang memulai runbook ini (jika tidak `AutomationAssumeRole` ditentukan). Lihat bagian izin yang diperlukan di deskripsi buku runbook. ![\[Input parameters form for AWS Systems Manager Automation with fields for roles, IDs, and S3 settings.\]](http://docs.aws.amazon.com/id_id/systems-manager-automation-runbooks/latest/userguide/images/automation-collect-amazon-connect-contact-flow-log_input_parameters.png) 1. Pilih Jalankan. 1. Otomatisasi dimulai. 1. Dokumen melakukan langkah-langkah berikut: + **CheckConnectInstanceExistance** Memeriksa apakah instans Amazon Connect yang disediakan di `ConnectInstanceId` is`ACTIVE`. + **Ceks3 BucketPublicStatus** Memeriksa apakah bucket Amazon S3 yang ditentukan dalam `S3BucketName` mengizinkan izin akses baca atau tulis anonim atau publik. + **GenerateLogSearchTimeRange** Menghasilkan `StartTime` dan `EndTime` untuk `StartQuery` langkah berdasarkan `InitiationTimestamp` dan `LastUpdateTimestamp` dikembalikan oleh `DescribeContact` API. `StartTime`akan menjadi satu jam sebelumnya `InitiationTimestamp` dan `EndTime` akan menjadi satu jam setelahnya`LastUpdateTimestamp`. + **StartQuery** Memulai log kueri untuk yang disediakan `ContactId` dalam grup CloudWatch log Log yang terkait dengan instans Amazon Connect yang disediakan`ConnectInstanceId`. Waktu kueri habis setelah 60 menit runtime. Jika waktu kueri Anda habis, kurangi rentang waktu yang dicari. Anda dapat melihat kueri yang sedang berlangsung serta riwayat kueri terbaru Anda di CloudWatch konsol. Untuk informasi selengkapnya, lihat [Melihat kueri atau riwayat kueri yang sedang berjalan](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CloudWatchLogs-Insights-Query-History.html). + **WaitForQueryCompletion** Menunggu CloudWatch log kueri Log `ContactId` untuk menyelesaikan yang disediakan. Perhatikan bahwa waktu kueri habis setelah 60 menit runtime. Jika waktu kueri Anda habis, kurangi rentang waktu yang dicari. Anda dapat melihat kueri yang sedang berlangsung serta riwayat kueri terbaru Anda di konsol Amazon Connect. Untuk informasi selengkapnya, lihat [Melihat kueri atau riwayat kueri yang sedang berjalan](https://docs.aws.amazon.com//AmazonCloudWatch/latest/logs/CloudWatchLogs-Insights-Query-History.html). + **UploadContactFlowLog** Mendapatkan hasil kueri dan mengunggah log alur kontak ke bucket Amazon S3 yang ditentukan. `S3BucketName` + **GenerateReport** Mengembalikan URL konsol Amazon S3 tempat log alur kontak diunggah dan contoh perintah AWS CLI yang dapat Anda gunakan untuk mengunduh file log. 1. Setelah selesai, tinjau bagian Output untuk hasil eksekusi yang terperinci: + **GenerateReport.OutputPayload** Output yang memberi tahu Anda bahwa runbook berhasil mengambil log alur kontak untuk kontak yang ditentukan. Laporan ini juga berisi URL konsol Amazon S3 dan contoh perintah AWS CLI sehingga Anda dapat mengunduh file log. ![\[Output showing successful retrieval of Contact Flow log with S3 Console URL and AWS CLI command.\]](http://docs.aws.amazon.com/id_id/systems-manager-automation-runbooks/latest/userguide/images/automation-collect-amazon-connect-contact-flow-log_outputs.png) **Referensi** Otomatisasi Systems Manager + [Jalankan Otomasi ini (konsol)](https://console.aws.amazon.com/systems-manager/documents/AWSSupport-CollectAmazonConnectContactFlowLog/description) + [Jalankan otomatisasi](https://docs.aws.amazon.com//systems-manager/latest/userguide/automation-working-executing.html) + [Menyiapkan Otomasi](https://docs.aws.amazon.com//systems-manager/latest/userguide/automation-setup.html) + [Support Automation Workflow landing page](https://aws.amazon.com/premiumsupport/technology/saw/)