All Add-ons

Exceptiontrap ^beta

Exceptiontrap gives you powerful & intelligent exception and error tracking & monitoring for your Ruby on Rails and PHP applications.

Lets You Feel Better

With Exceptiontrap you know that your app runs smoothly in production. Even the best tests cannot give you this safety.

The Information You Need

You can see all your apps information you need to know what was going wrong at one view. You can see all the information related to the error.

Team Player

Exceptiontrap makes it easy to handle your app errors in a team. At the dashboard everyone sees whats going on and if there is something to do.

HipChat & Campfire Integration

Additionally to emails, we can send new errors directly to your team chat. So you can decide together, what you should do.

SSL Security & Based in Germany

Because you care about the data sent to our service, a SSL connection is used so all the information will be encrypted on the way to us. Furthermore the servers and the company are located in Germany - we protect your data.

Multiple Accounts

When adding Exceptiontrap to multiple heroku apps, you can switch between these accounts with one click. It coulnd’t be easier for you.

test

Free

Users: 5
Rate-Limit: 10 per minute
SSL
Hipchat & Campfire

Ruby on Rails 2.3+, 3 and 4

Add the Exceptiontrap gem into your applications Gemfile.

gem 'exceptiontrap'

Now update application dependencies with bundler.

$ bundle install

And generate the configuration file. You find the **api-key** on the add-on page asEXCEPTIONTRAPAPIKEY`

$ rails generate exceptiontrap --api-key YOUR_EXCEPTIONTRAP_API_KEY

PHP, Zend Framework & other frameworks

PHP

Download the exceptiontrap-php plugin from Github to your desired folder (e.g. Exceptiontrap/).

Insert the following lines into your applications codebase. You can find your api-key on the add-on page as: EXCEPTIONTRAP_API_KEY.

require_once 'Exceptiontrap/Exceptiontrap.php';
Exceptiontrap::setup('YOUR_EXCEPTIONTRAP_API_KEY', true, 'YOUR_APPLICATION_ENV');

Zend Framework 1.x

Download the exceptiontrap-php plugin from Github to your desired library folder (e.g. /libraries/Exceptiontrap/).

Insert the following lines into your applications codebase. You can find your api-key on the add-on page as: EXCEPTIONTRAP_API_KEY.

require_once 'Exceptiontrap/Exceptiontrap.php';
Exceptiontrap::setup('YOUR_EXCEPTIONTRAP_API_KEY', true, 'YOUR_APPLICATION_ENV');

Register Plugin for better integration

If you use the Bootstrap class (recommended) insert the following method.

protected function _initExceptiontrap(){
  Zend_Controller_Front::getInstance()->registerPlugin(new Exceptiontrap_Services_Zf1ErrorHandler());
}

Or register the plugin manually to the front controller.

$controller = Zend_Controller_Front::getInstance();
$controller->registerPlugin(new Exceptiontrap_Services_Zf1ErrorHandler());

Other frameworks

The Exceptiontrap library is designed to be framework agnostic. So the integration into your framework of choice should be fine with the general PHP integration documented above.

You can set the request-components by yourself for better integration. The setRequestComponents class method expects an associated array to do this.

Exceptiontrap::setRequestComponents(array(
  'module' => 'YOUR_CURRENT_MODULE',
  'controller' => 'YOUR_CURRENT_CONTROLLER',
  'action' => 'YOUR_CURRENT_ACTION'
));

Further integration

If there is data in your request parameters, session or environment, which you don’t want to be sent to Exceptiontrap, define them as follows:

Exceptiontrap::setFilterParams(array('HTTP_COOKIE', '_app_session', 'password'));

You can also specify exceptions and errors, which should be ignored and not sent.

Exceptiontrap::setIgnoreList(array('InvalidArgumentException', 'Zend_Translate_Exception'));

Please redeploy your application after installing the add-on and following the instructions. This is necessary for the add-on to use your api-key provisioned by Engine Yard.

You must first have an app environment to add Exceptiontrap to. Create one from the dashboard.

Exceptiontrap beta