AWSSupport-TroubleshootDMSTableErrors - AWS Systems Manager Referensi buku runbook otomatisasi

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

AWSSupport-TroubleshootDMSTableErrors

Deskripsi

Runbook AWS Systems Manager AWSSuport-TroubleshootDMSTabelErrors otomatisasi membantu Anda mengotomatiskan proses pemecahan masalah yang Table errors ditemukan dalam tugas migrasi Database atau replikasi Tanpa Server dari. AWS Database Migration Service Kesalahan ini terjadi ketika tabel gagal bermigrasi dari titik akhir sumber (database sumber) ke titik akhir target (database target) oleh tugas migrasi Database atau replikasi Tanpa Server yang dibuat dalam layanan. AWS DMS Runbook ini menganalisis pesan kesalahan tanda tangan dari CloudWatch log, khususnya berfokus pada log tugas untuk tugas migrasi Database tradisional dan log tanpa server untuk replikasi Tanpa Server. Ini juga memberikan saran yang ditargetkan dan langkah-langkah perbaikan untuk pesan kesalahan umum yang ditemui Table error selama AWS DMS migrasi.

Bagaimana cara kerjanya?

Runbook melakukan langkah-langkah berikut:

  • Mengambil informasi tentang AWS DMS ARN yang disediakan, yang dapat berupa tugas migrasi Database atau replikasi Tanpa Server.

  • Memverifikasi apakah AWS DMS sumber daya yang disediakan telah dimulai setidaknya sekali dengan memeriksa FreshStartDate nilai dalam DescribeReplicationTasks API (untuk tugas migrasi Database) dan DescribeReplications API (untuk replikasi Tanpa Server). Jika sumber daya belum dimulai, otomatisasi menimbulkan kesalahan.

  • Jika sumber daya telah dimulai, otomatisasi memeriksa tabel di TableError negara bagian menggunakan TableStatistics informasi. Jika tidak ditemukan kesalahan, otomatisasi mengakhiri alur kerja setelah menampilkan pesan yang mengonfirmasi tidak ada kesalahan tabel yang ditemukan dalam tugas migrasi Database tertentu atau replikasi Tanpa Server.

  • Jika tabel dengan TableError status ditemukan, otomatisasi memeriksa apakah CloudWatch logging diaktifkan untuk AWS DMS sumber daya yang ditentukan. Jika logging tidak diaktifkan, otomatisasi mengakhiri alur kerja setelah menampilkan pesan yang menunjukkan bahwa logging tidak diaktifkan.

    Catatan: CloudWatch logging diharapkan diaktifkan, karena otomatisasi bergantung pada log ini untuk menganalisis dan mengidentifikasi masalah dengan tabel dalam TableError status.

  • Jika logging diaktifkan, otomatisasi menganalisis CloudWatch log dan menghasilkan laporan untuk setiap tabel yang dalam TableError status. Laporan ini menyertakan saran untuk pesan kesalahan umum dan menyediakan log kesalahan yang relevan untuk membantu mengidentifikasi dan menyelesaikan masalah yang mencegah migrasi tabel berhasil dari titik akhir AWS DMS sumber ke titik akhir AWS DMS target.

Jalankan Otomasi ini (konsol)

Jenis dokumen

Otomatisasi

Pemilik

Amazon

Platform

/

Parameter

  • AutomationAssumeRole

    Tipe: String

    Deskripsi: (Opsional) Nama Sumber Daya Amazon (ARN) peran AWS Identity and Access Management (IAM) yang memungkinkan Otomasi Systems Manager untuk melakukan tindakan atas nama Anda. Jika tidak ada peran yang ditentukan, Systems Manager Automation menggunakan izin pengguna yang memulai runbook ini.

  • DMSArn

    Tipe: String

    Deskripsi: (Diperlukan) ARN dari tugas migrasi Database atau replikasi Tanpa Server

    Pola yang Diizinkan: ^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):dms:[a-z0-9-]+:\d{12}:(task|replication-config):[a-zA-Z0-9-]+$

  • StartTimeRange

    Tipe: String

    Deskripsi: (Opsional) Parameter ini mendefinisikan awal rentang waktu untuk analisis CloudWatch log dari tugas Migrasi Database yang diberikan atau replikasi Tanpa Server. Jika disediakan, hanya log yang dihasilkan dari waktu tertentu ini dan seterusnya yang akan dikumpulkan dan dianalisis. Harap dicatat, ada kemungkinan alur kerja bisa batas waktu jika rentang waktu antara startDate dan endDate terlalu lama. Nilai harus diberikan dalam format waktu tanggal ISO 6081.

    Pola yang Diizinkan: ^$|^(\\d{4})-(\\d{2})-(\\d{2})T(\\d{2}):(\\d{2}):(\\d{2})\\.(\\d{3})Z$

  • EndTimeRange

    Tipe: String

    Deskripsi: (Opsional) Parameter ini menetapkan akhir rentang waktu untuk analisis CloudWatch log tugas migrasi Database yang diberikan atau replikasi Tanpa Server. Saat disediakan, hanya log yang dihasilkan hingga waktu tertentu ini yang akan dikumpulkan dan dianalisis. Harap dicatat, ada kemungkinan alur kerja bisa batas waktu jika rentang waktu antara startDate dan endDate terlalu lama. Nilai harus diberikan dalam format waktu tanggal ISO 6081.

    Pola yang Diizinkan: ^$|^(\\d{4})-(\\d{2})-(\\d{2})T(\\d{2}):(\\d{2}):(\\d{2})\\.(\\d{3})Z$

