Skip to main content

System Services and Logs

The Designer Cloud Powered by Trifacta platform provides the following major services. For each of the listed service, any relevant logs are listed.

The logging levels for many of these services can be modified through the Admin Settings page. See Configure Logging for Services.

Download Logs

Support logs

For support use, the most meaningful logs and configuration files can be downloaded from the application. Select Resources menu > Download logs.

Note

If you are submitting an issue to Alteryx Support, please download these files through the application.

For more information, see Download Logs Dialog.The admin version of this dialog enables downloading logs by timeframe, job ID, or session ID. For more information, see Admin Download Logs Dialog.

Log directory

System logs are maintained in the following directory: /opt/trifacta/logs

Alteryx administrators can access the logs through the Trifacta Application. Use the following URL:

<hostname>:<port_number>/logs

Available logs

Filename

Description

jobgroups/

Directory of logs for transformation jobs by Id.

Tip

If you are troubleshooting a failed job, please acquire the job logs from the Job Details page when you contact Alteryx Support. See Job Details Page.

jobs/

Directory of logs for other kinds of jobs, such as sampling or ingest, by Id.

nginx/

Temporary storage for nginx server. No log files are stored here.

artifact-storage-service.access.log

Access logs for the artifact storage service.

artifact-storage-service.log

Application logs for the artifact storage service.

authorization-service.access.log

Access logs for the authorization service.

authorization-service.log

Application logs for the authorization service.

batch-job-runner.access.log

Access logs for the batch job runner service.

Batch job runner service manages transformation jobs and scheduling. More information is below.

batch-job-runner.job-status.log

Status information on batch job runner jobs.

batch-job-runner.log

Application logs for the batch job runner service.

configuration-service.access.log

Access logs for the configuration service service.

Configuration service is used for managing configuration that can be changed at runtime for different workspaces and users. Some of these settings are available through the Trifacta Application. See Workspace Settings Page.

configuration-service.log

Application logs for the configuration service.

connector-configuration-service.log

Application logs for the connector configuration service.

connector-configuration-service.access.log

Access logs for the connector configuration service.

conversion-service.access.log

Access logs for the conversion service.

Conversion service is used for converting from various inputs formats and to various output formats.

conversion-service.log

Application logs for the conversion service.

data-service.access.log

Access logs for the data service.

Data service is used for interacting with relational sources. More information is below.

data-service.log

Application logs for the data service.

java-vfs-service.access.log

Access logs for the Java VFS service.

java-vfs-service.log

Application logs for the Java VFS service.

job-metadata-service.access.log

Access logs for the job metadata service.

job-metadata-service.log

Application logs for the job metadata service.

migration.log

Application logs for database migrations performed for the webapp service.

ml_service.access.log

Access logs for the ml (machine-learning) service.

Machine learning service is used for predictive interaction, suggestion ranking, pattern profiling, pattern suggestions, and collecting user action logs. More information is below.

ml_service.log

Application logs for the ml (machine-learning) service.

nginx_service.log

Application logs for the nginx service. More information is below.

optimizer-service.access.log

Access logs for the optimizer service.

optimizer-service.log

Application logs for the optimizer service.

protobuf-events.log

Client events around column values, user selections, and recipe editing.

proxy_access.log

Access logs for the nginx server.

proxy_error.log

Error logs for the nginx server.

scheduling-service.access.log

Access logs for the scheduling service.

Scheduling service is used for scheduling jobs at a specific time. More information is below.

scheduling-service.log

Application logs for the scheduling service.

secure-token-service.access.log

Access logs for the secure token service.

secure-token-service is used for securely storing tokens for some external services, such as Azure AD and Databricks and OAuth2-connected datastores.

secure-token-service.log

Application logs for the secure token service

spark-job-service.log

Application logs for the Spark job service.

Spark job service is used for interfacing with cluster-based Spark service to plan and execute Spark jobs. More information is below.

supervisord.log

Logs for the supervisord system service.

supervisord manages the starting, stopping, and restarting of services for the Designer Cloud Powered by Trifacta platform. More information is below.

time-based-trigger-service.access.log

Access logs for the time-based trigger service.

Time-based trigger service is used for managing the triggers for scheduled jobs. More information is below.

time-based-trigger-service.log

Application logs for the time-based trigger service.

vfs-service.access.log

Access logs for the VFS service.

VFS service is used for managing loading of files from various supported datastores. More information is below.

vfs-service.log

Application logs for the VFS service.

webapp.access.log

Access logs for the Webapp service.

Webapp service serves the Trifacta Application to users. More information is below.

webapp.log

Application logs for the Webapp service. More information is below.

webapp.sql-error.log

Error log for SQL issued from the Webapp service.

webworker.log

Event logs for webworkers running in browser clients.

Webworkers run in the background of a browser client's Alteryx session and are used for predictive interaction, suggestion ranking, pattern profiling, pattern suggestions, and collecting user action logs.

Artifact Storage Service

Description: Manages storage of feature-specific usage data, such as value mappings.

Log File

Can Help With

artifact-storage-service-access.log

Access issues to the service.

