Trigger.dev 任务运行成本与时长监控指南-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00835/article/details/148394328

Trigger.dev 任务运行成本与时长监控指南

trigger.dev ✨ Trigger.dev is the open source background jobs framework for TypeScript. With features like API integrations, webhooks, scheduling and delays. 项目地址: https://gitcode.com/gh_mirrors/tr/trigger.dev

理解运行成本与时长监控的重要性

在现代云原生应用开发中，精确掌握任务执行的成本和时长对于优化资源使用和成本控制至关重要。Trigger.dev 提供了完善的运行监控机制，让开发者能够实时获取任务执行的详细成本和时间数据。

获取当前运行的成本和时长

在任务执行过程中，可以通过 usage.getCurrent() 方法获取当前运行的成本和时长信息。这个方法返回一个包含详细计费信息的对象：

export const heavyTask = task({
  id: "heavy-task",
  machine: {
    preset: "medium-2x",
  },
  run: async (payload, { ctx }) => {
    // 执行一些计算密集型操作
    const result = await convertVideo(payload.videoUrl);

    // 获取当前运行的成本和时长
    let currentUsage = usage.getCurrent();
    /* 返回数据结构示例：
    {
        compute: {
          attempt: {
            costInCents: 0.01700,  // 当前尝试的计算成本(美分)
            durationMs: 1000,      // 当前尝试的计算时长(毫秒)
          },
          total: {
            costInCents: 0.0255,   // 包括重试在内的总计算成本
            durationMs: 1500,      // 包括重试在内的总计算时长
          },
        },
        baseCostInCents: 0.0025,   // 基础成本
        totalCostInCents: 0.028,   // 总成本(计算成本+基础成本)
      }
    */
  }
});

重要注意事项

等待时间不计费：在 Trigger.dev 云服务中，wait.for() 等等待操作不会计入计算成本或时长。
重试机制：总成本(total)包含了所有重试尝试的成本，而当前尝试(attempt)仅反映当前执行的成本。
执行前时间：任务开始执行代码前的时间不计入计算时长。

从后端获取运行数据

除了在任务内部获取数据，Trigger.dev 还提供了从外部获取运行数据的API：

获取单个运行数据

import { runs } from "@trigger.dev/sdk/v3";

const run = await runs.retrieve("run-id");
console.log(run.costInCents, run.baseCostInCents, run.durationMs);
const totalCost = run.costInCents + run.baseCostInCents;

批量获取运行数据

import { runs } from "@trigger.dev/sdk/v3";

let totalCost = 0;
for await (const run of runs.list({ tag: "user_123456" })) {
  totalCost += run.costInCents + run.baseCostInCents;
  console.log(run.costInCents, run.baseCostInCents, run.durationMs);
}

console.log("Total cost", totalCost);

这种方法特别适合：

生成用户账单
分析特定时间段或标签的运行成本
监控系统整体资源消耗

测量代码块的成本和时长

对于需要精确测量特定代码段性能的场景，可以使用 usage.measure 方法：

const { result, compute } = await usage.measure(async () => {
  // 执行需要测量的代码
  await processLargeDataset();
  return {
    processed: true
  };
});

console.log("执行结果:", result);
console.log("计算成本:", compute.costInCents);
console.log("计算时长:", compute.durationMs);