Memecahkan masalah Cloud Scheduler

Cloud Scheduler memublikasikan log di awal dan akhir setiap eksekusi tugas yang memungkinkan Anda mendiagnosis dan menyelesaikan masalah tugas. Anda dapat mengambil, melihat, dan menganalisis log eksekusi dan audit untuk tugas tertentu. Untuk mengetahui informasi selengkapnya, lihat Melihat log.

Secara default, jika tugas Cloud Scheduler tidak menerima konfirmasi dari layanan targetnya (pengendali permintaan tugas), Cloud Scheduler akan menganggap tugas tersebut gagal dan mencobanya kembali sesuai dengan backoff eksponensial yang Anda konfigurasi.

Untuk mengetahui informasi tentang insiden yang memengaruhi layanan Google Cloud , lihat Google Cloud Dasbor Service Health dan Semua insiden yang dilaporkan untuk Cloud Scheduler.

Tugas gagal karena masalah layanan downstream

Kegagalan tugas mungkin disebabkan oleh masalah pada layanan downstream yang ditargetkan Cloud Scheduler (misalnya, Cloud Run), bukan Cloud Scheduler itu sendiri. Masalah layanan downstream kemungkinan terjadi jika kondisi berikut berlaku:

  • Izin untuk Cloud Scheduler sudah disiapkan dengan benar.
  • Cloud Scheduler dapat berhasil menjangkau layanan target.
  • Pesan error di log eksekusi Cloud Scheduler berasal dari layanan downstream.

Untuk mengatasi masalah ini, selesaikan beberapa langkah berikut:

  1. Panggil layanan downstream secara langsung: Pastikan layanan downstream dapat dipanggil tanpa Cloud Scheduler. Pemanggilan yang berhasil menunjukkan bahwa Cloud Scheduler kemungkinan menyebabkan masalah; jika tidak berhasil, layanan downstream memerlukan proses debug lebih lanjut.
  2. Periksa log layanan tujuan: Periksa log untuk layanan tujuan, tentukan error yang dihasilkan, dan lakukan triase sesuai kebutuhan.
  3. Cari operasi yang berjalan lama: Saat Cloud Scheduler menampilkan error HTTP 504 untuk operasi yang berjalan lama (lebih dari 30 menit), periksa log layanan tujuan untuk melihat apakah eksekusi berhasil atau gagal, karena layanan tujuan mungkin memiliki waktu tunggu permintaan yang lebih lama. Dalam skenario ini, Cloud Scheduler akan mengalami waktu tunggu habis dan mungkin mencoba ulang tugas saat layanan tujuan masih berjalan. Untuk mencegah eksekusi duplikat pada percobaan ulang, lihat Menghapus duplikat permintaan tugas.

Tugas gagal dengan error izin

Izin mengontrol akun utama mana yang dapat mengakses resource dan operasi apa yang diizinkan. Izin yang salah dikonfigurasi dapat mengganggu eksekusi tugas dan menyebabkan error izin ditolak. Log audit memberikan data mendetail tentang semua perubahan izin sehingga Anda dapat mengidentifikasi sumber masalah ini.

Jika tugas Cloud Scheduler Anda gagal karena error izin, log eksekusi mungkin menampilkan pesan yang mirip dengan "debugInfo":"URL_ERROR-ERROR_OTHER. Original HTTP response code number = 403".

