README.md

Telltale

Statistics that help you improve application performance.

Telltale analyses current execution and provides information about potential bottlenecks in your application. Analyzes are executed by agents. Output reports are automatically sent to console of your browser. Available agents:

• Memory Peak;
• Critical Path;
• Slowest Calls;
• Memory Usage Calls.

Usage

<?php

use Telltale\Telltale;
use Telltale\Agent\MemoryPeakAgent;
use Telltale\Agent\CriticalPathAgent;
use Telltale\Agent\SlowestCallsAgent;
use Telltale\Agent\MemoryUsageCallsAgent;

// create an analyser
$telltale = new Telltale();
$telltale->pushAgent(new MemoryPeakAgent());
$telltale->pushAgent(new CriticalPathAgent());
$telltale->pushAgent(new SlowestCallsAgent());
$telltale->pushAgent(new MemoryUsageCallsAgent());

// start watching
$telltale->start();

Then your browser displays informations like this...

Analysing a code snippet...

<?php
// ignored
$telltale->start();
// analysed
$telltale->stop();
// ignored

Installation

Add renanbr/telltale dependency using Composer.

php composer.phar require renanbr/telltale:~1

Or change composer.json file...

{
    "require": {
        "renanbr/telltale": "~1"
    }
}

For Composer documentation, please refer to getcomposer.org.

Environment Requirements

• PHP 5.3+
• Xdebug 2.1+
• FirePHP for Firefox, or
  • ChromeLogger for Chrome

Acknowledgements

This library is inspired by Derick Rethans' tracefile analyser script and ZendServer Code Tracing.