told-nodejs-client

A client to log messates into a told log recorder. See https://github.com/petershaw/told-LogRecorder to kern more about told.

Description

Sends a message to the server. Noting more, nothing less.

Usage

var told = require('told-client-js')(opts);
told.tell("A Test Message", "Error", "Connection,Database");

or

var told = require('told-client-js')(opts);
message = {
	myKey_1: "foo"
	, myKey_2: "bar"
};
type = "Error";
tags = ["Connection", "Database"];
told.tell(message, type, tags);

and of course you can use it as one big Object:

var told = require('told-client-js')(opts);
paylaod = {
	message: {
		myKey_1: "foo"
		, myKey_2: "bar"
	}
	, type: "Error"
	, tags: [
		"Connection"
		, "Database"
	]
};
told.tell(paylaod);

Configuration

You HAVE TO set a url to your told server.

opts = {
	url: 'http://told.mydomain.com'
}

 Additional you can set one of this default options:

To set a fixed type, if no other is set by the call itself:

opts.type = "myApplication"

To add some default tags. These tags will be send ALWAYS right next to the tags that are send by the call it self:

opts.tags = ["beutiful", "catcontent"]

To set some default tags could be overwritten by the call:

opts.defaultags = ["unspecific error"]

Protokoll:

As default, this client use http POST over tcp ip. If you want to use UDP dgram packages instead, than you have to wait for the next Version.