服务对象与地域限制
PuppyIP 仅面向海外合规企业及其授权人员提供服务,不面向中国大陆地区开放或提供代理服务。本服务仅限用于中国大陆境外的合法业务活动,严禁在中国大陆境内使用本服务。
代理 IP 或服务器位于境外,不改变上述限制。不得通过中转、转接、共享或转售向中国大陆境内的最终使用者提供本服务。使用前请阅读用户服务协议。
本文要点
- Google Cloud 于 2026 年 11 月 2 日公布此功能,按可用区逐步推出。单个实例是否已可用,要按实际环境核对。
- 日志会指出受影响的组织和实例,按设计省略密钥名称。
- 密钥持续不可达时,Apigee 约每小时记录一次错误。告警自动关闭后,仍需确认依赖密钥的操作已恢复。
哪些 Apigee 组织可以使用?
这项监控适用于创建组织时就用 Cloud EKM 配置客户管理加密密钥(CMEK)的托管版 Apigee,也就是 Apigee X。Cloud EKM 让加密操作依赖外部密钥管理服务。Apigee Hybrid 不在这项功能的范围内,创建时未选 EKM 的现有组织也无法事后启用。
Google Cloud 在 2026 年 11 月 2 日的发布说明中列出这一功能,说明各 Google Cloud 可用区的推出过程可能需要四个或更多工作日。核对时可以查组织的初始配置和当前环境,单凭公告日期无法确定某个实例已收到更新。
去哪里找故障日志?
在 Google Cloud 的 Logs Explorer 中,选中能读取该 Apigee 日志的项目,将文档给出的检索文本 Apigee EKM key health issue detected 输入查询编辑器并运行。先把时间范围设在故障开始前后,查看返回条目的时间和状态。
这类条目覆盖访问遭拒、密钥被停用、计费被停用或密钥不可达等情况。记录事件所在的组织和实例,再与自己维护的资源清单对照。日志有意省略密钥名。需要定位具体密钥时,按团队的权限和流程查组织的配置记录。
如何设置告警并读懂重复通知?
在 Cloud Logging 创建基于日志的告警策略,用上面同一个查询条件匹配 EKM 故障,将通知发给负责该环境的值班人员。保存前用已存在的脱敏日志核对过滤条件能命中正确的环境。设置中还要确认通知渠道、通知间隔和自动关闭时间。
只要密钥持续不可达,Apigee 大约每小时写入一条故障日志。假设同一实例在 02:10 和 03:10 都出现同类错误,处置时先把它们和原事件关联,核对问题是否持续,再判断是否需要单独开事件。日志的记录间隔也不能作为密钥检查频率或告警送达时间的保证。
告警关闭后,怎样确认服务恢复?
密钥重新可达时,Apigee 不会额外写入恢复日志,也不会发恢复通知。错误停止进入后,日志型告警会按策略的自动关闭设置处理。值班记录可以把最后一次异常、告警关闭和验证成功分别记下来。
先请负责外部密钥的团队确认可达性,再按变更流程运行一个确实需要相关密钥的操作。Google 举例是部署 API proxy。优先用符合条件的非生产环境验证,并确认该操作实际依赖需要验证的密钥。只有生产环境可以覆盖该密钥时,安排团队已授权的验证。普通健康检查成功不足以证明这条加密链路恢复。
什么情况下要继续查外部密钥服务?
Apigee 日志用于发现它观察到的密钥或连接故障。若网络不通,或者问题发生在外部密钥管理器一侧,由相应团队按原有权限核对配置、连接和服务状态。
交接时带上时间范围、受影响的组织和实例、错误状态及近期相关变更。等到依赖密钥的操作确认成功,再记录恢复已验证。这样可以保留可核对的恢复证据,也方便区分多个实例可能同时受到的影响。
资料来源
常见问题
查不到 EKM 日志,就能确认密钥一直可用吗?
仅凭空查询无法确认。先核对组织资格、项目、读取权限和时间范围。确需判断当前可用性时,用经过批准且确实依赖该密钥的操作验证。
同一项目里多个 Apigee 实例都告警怎么办?
按日志中的组织、实例和时间归类,检查是否指向同一外部依赖。保留各实例的验证结果,避免把一处成功记录成全项目恢复。