platform-tracing-configure

Platform Tracing — Configure

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:

1. 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.
2. 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.

---

Clarifying Questions

Before generating, confirm with the user if not already clear:

• Enable or disable? (Which state do you want for Platform Tracing / TraceSpanEvent?)

No other clarification needed — this controls a single boolean field.

---

Required Inputs

Gather or infer before proceeding:

• Desired state: true (enable) or false (disable)

Defaults unless specified:

• If user says "enable" or "turn on": set to true
• If user says "disable" or "turn off": set to false

If the user provides a clear request, generate immediately without unnecessary back-and-forth.

---

Workflow

1. Warn about prerequisites — inform the user that this feature requires the PlatformTracing org permission and API version 68.0+.

1. Read the template — load assets/EventSettings-template.xml.

1. Generate the settings file — replace {ENABLED} with true or false based on the user's desired state.

1. Place the file — output to settings/Event.settings-meta.xml in the project's source directory.

---

Rules / Constraints

| Constraint | Rationale |

|---|---|

| Only include enablePlatformTracing in generated metadata | Other fields in EventSettings are owned by other teams. Including them risks overwriting unrelated settings during deploy. |

| XML namespace must be http://soap.sforce.com/2006/04/metadata | Any other namespace causes deploy failure. |

| File must be named Event.settings-meta.xml | SFDX source format convention — the type name prefix for EventSettings is Event. |

| Requires PlatformTracing org permission | Without this permission, the setting deploys but has no effect on TraceSpanEvent publishing. |

| Requires API v68.0+ | Older orgs/tooling reject the field entirely. |

---

Gotchas

| Issue | Resolution |

|---|---|

| Deploy succeeds but TraceSpanEvent not published | Org lacks the PlatformTracing permission. This is provisioned, not settable via metadata. |

| enablePlatformTracing field not recognized by org/tooling | Tooling is on API version < 68.0. Update sfdx-project.json sourceApiVersion to 68.0 or higher. |

| User confuses this with Agentforce tracing | Clarify: this publishes TraceSpanEvent for platform operations. For Agentforce agent spans to Data Cloud, use the platform-tracing-agentforce-configure skill. |

| User wants to configure all Event Monitoring settings | Only enablePlatformTracing is in scope. Other EventSettings fields are owned by other teams and not managed by this skill. |

---

Output Expectations

Deliverables:

• settings/Event.settings-meta.xml

Before delivering, verify:

• [ ] XML namespace is exactly http://soap.sforce.com/2006/04/metadata
• [ ] File is named Event.settings-meta.xml
• [ ] Only enablePlatformTracing is present (no other EventSettings fields)
• [ ] Project sourceApiVersion in sfdx-project.json is 68.0 or higher

---

Cross-Skill Integration

| Need | Delegate to |

|---|---|

| Enable Agentforce agent tracing to Data Cloud | platform-tracing-agentforce-configure skill |

| Set up Change Data Capture | integration-eventing-cdc-configure skill |

| Configure ManagedEventSubscription | integration-eventing-subscription-configure skill |

---

Reference File Index

| File | When to read |

|---|---|

| assets/EventSettings-template.xml | Step 2 — template for generating the settings file |