Yii 1.1: yii-newrelic

Yii wrapper around the New Relic PHP API, for Application Performance Management
6 followers

yii-newrelic

Yii wrapper around the New Relic PHP API.

Introduction

yii-newrelic is a wrapper around the New Relic PHP API. New Relic is a SaaS company that provides a native PHP extension to interface with their application performance tracking and metrics engine. With New Relic, and this extension, you will have access to detailed performance metrics for your Yii application, as well as the server(s) on which your application is running.

Automatic tracking of module/controller/action ID's is supported. Automatic injection of timing header and footer also supported.

Requirements

  • PHP 5.2+
  • New Relic for PHP
  • One of the following OS's:
    • Linux 2.6+, glibc 2.5+ with NPTL support
    • OpenSolaris 10
    • FreeBSD 7.3+
    • MacOS/X 10.5+
  • Apache 2.2 or 2.4 via mod_php
  • Intel CPU

Installation

1) Install the New Relic PHP driver on your web server per New Relic For PHP instructions.

2) Place this extension in /protected/extensions/yii-newrelic/.

3) In main.php, add the following to 'components':

'newRelic' => array(
    'class' => 'ext.yii-newrelic.YiiNewRelic',
),
'clientScript' => array(
    'class' => 'ext.yii-newrelic.YiiNewRelicClientScript',
),

4) If you are using a script that subclasses CClientScript, instead of adding 'clientScript' to your 'components', you will instead need to orphan that extension's script and extend it from YiiNewClientScript instead. To do so, change extends CClientScript to extends YiiNewRelicClientScript, and then add a line before that class declaration that says:

Yii::import('ext.yii-newrelic.YiiNewRelicClientScript');

5) In main.php, add the following to the top-level array:

'behaviors' => array(
    'onBeginRequest' => array(
        'class' => 'ext.yii-newrelic.behaviors.YiiNewRelicWebAppBehavior',
    ),
),

6) Create subclass of CWebApplication, e.g. NewRelicApplication.

7) In this new class, e.g. NewRelicApplication, add a method::

public function beforeControllerAction($controller, $action) {
    Yii::app()->newRelic->setTransactionName($controller->id, $action->id);
    return parent::beforeControllerAction($controller, $action);
}

8) To use your new subclassed CWebApplication, modify index.php similar to:

$config=dirname(__FILE__).'/../protected/config/main.php';
require_once(dirname(__FILE__).'/../yii-1.1.12.b600af/framework/yii.php');
require_once(dirname(__FILE__).'/../protected/components/system/PromocastApplication.php');
$app = new NewRelicApplication($config);
$app->run();

9) In console.php, add the following to 'components':

'newRelic' => array(
    'class' => 'ext.yii-newrelic.YiiNewRelic',
),

10) In console.php, add the following to the top-level array:

'behaviors' => array(
    'onBeginRequest' => array(
        'class' => 'ext.yii-newrelic.behaviors.YiiNewRelicConsoleAppBehavior',
    ),
    'onEndRequest' => array(
        'class' => 'ext.yii-newrelic.behaviors.YiiNewRelicConsoleAppBehavior',
    ),
),

Features

  • yii-newrelic automatically detects whether the New Relic PHP extension is properly installed.
  • Automatic association of Yii module/controller/action ID's.
  • Automatic injection of New Relic timing header/footer into your HTML layouts.
  • Console commands also supported.

Usage

  • TODO: Finish docs with use cases with YiiNewRelic API wrapper methods

Known issues and other comments

  • A future release will aim to avoid needing to call YiiNewRelic::nameTransaction() via CWebApplication subclass. This seems to be the only reliable mechanism for determining the actual controller/action in use. An attempt was made to use Yii::app()->getUrlManager()->parseUrl(Yii::app()->getRequest()) in YiiNewRelicWebAppBehavior, but this does not seem to produce consistent results.
  • Console apps currently only set the class name to YiiNewRelic::nameTransaction(). A future release will attempt to include the action as well.
  • Your contributions, as always, are greatly appreciated.

Code

Get the code at GitHub. You may download directly using this Direct Download Link.

License

Modified BSD License https://github.com/gtcode/yii-newrelic

Total 4 comments

#17629 report it
raghul at 2014/07/09 06:24am
thanks you save my day

thanks for this code and use full information

#13565 report it
andyofb at 2013/06/06 11:41am
Error logging

Does this log errors to New Relic as well?

#10187 report it
yiier at 2012/10/09 03:48pm
re: Any code?

Hi canreo,

You may proceed to the GitHub project page and clone/download the code from there.

edit: I've added a direct download link for your convenience. Thanks for the comment.

#10186 report it
canreo at 2012/10/09 03:40pm
Any code?

This looks interesting, but it's hard to do anything without downloadable code!

Leave a comment

Please to leave your comment.

Create extension
Downloads
No downloadable files yet