lisk-plugin-health

Lightweight plugin for Lisk health check

Usage no npm install needed!

<script type="module">
  import liskPluginHealth from 'https://cdn.skypack.dev/lisk-plugin-health';
</script>

README

Lisk Plugin Health

npm

Installation

npm install lisk-plugin-health
# or
yarn add lisk-plugin-health

Getting started

// src/application/index.js

import { HealthPlugin } from 'lisk-plugin-health';

app.registerPlugin(HealthPlugin);

Usage

To check the health of the app, just run.

// Use the params as configured, see below
const isHealthy = await this._client.invoke('health:isHealthy');
// or set a custom delay (default is 12000)
const isHealthy = await this._client.invoke('health:isHealthy', {
  delayUntilUnhealthy: 15000,
});

It will return 0 if the app is healthy, 1 if there is an issue

Configuration

The app is considered healthy if it registered a block recently. You can configure the delay before the app is considered unhealthy. The unit is milliseconds.

// src/application/index.js

const appConfig = utils.objects.mergeDeep({}, configDevnet, {
  plugins:  {
    health: {
      delayUntilUnhealthy: 15000 // default 12000
    }
  },
});

const app = Application.defaultApplication(genesisBlockDevnet, appConfig);