Note: This release is in preview. Features described here don’t become generally available until the latest general availability date that Salesforce announces for this release. Before then, and where features are noted as beta, pilot, or developer preview, we can’t guarantee general availability within any particular time frame or at all. Make your purchase decisions only on the basis of generally available products and features.

Configure the Data Loader Log File

You can customize the Data Loader log file for advanced troubleshooting and tracking.
Available in: both Salesforce Classic (not available in all orgs) and Lightning Experience
Available in: Enterprise, Performance, Unlimited, and Developer editions

log-conf.xml

The log-conf.xml file is included with the Data Loader installer version 35.0 and later. To change the location of the log-conf.xml file, specify the full path, incuding the full file name, in the LOG4J_CONFIGURATION_FILE environment variable.

  • In Windows, the log-conf.xml file is at C:\Users\{userName}\dataloader\version\configs
  • In macOS, the log-conf.xml file is at /Users/{userName}/dataloader/version/configs

Configure Log Levels

Change @LOG_LEVEL@ to TRACE, DEBUG, INFO, WARN, ERROR, or FATAL for the needed level of log tracking. For Log4J log levels, see https://logging.apache.org/log4j/2.0/manual/architecture.html.

To implement enhanced logging, use a copy of log-conf.xml.