Skip to main content
Skip table of contents

How to create detailed Jira logs for OBSS plugins?

In order to create detailed logs, you need to temporarily enable DEBUG level logging for tr.com.obss and com.obss package names, as described below:

  1. Go to "Logging and Profiling" page 
    1. It is located under Administration >> System
  2. Enable debug level logging for tr.com.obss and com.obss packages. See the documents below for detailed information about setting logging levels.
    1. JIRA
      1. https://confluence.atlassian.com/jirakb/how-to-set-logging-level-for-a-package-in-jira-629178605.html
    2. Confluence
      1. https://confluence.atlassian.com/doc/configuring-logging-181535215.html
  3. On the same page, trigger a roll over for the log file so you can have a clean log.
    1. Go to the top of Logging and Profiling page
    2. Insert an optional message into the textbox labeled "Optional Message"
    3. Check the checkbox labeled "Log Rollover"
    4. Click the Mark button. This will start a clean new log file.
  4. Trigger the action on JIRA that you want to create a log for. 
    1. This will create detailed log output in the log file.
  5. Create a support ZIP and send it to OBSS.
    1. Go to "Administration >> System >> Troubleshooting and Support Tools >> Create support zip" to create a support zip file.
    2. You may exclude "Authentication configuration files" while creating the zip, unless it is explicitly requested by OBSS support team.
    3. If the support ZIP file is too large, OBSS team might ask just for your Jira log file. (The "atlassian-jira.log file" in the home folder on your Jira server)
    4. Once the zip file is created, the very same page will tell you the location of the support zip file on the server.
    5. Go to the link below to get more information about preparing a support zip file.
      1. https://confluence.atlassian.com/support/create-a-support-zip-790796819.html
  6. Do not forget to reduce logging level for tr.com.obss and com.obss to INFO when you are done.
    1. Otherwise the plugin will keep producing very detailed log output and you log files will grow rapidly
    2. Click the INFO link button next to tr.com.obss package name down in the page to set the log level to INFO


Producing clean logs will help OBSS Team while examining your issue so please consider the following:

  1. Try to create logs on a spare test system where nobody else is working so you are the only one creating log output.
  2. If you have to use your live system (or another system that is also used by others) please try to do it in off times where few people as possible is working (and creating logs) on the system.
  3. Follow every step in your use case to create comprehensive logs but don't do anything that is not necessary or don't do things several times. Most of the time repeting logs just make it harder to analyse.





JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.