softius/jenkins-job-monitor

Monitor non-interactive execution of processes including Symfony Commands, cron jobs, procmail and inetd-launched processes

Jenkins job monitor

![Software License][ico-license] ![Coverage Status][ico-scrutinizer] ![Total Downloads][ico-downloads], _(*1)

Jenkins is useful for monitoring the non-interactive execution of processes, such as cron jobs, procmail, inetd-launched processes. This library facilates Jenkins integration for PHP projects and processes running in a PHP environment., _(*2)

Monitoring external jobs in Jenkins, _(*3)

Install

Via Composer, _(*4)

``` bash $ composer require softius/jenkins-job-monitor, <sub>(*5)</sub>

## Usage

### Monitor a process

A process result can be submitted using the command `jenkins-job-monitor monitor` as indicated below.

``` bash
jenkins-job-monitor monitor http://acme.org/jenkins jobName 'ls -lah'

Submit a process result

A process result can be submitted using the command jenkins-job-monitor push. This approach is only useful when the process output and total execution are already available and it's only necessary to push the data to Jenkins., <sub>(*6)</sub>

``` bash jenkins-job-monitor push http://acme.org/jenkins jobName --log "Command results" --duration 5, <sub>(*7)</sub>

Large log results can be transported through pipe as shown below.

``` bash
cat results.txt | jenkins-job-monitor push http://acme.org/jenkins jobName --duration 5

Testing

bash $ composer test, <sub>(*8)</sub>

Security

If you discover any security related issues, please email softius@gmail.com instead of using the issue tracker., <sub>(*9)</sub>

Credits

• Iacovos Constantinou
• All Contributors

License

The MIT License (MIT). Please see License File for more information., <sub>(*10)</sub>