如何使用 Webhook 进行告警

欢迎阅读本指南，了解如何创建 webhook 作为告警目标，以从告警服务接收事件。在本指南中，您将学习如何设置 webhook 并查看其执行情况。

​

将 webhook 添加为告警目标

登录后，创建一个新的 Tenderly 项目 或选择您希望在其中创建 Webhook 的现有项目。 从左侧菜单中，前往 Alerts → Destinations 选项卡，您将看到 所有可用目标的列表。 要创建 webhook 告警目标，请点击 Webhook 卡片，这将打开配置弹窗。系统会提示您配置以下选项：

• Webhook 名称 — 必须唯一，且之后不能更改
• Webhook URL — 您将在此 URL 接收来自 Tenderly 的实时事件
• 描述 — 可选参数，可用于提供有关 webhook 配置的更多信息

如果您点击 Advanced Configuration 链接，将打开一个弹窗，展示可用于设置自定义 webhook 的 JavaScript、Python 或 Go 代码片段。 要测试提供的 URL 是否能够接收来自 Tenderly 的事件，请点击 Send test webhook 按钮，预定义的测试负载将被发送到您的端点。 如果一切正常并且您收到了事件，请点击 Add Webhook 按钮。此操作会将新的 webhook 目标添加到 Active Destinations 列表中。 点击右侧的按钮将打开 Webhook 概览页面。您可以在此找到 webhook 状态、URL、创建日期、签名密钥等信息。 您还可以对 webhook 执行其他操作，例如启用/禁用 webhook 或修改现有配置。 启用/禁用 Webhook： 在活动和非活动状态之间切换 webhook 的状态。 删除 Webhook：从您的 Tenderly 项目中移除 webhook。删除 webhook 是永久性操作，无法撤销。 发送测试请求： 通过提供事务哈希及其所在网络，向提供的 URL 发送测试事件，从而测试 webhook 的功能。 编辑 Webhook：修改现有 webhook 的配置，例如 URL 或描述。

​

Webhook 执行历史

在 webhook 概览页面，点击 Execution History 查看已发送到指定 webhook URL 的事务负载以及来自 webhook 端点的响应。 Webhook 执行可能有以下多种状态：

• Success： Webhook 已成功执行，事件已投递到指定的 URL。
• Failed：由于错误（例如连接问题、URL 问题或其他原因），webhook 无法执行。请检查响应内容以了解错误原因，或联系我们的支持。
• Pending：Webhook 正在执行中，尚未完成。
• Retry：Webhook 执行失败，但将最多重试 5 次，直到状态变为 Success 或 Failed。
• Skipped：Webhook 未被执行，因为它已被禁用。

您还可以通过应用不同的过滤器（例如 按状态过滤 和 选择日期范围）查看之前的 webhook 执行记录。

​

将 webhook 连接到 Alert

配置好 webhook 端点后，您可以将其作为 Destination 添加到任何 Alert。 创建 Alert 规则时，您将被重定向到以下页面： 如果您的 Alert 已启用，您将开始向 webhook 端点接收事件。 在此示例中，我们使用 https://webhook.site 创建了一个临时的 webhook 端点来测试 Tenderly webhook 的工作方式。下图展示了成功发送到 webhook 的负载。