告警

Alerts（告警）模块让你可以实时监控钱包活动，并通过 Telegram 等外部渠道接收即时通知。你可以为特定钱包设置基于事件或基于条件的告警，将其发送到团队的沟通渠道，在事情发生的第一时间收到通知，而无需一直盯着控制台。

告警分为两个标签页：

  • Alert：你已配置的告警及其当前状态
  • Channels：接收告警消息的通知目的地（例如 Telegram 群组）

设置通知渠道

通知渠道是告警的投递目的地。目前，Fystack 支持 Telegram 频道和群组。

第 1 步：进入 Alerts 并打开 Channels 标签页

在左侧边栏中点击 Alerts，然后选择 Channels 标签页。现有渠道都会显示在这里。点击 + Create Channel 添加新渠道。

Alerts 的 Channels 标签页，显示现有渠道和 Create Channel 按钮

第 2 步：填写渠道详情

在 Create Notification Channel 弹窗中，填写以下字段：

  1. Channel Type：从下拉框中选择 Telegram
  2. Channel Name：用于在 Fystack 中识别该渠道的名称（例如 Marketing Department、Ops Team）
  3. Description：可选的备注，说明该渠道的用途

点击 Create Channel 保存。

Create Notification Channel 弹窗，包含 Channel Type、Channel Name 和 Description 字段

第 3 步：将渠道连接到 Telegram

创建后，该渠道会出现在列表中，显示为 Connected: False。它需要关联到一个 Telegram 聊天后才能投递告警。点击该行右侧的 Connect channel 图标（链接图标）。

渠道列表，显示新创建的 Demo Channel，Connected 为 False 渠道列表行上高亮显示的 Connect channel 图标

第 4 步：在 Telegram 中关联 Fystack Alert Bot

Channel Connection Setup 对话框会打开，其中包含唯一的连接码和操作说明。关联渠道的步骤如下：

  1. 打开 Telegram，搜索 @FystackAlertBot
  2. 与机器人开始私聊，或将其添加到你希望接收通知的群组或频道
  3. 发送对话框中显示的连接码：点击连接码字段进行复制，然后将其作为消息粘贴发送给机器人
Channel Connection Setup 对话框，显示 Telegram 机器人名称和需要发送的连接码

机器人会回复确认信息："Channel successfully linked! You will now receive alerts here."

与 Fystack Alert Bot 的 Telegram 聊天，确认渠道已成功关联

如需团队通知，请将 @FystackAlertBot 添加到 Telegram 群组或频道，并确保它拥有发送消息的权限。如需个人通知，与机器人私聊即可。

第 5 步：点击 Complete Setup

回到 Channel Connection Setup 对话框，状态指示器现在显示 Connected。点击 Complete Setup 完成配置。

Channel Connection Setup 对话框，显示 Connected 状态并高亮 Complete Setup 按钮

渠道列表中该渠道现在显示为 Connected: True，已可以接收告警通知。

渠道列表，Demo Channel 现在显示 Connected 为 True

创建告警

创建告警前，你必须至少有一个已连接的渠道。如果尚未设置，请先按照上面的步骤操作。

进入 Alert 标签页，点击 + Create Alert 设置监控规则。

Alert 标签页，显示现有告警列表和 Create Alert 按钮

第 1 步：选择告警类型

Create Alert 向导首先会询问你要监控什么。选择适合你使用场景的类型，然后点击 Next。

Create Alert 类型选择界面，显示 Event Alert 和 Trigger Alert 选项
类型 触发时机 使用场景示例
Event Alert 发生特定的钱包操作：收到充值、提交提现请求、提现被批准、提现被取消或提现已执行 每当热钱包执行一笔提现时通知运营团队
Trigger Alert 钱包状态满足设定条件：余额低于阈值、交易量超过限额或检测到异常活动 当资金库钱包的 USDC 余额低于 100 时发出告警

第 2 步：选择事件类型和目标钱包

对于 Event Alert，从列表中选择一个或多个要监控的钱包事件：

  • Incoming Deposit：收到资金时触发
  • Withdrawal Request：提交提现时触发
  • Withdrawal Approval：提现被 Signer 批准时触发
  • Withdrawal Cancel：提现被取消时触发
  • Withdrawal Executed：提现在链上完成时触发

然后选择一个或多个 Target Wallets 来限定告警范围。底部的摘要会确认将监控多少种事件类型和多少个钱包。

Create Alert 步骤，显示事件类型选择和目标钱包选择器

对于 Trigger Alert，此步骤会改为要求你定义条件（例如 balance gte 100 USDC）以及要评估的钱包。系统会根据实时钱包状态持续检查该条件。

第 3 步：选择通知渠道

选择哪些通知渠道接收此告警的消息。所有已连接的渠道都会出现在 Add Notification Channel 选择器中。选择一个或多个渠道，确认底部的摘要，然后点击 Create Alert。

Create Alert 步骤，显示通知渠道选择器，已选中 Demo Channel

告警已启用

新告警会出现在 Alert 列表中，显示为 Active: True。每一行显示告警类型、事件或触发条件、所监控的钱包、创建者以及关联的渠道。

告警列表，显示多个已启用的告警及其类型、事件、钱包和渠道

测试告警

验证告警是否正常工作的最快方式是手动触发其中一个被监控的事件。对于 Withdrawal Request 或 Withdrawal Executed 事件告警，从某个目标钱包发起一笔提现即可。

Withdraw 弹窗，发起一笔测试提现以验证告警通知

事件触发后，Fystack Alert Bot 会在几秒内向你的 Telegram 渠道发送一条结构化消息。消息包含事件类型、钱包名称、交易 ID、金额、网络、收款地址以及区块浏览器链接。

Fystack Alert Bot 发送的 Telegram 消息，显示包含完整交易详情的 Withdrawal Requested 通知

最佳实践

  • 为每个团队或职能创建一个渠道：为运营、财务和合规分别设置渠道，可以更轻松地将合适的告警发送给合适的人，避免信息干扰。
  • 使用 Event Alert 形成审计记录：同时配置 Withdrawal Approval 和 Withdrawal Executed 告警，可以为团队提供每笔交易的实时记录，作为工作区审计日志的补充。
  • 使用 Trigger Alert 监控余额：为用于自动化归集任务的钱包设置最低余额阈值，以便在余额不足阻碍自动转账之前及时发现。
  • 在依赖新告警之前先进行测试：设置完成后立即手动触发被监控的事件，确认机器人消息已送达预期的 Telegram 聊天。
  • 将机器人添加到群组以便团队查看：个人私信很容易被忽略。共享的 Telegram 群组可确保整个团队实时看到关键事件。