Community写作与编辑github.com

get-convex/convex-performance-audit

审计 Convex 性能,涵盖读取、订阅、写入争用和函数限制。适用于慢速功能、Insights 发现、OCC 冲突或读取放大问题。

convex-performance-audit 是什么?

该技能用于对 Convex 后端进行全面性能审计。它专注于分析读取操作、实时订阅、写入事务的争用情况以及函数执行限制。当开发者遇到功能响应缓慢、在 Convex 仪表盘 Insights 中观察到异常指标、出现乐观并发控制(OCC)冲突,或者怀疑存在读取放大(即单个操作导致大量数据库读取)时,此技能特别有用。通过系统性地检查这些关键性能维度,该技能帮助定位瓶颈、优化查询和订阅设计,并确保 Convex 应用程序在读写负载下高效运行。它适用于任何使用 Convex 作为后端服务的项目,并能输出结构化的审计发现,为开发者提供可操作的改进建议。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/get-convex/agent-skills/tree/main/skills/convex-performance-audit

Installed? Explore more 写作与编辑 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

convex-performance-audit 是做什么的?

审计 Convex 性能,涵盖读取、订阅、写入争用和函数限制。适用于慢速功能、Insights 发现、OCC 冲突或读取放大问题。

概述

此技能对 Convex 应用程序进行性能审计,重点关注以下方面:

  • 读取性能:分析数据库读取的效率和延迟。
  • 订阅性能:评估实时订阅的开销和可扩展性。
  • 写入争用:检测并诊断写入操作中的乐观并发控制(OCC)冲突。
  • 函数限制:检查函数执行是否超过 Convex 的限制(如执行时间、内存)。

使用场景

  • 解决响应慢的功能或页面。
  • 分析 Convex 仪表盘 Insights 中报告的异常。
  • 处理 ConcurrentWriteConflict 或 OCC 错误。
  • 减少由于过度加载数据而导致的读取放大。

支持平台

  • Convex

工作原理

该技能通过检查 Convex 数据模型、查询模式、订阅设置和函数定义来工作。它利用 Convex 的内置监控工具和最佳实践来生成详细的审计报告,包括问题、影响和优化建议。

使用方法

运行以下命令进行审计:

convex run auditer

审计完成后,结果将以结构化格式输出,便于采取后续行动。

示例输出

{
  "issues": [
    {
      "type": "read_amplification",
      "query": "listAllUsers",
      "impact": "高",
      "recommendation": "添加索引并限制返回的文档数。"
    },
    {
      "type": "subscription_overhead",
      "query": "watchNotifications",
      "impact": "中",
      "recommendation": "减少订阅字段数,或使用分页。"
    }
  ]
}

相关文档

Individual skills in this repo

This repo contains 5 individual skills — each has its own dedicated page.

相关技能