{"_id":"56eff7ebb31ea117009ed4d4","parentDoc":null,"category":{"_id":"55faf970a8a7770d00c2c0c1","version":"55faf11ba62ba1170021a9aa","pages":["5626a8c022ef6a2100fb3351","5626a9b766c62617009d1717","5626ab339ef9ea0d0029239a","56426aedb48bdf19006a4d34","56426b18b0dc090d00f884e3","56eff15b01da23190009bc74","56eff7ebb31ea117009ed4d4","56effc9d0b91372200aa2a40"],"project":"55faf11ba62ba1170021a9a7","__v":8,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-09-17T17:33:36.928Z","from_sync":false,"order":19,"slug":"review-task","title":"REVIEW A TASK"},"user":"566590c83889610d0008a253","project":"55faf11ba62ba1170021a9a7","version":{"_id":"55faf11ba62ba1170021a9aa","project":"55faf11ba62ba1170021a9a7","__v":37,"createdAt":"2015-09-17T16:58:03.490Z","releaseDate":"2015-09-17T16:58:03.490Z","categories":["55faf11ca62ba1170021a9ab","55faf8f4d0e22017005b8272","55faf91aa62ba1170021a9b5","55faf929a8a7770d00c2c0bd","55faf932a8a7770d00c2c0bf","55faf94b17b9d00d00969f47","55faf958d0e22017005b8274","55faf95fa8a7770d00c2c0c0","55faf96917b9d00d00969f48","55faf970a8a7770d00c2c0c1","55faf98c825d5f19001fa3a6","55faf99aa62ba1170021a9b8","55faf99fa62ba1170021a9b9","55faf9aa17b9d00d00969f49","55faf9b6a8a7770d00c2c0c3","55faf9bda62ba1170021a9ba","5604570090ee490d00440551","5637e8b2fbe1c50d008cb078","5649bb624fa1460d00780add","5671974d1b6b730d008b4823","5671979d60c8e70d006c9760","568e8eef70ca1f0d0035808e","56d0a2081ecc471500f1795e","56d4a0adde40c70b00823ea3","56d96b03dd90610b00270849","56fbb83d8f21c817002af880","573c811bee2b3b2200422be1","576bc92afb62dd20001cda85","5771811e27a5c20e00030dcd","5785191af3a10c0e009b75b0","57bdf84d5d48411900cd8dc0","57ff5c5dc135231700aed806","5804caf792398f0f00e77521","58458b4fba4f1c0f009692bb","586d3c287c6b5b2300c05055","58ef66d88646742f009a0216","58f5d52d7891630f00fe4e77"],"is_deprecated":false,"is_hidden":false,"is_beta":true,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"__v":9,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-03-21T13:32:27.511Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":2,"body":"Task logs are produced for every job of every tool executed in the task.  \n\nTo see detailed information about the tools executed in a task:  \n\n1. [Navigate to the project](view-a-project) where you executed your task.\n2. Click the **Tasks** tab and then click the name of the desired task. \n3. To open the task stats, click **View Stats**. \n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/nvayUMslQcaq3rimrDWl_task-stat-logz.jpg\",\n        \"task-stat-logz.jpg\",\n        \"1165\",\n        \"658\",\n        \"#225285\",\n        \"\"\n      ],\n      \"border\": true\n    }\n  ]\n}\n[/block]\nThe **Task stats **page will be displayed.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [],\n      \"border\": true\n    }\n  ]\n}\n[/block]\n4. Click **View task logs** in the top-right corner.\nThe **Task logs** page will be displayed. \nThe left hand side bar shows directories containing the logs for each job in the task.\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/tSYRMjS7uQHRbgpNoVg6_task-logs-frr.jpg\",\n        \"task-logs-frr.jpg\",\n        \"1880\",\n        \"834\",\n        \"#76614a\",\n        \"\"\n      ],\n      \"border\": true\n    }\n  ]\n}\n[/block]\nEach directory contains the following files:\n\n  * `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.\n  * `job.result.json`: A file which contains the outputs of the job. This file is only created if the job was finished successfully.\n  * `job.result.err`: A file containing the Standard Error (stderr) stream of the job command. To understand the error logs, please consult the tool's manual.\n  * ***.log files** - Log files that are produced by the Platform and by the tool:\n    * `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.\n    * `job.tree.log` - A log file that contains the tree structure of the working directory of the tool used in the job.\n\nTo view a log click on its name. The contents of the log will be displayed on the right.\n[block:callout]\n{\n  \"type\": \"success\",\n  \"body\": \"Logs can be used to troubleshoot failed tasks. See the documentation on [Troubleshooting a Failed Task](doc:troubleshoot-a-failed-task) for more information.\"\n}\n[/block]\n<div align=\"right\"><a href=\"#top\">top</a></div>\n\n##View a log for a single tool or job\nYou can also view logs for a specific tool or job. This is particularly useful if you are [troubleshooting a failed task](troubleshoot-a-failed-task). To see the logs for a specific tool or job: \n\n1. Navigate to the project where you executed your task.\n2. Click the **Tasks** tab and then click the name of the desired task. \n3. Click **View Stats**. \n4. Select the tool or job in the timeline to pull up **Pinned Details** in the right panel.\n5. Click **View logs** in **Pinned Details**.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/c14cbf2-view_task_logs_4_cgc.png\",\n        \"view_task_logs_4_cgc.png\",\n        1101,\n        657,\n        \"#f8f8f8\"\n      ],\n      \"border\": true\n    }\n  ]\n}\n[/block]\nThis displays the log file for the chosen job.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/OTwKQQRyRR2XWIgcZMnA_view-single-job-F.jpg\",\n        \"view-single-job-F.jpg\",\n        \"1867\",\n        \"841\",\n        \"#e39633\",\n        \"\"\n      ],\n      \"border\": true\n    }\n  ]\n}\n[/block]\nFor each job, the following log files are produced:\n\n* `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.\n* `job.result.json`: A file which contains the outputs of the job. This file is only created if the job was finished successfully.\n* `job.result.err`: A file containing the Standard Error (stderr) stream of the job command. To understand the error logs, please consult the tool's manual.\n*  ** *.log files** - Log files that are produced by the Platform and by the tool:\n  * `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.\n  *  `job.tree.log` - A file that contains the tree structure of the working directory of the tool used in the job.\n\n<div align=\"right\"><a href=\"#top\">top</a></div>","excerpt":"<a name=\"top\"></a>","slug":"view-task-logs","type":"basic","title":"View Task logs"}

View Task logs

<a name="top"></a>

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](view-a-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**. [block:image] { "images": [ { "image": [ "https://files.readme.io/nvayUMslQcaq3rimrDWl_task-stat-logz.jpg", "task-stat-logz.jpg", "1165", "658", "#225285", "" ], "border": true } ] } [/block] The **Task stats **page will be displayed. [block:image] { "images": [ { "image": [], "border": true } ] } [/block] 4. 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. [block:image] { "images": [ { "image": [ "https://files.readme.io/tSYRMjS7uQHRbgpNoVg6_task-logs-frr.jpg", "task-logs-frr.jpg", "1880", "834", "#76614a", "" ], "border": true } ] } [/block] 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. * `job.result.json`: A file which contains the outputs of the job. This file is only created if the job was finished successfully. * `job.result.err`: 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. [block:callout] { "type": "success", "body": "Logs can be used to troubleshoot failed tasks. See the documentation on [Troubleshooting a Failed Task](doc:troubleshoot-a-failed-task) for more information." } [/block] <div align="right"><a href="#top">top</a></div> ##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](troubleshoot-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**. [block:image] { "images": [ { "image": [ "https://files.readme.io/c14cbf2-view_task_logs_4_cgc.png", "view_task_logs_4_cgc.png", 1101, 657, "#f8f8f8" ], "border": true } ] } [/block] This displays the log file for the chosen job. [block:image] { "images": [ { "image": [ "https://files.readme.io/OTwKQQRyRR2XWIgcZMnA_view-single-job-F.jpg", "view-single-job-F.jpg", "1867", "841", "#e39633", "" ], "border": true } ] } [/block] 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. * `job.result.json`: A file which contains the outputs of the job. This file is only created if the job was finished successfully. * `job.result.err`: 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. <div align="right"><a href="#top">top</a></div>