Sign Up for Free

RunKit +

Try any Node.js package right in your browser

This is a playground to test code. It runs a full Node.js environment and already has all of npm’s 1,000,000+ packages pre-installed, including resitail with all npm packages installed. Try it out:

var resitail = require("resitail")

This service is provided by RunKit and is not affiliated with npm, Inc or the package authors.

resitail v1.5.3

Stream your residue server logs using hooks

Resitail

Version Apache 2.0 license

Donate

Stream residue server logs via various hooks

Quick start

  • npm install -g resitail
  • sudo resitail --config <config>

Notice the sudo, this is because all the files written by residue server will need sudo access as they may be owned by one user or another with limited permissions. Resitail needs to be able to read all of these log files.

Configuration

A configuration file looks like:

{
    "residue_config" : "<residue-config>",
    "hooks": [
    ... <see Connecting Hooks section below>
    ]
}

Creating Hook

Hook is essentially a JS module with following minimal requirements

  • A class with options constructor
  • A send function with data parameter.
  • Export this class

Once connected resitail will use this send function to send the logs

A most commonly used hook is resitail-f. It is even used in production servers for muflihun.com

Example:

"use strict";

function sampleHook (options) {
    this.options = options;

    this.send = (data) => {
        console.log(data);
    }
}

module.exports = (options) => new sampleHook(options);

Data contains following properties:

PropertyDescription
eventEvent name (i.e, resitail:line, resitail:err)
event_typeType of event (i.e, info, error)
lineContents of event (either log line or error details etc)
channelType of channel (i.e, client or logger)
channel_nameName of channel (i.e, client_id or logger_id)
logger_idLogger ID if channel is client
client_idClient ID if channel is logger

Connecting Hook

Once hook is ready you can connect it by adding it to configuration.

{
    "name": "<hook name>",
    <path or package>
    "enabled": false,
    "config": {
        "channels" : {
            "to_client" : true,
            "to_logger" : true
        }
        ... more configs specific to hook
    }
}

A fully working hook configuration looks like:

From registry (notice package and version):

{
    "name": "resitail-f",
    "package": "resitail-f",
    "version": "latest"
    "enabled": true,
    "config": {
        "channels" : {
            "to_client" : true,
            "to_logger" : true
        }
        port: 3000
    }
}

This will install the package globally.

Local (notice path):

{
    "name": "resitail-f",
    "path": "../resitail-f",
    "enabled": true,
    "config": {
        "channels" : {
            "to_client" : true,
            "to_logger" : true
        }
        port: 3000
    }
}

Notes

License

Copyright 2017-present Zuhd Web Services
Copyright 2017-present @abumusamq

https://github.com/zuhd-org/
https://muflihun.com/
https://zuhd.org

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

Metadata

RunKit is a free, in-browser JavaScript dev environment for prototyping Node.js code, with every npm package installed. Sign up to share your code.
Sign Up for Free