Package Exports

pip-clients-logging-node

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (pip-clients-logging-node) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Logging Microservice Client SDK for Node.js

This is a Node.js client SDK for pip-services-logging microservice. It provides an easy to use abstraction over communication protocols:

HTTP/REST client
Seneca client (see http://www.senecajs.org)
Direct client for monolythic deployments
Null client to be used in testing

This client SDK also contains Direct, REST and Seneca loggers that allow to directly log into the microservice.

Quick Links:

Install

Add dependency to the client SDK into package.json file of your project

{
    ...
    "dependencies": {
        ....
        "pip-clients-logging-node": "^1.0.*",
        ...
    }
}

Then install the dependency using npm tool

# Install new dependencies
npm install

# Update already installed dependencies
npm update

Use

Inside your code get the reference to the client SDK

var sdk = new require('pip-clients-logging-node');

Define client configuration parameters that match configuration of the microservice external API

// Client configuration
var config = {
    connection: {
        protocol: 'http',
        host: 'localhost', 
        port: 8080
    }
};

Instantiate the client and open connection to the microservice

// Create the client instance
var client = sdk.LoggingHttpClientV1(config);

// Connect to the microservice
client.open(null, function(err) {
    if (err) {
        console.error('Connection to the microservice failed');
        console.error(err);
        return;
    }
    
    // Work with the microservice
    ...
});

Now the client is ready to perform operations

// Log message
client.writeMessage(
    null,
    { 
        type: 'restart',
        source: 'server 1',
        message: 'Server restarted'
    },
    function (err, event) {
        ...
    }
);

var now = new Date();

// Get the messages for server 1 for the last day
client.readMessages(
    null,
    {
        from: new Date(now.getTime() - 24 * 3600 * 1000),
        to: now,
        source: 'server 1'
    },
    {
        total: true,
        skip: 0, 
        take: 100
    },
    function(err, page) {
    ...    
    }
);

Acknowledgements

This client SDK was created and currently maintained by Sergey Seroukhov.