@livy/socket.io-handler

Sends Livy log records to a WebSocket server

Usage no npm install needed!

<script type="module">
  import livySocketIoHandler from 'https://cdn.skypack.dev/@livy/socket.io-handler';
</script>

README

@livy/socket.io-handler

This Livy handler sends log records to a Socket.IO server.

Synchronous logger support: no

Runtime: Node.js and browsers

Basic Example

const { SocketIoHandler } = require('@livy/socket.io-handler')

const handler = new SocketIoHandler('wss://example.com/logs')

Installation

Install it via npm:

npm install @livy/socket.io-handler

Options

The first argument to this handler's constructor contains the Socket.IO endpoint to connect to.

An object of options can be passed 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

connection

Type: object

Default: {}

Description: An object of Socket.IO client initialization options.

level

Type: LogLevel

Default: 'debug'

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

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 Socket.IO connection.

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.

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.