A simple logging utility for NodeJS

Usage no npm install needed!

<script type="module">
  import theSimpleLog from '';


simple-log: a cloud-based log for node

simple-log is the simple way to do logging on node. Debug your application from anywhere, whether it's running locally, in a docker container, or in a VPS in the cloud.

Table of Contents


npm install -S simple-log


You need to create an API Key and a Project on


After setting up the simple object:

const options = { apiKey: '', projectName: 'My App' };
const simple = require('simple-log')(options);

You can call simple.log or one of the convenience functions (simple.debug,, simple.warn, simple.error, simple.fatal)


Logging 101

'use strict';

const options = { apiKey: '', project: 'My App' };
const simple = require('simple-log')(options);

// since we're using simple.log, we have to pass the logging level ('info') ourselves
simple.log('info', 'Started application'); 

// helper functions perform the same action as simple.log('LEVEL', 'message')'Initializing modules...');
simple.debug('Starting MySQL');
simple.debug('Starting Redis');


There are a number of options that can be set while initializing the simple object:

  • apiKey (required) - obtain via
  • project (required) - obtain via
  • transports (optional) - default value: ["simple-api", "console"], allowable values: ["simple-api", "console"]
  • consoleFormat (optional) - default value: d h (i): m, allowable values can be seen here


There are two available transports, both are enabled by default:

  • simple-api - logs to The Simple App API
  • console - logs locally to stdout, just like console.log

Output Formats

When logging to the console (using the console transport option and setting consoleFormat), you can specify the preferred format from the following options:

  • f: filename
  • l: line number
  • h: hostname
  • i: internal ip
  • e: external ip
  • d: date
  • m: message