softius/jenkins-job-monitor

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

1.0.0 2016-09-28 11:25 UTC

This package is auto-updated.

Last update: 2024-11-14 04:21:40 UTC


README

Latest Version on Packagist Software License Build Status Coverage Status Quality Score Total Downloads

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.

Monitoring external jobs in Jenkins

Install

Via Composer

$ composer require softius/jenkins-job-monitor

Usage

Monitor a process

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

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.

jenkins-job-monitor push http://acme.org/jenkins jobName --log "Command results" --duration 5

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

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

Testing

$ composer test

Security

If you discover any security related issues, please email softius@gmail.com instead of using the issue tracker.

Credits

License

The MIT License (MIT). Please see License File for more information.