inspector-apm/inspector-php

Inspector for PHP applications.

3.0.8 2020-02-14 11:03 UTC

README

Build Status Latest Stable Version

Inspector is a composer package to add Real-Time performance and error alerting in your Laravel applications.

Install the latest version by:

composer require inspector-apm/inspector-php

Use

To start sending data to Inspector you need an API key to create a configuration instance. You can obtain INSPECTOR_API_KEY creating a new project in your Inspector dashboard.

<?php
require __DIR__ . '/../vendor/autoload.php';

use Inspector\Inspector;
use Inspector\Configuration;

$configuration = new Configuration('YOUR_API_KEY');
$inspector = new Inspector($configuration);

All start with a transaction. Transaction represent an execution cycle and it can contains one or hundred of segments:

// Start execution cycle with a transaction
$inspector->startTransaction($_SERVER['PATH_INFO']);

// Trace performance of code blocks
$segment = $inspector->startSegment('my-process');
try {

    throw new UnauthorizedException("You don't have permission to access.");

} catch(UnauthorizedException $exception) {
    $inspector->reportException($exception);
} finally {
    $segment->end();
}

Or directly use add segment that implement this strategy for you, and put the new segment in the callback so you can add context information if you need:

$result = $inspector->addSegment(function ($segment) {
    // Write here the code block to monitor
    $text = 'Hello Workd!';

    return $text;
}, 'my-process');

echo $result; // this will print "Hello World!"

Inspector will collect information to produce performance chart in your dashboard.

See official documentation

LICENSE

This package are licensed under the MIT license.