运行管理接口
DBNginx 运行管理接口用于健康检查、运行状态、策略解释、审计查询和生命周期操作。管理接口建议只暴露在运维网络或控制面网络，配合认证、授权和审计。
接口类别
| 类别 | 示例接口 | 用途 |
|---|---|---|
| 健康检查 | /health、/ready | 负载均衡、启动探针、发布检查 |
| 运行状态 | /stats、/upstreams | 连接、请求、拒绝、延迟、上游状态 |
| 策略解释 | /explain/policy | 解释访问为什么允许、拒绝、重写、脱敏或水印 |
| 审计查询 | /audit/events | 按主体、资源、动作、风险、时间和结果查询 |
| 审计追踪 | /audit/traces/{trace_id} | 聚合一次访问的策略链和证据链 |
| 配置生命周期 | /reload/validate、/reload、/rollback | 校验、发布和回滚 |
安全建议
- 管理接口不应直接暴露公网。
- 所有接口调用应记录操作主体和来源。
- 配置发布和回滚需要权限控制。
- 审计导出需要审批或水印。
- 接口错误不要泄露密钥、账号或上游连接信息。
告警建议
重点关注：
- 上游不可用。
- 审计写入失败。
- 拒绝数突增。
- 连接等待升高。
- 链路动态扩展超时。
- 密码设备调用失败。
- 策略发布失败。