A simple prettifier for pino with built-in support for common ecosystem packages. Designed to be clear, unintrusive and to the point with sensible defaults optimized for use during development.
Is your favorite pino package not yet supported? Request support here.
Discovered a problem with pino-dev? Report an issue.
Install using one of the commands below
npm install --save-dev pino-dev
yarn add --dev pino-dev
then pipe the output of your pino
-enhanced app to the pino-dev
cli
./start-your-app | pino-dev
Often it's convenient to add this to your package.json scripts to not have to remember it.
{
"scripts": {
"dev": "./start-your-app | pino-dev"
}
}
In some situations using npx
can also be really convenient:
yarn start | npx pino-dev
Configuration is preferably stored as a pino-dev.config.json
or pino-dev.config.js
file at the root of your repo. It's also possible to use a "pino-dev": {...}
key in your package.json
.
{
"newline": "\n",
"timeFormat": "HH:mm:ss.SSS",
"propertyMap": {
"msg": "msg",
"level": "level",
"ns": "ns",
"name": "name",
"stack": "stack",
"time": "time",
"req.method": "req.method",
"req.url": "req.url",
"res.statusCode": "res.statusCode",
"responseTime": "responseTime"
}
}
The newline character used in prettified output. Usually dependent on your operating system, it's either "\n" (default) or "\r\n".
The time format to use (syntax according to https://www.npmjs.com/package/date-fns).
This configuration allows you to map arbitrary incoming properties to semantic pino-dev properties using json. For instance,
echo '{"message": "foobar"}' | pino-dev --property-map '{"msg": "message"}'
would map the message
property in the incoming json to the semantic property msg
which enables pino-dev
to understand how to format the log. For deep properties it's possible to use dot-notation, and mapping to a boolean false
will disable the default mapping (e.g. pino-dev --property-map '{"name": false}'
won't display the name in the prettified output).
It's also possible to specify/override configuration with command-line arguments:
Usage: pino-dev [options]
--, --color Force color.
-h, --help Output usage information
-n, --newline The newline character used in prettified output. Either "\n" (default) or "\r\n".
--, --no-color Force no color.
-m, --property-map Map arbitrary incoming properties to semantic pino-dev properties using json.
-t, --time-format The time format to use (syntax according to https://www.npmjs.com/package/date-fns).
-v, --version Output the version number