hyperhealth

Monitor the health of a hyperdrive feed, including peer mirror percentages.


Keywords
dat, hyperdrive, health, peers, download, downloaded, swarm, data package, dataset, replication, synchronization, monitoring, dashboard, network, peer, stats
License
BSD-2-Clause
Install
npm install hyperhealth@3.0.0

Documentation

hyperhealth

Monitor the health of a hyperfeed (hypercore or hyperdrive), including peer count and peer mirror percentages.

Does not actually download any data content, only downloads some of the metadata and monitors the peer feeds.

npm install hyperhealth

Example

var Health = require('hyperhealth')

var health = Health(core)

// Will fire every 1 second
setInterval(function () {
  var data = health.get()
  console.log(data.peers.length, 'total peers')
  console.log(data.length, 'total length')
  console.log(data.byteLength, 'total bytes')
  console.log('Peer 1 Downloaded ' + (data.peers[0].have / data.peers[0].length) * 100 + '%')
}, 1000)

API

health = Health(hypercore-or-hyperdrive, [opts])

Takes a hyperdrive or hypercore instance. Returns an object health.

health.get()

When called will return an object representing the health at a particular state.

Returns:

  • byteLength: Number of total bytes
  • length: Number of total blocks
  • peers: An array of the peers containing id, length, and have

Peer object

  • id: The unique id of the peer, derived from stream.remoteId
  • have: The number of blocks that have been downloaded by peer
  • length: The total number of blocks