@opentelemetry/host-metrics

What is @opentelemetry/host-metrics?

@opentelemetry/host-metrics is a package that provides metrics related to the host system, such as CPU and memory usage. It is part of the OpenTelemetry project, which is a set of APIs, libraries, agents, and instrumentation to provide observability for cloud-native software.

What are @opentelemetry/host-metrics's main functionalities?

Collect CPU Usage Metrics

This feature allows you to collect CPU usage metrics from the host system. The code sample demonstrates how to initialize the HostMetrics class and start collecting metrics using a MeterProvider.

const { HostMetrics } = require('@opentelemetry/host-metrics');
const { MeterProvider } = require('@opentelemetry/sdk-metrics-base');

const meterProvider = new MeterProvider();
const hostMetrics = new HostMetrics({ meterProvider });

hostMetrics.start();

// The metrics will be collected and can be exported using an exporter.

Collect Memory Usage Metrics

This feature allows you to collect memory usage metrics from the host system. The code sample shows how to set up the HostMetrics to start collecting memory metrics using a MeterProvider.

const { HostMetrics } = require('@opentelemetry/host-metrics');
const { MeterProvider } = require('@opentelemetry/sdk-metrics-base');

const meterProvider = new MeterProvider();
const hostMetrics = new HostMetrics({ meterProvider });

hostMetrics.start();

// Memory usage metrics will be collected and can be exported using an exporter.

Other packages similar to @opentelemetry/host-metrics

prom-client

prom-client is a Prometheus client for Node.js that can be used to collect various metrics, including host metrics. It provides a flexible way to define custom metrics and export them to a Prometheus server. Compared to @opentelemetry/host-metrics, prom-client is more focused on integration with Prometheus and offers a broader range of metric types.

node-os-utils

node-os-utils is a utility library for Node.js that provides functions to get system and OS-related metrics, such as CPU, memory, and disk usage. It is simpler and more lightweight compared to @opentelemetry/host-metrics, but it does not integrate with the OpenTelemetry ecosystem for observability.

README

OpenTelemetry Host Metrics for Node.js

This module provides automatic collection of Host Metrics which includes metrics for:

• CPU
• Memory
• Network

Compatible with OpenTelemetry JS API and SDK 1.0+.

Installation

npm install --save @opentelemetry/host-metrics

Usage

const { MeterProvider } = require('@opentelemetry/sdk-metrics');
const { HostMetrics } = require('@opentelemetry/host-metrics');
const { PrometheusExporter } = require('@opentelemetry/exporter-prometheus');

const exporter = new PrometheusExporter(
  {
    startServer: true
  }, () => {
    console.log('prometheus scrape endpoint: http://localhost:9464/metrics')
  }
);

const meterProvider = new MeterProvider();
meterProvider.addMetricReader(exporter);

const hostMetrics = new HostMetrics({ meterProvider, name: 'example-host-metrics' });
hostMetrics.start();

Useful links

• For more information on OpenTelemetry, visit: https://opentelemetry.io/
• For more about OpenTelemetry JavaScript: https://github.com/open-telemetry/opentelemetry-js
• For help or feedback on this project, join us in GitHub Discussions

License

APACHE 2.0 - See LICENSE for more information.