Skip to main content

Configure and Use Server Logs

Server creates log files and saves them to a location set in your Server's system settings. Logs capture warnings and errors and can be used to investigate and diagnose issues.

Configure Logging for Your Server

Configure Service Logs

Configure the service log file location, logging level, file size, and file rotation on the System Settings > Controller > General screen.

Configure the service log file location, logging level, file size, and file rotation on the System Settings Controller General screen.
  1. The storage location for service log files is set to C:\ProgramData\Alteryx\Service by default. Customize the location if necessary.

  2. Choose the Level of messages to log.

    Important

    We recommend setting the log level to Low or None. This minimizes disk write operations and input/output contention. You can increase the log level when debugging aberrant Server behavior.

    • None: No logging.

    • Low: Only log emergency, alert, critical, and error messages.

    • Normal: Log low, warning, and notice messages.

    • High: Log all message types.

  3. Specify the maximum File size in MB for log files.

  4. Select Enable log file rotation to place log files that exceed the max size in an archive file. New events write to a new file. This prevents the creation of large log files that are difficult to consume in standard log readers.

Configure Gallery Logging

The storage location for Gallery log files is set to C:\ProgramData\Alteryx\Gallery\Logs by default. Customize the location, if necessary, on the System Settings > Gallery > General page.

Configure Engine Logging

Engine logs are not stored by default. You can specify a location to store engine log files on the System Settings > Engine > General page in the Logging Directory.

Use Log Files for Troubleshooting

Service and Gallery logs are most-commonly used for investigating issues. There are several steps you can take to investigate logs and diagnose issues in Server.

  1. Locate and open the log in a text editor or Microsoft Excel.

  2. Search log entries for words such as Error, Alert, and Critical.

  3. Read the error description.

  4. Starting from the error, locate the point in the log where Server started ("AlteryxService starting").

  5. Scan for events before the error occurred to identify potential causes.

  6. Scan for events after the error occurred to identify potential consequences.

Types of Log Files

File Name: AlteryxServiceLog.log

Default Location: C:\ProgramData\Alteryx\Service

Service logs contain communication between components and startup and shutdown of processes on the controller and worker machines. Go to the Controller help page for more info.

File Name: alteryx-[year]-[month]-[date].csv

Default Location: C:\ProgramData\Alteryx\Gallery\Logs

Gallery logs contain Gallery processes and functions, including errors found when running an Analytic App that uses interface tools, and schedule migration records. Go to the Server UI help page for more info.

File Name: Alteryx_Log_[number].log

Default Location: Manually set.

Engine logs contain the output of messages created when a workflow runs, as well as the timestamps when tools run in a workflow. Go to the Engine help page for more info.

File Name: [name].log

Default Location: C:\ProgramData\Alteryx\ErrorLogs (might be saved in a sub-folder)

The UI error logs contain stack traces for errors.

File Name: aas-log-yyyymmdd.txt

Default Location: C:\ProgramData\Alteryx\Logs

(You can't change the default location.)

Alteryx Authentication Service logs contain messages related to your SAML configuration, including error messages, authentication attempt information, and helpful information for troubleshooting SAML authentication.