Overview Version (1) Discussion (1)

• 

  Monolog Logging Service

  This XenForo 2.x addon adds logging functionality using the Monolog library
  About this resource

  This XenForo 2.x addon adds logging functionality using the Monolog library from https://github.com/Seldaek/monolog
  
  Notes
  v3.x of this addon uses Monolog v1
  v4.x of this addon uses Monolog v2
  
  There is currently no difference in functionality between the two versions other than the version of Monolog used.
  
  Features
  

  • Log to a file
  • Send logs via email
  • Emailed logs are deduplicated and buffered
  • Configure minimum logging levels for files vs email logging
  • Add extra visitor data to logs: user_id and username
  • Add extra web data to logs: current request URI, request method and client IP
  • Test tool included to verify that logs are being written to disk - go to AdminCP > Tools > Checks and tests > Test Monolog

  

  
  
  Usage Instructions
  
  By default, this addon will log events to a file called internal_data/monolog.log - this is configurable.
  
  To use the default logging facility, do the following in your addon code:
  
  

  PHP:

  use Monolog\Helper\Log;
  Log::info('an info message', ['context' => 'foo']);
  Log::error('an error message', ['data' => 'bar']);

  
  However, it is recommended that you create your own channel for your addon to make it easier to filter log entries:
  
  

  PHP:

  $logger = \XF::app()->get('monolog')->newChannel('myaddon');
  $logger->warning('a warning message', ['context' => 'foo']);

  
  Refer to the documentation for more detailed usage instructions for Monolog.
  
  You can create your own handler stack to customise how things are logged:
  
  

  PHP:

  use Monolog\Logger;
  
  $monolog = \XF::app()->get('monolog');
  $streamhandler = $monolog->stream(); // return our default stream handler for logging to a file
                              //(or create your own!)
  
  /** @var Monolog\Logger $logger */
  $logger = $monolog->logger('myaddon');
  $logger->pushHandler($streamhandler); // push our stream handler onto the handler stack
  // you can apply any other customisations you like here as well by adding custom handlers, formatters or processors
  
  $logger->critical('a critical message', ['context' => 'foo']);
• Version

  4.1.1 Stable Available Jan 15, 2026 · 0

  Download

  File size: 251 KB

  SHA-256: 0f3662da973994b349cc96a919b15bfa556d5efdcb04f056d7d09509e24086e0

  SHA-256 verified Package valid Compatibility checked Last verified: Wednesday at 12:10 AM

  This XenForo 2.x addon adds logging functionality using the Monolog library from https://github.com/Seldaek/monolog
  
  Notes
  v3.x of this addon uses Monolog v1
  v4.x of this addon uses Monolog v2
  
  There is currently no difference in functionality between the two versions other than the version of Monolog used.
  
  Features
  

  • Log to a file
  • Send logs via email
  • Emailed logs are deduplicated and buffered
  • Configure minimum logging levels for files vs email logging
  • Add extra visitor data to logs: user_id and username
  • Add extra web data to logs: current request URI, request method and client IP
  • Test tool included to verify that logs are being written to disk - go to AdminCP > Tools > Checks and tests > Test Monolog

  View attachment 3421
  
  Usage Instructions
  
  By default, this addon will log events to a file called internal_data/monolog.log - this is configurable.
  
  To use the default logging facility, do the following in your addon code:
  
  

  PHP:

  use Monolog\Helper\Log;
  Log::info('an info message', ['context' => 'foo']);
  Log::error('an error message', ['data' => 'bar']);

  
  However, it is recommended that you create your own channel for your addon to make it easier to filter log entries:
  
  

  PHP:

  $logger = \XF::app()->get('monolog')->newChannel('myaddon');
  $logger->warning('a warning message', ['context' => 'foo']);

  
  Refer to the documentation for more detailed usage instructions for Monolog.
  
  You can create your own handler stack to customise how things are logged:
  
  

  PHP:

  use Monolog\Logger;
  
  $monolog = \XF::app()->get('monolog');
  $streamhandler = $monolog->stream(); // return our default stream handler for logging to a file
                              //(or create your own!)
  
  /** @var Monolog\Logger $logger */
  $logger = $monolog->logger('myaddon');
  $logger->pushHandler($streamhandler); // push our stream handler onto the handler stack
  // you can apply any other customisations you like here as well by adding custom handlers, formatters or processors
  
  $logger->critical('a critical message', ['context' => 'foo']);
• Discussion

  This resource has a discussion thread on the forum where you can ask questions, report issues, and talk with the author and other users.

  Join the discussion (1)