Memeye
Introduction
Memeye is a lightweight NodeJS process monitoring tool that provides data visualization of process memory, V8 heap space memory, and operating system memory.
The front part, with Vue2 and ChartJS, provides a nice dynamic dashboard.
Memeye in the host process, only the implantation of a simple data collector, the other work is to start a child-process, by the child-process to carry out.
This will minimize the impact of Memeye's code on the host process to ensure the authenticity of the data.
Feature
- Lightweight
- Simple
- For development
- Visualization
Note: Memeye only support a single process, NodeJS distributed process is not applicable, it is not recommended in the product environment。
Motivation
As we all know, NodeJS is very sensitive to memory.
In April last year I used NodeJS to build a marketing project, on the day of project online PV broke one million.
Which is showing a continuous upward trend in memory, in the process of troubleshooting problems, i want to find a lightweight, as long as the visual display of the use of memory tools, but no result.
Then there is the idea of this project, but at that time because of the busy only made a simple Demo to use (Memeye v0.0.3).
Recently there is time, once again turned out to reorganize and revision, add more type of the data display.
Demo
Compatibility
- Node v7.x
- Node v6.x
Install & Usage
For install simply run :
npm install memeye --save-dev
Then require it in your nodejs application
const memeye = require('memeye');
memeye();
Then open your browser and load address:
http://localhost:23333 //23333 port by default.
That's it! No more options, no more config, just so easy.
How it works
Memeye has three core concept: Collector, Indicator and Dashboard.
While Collector runing in your nodejs process, Indicators and Dashboard runing on the child-process, in this way Memeye will make as little influence as possible to your nodejs process.
Collector
Collector will wathching and collecting data from the host node process、v8 heap and operrating system ，then send the datas to dashboard process with IPC communication channel.
Indicator
Indicator like a state machine . When attribute changed, the instance of Indicator will emit an event. So we can use it to handle our indicators data of process, v8 heap and OS.
Dashboard
The dashboard , will calling at the child process way. It will create an Indicator instance and start a http server which provide a socket.io instance.
Then bind the indicator with process IPC channel, to recive massage from parent process.
And then bind the indicator with socket.io, to send messages while indicator attrbutes changed.
The commication between Collector, Indicator and Dashboard
Test
Simply run:
npm test
Some feature may be
- Mutil process support
- Report export
License
Copyright (c) 2016-2017 JerryC