node package manager
Share your code. npm Orgs help your team discover, share, and reuse code. Create a free org »


oranch Build Status

Log file tracker using in node. Installing and using easily as npm module. npm

Get starting


$ npm install oranch


Create oranch object

To create oranch object, you should give some options as below. Default is cron scheduling.

  • schedule : Oranch read logfile at fixed interval decided by this parameter. Written in crontab format.
  • logfile : Oranch read this file.
  • task : When log matching is induced, this task will be called.
  • jobType : If you want to use watch file API, set watch or with cron scheduler set cron.
  • match : Log matching is conditioned by this regular expression.
  • endMatch : With this options you can finish job when this tag matches
  • offset : If you want to off default already files, oranch starts reading as you like by this offset.
  • onComplete : When oranch stops, this function will be called.

These are all required parameters.

If your tracking is unfrequent, you should use watchFile API in node. watchFile API calls your task funcion in the case of updating logfile. So it will be more efficient unfrequent case.

In order to start tracking log, please call start.


When you want to stop oranch log tracking, call stop.



var Oranch = require('oranch').Oranch;
    var options = {
    'schedule' : '* * * * * *',
    'logfile'  : '/path/to/somelogfile.log',
    'match'    : /WARN/,
    'jobType'  : 'cron',
    'task'     : function (line) {  
        // Write down what you want when WARN log is induced. 
    'onComplete' : function () {
        // Write down what you want when Oranch stops 
var oranch = new Oranch(options);


MIT License