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

Mencoba lagi di AWS SDK untuk Kotlin

Panggilan untuk Layanan AWS sesekali mengembalikan pengecualian yang tidak terduga. Jenis kesalahan tertentu, seperti kesalahan pelambatan atau transien, mungkin berhasil jika panggilan dicoba ulang.

Halaman ini menjelaskan cara AWS SDK untuk Kotlin penanganan mencoba ulang secara otomatis dan cara menyesuaikan perilaku coba ulang untuk aplikasi Anda.

Memahami perilaku coba lagi

Bagian berikut menjelaskan bagaimana SDK menentukan kapan harus mencoba ulang permintaan dan pengecualian apa yang dianggap dapat dicoba ulang.

Konfigurasi coba lagi default

Secara default, setiap klien layanan secara otomatis dikonfigurasi dengan strategi coba ulang standar. Konfigurasi default mencoba panggilan yang gagal hingga tiga kali (upaya awal ditambah dua percobaan ulang). Penundaan intervensi antara setiap panggilan dikonfigurasi dengan backoff eksponensial dan jitter acak untuk menghindari badai coba lagi. Konfigurasi ini berfungsi untuk sebagian besar kasus penggunaan tetapi mungkin tidak cocok dalam beberapa keadaan, seperti sistem throughput tinggi.

SDK mencoba mencoba ulang hanya pada kesalahan yang dapat dicoba ulang. Contoh kesalahan yang dapat dicoba ulang adalah batas waktu soket, pelambatan sisi layanan, kegagalan kunci konkurensi atau optimis, dan kesalahan layanan sementara. Parameter, authentication/security kesalahan, dan pengecualian salah konfigurasi yang hilang atau tidak valid tidak dianggap dapat dicoba ulang.

Anda dapat menyesuaikan strategi coba ulang standar dengan menyetel upaya maksimum, penundaan dan backoff, dan konfigurasi bucket token.

Pengecualian mana yang bisa dicoba kembali?

AWS SDK untuk Kotlin Menggunakan kebijakan coba ulang yang telah dikonfigurasi sebelumnya yang menentukan pengecualian mana yang dapat dicoba ulang. Konfigurasi klien layanan memiliki retryPolicy properti yang menentukan kebijakan yang diterapkan pada percobaan ulang. Jika tidak ada nilai kustom yang ditentukan, nilai defaultnya adalah AwsRetryPolicy.

Pengecualian berikut ditentukan untuk dapat dicoba kembali oleh: AwsRetryPolicy

Dicoba ulang dengan kode kesalahan

Apa saja ServiceException dengan sdkErrorMetadata.errorCode dari:

Dicoba ulang dengan kode status HTTP

Apa saja ServiceException dengan sdkErrorMetadata.statusCode dari:

Dicoba ulang dengan jenis kesalahan

Apa saja ServiceException dengan sdkErrorMetadata.errorType dari:

Dicoba ulang dengan metadata SDK

SdkBaseExceptionDimana saja:

Untuk daftar lengkap pengecualian yang mungkin dilemparkan oleh setiap klien layanan, lihat dokumentasi referensi API khusus layanan.

Periksa apakah pengecualian dapat dicoba ulang

Untuk menentukan apakah SDK menganggap pengecualian dapat dicoba ulang, periksa isRetryable properti pada pengecualian yang tertangkap:

try {
    dynamoDbClient.putItem {
        tableName = "MyTable"
        item = mapOf("id" to AttributeValue.S("123"))
    }
} catch (e: SdkBaseException) {
    println("Exception occurred: ${e.message}")
    
    if (e.sdkErrorMetadata.isRetryable) {
        println("This exception is retryable - SDK will automatically retry")
        println("If you're seeing this, retries may have been exhausted")
    } else {
        println("This exception is not retryable - fix the underlying issue")
        
        // Common non-retryable scenarios.
        when {
            e.message?.contains("ValidationException") == true -> 
                println("Check your request parameters")
            e.message?.contains("AccessDenied") == true -> 
                println("Check your IAM permissions")
            e.message?.contains("ResourceNotFound") == true -> 
                println("Verify the resource exists")
        }
    }
}

Pengecualian apa yang mencapai kode Anda saat percobaan ulang gagal

Ketika mekanisme percobaan ulang SDK tidak dapat menyelesaikan masalah, pengecualian akan dilemparkan ke kode aplikasi Anda. Memahami jenis pengecualian ini membantu Anda menerapkan penanganan kesalahan yang sesuai. Ini bukan pengecualian yang memicu pengambilan — yang ditangani secara internal oleh SDK.

Kode Anda akan menangkap jenis pengecualian berikut ketika percobaan ulang habis atau dinonaktifkan:

Gunakan pola berikut untuk menangani pengecualian ini dalam aplikasi Anda:

try {
    s3Client.getObject { 
        bucket = "amzn-s3-demo-bucket"
        key = "my-key" 
    }
} catch (e: AwsServiceException) {
    // Service-side errors that persisted through all retries.
    println("Service error after retries: ${e.errorDetails?.errorCode} - ${e.message}")
    
    // Handle specific service errors that couldn't be resolved.
    if (e.errorDetails?.errorCode == "ServiceQuotaExceededException" || 
        e.errorDetails?.errorCode == "ThrottlingException") {
        println("Rate limiting persisted - consider longer delays or quota increase")
    }
} catch (e: ClientException) {
    // Client-side errors (persistent network issues, DNS resolution failures, etc.)
    println("Client error after retries: ${e.message}")
}

