Provides a public interface which can send messages to the Plumtree Logging Toolkit.

See Logging Example for an annotated console application example, or refer to the more concise usage examples below.

Recommendations for Configuration

When using the EDK in a web application context we recommend configuring the logging framework via Web.config (Microsoft IIS) or web.xml (Java servlet containers). The web application configuration files shipped with the EDK contain annotated examples of how to configure logging.

When outside a web application context we recommend that a single log management class be declared within the project that will initialize the LogFactory (possibly as part of static initialization). This instance will provide instances of ILogger and possibly define a set of known component names for the application. This technique will help to avoid multiple initializations.

Logging Application Name

This name is set during initialization of the LogFactory or configured in the web configuration file. The logging application name is used as a shared identifier which allows Plumtree log receivers to pick up messages from the logging application. All crawler, authentication, profile or search web services running in the same EDK web application instance will have the same logging application name.

Component Name

All ILogger instances require a component name to identify the general context for a set of log messages. A component is a conceptual unit within an application. A small application may have only a single named component. It is reasonable to define component names as string constants that are localized in a log management class.

Recommendations for Efficiency

The Plumtree logging framework is designed to suppress logging if there are no listening applications. For better performance, logging applications should use the ILogger interface to find out if there any listening applications before composing complex log messages. For example:

if (logger.DebugEnabled) {
	// compose a diagnostic message
	logger.Debug( complex diagnostic message...);
}

Similarly, the Plumtree logging framework will avoid internally composing formatted log messages when there are no listeners. For this reason, ILogger has numerous method overloads which allow passing a format string and various Object and numeric arguments. The arguments will only be processed and composed into a log message if there is an active listener for that log level. This helps avoid unnecessary string concatenation and makes for cleaner code.

Prefer this:

	logger.Debug("An error occurred when {0} attempted to access {1} (context {2})", 
                        user, resource, context);

to this:

	logger.Debug(
	    "An error occurred when " + user +
	    " attempted to access " + resource +
	    " (context " + context + 
	    ")");

Usage Example

using System;
using Plumtree.Remote.Logging;
namespace Plumtree.Remote.Logging.Test;
{
  /// <summary>
  /// Provides an example of using the Plumtree EDK
  ///  logging API.
  /// </summary>
  public class LoggingExampleLogUser
  {
    public LoggingExampleLogUser() : base()
    {
    }
    private static ILogger getLogger()
    {
      return LoggingExampleLogHolder.getLogger(typeof(LoggingExampleLogUser));
    }
    public static Object createObjectFor(String customerName)
    {
      ILogger logger = getLogger();
      logger.FunctionBegin("createObjectFor");
      Object retValue = new Object();
      logger.Info("Created new object for customer {0}.", customerName);
      if (logger.DebugEnabled())
      {
        logger.Debug("Details of new object: {0}, runtime type {1}, customer {2}",
         retValue.ToString(), retValue.GetType().FullName, customerName);
        }
      logger.FunctionEnd("createObjectFor");
      return retValue;
    }
    public static void Main(String[] arguments)
    {
      createObjectFor("Plumtree");
      for (int i = 0;i < arguments.Length;i++)
      {
        createObjectFor(arguments[i]);
      }
    }
  }
}

using System;
using Plumtree.Remote.Logging;
namespace Plumtree.Remote.Logging.Test;
{
  public class LoggingExampleLogHolder
  {
    public LoggingExampleLogHolder() : base()
    {
    }
    private static bool logToNetworkWhenTrue = true;
    static LoggingExampleLogHolder()
    {
      LogFactory.Initialize("ExampleName", logToNetworkWhenTrue);
    }
    public static ILogger getLogger(Type loggingClass)
    {
      return LogFactory.GetLogger("LoggingExample", loggingClass);
    }
  }
}
    

Receiving and Viewing Log Messages

To receive and view log messages generated by the Plumtree logging framework, it is necessary to install the Plumtree Logging Toolkit and use one of its log receivers such as Plumtree Logging Spy or the Plumtree Logger. The receiver must be configured with a logging application name matching the sender. For more information, see the Plumtree Developer Center.

Related Documentation

For examples, developer discussions and additional documentation, see the Plumtree Developer Center.

Namespace hierarchy

Classes

Interfaces

---