Generate EventSettings metadata to enable or disable the Platform Tracing toggle, which controls whether TraceSpanEvent is published at a sample rate. This modifies a single field (
enablePlatformTracing
) within the existing EventSettings metadata type.
Scope
In scope
Generating
Event.settings-meta.xml
with the
enablePlatformTracing
field to enable or disable TraceSpanEvent publishing.
Out of scope
Agentforce agent tracing to Data Cloud (use
platform-tracing-agentforce-configure
). Other EventSettings fields (
enableDeleteMonitoringData
,
enableLoginForensics
, etc.) owned by other teams. Event Log Files. Change Data Capture.
Prerequisites
Before generating, inform the user of these requirements:
PlatformTracing
org permission
must be active — this permission gates the feature. It is provisioned (not settable via metadata). Without it, the setting deploys but TraceSpanEvent is not published.
API version 68.0+
—
enablePlatformTracing
on EventSettings was introduced in Spring '25. Orgs or tooling on older API versions will not recognize the field. Update
sfdx-project.json
sourceApiVersion
to
68.0
or higher if on an older tooling version.
If the user reports the setting isn't working after deploy, the most likely cause is a missing prerequisite above.
Show more
Installs
574
Repository
forcedotcom/sf-skills
GitHub Stars
658
First Seen
8 days ago
Security Audits
Gen Agent Trust Hub
Pass
Socket
Pass
Snyk
Pass