SuperAPI AI 工具集

platform-tracing-configure

部署与运维

查看项目

更新于 10-15 21:43

技能介绍

用途:生成 EventSettings 元数据,通过修改 enablePlatformTracing 字段来开启或关闭 Platform Tracing,也就是控制是否以采样率发布 TraceSpanEvent。这是 Salesforce 技能,产出一个单字段的 Event.settings-meta.xml,不涉及其他 EventSettings 字段或事件日志文件、变更数据捕获。

主要能力:该技能只影响 enablePlatformTracing 一个布尔值。用户表达“enable”“turn on”时设为 true,“disable”“turn off”时设为 false。生成流程为:先告知用户前置条件,读取 assets/EventSettings-template.xml 模板,将占位符 {ENABLED} 替换为 true 或 false,再输出到项目源码目录下的 settings/Event.settings-meta.xml。

前置条件与限制:需要 PlatformTracing 组织权限处于激活状态,该权限用于门控此功能,只能通过配置而非元数据设置;缺少时设置仍可部署但 TraceSpanEvent 不会发布。需要 API 版本 68.0 及以上,enablePlatformTracing 字段自 Spring '25 引入,旧工具或组织无法识别,需将 sfdx-project.json 的 sourceApiVersion 更新为 68.0 或更高。XML 命名空间必须为 http://soap.sforce.com/2006/04/metadata,文件名必须为 Event.settings-meta.xml,且生成的元数据中只应包含 enablePlatformTracing,以免部署时覆盖其他团队管理的设置。

适用场景:需要为平台操作发布 TraceSpanEvent 时使用;如需将 Agentforce 智能体追踪发送到 Data Cloud,应改用 platform-tracing-agentforce-configure;变更数据捕获、ManagedEventSubscription、其他 EventSettings 字段均不在本技能范围内。常见问题包括部署成功但事件未发布(多为权限缺失)、字段不被识别(工具 API 版本过低),以及与其 Agentforce 追踪功能混淆。