MMM-Logging

This is a module for the MagicMirror².

This module extends the Node.js console logging capabilities of the MagicMirror² project through implementation of the tracer Node.js module, including adding timestamps and stack traces.

By default, this module will intercept and format ALL console log messages from the MagicMirror instance once it is loaded.

Examples:

Before MMM-Logging:

0|mm  | Starting MagicMirror: v2.6.0-dev
0|mm  | Loading config ...
0|mm  | Loading module helpers ...
0|mm  | Initializing new module helper ...
0|mm  | Module helper loaded: MMM-Logging
0|mm  | No helper found for module: alert.

After MMM-Logging:

Note: You can find more detailed information on debugging your MagicMirror here: Module Debugging. If you also want the Electron rederer (web browser) console logs to be printed to the standard console (or PM2 logs), change the following line to the very top of ~/MagicMirror/run-start.sh

export ELECTRON_ENABLE_LOGGING=true

Installing the module

To install the module, assuming you have MagicMirror installed with the default configuration:

cd ~/MagicMirror/modules
git clone https://github.com/shbatm/MMM-Logging.git
cd MMM-Logging/
npm install

Updating the module

cd ~/MagicMirror/modules/MMM-Logging
git pull
npm install

Using the module

To use this module, add the following configuration block to the TOP of the modules array in the config/config.js file:

var config = {
    modules: [
        {
            module: 'MMM-Logging',
            config: {
                // Module functions out of the box with nothing set here.
                // See below for configurable options.
            }
        }
    ]
}

Configuration options

Refer to documentation for tracer for most configuration options. They can be applied directly in the config section.

Module specific options:

Option	Description
`useColor`	Optional Whether or not to use `tracer`'s `colorConsole` method or regular `console` method. Type: `bool` Default `true`.
`overwriteConsoleMethods`	Optional Whether or not to overwrite the default Node.JS console methods. If `true` any `console.log`, `console.error`, etc. function calls in any module will be formatted. If `false`, only calls to `tracer.log`, etc. will be formatted. In most cases for MagicMirror, if you're using this module, you want `true` Type: `bool` Default `true`.
`overwriteBrowserMethods`	Optional Whether or not to overwrite the default web browser console methods. If `true` any `console.log`, `console.error`, etc. function calls in the DevTools console in any module will be formatted. If `false`, only calls to `tracer.log`, etc. will be formatted. Type: `bool` Default `false`--usually the DevTools console is good enough for tracing errors.
`echoModuleNotifications`	Optional If set any module notifications sent on the front-end will be printed on the Node.JS console log. Can be set to 'notification' to just send the notifications, or 'payload' to include the payloads as well. Type: `string` Default `'notification'`.
`echoErrors`	Optional If `true`, any errors in the web browser (front-end) will be printed on the Node.JS console log. Type: `bool` Default `true`.
`ignoreModules`	Optional Option to ignore notifications sent from certain modules. Defaults to ignoring `clock`, `calendar` and `newsfeed` since these send a lot of nusance notifications.

Default configuration:

{
    format: "{{timestamp}} <{{title}}> {{message}} ({{folder}}/{{file}}:{{line}} {{method}})",
    dateformat: "yyyy-mm-dd'T'HH:MM:ss",
    stackIndex: 2,
}

shbatm / MMM-Logging