Journalctl

This is a module for accessing the all mighty Systemd Journal and its handy dandy key-value store hidden behind every log line. In the background it spawns a journalctl process with the output format json and parses the serialised object stream.

API

Require the module and create a new instance:

const Journalctl = require('@seydx/journalctl');
const journalctl = new Journalctl([opts]);

The optional object opts can have the following properties:

• identifier: Just output logs of the given syslog identifier (or identifier if defined as array) (cf. man journalctl, option '-t')
• unit: Just output logs originated from the given unit file (or files if defined as array) (cf. man journalctl, option '-u')
• filter: An array/string of matches to filter by (cf. man journalctl, matches)

const Journalctl = require('journalctl');

let opts = {
   identifier: ['systemd', 'homebridge'],
   unit: ['homebridge-instances-platform', 'homebridge'],
   filter: ['Stopped Node.js HomeKit Server', 'Started Node.js HomeKit Server']
}

const journalctl = new Journalctl(opts);

journalctl.on('event', (event) => {
   
   console.log(event)
   
});

Event: 'event'

journalctl.on('event', (event) => {});

Is fired on every log event and hands over the object event describing the event. (Oh boy ... so many events in one sentence ...)

Method: stop

journalctl.stop([callback]);

Stops journalctl and calls the optional callback once everything has been killed.

Contributing

This project is forked from @jue89. Only a few improvements have been added so that the module can work with my Homebridge plugin (homebridge-instances-platform)