Often you download an Add-On for Jira, which doesn’t work right away. The first thing you do, of course, is contacting the support – which is fine. The support, however, immediately asks for the server log. This is not always easy to find, but in this tutorial I will show you how to read the log quickly and effectively (in this case Jira SITO).
Enable logging and profiling
The first thing to do is to enable the logging and profiling for a given logger. The logger names are usually sent to you by the support or Wiki of the add-on:
- Navigate to Administration > System > Logging and profiling
- Scroll down to the section “Default loggers”
- Click on “Configure logging level for another package.”
- A dialog opens where you have to enter the logger name
- For support purposes the log level should be “TRACE”
For Jira SITO you should add the following logger names:
Note: When you have finished with debugging and sent the log to the support please do not forget to deactivate the logging for that packages by clicking “OFF” in the list of default loggers.
Trigger a synchronization
Now you have enabled the logging. To fill text into the log you have to trigger the Exchange synchronization by navigating to an issue and change one of the following fields:
- Period of time
- Due Date
Please consider that all of that fields have to be filled so the Outlook appointment can be created.
The usual way to view a log is by connecting to the server and navigate to the log output folder. But there is a much simpler way by and lightweight Add-on:
- Download and install “Last log for Jira”: https://marketplace.atlassian.com/apps/1211604/last-log-for-jira
- Navigate to Administration > Add-Ons > Lastlog-Add-On “View log”
- Search for string should be “jira.sito”
- “Apply filter”
By clicking “Apply filter” a lot of text is output which represents the log of the Add-on (Jira SITO). Now you can copy that text and send it to the support team.