Pino

Common errors

• ERR_WORKER_INVALID_EXEC_ARGV

  cause Using Pino transports in worker threads with specific monitoring tools or `NODE_OPTIONS` preload configurations.
  fix Upgrade to Pino v10.2.1 or newer. Ensure Node.js environment variables (like `NODE_OPTIONS`) are correctly sanitized or avoid conflicting preload settings when using worker-based transports.

• TypeError: Argument of type '...' is not assignable to parameter of type '(...)'

  cause Pino v10.1.0 introduced stricter type definitions for the `censor` function signature, leading to TypeScript compilation errors for older, less safe implementations.
  fix Adjust the signature of your `censor` function to align with the updated, safer types provided by Pino v10.1.0 and later. Consult the Pino redaction documentation for the correct signature.

Warnings

• breaking Pino v10 drops support for Node.js 18.
  Fix: Upgrade your Node.js runtime to version 20 or newer, or stick to Pino v9.x.
• breaking The type signature for the `censor` function used in redaction has been updated for improved safety, potentially causing TypeScript errors or runtime issues if using previous, less safe types.
  Fix: Review and update your `censor` function implementations to match the safer type definitions introduced in v10.1.0. Consult the official Pino redaction documentation for guidance.
• gotcha When using Pino transports in worker threads, certain Node.js monitoring tools or `--import` preload options can lead to `ERR_WORKER_INVALID_EXEC_ARGV` errors or memory leaks.
  Fix: Ensure your Pino version is at least 10.3.1 for fixes related to `NODE_OPTIONS` sanitization and `ERR_WORKER_INVALID_EXEC_ARGV`. Avoid using `--import` preloads with transports if possible, or consult Pino transport documentation for recommended practices.
• gotcha Pino's transport level filtering behavior might not be immediately intuitive. Logs are filtered by the transport's level, not necessarily the parent logger's level.
  Fix: Explicitly configure transport levels if you require specific filtering. Refer to the 'Transports' documentation for detailed examples on level filtering.

Install

• npm install pino npm
• yarn add pino yarn
• pnpm add pino pnpm

Imports

• pino

  import pino from 'pino'

  Pino supports both ESM imports and CommonJS `require()` syntax.

Quickstart

Initializes a Pino logger and demonstrates basic info logging and creating a child logger with additional properties.

import pino from 'pino';

const logger = pino();

logger.info('hello world');

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