Halaman ini berlaku untuk Apigee, tetapi tidak untuk Apigee hybrid.
Lihat dokumentasi
Apigee Edge.
Dokumen ini menjelaskan cara memantau kondisi Cloud External Key Manager (Cloud EKM) yang digunakan dengan Apigee dan cara mengonfigurasi pemberitahuan untuk masalah terkait Cloud EKM menggunakan Cloud Logging.
Apigee dapat mengandalkan Cloud EKM untuk CMEK. Jika Cloud EKM tidak tersedia karena masalah jaringan, atau jika kunci dinonaktifkan atau tidak dapat dijangkau, layanan Apigee yang mengandalkan enkripsi mungkin akan terpengaruh.
Memantau masalah Cloud EKM di Cloud Logging
Saat Apigee mengalami masalah dengan Cloud EKM, seperti perubahan status menjadi ditolak, kunci dinonaktifkan, penagihan dinonaktifkan, atau kunci tidak dapat dijangkau, Apigee akan membuat entri log di Cloud Logging. Anda dapat melihat log ini di Logs Explorer dan mengonfigurasi pemberitahuan berbasis log untuk mendapatkan notifikasi tentang peristiwa tersebut.
Entri log berisi detail tentang organisasi dan instance yang mengalami masalah, tetapi menghilangkan nama kunci karena alasan keamanan.
Untuk menemukan entri log terkait Cloud EKM di Logs Explorer, ikuti langkah-langkah berikut:
- Buka halaman Logs Explorer di konsol Google Cloud .
- Masukkan kueri berikut di kolom editor kueri, lalu klik Run query:
Apigee EKM key health issue detected
- Jika terjadi masalah Cloud EKM, hasil kueri akan menampilkan entri log yang menjelaskan peristiwa tersebut.
Mengonfigurasi pemberitahuan berbasis log untuk masalah Cloud EKM
Anda dapat membuat kebijakan pemberitahuan berbasis log untuk memberi tahu Anda saat Apigee mencatat error terkait Cloud EKM ke dalam log. Notifikasi ini dapat membantu Anda mengidentifikasi dan mengatasi masalah pada Cloud EKM secara proaktif.
Untuk mengonfigurasi pemberitahuan berbasis log berdasarkan string pesan error Cloud EKM, lihat Mengonfigurasi kebijakan pemberitahuan berbasis log dalam dokumentasi Cloud Logging.
Saat membuat pemberitahuan, gunakan filter kueri yang sama seperti yang dijelaskan dalam Memantau masalah Cloud EKM di Cloud Logging agar sesuai dengan entri log Cloud EKM tertentu.
Batasan dan pemulihan pemberitahuan
Perhatikan batasan berikut saat Anda mengonfigurasi dan merespons pemberitahuan kondisi Cloud EKM:
- Pemberitahuan berulang: Meskipun kunci tetap tidak dapat dijangkau, Apigee akan membuat entri log kira-kira sekali setiap jam. Jika Anda mengonfigurasi pemberitahuan berbasis log, Anda akan menerima notifikasi pada ritme ini hingga masalah yang mendasarinya diselesaikan.
- Tidak ada notifikasi pemulihan: Apigee tidak membuat entri log atau mengirim notifikasi saat Cloud EKM dapat dijangkau kembali. Pemberitahuan berbasis log akan terselesaikan dengan sendirinya setelah Apigee berhenti membuat entri log error, berdasarkan konfigurasi penutupan otomatis kebijakan pemberitahuan Anda.
- Memverifikasi pemulihan: Karena tidak ada entri log pemulihan yang dibuat, konfirmasi bahwa Cloud EKM Anda dapat dijangkau lagi dengan melakukan operasi yang memerlukan kunci, seperti men-deploy proxy API, dan memverifikasi bahwa operasi tersebut berhasil.
Batasan pemecahan masalah
Logging Apigee menunjukkan kapan ada masalah dengan koneksi Cloud EKM atau status kunci. Namun, pemecahan masalah mendetail pada Cloud EKM itu sendiri (misalnya, mendiagnosis masalah konektivitas jaringan atau masalah di sisi pengelola kunci eksternal) berada di luar cakupan pemantauan Apigee. Jika Anda menerima pemberitahuan tentang masalah Cloud EKM, Anda harus menyelidiki kondisi dan konfigurasi layanan Cloud EKM Anda.