tm/php-metrics-monitor

Simple tool to visualize metrics.

php-metrics-monitor

, _(*1)

The metrics-monitor is a simple tool to visualize metrics across various projects. So you can see the trend on one monitor., _(*2)

At the time it can visualize the the following metrics:, _(*3)

• (Line-)Coverage
• to be continued ...

Further metrics are planned. Please look at the roadmap or feel free to contact me., _(*4)

Demo

, _(*5)

Install

As Phar (Recommended for single-user)

You can install the monitor with these two simple commands:, _(*6)

$ curl -OsL https://github.com/tommy-muehle/php-metrics-monitor/releases/download/1.0.0/memo.phar
$ chmod +x memo.phar

The only requirement is PHP >= 5.5.0, _(*7)

From source (Recommended for multi-user)

In case that multiple users want an access to the monitor you should build up from source on an accesssible system. For example you can create a vHost on the Jenkins CI., _(*8)

The requirements are: - PHP >= 5.5.0 - Running webserver such as Apache or nginx, _(*9)

To build the project do the following:, _(*10)

$ git clone https://github.com/tommy-muehle/php-metrics-monitor.git
$ cd php-metrics-monitor
$ composer install --no-dev

After these steps you can play with memo:, _(*11)

$ php ./bin/memo

To build your own phar do this in the project directory:, _(*12)

$ curl -LSs https://box-project.github.io/box2/installer.php | php
$ php box.phar build

Now you can found your own phar in the build directory., _(*13)

Usage

Add entries

To add entries for further visualization run the following command:, _(*14)

$ php memo.phar add path/to/coverage.xml --slug=MYPROJ

The "slug" option are optional. The default is "GENERAL"., _(*15)

This task can also automatically done by a CI system such as Jenkins. Please look at the wiki page to see integration examples., _(*16)

Show diagrams

To visualize the results simple run the following command:, _(*17)

$ php memo.phar run

After this you can access the GUI via browser. By default the address are http://localhost:8000., _(*18)

If you want permanent access to the GUI then take a look at this wiki page., _(*19)

Security

You can download Tommy's public key and verify the signature (memo.phar.sig) of the memo.phar., _(*20)

$ gpg --keyserver hkp://pgp.mit.edu --recv-keys 9BA742C3
$ gpg --verify memo.phar.sig memo.phar

Roadmap

1.1.0 (Planned release in mid-July)

• Add complexity as second diagram option
• Refactor javascript parts

Changelog

[1.0.0]

• Initial release with coverage diagram option

Contributing

Please refer to CONTRIBUTING.md for information on how to contribute., _(*21)