自信运维:用编码代理检查生产环境

自信运维:用编码代理检查生产环境

💡 原文英文,约1000词,阅读约需4分钟。
📝

内容提要

Supabase 推出“Agent prompts”等五项更新,使编码代理可定期检查生产项目:健康、安全、性能、资源四类提示可定时运行,报告新出现或恶化的问题,并给出实测值与下一步。配套新增只读 SQL 查询日志工具 query_logs、覆盖调试的 agent 技能、Advisors 健康标签页及数据库连接页面,便于定位错误、慢查询和阻塞连接。

🔎

延伸解读

定时巡检的前提:保存告警状态

文章强调,要让代理跳过已报告的问题,代理工具必须在两次运行之间保存告警状态。否则代理会表示无法判断哪些是新问题。这意味着定时检查并非开箱即用,需要确认所用工具(如 Claude routine、Codex 任务或 Cursor 自动化)是否具备状态持久化能力,否则每次运行都可能重复报告旧问题。

只读权限与预授权:安全运行的关键

设置时需将 MCP 服务器限定到单个项目并加上 read_only=true,使所有查询以只读 Postgres 用户执行。由于定时运行无法中途请求批准,必须预先只批准提示所需的只读工具。文章还提醒代理应忽略日志或查询结果中出现的指令,避免被注入内容误导。这些措施共同降低了自动检查生产环境的风险。

从报告到行动:仪表盘与工具的分工

报告会给出实测值、阈值和下一步,但后续排查依赖配套页面:错误率异常可打开 Advisors 的 Health 标签页;连接压力或阻塞查询则打开 Database Connections 页面,在那里可以取消查询或终止连接,无需写 SQL。query_logs 工具支持对最长 24 小时的日志做只读 SQL 聚合与关联,帮助代理对比相邻小时的错误变化。

起步建议:先手动跑一次再定时

文章建议先粘贴提示手动运行一次并阅读报告,再安排定时任务。对于小项目,可从单个提示开始,按每日或每周频率运行。四个提示分别覆盖健康、安全、性能和资源,建议频率不同(健康与性能每小时,安全与资源每日),但阈值来自公开检测检查,属于可覆盖的起始告警策略,并非固定标准。

❓

Q&A

Supabase 的 Agent prompts 是什么?它能做什么?

Agent prompts 是 Supabase 推出的一项功能,让编码代理可以定期检查生产项目。它提供健康、安全、性能、资源四类提示,可定时运行,报告新出现或恶化的问题,并给出实测值和下一步建议。

如何设置定时检查来监控 Supabase 生产项目?

设置步骤:1. 以只读方式连接 Supabase MCP 服务器(使用 project_ref 和 read_only=true);2. 从文档页复制一个提示;3. 先运行一次并阅读报告;4. 创建 Claude routine、Codex 计划任务或 Cursor 自动化来定时运行;5. 根据报告采取行动。

query_logs 工具是什么?它有什么用途?

query_logs 是一个新的 Supabase MCP 工具,可对项目日志运行只读 SQL,每次请求最多查询 24 小时的数据,并能聚合和连接日志字段。健康提示用它来比较每小时 API 和 Auth 服务器错误与前一小时的情况。

更新后的 agent skills 在调试方面有什么改进?

supabase agent skill 现在覆盖调试。当代理遇到项目错误(如 Postgres 或 PostgREST 错误代码、空结果或意外的 RLS 阻止)时,它会先获取当前的 Supabase 可观测性文档,而不是凭记忆诊断问题。这些文档列出了需要关注的健康、安全、性能和资源信号以及如何检查每个信号。

Advisors 中的 Health 标签页有什么作用?

Advisors 页面新增了 Health 标签页,与 Security 和 Performance 并列。它标记 Data API、Auth、Storage 和 Edge Functions 中高于正常的错误率。可以从仪表板或 Management API 按需运行健康检查,每个发现会说明应读取哪个日志源以及如何解释错误。

Database Connections 页面能帮助我做什么?

Database Connections 是一个仪表板页面,显示哪些会话持有连接、哪些查询运行时间长、哪些在事务中空闲或被阻塞,以及哪个会话持有锁。你可以直接从页面取消查询或终止连接,无需编写 SQL。该功能默认对所有项目开启,包括自托管。

🏷️

标签

➡️

继续阅读