Untuk mengatasi masalah ini, selesaikan satu atau beberapa verifikasi berikut:

  • Verifikasi peran Identity and Access Management (IAM) yang diberikan kepada agen layanan: Agen layanan Cloud Scheduler memerlukan peran Agen Layanan Cloud Scheduler (roles/cloudscheduler.serviceAgent). Tanpa peran ini, tugas Cloud Scheduler akan gagal. Anda dapat memberikan peran tersebut secara manual ke agen layanan Cloud Scheduler Anda. Pemberian manual hanya diperlukan jika Anda mengaktifkan Cloud Scheduler API sebelum 19 Maret 2019, atau jika Anda menghapus peran Agen Layanan Cloud Scheduler. Untuk mengetahui informasi selengkapnya, lihat Memberikan peran Agen Layanan Cloud Scheduler.

  • Verifikasi izin akun layanan Anda: Pastikan akun layanan yang dilampirkan ke tugas Anda memiliki izin dan cakupan yang benar untuk memanggil layanan tujuan. Hal ini mencakup skenario saat target berada di project lain atau merupakan target akhir dari layanan perantara. Jika target Anda berada dalam Google Cloud, pastikan bahwa Anda telah memberikan peran yang diperlukan ke akun layanan Anda. Setiap layanan dalam Google Cloud memerlukan peran tertentu, dan layanan penerima akan otomatis memverifikasi token yang dibuat. Misalnya, untuk Cloud Run dan Cloud Run Functions, Anda harus memberikan peran Cloud Run Invoker (roles/run.invoker). Jika target Anda berada di luar Google Cloud, layanan penerima harus memverifikasi token secara manual. Untuk mengetahui informasi selengkapnya, lihat Melakukan autentikasi ke Cloud Scheduler dan Menggunakan autentikasi dengan target HTTP.

  • Verifikasi setiap pelanggaran Kontrol Layanan VPC: Kontrol Layanan VPC adalah fiturGoogle Cloud yang memungkinkan Anda menyiapkan perimeter yang aman untuk mencegah pemindahan data yang tidak sah. Untuk menentukan apakah error terkait dengan Kontrol Layanan VPC, periksa apakah Anda telah mengaktifkan Kontrol Layanan VPC dan menerapkannya ke project dan layanan yang Anda gunakan. Untuk memverifikasi apakah project dan layanan dilindungi oleh Kontrol Layanan VPC, periksa kebijakan Kontrol Layanan VPC di level hierarki resource tersebut.

    Untuk memahami cakupan masalah, Anda dapat mengambil error Kontrol Layanan VPC dari log audit:

    1. Di konsol Google Cloud , buka halaman segmen:

      Buka Logs Explorer

      Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Logging.

    2. Buat kueri log audit untuk kriteria berikut:

      severity="ERROR" AND protoPayload.status.details.violations.type="VPC_SERVICE_CONTROLS"

      Secara khusus, pesan error mungkin menyertakan teks berikut:

      • Request is prohibited by organization's policy
      • Request violates VPC Service Controls

    Untuk mengetahui informasi selengkapnya tentang masalah yang mungkin Anda alami saat mengonfigurasi Kontrol Layanan VPC, lihat Memecahkan masalah umum.

  • Verifikasi endpoint pribadi apa pun: Cloud Scheduler hanya dapat memanggil endpoint pribadi yang didukung seperti Cloud Run, Cloud Run Functions, dan API Google Cloud dalam perimeter Kontrol Layanan VPC. Periksa setelan ingress untuk layanan tujuan Anda (misalnya, lihat Membatasi ingress jaringan untuk Cloud Run) dan izin akun layanan yang dilampirkan. Anda mungkin menerima pesan error URL_ERROR-ERROR_DNS. Untuk mengetahui informasi selengkapnya, lihat Tugas gagal karena target tujuan tidak dapat dijangkau dalam dokumen ini.

Tugas gagal karena target tujuan tidak dapat dijangkau

Masalah ini terjadi saat tugas Cloud Scheduler Anda gagal karena target tujuan tidak dapat dijangkau. Log eksekusi menampilkan error yang dimulai dengan URL_ERROR atau URL_UNREACHABLE.

