Registry / devops / pm2-server-monit

pm2-server-monit

library3.0.0jsnpmunverified

pm2-server-monit is a PM2 module designed to automatically monitor crucial server vital signs, integrating seamlessly into the PM2 ecosystem for process management. It tracks key metrics such as CPU average usage, free and used memory, drive space, network speed (input/output), total opened files, running processes, and active TTY/SSH sessions. The current stable version is 3.0.0. While no explicit release cadence is documented, the jump from v2.0 to v3.0 suggests periodic updates incorporating significant feature enhancements or internal changes. Its primary differentiator is its deep integration with PM2, allowing server monitoring to be managed and viewed alongside application processes, making it particularly useful for environments already leveraging PM2 for their Node.js applications. Unlike standalone monitoring agents, pm2-server-monit leverages the PM2 daemon to collect and report system statistics.

devops observability

npm install pm2-server-monit

github ↗package ↗

INSTALL

IMPORT

SIG · PM2-SERVER-MONIT

pm2-server-monit

devopsjavascriptv3.0.0

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–226 runs

build_error

glibc

node 18–226 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

Installation

✓ pm2 install pm2-server-monit

✗ import pm2ServerMonit from 'pm2-server-monit'

pm2-server-monit is a PM2 module, not a JavaScript library directly imported into application code. Interaction is primarily via the PM2 CLI.

Configuration

✓ pm2 set pm2-server-monit:drive /

✗ const config = require('pm2-server-monit').config;

Module configuration is managed through PM2's `set` command or the PM2 Plus dashboard, not through programmatic access within application code.

Logs and Status

✓ pm2 logs pm2-server-monit

✗ import { getStatus } from 'pm2-server-monit'

Monitor the module's operational status and output via the PM2 CLI logs command, as there is no direct JavaScript API for retrieving metrics from user code.

This quickstart demonstrates how to install the pm2-server-monit module, configure its monitoring parameters, and check its operational logs via the PM2 command-line interface.

# First, ensure PM2 is installed globally if you haven't already npm install -g pm2 # Install the pm2-server-monit module into PM2 pm2 install pm2-server-monit # Configure the module to monitor multiple drives and adjust a refresh rate # Example: monitoring root '/' and a '/data' partition pm2 set pm2-server-monit:drive "/,/data" pm2 set pm2-server-monit:network_refresh_rate 5 # View the status and initial logs of the module to verify operation echo "Waiting a few seconds for initial metrics to be collected..." sleep 5 pm2 logs pm2-server-monit --lines 50 # To view the collected metrics in a dashboard, use PM2 Plus # or other PM2 monitoring tools, as this module feeds data into PM2's ecosystem.

Debug

Known issues

breakingVersion 2.0 introduced significant changes to drive and network monitoring mechanisms. Users upgrading from earlier versions should review their configurations for compatibility and verify expected metric outputs.

fix

Review the module's documentation for updated configuration options related to drive and network monitoring. Verify metrics post-upgrade using `pm2 logs pm2-server-monit`.

affects: >=2.0.0

gotchaConfiguring refresh rates for CPU, memory, disk, and network too low can lead to excessive CPU usage by the monitoring module itself.

fix

Increase `disk_refresh_rate`, `memory_refresh_rate`, `cpu_refresh_rate`, and `network_refresh_rate` values to higher intervals (in seconds) to reduce the monitoring overhead. For example, `pm2 set pm2-server-monit:cpu_refresh_rate 10`.

affects: >=1.0.0

gotchaSome system metrics might not appear in the monitoring output due to platform-specific incompatibilities or internal errors.

fix

Always check the module's logs using `pm2 logs pm2-server-monit` for specific error messages or warnings that might indicate unsupported features or underlying issues on your operating system.

affects: >=1.0.0

Errors

Common errors & fixes

PM2 module consuming excessive CPU

Refresh rates for system metrics (CPU, memory, disk, network) are set too low, causing frequent data collection.

fix

Increase the refresh rate configuration values for `disk_refresh_rate`, `memory_refresh_rate`, `cpu_refresh_rate`, and `network_refresh_rate` using `pm2 set` commands.

Metrics are not displayed or missing from monitoring output

The specific system metric might not be supported on the operating system platform where the module is running, or an internal error occurred during data collection.

fix

Check the module's logs using `pm2 logs pm2-server-monit` for specific error messages or warnings related to the missing metrics to diagnose platform support or runtime issues.

pm2-server-monit: command not found (or similar PM2 module installation error)

PM2 is either not installed globally, or the `pm2 install` command failed due to network issues or permissions.

fix

Ensure PM2 is installed globally (`npm install -g pm2`) and then retry `pm2 install pm2-server-monit`. Check network connectivity and user permissions if the issue persists.

Upgrade

Version history

3.0.0latest on npm

Audit

Dependencies

pm2requiredThis package is a PM2 module and requires PM2 to be installed globally to function.

Agent activity

15 hits · last 30 days

node

OpenAI (training)

Amazon

Resources

githubhttps://github.com/pm2-hive/pm2-server-monit ↗

packagehttps://www.npmjs.com/package/pm2-server-monit ↗