Our new Appfire Documentation Space is now live!
Take a look here! If you have any questions please email support@appfire.com
Execution logs
Execution logs are generated by every JMWE Extension (Conditions, Validators, and Post functions) when executed. These log files enable Jira administrators to monitor workflow extensions and provide detailed information about each execution at runtime. This information includes the extension, the issue to which the extension is attached, when the extension was triggered, and more.
You must be logged in as an administrator to view or use this page.
Navigate to the Execution log page by going to Jira Settings → Manage Apps and selecting Execution logs in the right-hand panel (under the Jira Misc Workflow Extensions). The Execution logs page will open.
Recent executions
You can use the Recent executions chart to monitor successful executions and any errors or warnings in the last seven days. By default, any executions with errors or warnings are displayed in the chart; however, the chart can be filtered to display only specific executions - Successes, Errors, or Warnings using the checkboxes to the right.
Additionally, there are several actions that can be performed on log files, available through the action buttons above the Recent executions chart or through the Detail view. These actions include:
Acknowledge logs - This marks the log as reviewed, which greys them out in the list but does not delete them.
Delete logs - This will delete all logs of a specific type (Successes, Warnings, or Errors); clicking the Delete logs button will open a confirmation box where the type of log to be deleted can be selected and confirmed.
Download logs - This will download all logs of the selected type (or types) in JSON format.
Log Entries
The table view (shown above) aggregates and displays information about the execution logs generated by the JMWE add-on. This table includes the following information:
Status - Displays the type of execution - Errors, Warnings, or Success. You can click on the specific execution status you are interested in to get more information about the execution.
Executed at - Displays the time of execution.
Issue - The link to the associated issue.
Workflow extension - The name and type of the workflow extension.
Context - Displays the information about the transition and the workflow associated with the execution.
Triggered by - Information about the user who triggered the execution.
View - Opens a modal window detailing more information on the execution, including context and stack trace. See Detail view below for more information.
Detail View
Clicking the View link in the list of execution logs will open a modal window showing the full details of the log (pictured above). This window includes the specific error message or warning (if any) as well as the option to fetch and display detailed Jira log information.
Lastly, logs can also be acknowledged using the Acknowledge button, which will mark them as reviewed and grey them out in the Recent executions list.
View recent executions in the Transition editor
It is possible to view only the execution logs for a specific transition entity (e.g., a Condition, Validator, or Post Function).
Open the transition and select the Conditions/Validators/Post Functions tab, depending on the execution log to be viewed.
The ‘Recent execution logs’ associated with each JMWE workflow extension are listed underneath the JMWE entity (see screenshot, below). From this list, current and previous versions of the execution can be viewed.
Click on an execution status to get more information about that execution log.
Configure Logs Storage
From the Jira menu, go to Manage Apps.
In the left sidebar, under the Jira Misc Workflow Extensions section, click the JMWE Configuration link.
Locate the Logs storage section towards the bottom of the page.
Select the number of recent logs to be stored for each workflow extension.
Additionally, select the number of error logs to keep for each workflow extension.
Click Update Settings.