librato-pm2 v1.0.0
librato-pm2
librato-pm2 is a tiny node application to feed process metrics from PM2 into librato.com.
##Installation
Install the executable with npm:
npm install -g librato-pm2
Create a .librato-pm2rc
file in your home directory (or the directory of the user that PM2 processes run as) containing the following JSON:
{
"email": "YOUR LIBRATO EMAIL ADDRESS",
"token": "YOUR LIBRATO API ACCESS TOKEN"
}
You can obtain the access token from the Account Settings > API Access Tokens page
Finally, add librato-pm2 to your PM2 process stack.
pm2 start librato-pm2
Within a few moments you will see new metrics on your librato account for every process currently managed by PM2, named with a prefix followed by the process name in PM2 and the metric available.
The following metrics are supplied:
cpu
: CPU usage in percentage from 0 to 100.memory
: Memory usage in bytes.online
: Boolean 0 or 1 for if the process is running.restarts
: Total crashes recorded by PM2.uptime
: Time in seconds since the process was last started (Float).
##Options
In addition to the email
and token
values on the configuration file, you can provide the following options:
interval
: Time, in seconds, that the metrics will be polled and submitted. Default is 10
.
metricPrefix
: String used to prefix every metric name. Default is "pm2."
Additionally, the config file itself may be installed in any of the locations supported by the rc
library.
10 years ago