View Task logs

Task logs are produced for every job of every tool executed in the task.

To see detailed information about the tools executed in a task:

  1. Navigate to the project where you executed your task.
  2. Click the Tasks tab and then click the name of the desired task.
  3. To open the task stats, click View Stats.
1356

The Task stats page will be displayed.

  1. Click View task logs in the top-right corner.
    The Task logs page will be displayed.
    The left hand side bar shows directories containing the logs for each job in the task.
1880

Each directory contains the following files:

  • job.json: A JSON file which describes the job. It contains the description of the command line tool, the inputs, and the allocated resources for the job.
  • cwl.output.json: A file which contains the outputs of the job. This file is only created if the job was finished successfully.
  • job.err.log: A file containing the Standard Error (stderr) stream of the job command. To understand the error logs, please consult the tool's manual.
  • *.log files - Log files that are produced by the Platform and by the tool:
    • cmd.log : A single-line file with the command used to run the job. If this file is absent, there was an error in constructing the command, such as an exception while evaluating an expression.
    • job.tree.log - A log file that contains the tree structure of the working directory of the tool used in the job.

To view a log click on its name. The contents of the log will be displayed on the right.

👍

Logs can be used to troubleshoot failed tasks. See the documentation on Troubleshooting a Failed Task for more information.

View a log for a single tool or job

You can also view logs for a specific tool or job. This is particularly useful if you are troubleshooting a failed task. To see the logs for a specific tool or job:

  1. Navigate to the project where you executed your task.
  2. Click the Tasks tab and then click the name of the desired task.
  3. Click View Stats.
  4. Select the tool or job in the timeline to pull up Pinned Details in the right panel.
  5. Click View logs in Pinned Details.
1101

This displays the log file for the chosen job.

2696

For each job, the following log files are produced:

  • job.json: A JSON file which describes the job. It contains the description of the command line tool and the inputs and allocated resources for the job.
  • cwl.output.json: A file which contains the outputs of the job. This file is only created if the job was finished successfully.
  • job.err.log: A file containing the Standard Error (stderr) stream of the job command. To understand the error logs, please consult the tool's manual.
  • *.log files - Log files that are produced by the Platform and by the tool:
  • cmd.log : A single-line file with the command used to run the job. If this file is absent, there was an error in constructing the command, such as an exception while evaluating an expression.
  • job.tree.log - A file that contains the tree structure of the working directory of the tool used in the job.
  • sbg.worker.log - A file which documents each phase of the job execution (starting and ending point for inputs download, docker pull, cmd execution and outputs upload) and evaluations for dynamic expressions.