Configure Logging for Services

Contents:

Expand all Collapse all

Contents:

As needed, you can modify via parameter the logging levels for the following services of the platform. These settings should only be modified when you are debugging an issue. After the issue is resolved, you should set the logging level back to its original value.

You can apply this change through the Admin Settings Page (recommended) or trifacta-conf.json. For more information, see Platform Configuration Methods.

Tip: You can download service logs through the application. See System Services and Logs.

For more information on these services, see System Services and Logs.

For more information on logging levels, see https://logging.apache.org/log4j/log4j-2.6.1/manual/customloglevels.html.

Configure

Mask PII

You can use the following settings to mask personal information in the log files. However, doing so may complicate debugging:

Logging Parameter and Default Value	Description
"logging.piiMask.enabled": false,	Set this value to `true` to enable masking of personally identifiable information (PII) in log files. In the Designer Cloud Powered by Trifacta platform, this feature masks email addresses (userIds) with hashed values.
"logging.piiMask.salt": "this is a grain of salt",	When PII masking is enabled, this value can be used as a randomizing element for generating hashed values.

Configure log rotation

By default, log files for each service is automatically rotated for you.

As needed, you can enable and configure log rotation for additional log files. When enabled, the following logs are subject to rotation:

proxy_access.log
proxy_error.log
batch-job-runner.access.log
data-service.access.log
ml_service.access.log
scheduling-service.access.log
time-based-trigger-service.access.log

NOTE: By default, these log files are rotated by supervisord. For more information on default values for stdout_logfile_maxbytes, stdout_logfile_backups, and stderr equivalents, see http://supervisord.org/configuration.html#program-x-section-values.

The following logs are excluded from log rotation and are not rotated when this feature is enabled:

join-inf.log
join-sel.log
protobuf-events.log
webapp.analytics.log
segment-proto.log

To enable log rotation, you must copy the default configuration file into the appropriate working directory and set permissions:

sudo cp /opt/trifacta/conf/trifacta-logrotate.conf /etc/logrotate.d/trifacta-logrotate.conf
sudo chown root: /etc/logrotate.d/trifacta-logrotate.conf
sudo chmod 644 /etc/logrotate.d/trifacta-logrotate.conf

You can test the configuration using the following command:

sudo logrotate --debug /etc/logrotate.d/trifacta-logrotate.conf

Configure log format

You can configure the fields and format of them for the following log files:

Service	Applicable Log Files	Parameter
VFS Service	`vfs-service.access.log`	`vfs-service.loggerOptions.format`
WebApp	`webapp.access.log`	`webapp.loggerOptions.format`

NOTE: This field configuration applies only the log files listed above.

For each of the above parameters, you can use a token-based method of configuring the fields to include in a log entry. You can modify:

The sequence of fields
The fields to include
For some fields, you can specify specific subsets of the available information.

Entries are specified as space-delimited fields, each of which begins with a colon:

:field1 :field2 :field3

For more information on these log format options, see https://github.com/expressjs/morgan#tokens.

Configure output format

By default, logs are in flat text format and exported as .log files.

Some loggers enable output in JSON format.

NOTE: JSON format is not recommended for Designer Cloud Enterprise Edition. You may not be able to download logs in JSON format.

To enable JSON format, locate the appropriate parameter, where the wildcard below represents the service. Set the value to true:

"*.loggerOptions.json": true,

Save your changes and restart the platform or service.

More examples are listed below.

WebApp

The WebApp manages loading of data from the supported connections into the front-end web interface.

NOTE: After changing these settings, the platform must be restarted.

Logging Parameter and Default Value	Description
"webapp.loggerOptions.silent": false,	When set to `true`, log messages are silent.
"webapp.loggerOptions.level": "info",	Supported levels (in decreasing order of verbosity): `silly`, `debug`, `info`, `warning`, `error`
"webapp.loggerOptions.json": false,	If set to `true`, logging output is in JSON format.
"webapp.loggerOptions.format": ":method :url :status :res[content-length] :response-time :referrer :remote-addr :trifacta-user :user-agent",	String containing list of fields to include in each log message.

Batch Job Runner

The Batch Job Runner service manages the execution of batch jobs on the backend running environment.

Logging Parameter and Default Value	Description
"batch-job-runner.systemProperties.batch.rootLogLevel": "info",	Supported levels (in decreasing order of verbosity): `trace`, `debug`, `info`, `warn`, `error`, `fatal`, `off`

VFS Service

Loads data from the various filesystems supported by the platform, both in the front-end user interface and in batch mode when Photon running environment is enabled. For more information, see Configure Photon Running Environment.

Logging Parameter and Default Value	Description
"vfs-service.loggerOptions.silent": false,	When set to `true`, log messages are silent.
"vfs-service.loggerOptions.level": "info",	Supported levels (in decreasing order of verbosity): `silly`, `debug`, `info`, `warning`, `error`
"vfs-service.loggerOptions.json" : false,	If set to `true`, logging output is in JSON format.
"vfs-service.loggerOptions.format": ":method :url :status :res[content-length] :response-time :referrer :remote-addr :trifacta-user :user-agent",	String containing list of fields to include in each log message.

Data Service

Service prepares queries against JDBC interfaces, using internal REST API calls.

Logging Parameter and Default Value	Description
"data-service.systemProperties.logging.level": "info",	Supported levels (in decreasing order of verbosity): `trace`, `debug`, `info`, `warn`, `error`, `fatal`, `off`
"data-service.systemProperties.logging.config": "classpath:logback.xml",	Do not modify this parameter.

ML Service

For the ML service, logging level can be modified at the command line:

python cyclone.py —log-level <level>

Supported levels: DEBUG, INFO, WARNING, ERROR, CRITICAL

Logging Parameter and Default Value	Description
"ml-service.loggerOptions.json": false,	If set to `true`, logging output is in JSON format.

JSData

The JSData logging options do not apply to a specific service. Instead, they are used by various services to log activities related to Wrangle and its interactions with various connections and running environments.

Logging Parameter and Default Value	Description
"jsdata.loggerOptions.silent": false,	When set to `true`, log messages are silent.
"jsdata.loggerOptions.level": "info",	Supported levels (in decreasing order of verbosity): `silly`, `debug`, `info`, `error`, `warn`
"jsdata.loggerOptions.json": false,	If set to `true`, logging output is in JSON format.

Send Feedback

Page tree