🌲 super fast, all natural json logger 🌲
Перейти к файлу
zhany 87f7b25ff3 Change the timestamp field name to @time 2019-07-22 19:13:35 +08:00
benchmarks Updated to standard v13 (#683) 2019-07-17 15:09:01 +02:00
docs Remove note about fastify v2 and link to right doc (#678) 2019-07-08 07:51:11 +02:00
docsify destination reopening docs (#462) 2018-07-25 16:39:06 -07:00
lib Change the timestamp field name to @time 2019-07-22 19:13:35 +08:00
test Updated to standard v13 (#683) 2019-07-17 15:09:01 +02:00
.gitignore Ignored both yarn and npm@5 lock files. 2017-05-29 17:22:53 +02:00
.nojekyll Basic docsify support. 2017-07-23 14:51:40 +02:00
.travis.yml Added Node v11 to .travis.yml 2018-10-31 08:35:33 +00:00
CNAME Create CNAME 2018-05-06 14:44:10 -04:00
CONTRIBUTING.md Pino version of OOS. 2016-11-13 21:40:01 +01:00
LICENSE update to 2019 2019-06-09 20:42:40 +02:00
README.md Switch DefinitelyTyped badge URL to https 2019-02-25 15:10:41 +01:00
bin.js tests: test param lambdas, destructure t, switch to end always, tweaks 2018-06-15 17:53:15 +02:00
browser.js Updated to standard v13 (#683) 2019-07-17 15:09:01 +02:00
example.js Correctly assemble the message when errors are present (#501) 2018-08-24 13:31:43 +02:00
index.html v5 docs 2018-07-11 01:48:56 +02:00
package.json Bumped v5.13.0. 2019-07-17 15:10:40 +02:00
pino-banner.png Added banner for the README. 2016-07-25 09:41:47 -07:00
pino-logo-hire.png Added logo as well. 2016-07-25 09:46:18 -07:00
pino-tree.png v5 docs 2018-07-11 01:48:56 +02:00
pino.js more careful timestamp extraction (#675) 2019-07-17 13:04:24 +02:00
pretty-demo.png CLI revamp (#386) 2018-04-13 08:11:40 -04:00

README.md

banner

pino  Build Status Coverage Status js-standard-style TypeScript definitions on DefinitelyTyped

Very low overhead Node.js logger, inspired by Bunyan.

Documentation

Install

$ npm install pino

Usage

const logger = require('pino')()

logger.info('hello world')

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

This produces:

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

For using Pino with a web framework see:

Essentials

Development Formatting

The 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 is conducted in a separate process. In Pino parlance we call all log processors "transports", and recommend that the transports be run as separate processes, piping the stdout of the application to the stdin of the transport.

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.

The Team

Matteo Collina

https://github.com/pinojs

https://www.npmjs.com/~matteo.collina

https://twitter.com/matteocollina

David Mark Clements

https://github.com/davidmarkclements

https://www.npmjs.com/~davidmarkclements

https://twitter.com/davidmarkclem

James Sumners

https://github.com/jsumners

https://www.npmjs.com/~jsumners

https://twitter.com/jsumners79

Thomas Watson Steen

https://github.com/watson

https://www.npmjs.com/~watson

https://twitter.com/wa7son

Communication

Chat on Gitter

https://gitter.im/pinojs/pino

Chat on IRC

You'll find an active group of Pino users in the #pinojs channel on Freenode, including some of the contributors to this project.

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.

Acknowledgements

This project was kindly sponsored by nearForm.

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

License

Licensed under MIT.