Untuk mengatasi masalah ini, bergantung pada pesan error yang diterima, selesaikan salah satu pemeriksaan berikut:

  • URL_ERROR-ERROR_AUTHENTICATION: Error HTTP 401 (Unauthorized) atau HTTP 407 (Proxy Authentication Required) ditampilkan. Target tujuan memerlukan autentikasi; namun, permintaan Cloud Scheduler tidak menyertakan token autentikasi yang valid—misalnya, permintaan tidak memiliki header otorisasi atau kredensial tidak valid. Periksa setelan autentikasi tugas Anda. Jika endpoint target Anda memerlukan kunci API di header permintaan, pastikan nama header cocok dengan yang diharapkan layanan target, seperti x-api-key atau X-Goog-Api-Key, bukan api_key. Untuk mengetahui informasi selengkapnya, lihat Melakukan autentikasi ke Cloud Scheduler dan Menggunakan autentikasi dengan target HTTP.

  • URL_ERROR-ERROR_DNS: Menunjukkan bahwa pengambilan URL gagal karena nama host tidak dapat di-resolve menggunakan Domain Name System (DNS)—misalnya, nama host tidak ada atau tidak memiliki alamat IP terkait. Pesan error mungkin menyertakan teks Original HTTP response code number = 0. Periksa validitas nama host, dan saat memanggil endpoint pribadi, pastikan endpoint tersebut didukung oleh Cloud Scheduler dan periksa setelan ingress-nya.

  • URL_ERROR-ERROR_NOT_FOUND: Server web menampilkan error HTTP 404 Not Found. Periksa apakah URL target sudah benar dan resource-nya ada.

  • URL_ERROR-ERROR_OTHER: Merujuk pada error HTTP 4xx umum yang belum dijelaskan sebelumnya. Periksa log untuk mengambil kode respons HTTP asli. Jika Anda menerima error HTTP 403, lihat Tugas gagal dengan error izin dalam dokumen ini.

  • URL_UNREACHABLE-UNREACHABLE_5xx: Target tujuan menampilkan error HTTP 5xx atau 429. Hal ini mungkin merupakan kondisi sementara, seperti server yang kelebihan beban. Periksa log target tujuan untuk men-debug masalah.

  • URL_UNREACHABLE-UNREACHABLE_CONNECTION_RESET: Koneksi direset oleh peer. Periksa masalah di sisi server eksternal.

  • URL_UNREACHABLE-UNREACHABLE_ERROR: Menunjukkan error jaringan. Periksa apakah URL target sudah benar dan apakah ada aturan firewall yang memblokir akses.

Target yang tidak didukung saat menggunakan perimeter aman

Jika Cloud Scheduler adalah layanan yang dibatasi dalam perimeter Kontrol Layanan VPC, setiap upaya untuk membuat atau mengupdate tugas dengan target yang tidak didukung akan gagal dengan kode error TARGET_TYPE_NOT_PERMITTED_FOR_VPC. Untuk mengetahui informasi selengkapnya, lihat Mengamankan cron job dengan Kontrol Layanan VPC.

Masalah eksekusi tugas

Tugas Cloud Scheduler dijalankan pada waktu yang ditentukan atau secara berkala. Masalah berikut mungkin terjadi saat tugas sedang dijalankan.

Tugas yang sebelumnya berfungsi berhenti dieksekusi

Masalah ini terjadi saat tugas Cloud Scheduler yang sebelumnya berhasil dijalankan berhenti dieksekusi karena Cloud Scheduler API dinonaktifkan. Anda dapat mengonfirmasi waktu penonaktifan API dengan mengkueri log audit untuk kriteria berikut:

resource.type="audited_resource" AND
protoPayload.serviceName="cloudscheduler.googleapis.com" AND
operation.producer="serviceusage.googleapis.com" AND
protoPayload.authorizationInfo.permission="serviceusage.services.disable"

Untuk mengatasi masalah ini, aktifkan Cloud Scheduler API.

Eksekusi tugas berikutnya tidak dimulai

Masalah ini terjadi saat tugas masih berjalan atau menunggu respons dari targetnya. Operasi terjadwal lainnya dari tugas akan dilewati hingga operasi saat ini selesai atau waktu habis.

Di entri log, temukan entri type.googleapis.com/google.cloud.scheduler.logging.AttemptStarted terbaru dan entri type.googleapis.com/google.cloud.scheduler.logging.AttemptFinished yang sesuai. Jika entri AttemptFinished tidak ada atau muncul setelah eksekusi terjadwal berikutnya dari tugas, eksekusi tertunda lainnya akan diblokir dan tidak dimulai. Bergantung pada jadwal tugas, hal ini dapat mencegah beberapa eksekusi tugas dimulai. Untuk menyelidiki lebih lanjut, verifikasi waktu tunggu pada target tujuan tugas Anda dan periksa apakah target mengalami masalah.

Eksekusi tugas menjadi tidak teratur karena waktu musim panas

Saat membuat tugas Cloud Scheduler menggunakan konsol Google Cloud , Anda harus menentukan zona waktu. Saat menggunakan Google Cloud CLI, Anda dapat menentukan zona waktu secara opsional menggunakan flag --time-zone; jika tidak, zona waktu defaultnya adalah Waktu Universal Terkoordinasi (UTC).

