自动化与监控

自动化是 Aptli 的集成层——它决定了您的部署如何响应内部事件，并连接到外部系统。 它涵盖四个方面：当事件发生时触发操作的规则、将事件推送至其他系统的钩子、将传感器和设备数据拉取进来的数据采集，以及将这些传入数据转化为读数、图表和警报的监控。

自动化功能包含在每个套餐中。计费依据是您配置的外部连接数量——请参阅下方的连接配额。

页面概览

“自动化”位于独立的导航组中，包含四个页面：

钩子 —— 快速推送事件的途径

钩子 是一个已签名的目标，用于订阅您选择的事件。这是最简单的出站集成：为其指定一个 名称、一个 目标 URL、 要发送的事件、一个签名密钥（以便接收方验证有效载荷来自您），以及（可选）一个有效载荷模板。每个匹配的事件都会通过 POST 请求发送到该 URL。无需条件，无需分支；只需“将这些事件发送到那里”。

当其他系统只需知晓发生了某件事时，请使用钩子。若需要条件判断或非 Webhook 操作，请使用下文介绍的 事件触发器。

事件触发器 — 执行特定操作的规则

事件触发器是一个完整的 触发 → 条件 → 操作 引擎。当事件触发且满足条件时，将执行一项或多项操作。您可以从 “什么应该自动发生？” 配方库中创建一个新的触发器，或者直接进入完整编辑器。

触发器

触发器按其在 Aptli 中的来源进行分组。以下是一些示例：

• 工作 — workOrder.created、workOrder.statusChanged、report.completed、report.validated、report.rejected、validation.statusChanged
• 项目与任务 — project.created、project.statusChanged、job.created、job.removed
• 库存 — inventory.created、stock.adjusted、stock.transferred、stock.low
• 导入与版本 — geo.import.completed、geo.import.failed、version.submittedForReview、version.committed
• 用户、文件、求助请求 — user.invited、file.uploaded、file.quarantine_failed、helpRequest.created、helpRequest.statusChanged
• 传感器数据 — sensor.reading（每个数据采集批次触发一次，携带该批次的聚合数据——这是从数据采集到自动化的桥梁）
• 告警 — alarm.raised 和 alarm.resolved (§293)。与 sensor.reading 不同，这些事件携带完整的操作集，因此违规事件可以创建工单、更新字段或通知相关人员——而不仅仅是触发钩子
• 定时任务 — schedule.daily、schedule.weekly、schedule.monthly
• SLA 计时器 — timer.threshold、timer.expired、timer.escalated（由正在运行的生命周期计时器触发）

条件

条件用于限定触发器何时触发，它们基于事件上下文进行评估，并以“且”条件组合（所有条件必须都满足）：

• workOrder.status == 'completed' —— 仅在任务完成时触发
• actor.email endsWith '@myorg.com' —— 仅限内部用户
• job.featureCount > 1000 — 仅限大规模导入

操作

每个触发器都带有内置的 测试运行 面板——通过一个按钮，即可针对该触发器的 合成样本上下文 触发规则。 使用前需了解两点：它会跳过条件判断（直接执行操作），且并非干跑——外发操作（Webhook、Postgres、工件交付） 会实际执行，目标是您配置的目标，只是在“交付”中会标记为测试状态。电子邮件会进行验证但不会发送，而会修改记录的操作（创建/更新）会被跳过。因此，请将测试指向一个安全的目标；此功能用于确认连接配置，而非无操作预览。

数据采集 — 导入传感器和设备数据

采集连接器是一种将读数输入到 Aptli 的外部数据源。每个连接器都有一个 模式：

• 拉取（定时轮询） — Aptli 会按 间隔（至少 30 秒）轮询供应商的 REST API。您需要设置 URL、凭据 以及一个简短的响应映射（读数路径、 时间戳键、值键、指标键），以便 Aptli 读取供应商的 JSON 数据。
• 推送（发送方 POST） — 发送方将 JSON 批次数据通过 POST 方式发送到连接器自身的入站端点（保存连接器后会显示该端点），并使用 数据采集 API 密钥 进行身份验证。无需轮询；设备或网关会按照自己的时间表进行推送。

无论采用哪种方式，每个连接器都会指定一个 站点的特征 ID（即读数所属的地图特征——参见 监控与告警）和一个 单位，且其摄入的每个批次都会触发 sensor.reading 触发器。 数据摄取 选项卡还会实时显示计划轮询的状态（包括活跃、延迟或失败的轮询数量）。

凭据、密钥和连接配额

外发凭据

访问外部系统的外发操作（Webhook、Postgres、S3/SFTP 构建产物交付）通过 存储的凭据 进行身份验证，而非内联密钥。请在 凭据 页面上创建一次，并按名称引用它。 密钥在静止状态下经过加密，保存后将不再显示；而非密钥类配置（基础 URL、主机名、区域）仍可读取。类型包括：bearer / basic / API-key HTTP、S3、SFTP 和 Postgres。

