Elasticman: An elasticsearch monitoring and alerting tool

The elastiman constantly monitors the your elasticsearch cluster's health by checking the following:

1. It checks the overall clusters health as if any of the node left the cluster or any shard is not avaliable.

2. It checks over all the nodes present in the cluster following parameters:
   • CPU usage Alert
   • Memory usage alert
   • Disk space usage for all mounts on perticular node
   • Swap Memory alert
   • Open File Descriptors alert
   • Heap usage alert
   

Currenty Elasticman supports mail and slack integrations.

Usage:

Install the package npm:

1npm i elasticman -g

Then, create a file called config.js and paste the following inside it:

1module.exports = {
2    // Elasticsearch Cluster Nodes uri's
3    nodes: [
4        'http://localhost:9200'
5    ],
6    // Number of seconds to wait in between health checks
7    interval: 30,
8    // Alerting CPU usage in percent
9    maxCpuUsage: 50,
10    // Cutoff Nodes memory in percentage
11    maxAvailableMemoryInUse: 60,
12    // Alerting data space in percentage (will calculate for all the mount storages)
13    maxDataSpaceInUse: 80,
14    // alerting OS swap memory in percentage
15    maxSwapMemory: 50,
16    // alerting open file descriptors in percentage
17    maxOpenFileDescriptors: 80,
18    // Alerting jvm heap size in percentage
19    maxHeapUsed: 80,
20    // SMTP configuration for sending alert e-mails (delete to disable)
21    smtp: {
22        host: 'smtp.gmail.com',
23        port: 465,
24        secure: true,
25        auth: {
26            user: 'username@gmail.com',
27            pass: 'password'
28        },
29        address: 'username@gmail.com'
30    },
31    // Slack configuration for sending alert messages through webhook (delete to disable)
32    slack: {
33        channelUrl: 'https://hooks.slack.com/services/xxx/xxx/xxx',
34        notifyMembers: ['gurbaj', 'singh'] // enter slack user names here
35    }
36};

Modify the configuration file according to your need:

• smtp (optional) - the SMTP e-mail configuration for sending alerts (using Gmail, AWS SES, etc) • slack (optional) - the Slack webhook configuration for sending alert messages

Test the SMTP configuration by running:

1elasticman --test-email

Test the Slack configuration by running:

1elasticman --test-slack

Finally run elasticman from the same directory as your config.js or you can also provide the confing file's path by running the command elasticman -c <path to the config file>

If you want to keep your process running uninterrupted (recommended), it is advisable to use a process manager like PM2 or forever.

License

Apache 2.0