🚧 Vigil Reporter for Node. Used in pair with Vigil, the Microservices Status Page.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.



Build Status Test Coverage NPM Downloads Buy Me A Coffee

Vigil Reporter for Node. Used in pair with Vigil, the Microservices Status Page.

Vigil Reporter is used to actively submit health information to Vigil from your apps. Apps are best monitored via application probes, which are able to report detailed system information such as CPU and RAM load. This lets Vigil show if an application host system is under high load.

🇭🇺 Crafted in Budapest, Hungary.

Who uses it?


👋 You use vigil-reporter and you want to be listed there? Contact me.

How to install?

Include vigil-reporter in your package.json dependencies.

Alternatively, you can run npm install vigil-reporter --save.

How to use?

1. Create reporter

vigil-reporter can be instantiated as such:

var VigilReporter = require("vigil-reporter").VigilReporter;

var vigilReporter = new VigilReporter({
  url        : "https://status.example.com",  // `page_url` from Vigil `config.cfg`
  token      : "YOUR_TOKEN_SECRET",           // `reporter_token` from Vigil `config.cfg`
  probe_id   : "relay",                       // Probe ID containing the parent Node for Replica
  node_id    : "socket-client",               // Node ID containing Replica
  replica_id : "",                // Unique Replica ID for instance (ie. your IP on the LAN)
  interval   : 30,                            // Reporting interval (in seconds; defaults to 30 seconds if not set)
  console    : require("console"),            // Console instance if you need to debug issues

  tuning     : {                              // Optional tuning options
    use_active_memory : false                 // Set to `true` if you want to calculate RAM usage based on "active" instead of default "used"

2. Teardown reporter

If you need to teardown an active reporter, you can use the end() method to unbind it.


What is Vigil?

ℹ️ Wondering what Vigil is? Check out valeriansaliou/vigil.