Automatically Include Revision in Log Statement

When there is a problem with your software, the first thing you usually ask for is a log showing what happened (provided you write debuggable code), and the version of the software that was running. But it is easy to have the revision of the software automatically added to the log.

In the class Call.java, the subversion revision number is automatically stored at every commit using the following syntax:


// Don't change, auto-updated by svn on check-in
final static String revision = "$Revision: 135264 $";

When printing to the log the first time for a call, the revision information is added:

private void printTraceHeader(String message) {
  if (!initialTracePrinted) {
    ctx.printTraceHeader(revision);
    initialTracePrinted = true;
  }
  ctx.printTraceHeader(message);
}

The beginning of a call log looks like this:

-- 17, callcontrol: $Revision: 135264 $

-- 18, callcontrol: Processing MOC IDP, protocol=CAP_V2,
   profile=Profile7.6, layer=callcontrol@tsmr2

-- 18, callcontrol: Trace already activated before call control.

-- 19, callhomerouting: Check if call should be home
   routed, location: 46702000000

-- 19, callhomerouting: Location 46702000000 not configured
   in table, so don't home route.
...

The first printed line in the log shows that the version of Call.java used was 135264. Every line in the log also contains a relative time stamp (in milliseconds) and the module name, in addition to the actual message. And yes, we still use subversion at work, but I am sure the same information can be included from git as well.

I have been using this simple addition to the logs for a long time, and it has been helpful many times in the past. Every time you check in a new version, the revision variable is updated automatically. If you are not already using this, give it a try. It is quick to set up, and you never again have to wonder which revision was used.

One response to “Automatically Include Revision in Log Statement

  1. Here is a link to the svn documentation explaining how to use keyword substitution: http://svnbook.red-bean.com/en/1.7/svn.advanced.props.special.keywords.html
    For example, add final static String revision = “$Revision$”; to the class Call.java, and don’t forget to give command: svn propset svn:keywords “Revision” Call.java

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s