Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Memantau AWS DataSync transfer Anda
Pemantauan penting untuk menjaga keandalan dan kinerja aktivitas AWS DataSync transfer Anda. Kami menyarankan Anda mengumpulkan data pemantauan sehingga Anda dapat lebih mudah men-debug kesalahan jika terjadi. Namun DataSync, sebelum Anda mulai memantau, buat rencana pemantauan yang mencakup jawaban atas pertanyaan-pertanyaan berikut:
+ Apa saja sasaran pemantauan Anda?
+ Sumber daya apa yang akan Anda pantau?
+ Seberapa sering Anda akan memantau sumber daya ini?
+ Alat pemantauan apa yang akan Anda gunakan?
+ Siapa yang akan melakukan tugas pemantauan?
+ Siapa yang harus diberi tahu saat terjadi kesalahan?
AWS menyediakan berbagai layanan dan alat untuk pemantauan DataSync. Anda dapat mengonfigurasi beberapa di antaranya untuk melakukan pemantauan untuk Anda, tetapi beberapa memerlukan intervensi manual. Sebaiknya Anda mengotomatisasi tugas pemantauan sebanyak mungkin.
**Topics**
+ [Memahami penghitung kinerja transfer data](transfer-performance-counters.md)
+ [Memantau transfer data dengan CloudWatch metrik Amazon](monitor-datasync.md)
+ [Memantau transfer data Anda dengan laporan tugas](task-reports.md)
+ [Memantau transfer data dengan Amazon CloudWatch Logs](configure-logging.md)
+ [Pencatatan panggilan AWS DataSync API dengan AWS CloudTrail](logging-using-cloudtrail.md)
+ [Memantau peristiwa dengan menggunakan Amazon EventBridge](events.md)
+ [Pemantauan AWS DataSync dengan alat manual](monitoring-task-manually.md)
# Memahami penghitung kinerja transfer data
Saat Anda [memulai tugas, AWS DataSync sediakan](run-task.md) penghitung untuk membantu melacak kinerja dan kemajuan transfer data Anda.
Gunakan informasi berikut untuk memahami apa yang diwakili oleh setiap penghitung. Anda dapat melihat penghitung ini di DataSync konsol atau [DescribeTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html)respons. Beberapa penghitung tidak tersedia dengan setiap [mode tugas](choosing-task-mode.md).
| Konsol | `DescribeTaskExecution` | Dukungan mode tugas | Deskripsi |
| --- | --- | --- | --- |
| – | `BytesWritten` | Ditingkatkan, Dasar | Jumlah byte logis yang DataSync benar-benar menulis ke lokasi tujuan. |
| **Throughput data** | – | Ditingkatkan, Dasar | Tingkat di mana DataSync menulis byte logis ke lokasi tujuan. Jika Anda menggunakan [DescribeTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html), cara Anda menghitung penghitung ini tergantung pada mode tugas Anda: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/datasync/latest/userguide/transfer-performance-counters.html) |
| Data ditransfer | `BytesTransferred` | Ditingkatkan, Dasar | Jumlah byte yang DataSync dikirim ke jaringan sebelum kompresi (jika kompresi dimungkinkan). Untuk jumlah byte yang ditransfer melalui jaringan, lihat Penghitung **throughput Jaringan** (di konsol) atau `BytesCompressed` (dalam [DescribeTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html)). |
| **Dihapus dari tujuan** | `FilesDeleted` | Basic | Jumlah file, objek, dan direktori yang DataSync benar-benar dihapus di lokasi tujuan Anda. Jika Anda tidak mengonfigurasi tugas untuk [menghapus data di tujuan yang tidak ada di sumber](configure-metadata.md#task-option-file-object-handling): [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/datasync/latest/userguide/transfer-performance-counters.html) |
| **Dihapus dari tujuan** | `FilesDeleted`, `FoldersDeleted` | Ditingkatkan | Jumlah file atau objek, dan direktori yang DataSync benar-benar dihapus di lokasi tujuan Anda. Jika Anda tidak mengonfigurasi tugas untuk [menghapus data di tujuan yang tidak ada di sumber](configure-metadata.md#task-option-file-object-handling): [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/datasync/latest/userguide/transfer-performance-counters.html) |
| – | `EstimatedBytesToTransfer` | Ditingkatkan, Dasar | Jumlah byte logis yang DataSync mengharapkan untuk menulis ke lokasi tujuan. |
| – | `EstimatedFilesToDelete` | Basic | Jumlah file, objek, dan direktori yang DataSync diharapkan untuk dihapus di lokasi tujuan Anda. Jika Anda tidak mengonfigurasi tugas untuk [menghapus data di tujuan yang tidak ada di sumber](configure-metadata.md#task-option-file-object-handling), nilainya selalu`0`. |
| – | `EstimatedFilesToDelete`, `EstimatedFoldersToDelete` | Ditingkatkan | Jumlah file atau objek, dan direktori yang DataSync diharapkan untuk dihapus di lokasi tujuan Anda. Jika Anda tidak mengonfigurasi tugas untuk [menghapus data di tujuan yang tidak ada di sumber](configure-metadata.md#task-option-file-object-handling), nilainya selalu`0`. |
| – | `EstimatedFilesToTransfer` | Basic | Jumlah file, objek, dan direktori yang DataSync diharapkan untuk ditransfer melalui jaringan. Nilai ini dihitung saat DataSync [menyiapkan](run-task.md#understand-task-execution-statuses) transfer. Bagaimana ini dihitung terutama tergantung pada [mode transfer](configure-metadata.md#task-option-transfer-mode) yang Anda gunakan: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/datasync/latest/userguide/transfer-performance-counters.html) |
| – | `EstimatedFilesToTransfer`, `EstimatedFoldersToTransfer` | Ditingkatkan | Jumlah file atau objek, dan direktori yang DataSync mengharapkan untuk mentransfer melalui jaringan. Nilai ini dihitung saat DataSync [menyiapkan](run-task.md#understand-task-execution-statuses) transfer. Bagaimana ini dihitung terutama tergantung pada [mode transfer](configure-metadata.md#task-option-transfer-mode) yang Anda gunakan: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/datasync/latest/userguide/transfer-performance-counters.html) |
| **Throughput file** | – | Ditingkatkan, Dasar | Tingkat di mana DataSync mentransfer file, objek, dan direktori melalui jaringan. Jika Anda menggunakan [DescribeTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html), cara Anda menghitung penghitung ini tergantung pada mode tugas Anda: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/datasync/latest/userguide/transfer-performance-counters.html) |
| – | `FilesFailed`, `FoldersFailed` | Ditingkatkan | Jumlah file atau objek, dan direktori yang DataSync gagal untuk mempersiapkan, mentransfer, memverifikasi, dan menghapus selama pelaksanaan tugas Anda. Jika ada kegagalan, Anda dapat melihatnya di samping penghitung konsol yang **Disiapkan**, **Ditransfer**, **Dilewati**, dan **Dihapus dari penghitung konsol tujuan**. |
| **Terdaftar di sumber** | `FilesListed.AtSource`, `FoldersListed.AtSource` | Ditingkatkan | Jumlah file atau objek, dan direktori yang DataSync ditemukan di lokasi sumber Anda. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/datasync/latest/userguide/transfer-performance-counters.html) |
| – | `FilesListed.AtDestinationForDelete`, `FoldersListed.AtDestinationForDelete` | Ditingkatkan | Jumlah file atau objek, dan direktori yang DataSync ditemukan di lokasi tujuan Anda. Penghitung ini hanya berlaku jika Anda mengonfigurasi tugas Anda untuk [menghapus data di tujuan yang tidak ada di sumbernya](configure-metadata.md#task-option-file-object-handling). |
| **Throughput jaringan\$1** | `BytesCompressed` | Ditingkatkan, Dasar | Jumlah byte fisik yang DataSync ditransfer melalui jaringan setelah kompresi (jika kompresi dimungkinkan). Jumlah ini biasanya kurang dari **Data yang ditransfer** (di konsol) atau `BytesTransferred` (in [DescribeTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html)) kecuali data tidak dapat dimampatkan. \$1 Untuk mode Enhanced, **throughput Jaringan** tidak ditampilkan di konsol. |
| **Persen dikompresi** | – | Ditingkatkan, Dasar | Persentase transfer data yang DataSync dikompresi sebelum mengirimnya melalui jaringan. Jika Anda menggunakan [DescribeTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html), Anda dapat menghitung penghitung ini dengan`1 - BytesCompressed / BytesWritten`. |
| **Disiapkan** | `FilesPrepared`, `FoldersPrepared` | Ditingkatkan | Jumlah file atau objek, dan direktori yang DataSync akan mencoba mentransfer setelah membandingkan lokasi sumber dan tujuan Anda. Di konsol, penghitung ini juga dapat menunjukkan kepada Anda jumlah objek yang DataSync dilewati selama persiapan. Untuk informasi selengkapnya, lihat [Bagaimana DataSync mempersiapkan transfer data Anda](how-datasync-transfer-works.md#how-datasync-prepares). Penghitung ini tidak berlaku jika Anda mengonfigurasi tugas Anda untuk [mentransfer semua data](configure-metadata.md#task-option-transfer-mode). Dalam skenario itu, DataSync menyalin segala sesuatu dari sumber ke tujuan tanpa membandingkan perbedaan antar lokasi. |
| **Tingkat pemrosesan** | – | Ditingkatkan, Dasar | Tingkat di mana DataSync membaca file, objek, dan direktori di lokasi sumber Anda. Tingkat pemrosesan didasarkan pada beberapa [CloudWatch metrik](monitor-datasync.md#accessing-metrics). Metrik yang tepat bergantung pada mode tugas yang Anda gunakan. **Mode yang disempurnakan**: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/datasync/latest/userguide/transfer-performance-counters.html) **Mode dasar:** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/datasync/latest/userguide/transfer-performance-counters.html) |
| **Tersisa** | – | Basic | Jumlah file, objek, dan direktori yang tersisa yang DataSync diharapkan dapat ditransfer melalui jaringan. Jika Anda menggunakan [DescribeTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html), Anda dapat menghitung penghitung ini dengan mengurangi `FilesTransferred` dari. `EstimatedFilesToTransfer` |
| **Dilewati \$1** | `FilesSkipped` | Basic | Jumlah file, objek, dan direktori yang DataSync dilewati selama transfer Anda. |
| – | `FilesSkipped`, `FoldersSkipped` | Ditingkatkan | Jumlah file atau objek, dan direktori yang DataSync melompati selama transfer Anda. Item yang **dilewati** disertakan dalam penghitung yang **Disiapkan** saat [mentransfer hanya data yang telah berubah](configure-metadata.md#task-option-transfer-mode) atau penghitung yang **Ditransfer** saat [mentransfer](configure-metadata.md#task-option-transfer-mode) semua data. |
| **Ditransfer** | `FilesTransferred` | Basic | Jumlah file, objek, dan direktori yang DataSync ditransfer melalui jaringan. Nilai ini diperbarui secara berkala selama eksekusi tugas Anda ketika sesuatu dibaca dari sumber dan dikirim melalui jaringan. Jika DataSync gagal mentransfer sesuatu, nilai ini bisa kurang dari `EstimatedFilesToTransfer` atau`EstimatedFoldersToTransfer`. Dalam beberapa kasus, nilai ini juga bisa lebih besar dari `EstimatedFilesToTransfer` atau`EstimatedFoldersToTransfer`. Penghitung ini khusus implementasi untuk beberapa jenis lokasi, jadi jangan gunakan sebagai indikasi pasti tentang apa yang ditransfer atau untuk memantau pelaksanaan tugas Anda. |
| **Ditransfer** | `FilesTransferred`, `FoldersTransferred` | Ditingkatkan | Jumlah file atau objek, dan direktori yang DataSync ditransfer melalui jaringan. Nilai ini diperbarui secara berkala selama eksekusi tugas Anda ketika sesuatu dibaca dari sumber dan dikirim melalui jaringan. Jika DataSync gagal mentransfer sesuatu, nilai ini bisa kurang dari `EstimatedFilesToTransfer` atau`EstimatedFoldersToTransfer`. Dalam beberapa kasus, nilai ini juga bisa lebih besar dari `EstimatedFilesToTransfer` atau`EstimatedFoldersToTransfer`. Penghitung ini khusus implementasi untuk beberapa jenis lokasi, jadi jangan gunakan sebagai indikasi pasti tentang apa yang ditransfer atau untuk memantau pelaksanaan tugas Anda. |
| **Terverifikasi** | `FilesVerified` | Basic | Jumlah file, objek, dan direktori yang DataSync memverifikasi selama transfer Anda. Ketika Anda mengonfigurasi tugas Anda untuk [memverifikasi hanya data yang ditransfer](configure-data-verification-options.md), DataSync tidak memverifikasi direktori dalam beberapa situasi atau file atau objek yang gagal ditransfer. |
| **Terverifikasi** | `FilesVerified`, `FoldersVerified` | Ditingkatkan | Jumlah file atau objek, dan direktori yang DataSync memverifikasi selama transfer Anda. |
# Memantau transfer data dengan CloudWatch metrik Amazon
Amazon CloudWatch menyediakan metrik untuk melacak kinerja DataSync transfer dan memecahkan masalah dengan tugas transfer Anda.
Anda dapat memantau kinerja AWS DataSync transfer dengan menggunakan CloudWatch metrik Amazon. DataSync metrik secara otomatis dikirim ke CloudWatch dalam interval 5 menit (terlepas dari bagaimana Anda [mengonfigurasi logging](configure-logging.md)). Metrik dipertahankan untuk jangka waktu 15 bulan.
Untuk melihat CloudWatch metrik DataSync, Anda dapat menggunakan alat berikut:
+ CloudWatch Konsol
+ CloudWatch CLI
+ CloudWatch API
+ DataSync Konsol (di halaman detail eksekusi tugas)
Untuk informasi selengkapnya, lihat [https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/working_with_metrics.html](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/working_with_metrics.html).
## CloudWatch metrik untuk DataSync
DataSync metrik menggunakan `aws/datasync` namespace dan menyediakan metrik untuk dimensi berikut:
+ **AgentId**— ID unik agen (jika tugas Anda menggunakan agen).
+ **TaskId**— ID unik tugas. URL ini menggunakan bentuk `task-01234567890abcdef`.
Namespace `aws/datasync` mencakup metrik berikut. Beberapa metrik tidak tersedia dengan setiap [mode tugas](choosing-task-mode.md).
| CloudWatch metrik | Dukungan mode tugas | Deskripsi |
| --- | --- | --- |
| `BytesCompressed` | Basic | Jumlah byte fisik yang DataSync ditransfer melalui jaringan setelah kompresi (jika kompresi dimungkinkan). Jumlah ini biasanya kurang dari `BytesTransferred` kecuali data tidak dapat dimampatkan. Unit: Bita |
| `BytesPreparedDestination` | Basic | Jumlah byte logis yang DataSync mempersiapkan di lokasi tujuan. Unit: Bita |
| `BytesPreparedSource` | Basic | Jumlah byte logis yang DataSync mempersiapkan di lokasi sumber. Unit: Bita |
| `BytesTransferred` | Basic | Jumlah byte yang DataSync dikirim ke jaringan sebelum kompresi (jika kompresi dimungkinkan). Untuk jumlah byte yang ditransfer melalui jaringan, lihat `BytesCompressed` metrik. Unit: Bita |
| `BytesVerifiedDestination` | Basic | Jumlah byte logis yang DataSync memverifikasi di lokasi tujuan. Unit: Bita |
| `BytesVerifiedSource` | Basic | Jumlah byte logis yang DataSync memverifikasi di lokasi sumber. Unit: Bita |
| `BytesWritten` | Ditingkatkan, Dasar | Jumlah byte logis yang DataSync menulis ke lokasi tujuan. Unit: Bita |
| `FilesDeleted` | Ditingkatkan, Dasar | Jumlah file, objek, dan direktori yang DataSync dihapus di lokasi tujuan Anda. Jika Anda tidak mengonfigurasi tugas untuk [menghapus data di tujuan yang tidak ada di sumber](configure-metadata.md#task-option-file-object-handling), nilainya selalu`0`. Unit: Jumlah |
| `FilesListedSource` | Ditingkatkan | Jumlah objek yang DataSync ditemukan di lokasi sumber Anda. Unit: Jumlah |
| `FilesPrepared` | Ditingkatkan | Jumlah objek yang DataSync akan mencoba mentransfer setelah membandingkan lokasi sumber dan tujuan Anda. Untuk informasi selengkapnya, lihat [Bagaimana DataSync mempersiapkan transfer data Anda](how-datasync-transfer-works.md#how-datasync-prepares). Metrik ini tidak berlaku jika Anda mengonfigurasi tugas untuk [mentransfer semua data](configure-metadata.md#task-option-transfer-mode). Dalam skenario itu DataSync , salin semuanya dari sumber ke tujuan tanpa membandingkan perbedaan antar lokasi. Unit: Jumlah |
| `FilesPreparedDestination` | Basic | Jumlah file, objek, dan direktori yang DataSync disiapkan di lokasi tujuan. Unit: Jumlah |
| `FilesPreparedSource` | Basic | Jumlah file, objek, dan direktori yang DataSync disiapkan di lokasi sumber. Unit: Jumlah |
| `FilesSkipped` | Basic | Jumlah file, objek, dan direktori yang DataSync dilewati selama transfer Anda. Unit: Jumlah |
| `FilesTransferred` | Ditingkatkan, Dasar | Jumlah file, objek, dan direktori yang DataSync ditransfer melalui jaringan. Nilai ini diperbarui secara berkala selama [eksekusi tugas](run-task.md#understand-task-execution-statuses) ketika sesuatu dibaca dari sumber dan dikirim melalui jaringan. Nilai ini bisa kurang dari `EstimatedFilesToTransfer` [DescribeTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html)respons jika DataSync gagal mentransfer sesuatu. Dalam beberapa kasus, nilai ini juga bisa lebih besar dari`EstimatedFilesToTransfer`. Metrik ini khusus implementasi untuk beberapa jenis lokasi, jadi jangan gunakan sebagai indikasi pasti tentang apa yang ditransfer atau untuk memantau pelaksanaan tugas Anda. Unit: Jumlah |
| `FilesVerified` | Ditingkatkan | Jumlah objek yang DataSync memverifikasi selama transfer Anda. Unit: Jumlah |
| `FilesVerifiedDestination` | Basic | Jumlah file, objek, dan direktori yang DataSync memverifikasi di lokasi tujuan. Unit: Jumlah |
| `FilesVerifiedSource` | Basic | Jumlah file, objek, dan direktori yang DataSync memverifikasi di lokasi sumber. Unit: Jumlah |
# Memantau transfer data Anda dengan laporan tugas
*Laporan tugas* memberikan informasi terperinci tentang AWS DataSync upaya untuk mentransfer, melewati, memverifikasi, dan menghapus selama pelaksanaan tugas. Untuk informasi selengkapnya, lihat [Cara DataSync mentransfer file, objek, dan direktori](how-datasync-transfer-works.md#transferring-files).
Laporan tugas dihasilkan dalam format JSON. Anda dapat menyesuaikan tingkat detail dalam laporan Anda:
+ [Ringkasan hanya laporan tugas](#task-report-types-summary) yang memberi Anda rincian yang diperlukan tentang pelaksanaan tugas Anda, seperti berapa banyak file yang ditransfer dan apakah DataSync dapat memverifikasi integritas data dari file-file tersebut.
+ [Laporan tugas standar](#task-report-types-standard) mencakup ringkasan ditambah laporan terperinci yang mencantumkan setiap file, objek, atau folder yang DataSync mencoba mentransfer, melewati, memverifikasi, dan menghapus. Dengan laporan tugas standar, Anda juga dapat menentukan [tingkat laporan](#task-report-level) untuk hanya menampilkan kesalahan eksekusi tugas atau keberhasilan dan kesalahannya.
## Kasus penggunaan
Berikut adalah beberapa situasi di mana laporan tugas dapat membantu Anda memantau dan mengaudit transfer data Anda:
+ Saat memigrasi jutaan file, identifikasi file dengan cepat yang DataSync memiliki masalah saat mentransfer.
+ Verifikasi chain-of-custody proses untuk file Anda.
## Ringkasan hanya laporan tugas
Laporan yang hanya ringkasan pelaksanaan tugas mencakup rincian berikut:
+ Akun AWS Yang menjalankan eksekusi tugas
+ Lokasi sumber dan tujuan
+ Jumlah total file, objek, dan folder yang dilewati, ditransfer, diverifikasi, dan dihapus
+ Total byte (logis dan fisik) yang ditransfer
+ Jika eksekusi tugas selesai, dibatalkan, atau mengalami kesalahan
+ Waktu mulai dan berakhir (termasuk total waktu transfer)
+ Pengaturan tugas (seperti batas bandwidth, verifikasi integritas data, dan opsi lain untuk DataSync transfer Anda)
## Laporan tugas standar
Laporan tugas standar mencakup [ringkasan](#task-report-types-summary) pelaksanaan tugas Anda ditambah laporan terperinci tentang DataSync upaya untuk mentransfer, melewati, memverifikasi, dan menghapus.
**Topics**
+ [Tingkat laporan](#task-report-level)
+ [Laporan yang ditransfer](#task-report-types-transferred)
+ [Laporan yang dilewati](#task-report-types-skipped)
+ [Laporan terverifikasi](#task-report-types-verified)
+ [Laporan yang dihapus](#task-report-types-deleted)
### Tingkat laporan
Dengan laporan tugas standar, Anda dapat memilih salah satu tingkat laporan berikut:
+ Kesalahan saja
+ Keberhasilan dan kesalahan (pada dasarnya daftar semua yang terjadi selama pelaksanaan tugas Anda)
Misalnya, Anda mungkin ingin melihat file mana yang berhasil DataSync dilewati selama transfer dan mana yang tidak. File yang berhasil DataSync dilewati mungkin merupakan file yang sengaja DataSync ingin Anda kecualikan karena sudah ada di lokasi tujuan Anda. Namun, kesalahan yang dilewati misalnya mungkin menunjukkan bahwa DataSync tidak memiliki izin yang tepat untuk membaca file.
### Laporan yang ditransfer
Daftar file, objek, dan direktori yang DataSync mencoba mentransfer selama pelaksanaan tugas Anda. Laporan yang ditransfer mencakup rincian berikut:
+ Jalur untuk data yang ditransfer
+ Apa yang ditransfer (konten, metadata, atau keduanya)
+ Metadata, yang mencakup tipe data, ukuran konten (hanya objek dan file), dan banyak lagi
+ Waktu ketika suatu barang ditransfer
+ Versi objek (jika tujuannya adalah bucket Amazon S3 yang mengaktifkan versi)
+ Jika ada sesuatu yang ditimpa di tujuan
+ Apakah item berhasil ditransfer
**catatan**
Saat memindahkan data antar bucket S3, awalan yang Anda tentukan di [lokasi sumber](create-s3-location.md) dapat muncul di laporan Anda (atau di CloudWatch log Amazon), meskipun awalan itu tidak ada sebagai objek di lokasi tujuan Anda. (Di DataSync konsol, Anda mungkin juga melihat awalan ini muncul sebagai data yang dilewati atau diverifikasi.)
### Laporan yang dilewati
Daftar file, objek, dan direktori yang DataSync ditemukan di lokasi sumber Anda tetapi tidak mencoba untuk mentransfer. Alasan DataSync melewatkan data dapat bergantung pada beberapa faktor, seperti cara Anda mengonfigurasi tugas dan izin sistem penyimpanan. Berikut ini adalah beberapa contohnya:
+ Ada file yang ada di lokasi sumber dan tujuan Anda. File di sumber belum dimodifikasi sejak eksekusi tugas sebelumnya. Karena Anda [hanya mentransfer data yang telah berubah](configure-metadata.md#task-option-transfer-mode), DataSync tidak mentransfer file itu saat Anda menjalankan tugas berikutnya.
+ Objek yang ada di kedua lokasi Anda berubah di sumber Anda. Saat menjalankan tugas, DataSync lewati objek ini di tujuan karena tugas Anda tidak [menimpa data di](configure-metadata.md#task-option-file-object-handling) tujuan.
+ DataSync melewatkan objek di sumber Anda yang menggunakan [kelas penyimpanan arsip](create-s3-location.md#using-storage-classes) dan tidak dipulihkan. Anda harus mengembalikan objek yang diarsipkan DataSync untuk membacanya.
+ DataSync melewatkan file, objek, atau direktori di lokasi sumber Anda karena tidak dapat membacanya. Jika ini terjadi dan tidak diharapkan, periksa izin akses penyimpanan Anda dan pastikan itu DataSync dapat membaca apa yang dilewati.
Laporan yang dilewati mencakup detail berikut:
+ Jalur untuk data yang dilewati
+ Waktu ketika item dilewati
+ Alasan itu dilewati
+ Apakah item berhasil dilewati
**catatan**
Laporan yang dilewati bisa berukuran besar jika menyertakan keberhasilan dan kesalahan, Anda mengonfigurasi tugas Anda untuk [mentransfer hanya data yang telah berubah](configure-metadata.md), dan data sumber sudah ada di tujuan.
### Laporan terverifikasi
Daftar file, objek, dan direktori yang DataSync mencoba memverifikasi integritas selama pelaksanaan tugas Anda. Laporan data terverifikasi mencakup rincian berikut:
+ Jalur untuk data terverifikasi
+ Waktu ketika item diverifikasi
+ Alasan kesalahan verifikasi (jika ada)
+ SHA256 Checksum sumber dan tujuan (hanya file)
+ Apakah item berhasil diverifikasi
Perhatikan hal berikut tentang laporan terverifikasi:
+ Ketika Anda mengonfigurasi tugas Anda untuk [memverifikasi hanya data yang ditransfer](configure-data-verification-options.md), DataSync tidak memverifikasi direktori dalam beberapa situasi atau file atau objek yang gagal ditransfer. Dalam kedua kasus tersebut, DataSync tidak menyertakan data yang belum diverifikasi dalam laporan ini.
+ Jika Anda menggunakan [mode Enhanced](choosing-task-mode.md), verifikasi mungkin memakan waktu lebih lama dari biasanya jika Anda mentransfer objek besar.
### Laporan yang dihapus
Daftar file, direktori, dan objek yang dihapus selama eksekusi tugas Anda. DataSync menghasilkan laporan ini hanya jika [Anda mengonfigurasi tugas](configure-metadata.md) untuk menghapus data di lokasi tujuan yang tidak ada di sumbernya. Laporan data yang dihapus mencakup rincian berikut:
+ Jalur untuk data yang dihapus
+ Apakah item berhasil dihapus
+ Waktu ketika item dihapus
## Contoh laporan tugas
Tingkat detail dalam laporan tugas Anda terserah Anda. Berikut adalah beberapa contoh laporan data yang ditransfer dengan konfigurasi berikut:
+ **Jenis laporan** - Standar
+ **Tingkat laporan** - Keberhasilan dan kesalahan
**catatan**
Laporan menggunakan standar ISO-8601 untuk format stempel waktu. Waktu dalam UTC dan diukur dalam nanodetik. Perilaku ini berbeda dari bagaimana beberapa metrik laporan tugas lainnya diukur. Misalnya, [detail eksekusi tugas](https://docs.aws.amazon.com/datasync/latest/userguide/API_TaskExecutionResultDetail.html), seperti `TransferDuration` dan`VerifyDuration`, diukur dalam milidetik.
Laporan tugas mode yang disempurnakan menggunakan skema yang agak berbeda dari laporan tugas mode Dasar. Contoh berikut dapat membantu Anda mengetahui apa yang diharapkan dari laporan Anda tergantung pada [mode tugas](choosing-task-mode.md) yang Anda gunakan.
**Contoh laporan data yang ditransfer dengan status sukses**
Laporan berikut menunjukkan transfer yang berhasil untuk objek bernama`object1.txt`.
```
{
"TaskExecutionId": "exec-abcdefgh12345678",
"Transferred": [{
"RelativePath": "object1.txt",
"SourceMetadata": {
"Type": "Object",
"ContentSize": 6,
"LastModified": "2024-10-04T14:40:55Z",
"SystemMetadata": {
"ContentType": "binary/octet-stream",
"ETag": "\"9b2d7e1f8054c3a2041905d0378e6f14\"",
"ServerSideEncryption": "AES256"
},
"UserMetadata": {},
"Tags": []
},
"Overwrite": "False",
"DstS3VersionId": "jtqRtX3jN4J2G8k0sFSGYK1f35KqpAVP",
"TransferTimestamp": "2024-10-04T14:48:39.748862183Z",
"TransferType": "CONTENT_AND_METADATA",
"TransferStatus": "SUCCESS"
}]
}
```
```
{
"TaskExecutionId": "exec-abcdefgh12345678",
"Transferred": [{
"RelativePath": "/object1.txt",
"SrcMetadata": {
"Type": "Regular",
"ContentSize": 6,
"Mtime": "2022-01-07T16:59:26.136114671Z",
"Atime": "2022-01-07T16:59:26.136114671Z",
"Uid": 0,
"Gid": 0,
"Mode": "0644"
},
"Overwrite": "False",
"DstS3VersionId": "jtqRtX3jN4J2G8k0sFSGYK1f35KqpAVP",
"TransferTimestamp": "2022-01-07T16:59:45.747270957Z",
"TransferType": "CONTENT_AND_METADATA",
"TransferStatus": "SUCCESS"
}]
}
```
**Contoh laporan data yang ditransfer dengan status kesalahan**
Laporan berikut memberikan contoh kapan tidak DataSync dapat mentransfer objek bernama`object1.txt`.
Laporan ini menunjukkan bahwa tidak DataSync dapat mengakses objek bernama `object1.txt` karena masalah AWS KMS izin. (Jika Anda mendapatkan kesalahan seperti ini, lihat[Mengakses bucket S3 menggunakan enkripsi sisi server](create-s3-location.md#create-s3-location-encryption).)
```
{
"TaskExecutionId": "exec-abcdefgh12345678",
"Transferred": [{
"RelativePath": "object1.txt",
"SourceMetadata": {
"Type": "Object",
"ContentSize": 6,
"LastModified": "2022-10-07T20:48:32Z",
"SystemMetadata": {
"ContentType": "binary/octet-stream",
"ETag": "\"3a7c0b2f1d9e5c4a6f8b2e0d1c9f7a3b2\"",
"ServerSideEncryption": "AES256"
},
"UserMetadata": {},
"Tags": []
},
"Overwrite": "False",
"TransferTimestamp": "2022-10-09T16:05:11.134040717Z",
"TransferType": "CONTENT_AND_METADATA",
"TransferStatus": "FAILED",
"ErrorCode": "AccessDenied",
"ErrorDetail": "User: arn:aws:sts::111222333444:assumed-role/AWSDataSyncS3Bucket/AwsSync-loc-0b3017fc4ba4a2d8d is not authorized to perform: kms:GenerateDataKey on resource: arn:aws:kms:us-east-1:111222333444:key/1111aaaa-22bb-33cc-44d-5555eeee6666 because no identity-based policy allows the kms:GenerateDataKey action"
}]
}
```
Laporan ini menunjukkan bahwa objek bernama `object1.txt` tidak ditransfer karena masalah izin bucket S3. (Jika Anda mendapatkan kesalahan seperti ini, lihat[Menyediakan DataSync akses ke bucket S3](create-s3-location.md#create-s3-location-access).)
```
{
"TaskExecutionId": "exec-abcdefgh12345678",
"Transferred": [{
"RelativePath": "/object1.txt",
"SrcMetadata": {
"Type": "Regular",
"ContentSize": 6,
"Mtime": "2022-01-07T16:59:26.136114671Z",
"Atime": "2022-01-07T16:59:26.136114671Z",
"Uid": 0,
"Gid": 0,
"Mode": "0644"
},
"Overwrite": "False",
"DstS3VersionId": "jtqRtX3jN4J2G8k0sFSGYK1f35KqpAVP",
"TransferTimestamp": "2022-01-07T16:59:45.747270957Z",
"TransferType": "CONTENT_AND_METADATA",
"TransferStatus": "FAILED",
"FailureReason": "S3 Get Object Failed",
"FailureCode": 40974
}]
}
```
## Batasan
+ Laporan tugas individu tidak boleh melebihi 5 MB. Jika Anda menyalin sejumlah besar file, laporan tugas Anda mungkin dibagi menjadi beberapa laporan.
+ Ada situasi saat membuat laporan tugas dapat memengaruhi kinerja transfer data Anda. Misalnya, Anda mungkin memperhatikan hal ini ketika koneksi jaringan Anda memiliki latensi tinggi dan file yang Anda transfer kecil atau Anda hanya menyalin perubahan metadata.
# Membuat laporan DataSync tugas Anda
AWS DataSync Laporan tugas hanya dapat berupa ringkasan pelaksanaan tugas Anda atau serangkaian laporan terperinci tentang DataSync upaya untuk mentransfer, melewati, memverifikasi, dan menghapus.
## Prasyarat
Sebelum Anda dapat membuat laporan tugas, Anda harus melakukan hal berikut.
**Topics**
+ [Buat bucket S3 untuk laporan tugas Anda](#setting-up-task-report-create-bucket)
+ [Izinkan DataSync untuk mengunggah laporan tugas ke bucket S3 Anda](#task-report-access)
### Buat bucket S3 untuk laporan tugas Anda
Jika Anda belum memilikinya, [buat bucket S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-bucket-overview.html) tempat DataSync dapat mengunggah laporan tugas Anda. Laporan disimpan di kelas penyimpanan Standar S3.
Kami merekomendasikan hal berikut untuk ember ini:
+ Jika Anda berencana untuk mentransfer data ke bucket S3, jangan gunakan bucket yang sama untuk laporan tugas jika Anda [menonaktifkan opsi **Simpan file yang dihapus**](configure-metadata.md). Jika tidak, DataSync akan menghapus laporan tugas sebelumnya setiap kali Anda menjalankan tugas karena laporan tersebut tidak ada di lokasi sumber Anda.
+ Untuk menghindari penyiapan izin akses yang rumit, pastikan bucket laporan tugas Anda sama Akun AWS dan Wilayah sebagai tugas DataSync transfer Anda.
### Izinkan DataSync untuk mengunggah laporan tugas ke bucket S3 Anda
Anda harus mengonfigurasi peran AWS Identity and Access Management (IAM) yang memungkinkan DataSync untuk mengunggah laporan tugas ke bucket S3 Anda.
Di DataSync konsol, Anda dapat membuat peran IAM yang dalam kebanyakan kasus secara otomatis menyertakan izin untuk mengunggah laporan tugas ke bucket Anda. Ingatlah bahwa peran yang dihasilkan secara otomatis ini mungkin tidak memenuhi kebutuhan Anda dari sudut pandang hak istimewa yang paling sedikit. Peran ini juga tidak akan berfungsi jika bucket Anda dienkripsi dengan kunci terkelola pelanggan AWS Key Management Service (AWS KMS) (SSE-KMS). Dalam kasus ini, Anda dapat membuat peran secara manual selama peran tersebut melakukan setidaknya hal berikut:
+ [Mencegah masalah wakil yang membingungkan lintas layanan](https://docs.aws.amazon.com/datasync/latest/userguide/cross-service-confused-deputy-prevention.html) dalam entitas tepercaya peran.
Contoh lengkap berikut menunjukkan bagaimana Anda dapat menggunakan kunci konteks kondisi `aws:SourceAccount` global `aws:SourceArn` dan global untuk mencegah masalah wakil yang membingungkan DataSync.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "datasync.amazonaws.com"
},
"Action": "sts:AssumeRole",
"Condition": {
"StringEquals": {
"aws:SourceAccount": "123456789012"
},
"ArnLike": {
"aws:SourceArn": "arn:aws:datasync:us-east-1:123456789012:*"
}
}
}
]
}
```
------
+ Memungkinkan DataSync untuk mengunggah laporan tugas ke bucket S3 Anda.
Contoh berikut melakukan ini dengan menyertakan `s3:PutObject` tindakan hanya untuk awalan (`reports/`) tertentu di bucket Anda.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [{
"Action": [
"s3:PutObject"
],
"Effect": "Allow",
"Resource": "arn:aws:s3:::your-task-reports-bucket/reports/*"
}]
}
```
------
+ Jika bucket S3 Anda dienkripsi dengan kunci SSE-KMS yang dikelola pelanggan, [kebijakan](https://docs.aws.amazon.com/kms/latest/developerguide/key-policy-modifying.html) kunci harus menyertakan peran IAM yang digunakan untuk mengakses bucket. DataSync
Untuk informasi selengkapnya, lihat [Mengakses bucket S3 menggunakan enkripsi sisi server](create-s3-location.md#create-s3-location-encryption).
## Membuat laporan tugas ringkasan saja
Anda dapat mengonfigurasi laporan tugas yang menyertakan [ringkasan hanya](task-reports.md#task-report-types-summary) saat membuat DataSync tugas, memulai tugas, atau memperbarui tugas.
Langkah-langkah berikut menunjukkan cara mengonfigurasi laporan tugas ringkasan saja saat membuat tugas.
### Menggunakan DataSync konsol
1. Buka AWS DataSync konsol di [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/).
1. Di panel navigasi kiri, perluas **Transfer data**, lalu pilih **Tugas**, lalu pilih **Buat tugas**.
1. Konfigurasikan lokasi sumber dan tujuan tugas Anda.
Untuk informasi selengkapnya, lihat [Di mana saya dapat mentransfer data saya AWS DataSync?](working-with-locations.md)
1. Gulir ke bawah ke bagian **Laporan tugas**. Untuk **jenis Laporan**, pilih **Ringkasan saja**.
1. Untuk **bucket S3 untuk laporan**, pilih bucket S3 tempat Anda ingin DataSync mengunggah laporan tugas.
**Tip**
Jika Anda berencana untuk mentransfer data ke bucket S3, jangan gunakan bucket yang sama untuk laporan tugas jika Anda [menonaktifkan opsi **Simpan file yang dihapus**](configure-metadata.md). Jika tidak, DataSync akan menghapus laporan tugas sebelumnya setiap kali Anda menjalankan tugas karena laporan tersebut tidak ada di lokasi sumber Anda.
1. Untuk **Folder**, masukkan awalan yang akan digunakan untuk laporan tugas saat DataSync mengunggah laporan ke bucket S3 (misalnya,). **reports/**
Pastikan untuk menyertakan karakter pembatas yang sesuai di akhir awalan Anda. Karakter ini biasanya garis miring (`/`). Untuk informasi selengkapnya, lihat [Mengatur objek menggunakan awalan](https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-prefixes.html) di Panduan Pengguna *Amazon S3*.
1. Untuk **IAM role**, lakukan salah satu hal berikut ini:
+ Pilih **Autogenerate** agar secara DataSync otomatis membuat peran IAM dengan izin yang diperlukan untuk mengakses bucket S3.
Jika DataSync sebelumnya membuat peran IAM untuk bucket S3 ini, peran tersebut dipilih secara default.
+ Pilih peran IAM kustom yang Anda buat.
Dalam beberapa kasus, Anda mungkin perlu membuat peran sendiri. Untuk informasi selengkapnya, lihat [Izinkan DataSync untuk mengunggah laporan tugas ke bucket S3 Anda](#task-report-access).
**penting**
Jika bucket S3 Anda dienkripsi dengan kunci SSE-KMS yang dikelola pelanggan, kebijakan kunci harus menyertakan peran IAM yang digunakan untuk mengakses bucket. DataSync
Untuk informasi selengkapnya, lihat [Mengakses bucket S3 menggunakan enkripsi sisi server](create-s3-location.md#create-s3-location-encryption).
1. Selesai membuat tugas Anda, dan kemudian [mulai tugas](run-task.md) untuk mulai mentransfer data Anda.
Ketika transfer Anda selesai, Anda dapat [melihat laporan tugas Anda](task-report-viewing.md).
### Menggunakan AWS CLI
1. Salin perintah `create-task` AWS Command Line Interface (AWS CLI) berikut:
```
aws datasync create-task \
--source-location-arn arn:aws:datasync:us-east-1:123456789012:location/loc-12345678abcdefgh \
--destination-location-arn arn:aws:datasync:us-east-1:123456789012:location/loc-abcdefgh12345678 \
--task-report-config '{
"Destination":{
"S3":{
"Subdirectory":"reports/",
"S3BucketArn":"arn:aws:s3:::your-task-reports-bucket",
"BucketAccessRoleArn":"arn:aws:iam::123456789012:role/bucket-iam-role"
}
},
"OutputType":"SUMMARY_ONLY"
}'
```
1. Untuk `--source-location-arn` parameter, tentukan Nama Sumber Daya Amazon (ARN) dari lokasi sumber dalam transfer Anda. Ganti `us-east-1` dengan yang sesuai Wilayah AWS, ganti `123456789012` dengan Akun AWS nomor yang sesuai, dan ganti `12345678abcdefgh` dengan ID lokasi sumber yang sesuai.
1. Untuk `--destination-location-arn` parameter, tentukan ARN dari lokasi tujuan dalam transfer Anda. Ganti `us-east-1` dengan yang sesuai Wilayah AWS, ganti `123456789012` dengan Akun AWS nomor yang sesuai, dan ganti `abcdefgh12345678` dengan ID lokasi tujuan yang sesuai.
1. Untuk `--task-report-config` parameter, lakukan hal berikut:
+ `Subdirectory`— Ganti `reports/` dengan awalan di bucket S3 tempat Anda ingin DataSync mengunggah laporan tugas Anda.
Pastikan untuk menyertakan karakter pembatas yang sesuai di akhir awalan Anda. Karakter ini biasanya garis miring (`/`). Untuk informasi selengkapnya, lihat [Mengatur objek menggunakan awalan](https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-prefixes.html) di Panduan Pengguna *Amazon S3*.
+ `S3BucketArn`— Tentukan ARN bucket S3 tempat Anda ingin mengunggah laporan tugas Anda.
**Tip**
Jika Anda berencana untuk mentransfer data ke bucket S3, jangan gunakan bucket yang sama untuk laporan tugas jika Anda [menonaktifkan opsi **Simpan file yang dihapus**](configure-metadata.md). Jika tidak, DataSync akan menghapus laporan tugas sebelumnya setiap kali Anda menjalankan tugas karena laporan tersebut tidak ada di lokasi sumber Anda.
+ `BucketAccessRoleArn`— Tentukan peran IAM yang memungkinkan DataSync untuk mengunggah laporan tugas ke bucket S3 Anda.
Untuk informasi selengkapnya, lihat [Izinkan DataSync untuk mengunggah laporan tugas ke bucket S3 Anda](#task-report-access).
**penting**
Jika bucket S3 Anda dienkripsi dengan kunci SSE-KMS yang dikelola pelanggan, kebijakan kunci harus menyertakan peran IAM yang digunakan untuk mengakses bucket. DataSync
Untuk informasi selengkapnya, lihat [Mengakses bucket S3 menggunakan enkripsi sisi server](create-s3-location.md#create-s3-location-encryption).
+ `OutputType`— Tentukan`SUMMARY_ONLY`.
Untuk informasi selengkapnya, lihat [Ringkasan hanya laporan tugas](task-reports.md#task-report-types-summary).
1. Jalankan `create-task` perintah untuk membuat tugas Anda.
Anda mendapatkan respons seperti berikut yang menunjukkan ARN dari tugas yang Anda buat. Anda akan membutuhkan ARN ini untuk menjalankan perintah. `start-task-execution`
```
{
"TaskArn": "arn:aws:datasync:us-east-1:123456789012:task/task-12345678abcdefgh"
}
```
1. Salin `start-task-execution` perintah berikut.
```
aws datasync-task-report start-task-execution \
--task-arn arn:aws:datasync:us-east-1:123456789012:task/task-12345678abcdefgh
```
1. Untuk `--task-arn` parameter, tentukan ARN dari tugas yang Anda mulai. Gunakan ARN yang Anda terima dari menjalankan perintah. `create-task`
1. Jalankan perintah `start-task-execution`.
Ketika transfer Anda selesai, Anda dapat [melihat laporan tugas Anda](task-report-viewing.md).
## Membuat laporan tugas standar
Anda dapat mengonfigurasi [laporan tugas standar](task-reports.md#task-report-types-standard) saat membuat DataSync tugas, memulai tugas, atau memperbarui tugas.
Langkah-langkah berikut menunjukkan cara mengonfigurasi laporan tugas standar saat membuat tugas.
### Menggunakan DataSync konsol
1. Buka AWS DataSync konsol di [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/).
1. Di panel navigasi kiri, perluas **Transfer data**, lalu pilih **Tugas**, lalu pilih **Buat tugas**.
1. Konfigurasikan lokasi sumber dan tujuan tugas Anda.
Untuk informasi selengkapnya, lihat [Di mana saya dapat mentransfer data saya AWS DataSync?](working-with-locations.md)
1. Gulir ke bawah ke bagian **Laporan tugas**. Untuk **jenis Laporan**, pilih **Laporan standar**.
1. Untuk **tingkat Laporan**, pilih salah satu dari berikut ini:
+ **Hanya kesalahan** — Laporan tugas Anda hanya mencakup masalah dengan apa yang DataSync mencoba mentransfer, melewati, memverifikasi, dan menghapus.
+ **Keberhasilan dan kesalahan** — Laporan tugas Anda mencakup apa yang DataSync berhasil ditransfer, dilewati, diverifikasi, dan dihapus dan apa yang tidak.
+ **Kustom** - Memungkinkan Anda memilih apakah Anda ingin melihat kesalahan saja atau keberhasilan dan kesalahan untuk aspek tertentu dari laporan tugas Anda.
Misalnya, Anda dapat memilih **Keberhasilan dan kesalahan** untuk daftar file yang ditransfer tetapi **Kesalahan hanya** untuk sisa laporan.
1. Jika Anda mentransfer ke bucket S3 yang menggunakan versi objek, tetap pilih versi objek Sertakan Amazon **S3 jika Anda ingin laporan menyertakan versi baru untuk setiap objek** yang ditransfer.
1. Untuk **bucket S3 untuk laporan**, pilih bucket S3 tempat Anda ingin DataSync mengunggah laporan tugas.
**Tip**
Jika Anda berencana untuk mentransfer data ke bucket S3, jangan gunakan bucket yang sama untuk laporan tugas jika Anda [menonaktifkan opsi **Simpan file yang dihapus**](configure-metadata.md). Jika tidak, DataSync akan menghapus laporan tugas sebelumnya setiap kali Anda menjalankan tugas karena laporan tersebut tidak ada di lokasi sumber Anda.
1. Untuk **Folder**, masukkan awalan yang akan digunakan untuk laporan tugas saat DataSync mengunggah laporan ke bucket S3 (misalnya,). **reports/** Pastikan untuk menyertakan karakter pembatas yang sesuai di akhir awalan Anda. Karakter ini biasanya garis miring (`/`). Untuk informasi selengkapnya, lihat [Mengatur objek menggunakan awalan](https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-prefixes.html) di Panduan Pengguna *Amazon S3*.
1. Untuk **IAM role**, lakukan salah satu hal berikut ini:
+ Pilih **Autogenerate** agar secara DataSync otomatis membuat peran IAM dengan izin yang diperlukan untuk mengakses bucket S3.
Jika DataSync sebelumnya membuat peran IAM untuk bucket S3 ini, peran tersebut dipilih secara default.
+ Pilih peran IAM kustom yang Anda buat.
Dalam beberapa kasus, Anda mungkin perlu membuat peran sendiri. Untuk informasi selengkapnya, lihat [Izinkan DataSync untuk mengunggah laporan tugas ke bucket S3 Anda](#task-report-access).
**penting**
Jika bucket S3 Anda dienkripsi dengan kunci SSE-KMS yang dikelola pelanggan, kebijakan kunci harus menyertakan peran IAM yang digunakan untuk mengakses bucket. DataSync
Untuk informasi selengkapnya, lihat [Mengakses bucket S3 menggunakan enkripsi sisi server](create-s3-location.md#create-s3-location-encryption).
1. Selesai membuat tugas Anda dan [mulai tugas](run-task.md) untuk mulai mentransfer data Anda.
Ketika transfer Anda selesai, Anda dapat [melihat laporan tugas Anda](task-report-viewing.md).
### Menggunakan AWS CLI
1. Salin `create-task` perintah berikut:
```
aws datasync create-task \
--source-location-arn arn:aws:datasync:us-east-1:123456789012:location/loc-12345678abcdefgh \
--destination-location-arn arn:aws:datasync:us-east-1:123456789012:location/loc-abcdefgh12345678 \
--task-report-config '{
"Destination":{
"S3":{
"Subdirectory":"reports/",
"S3BucketArn":"arn:aws:s3:::your-task-reports-bucket",
"BucketAccessRoleArn":"arn:aws:iam::123456789012:role/bucket-iam-role"
}
},
"OutputType":"STANDARD",
"ReportLevel":"level-of-detail",
"ObjectVersionIds":"include-or-not"
}'
```
1. Untuk `--source-location-arn` parameter, tentukan ARN dari lokasi sumber dalam transfer Anda. Ganti `us-east-1` dengan yang sesuai Wilayah AWS, ganti `123456789012` dengan Akun AWS nomor yang sesuai, dan ganti `12345678abcdefgh` dengan ID lokasi sumber yang sesuai.
1. Untuk `--destination-location-arn` parameter, tentukan ARN dari lokasi tujuan dalam transfer Anda. Ganti `us-east-1` dengan yang sesuai Wilayah AWS, ganti `123456789012` dengan Akun AWS nomor yang sesuai, dan ganti `abcdefgh12345678` dengan ID lokasi tujuan yang sesuai.
1. Untuk `--task-report-config` parameter, lakukan hal berikut:
+ `Subdirectory`— Ganti `reports/` dengan awalan di bucket S3 tempat Anda ingin DataSync mengunggah laporan tugas Anda. Pastikan untuk menyertakan karakter pembatas yang sesuai di akhir awalan Anda. Karakter ini biasanya garis miring (`/`). Untuk informasi selengkapnya, lihat [Mengatur objek menggunakan awalan](https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-prefixes.html) di Panduan Pengguna *Amazon S3*.
+ `S3BucketArn`— Tentukan ARN bucket S3 tempat Anda ingin mengunggah laporan tugas Anda.
**Tip**
Jika Anda berencana untuk mentransfer data ke bucket S3, jangan gunakan bucket yang sama untuk laporan tugas jika Anda [menonaktifkan opsi **Simpan file yang dihapus**](configure-metadata.md). Jika tidak, DataSync akan menghapus laporan tugas sebelumnya setiap kali Anda menjalankan tugas karena laporan tersebut tidak ada di lokasi sumber Anda.
+ `BucketAccessRoleArn`— Tentukan peran IAM yang memungkinkan DataSync untuk mengunggah laporan tugas ke bucket S3 Anda.
Untuk informasi selengkapnya, lihat [Izinkan DataSync untuk mengunggah laporan tugas ke bucket S3 Anda](#task-report-access).
**penting**
Jika bucket S3 Anda dienkripsi dengan kunci SSE-KMS yang dikelola pelanggan, kebijakan kunci harus menyertakan peran IAM yang digunakan untuk mengakses bucket. DataSync
Untuk informasi selengkapnya, lihat [Mengakses bucket S3 menggunakan enkripsi sisi server](create-s3-location.md#create-s3-location-encryption).
+ `OutputType`— Tentukan `STANDARD` laporan.
Untuk informasi selengkapnya, lihat [Laporan tugas standar](task-reports.md#task-report-types-standard) Jenis laporan tugas.
+ (Opsional) `ReportLevel` — Tentukan apakah Anda ingin `ERRORS_ONLY` (default) atau `SUCCESSES_AND_ERRORS` dalam laporan Anda.
+ (Opsional) `ObjectVersionIds` — Jika Anda mentransfer ke bucket S3 yang menggunakan versi objek, tentukan `NONE` apakah Anda tidak ingin menyertakan versi baru untuk setiap objek yang ditransfer dalam laporan.
Secara default, opsi ini diatur ke`INCLUDE`.
+ (Opsional) `Overrides` — Sesuaikan `ReportLevel` aspek tertentu dari laporan Anda.
Misalnya, Anda mungkin ingin melihat `SUCCESSES_AND_ERRORS` daftar apa yang DataSync dihapus di lokasi tujuan Anda, tetapi Anda ingin `ERRORS_ONLY` untuk yang lainnya. Dalam contoh ini, Anda akan menambahkan `Overrides` opsi berikut ke `--task-report-config` parameter:
```
"Overrides":{
"Deleted":{
"ReportLevel":"SUCCESSES_AND_ERRORS"
}
}
```
Jika Anda tidak menggunakan`Overrides`, seluruh laporan Anda menggunakan `ReportLevel` yang Anda tentukan.
1. Jalankan `create-task` perintah untuk membuat tugas Anda.
Anda mendapatkan respons seperti berikut yang menunjukkan ARN dari tugas yang Anda buat. Anda akan membutuhkan ARN ini untuk menjalankan perintah. `start-task-execution`
```
{
"TaskArn": "arn:aws:datasync:us-east-1:123456789012:task/task-12345678abcdefgh"
}
```
1. Salin `start-task-execution` perintah berikut.
```
aws datasync-task-report start-task-execution \
--task-arn arn:aws:datasync:us-east-1:123456789012:task/task-12345678abcdefgh
```
1. Untuk `--task-arn` parameter, tentukan ARN dari tugas yang Anda jalankan. Gunakan ARN yang Anda terima dari menjalankan perintah. `create-task`
1. Jalankan perintah `start-task-execution`.
Ketika transfer Anda selesai, Anda dapat [melihat laporan tugas Anda](task-report-viewing.md).
# Melihat laporan DataSync tugas Anda
DataSync membuat laporan tugas untuk setiap eksekusi tugas. Saat eksekusi selesai, Anda dapat menemukan laporan tugas terkait di bucket S3 Anda. Laporan tugas diatur di bawah awalan yang mencakup tugas Anda dan eksekusi mereka. IDs
Untuk membantu menemukan laporan tugas di bucket S3 Anda, gunakan contoh berikut:
+ **Ringkasan hanya laporan tugas** - `reports-prefix/Summary-Reports/task-id-folder/task-execution-id-folder`
+ **Laporan tugas standar** - `reports-prefix/Detailed-Reports/task-id-folder/task-execution-id-folder`
Karena laporan tugas dalam format JSON, Anda memiliki beberapa opsi untuk melihat laporan Anda:
+ Lihat laporan menggunakan [Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/selecting-content-from-objects.html) Select.
+ Visualisasikan laporan dengan menggunakan AWS layanan seperti AWS Glue, Amazon Athena, dan Amazon Quick. Untuk informasi selengkapnya tentang memvisualisasikan laporan tugas Anda, lihat [Blog AWS Penyimpanan](https://aws.amazon.com/blogs/storage/derive-insights-from-aws-datasync-task-reports-using-aws-glue-amazon-athena-and-amazon-quicksight/).
# Memantau transfer data dengan Amazon CloudWatch Logs
Anda dapat memantau AWS DataSync transfer Anda dengan menggunakan CloudWatch Log. Kami menyarankan Anda mengonfigurasi tugas Anda untuk setidaknya mencatat informasi dasar (seperti kesalahan transfer).
## Memungkinkan DataSync untuk mengunggah log ke grup CloudWatch log
Untuk [mengonfigurasi pencatatan](#configure-logging-for-task) untuk DataSync tugas Anda, Anda memerlukan grup CloudWatch log yang DataSync memiliki izin untuk mengirim log. Anda mengatur akses ini melalui peran AWS Identity and Access Management (IAM). Cara kerjanya secara khusus tergantung pada [mode tugas](choosing-task-mode.md) Anda.
------
#### [ Enhanced mode ]
Dengan mode Enhanced, DataSync secara otomatis mengirimkan log tugas ke grup log bernama`/aws/datasync`. Jika grup log itu tidak ada di dalam Anda Wilayah AWS, DataSync buat grup log atas nama Anda dengan menggunakan [peran terkait layanan](https://docs.aws.amazon.com/datasync/latest/userguide/using-service-linked-roles-service-action-2.html) IAM saat Anda membuat tugas.
------
#### [ Basic mode ]
Ada beberapa cara untuk mengatur grup CloudWatch log untuk DataSync tugas menggunakan mode Dasar. Di konsol, Anda dapat secara otomatis membuat peran IAM yang dalam banyak kasus menyertakan izin yang DataSync diperlukan untuk mengunggah log. Ingatlah bahwa peran yang dihasilkan secara otomatis ini mungkin tidak memenuhi kebutuhan Anda dari sudut pandang hak istimewa yang paling sedikit.
Jika Anda ingin menggunakan grup CloudWatch log yang ada atau membuat tugas Anda secara terprogram, Anda harus membuat peran IAM sendiri.
Contoh berikut adalah kebijakan IAM yang memberikan izin ini.
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "DataSyncLogsToCloudWatchLogs",
"Effect": "Allow",
"Action": [
"logs:PutLogEvents",
"logs:CreateLogStream"
],
"Principal": {
"Service": "datasync.amazonaws.com"
},
"Condition": {
"ArnLike": {
"aws:SourceArn": [
"arn:aws:datasync:us-east-1:444455556666:task/*"
]
},
"StringEquals": {
"aws:SourceAccount": "444455556666"
}
},
"Resource": "arn:aws:logs:us-east-1:444455556666:log-group:*:*"
}
]
}
```
Kebijakan menggunakan `Condition` pernyataan untuk membantu memastikan bahwa hanya DataSync tugas dari akun tertentu yang memiliki akses ke grup CloudWatch log yang ditentukan. Kami merekomendasikan penggunaan kunci konteks kondisi [https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-sourceaccount](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-sourceaccount)global [https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-sourcearn](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-sourcearn)dan dalam `Condition` pernyataan ini untuk melindungi dari masalah wakil yang membingungkan. Untuk informasi selengkapnya, lihat [Pencegahan "confused deputy" lintas layanan](cross-service-confused-deputy-prevention.md).
Untuk menentukan DataSync tugas atau tugas, ganti *`region`* dengan kode Wilayah untuk Wilayah AWS tempat tugas berada (misalnya,`us-west-2`), dan ganti *`account-id`* dengan Akun AWS ID akun yang berisi tugas. Untuk menentukan grup CloudWatch log, ganti nilai yang sama. Anda juga dapat memodifikasi `Resource` pernyataan untuk menargetkan grup log tertentu. Untuk informasi selengkapnya tentang penggunaan `SourceArn` dan`SourceAccount`, lihat [Kunci kondisi global](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-sourceaccount) di *Panduan Pengguna IAM*.
Untuk menerapkan kebijakan, simpan pernyataan kebijakan ini ke file di komputer lokal Anda. Kemudian jalankan AWS CLI perintah berikut untuk menerapkan kebijakan sumber daya. Untuk menggunakan perintah contoh ini, ganti `full-path-to-policy-file` dengan path ke file yang berisi pernyataan kebijakan Anda.
```
aws logs put-resource-policy --policy-name trust-datasync --policy-document file://full-path-to-policy-file
```
**catatan**
Jalankan perintah ini dengan menggunakan yang sama Akun AWS dan Wilayah AWS di mana Anda mengaktifkan DataSync agen Anda.
Untuk informasi selengkapnya, lihat [https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html).
------
## Mengonfigurasi pencatatan untuk tugas Anda DataSync
Kami menyarankan Anda mengonfigurasi setidaknya beberapa tingkat pencatatan untuk DataSync tugas Anda.
**Sebelum Anda mulai**
DataSync membutuhkan izin untuk mengunggah log ke grup CloudWatch log. Untuk informasi selengkapnya, lihat [Memungkinkan DataSync untuk mengunggah log ke grup CloudWatch log](#cloudwatchlogs).
### Menggunakan DataSync konsol
Petunjuk berikut menjelaskan cara mengkonfigurasi CloudWatch logging saat membuat tugas. Anda juga dapat mengonfigurasi logging saat mengedit tugas.
1. Buka AWS DataSync konsol di [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/).
1. Di panel navigasi kiri, perluas **Transfer data**, lalu pilih **Tugas**, lalu pilih **Buat tugas**.
1. Konfigurasikan lokasi sumber dan tujuan tugas Anda.
Untuk informasi selengkapnya, lihat [Di mana saya dapat mentransfer data saya AWS DataSync?](working-with-locations.md)
1. Pada halaman **Konfigurasi pengaturan**, pilih [mode tugas](choosing-task-mode.md) dan opsi lainnya.
Anda mungkin tertarik dengan beberapa opsi berikut:
+ Tentukan data apa yang akan ditransfer dengan menggunakan [manifes](transferring-with-manifest.md) atau [filter](filtering.md).
+ Konfigurasikan cara [menangani metadata file](configure-metadata.md) dan [memverifikasi integritas data](configure-data-verification-options.md).
1. Untuk **tingkat Log**, pilih salah satu opsi berikut:
+ **Log informasi dasar seperti kesalahan transfer** — Publikasikan log dengan hanya informasi dasar (seperti kesalahan transfer).
+ **Log semua objek dan file yang ditransfer** — Publikasikan log untuk semua file atau objek yang DataSync mentransfer dan melakukan pemeriksaan integritas data.
+ **Jangan buat log**
1. Lakukan salah satu hal berikut tergantung pada mode tugas yang Anda gunakan untuk membuat atau menentukan grup CloudWatch log:
------
#### [ Enhanced mode ]
Saat Anda memilih **Buat tugas**, DataSync secara otomatis menggunakan (atau membuat) grup log bernama`/aws/datasync`.
------
#### [ Basic mode ]
Untuk **grup CloudWatch log**, tentukan grup log yang DataSync memiliki izin untuk mengunggah log dengan melakukan salah satu hal berikut:
+ Pilih **Autogenerate** untuk secara otomatis membuat grup log yang memungkinkan DataSync untuk mengunggah log ke dalamnya.
+ Pilih grup log yang ada di grup Anda saat ini Wilayah AWS.
Jika Anda memilih grup log yang ada, pastikan grup tersebut [DataSync memiliki izin](#cloudwatchlogs) untuk mengunggah log ke grup log tersebut.
------
1. Pilih **Buat tugas**.
Anda siap untuk [memulai tugas Anda](run-task.md).
### Menggunakan AWS CLI
1. Salin `create-task` perintah berikut:
```
aws datasync create-task \
--source-location-arn "arn:aws:datasync:us-east-1:account-id:location/location-id" \
--destination-location-arn "arn:aws:datasync:us-east-1:account-id:location/location-id" \
--task-mode "ENHANCED-or-BASIC" \
--name "task-name" \
--options '{"LogLevel": "log-level"}' \
--cloudwatch-log-group-arn "arn:aws:logs:us-east-1:account-id:log-group:log-group-name:*"
```
1. Untuk`--source-location-arn`, tentukan Nama Sumber Daya Amazon (ARN) dari lokasi sumber Anda.
1. Untuk`--destination-location-arn`, tentukan ARN lokasi tujuan Anda.
Jika Anda mentransfer lintas Wilayah AWS atau akun, pastikan ARN menyertakan Wilayah atau ID akun lainnya.
1. Untuk`--task-mode`, tentukan `ENHANCED` atau`BASIC`.
1. (Disarankan) Untuk`--name`, tentukan nama untuk tugas Anda yang dapat Anda ingat.
1. Untuk`LogLevel`, tentukan salah satu opsi berikut:
+ `BASIC`— Publikasikan log dengan hanya informasi dasar (seperti kesalahan transfer).
+ `TRANSFER`— Publikasikan log untuk semua file atau objek yang DataSync mentransfer dan melakukan pemeriksaan integritas data.
+ `NONE`— Jangan menghasilkan log.
1. Untuk -`-cloudwatch-log-group-arn`, tentukan ARN dari grup CloudWatch log.
**penting**
Jika `--task-mode` ya`ENHANCED`, Anda tidak perlu menentukan opsi ini. Untuk informasi selengkapnya, lihat [Memungkinkan DataSync untuk mengunggah log ke grup CloudWatch log](#cloudwatchlogs).
1. Jalankan perintah `create-task`.
Jika perintah berhasil, Anda mendapatkan respons yang menunjukkan ARN dari tugas yang Anda buat. Contoh:
```
{
"TaskArn": "arn:aws:datasync:us-east-1:111222333444:task/task-08de6e6697796f026"
}
```
Anda siap untuk [memulai tugas Anda](run-task.md).
### Menggunakan DataSync API
Anda dapat mengonfigurasi CloudWatch pencatatan untuk tugas Anda dengan menggunakan `CloudWatchLogGroupArn` parameter dengan salah satu operasi berikut:
+ [https://docs.aws.amazon.com/datasync/latest/userguide/API_CreateTask.html](https://docs.aws.amazon.com/datasync/latest/userguide/API_CreateTask.html)
+ [https://docs.aws.amazon.com/datasync/latest/userguide/API_UpdateTask.html](https://docs.aws.amazon.com/datasync/latest/userguide/API_UpdateTask.html)
## Melihat log DataSync tugas
Saat [memulai tugas](run-task.md), Anda dapat melihat log eksekusi tugas dengan menggunakan CloudWatch konsol atau AWS CLI (di antara opsi lainnya). Untuk informasi selengkapnya, lihat [https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html).
DataSync menyediakan log terstruktur JSON untuk tugas mode yang Ditingkatkan. Tugas mode dasar memiliki log yang tidak terstruktur. Contoh berikut menunjukkan bagaimana kesalahan verifikasi ditampilkan dalam log mode Peningkatan dibandingkan dengan log mode Dasar.
------
#### [ Enhanced mode log example ]
```
{
"Action": "VERIFY",
"Source": {
"LocationId": "loc-abcdef01234567890",
"RelativePath": "directory1/directory2/file1.txt"
},
"Destination": {
"LocationId": "loc-05ab2fdc272204a5f",
"RelativePath": "directory1/directory2/file1.txt",
"Metadata": {
"Type": "Object",
"ContentSize": 66060288,
"LastModified": "2024-10-03T20:46:58Z",
"S3": {
"SystemMetadata": {
"ContentType": "binary/octet-stream",
"ETag": "\"1234abcd5678efgh9012ijkl3456mnop\"",
"ServerSideEncryption": "AES256"
},
"UserMetadata": {
"file-mtime": "1602647222/222919600"
},
"Tags": {}
}
}
},
"ErrorCode": "FileNotAtSource",
"ErrorDetail": "Verification failed due to file being present at the destination but not at the source"
}
```
------
#### [ Basic mode log example ]
```
[NOTICE] Verification failed > /directory1/directory2/file1.txt
[NOTICE] /directory1/directory2/file1.txt dstMeta: type=R mode=0755 uid=65534 gid=65534 size=8972938 atime=1728657659/0 mtime=1728657659/0 extAttrsHash=0
[NOTICE] dstHash: f9c2cca900301d38b0930367d8d587153154af467da0fdcf1bebc0848ec72c0d
```
------
# Pencatatan panggilan AWS DataSync API dengan AWS CloudTrail
AWS DataSync terintegrasi dengan AWS CloudTrail, layanan yang menyediakan catatan tindakan yang diambil oleh pengguna, peran, atau Layanan AWS dalam DataSync. CloudTrail menangkap semua panggilan API untuk DataSync sebagai peristiwa. Panggilan yang ditangkap termasuk panggilan dari DataSync konsol dan panggilan kode ke operasi DataSync API.
Jika Anda membuat jejak, Anda dapat mengaktifkan pengiriman CloudTrail acara secara berkelanjutan ke bucket Amazon S3, termasuk acara untuk. AWS DataSync Jika Anda tidak mengonfigurasi jejak, Anda masih dapat melihat peristiwa terbaru di CloudTrail konsol dalam **Riwayat acara**. Dengan menggunakan informasi yang dikumpulkan oleh CloudTrail, Anda dapat menentukan permintaan yang dibuat AWS DataSync, alamat IP dari mana permintaan dibuat, siapa yang membuat permintaan, kapan dibuat, dan detail tambahan.
Untuk mempelajari selengkapnya CloudTrail, lihat [Panduan AWS CloudTrail Pengguna](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/).
## Bekerja dengan DataSync informasi di CloudTrail
CloudTrail diaktifkan pada Akun AWS saat Anda membuat akun. Ketika aktivitas terjadi AWS DataSync, aktivitas tersebut dicatat dalam suatu CloudTrail peristiwa bersama dengan Layanan AWS peristiwa lain dalam **sejarah Peristiwa**. Anda dapat melihat, mencari, dan mengunduh acara terbaru di situs Anda Akun AWS. Untuk informasi selengkapnya, lihat [Melihat peristiwa dengan riwayat CloudTrail acara](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html).
Untuk catatan berkelanjutan tentang peristiwa di Akun AWS, termasuk peristiwa untuk AWS DataSync, buat jejak. *Jejak* memungkinkan CloudTrail untuk mengirimkan file log ke bucket Amazon S3. Secara default, saat Anda membuat jejak di konsol, jejak tersebut berlaku untuk semua Wilayah AWS. Trail mencatat peristiwa dari semua Wilayah AWS di AWS partisi yang sama dan mengirimkan file log ke bucket Amazon S3 yang Anda tentukan. Selain itu, Anda dapat mengonfigurasi lainnya Layanan AWS untuk menganalisis lebih lanjut dan menindaklanjuti data peristiwa yang dikumpulkan dalam CloudTrail log. Untuk informasi selengkapnya, lihat berikut:
+ [Gambaran umum untuk membuat jejak](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html)
+ [CloudTrail layanan dan integrasi yang didukung](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html#cloudtrail-aws-service-specific-topics-integrations)
+ [Mengonfigurasi notifikasi Amazon SNS untuk CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/configure-sns-notifications-for-cloudtrail.html)
+ [Menerima file CloudTrail log dari beberapa Wilayah](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/receive-cloudtrail-log-files-from-multiple-regions.html) dan [Menerima file CloudTrail log dari beberapa akun](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-receive-logs-from-multiple-accounts.html)
Semua DataSync tindakan dicatat oleh CloudTrail. (Untuk informasi selengkapnya, lihat [referensi DataSync API](https://docs.aws.amazon.com/datasync/latest/userguide/API_Operations.html).)
Misalnya, panggilan ke`CreateAgent`,`CreateTask`, dan `ListLocations` operasi menghasilkan entri dalam file CloudTrail log.
Setiap entri peristiwa atau log berisi informasi tentang entitas yang membuat permintaan tersebut. Informasi identitas membantu Anda menentukan hal berikut ini:
+ Apakah permintaan dibuat dengan kredensi root atau AWS Identity and Access Management (IAM).
+ Apakah permintaan tersebut dibuat dengan kredensial keamanan sementara untuk satu peran atau pengguna gabungan.
+ Apakah permintaan tersebut dibuat oleh Layanan AWS lain.
Untuk informasi selengkapnya, lihat [CloudTrailuserIdentityelemen](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html) dalam *Panduan AWS CloudTrail Pengguna.*
## Memahami entri file DataSync log
Trail adalah konfigurasi yang memungkinkan pengiriman peristiwa sebagai file log ke bucket Amazon S3 yang Anda tentukan. CloudTrail file log berisi satu atau lebih entri log. Peristiwa mewakili permintaan tunggal dari sumber mana pun dan mencakup informasi tentang tindakan yang diminta, tanggal dan waktu tindakan, parameter permintaan, dan sebagainya. CloudTrail file log bukanlah jejak tumpukan yang diurutkan dari panggilan API publik, jadi file tersebut tidak muncul dalam urutan tertentu.
Contoh berikut menunjukkan entri CloudTrail log yang menunjukkan `CreateTask` operasi.
```
{
"eventVersion": "1.05",
"userIdentity": {
"type": "IAMUser",
"principalId": "1234567890abcdef0",
"arn": "arn:aws:iam::123456789012:user/user1",
"accountId": "123456789012",
"accessKeyId": "access key",
"userName": "user1",
"sessionContext": {
"attributes": {
"mfaAuthenticated": "false",
"creationDate": "2018-12-13T14:56:46Z"
}
},
"invokedBy": "signin.amazonaws.com"
},
"eventTime": "2018-12-13T14:57:02Z",
"eventSource": "datasync.amazonaws.com",
"eventName": "CreateTask",
"awsRegion": "ap-southeast-1",
"sourceIPAddress": "192.0.2.1",
"userAgent": "signin.amazonaws.com",
"requestParameters": {
"cloudWatchLogGroupArn": "arn:aws:logs:ap-southeast-1:123456789012:log-group:MyLogGroup",
"name": "MyTask-NTIzMzY1",
"tags": [],
"destinationLocationArn": "arn:aws:datasync:ap-southeast-1:123456789012:location/loc-abcdef01234567890",
"options": {
"bytesPerSecond": -1,
"verifyMode": "POINT_IN_TIME_CONSISTENT",
"uid": "INT_VALUE",
"posixPermissions": "PRESERVE",
"mtime": "PRESERVE",
"gid": "INT_VALUE",
"preserveDevices": "NONE",
"preserveDeletedFiles": "REMOVE",
"atime": "BEST_EFFORT"
},
"sourceLocationArn": "arn:aws:datasync:ap-southeast-1:123456789012:location/loc-021345abcdef6789"
},
"responseElements": {
"taskArn": "arn:aws:datasync:ap-southeast-1:123456789012:task/task-1234567890abcdef0"
},
"requestID": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"eventID": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
"eventType": "AwsApiCall",
"recipientAccountId": "123456789012"
}
```
# Memantau peristiwa dengan menggunakan Amazon EventBridge
EventBridge Acara Amazon menggambarkan perubahan DataSync sumber daya. Anda dapat menyiapkan aturan untuk mencocokkan peristiwa ini dan merutekannya ke satu atau beberapa fungsi atau pengaliran target. Peristiwa dipancarkan atas dasar upaya terbaik.
## DataSync acara transfer
EventBridge Acara berikut tersedia untuk DataSync transfer.
| **Agent state changes** |
| --- |
| Peristiwa | Deskripsi |
| Online | Agen dikonfigurasi dengan benar dan siap digunakan. Ini adalah status berjalan normal untuk agen. |
| Offline | Agen telah keluar dari kontak dengan DataSync layanan selama lima menit atau lebih. Ini bisa terjadi karena beberapa alasan. Untuk informasi selengkapnya, lihat [Apa yang harus saya lakukan jika agen saya offline?](troubleshooting-datasync-agents.md#troubleshoot-agent-offline) |
| **Location state changes** |
| --- |
| Peristiwa | Deskripsi |
| Menambahkan | DataSync menambahkan lokasi. |
| Available | Lokasi dibuat dan tersedia untuk digunakan. |
| **Task state changes** |
| --- |
| Peristiwa | Deskripsi |
| Available | Tugas itu dibuat dan siap untuk memulai. |
| Berjalan | Tugas sedang berlangsung dan berfungsi dengan baik. |
| Tidak tersedia | Tugas tidak dikonfigurasi dengan benar dan tidak dapat digunakan. Anda mungkin melihat acara ini ketika agen yang terkait dengan tugas tersebut offline. |
| Antre | Tugas lain adalah menjalankan dan menggunakan agen yang sama. DataSync menjalankan tugas secara seri (pertama masuk, keluar pertama). |
| **Task execution state changes** |
| --- |
| Peristiwa | Deskripsi |
| Antrian | Eksekusi tugas lain berjalan dan menggunakan DataSync agen yang sama. Untuk informasi selengkapnya, lihat [Mengetahui kapan tugas Anda antri](run-task.md#queue-task-execution). |
| Peluncuran | DataSync menginisialisasi eksekusi tugas. Status ini biasanya berjalan cepat tetapi dapat memakan waktu hingga beberapa menit. |
| Mempersiapkan | DataSync menentukan data apa yang akan ditransfer. Langkah ini dapat memakan waktu hanya beberapa menit atau beberapa jam tergantung pada jumlah file, objek, atau direktori di kedua lokasi dan bagaimana Anda mengonfigurasi tugas Anda. Persiapan juga mungkin tidak berlaku untuk tugas Anda. Untuk informasi selengkapnya, lihat [Bagaimana DataSync mempersiapkan transfer data Anda](how-datasync-transfer-works.md#how-datasync-prepares). |
| Mentransfer | DataSync melakukan transfer data yang sebenarnya. |
| Verifikasi | DataSync melakukan pemeriksaan integritas data di akhir transfer. |
| Berhasil | Eksekusi tugas berhasil. |
| Membatalkan | Eksekusi tugas sedang dalam proses dibatalkan. |
| Kesalahan | Eksekusi tugas gagal. |
# Pemantauan AWS DataSync dengan alat manual
Anda dapat melacak AWS DataSync transfer Anda dari konsol atau baris perintah.
## Memantau transfer Anda dengan menggunakan DataSync konsol
Anda dapat memantau DataSync transfer Anda dengan menggunakan konsol, yang menyediakan metrik real-time seperti data yang ditransfer, throughput data dan file, dan kompresi data.
**Untuk memantau transfer Anda dengan menggunakan DataSync konsol**
1. Setelah [memulai DataSync tugas](run-task.md#starting-task), pilih **Lihat detail eksekusi**.
1. Lihat metrik tentang transfer Anda.
## Memantau transfer Anda dengan menggunakan AWS CLI
Anda dapat memantau DataSync transfer Anda dengan menggunakan AWS Command Line Interface (AWS CLI).
Salin `describe-task-execution` perintah berikut. Untuk menggunakan perintah contoh ini, ganti `user input placeholders` dengan informasi Anda sendiri.
```
aws datasync describe-task-execution \
--task-execution-arn 'arn:aws:datasync:region:account-id:task/task-id/execution/task-execution-id'
```
Perintah ini mengembalikan informasi tentang eksekusi tugas yang serupa dengan yang ditampilkan berikut ini.
```
{
"BytesCompressed": 3500,
"BytesTransferred": 5000,
"BytesWritten": 5000,
"EstimatedBytesToTransfer": 5000,
"EstimatedFilesToDelete": 10,
"EstimatedFilesToTransfer": 100,
"FilesDeleted": 10,
"FilesSkipped": 0,
"FilesTransferred": 100,
"FilesVerified": 100,
"Result": {
"ErrorCode": "??????",
"ErrorDetail": "??????",
"PrepareDuration": 100,
"PrepareStatus": "SUCCESS",
"TransferDuration": 60,
"TransferStatus": "AVAILABLE",
"VerifyDuration": 30,
"VerifyStatus": "SUCCESS"
},
"StartTime": 1532660733.39,
"Status": "SUCCESS",
"OverrideOptions": {
"Atime": "BEST_EFFORT",
"BytesPerSecond": "1000",
"Gid": "NONE",
"Mtime": "PRESERVE",
"PosixPermissions": "PRESERVE",
"PreserveDevices": "NONE",
"PreserveDeletedFiles": "PRESERVE",
"Uid": "NONE",
"VerifyMode": "POINT_IN_TIME_CONSISTENT"
},
"TaskExecutionArn": "arn:aws:datasync:us-east-1:111222333444:task/task-aaaabbbbccccddddf/execution/exec-1234abcd1234abcd1",
"TaskReportConfig": {
"Destination": {
"S3": {
"BucketAccessRoleArn": "arn:aws:iam::111222333444:role/my-datasync-role",
"S3BucketArn": "arn:aws:s3:::amzn-s3-demo-bucket/*",
"Subdirectory": "reports"
}
},
"ObjectVersionIds": "INCLUDE",
"OutputType": "STANDARD",
"Overrides": {
"Deleted": {
"ReportLevel": "ERRORS_ONLY"
},
"Skipped": {
"ReportLevel": "SUCCESSES_AND_ERRORS"
},
"Transferred": {
"ReportLevel": "ERRORS_ONLY"
},
"Verified": {
"ReportLevel": "ERRORS_ONLY"
}
},
"ReportLevel": "ERRORS_ONLY"
}
}
```
+ Jika eksekusi tugas berhasil, nilai **Status** berubah menjadi **BERHASIL**. Untuk informasi tentang arti elemen respons, lihat[DescribeTaskExecution](API_DescribeTaskExecution.md).
+ Jika eksekusi tugas gagal, hasilnya akan mengirimkan kode kesalahan yang dapat membantu Anda memecahkan masalah. Untuk informasi tentang kode kesalahan, lihat[TaskExecutionResultDetail](API_TaskExecutionResultDetail.md).
## Memantau transfer Anda dengan menggunakan `watch` utilitas
Untuk memantau kemajuan tugas Anda secara real time dari baris perintah, Anda dapat menggunakan `watch` utilitas Unix standar. Nilai durasi eksekusi tugas diukur dalam milidetik.
`watch`Utilitas tidak mengenali DataSync alias. Contoh berikut menunjukkan cara memanggil CLI secara langsung. Untuk menggunakan contoh perintah ini, ganti `user input placeholders` dengan informasi Anda sendiri.
```
# pass '-n 1' to update every second and '-d' to highlight differences
$ watch -n 1 -d \ "aws datasync describe-task-execution --task-execution-arn 'arn:aws:datasync:region:account-id:task/task-id/execution/task execution-id'"
```