Node.js plugin to interface to LogMeUp
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

Node.js - LogMeUp


LogMeUp is logger software. The difference between LogMeUp and other logging solutions is that with LogMeUp you can view your log files real-time in the web browser all over the world.

This is a Node.js REST api wrapper for LogMeUp Server ( Vist to learn about setting it up.


npm install logmeup


To create a log file to start logging to, you must create a LogMeUp collection/app pair.

If you're developing an app named 'Slick Server' and you worked for the company 'Crab Shack', you might name your app slickserver and your collection crabshack.



Creates an instance of a LogMeUp object. Valid input parameters are:

  • host - LogMeUp host
  • port - LogMeUp port, typically 7070
  • collection - The name of your collection
  • app - The name of your app
  • autocreate - (Optional) recommend, Calling the create() method isn't needed if this flag is set.


Creates a log file. Callback parameters:

  • error - null if no error
  • body - body text from server, null if error


Deletes a log file. Callback parameters:

  • error - null if no error
  • body - body text from server, null if error


Is always set to false after a LogMeUp object is instantiated or created. Once a create() is called, it's set to true. If autocreate is set to true, then create() is implicitly called and logExists will be set to true. Calling delete() will set this to false.


Logs data. Data can be a string for an object. Callback isn't necessary, but may be used for troubleshooting. Callback parameters:

  • error - null if no error
  • body - body text from server, null if error

Example: Creating Logger

var LogMeUp = require('logmeup').LogMeUp
var logger = LogMeUp.createLogger({host: "", port: 7070, collection: "crabshack", app: "slickserver", autocreate: true});

Note: Setting autocreate to true will prevent you from having to call create() before you start logging.

Example: Logging Data

These methods are asynchronous.

//log some JSON
logger.log({name: "JP", company: "Gitpilot"});

//log a string
logger.log("This is a really bad error!");

//optionally: inspect the servers response
logger.log("Bad error", function(error, responseText){
  console.log("The server said: " + responseText);
  if (err != null) {
    console.log("There was an error: " + err.message());

Default Logger

You can create a file named logmeup.json in the base directory of your application or in the config/ folder of your app.

Configuration File

The configuration file should look like this:

    "host": "",
    "port": 7070,
    "collection": "gitpilotllc",
    "app": "server"
	"autocreate": true

Using Default Logger

//will autoload logmeup.json
//this way you can put this at the top of all your modules in your app without having to recreate the logger each time
var logger = require('logmeup').default;



MIT License. See LICENSE for complete details.

Copyright (c) 2012 JP Richardson Twitter / Google+