Viewing Job Debug Results

During Job execution, the Director gathers logs from the Actors involved in each Action to support troubleshooting. Based on your security group, you can configure the platform so you always have the options to view these logs or you can make them available for a single Job.

Viewing Debug Results for a single Job

This method is available to all users, regardless of the group the user is assigned. If expanded Job debug logs are enabled, this method will also display those logs in the Director Job Logs (for all Actions in Job) section of the log's popup window.

1. Go to Jobs > Job Status.
2. Locate the Job you want to debug and click View  (you can also use standard shortcuts to open it in a new tab or windows).
3. Add ?debug to the end of the URL and press Enter. The page refreshes and the View Action Logs icon appears next to each Action.
4. Click View Action Logs. Logs from the source and destination Actor will be shown in a popup window.

To enable the Debug / View Action Logs

This method is only for those users assigned to the System Admin group.

1. Click User > User Preferences. The User Settings menu opens.
2. Locate the Always Show Debug Links for Jobs checkbox and select it.
3. Click Update Account Settings. When reviewing Jobs, the View Action Logs icon now appears next to each Action by default.

To enable Expanded Job Debug Logs

Enabling expanded Job debug logs makes it easier to access Job debug information without needing to download all the Support logs. When this setting is disabled, only logs for the source and destination Actor are accessible from Job Results.

This setting is disabled by default and can only be enabled by users with the Settings - Edit permission.

Job logs are stored in the Director when the Enable Expanded Job Debug Log setting is on. The Security Validation team recommends you only enable this setting while debugging issues alongside Customer Support. These Job debug logs will take significant space in the database and may fill the database storage quickly if your organization frequently runs Jobs.

1. Go to Settings > Director Settings. The Systems Settings page opens.
2. Click Advanced.
3. Select On for Enable Expanded Job Debug Log.
4. Click Update Advanced Settings.

After you enable this setting, users can view logs in the UI by using the ?debug flag or by enabling Always Show Debug Links for Jobs in User Preferences. Additional details from the expanded logs will be under the Director Job Logs (for all Actions in Job) section of the logs. For more information, see Viewing Job Debug Results.

To enable the automatic deletion of old Job Debug logs

By default, Job debug logs are stored in the database forever. Enabling the automatic deletion of logs after a specific number of days can help clear up space in the database. This method is only for users with the Settings - Edit permission enabled.

1. Go to Settings > Director Settings. The Systems Settings page opens.
2. Click Advanced.
3. For Delete Old Job Debug Logs (days), define how frequently you want old debug logs to be deleted.
4. Click Update Advanced Settings.