platform-tracing-configure

Generate EventSettings metadata to enable or disable Platform Tracing in Salesforce Event Monitoring.

Updated Jul 2, 2026
One-click install
npx skills add https://github.com/padjei/SF_Build --skill platform-tracing-configure-padjei
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: platform-tracing-configure
Source: https://github.com/padjei/SF_Build/tree/main/.claude/skills/platform-tracing-configure
Command: npx skills add https://github.com/padjei/SF_Build --skill platform-tracing-configure-padjei

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve? Configuring Salesforce Platform Tracing requires hand-writing EventSettings metadata with the correct field, namespace, and file naming conventions, and mistakes cause silent deploy failures or overwritten settings. This Skill generates a correct, minimal Event.settings-meta.xml file that toggles TraceSpanEvent publishing without touching unrelated Event Monitoring fields. ## Core Features & Use Cases - Metadata Generation: Produces a valid Event.settings-meta.xml containing only the enablePlatformTracing field set to true or false. - Prerequisite Guardrails: Warns about the required PlatformTracing org permission and API version 68.0+ before generating. - Scoped Safety: Excludes other EventSettings fields owned by other teams to avoid overwriting unrelated settings on deploy. - Use Case: An admin asks to turn on trace span events for Event Monitoring; the Skill outputs settings/Event.settings-meta.xml ready to deploy via SFDX. ## Quick Start Ask the assistant to enable Platform Tracing in Event Monitoring and generate the EventSettings metadata file for your Salesforce project.

Frequently Asked Questions about platform-tracing-configure

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I enable Platform Tracing in Salesforce Event Monitoring?▼

Deploy an Event.settings-meta.xml file containing the enablePlatformTracing field set to true, using the namespace http://soap.sforce.com/2006/04/metadata. The org must also have the PlatformTracing permission and API version 68.0 or higher.

What metadata controls TraceSpanEvent publishing in Salesforce?▼

The enablePlatformTracing field on the EventSettings metadata type controls whether TraceSpanEvent is published at a sample rate. It is deployed as settings/Event.settings-meta.xml in SFDX source format.

Why is TraceSpanEvent not published after deploying EventSettings?▼

The most common cause is a missing PlatformTracing org permission, which is provisioned rather than settable via metadata. Without it, the setting deploys successfully but has no effect on trace span publishing.

Does enablePlatformTracing work on older Salesforce API versions?▼

No, the field was introduced in Spring '25 and requires API version 68.0 or higher. Update sourceApiVersion in sfdx-project.json to 68.0 or higher if your tooling rejects the field.

What is the difference between Platform Tracing and Agentforce agent tracing?▼

Platform Tracing publishes TraceSpanEvent for platform operations via EventSettings. Agentforce agent tracing sends agent spans to Data Cloud and is configured separately through the platform-tracing-agentforce-configure skill.