这个品类的数据长什么样
用量统计的数据来源于平台内置的调用链路日志、资源监控探针，覆盖API调用次数、算力消耗、存储占用等维度。更新节奏按分钟级聚合生成统计快照，平衡数据时效性与存储成本。单份统计文档包含固定结构字段：stat_time（统计时间戳）、tenant_id（租户标识）、resource_type（资源类型）、usage_value（消耗数值）、unit（统计单位）。不同资源类型对应专属统计单位，例如API调用次数的单位为次，GPU算力消耗的单位为核时，存储占用的单位为GB，无额外聚合类百分比字段。
这些特征在「工作流编排」这一环带来什么约束
这些特征在工作流编排环节带来明确约束。由于数据按分钟级聚合更新，工作流需匹配该节奏，无法配置亚分钟级触发间隔，否则会拉取未完成聚合的无效数据。由于数据包含租户标识字段，编排时需添加租户维度过滤规则，避免跨租户数据泄露与访问错误。由于资源类型与统计单位存在差异，编排中需配置字段提取与格式转换节点，确保下游节点接收统一格式的统计数据。同时，统计数据字段结构固定，编排时需严格绑定对应字段的提取规则，遗漏关键字段会导致工作流执行失败。此外，用量统计数据的拉取需依赖平台原生接口，编排时需直接对接内置数据源，不可使用自定义外部接口，否则会导致数据不一致。
配置怎么定
| 配置项 | 建议取法 | 这样取的依据 |
|---|---|---|
trigger_interval | 60 秒 | 匹配用量统计数据的分钟级聚合更新节奏，避免拉取未完成的临时数据 |
filter_field | tenant_id、resource_type | 按租户与资源类型拆分统计数据，实现权限隔离与精准统计 |
data_mapping | usage_value→workflow_input_var | 将统计数值映射为工作流的标准输入变量，适配下游节点的参数要求 |
unit_convert_node | 统一转换为核时/次/GB | 标准化不同资源类型的统计单位，消除下游节点的格式兼容问题 |
alert_threshold | 按业务需求标定 | 不同租户的用量阈值差异较大，需结合实际业务场景调整触发条件 |
data_source_node | 内置用量统计接口 | 直接对接平台原生监控数据，确保数据来源的准确性与一致性 |
本页给出的参数取值均为常规建议，用于确定配置的起点。实际取值受材料形态、数据量与业务规则影响，具体问题需具体分析，建议在自有样本上实测后再定。
容易做错的三处
- 现象：工作流中引用的用量统计变量仅在首次执行时加载固定值，后续周期无更新。原因：未将
trigger_interval设置为匹配统计数据的更新节奏，且未将触发节点的输出变量绑定到下游节点。 - 现象：工作流执行时返回
400 Bad Request错误，提示缺少tenant_id字段。原因：在filter_field配置中未添加租户标识字段，导致拉取的统计数据不包含权限校验所需的参数。 - 现象：工作流拼接的统计报告出现单位混乱，例如同时显示
次和GB。原因：未配置unit_convert_node对不同资源类型的统计值进行单位标准化，导致下游展示节点无法统一格式。
怎么确认配好了
- 手动触发工作流一次，检查输出节点是否包含完整的用量统计字段，核对字段名与
data_mapping规则的配置一致。 - 查看工作流的运行日志，确认触发间隔符合
trigger_interval的设置，且每次触发均拉取到新的统计数据。 - 模拟不同租户的触发请求，检查工作流是否仅返回对应租户的统计数据，验证
filter_field的过滤效果。 - 修改
unit_convert_node的配置，观察下游节点的输入格式是否符合预期，确认单位转换生效。
问题素材取自公开社区提问（2026-09-11 去重 4,834 条）。文中的配置项名称与取值区间需以所用版本的实际界面与文档为准；本页核验日 2026-09-14，当时的最新发布版本为 FastGPT v4.17.0。