Memantau AWS DataSync transfer Anda dengan laporan tugas - AWS DataSync
Kasus penggunaanRingkasan hanya laporan tugasLaporan tugas standarContoh laporan tugasPrasyaratMembuat laporan tugas ringkasan sajaMembuat laporan tugas standarMelihat laporan tugas AndaBatasan

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 dengan laporan tugas

Laporan tugas memberikan informasi terperinci tentang AWS DataSync upaya untuk mentransfer, melewati, memverifikasi, dan menghapus selama pelaksanaan tugas.

Laporan tugas dihasilkan dalam format JSON. Anda dapat menyesuaikan tingkat detail dalam laporan Anda:

  • Ringkasan hanya laporan tugas 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 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 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 pelaksanaan tugas Anda ditambah laporan terperinci tentang DataSync upaya untuk mentransfer, melewati, memverifikasi, dan menghapus.

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 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 file. 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, DataSync lewati file itu dan tidak mentransfernya selama eksekusi tugas berikutnya.

  • Objek yang ada di lokasi sumber dan tujuan Anda berubah di sumber Anda. Saat menjalankan tugas, DataSync lewati objek ini di tujuan karena tugas Anda tidak menimpa data di tujuan.

  • DataSync melewatkan direktori di lokasi sumber Anda karena tidak dapat membacanya.

    Jika ini terjadi dan tidak diharapkan, periksa izin akses 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, 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)

  • Sumber dan tujuan SHA256 checksum (hanya file)

  • Apakah item berhasil diverifikasi

catatan

Ketika Anda mengonfigurasi tugas Anda untuk memverifikasi hanya data yang ditransfer, DataSync tidak memverifikasi direktori dalam beberapa situasi atau file yang gagal ditransfer. Dalam kedua kasus tersebut, DataSync tidak menyertakan data yang belum diverifikasi dalam laporan ini.

Laporan yang dihapus

Daftar file, direktori, dan objek yang dihapus selama eksekusi tugas Anda. DataSync menghasilkan laporan ini hanya jika Anda mengonfigurasi tugas 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, seperti TransferDuration danVerifyDuration, diukur dalam milidetik.

Contoh laporan data yang ditransfer dengan status sukses

Laporan ini menunjukkan bahwa objek bernama object1.txt berhasil ditransfer.

