Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/lrlna/pino-colada
cute ndjson formatter for pino 🌲🍹
https://github.com/lrlna/pino-colada
emoji logger ndjson node
Last synced: about 1 month ago
JSON representation
cute ndjson formatter for pino 🌲🍹
- Host: GitHub
- URL: https://github.com/lrlna/pino-colada
- Owner: lrlna
- License: mit
- Created: 2017-02-19T22:58:58.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2022-05-22T14:32:40.000Z (over 2 years ago)
- Last Synced: 2024-07-23T01:11:45.800Z (about 2 months ago)
- Topics: emoji, logger, ndjson, node
- Language: JavaScript
- Homepage:
- Size: 1.11 MB
- Stars: 243
- Watchers: 3
- Forks: 46
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# pino-colada 🍹
[![npm version][1]][2] [![build status][3]][4]
[![downloads][5]][6] [![js-standard-style][7]][8]
A cute [ndjson](http://ndjson.org) formatter for [pino](https://github.com/pinojs/pino).
# Usage
Pipe a server that uses pino into pino-colada for logging.
```bash
node server.js | pino-colada
```
## pino-colada
After parsing input from `server.js`, pino-colada returns a stream and pipes it
over to `process.stdout`. It will output a timestamp, a log level in a form of
an emoji, and a message.
### Usage as [pino prettifier](http://getpino.io/#/docs/pretty?id=api-example)
```javascript
const pino = require('pino')
const logger = pino({
prettyPrint: {},
prettifier: require('pino-colada')
})
logger.info('hi')
```
## Log Output Format
pino-colada has a few special-case formatting modes that are enabled by passing
certain keys into pino when the data is logged. Errors, for instance, should
print out the error message and the stack trace. But not all errors will contain
the appropriate keys (such as an error return from a promise).
Below is an example log message to demonstrate how pino-colada processes the
data:
```bash
10:01:31 🚨 MyNamespace MyFunction Encountered an internal server error GET 500 /test 230B 45ms
Error: Mock Error message triggered.
at testHandler (/home/user/index.js:175:20)
at /home/user/index.js:398:11
at processTicksAndRejections (node:internal/process/task_queues:96:5)
{
"err": {
"msg": "Mock Error message triggered."
}
}
```
Given the following pino log,
```bash
{"level":30,"time":1639403408545,"pid":37661,"hostname":"Irinas-MacBook-Pro.local","name":"http","message":"response","method":"GET","url":"/error","statusCode":500,"elapsed":3,"contentLength":0,"v":1}
```
`pino-colada` produces the following output:
```
14:46:04 ✨ http --> GET 500 /error 0B 3ms
```
The output corresponds to pino's ndjson. Here are is an annotated explanation of how `pino-colada` formats the logs:
```
14:46:04 ✨ http --> GET 500 /error 0B 3ms
┬ ─┬─ ─┬─ ─┬─ ─┬─ ───┬── ┬ ─┬─
| | | | | | | |
────┬─── | | | | | | | |
╰── "time" | | | | | |
| | | | | | | |
╰── "level" | | | | |
| | | | | | |
╰── "name" | | | |
| | | | | |
╰── "message" | | |
| | | | |
╰── "method" | |
| | | |
╰── "statusCode"
| | |
╰── "url"
| |
╰── "contentLength"
╰── "elapsed"/"responseTime"
```
A few notes on the formatting:
- We use these emojis to represent the `"level"`:
* level 10, trace: '🔍'
* level 20, debug: '🐛',
* level 30, info: '✨',
* level 40, warn: '⚠️',
* level 50, error: '🚨',
* level 60, fatal: '💀'.
- If the `"message"` value is `request` or `response`, we convert it to `<--` and `-->` respectively.
- If `"stack"` property is present, `pino-colada` will print the stack trace following the formatted error log.
# Install
```bash
npm install pino-colada
```
# Related content
- [pino](https://github.com/pinojs/pino)
- [merry](https://github.com/shipharbor/merry)
- [garnish](https://github.com/mattdesl/garnish)
- [@studio/log](https://github.com/javascript-studio/studio-log)
- [pino-http](https://github.com/pinojs/pino-http)
- [hapi-pino](https://github.com/pinojs/hapi-pino)
## License
[MIT](https://tldrlegal.com/license/mit-license)
[1]: https://img.shields.io/npm/v/pino-colada.svg?style=flat-square
[2]: https://npmjs.org/package/pino-colada
[3]: https://img.shields.io/travis/lrlna/pino-colada/master.svg?style=flat-square
[4]: https://travis-ci.org/lrlna/pino-colada
[5]: http://img.shields.io/npm/dm/pino-colada.svg?style=flat-square
[6]: https://npmjs.org/package/pino-colada
[7]: https://img.shields.io/badge/code%20style-standard-brightgreen.svg?style=flat-square
[8]: https://github.com/feross/standard