Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# 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/).