Usage
How to start monitoring your script.
Transactions
All start with a
transaction. A Transaction represents an execution cycle and it can contains one or hundreds of segments.It should be started as soon as possible in your application to better represent the time your script takes to fulfill the request.
Typically the transaction should be started in the entry point of your application e.g.
index.php1
/*
2
* A transaction should start as soon as possible,
3
* typically in the "index.php" file of your application.
4
*/
5
$pathInfo = explode('?', $_SERVER["REQUEST_URI"]);
6
$path = array_shift($pathInfo);
7
​
8
$inspector->startTransaction($path);
9
​
10
​
11
// Continue with the script...
Copied!
Set transaction result
When your application return a response back to the client you can setup the result of the transaction like the HTTP code:
1
$inspector->currentTransaction()->setResult(200);
Copied!
Add Context
Each transaction can be enriched with additional information to have a more complete picture of the process execution context.
You can use the
addCotext method to attach new tabs to the current transaction:1
$inspector->currentTransaction()->addContext('label', ['foo' => 'bar']);
Copied!
Contextual information will be reported as additional tabs in the transaction view. This code example creates a new tab "Label" in the transaction details as showed in the image below:
The new "Label" tab
Make Inspector available in your application globally
To be free to add new segments, or interact with the current transaction you need a way to make the Inspector instance available everywhere in your application.
Use an IoC container like PHP-DI is a common way to distribute internal services inside an application. If your application has one, or implement other similar strategies, you could put the Inspector instance in the registry:
1
$container->set('inspector', $inspector);
Copied!
in order to use it later inside your application to add segments:
1
class UserController extends BaseController
2
{
3
/**
4
* @var \Inspector\Inspector
5
*/
6
protected $inspector;
7
8
/**
9
* UserController constructor.
10
*/
11
public function __construct()
12
{
13
// Get Inspector instance from the container.
14
$this->inspector = $container->get('inspector');
15
}
16
17
/**
18
* Do something.
19
*/
20
public function action()
21
{
22
// Monitor a piece of code and return the result back to the client.
23
return $this->inspector->addSegment(function () {
24
25
return $this->someService->doSomething();
26
27
}, 'someService', 'doSomething');
28
}
29
}
Copied!
Last modified 2mo ago