Progvis NPM | npm.io

ProgVis Node Client

This is the Node client library for ProgVis.

ProgVis is a simple to use tool for instrumenting periodic and long running batch jobs so you can easily track their progress and state.

Screenshot

ProgVis Web UI lets you track current and past jobs, view logs, etc.

Here is a sample screen grab:

Sample Progress Bars

Features

ProgVis lets you...

Track your cron and batch jobs as they run to completion.
Keep records of each run - when they ran, for how long & exit status.
Search/view logs to help with troubleshooting.
Compare to historical stats to spot performance issues.

Installation

Install ProgVis Node Client using npm or yarn.

$ npm install progvis

Then visit ProgVis, register and get a client access token.

Set your client access token as PV_TOKEN environement variable or pass it in as options.token to the ProgVis constructor.

Example Usage

:information_source: if you can't modify your program, you can use ProgVis CLI to track your jobs.

ProgVis API is similar to cli progress tracking libraries. Instead of logging to terminal, it uploads progress data to progvis.io where you can access it.

import ProgVis from "progvis";

async function main() {
  const things = await getThingsToProcess();

  // opts = { token: <ACCESS_TOKEN> }
  const pv = new ProgVis("job_name", things.length, opts);

  while (things.length) {
    const thing = things.shift();
    const result = await process(thing);
    pv.step(1);                // indicate you made some progress
    pv.log({ thing, result }); // optionally log some stuff
  })

  pv.done(); // success OR pv.error(); for failure
}

main();
...

API

new ProgVis(name, expected, options)

Construct a new ProgVis instance.

Param	Type	Default	Description
name	string		A unique, stable name for this job
expected	number		Number of expected steps for this job
options	object
options.collect_argv	boolean	false	Enable collecting argv. :warning: Don't use if args contains sensitive information
options.token	string		API Access Token. Takes precedence over env.PV_TOKEN