Instrumentation

Monitor any system stats and process memory usage over time.

gem install process-instrumentation

To monitor a process, get its PID from the system (using ps aux | grep PROCESS_NAME) and start the command:

$ instrument <pid>

Then go to http://localhost:8080 and you'll see the graph of memory usage over time.

Install dependencies with:

bin/setup

Run tests with:

rake test

Run the local binary with:

exe/instrument <pid>

An interactive console with all files loaded is available on:

bin/console

You can generate documentation locally:

rake yard

Then open doc/index.html in your browser.

Bug reports and pull requests are welcome on GitHub at https://github.com/felipeelias/instrumentation. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.

Make sure that the code passes the style guidelines with:

rake rubocop

If you want to contribute with anything but don't know where to start, check the project's to-do list:

• Auto-refresh report (fetch datapoints dynamically)
• Implement Load average reader
• Setup rubocop task
• Implement option parser for command line tool
• Add tests when the interface and functionality is defined
• Implement memory reader for Linux, that reads from /proc/<pid>/statm, example here
• Implement CPU % reader
• Let user customize HTTP server port via command line
• Setup continuous integration
• Setup code climate

The gem is available as open source under the terms of the MIT License.