Repository files navigation

Very low overhead JavaScript logger.

• Benchmarks ⇗
• API ⇗
• Browser API ⇗
• Redaction ⇗
• Child Loggers ⇗
• Transports ⇗
• Diagnostics ⇗
• Web Frameworks ⇗
• Pretty Printing ⇗
• Asynchronous Logging ⇗
• Ecosystem ⇗
• Help ⇗
• Long Term Support Policy ⇗

Pino is built to run onNode.js.

Pino works onBare with thepino-bare compatability module.

Pino works onPear, which is built onBare, with thepino-bare compatibility module.

Using NPM:

$ npm install pino

Using YARN:

$ yarn add pino

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

constlogger=require('pino')()logger.info('hello world')constchild=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"}{"level":30,"time":1531171082399,"msg":"hello child!","pid":657,"hostname":"Davids-MBP-3.fritz.box","a":"property"}

For using Pino with a web framework see:

• Pino with Fastify
• Pino with Express
• Pino with Hapi
• Pino with Restify
• Pino with Koa
• Pino with Node corehttp
• Pino with Nest
• Pino with Hono

Thepino-pretty module can be used toformat logs during development:

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

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

For more details see ourTransports⇗ document.

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

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

See theBenchmarks document for comparisons.

Pino supports being bundled using tools like webpack or esbuild.

SeeBundling document for more information.

https://github.com/mcollina

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

https://twitter.com/matteocollina

https://github.com/davidmarkclements

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

https://twitter.com/davidmarkclem

https://github.com/jsumners

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

https://twitter.com/jsumners79

https://github.com/watson

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

https://twitter.com/wa7son

Pino is anOPEN 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 theCONTRIBUTING.md file for more details.

This project was kindly sponsored bynearForm.This project is kindly sponsored byPlatformatic.

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

Licensed underMIT.