knock/probes

Knock Probe SDK - Lib to send probe to knock daemon

dev-master 2016-12-06 00:00 UTC

This package is auto-updated.

Last update: 2024-04-14 17:20:56 UTC


README

Build Status

Latest release: 0.99.0-RC2

PHP >= 5.6.0

This library contains a class to send business probe to knock daemon.

https://knock.center

Copyright (C) 2013/2014/2015/2016 Laurent Champagnac / Laurent Labatut

Source code

  • We use a right margin of 360 characters (please don't talk me about 80 chars)
  • SDK code is located inside "./src"
  • Test are located inside "./tests"
  • All test files must end with Test
  • All tests must adapt to any running directory
  • We are still bound to php 5.6 2.7 (we will move to php 7 later on)
  • We are using docstring.

Requirements

  • Knockdaemon
  • An account on Knock

Authors

Contribute

Contributions to the package are always welcome!

Support

If you are having problems, open a ticket on issue tracker.

License

All contents of this package are licensed under the GPL V2.

Example

Installation

Use [Composer] to install the package:

$ composer require knock/probes

Push a Gauge Probe

You can push a gauge probe one by one without declare first.

<?php
 
 require __DIR__ . '/vendor/autoload.php';
 use Knock\Probes\Knock;
 
 $k = new Knock();
 $k->gauge('apple', 2);
 $k->gauge('orange', 3);


Push a Counter Probe

You can push a incerment probe.

<?php

require __DIR__ . '/vendor/autoload.php';
use Knock\Probes\Knock;

$k = new Knock();
$k->increment('action1', 1);
// do something

Delay to Count

Delay to count is a spécial probe. This probe agregate all execution time in a dict of range of time.

<?php

require __DIR__ . '/vendor/autoload.php';
use Knock\Probes\Knock;

$k = new Knock();
$timecode = $k->start_delay('api_facebook_request');
sleep(2); // here your external request
$k->stop_delay($timecode);

Important information

Knock lib have a destructor. So for performance improvement you can omit to commit. So it's not possible to uncommit a probe.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA