Skip to content
Plugin that handles logs from Kuzzle
Branch: master
Clone or download
scottinet Merge pull request #29 from kuzzleio/2.0.12-proposal
# [2.0.12]( (2019-02-21)

#### Bug fixes

- [ [#28](#28) ] Properly handle plain Error objects   ([scottinet](
Latest commit 034ab63 Feb 21, 2019

Build Status

Kuzzle logger plugin

This plugin is a bridge between Kuzzle and winston package. It is part of the default plugins provided with Kuzzle.

Currently, three winston transports are supported:

  • stdout (winston Console)
  • file (winston File)
  • syslog (from winston-syslog)


Each transport can be added and configured by adding it to the services entry.

The content of this section is almost passed as-is to winston related transport constructor.

The only exception is addDate and dateFormat parameters, which are specific to Kuzzle and allow to specify a custom date format using only plain-text configuration, using moment format.

⚠️ Contrary to winston, it is not possible to pass a function to any option.


  "threads": 2,
  "services": {
    "file": {
      "level": "warn",
      "filename": "kuzzle.log",
      "addDate": true,
      "dateFormat": "dddd, MMMM Do YYYY, h:mm:ss a"
    "stdout": {
      "level": "info",
      "addDate": "true"
    "syslog": {
      "protocol": "unix",
      "path": "/dev/log",
      "facility": "local6"

Default configuration

If no configuration is given, this plugin will output logs to the console only, from info level and above.

Transports configuration references

Date formatting

Native winston date related/timestamp configurations are merged during the plugin init for transports that support it.

In other words, timestamp and addDate can be used indifferently for stdout and file transports:

  "services": {
    "stdout": {
      "timestamp": true,
      "dateFormat": "YYYY-MM-DD HH-mm-ss"

How to create a plugin

Please refer to Kuzzle plugin documentation for more information on how to build you own plugins.

About Kuzzle

Kuzzle is an open-source back-end solution for various applications.

It combines a high level API, a database, a real-time engine, subscription and notification mechanisms as well as some advanced search features. The API is accessible through several standard protocols.

You can’t perform that action at this time.