# 指标监控

选中一个数值，设置时间范围和触发条件，满足条件时自动通知。

使用指南 · 模块: automation · 使用者 · 部署形态：资料未说明 · 已确认产品版本：资料未说明 · 来源：编辑整理 · 按产品 4.2.76-1110（CLI 0.0.18）核对；私有部署的旧版本可能不包含近期变化。

指标监控定期检查一个数值，例如「最近 1 小时的订单量」，满足条件（例如低于 100）时通过邮件或飞书通知你。它不生成分析报告；需要定期收到报告时用[定时任务](https://docs.asktable.com/integrations/scheduled-reports)。

指标监控目前为 Beta。只支持可解释的 SQL 汇总指标（例如求和、计数），不支持依赖 Python 或其他额外计算得出的数字。

入口：左侧主导航 →「自动化」，或在对话、看板的数据表中直接创建。

## 创建监控

**选择数值**

在对话或数据看板的数据表中，选中要监控的数值，点「监控此指标」。

**确认统计范围和计算规则**

系统会解释这个数值的统计对象、业务筛选和计算规则，请核对是否符合你的口径。无法完整解释时，回到对话中把指标和时间范围问清楚，再重新创建。

**选择时间范围**

| 方式       | 说明                                       |
| -------- | ---------------------------------------- |
| 滚动时间窗口   | 最近 1 小时、最近 24 小时、最近 7 天，或自定义分钟数；每次检查重新计算 |
| 自然时间段    | 今天截至本次检查、昨天、本周、上周、本月、上月                  |
| 文字描述     | 例如「过去三小时」「本周以来」，识别后确认结果                  |
| 沿用原查询的范围 | 原查询中的固定日期不会移动，只适合持续观察同一时间段               |

时间字段只有日期时，不能使用小时或分钟窗口，请选择自然日。在「高级设置」中可以设置数据时间的时区和等待数据入库的分钟数。

**设置触发条件**

选择条件：大于、小于、等于、大于等于、小于等于、不等于、在范围内、不在范围内，并填写阈值。

**选择 Action 并试查**

选择一个邮件或飞书 [Action](https://docs.asktable.com/automation/actions)，点「试查当前口径」查看当前值。修改条件后需要重新试查，试查结果 15 分钟内有效。

**创建并启用**

点「确认规则并创建监控」。默认每 10 分钟检查一次，两次通知至少间隔 60 分钟。创建后默认停用，确认无误后启用。

## 通知规则

- 首次满足条件时发送通知。
- 冷却时间内不重复通知；冷却结束时仍满足条件，才再次通知。
- 恢复正常后再次满足条件，会重新触发。

## 怎样用好

- **监控汇总值，而不是排名。** 「华东区销售额」是稳定的指标；「销售额第一的门店」会变化，不适合监控。查询含 Top N 或分页时，目标行可能不在结果中，会记为检查失败，而不是 0。
- **数据有延迟时设置等待时间。** 数据每小时入库一次时，设置等待数据入库的分钟数，避免把未到齐的数据当成下降。
- **阈值留出余量。** 根据历史波动设置阈值，并调整冷却时间，避免频繁打扰。

## 监控异常

| 状态         | 原因             | 处理                             |
| ---------- | -------------- | ------------------------------ |
| 需要修复，监控已暂停 | 数据源的字段发生变化     | 修复数据源后重新试查并保存，再手动启用；或重新查询并创建监控 |
| 重试中        | 检查连续失败，仍按原频率重试 | 检查数据源连接；最近成功值不代表当前数据           |
| 监控已停用      | 上次检查失败         | 处理后重新启用                        |
| 故障提醒未能送达   | Action 配置有误    | 检查 Action                      |

文件型数据源只反映已同步的数据，监控不会自动拉取外部文件。成员停用前的确认窗口会提示其监控将暂停。

## 常见问题

| 现象             | 原因                | 处理                 |
| -------------- | ----------------- | ------------------ |
| 提示暂时无法确认这项指标   | 原查询的指标或时间范围不明确    | 在对话中明确指标和时间范围后重试   |
| 提示未识别到可替换的时间范围 | 查询有多个时间字段或复杂的时间条件 | 在对话中只保留一个时间条件后重新查询 |
| 试查失败           | 指标不是数字，或业务行不唯一    | 改为单一汇总值            |
| 没有可选的 Action   | 还没有 Action        | 点「管理 Action」新建     |