Memecahkan masalah

Halaman ini menunjukkan cara menyelesaikan masalah yang mungkin Anda alami saat menggunakan Eventarc.

Untuk masalah khusus tujuan yang mungkin juga Anda alami, lihat pemecahan masalah untuk:

Penyedia Eventarc

Bagian ini memberikan tips pemecahan masalah untuk masalah di sumber peristiwa (penyedia).

Penyedia tidak ada

Pastikan penyedia ada dan Anda telah menentukan filter pemicu dengan benar.

Peristiwa dihasilkan dari penyedia, tetapi tidak diterima di target

Pastikan Anda memfilter peristiwa dari penyedia yang berada di wilayah yang didukung untuk tujuan target. Untuk informasi selengkapnya, lihat lokasi yang didukung oleh Eventarc dan Memahami lokasi Eventarc.

Pemicu tidak mengirimkan peristiwa

  1. Pastikan bahwa penyedia menghasilkan peristiwa. Periksa Cloud Audit Logs dan pastikan layanan yang dipantau menulis log. Jika log dicatat, tetapi peristiwa tidak dikirim, hubungi dukungan.

  2. Pastikan topik Pub/Sub dengan nama pemicu yang sama sudah ada.

    1. Untuk mencantumkan pemicu di semua lokasi, jalankan:

      gcloud eventarc triggers list --location=-

    2. Untuk mencantumkan topik Pub/Sub, jalankan:

      gcloud pubsub topics list

      Pastikan nama topik Pub/Sub menyertakan nama pemicu yang dibuat. Jika topik Pub/Sub tidak ada, buat topik saat Anda membuat pemicu.

    3. Untuk mendeskripsikan pemicu dan mendeteksi masalah pada kondisi pemicu, jalankan:

      gcloud eventarc triggers describe TRIGGER \
  --location=LOCATION

      Ganti kode berikut:

      • TRIGGER: ID pemicu atau ID yang memenuhi syarat sepenuhnya.
      • LOCATION: lokasi pemicu Eventarc.

    4. Perintah sebelumnya menampilkan kondisi pemicu. Jika ada masalah dengan topik Pub/Sub, salah satu kondisi berikut akan ditampilkan:

      conditions:
transport.pubsub.topic:
  code: NOT_FOUND
  message: Pub/Sub topic not found. Try recreating the trigger.

      atau

      conditions:
transport.pubsub.topic:
  code: UNKNOWN
  message: Pub/Sub topic status is unknown. Try requesting the trigger description again.

      Jika berlaku, lakukan hal berikut:

      • Jika Pub/Sub topic not found ditampilkan, buat ulang pemicu untuk penyedia, jenis peristiwa, dan tujuan tertentu](/eventarc/standard/docs/event-providers-targets#triggers), lalu buat topik.

      • Jika Pub/Sub topic status is unknown ditampilkan, jalankan perintah untuk mendeskripsikan pemicu lagi.

      • Jika masalah berlanjut, hubungi dukungan. Untuk mengetahui informasi selengkapnya, lihat Mengelola pemicu.

  3. Verifikasi status topik Pub/Sub:

    1. Verifikasi konfigurasi topik Pub/Sub. Buka halaman Topik.

      Buka Topik

    2. Pantau apakah pesan dipublikasikan ke topik dengan metrik: topic/send_message_operation_count. Jika pesan tidak dipublikasikan ke topik, periksa Cloud Audit Logs dan pastikan layanan yang dipantau menghasilkan log. Jika log dicatat, tetapi peristiwa tidak dikirim, hubungi dukungan.

    3. Pantau apakah pesan berhasil dikirim dengan metrik: subscription/push_request_count oleh response_code. Jika error push dilaporkan, periksa log layanan. Jika endpoint penerima menampilkan kode status yang bukan OK, hal ini menunjukkan bahwa kode Cloud Run tidak berfungsi seperti yang diharapkan dan Anda harus menghubungi dukungan.

Pemicu Eventarc

Bagian ini memberikan tips pemecahan masalah untuk masalah pada pemicu.

Error izin ditolak

  • Jika Anda mengalami error Failed to load service details: permission denied, confirmasikan bahwa izin pemicu dikonfigurasi dengan benar, dan akun layanan Pub/Sub diberi peran iam.serviceAccountTokenCreator. Untuk informasi selengkapnya, lihat Kontrol akses.

  • Jika Anda mengalami error berikut saat mencoba membuat pemicu, tunggu beberapa menit (hingga tujuh), lalu coba buat pemicu lagi:

    Permission denied while using the Eventarc Service Agent. If you recently
started to use Eventarc, it may take a few minutes before all necessary
permissions are propagated to the Service Agent. Otherwise, verify that it has
Eventarc Service Agent role.

    Agen layanan bertindak sebagai identitas layanan Google Cloud tertentu untuk project tertentu. Untuk mengetahui informasi selengkapnya, lihat Agen layanan dan lihat izin untuk peran agen layanan Eventarc (roles/eventarc.serviceAgent).

    Untuk memverifikasi bahwa agen layanan Eventarc ada di project Google Cloud Anda dan memiliki peran yang diperlukan, selesaikan langkah-langkah berikut:

    1. Di konsol Google Cloud, buka halaman IAM.

      Buka IAM

    2. Pada tab Permissions, centang kotak Include Google-provided role grants.

    3. Dalam daftar akun utama, cari agen layanan Eventarc, yang menggunakan format ini:

      service-PROJECT_NUMBER@gcp-sa-eventarc.iam.gserviceaccount.com

    4. Pastikan agen layanan memiliki peran Agen Layanan Eventarc. Jika agen layanan tidak memiliki peran tersebut, berikan peran.

  • Jika Anda mencoba menggunakan akun layanan lintas project dan mengalami error izin ditolak untuk iam.serviceAccounts.getAccessToken atau iam.serviceAccounts.actAs, atau jika Anda menerima pesan error yang mirip dengan ...cross-project service accounts are disabled atau Failed to impersonate..., konfirmasi bahwa izin dikonfigurasi dengan benar. Untuk mengetahui informasi selengkapnya, lihat Menggunakan akun layanan lintas project.

Biaya tak terduga saat menggunakan Eventarc

Saat membuat pemicu, periksa apakah filter yang dikonfigurasi dapat menyebabkan pemicu diaktifkan tanpa batas waktu. Untuk membantu menghindari tagihan yang tidak terduga pada tagihan Anda, tetapkan anggaran dan pemberitahuan menggunakan konsol penagihan Google Cloud. Untuk mengetahui informasi selengkapnya, lihat Membuat anggaran.