入站数据导入密钥

机器 bearer 密钥允许发送方将数据推送至 Aptli。仅限摄入，其权限范围受限于允许的操作（推送读数或拉取门户提交），原始密钥仅在创建时显示一次——请届时复制。

连接配额

商业计费指标是 外部连接 的数量，而非功能本身。每个 数据导入连接器、API 密钥 和可重用的 出站钩子 都会从共享池中消耗一个 单位（内部事件触发规则不计入配额）。 “自动化”和“凭据”页面上的一个计数器会显示 “已使用 {used} 个，总计 {total} 个连接器/密钥”，并详细列出连接器、API 密钥和钩子的使用情况。默认配额为 3；当达到配额时，创建新连接器会提示您撤销一个未使用的连接器，或联系支持团队以增加配额。 即使后续配额减少，您已有的连接仍会继续运行。

监控与警报

数据采集负责将传感器数据导入系统；监控则是您所见的内容以及会收到警告的事项。

监测点与读数

监测点 只是传感器用于上报数据的地图特征。 默认情况下，连接器的站点要素 ID即为该要素自身的 ID，因此读数会直接关联到该要素；使用自有站点代码的发送方可以显式关联。

一旦读数开始流转，该要素的记录中就会增加一个传感器读数部分：对于每个指标， 都会显示最新数值和单位，以及一条7天趋势线。如果某个站点停止发送数据，但其数据源仍在其他ID下继续发送（即传感器在源端被重命名），Aptli会标记该情况，并提供一键重新链接功能，以确保您不会丢失历史数据。

警报

警报规则位于 数据采集连接器 上。开启 触发警报 并设置：

• 当值达到 — 高于或低于阈值时触发警报
• 清除阈值范围 —— 读数必须低于阈值多远，警报才会自动清除（即滞后效应，以防止值在阈值线上徘徊时警报频繁触发）
• （分钟）后静音告警 —— 若在此时间段内未收到数据，则触发静音告警（传感器失效检测）
• 告警接收者 — 谁将收到通知
• 若（分钟）后仍未确认则升级 + 升级接收者 — 若无人及时确认，则触发第二级告警

告警页面是实时记录。 每个警报状态为 活动、已确认 或 已解决；您需 确认 警报以表明有人正在处理，并在问题处理完毕后 解决 警报（当读数恢复至安全阈值以上时，警报也会自动清除）。 阈值告警和静默（“未收到数据”）告警会清晰区分显示，每个告警包含其数值/阈值/峰值、确认人员，以及——若已升级——一条带有投递状态图标的**“已升级 {日期}”**行。 主仪表盘卡片会显示活跃警报，确保它们不会被忽略。警报页面对任何已登录的监督人员可见，而不仅限于自动化管理员，这样负责监督工作的人员就能实时查看警报。

双向工单闭环

每个警报都可携带一个 回写 URL：您的外部工单系统会通过 POST 请求将状态变更发回，以确认或解决该警报，而工单的引用链接会显示在警报上。当警报在其他工具中得到处理时，这便形成了闭环。

成果与共享链接

在项目中，“成果”标签页会将监控的指标序列与已完成的工作里程碑进行对比图表展示——参见 项目。 您可以为外部人员发布这些图表的只读、经过令牌加密的共享链接，并可随时撤销该链接。数据读数会与工作日期一同显示以提供背景信息；Aptli 不对因果关系作出任何声明，且该页面明确声明不属于经认证的测量数据。

交付 — 活动日志

交付页面是只读历史记录，分为两个标签页：

• 外发交付 —— 每次外发尝试占一行：日期、工作流、操作、目的地、结果（成功 / 失败 / 重试 / 死信）、尝试次数、持续时间以及任何错误。 测试运行会标有特殊标记。
• 入站运行 — 数据摄取历史记录：来源、结果、日期、持续时间、行数和错误。

快速连接

对于常见的集成，快速连接向导会引导您完成配方配置，而无需使用原始编辑器——例如“将新的门户提交发送到我的系统”、“库存不足时向我的系统发送警报”， “触发警报时创建工单”，或“接收来自我的传感器或网关的读数”。它会为您自动配置连接器、钩子或规则。

权限

自动化功能不使用全局管理员权限矩阵。三个配置页面（自动化、凭据、交付）受自动化设置中查看者/修改者白名单的限制，因此您需要明确授予访问权限。 **“警报”**页面特意对所有已登录用户开放——监控警报属于运维任务，而非配置任务。如果列表为空，拥有“应用程序设置”权限的用户始终可通过恢复路径进行操作。