• Install dependencies
• Compile
• Compile and run
• Build container image (must have buildah installed)
• Usage
• Examples
• ToDo
• Link:

Install dependencies

• make deps

Compile

• make build

Compile and run

• make run

Build container image (must have buildah installed)

• buildah unshare
• ./build.sh

NOTE: Not sure about "system metrics" when run in container…

Usage

Use metrorama -h to see a list of flags and options.

Once started it can be call on following routes:

• /start: starts the data gathering. Every new start deletes previous collected datas so only one test at the time can be run (by design?).

  Parameters:

  • rate set the gathering interval rate (in ms). Default: 500ms
  • timeout set a timeout to stop gathering data: Default: 10s
  • name set an identifier for the test. Default is autogenerated one.

These parameters can be specified also via CLI options at the server start. In this case minimum rate and maximum timeout are not specified so beware.

HTTP parameters overrides CLI ones (but are restricted to boundaries).

• /stop: stops the data gathering and prints result

• /status: prints the collected results while the test is running or is complete.

  Parameters:

  • format=json: print results in JSON format

Examples

• Start the server with default optiokns: ./metrorama
• Start a simple test with name "sample-test" and a timeout of 20s: curl 'http://localhost:8080/start?name=sample-test&timeout=20'
• Check the ongoing test printing result in JSON format: curl 'http://localhost:8080/status?format=json'

ToDo

• Add other output format
• Add other data gathering types
• Calculate statistics for Disk IO and Network
• Multiple tests (store results of old tests on disk)
• Render simple graphs in web page with RRDTools
• Calculate and optimize footprint

Link:

• https://github.com/mackerelio/go-osstat