Menyesuaikan perilaku coba lagi

Bagian berikut menunjukkan cara menyesuaikan perilaku coba ulang SDK untuk kasus penggunaan spesifik Anda.

Konfigurasikan upaya maksimum

Anda dapat menyesuaikan upaya maksimum default (3) di blok retryStrategy DSL selama konstruksi klien.

val dynamoDb = DynamoDbClient.fromEnvironment {
    retryStrategy {
        maxAttempts = 5
    }
}

Dengan klien layanan DynamoDB yang ditampilkan dalam cuplikan sebelumnya, SDK mencoba panggilan API yang gagal hingga lima kali (upaya awal ditambah empat percobaan ulang).

Anda dapat menonaktifkan percobaan ulang otomatis sepenuhnya dengan mengatur upaya maksimum ke satu seperti yang ditunjukkan pada cuplikan berikut.

val dynamoDb = DynamoDbClient.fromEnvironment {
    retryStrategy {
        maxAttempts = 1  // The SDK makes no retries.
    }
}

Konfigurasikan penundaan dan backoff

Jika percobaan ulang diperlukan, strategi coba lagi default menunggu sebelum melakukan upaya berikutnya. Penundaan untuk percobaan ulang pertama kecil tetapi tumbuh secara eksponensial untuk percobaan ulang nanti. Jumlah penundaan maksimum dibatasi sehingga tidak tumbuh terlalu besar.

Akhirnya, jitter acak diterapkan pada penundaan di antara semua upaya. Jitter membantu mengurangi efek armada besar yang dapat menyebabkan badai coba lagi. (Lihat posting Blog AWS Arsitektur ini untuk diskusi yang lebih dalam tentang backoff dan jitter eksponensial.)

Parameter penundaan dapat dikonfigurasi di blok delayProviderDSL.

val dynamoDb = DynamoDbClient.fromEnvironment {
    retryStrategy {
        delayProvider {
            initialDelay = 100.milliseconds
            maxBackoff = 5.seconds
        }
    }
}

Dengan konfigurasi yang ditunjukkan pada cuplikan sebelumnya, klien menunda upaya percobaan ulang pertama hingga 100 milidetik. Jumlah waktu maksimum antara setiap upaya coba lagi adalah 5 detik.

Parameter berikut tersedia untuk tuning delay dan backoff.

Konfigurasikan ember token coba lagi

Anda dapat memodifikasi perilaku strategi coba ulang standar lebih lanjut dengan menyesuaikan konfigurasi bucket token default. Bucket token coba lagi membantu mengurangi percobaan ulang yang cenderung tidak berhasil atau yang mungkin membutuhkan lebih banyak waktu untuk diselesaikan, seperti kegagalan batas waktu dan pembatasan.

Setiap upaya coba lagi (opsional termasuk upaya awal) mengurangi beberapa kapasitas dari ember token. Jumlah yang dikurangi tergantung pada jenis upaya. Misalnya, mencoba ulang kesalahan sementara mungkin murah, tetapi mencoba kembali kesalahan batas waktu atau pelambatan mungkin lebih mahal.

Upaya yang berhasil mengembalikan kapasitas ke ember. Bucket mungkin tidak bertambah melebihi kapasitas maksimumnya atau dikurangi di bawah nol.

Bergantung pada nilai useCircuitBreakerMode pengaturan, upaya untuk mengurangi kapasitas di bawah nol menghasilkan salah satu hasil berikut:

Parameter bucket token dapat dikonfigurasi di blok tokenBucketDSL:

val dynamoDb = DynamoDbClient.fromEnvironment {
    retryStrategy {
        tokenBucket {
            maxCapacity = 100
            refillUnitsPerSecond = 2
        }
    }
}

Parameter berikut tersedia untuk menyetel ember token coba lagi:

Untuk informasi rinci tentang jenis pengecualian yang dilemparkan selama skenario coba lagi, termasuk pengecualian pemutus sirkuit, lihat. Pengecualian apa yang mencapai kode Anda saat percobaan ulang gagal

Konfigurasikan percobaan ulang adaptif

Sebagai alternatif dari strategi coba ulang standar, strategi coba lagi adaptif adalah pendekatan lanjutan yang mencari tingkat permintaan yang ideal untuk meminimalkan kesalahan pelambatan.

Percobaan ulang adaptif mencakup semua fitur percobaan ulang standar. Ini menambahkan pembatas tingkat sisi klien yang mengukur tingkat permintaan yang dibatasi dibandingkan dengan permintaan non-throttled. Ini juga membatasi lalu lintas untuk mencoba tetap berada dalam bandwidth yang aman, idealnya menyebabkan kesalahan pelambatan nol.

Tarif beradaptasi secara real time untuk mengubah kondisi layanan dan pola lalu lintas dan dapat meningkatkan atau menurunkan tingkat lalu lintas yang sesuai. Secara kritis, pembatas tarif mungkin menunda upaya awal dalam skenario lalu lintas tinggi.

Anda memilih strategi coba ulang adaptif dengan memberikan parameter tambahan pada retryStrategy metode ini. Parameter pembatas laju dapat dikonfigurasi di blok rateLimiterDSL.

val dynamoDb = DynamoDbClient.fromEnvironment {
    retryStrategy(AdaptiveRetryStrategy) {
        maxAttempts = 10
        rateLimiter {
            minFillRate = 1.0
            smoothing = 0.75
        }
    }
}