动作日志(Action log)
谁在什么时候、因为什么改了数据?动作日志把"成功的动作提交"建模成本体里的对象,让决策与审计可追溯。这一篇讲清它记什么、在哪配、有何限制。
https://www.palantir.com/docs/foundry/action-types/action-log/
原始标题:Action log
一句话速览
动作日志(Action log):谁在什么时候、因为什么改了数据?动作日志把"成功的动作提交"建模成本体里的对象,让决策与审计可追溯。这一篇讲清它记什么、在哪配、有何限制。
什么是动作日志(action log)
它把"成功的动作提交"变成本体里可以分析、展示的对象。
动作日志(action log)把成功的动作提交建模为对象类型(object type),以便在本体感知(object-aware)的 Foundry 工具中分析与展示。你可以把它作为决策流程的输入,也能用它监控本体的变更。
生成的动作日志对象类型,显示名自动取为 [Log] <动作类型名>,复数显示名取为 [Logs] <动作类型名>。它的设计目标,是简化"代表决策与数据编辑"的对象类型的生成与维护。
什么时候用它:五个能力别搞混
Foundry 提供多个回答"变更"问题的能力,它们不可互换。
| 你想回答的问题 | 该用的能力 |
|---|---|
| 什么决策、谁、何时、在何种语境下做出的? | Action log(动作日志) |
| 这个对象每一次编辑的完整历史(不论怎么改的)? | Edit history(编辑历史) |
| 动作多久成功/失败一次、花了多长时间? | Action metrics(动作指标) |
| 怎么撤销一个动作应用的编辑? | Undo / revert(回滚) |
| 动作开始失败时怎么告警? | Monitoring(监控) |
在哪配置动作日志
有两个不同的配置入口,分别针对"单个动作"和"整类对象"。
日志本体:一次提交 = 一个日志对象
动作日志对象类型与动作类型一一对应,并自动链接到被编辑的所有对象。
提交一个动作,会生成一个对应的动作日志对象,并自动链接到该动作编辑过的所有对象。例如一个 Close Alerts 动作类型,一次性把 10 个 Alert 对象的"Status"改为"Closed"——配置日志后,会产出单个日志对象,通过外键链接到全部 10 个 Alert 对象。
日志里记什么:必填值与可选值
把下列字段分到"必填(Required)"还是"可选(Optional)"(点击每行右侧)。
必填值里还包含"副作用与回滚的溯源"信息,点击揭晓有哪些:
点击这里揭晓 →
限制与函数后端动作
设计流程前,先知道这些硬约束;并用函数后端动作时还有额外要求。
- 属性类型一旦创建即固定:日志属性类型创建后不可改;若源属性类型变了,动作类型会校验失败,需新建属性并改映射。
- 摘要长度:摘要最多 20 个部分,每个纯文本部分最多 50 字符(参数部分不受此限)。
- 摘要内容:摘要不能引用对象类型参数。
- 无回填(No backfill):开启日志不会为已经提交的旧动作补建日志对象,从保存配置那一刻才开始记。
- 编辑上限:日志对象同样受对象编辑的规模与属性上限约束。
一页带走
[Log] 对象;不记失败、不记非动作编辑。延伸阅读 · 相关页面
按主题横向跳转,不必顺着目录一篇篇读。
常见问题速答 · FAQ
关于「动作日志(Action log)」,读者最常问的几个问题。