artifact-storage-service.log

Transactions with the database for the features that use it.

Authorization Service

Description: Manages access permissions for workspace objects.

Log File

Can Help With

authorization-service-access.log

Access issues to the service.

authorization-storage-service.log

Transactions with the database for the features that use it.

Batch Job Runner

Description: This service manages the tracking of jobs submitted to the backend running environment.

Log File

Can Help With

batch-job-runner.log
  • Service errors and crashes

  • Determine execution environment of the job. Search for:

    • LocalJobRunner = local execution in Photon

    • YARNRunner = execution in Spark

  • Communication errors back from environment

  • Status information on jobs

  • Status information on counts of job retries

For more information on this service, seeConfigure Batch Job Runner.

Configuration Service

Description: Service for managing configurations at the user, workspace, and system levels, which can be changed at runtime.

Log File

Can Help With

configuration-service-access.log

Issues accessing the service.

configuration-service.log

Configuration problems.

Some configuration service options are surfaced in the Trifacta Application. See Workspace Settings Page.

Connector Configuration Service

Description: Service for managing metadata for connector types.

Log File

Can Help With

connector-configuration-service-access.log

Issues accessing the service.

connector-configuration-service.log

Configuration problems.

Conversion Service

Description: Service converts some formats for input or output. For example, Microsoft Excel workbooks must be ingested through the conversion service and stored as separate CSVs for each worksheet.

Log File

Can Help With

conversion-service-access.log

Issues accessing the service.

conversion-service.log

Problems with ingest jobs for datasets whose sources must be converted.

Data Service

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

Log File

Can Help With

data-service.log
  • Initialization of communications through JDBC interface

  • Query failures

For more information on this service, see Configure Data Service.

Java UDF Service

Description: Service enables the execution of Java-based user-defined functions within a transform recipe.

Log File

Can Help With

java-udf-service.log
  • Status of the service

Tip

You can pass through messages on errors through Logger to this log, which can assist in diagnosing issues.

For more information, see User-Defined Functions.

Java VFS Service

Description: Service manages metadata associated with jobs during execution.

Log File

Can Help With

java-vfs-service.log
  • Help with issues accessing data on ADLS Gen2

  • Status of the service

For more information, see Configure Java VFS Service.

Job Metadata Service

Description: Service manages metadata associated with jobs during execution.

Log File

Can Help With

job-metadata-service.log
  • Help with job phases and status

  • Status of the service

Machine Learning Service

Description: ML service provides machine learning capabilities for the platform.

Log File

Can Help With

ml_service.log
  • This log is likely to contain information that is only useful if the ML service has crashed.

Migration

Description: Migration applies to database migrations executed as part of upgrading the platform.

Log File

Can Help With

migration.log
  • Connectivity errors and other issues that may have occurred during migration.

Nginx Service

Description: Ngnix is a proxy server embedded in the platform that serves the web application and other resources.

Log File

Can Help With

nginx_service.log
  • This log may be useful in identifying any warnings that occurred when the nginx services starts.

  • The nginx server may contain log information for the server that provides HTTP access.

Optimizer Service

Description: Handles optimizations of the queries for data from relational sources.

Log File

Can Help With

optimizer-service.log
  • Service-related issues

optimizer-service.access.log
  • Gives information about accessed routes

Proxy

Description: The proxy (nginx) service manages requests from the user interface to the other components of the platform.

Log File

Can Help With

proxy_access.log
  • Shows any requests made through the nginx to the port used by the Designer Cloud Powered by Trifacta platform.

proxy_error.log
  • Contains any errors thrown by the nginx service when a request is made to the port used by the Designer Cloud Powered by Trifacta platform.

Scheduling Service

Description: Handles all metadata related to scheduling.

Log File

Can Help With

scheduling-service.log
  • Schedule-related issues

scheduling-service.access.log
  • Gives information about accessed routes

Spark Job Service

Description: Service that manages jobs processed on Spark.

Log File

Can Help With

spark-job-service.log

Supervisord Server

Description: Process that starts, stops, and restarts services in the platform.

Log File

Can Help With

supervisord.log
  • Status information from platform services

Time-Based Trigger Service

Description: Handles all metadata related to the trigger service

Log File

Can Help With

time-based-trigger-service.log
  • schedules not triggering correctly

time-based-trigger-service.access.log
  • Gives information about accessed routes

VFS Service

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

Log File

Can Help With

vfs-service.log
  • Client connection issues

  • Status issues with backend components

  • Information on batch jobs that cannot be started

Webapp Service

Description: Loads data from the various filesystems supported by the platform in the front-end user interface.

Log File

Can Help With

webapp.log
  • Client connection issues

  • Status issues with backend components

  • Information on batch jobs that cannot be started

webapp.access.log
  • Provides access information to the Webapp service and routes.

Additional logs

Job logs

The following sources of information may provide information related to job status and performance:

  • job log

  • spark log

  • cdf script

  • yarn application logs

    (if log aggregation is enabled)

  • platform configuration file

    (trifacta-conf.json)

  • batch job runner log

  • spark service log

  • hadoop conf directory