Logging Overview

Logging is a standard part of most software that is, all to often, only given a minimal amount of attention. However, by approaching logging with a more stringent point of view, we are able to design systems that allows us to quickly determine what is going on inside of them. This introspection in turn allows us to determine what the typical performance is for a system, as well as determine where a fault has occurred in the system.

Some typical information that is logged by a system includes, but is not limited to:

Another aspect that is usually considered to be separate from logging is performance metrics. I am including metrics in this paper, since the overall design that will be discussed here lends itself to not only logging messages like the ones listed above, but perfomance metrics as well. Examples of metrics include:

Logging Locations

The traditional location for a log has been a file located on the server that houses the service that is writing to the log. This is not always true, especially with the adoption of microservices. In the latter case, instead of writing to a file, the logging system sends the log line to another service, when then stores it in some type of database.

By abstracting the logging from the core code we will be able to take advantage of these features:

  1. Simplify the business logic code
  2. Simplify the logging code
  3. Update the logging code with minimal impact on the business code.
  4. Introduce standard formatting to the logged information.

Next: Design Concepts