Estimación de costos y migración práctica al adoptar Vercel Workflows
El muro del tiempo de espera en serverless y el cálculo de costos mensuales
Al operar un SaaS con funciones serverless, el límite de tiempo de espera de 10 a 60 segundos suele ser un obstáculo con frecuencia inesperada. Al implementar respaldos de datos a gran escala o canales de generación de medios con IA multimodal, el entorno serverless existente interrumpe constantemente el código.
Vercel Workflows mantiene las tareas activas mientras reduce el consumo de recursos a cero cuando la función entra en estado de espera. Para predecir los costos, ejecuta directamente un script de TypeScript para calcular el gasto mensual por adelantado. Define la cantidad de ejecuciones diarias, el número de pasos, el tiempo de ejecución y el tamaño de la carga útil como objetos, y luego introdúcelos en la función de cálculo de costos. Si se superan los límites del plan Hobby de 50 000 eventos al mes y 1 GB de escritura, debes prepararte con anticipación para actualizar a Pro. Si se ejecuta menos de 15 000 veces al mes, se puede cubrir dentro de los créditos básicos de Pro, lo que reduce los costos en comparación con mantener una infraestructura de Redis autoalojada.
`typescript
interface WorkflowMetrics {
dailyExecutions: number;
stepsPerExecution: number;
avgStepDurationMs: number;
payloadSizeKb: number;
}
function calculateEstimatedCost(metrics: WorkflowMetrics): { totalEvents: number; estimatedCostUsd: number } {
const totalEvents = metrics.dailyExecutions * metrics.stepsPerExecution * 30;
const freeTierEvents = 50000;
const overageEvents = Math.max(0, totalEvents - freeTierEvents);
const costPerThousand = 0.20;
const estimatedCostUsd = (overageEvents / 1000) * costPerThungk?: number;
return {
totalEvents,
estimatedCostUsd: Number(((overageEvents / 1000) * costPerThousand).toFixed(2))
};
}
`
Procedimiento para migrar de una cola de mensajes al SDK de workflows
Cuando se utilizaba BullMQ o AWS SQS, la creación de colas, la publicación de tareas, la recepción y la gestión de conexiones de Redis se programaban manualmente de forma íntegra. Este proceso infla el código de manera innecesaria. El SDK de Vercel Workflows elimina este código de infraestructura mediante directivas a nivel de código.
La migración se completa en 3 pasos. Primero, se aplica el envoltorio withWorkflow en el archivo next.config.ts. Segundo, en lugar del proceso de trabajador existente, se utiliza la directiva use step para escribir tareas individuales como funciones asíncronas. Tercero, se descarta la compleja estructura encadenada de trabajos padre-hijo (Parent-Child Job) y se utilizan declaraciones de control de JavaScript junto con la función await sleep dentro de use workflow. A medida que desaparece el código de conexión externa a Redis, se reduce la huella de memoria de la aplicación y se acelera el tiempo de transición.
`typescript
import { workflow } from "@vercel/workflows";
export const { POST } = workflow(async (context) => {
const userId = context.request.payload.userId;
const data = await context.run("fetch-user-data", async () => {
const res = await fetch(https://api.example.com/users/${userId});
return res.json();
});
await context.sleep("wait-for-processing", "10m");
await context.run("finalize-task", async () => {
await db.users.update({ where: { id: userId }, data: { status: "processed" } });
});
});
`
Manejo de errores para proteger la consistencia de los datos en situaciones de desconexión de red
Para evitar la pérdida de datos cuando ocurren fallas no deterministas, primero se debe separar la naturaleza de los errores. Vercel Workflows maneja los errores dividiéndolos en fallas temporales y fallas críticas.
Para capturar errores dentro de un paso, primero se lanza un RetryableError cuando se produce un error de la familia HTTP 429 o 500 para inducir reintentos basados en retroceso exponencial (exponential backoff). Luego, dentro del paso que modifica la base de datos, se incluye una lógica de verificación de clave única para evitar que se acumulen datos duplicados al reintentar. Por último, se conecta Vercel Log Drains con Sentry para transmitir registros JSON estructurados en tiempo real. Al aplicar este patrón, el estado se recupera desde el punto de interrupción incluso en situaciones de excepción, eliminando la necesidad de recuperar datos manualmente.
`typescript
import { RetryableError } from "@vercel/workflows";
export async function processPaymentStep(context: any, paymentData: any) {
return await context.run("charge-payment", async () => {
const exists = await db.transactions.findUnique({
where: { idempotencyKey: paymentData.key }
});
if (exists) {
return exists;
}
const response = await paymentGateway.charge(paymentData);
if (response.status === 429 || response.status >= 500) {
throw new RetryableError("Payment gateway overloaded, retrying...");
}
return await db.transactions.create({
data: { idempotencyKey: paymentData.key, amount: response.amount }
});
});
}
`