¿Qué hace convex-performance-audit?
Audita el rendimiento de Convex en lecturas, suscripciones, contención de escritura y límites de funciones. Útil para funciones lentas, hallazgos de insights, conflictos OCC o amplificación de lectura.
Esta habilidad analiza el rendimiento de tu proyecto Convex, enfocándose en:
- Lecturas: Identifica consultas ineficientes, falta de índices o carga excesiva de datos.
- Suscripciones: Detecta suscripciones que pueden estar causando una sobrecarga de actualizaciones en el cliente.
- Contención de escritura: Encuentra conflictos de concurrencia optimista (OCC) y sugiere mejores estrategias de escritura.
- Límites de funciones: Verifica si alguna función está cerca de los límites de ejecución (tiempo, tamaño de respuesta, etc.) y sugiere optimizaciones.
¿Cómo usarla?
-
Ejecuta el comando de auditoría (ajusta según tu flujo de trabajo):
npx convex performance-audit -
Revisa el informe generado, que incluirá secciones como:
- Lecturas lentas detectadas en la función `getUserData`. - Suscripción `onMessage` con alta frecuencia de actualizaciones. - Posible contención en `updateBalance`. - Función `processBatch` cerca del límite de tiempo (5s). -
Aplica las recomendaciones (ej. añadir índices, optimizar queries, usar mutaciones por lotes).
Plataformas compatibles: Claude Code, Cursor, Codex, y cualquier agente que lea SKILL.md.
Nota: Asegúrate de que tu proyecto tenga convex instalado y configurado. El auditor utiliza las APIs de Convex para obtener métricas y analizar el código fuente.
Para más detalles, consulta la documentación oficial de Convex sobre rendimiento.