README

MTR Batch processing storing in database with dashboard

OUTLINE

Demonstration
Introduction
Requirements
Installation
- Download
- Startup
Usage
- Launch
- Purge
- Dashboard
References

DEMONSTRATION

INTRODUCTION

REQUIREMENTS

This library requires the following:

MTR library (CLI) 0.9+
PHP 5.4.0+|7.0+

INSTALLATION

Download

Composer Installation

Using Composer to install is the easiest way with auto-installer:

composer create-project --prefer-dist yidas/mtr-database

Wget Installation

You could see Release for picking up the package with version, for example:

$ wget https://github.com/yidas/mtr-database-php/archive/master.tar.gz -O mtr-database-phpi.tar.gz

After download, uncompress the package:

$ tar -zxvf mtr-database-php.tar.gz

Startup

Database Setup

After the download, you could start to set up the config.inc.php with your database connection:

...
    'database' => [
        'host' => '',
        'driver'    => 'mysql',
        'database'  => 'mtr_database',
        'username'  => '',
        'password'  => '',
        'table' => 'records',
        'charset'   => 'utf8',
        'collation' => 'utf8_unicode_ci',
    ],
...

Then run install.php which will help you to install the database & table:

$ php install.php
Installation completed

Agent Launch

After the installation, enjoy to run or set launch.php with your prefered arguments in crontab:

$php launch.php
Process success

Set crontab into /etc/cron.d/mtr-database:

# Launch and record MTR every 10 miniutes by default
*/10 * * * * root php /var/www/html/mtr-database/launch.php >/dev/null 2>&1

# Purge data before 90 days by default (Optional)
00 00 * * * root php /var/www/html/mtr-database/purge.php >/dev/null 2>&1

The default batch period is configured to be 10 minutes, so we can set the batch to be executed every 10 minutes.

USAGE

Launch

The configuration file config.inc.php allows you to set the default settings for MTR launching. However, you can also specify parameters immediately in the command to be run.

Host

Host parameter allows you to specify the target host to be tracked with -h --host parameter:

php launch.php --host="yourhost.local"

Period

Period argument allocate the number of minutes between crontab intervals with -p --period parameter:

# Launch and record MTR every 5 miniutes
*/5 * * * * root php /var/www/html/mtr-database/launch.php --period=5 >/dev/null 2>&1

In addition, Count argument will distribute the sending count between the interval according to the Period setting with -c --report-cycles parameter:

# Launch and record MTR every 1 miniutes, and each report will send 10 count (send every 6 seconds)
*/1 * * * * root php /var/www/html/mtr-database/launch.php --period=1 --report-cycles=10 >/dev/null 2>&1

TCP

TCP argument allows you to use MTR TCP mode with specified port, -T --tcp for enabling TCP mode and -P --port for setting port:

php launch.php --tcp -port=443

Purge

Running purge.php will delete old records older than the given number of days. You can use the -d --days parameter to set with (default is 90 days):

00 00 * * * root php /var/www/html/mtr-database/purge.php --days=30 >/dev/null 2>&1

Dashboard

The endpoint of MTR Dashboard is /index.php and it's enabled by default, you could place the project in the web path such as /var/www/html/mtr-database/index.php.

For the authentication, you could easily set the username and password in config.ini.php:

...
    'dashboard' => [
        'enable' => true,
        'username' => '',
        'password' => '',
        'categories' => [''],   // Category list for selection
    ],
...

categories will enable you to query specific data by category settings or query all data with default blank values.

REFERENCES

MTR - Github

yidas / mtr-database

Maintainers

Details