{
    "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 ini menunjukkan bahwa objek bernama object1.txt tidak ditransfer karena masalah izin bucket S3. (Jika Anda mendapatkan kesalahan seperti ini, lihatMengakses bucket S3.)

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

Prasyarat

Sebelum Anda dapat membuat laporan tugas, Anda harus melakukan hal berikut.

Buat bucket S3 untuk laporan tugas Anda

Jika Anda belum memilikinya, buat bucket S3 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. 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 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. 

    {
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "Service": "datasync.amazonaws.com"
            },
            "Action": "sts:AssumeRole",
            "Condition": {
                "StringEquals": {
                    "aws:SourceAccount": "123456789012"
                },
                "StringLike": {
                    "aws:SourceArn": "arn:aws:datasync:us-east-2: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.

    {
        "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 kunci harus menyertakan peran IAM yang digunakan untuk mengakses bucket. DataSync

    Untuk informasi selengkapnya, lihat Mengakses bucket S3 menggunakan enkripsi sisi server.

Membuat laporan tugas ringkasan saja

Anda dapat mengonfigurasi laporan tugas yang menyertakan ringkasan hanya saat membuat DataSync tugas, memulai tugas, atau memperbarui tugas.

Langkah-langkah berikut menunjukkan cara mengonfigurasi laporan tugas ringkasan saja saat membuat tugas.

  1. Buka AWS DataSync konsol di https://console.aws.amazon.com/datasync/.

  2. Di panel navigasi kiri, perluas Transfer data, lalu pilih Tugas, lalu pilih Buat tugas.

  3. Konfigurasikan lokasi sumber dan tujuan tugas Anda.

    Lihat informasi yang lebih lengkap di Di mana saya dapat mentransfer data saya AWS DataSync?

  4. Gulir ke bawah ke bagian Laporan tugas. Untuk jenis Laporan, pilih Ringkasan saja.

  5. 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. Jika tidak, DataSync akan menghapus laporan tugas sebelumnya setiap kali Anda menjalankan tugas karena laporan tersebut tidak ada di lokasi sumber Anda.

  6. 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 berupa garis miring (/). Untuk informasi selengkapnya, lihat Mengatur objek menggunakan awalan di Panduan Pengguna Amazon S3.

  7. 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.

      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.

  8. Selesai membuat tugas Anda, dan kemudian mulai tugas untuk mulai mentransfer data Anda.

Ketika transfer Anda selesai, Anda dapat melihat laporan tugas Anda.

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

  2. 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.

  3. 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.

  4. 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 berupa garis miring (/). Untuk informasi selengkapnya, lihat Mengatur objek menggunakan awalan 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. 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.

      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.

    • OutputType— TentukanSUMMARY_ONLY.

      Untuk informasi selengkapnya, lihat Ringkasan hanya laporan tugas.

  5. 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"
}

  6. 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

  7. Untuk --task-arn parameter, tentukan ARN dari tugas yang Anda mulai. Gunakan ARN yang Anda terima dari menjalankan perintah. create-task

  8. Jalankan perintah start-task-execution.

Ketika transfer Anda selesai, Anda dapat melihat laporan tugas Anda.

Membuat laporan tugas standar

Anda dapat mengonfigurasi laporan tugas standar saat membuat DataSync tugas, memulai tugas, atau memperbarui tugas Anda.

Langkah-langkah berikut menunjukkan cara mengonfigurasi laporan tugas standar saat membuat tugas.

  1. Buka AWS DataSync konsol di https://console.aws.amazon.com/datasync/.

  2. Di panel navigasi kiri, perluas Transfer data, lalu pilih Tugas, lalu pilih Buat tugas.

  3. Konfigurasikan lokasi sumber dan tujuan tugas Anda.

    Lihat informasi yang lebih lengkap di Di mana saya dapat mentransfer data saya AWS DataSync?

  4. Gulir ke bawah ke bagian Laporan tugas. Untuk jenis Laporan, pilih Laporan standar.

  5. 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.

  6. 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.

  7. 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. Jika tidak, DataSync akan menghapus laporan tugas sebelumnya setiap kali Anda menjalankan tugas karena laporan tersebut tidak ada di lokasi sumber Anda.

  8. 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 berupa garis miring (/). Untuk informasi selengkapnya, lihat Mengatur objek menggunakan awalan di Panduan Pengguna Amazon S3.

  9. 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.

      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.

  10. Selesai membuat tugas Anda dan mulai tugas untuk mulai mentransfer data Anda.

Ketika transfer Anda selesai, Anda dapat melihat laporan tugas Anda.

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

  2. 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.

  3. 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.

  4. 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 berupa garis miring (/). Untuk informasi selengkapnya, lihat Mengatur objek menggunakan awalan 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. 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.

      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.

    • OutputType— Tentukan STANDARD laporan.

      Untuk informasi selengkapnya, lihat Laporan tugas standar 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 keINCLUDE.

    • (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 menggunakanOverrides, seluruh laporan Anda menggunakan ReportLevel yang Anda tentukan.

  5. 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"
}

  6. 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

  7. Untuk --task-arn parameter, tentukan ARN dari tugas yang Anda jalankan. Gunakan ARN yang Anda terima dari menjalankan perintah. create-task

  8. Jalankan perintah start-task-execution.

Ketika transfer Anda selesai, Anda dapat melihat laporan tugas Anda.

Melihat laporan 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 menyertakan ID tugas Anda dan pelaksanaannya.

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 Select.

  • Visualisasikan laporan dengan menggunakan AWS layanan seperti AWS Glue, Amazon Athena, dan Amazon. QuickSight Untuk informasi selengkapnya tentang memvisualisasikan laporan tugas Anda, lihat Blog AWS Penyimpanan.

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.