npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

@livy/rotating-file-handler

v1.0.4

Published

Stores Livy log records in rotating files

Downloads

440

Readme

@livy/rotating-file-handler

This Livy handler stores log records to files that are rotated by date/time or file size and only a limited number of files is kept.


Synchronous logger support: yes

Runtime: Node.js


Basic Example

const { RotatingFileHandler } = require('@livy/rotating-file-handler')

const handler = new RotatingFileHandler('logs-%date%.txt')

Installation

Install it via npm:

npm install @livy/rotating-file-handler

Options

The first argument to this handler's constructor is a file path to write to. It needs to contain a token based on the configured strategy.

An object of options can be passed to the constructor as the second argument.

The following options are available:

bubble

Type: boolean

Default: true

Description: Controls whether records handled by this handler should bubble up to other handlers.

See also: Bubbling

formatter

Type: FormatterInterface

Default: new LineFormatter()

Description: The formatter to use.

level

Type: LogLevel

Default: 'debug'

Description: Controls which log records should be handled based on their log level.

maxFiles

Type: number

Default: Infinity

Description: Number of log files to keep at maximum.

strategy

Type: 'max-age' | 'max-size'

Default: 'max-age'

Description: The strategy name:

  • max-age: Separates log files by the date/time attached to log records thus creates a new file every year/month/day/hour/minute. It requires a %date% token in the file name.
  • max-size: Separates log files by the size of the latest log file and thus creates a new file whenever the current file exceeds the size. It requires a %appendix% token in the file name.

threshold

The value this option takes varies based on the strategy option:

Strategy max-age

Type: 'minute' | 'hour' | 'day' | 'month' | 'year'

Default: 'day'

Description: The duration unit that separates individual log files. Using 'day' rotates the log files daily, using 'hour' rotates them every hour etc.

Strategy max-size

Type: number | string

Description: The file size that separates individual log files. May be a plain number of bytes or a file size string like '200 kb', '1.5M' etc.

Public API

bubble

Controls whether records handled by this handler should bubble up to other handlers. Initially set through the bubble option.

See also: Bubbling

close()

This handler implements the ClosableHandlerInterface. On cleanup, it closes the internal file handler.

You usually don't want to call this method manually. It is done automatically when a Node.js process exits / a browser page is closed.

defaultFormatter (read-only)

The formatter used by this handler if no formatter option is set.

formatter

This handler supports formatters by implementing the FormattableHandlerInterface.

level

The minimum log level of a log record to be considered by this handler. Initially set through the level option.

processors

This handler supports processors by implementing the ProcessableHandlerInterface.

reset()

This handler implements the ResettableInterface. Resetting it resets all attached processors.

You usually don't want to call this method manually on an individual handler. Consider calling it on the logger instead.