概述

本指南介绍了使用 PagerDuty 的 Events API v2 将 PagerDuty 配置为 LangSmith 警报通知渠道的过程。此集成允许关键的 LLM 应用程序问题触发 PagerDuty 事件,通过您已建立的事件管理工作流程实现快速响应。

前提条件

  • 具有管理员访问权限的活跃 PagerDuty 账户
  • PagerDuty 中的适当服务级别权限
此外,如果使用 LangSmith 的自定义部署,请确保没有防火墙设置阻止来自 LangSmith 服务的出站流量。

集成步骤

步骤 1:在 PagerDuty 中创建服务

  1. 登录到您的 PagerDuty 账户
  2. 导航到 Services → Service Directory
  3. 单击 + New Service
  4. 填写以下字段:
    • Name:提供描述性名称(例如,“LangSmith Monitoring”)
    • Description:添加有关受监控应用程序的详细信息
    • Escalation Policy:选择适当的团队升级策略
    • Integration Type:选择 “Events API V2”
  5. 单击 Add Service 以创建服务

步骤 2:获取集成密钥

创建服务后,您需要检索集成密钥:
  1. 从服务下拉菜单下的 Service Directory 中,找到并单击您新创建的服务
  2. 选择 Integrations 选项卡
  3. 找到 “Events API V2” 集成
  4. 复制 Integration Key(32 字符的字母数字字符串)
PagerDuty Integration Key Location

步骤 3:使用 PagerDuty 配置 LangSmith 警报

要在触发警报后一小时内再次接收相同的警报,您必须在 PagerDuty 中解决由警报创建的活跃事件。
PagerDuty Setup
  1. 在 LangSmith 中警报设置的通知部分,选择 PagerDuty
  2. 单击密钥图标以将集成密钥保存为工作区密钥或选择现有的工作区密钥。作为最佳实践,我们建议将集成密钥保存为工作区密钥,而不是直接添加它。这将允许您在工作区的警报中重复使用相同的密钥。
  3. 配置其他通知选项:
    • Severity:映射到 PagerDuty 事件优先级
  4. 通过单击发送测试警报发送测试警报
  5. 验证 PagerDuty 是否触发了事件并包含相关的 LangSmith 警报信息

故障排除

如果未在 PagerDuty 中创建事件:
  • 验证在 LangSmith 中是否正确输入了集成密钥
  • 确保 PagerDuty 服务处于活跃状态且未处于维护模式
  • 检查您的 PagerDuty 账户是否启用了 Events API v2
  • 如果 PagerDuty 中似乎缺少警报触发器,请检查预期的触发器是否在来自同一警报规则的前一个触发器的一小时内发生,以及由前一个警报创建的事件是否仍处于打开状态。
  • 如果您的 LangSmith 实例位于防火墙后面,请检查网络连接

其他资源


Connect these docs programmatically to Claude, VSCode, and more via MCP for real-time answers.