DefinitelyTyped icon, indicating that this package has TypeScript declarations provided by the separate @types/node-loggly-bulk package

4.0.1 • Public • Published


Version npmnpm Downloads


A client implementation for Loggly in node.js. Check out Loggly's Node logging documentation for more.


The node-loggly-bulk library is compliant with the Loggly API. Using node-loggly-bulk you can send logs to Loggly.

Getting Started

Before we can do anything with Loggly, we have to create a client with valid credentials. We will authenticate for you automatically:

  var loggly = require('node-loggly-bulk');

  var client = loggly.createClient({
    token: "your-really-long-input-token",
    subdomain: "your-subdomain",
    // Optional: Tag to send with EVERY log message
    tags: ['global-tag']


There are two ways to send log information to Loggly via node-loggly-bulk. The first is to simply call client.log with an appropriate input token:

  client.log(' - Theres no place like home', function (err, result) {
    // Do something once you've logged

Note that the callback in the above example is optional, if you prefer the 'fire and forget' method of logging:

  client.log(' - Theres no place like home');

Logging with Tags

If you're using Loggly's tags functionality, simply include an array of tags as the second argument to the log method:

  client.log(' - Theres no place like home', [ 'dorothy' ], function (err, result) {
    // Do something once you've logged

note Tags passed into the log function will be merged with any global tags you may have defined.

Logging Shallow JSON Objects as a String

In addition to logging pure strings, it is also possible to pass shallow JSON object literals (i.e. no nested objects) to client.log(..) or input.log(..) methods, which will get converted into the Loggly recommended string representation. So

  var source = {
    foo: 1,
    bar: 2,
    buzz: 3


will be logged as:


Logging JSON Objects

It is also possible to log complex objects using the new JSON capabilities of Loggly. To enable JSON functionality in the client simply add 'json: true' to the configuration:

  var config = {
    token: 'token',
    subdomain: "your-subdomain",
    json: true

When the json flag is enabled, objects will be converted to JSON using JSON.stringify before being transmitted to Loggly. So

  var source = {
    foo: 1,
    bar: 2,
    buzz: {
      sheep: 'jumped',
      times: 10


will be logged as:

  { "foo": 1, "bar": 2, "buzz": {"sheep": "jumped", "times": 10 }}

Logging arrays

It is possible to send arrays, which will result in one single request to Loggly.

  input.log([ {iam:'number 1'}, {iam:'number 2'} ])


Installing npm (node package manager)

  $ curl | sh

Installing node-loggly-bulk

  $ npm install node-loggly-bulk

Run Tests

  $ npm run test

Author: Charlie Robbins

Contributors: Marak Squires, hij1nx, Kord Campbell, Erik Hedenström,

Package Sidebar


npm i node-loggly-bulk

Weekly Downloads






Unpacked Size

29.6 kB

Total Files


Last publish


  • loggly-hoover
  • swi_npm_public