@specter-labs/fastify-logger NPM

Fastify Logger

Advanced HTTP request logging plugin for Fastify with support for custom contexts and flexible configuration.

Install

npm i @specter-labs/fastify-logger

Usage

import Fastify from 'fastify'
import logger from '@specter-labs/fastify-logger'

const fastify = Fastify()

// Register the plugin with default options
await fastify.register(logger)

// Or with custom options
await fastify.register(logger, {
  level: 'info',
  prefix: 'api',
  ignoreStatusCodes: [400],
  adapter: {
    log: (message) => console.log(message),
    error: (message) => console.error(message)
  }
})

Options

Option	Default	Description
`level`	`'info'`	The logging level. Can be `'info'` or `'error'`
`prefix`	`undefined`	Optional prefix for log messages
`ignoreStatusCodes`	`[]`	Array of HTTP status codes to ignore
`ignorePaths`	`[]`	Array of URL paths to ignore. If a request URL starts with any of these paths, it won't be logged
`adapter`	`{ log: fastify.log.info, error: fastify.log.error }`	Custom logging adapter implementation
`logRequestPayload`	`false`	When enabled, logs the request payload for error responses

Custom Adapter

You can provide a custom adapter to handle logging:

const customAdapter = {
  log: (message) => {
    // Handle regular logs
  },
  error: (message) => {
    // Handle error logs
  }
}

await fastify.register(logger, { adapter: customAdapter })

Log Format

The plugin logs requests in the following format:

[prefix] timestamp | statusCode | responseTime | ip | method | url

For errors, the error message is appended:

[prefix] timestamp | statusCode | responseTime | ip | method | url | errorMessage

License

Licensed under MIT.

fastify logger plugin

2 months ago

2 months ago

3 months ago

3 months ago