Izin IAM yang diperlukan

AutomationAssumeRoleParameter memerlukan tindakan berikut untuk menggunakan runbook dengan sukses.

  • dms:DescribeReplicationTasks

  • dms:DescribeReplications

  • dms:DescribeEndpoints

  • dms:DescribeReplicationConfigs

  • dms:DescribeTableStatistics

  • dms:DescribeReplicationTableStatistics

  • logs:FilterLogEvents

Contoh Kebijakan IAM untuk Otomasi Asumsikan Peran 


            {
                "Version": "2012-10-17",
                "Statement": [
                    {
                        "Sid": "VisualEditor0",
                        "Effect": "Allow",
                        "Action": [
                            "dms:DescribeReplicationConfigs",
                            "dms:DescribeEndpoints",
                            "dms:DescribeReplicationTableStatistics",
                            "dms:DescribeTableStatistics",
                            "logs:FilterLogEvents",
                            "dms:DescribeReplicationTasks",
                            "dms:DescribeReplications"
                        ],
                        "Resource": "*"
                    }
                ]
            }

Instruksi

Ikuti langkah-langkah ini untuk mengonfigurasi otomatisasi:

  1. Arahkan ke AWSSupport-TroubleshootDMSTableErrorsSystems Manager di bawah Documents.

  2. Pilih Jalankan otomatisasi.

  3. Untuk parameter input, masukkan yang berikut ini:

    • AutomationAssumeRole (Opsional):

      Nama Sumber Daya Amazon (ARN) dari peran AWS AWS Identity and Access Management (IAM) yang memungkinkan Otomasi Systems Manager untuk melakukan tindakan atas nama Anda. Jika tidak ada peran yang ditentukan, Systems Manager Automation menggunakan izin pengguna yang memulai runbook ini.

    • DMSArn

      ARN dari tugas migrasi Database atau replikasi Tanpa Server yang memiliki kesalahan Tabel.

    • StartTimeRange

      (Opsional) Format waktu tanggal ISO 6081 yang menentukan awal rentang waktu untuk menganalisis CloudWatch log tugas migrasi Database yang diberikan atau replikasi Tanpa Server.

    • EndTimeRange

      (Opsional) Format waktu tanggal ISO 6081 yang menentukan akhir rentang waktu untuk menganalisis CloudWatch log tugas migrasi Database yang diberikan atau replikasi Tanpa Server.

  4. Pilih tombol Execute dari bawah halaman.

  5. Otomatisasi dimulai.

  6. Dokumen melakukan langkah-langkah berikut:

    • memvalidasi DMSInput TypeAndGatherDetails

      Memvalidasi input AWS DMS ARN yang diberikan dan mengumpulkan rincian dasar tugas migrasi Database atau replikasi tanpa server yang diperlukan dalam langkah berikutnya.

    • branchOnTableKesalahan

      Cabang alur kerja berdasarkan jumlah kesalahan Tabel yang ditemukan pada langkah di atas. Jika hitungan lebih besar dari 0, maka lanjutkan ke - branchOnCWLoggingStatus langkah. Lain, lanjutkan ke - outputNoTableErrors langkah.

    • outputNoTableKesalahan

      Keluarkan pesan yang menyatakan bahwa kesalahan tabel tidak ditemukan dalam tugas migrasi Database yang diberikan atau replikasi Tanpa Server.

    • Status BranchOn CWLogging

      Cabang alur kerja berdasarkan status CloudWatch pencatatan yang ditemukan pada langkah di atas. Jika diaktifkan, lanjutkan ke - gatherTableDetails langkah. Lain, lanjutkan ke - outputNoCWLoggingEnabled langkah.

    • OutputTidak Diaktifkan CWLogging

      Mengeluarkan pesan yang menyatakan bahwa CloudWatch logging tidak diaktifkan dalam tugas migrasi Database yang diberikan atau replikasi Tanpa Server.

    • gatherTableDetails

      Mengumpulkan FullLoadEndTime stempel waktu dari tabel yang gagal dan menghitung nilai timerange untuk menganalisis log. CloudWatch

    • analyzeCloudWatchLog

      Menganalisis log yang ditemukan di grup CloudWatch log berdasarkan pesan galat tanda tangan dan mengembalikan laporan ke Pengguna.

  7. Setelah eksekusi selesai, tinjau bagian Output untuk hasil eksekusi yang terperinci.

    • Output dari kesalahan No Table ditemukan

      Jika tidak ada kesalahan tabel yang ditemukan dalam tugas migrasi Database yang disediakan atau replikasi Tanpa Server, otomatisasi menunjukkan output yang menyatakan hal yang sama.

    • Output dari Tidak ada CloudWatch loggin diaktifkan

      Jika CloudWatch logging tidak diaktifkan dalam tugas migrasi Database yang disediakan atau replikasi Tanpa Server, otomatisasi menunjukkan output yang menyatakan hal yang sama dan menyediakan langkah-langkah untuk mengaktifkan logging.

    • Laporan analisis log

      Mengeluarkan laporan yang mengidentifikasi tabel dalam Table error keadaan baik dari tugas migrasi Database yang disediakan atau replikasi Tanpa Server, membedakan antara jenis kesalahan, mencantumkan pesan kesalahan yang ditemui, dan memberikan langkah-langkah perbaikan yang ditargetkan dan saran untuk setiap tabel yang diidentifikasi.

Referensi

Otomatisasi Systems Manager