动作类型详解
动作指标（Action metrics）
动作上线后到底成不成功、慢不慢？动作指标给你近 30 天的实时概览，并细分失败原因。这一篇带你读懂这些数字。
本文来源 · Source
内容整理自 Palantir Foundry 官方文档：
https://www.palantir.com/docs/foundry/action-types/action-metrics/
原始标题：Action metrics
https://www.palantir.com/docs/foundry/action-types/action-metrics/
原始标题：Action metrics
★
一句话速览
动作指标（Action metrics）：动作上线后到底成不成功、慢不慢？动作指标给你近 30 天的实时概览，并细分失败原因。这一篇带你读懂这些数字。
1 指标（metrics）
动作指标（action metrics）展示一个动作类型在最近 30 天的近乎实时的使用情况
2 数据来源与如何嵌入应用
所有指标都通过 Foundry Telemetry Service（FTS）的最新数据，以近乎实时的方式更新——让你随时掌握动作的健…
3 权限与要点
要查看动作指标，你必须是该动作的 viewer（查看者）
1
什么是指标（metrics）
指标是"量"，告诉你动作用得怎么样；它和"日志""监控"互补但不同。
动作指标（action metrics）展示一个动作类型在最近 30 天的近乎实时的使用情况。你可以在两处查看：
- Ontology Manager 中该动作类型的概览页（overview page）；
- Workflow Lineage 中选中某次执行的动作节点（action node）。
"Action metrics display the near real-time usage of an action type over the last 30 days."动作指标展示一个动作类型在最近 30 天的近乎实时的使用情况。
提示：指标不需要动作日志（action log）就能展示；与日志相反，指标会跟踪失败，而日志只记录成功的提交。
2
两类核心指标
指标面板里最值得盯的就是这两个。
成功 / 失败计数
用成功数与失败数监控动作当前状态，快速发现异常、主动排查，让失败一发生就被处理。
P95 时长（duration）
跟踪每个动作类型的第 95 百分位执行时长，凸显执行时间的上沿，帮你发现性能瓶颈、优化工作流。
3
失败类型分类（Failure types）
指标把失败分成多种类别，便于你定位"为什么挂了"。
| 失败类别 | 含义 |
|---|---|
| Invalid parameter（参数无效） | 提交的参数在该动作语境下不合法。 |
| Scale limit（规模超限） | 影响的对象类型超过允许上限（默认通常约 10,000）。 |
| Authentication（鉴权失败） | 用户未通过动作的安全提交标准。 |
| Side effect（副作用失败） | 因 webhook 或配置错误的副作用而失败。 |
| Function（函数失败） | 底层函数失败；仅函数后端动作可能出现。 |
| User-facing function（面向用户的函数失败） | 函数抛出拟展示给用户的错误；仅函数后端动作。 |
| Conflict（冲突失败） | 因冲突（如并发修改）而失败。 |
| Unclassified（未分类） | 不属于以上任何类别的失败。 |
提示：其中 Function 与 User-facing function 两类，只有函数后端（function-backed）动作才可能出现。
4
数据来源与如何嵌入应用
指标为什么"近实时"？它从哪里来，又能放到哪里看。
所有指标都通过 Foundry Telemetry Service（FTS）的最新数据，以近乎实时的方式更新——让你随时掌握动作的健康状况，用于监控、调试与维护。
- 你还能查看运行历史（run history）：给出某动作过去 7 天执行的完整视图。
- 可以把指标直接嵌进运营应用：在 Workshop 里用 Observability Chart widget 展示，把资源健康度与工作流其余部分放在一起看。
5
权限与要点
想看指标，先确认你有没有权限；再动手看看指标长什么样。
要查看动作指标，你必须是该动作的 viewer（查看者）。这是查看指标的唯一权限门槛。
互动实验：近 30 天动作指标速览
点击上方按钮，查看对应指标说明（以下为示意数据，非真实数值）。
一页带走
① 指标 = 量
近 30 天近乎实时；核心看成功/失败计数与 P95 时长。
② 会跟踪失败
与日志相反，指标跟踪失败并细分 8 类失败原因。
③ 数据来自 FTS
由 Foundry Telemetry Service 近实时更新；另有 7 天运行历史。
④ 权限门槛
查看指标只需是动作的 viewer；可嵌入 Workshop 图表。
延伸阅读 · 相关页面
按主题横向跳转，不必顺着目录一篇篇读。
常见问题速答 · FAQ
关于「动作指标（Action metrics）」，读者最常问的几个问题。
什么是指标（metrics）？
动作指标（action metrics）展示一个动作类型在最近 30 天的近乎实时的使用情况。你可以在两处查看。
数据来源与如何嵌入应用？
所有指标都通过 Foundry Telemetry Service（FTS）的最新数据，以近乎实时的方式更新——让你随时掌握动作的健康状况，用于监控、调试与维护。
权限与要点是什么？
要查看动作指标，你必须是该动作的 viewer（查看者）。这是查看指标的唯一权限门槛。