blogdisclaimerImage Added

If you have a server hosting Jira and Confluence, what timezone do you set it to? UTC, or the timezone your users are in?

...

In this post I'll outline why I think you should set your server to the timezone of the bulk of your users, rather than nice clean UTC, and specifically why, if you find yourself setting the -Duser.timezone=...  parameter, you're probably making life harder for yourself than necessary.

Keeping the same timezone within a server

First, I think we can all agree, log files on the same server should all have use the same time zone.

There are at least 3 log-generating things you'll be concerned with:

• The app server (Jira, Confluence), and their its log files (atlassian-jira.log, atlassian-confluence.log)
• The web server (Apache, nginx) and their its log files (access.log, error.log)
• The operating system and its logs (/var/log/*) and persistent performance stats (e.g. /var/log/atop/*)

Events across these often need to be correlated - for instance, a spike in requests (access.log) triggers high server load (operating system), and eventually application errors (atlassian-jira.log). For your debugging sanity, it is essential that all these log files must have the same timezone.

The web server and OS logs are all in the OS timezone, obviously. How about app server logs, atlassian-jira.log and atlassian-confluence.log?

App Well, app server log timestamps will also be in the OS timezone, unless you've told Java otherwise , by explicitly setting -Duser.timezone . If To spell it out: if you've set -Duser.timezone , you can no longer correlate datestamps between atlassian-jira.log, access.log and the rest of the system.

So don't do that. Don't ever set -Duser.timezone. Leave Java in the same timezone as your OS.

Why not UTC?

There are two arguments against setting your server timezone to UTC.

The argument from ease-of-debugging

Users report problems relative to their timezone. Screenshots might be saved with timestamped filenames. "Things got really slow around 4pm" they'll say, and off you go your job is to find what was happening on the server at 4pm.

Perhaps my tooling is a bit primitive, but I work on Linux, and my tooling hasn't evolved much since the 1970s. I don't know an easy way to convert log timestamps from UTC to that of an arbitrary usersomething else, on the fly. If the log's timezone is that of the user, life just is just easier.

The argument from Confluence developer laziness

"But", our administrator says, "I want UTC on the server for <insert sane, excellent reasons>, and I use <insert names of tool that let me view logs in any timezone, which I shall share with you in the comments>. Why can't the OS and Java be set to UTC, and the apps be told only to display dates in a specific format?"

The answer is that this would be possible, had not the except that Confluence developers failed to implement a default user timezone setting (

To review, the timezone users see in Jira and Confluence comes from one of various levels:

1) User preference	Users can explicitly set their timezone in their profile: Jira Confluence Image Modified Image Modified
2) Default user preference	If your user preference isn't set, the default user preference will be in effect. Jira Jira conveniently lets you edit the default user timezone in General Configuration: Image Modified Confluence Confluence does not let you edit the default timezone ( Jira server Atlassian JIRA serverId 144880e9-a353-312f-9412-ed028e8166fa key CONFSERVER-16057 ). Instead you have to resort to editing XML files inside jars.
3) Java user.timezone	The default user timezone preference inherits its value from the Java user.timezone Java property.  You can set this user.timezone Java flag in bin/setenv.sh, e.g. to -Duser.timezone=America/Los_Angeles .
4) OS timezone	Finally, Java sets its user.timezone property default to the operating system's timezone: Code Block $ cat /etc/timezone Australia/Sydney

If Confluence allowed a default user timezone preference to be set (like Jira), then it wouldn't matter what your OS or Java timezone was set to. Set them to UTC or whatever you like.

...

So in Jira, everything is great. You can have atlassian-jira.log use a timezone that's good for debugging (UTC if that's your preference), while the default timezone used to render dates can be something appropriate for the majority of users.

In Confluence, sadly there is only one default timezone (Java's user.timezone ). It will have to be set to the timezone that makes sense for most users. This means atlassian-confluence.log will also use that timezone, and for consistency, so should the rest of the OS.

Conclusion

The conclusions are:

• Don't ever use -Duser.timezone  as it leads to inconsistent timezones across local log files.
• Vote for

  Jira
  server Atlassian JIRA serverId 144880e9-a353-312f-9412-ed028e8166fa key CONFSERVER-16057

  (bitter laughter).
• If you running Confluence, your OS timezone should be set to what you want your default user timezone for users to be.
• If you running only Jira, I still suggest setting your OS timezone to what you want the default user timezone to be, just to make debugging simpler. However you have the option to use UTC as your OS and Java timezone, as long as you set Jira's default user timezone explicitly.