监控器与告警(Monitors and Alerts)

监控器在所有 Langfuse Cloud 计划中可用;自托管版本需要 v4。

在 Langfuse Cloud 上,每个组织的监控器数量取决于你的计划:2(Hobby)、20(Core)、50(Pro)和 100(Enterprise)。

监控器让你能够在成本和质量问题影响用户之前捕获它们。

你可以通过 Slack 接收通知、触发 GitHub Actions,或调用你自己的 Webhooks。

创建监控器

在你的项目中导航到 Monitors 并点击 New Monitor。

告警状态

每个监控器带有一个严重性(severity),在每次评估后更新。

告警何时触发:

• 告警(UNKNOWN | OK → WARNING | ALERT):始终通知。
• 恢复(WARNING | ALERT → OK):始终通知。
• 无数据(NO_DATA ↔ WARNING | ALERT | OK | UNKNOWN):仅当无数据模式为 Notify after sustained NO_DATA 时通知。
• 持续严重性(WARNING → WARNING、ALERT → ALERT):仅当启用 Renotify 时触发。

暂停与恢复

从监控器列表或详情页,使用行操作菜单**暂停(Pause)或恢复(Resume)**监控器。暂停的监控器跳过所有评估;其严重性冻结在 PAUSED。恢复会将其设回 ACTIVE 并安排下一次评估。

自动化(Automations)

自动化将监控器告警路由到外部系统。每个自动化将一个触发器(监控器严重性变化)与一个操作(发送到外部系统的通知)配对。

有三种通知渠道:

如果你希望添加另一个渠道,请添加到 GitHub discussions。

创建监控器自动化

1. 导航到 Automations 并点击 Create Automation。
2. 选择事件源 Monitor。
3. 选择操作类型(Slack、Webhook 或 GitHub Actions)。
4. 配置操作:提供 Slack 频道、webhook 端点 URL,或 GitHub 仓库 dispatch URL、事件类型和个人访问令牌。
5. 为自动化命名并点击 Save。当你创建或编辑监控器时,它会出现在 Automations 面板中。

将监控器链接到自动化

1. 创建新的监控器自动化或编辑现有的。
2. 创建新的监控器或编辑现有的。
3. 从监控器编辑器通知部分的 Automations 面板中选择该自动化。
4. 点击 Save 将监控器链接到所选自动化。

每当监控器的严重性转换时,它会触发每个链接的自动化(参见告警状态)。

在连续 5 次投递失败后,Langfuse 会自动禁用该自动化的触发器。一旦端点恢复,从 Automations 页面重新启用它。

Webhook 负载

你的端点收到一个签名的 JSON 体:

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "timestamp": "2024-07-10T10:30:00Z",
  "type": "monitor-alert",
  "apiVersion": "v1",
  "payload": {
    "monitorId": "monitor_abc123",
    "projectId": "proj_xyz789",
    "permalink": "https://cloud.langfuse.com/project/proj_xyz789/monitors/monitor_abc123",
    "message": {
      "title": "avg latency crossed alert threshold",
      "body": "avg latency is 1234 ms (threshold: 1000 ms) over the last 1 hour"
    },
    "severity": "ALERT",
    "timestamp": "2024-07-10T10:30:00Z",
    "fromTimestamp": "2024-07-10T09:30:00Z",
    "toTimestamp": "2024-07-10T10:30:00Z",
    "view": "observations",
    "filters": [],
    "window": "1h"
  }
}

签名验证与提示词 webhooks 相同——HMAC 验证代码参见 Webhooks。