1.0.0 • Published 9 months ago

pm2-log-monitor v1.0.0

Weekly downloads
-
License
ISC
Repository
github
Last release
9 months ago

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.