New Relic

New Relic is an Application Performance Monitoring (APM) solution. It monitors mobile and web applications in real-time, enabling developers to diagnose and fix application performance problems. It is a great complement to Blackfire. Whenever New Relic detects a slow page, it triggers a Blackfire profile to quickly analyze and resolve detected problems. To know more about the differences between New Relic and Blackfire.io, please read this chapter of the 24 days of Blackfire.

Blackfire supports a native integration with New Relic, which can automate the triggering of Blackfire test scenarios on given events from New Relic. For instance, any alert you set-up in New Relic for your application or key transaction can enable Blackfire to run tests on a pre-defined scenario.

Note

Known limitation: New Relic does not capture the exact URLs for which the issue generates an alert. They are therefore not transmitted to Blackfire. You will need to define generic scenarios in Blackfire that will be executed for any alert generated by New Relic.

Setting up the New Relic Integration

Use New Relic Alerts interface to set up some alerts for your application or key transactions. Then add a new Notification Channel and use the Webhook type to enable Blackfire. Finally, configure the channel with the the Base URL and Basic Auth credentials which can be found in the Dashboard Builds tab, in the New Relic integration.

A new build report will be generated each time an alert is raised through the Notification channel. You might need to adjust the alert thresholds in order to get an appropriate build report rhythm.

Configuration Recommendation

In New Relic, you can configure Key Transactions. Those are important path/URLs that you want to monitor closely. New Relic gives you more details about it, and you can configure alert notifications which are specific to those transactions.

In order to get the best out of your New Relic/Blackfire integration, simply configure the same path/URLs both as New Relic key transactions, and as Blackfire scenarios.

You can also configure one of our notification channels to let you know when the build report is available.