Are there any guides to Jira log files?

Atlassian documentation offers some very light information, but I was hoping there might be a more robust guide to interpreting the information in all of the logs somewhere out there.

2 answers

1 accepted

1 vote
Accepted answer

There's two main log files for a JIRA - the catalina.out is the application server (tomcat) log file, and there's some stuff over at https://tomcat.apache.org/tomcat-7.0-doc/logging.html - again, it's more about general config and changing it, but it's a start on understanding the file.

The other one is the atlassian-jira.log - this is probably the one you're more interested in.  It's in a pretty standard format and basically captures everything if there's a hint of something going wrong.  It is, however, a java log, which is aimed at developers and can be very unfriendly to read. 

I'm not sure that there's much a "guide" can tell you though.  Some of it is intuitive, you can see dates and times, users etc.  When there's a fault or crash, you'll mostly see an "exception" of some sort, which are followed by a stack trace of hundreds of lines of file names and numbers (these really are hardcore dev messages - it's actually the line of source code in that file it is telling us!  So it's useless unless you have the source code).  You'll see batches of informational lines prefixed with warn or info, and then whatever messages the developers have chosen to output in their code.  That's what we can't write a guide for - each class could be doing anything at all, and we need the authors to code to spit out the messages we want!

I've found http://www.loggly.com/ultimate-guide/troubleshooting-with-java-logs/ helped me get my brain around it last time I was stuck, but obviously, that's not a JIRA guide.

Personally, I prefer to sling the logs through a log analyser or monitor - something that can look for patterns (e.g. lots of import related errors at 3am every day) and/or simplify the raw output to something more human.  Even better, I have the option of asking colleagues for help reading them!

Thanks - while those give information on where to find the logs, there isn't a lot of information on how to interpret the information in the logs.

Suggest an answer

Log in or Sign up to answer
Community showcase
Published Wednesday in Hipchat Cloud

Hipchat Cloud and Stride End of Life: Just over 90 days away

Earlier this year we made the difficult decision to discontinue our team messaging tools, Stride and Hipchat. The end of life date for Stride and Hipchat Cloud is quickly approaching - February 15, 2...

41 views 0 2
Read article

Atlassian User Groups

Connect with like-minded Atlassian users at free events near you!

Find a group

Connect with like-minded Atlassian users at free events near you!

Find my local user group

Unfortunately there are no AUG chapters near you at the moment.

Start an AUG

You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs

Groups near you