Data Loader Guide

Data Loader
When to Use Data Loader
Installing Data Loader
Configure Data Loader
Using Data Loader
Data Types Supported by Data Loader
Export Data
Define Data Loader Field Mappings
Insert, Update, or Delete Data Using Data Loader
Upload Attachments
Upload Content with the Data Loader
Review Data Loader Output Files
Data Import Dates
View the Data Loader Log File
Configure the Data Loader Log File
Running in Batch Mode (Windows Only)
Command-Line Quick Start (Windows Only)
Data Loader Third-Party Licenses
PDF

Newer Version Available

This content describes an older version of this product. View Latest

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.
  • 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
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.

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.