pino-gris

library1.3.1jsnpmunverified

A verbose ndjson log formatter for pino that provides human-readable, timestamped, emoji-leveled output including full object and error details. Current stable version is 1.3.1 (maintenance mode with no recent releases). It differs from pino-colada by printing all log keys not in a predefined ignore list, making error stacks and arbitrary objects visible. Ideal for local development and debugging with pino.

devops

npm install pino-gris

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · PINO-GRIS

pino-gris

devopsjavascriptv1.3.1

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

default

✓ import pinoGris from 'pino-gris'

✗ const pinoGris = require('pino-gris')

Package is ESM-only, CommonJS require not supported without bundler.

PinoGris

✓ import PinoGris from 'pino-gris'

✗ import { PinoGris } from 'pino-gris'

Default export, not a named export.

pino-gris cli

✓ node app.js | npx pino-gris

✗ node app.js | pino-gris

If not installed globally, use npx or install as dev dependency and reference bin.

Shows programmatic pino-gris transport integration and CLI piping for human-readable logs.

// server.js - uses pino with pino-gris formatter import pino from 'pino'; import pinoGris from 'pino-gris'; // programmatic usage const logger = pino({ transport: { target: 'pino-gris' } }); logger.info('Hello, world!'); // CLI usage: node server.js | npx pino-gris

Debug

Known issues

deprecatedpino-gris is in maintenance mode with no active development since 2020.

fix

Consider alternatives like pino-pretty for active maintenance.

affects: >=1.0.0

gotchapino-gris does not support pino v7+ built-in transports natively; use the 'target' option only with pino v7+.

fix

For pino v7+, use pino.transport({ target: 'pino-gris' }) or upgrade to a maintained formatter.

affects: >=1.0.0

breakingDefault export in v1.0.0 was removed; previously named export 'pinoGris' changed to default.

fix

Use default import: import pinoGris from 'pino-gris'.

affects: <1.0.0

gotchaKey filtering: only keys not in internal ignore list are printed; may omit custom properties like 'req' or 'res'.

fix

Ensure custom log keys are not in the pinoKeys ignore list, or fork the package to customize.

affects: >=1.0.0

deprecatedpino-gris relies on deprecated Node.js stream APIs; may break in future Node versions.

fix

Use pino-pretty or other actively maintained formatters that support modern Node.js streams.

affects: >=1.0.0

Errors

Common errors & fixes

SyntaxError: Unexpected token 'export'

Using CommonJS require on an ESM-only package.

fix

Use dynamic import: const pinoGris = await import('pino-gris'); or switch to ESM.

Module not found: Can't resolve 'pino-gris'

Package not installed or misconfigured bundler with ESM.

fix

Run npm install pino-gris --save-dev and configure bundler to handle ESM.

TypeError: pinoGris is not a function

Incorrect import (named instead of default) or using outdated pino v6 transport pattern.

fix

Use import pinoGris from 'pino-gris' and check pino version for transport API.

Error: Cannot find module 'pino-gris'

Global install missing for CLI usage.

fix

Install locally: npm install pino-gris --save-dev and use npx pino-gris.

Upgrade

Version history

1.3.1latest on npm

Audit

Dependencies

pinorequiredproduces ndjson logs that pino-gris consumes

Agent activity

9 hits · last 30 days

node

Amazon

Resources

githubhttps://github.com/ungoldman/pino-gris ↗

packagepino-gris ↗

homepagehttps://github.com/ungoldman/pino-gris#readme ↗