Logging

The Logging Configuration Editor is used to configure CopyStorm logs that are written to the database, STDOUT / STDERR, or using the Apache Commons Logging framework.

Parameter Name Default Setting Required Description
Database Logs in UTC Unchecked No If checked, timestamps recorded in CopyStorm’s job tracking log tables will be in UTC rather than local time.
Log Tables with No Activity Unchecked No If checked, CopyStorm will log tables with no activity (no records copied, skipped, deleted, or archived) during a job.
Log Format Full No This option controls the amount of detail sent to the CopyStorm log file. Options include:

  • Compact: Display a single line of text for each table that has copy activity.
  • Summary: Display a single line for each table processed (even if no records were copied).
  • Full: Display a verbose amount of logging information.
  • Debug: Display everything Full displays, plus additional debugging information.
Log Table Sizes Checked No If checked, log the starting and ending table sizes in bytes.
Use Apache Logging Unchecked No If checked, logging will be performed with the Apache Commons Logging framework. By default, Log4j will be used.
Debug Mode Unchecked No If checked, CopyStorm will output logging messages to the debug console (normally hidden).
Silent Mode Unchecked No If checked, when running in batch mode, CopyStorm will only display errors to stderr and will not display debug or informational messages.
SFDC Logging Off No This option enables CopyStorm-to-Salesforce job logging. Options include:

  • On: Write job logging information to Salesforce (If Salesforce logging is not supported, logging information will not be pushed and the job will proceed normally).
  • Off: Do not write job logging information to Salesforce.
  • Required: Write job logging information to Salesforce (if Salesforce logging is not supported, the job will abort).

CopyStorm contains backend support only for Salesforce Logging. To enable Salesforce support for this feature, contact your Capstorm account representative.
SFDC Logging Interval 2 No This option sets the time interval (in minutes) between pushes of job logging information to Salesforce.

CopyStorm contains backend support only for Salesforce Logging. To enable Salesforce support for this feature, contact your Capstorm account representative.
SFDC Log Count 4 No This option configures how many job logs for the CopyStorm configuration file are kept in Salesforce. When CopyStorm creates a new job log, older job log records are deleted, retaining records according to this option. For example:

  • With a value of 0, only the most recent job will be retained.
  • With a value of 5, only the most recent job log and the 5 previous job logs will be retained.
  • If this field is left blank/empty, all job logs will be retained.

CopyStorm contains backend support only for Salesforce Logging. To enable Salesforce support for this feature, contact your Capstorm account representative.
SFDC Log Retention 4 No This option determines how long job logs for all configuration file are kept in Salesforce before older log records are deleted. Job logs that are older than this many days are deleted. This option overrides the SFDC Log Count option if the SFDC Log Count option would cause job logs to be retained for more than this many days. For example:

  • With a value of 0, only the most recent job will be retained.
  • With a value of 5, only the most recent job log and logs from the previous 5 days will be retained.
  • If this field is left blank/empty, all job logs will be retained.

CopyStorm contains backend support only for Salesforce Logging. To enable Salesforce support for this feature, contact your Capstorm account representative.