Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

pm2-log-monitor

aravindhfinix15ISC1.0.0

npm package to monitor your server pm2 logs on local

pm2, moniter, logs, node

readme

PM2 Log Monitor

PM2 Log Monitor is an npm package that allows you to monitor and view logs from PM2-managed processes using a user-friendly web interface. It enables real-time updates of both standard output and error logs through a web browser.

Installation

To install the package globally, use the following command:

npm install -g pm2-log-monitor

Usage

  1. Import the startLogMonitor function from the package:
const startLogMonitor = require('pm2-log-monitor');
  1. Configure the inputs, authentication options, and other options:
const basicInputs = {
    logFilePath: '/path/to/your/pm2-log-out.log',
    errorLogFilePath: '/path/to/your/pm2-log-error.log',
};

const authOptions = {
    users: { 'admin': 'adminPassword' },
    challenge: true,
    realm: 'Restricted Area',
};

const otherOptions = {
    maxLines: 100,
    port: 8000,
};
  1. Call the startLogMonitor function:
startLogMonitor(basicInputs, authOptions, otherOptions);
  1. Access the log viewer by opening your web browser and navigating to http://localhost:8000.

  2. If authentication is enabled, you'll be prompted to enter a username and password.

  3. The log viewer interface will display real-time logs from the specified log files.

Configuration

You can customize the behavior of the log monitor by providing a configuration object. Here's an example:

const basicInputs = {
    logFilePath: '/path/to/your/pm2-log-out.log',
    errorLogFilePath: '/path/to/your/pm2-log-error.log',
};

const authOptions = {
    users: { 'admin': 'adminPassword' },
    challenge: true,
    realm: 'Restricted Area',
};

const otherOptions = {
    maxLines: 100,
    port: 8000,
};

License

This project is licensed under the MIT License.

Issues and Feedback

If you encounter any issues or have suggestions for improvements, please feel free to open an issue on the GitHub repository.

Contributing

Contributions are welcome! Please fork the repository and submit pull requests.


PM2 Log Monitor is developed by Aravindh. `