pino

super fast, all natural json logger

README

banner

pino npm version Build Status js-standard-style


Very low overhead Node.js logger.

Documentation



Install


  1. ```
  2. $ npm install pino
  3. ```

If you would like to install pino v6, refer to https://github.com/pinojs/pino/tree/v6.x.

Usage


  1. ``` js
  2. const logger = require('pino')()

  3. logger.info('hello world')

  4. const child = logger.child({ a: 'property' })
  5. child.info('hello child!')
  6. ```

This produces:

  1. ```
  2. {"level":30,"time":1531171074631,"msg":"hello world","pid":657,"hostname":"Davids-MBP-3.fritz.box"}
  3. {"level":30,"time":1531171082399,"msg":"hello child!","pid":657,"hostname":"Davids-MBP-3.fritz.box","a":"property"}
  4. ```

For using Pino with a web framework see:

[Pino with Node core http](docs/web.md#http)


Essentials


Development Formatting


The [pino-pretty](https://github.com/pinojs/pino-pretty) module can be used to
format logs during development:

pretty demo

Transports & Log Processing


Due to Node's single-threaded event-loop, it's highly recommended that sending,
alert triggering, reformatting, and all forms of log processing
are conducted in a separate process or thread.

In Pino terminology, we call all log processors "transports" and recommend that the
transports be run in a worker thread using our pino.transport API.

For more details see our Transports⇗ document.

Low overhead


Using minimum resources for logging is very important. Log messages
tend to get added over time and this can lead to a throttling effect
on applications – such as reduced requests per second.

In many cases, Pino is over 5x faster than alternatives.

See the Benchmarks document for comparisons.

Bundling support


Pino supports being bundled using tools like webpack or esbuild.

See Bundling document for more information.

The Team


Matteo Collina



David Mark Clements



James Sumners



Thomas Watson Steen



Contributing


Pino is an OPEN Open Source Project. This means that:

Individuals making significant and valuable contributions are given commit-access to the project to contribute as they see fit. This project is more like an open wiki than a standard guarded open source project.


See the CONTRIBUTING.md file for more details.

Acknowledgments


This project was kindly sponsored by nearForm.

Logo and identity designed by Cosmic Fox Design: https://www.behance.net/cosmicfox.

License


Licensed under MIT.

[elasticsearch]: https://www.elastic.co/products/elasticsearch
[kibana]: https://www.elastic.co/products/kibana