Collect libp2p metrics for scraping by Prometheus or Graphana

• Install
• Usage
  • Queries
    • Data sent/received
    • CPU usage
    • Memory usage
    • DHT query time
    • TCP transport dialer errors
• API Docs
• License
• Contribution

$ npm i @libp2p/prometheus-metrics

Configure your libp2p node with Prometheus metrics:

import { createLibp2p } from 'libp2p'
import { prometheusMetrics } from '@libp2p/prometheus-metrics'
const node = await createLibp2p({
  metrics: prometheusMetrics()
})

Then use the prom-client module to supply metrics to the Prometheus/Graphana client using your http framework:

import client from 'prom-client'
async handler (request, h) {
  return h.response(await client.register.metrics())
    .type(client.register.contentType)
}

All Prometheus metrics are global so there's no other work required to extract them.

Some useful queries are:

rate(libp2p_data_transfer_bytes_total[30s])

rate(process_cpu_user_seconds_total[30s]) * 100

nodejs_memory_usage_bytes

libp2p_kad_dht_wan_query_time_seconds

or

libp2p_kad_dht_lan_query_time_seconds

rate(libp2p_tcp_dialer_errors_total[30s])

• https://libp2p.github.io/js-libp2p-prometheus-metrics

Licensed under either of

• Apache 2.0, (LICENSE-APACHE / https://www.apache.org/licenses/LICENSE-2.0)
• MIT (LICENSE-MIT / https://opensource.org/licenses/MIT)

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.