EventSettings

Represents an org's platform event settings for Event Monitoring.

File Suffix and Directory Location

EventSettings components have the suffix .settings and are stored in the settings folder.

Version

EventSettings components are available in API version 47.0 and later.

Fields

Field Name Field Type Description
bypassMeteringBlock boolean Determines the behavior of metering service protection for Transaction Security policies. When true, metering occurs but doesn't block the user operation that triggered the policy. When false and a policy can't be handled within three seconds, metering occurs and the user's action is blocked. Default value is false.
enableApexLimitEvents boolean Enables (true) or disables (false) Apex Limit events.
enableDeleteMonitoringData boolean Allows (true) or disallows (false) Apex limits. Default value is false.
enableDynamicStreamingChannel boolean Enables (true) or disables (false) the dynamic creation of a streaming channel when you subscribe to generic streaming. Default value is false.
enableEventLogGeneration boolean Enables (true) or disables (false) the generation of event monitoring log files. Default value is false.
enableEventLogWaveIntegration boolean Enables (true) or disables (false) the integration of event monitoring log files and Analytics apps. Analytics apps help you visualize your user’s activity. Default value is false.
enableLightningLoggerEvents boolean Enables (true) or disables (false) the generation of Lightning Logger events. Lightning Logger events track information about custom Lightning web components. Default value is false. Requires Salesforce Shield or Salesforce Event Monitoring add-on subscriptions.
enableLoginForensics boolean Enables (true) or disables (false) the Login Forensics feature. Login Forensics helps you track and audit your org's user login activity. Default value is false. Available in API versions 47.0–49.0.

In versions 50.0 and later, enable LoginEvent on the Event Manager Setup page.

Tip

enablePlatformTracing boolean Enables (true) or disables (false) Platform Tracing in the org. Default value is true.
enableStreamingApi boolean Enables (true) or disables (false) Streaming API in the org. Default value is true.
enableTransactionSecurityPolicies boolean Enables (true) or disables (false) the ability to create and use transaction security policies in the Salesforce UI. Default value is false.
eventLogRetentionDuration integer Specifies the number of days (between 30 and 365) that your event log file data is retained for. If this value is not set, your event log file data is retained for 1 year by default.

Declarative Metadata Sample Definition

The following is an example of an EventSettings.settings file.

Example Package Manifest

The following is an example package manifest used to deploy or retrieve the Event settings metadata:

Wildcard Support in the Manifest File

The wildcard character * (asterisk) in the package.xml manifest file doesn’t apply to metadata types for feature settings. The wildcard applies only when retrieving all settings, not for an individual setting. For details, see Settings. For information about using the manifest file, see Deploying and Retrieving Metadata with the Zip File.