Masalah ini terjadi saat tugas dikonfigurasi dengan zona waktu non-UTC dan eksekusinya menjadi tidak teratur karena perubahan waktu musim panas (DST). Hal ini wajar terjadi.

Jika tugas Anda memerlukan ritme yang tepat, pilih zona waktu yang tidak menerapkan DST. Untuk sepenuhnya menghindari masalah ini, konfigurasikan jadwal tugas Anda untuk menggunakan zona waktu UTC.

Untuk mengetahui informasi selengkapnya, lihat Format cron job dan zona waktu.

Masalah CMEK

Anda dapat menggunakan kunci enkripsi yang dikelola pelanggan (CMEK) untuk melindungi Cloud Scheduler. Kunci dibuat dan dikelola melalui Cloud Key Management Service (Cloud KMS).

Anda mungkin mengalami error saat menggunakan Cloud KMS dengan Cloud Scheduler. Tabel berikut menjelaskan berbagai masalah dan cara mengatasinya.

Masalah Deskripsi
Izin cloudkms.cryptoKeyVersions.useToEncrypt ditolak

Kunci Cloud KMS yang diberikan tidak ada atau izin tidak dikonfigurasi dengan benar.

Solusi:

Versi kunci tidak diaktifkan

Versi kunci Cloud KMS yang diberikan telah dinonaktifkan.

Solusi: Aktifkan kembali versi kunci Cloud KMS.

Region key ring tidak cocok dengan resource yang akan dilindungi

Region key ring Cloud KMS yang disediakan berbeda dengan region Cloud Scheduler yang dilindungi.

Solusi: Gunakan key ring Cloud KMS dari region yang sama dengan region Cloud Scheduler. Key ring dapat berada di project yang berbeda. Untuk mengetahui informasi selengkapnya, lihat lokasi Cloud KMS dan lokasi Cloud Scheduler.

Project tidak kompatibel dengan CMEK di Cloud Scheduler

Pengaktifan CMEK gagal dengan error FAILED_PRECONDITION dengan pesan: Your project is currently not compatible with CMEK in Cloud Scheduler. Error ini terjadi jika tugas Cloud Scheduler yang ada di project Anda belum dimigrasikan untuk mendukung CMEK. Misalnya, izin agen layanan yang tidak ada atau tugas lama dengan nama topik Pub/Sub yang tidak valid dapat mencegah migrasi.

Solusi:

  1. Tinjau dan perbaiki masalah izin atau konfigurasi tugas di project Anda:
    • Pastikan agen layanan Cloud Scheduler memiliki peran Agen Layanan Cloud Scheduler (roles/cloudscheduler.serviceAgent) di project. Peran ini mencakup izin pubsub.topics.publish untuk topik Pub/Sub dalam project. Untuk mengetahui petunjuknya, lihat Memberikan peran Agen Layanan Cloud Scheduler.
    • Jika roles/cloudscheduler.serviceAgent tidak diberikan pada project atau dibatasi, pastikan agen layanan memiliki peran Pub/Sub Publisher (roles/pubsub.publisher) di setiap topik target.
    • Periksa tugas target Pub/Sub lama dengan nama topik yang tidak valid, lalu update atau hapus tugas tersebut. Nama topik harus menggunakan format projects/PROJECT_ID/topics/TOPIC_ID dalam project yang sama dengan tugas. Untuk aturan penamaan topik, lihat Panduan untuk memberi nama topik, langganan, skema, atau snapshot.
  2. Setelah menyelesaikan masalah izin atau konfigurasi tugas, buka permintaan dukungan di konsol Google Cloud untuk menyelesaikan migrasi sehingga Anda dapat mengaktifkan CMEK untuk project Anda. Memperbaiki izin atau konfigurasi tugas saja tidak akan menghapus error hingga migrasi selesai.

Langkah berikutnya

Jika Anda tidak dapat menemukan solusi untuk masalah Anda dalam dokumentasi Cloud Scheduler, pertimbangkan opsi berikut:

Untuk mengetahui informasi selengkapnya, lihat Dukungan Cloud Scheduler.