本頁面適用於 Apigee，但不適用於 Apigee Hybrid。
查看
Apigee Edge 說明文件。
本文說明如何監控與 Apigee 搭配使用的 Cloud External Key Manager (Cloud EKM) 健康狀態，以及如何使用 Cloud Logging 設定 Cloud EKM 相關問題的警告。
Apigee 可能會使用 Cloud EKM 進行 CMEK。如果 Cloud EKM 因網路問題而無法使用，或是金鑰遭到停用或無法連線，依賴加密功能的 Apigee 服務可能會受到影響。
在 Cloud Logging 中監控 Cloud EKM 問題
如果 Apigee 遇到 Cloud EKM 相關問題，例如狀態變更為「遭拒」、金鑰停用、帳單停用或無法連線至金鑰，就會在 Cloud Logging 中產生記錄項目。您可以在Logs Explorer中查看這些記錄，並設定記錄式警告，以便在發生這類事件時收到通知。
記錄項目包含發生問題的組織和執行個體詳細資料，但基於安全考量，會省略金鑰名稱。
如要在記錄檔探索工具中尋找 Cloud EKM 相關記錄項目，請按照下列步驟操作：
- 前往 Google Cloud 控制台的「Logs Explorer」頁面。
- 在查詢編輯器欄位中輸入下列查詢，然後按一下「Run query」(執行查詢)：
Apigee EKM key health issue detected
- 如果發生 Cloud EKM 問題，查詢結果會顯示記錄項目，詳細說明事件。
設定 Cloud EKM 問題的記錄檔型警告
您可以建立記錄型警告政策，在 Apigee 記錄 Cloud EKM 相關錯誤時通知您。這些快訊可協助您主動找出並解決 Cloud EKM 的問題。
如要根據 Cloud EKM 錯誤訊息字串設定記錄檔快訊，請參閱 Cloud Logging 說明文件中的「 設定記錄檔警告政策」。
建立快訊時，請使用「 在 Cloud Logging 中監控 Cloud EKM 問題」一文所述的查詢篩選器，比對特定 Cloud EKM 記錄項目。
快訊限制和復原
設定及回應 Cloud EKM 健康狀態警告時，請注意下列限制：
- 週期性快訊：如果金鑰仍無法連線，Apigee 大約每小時會產生一筆記錄項目。如果您設定記錄式警告，就會按照這個頻率收到通知，直到根本問題解決為止。
- 不傳送復原通知：Cloud EKM 恢復連線時，Apigee 不會產生記錄項目或傳送通知。Apigee 停止產生錯誤記錄項目後，記錄警告會根據警告政策的自動關閉設定自行解決。
- 驗證復原：由於系統不會產生復原記錄項目，請執行需要金鑰的操作 (例如部署 API Proxy)，並確認操作成功，藉此確認 Cloud EKM 是否再次可供連線。
疑難排解限制
如果 Cloud EKM 連線或金鑰狀態發生問題，Apigee 記錄會顯示相關資訊。不過，Cloud EKM 本身的詳細疑難排解 (例如診斷網路連線問題或外部金鑰管理工具端的問題) 不在 Apigee 監控範圍內。如果收到 Cloud EKM 問題的警示，請檢查 Cloud EKM 服務的健康狀態和設定。