10up

Jeffrey Paul

Thorsten Ott

Ritesh Patel

oscarssanchez

WP New Relic (WPNR) is designed to use with <a href="https://newrelic.com/application-monitoring" rel="nofollow ugc">New Relic APM</a> which uses <a href="https://docs.newrelic.com/docs/agents/php-agent/configuration/php-agent-api" rel="nofollow ugc">New Relic PHP Agent API</a> to properly augment existing metrics with valuable WordPress details such as templates, users, request type, transaction names etc. This plugin is tested with PHP Agent 10.19.0.9.
New Relic is a trademark of New Relic, Inc.
<h4>Admin Settings</h4>
After activating the plugin, You will see a new option named New Relic under the Tools menu in your WordPress Dashboard. If you are running WordPress in Network Mode, the settings page will be found in your Network Dashboard.
Capture URL Parameters: If Capture URLs setting is enabled, it will capture URL parameters for displaying in transaction traces.
<h4>Basic Config</h4>
By default plugin will setup 3 configs. 
– newrelic.appname 
– newrelic.capture_params 
– newrelic.framework (value is wordpress)
appname and capture_params config can be override using wp_nr_config filter. wp_nr_setup_config action hook can also be used to setup any extra config.
<h4>New Relic Custom Attributes</h4>
Certain useful custom attrribute (just like WordPress post meta) will be set for each event which can provide additional information using key-value pair. You can query events and filter them using these attributes in New Relic Insights. See <a href="https://docs.newrelic.com/docs/insights/new-relic-insights/using-new-relic-query-language/nrql-reference" rel="nofollow ugc">NRQL reference</a> for more details on how to query events.
<ol>
<li>
User
User attribute is getting set using <a href="https://docs.newrelic.com/docs/agents/php-agent/configuration/php-agent-api#api-set-user-attributes" rel="nofollow ugc">newrelic_set_user_attributes</a>. If user is logged in, user ID will be set to user attribute and if not it will be set to not-logged-in. 
Ex: In New Relic Insights you can query transactions for non-logged in users as 
SELECT * FROM Transaction WHERE appName = ‘{appName}’ AND user = ‘not-logged-in’
</li>
<li>
Post ID
For single post, post ID will be set via post_id custom parameter in transaction.
Ex: Get all transactions for a post ID 190.
SELECT * FROM Transaction WHERE appName = ‘{appName}’ AND post_id = ‘190’
One can also query for post view count for post 190.
SELECT count(*) FROM Transaction WHERE appName = ‘{appName}’ AND post_id = ‘190’
</li>
<li>
Template
For each request, template being used getting set as template custom parameter in transaction.
Ex: You can query all transactions for a particular template as following.
SELECT * FROM Transaction WHERE appName = ‘{appName}’ AND template = ‘{Absolute Template Path}’
</li>
<li>
Theme
Current theme is getting set as theme custom parameter in transaction.
Ex: Query all transactions for “Twenty Fifteen” theme.
SELECT * FROM Transaction WHERE appName = ‘{appName}’ AND theme = ‘Twenty Fifteen’
</li>
<li>
Request type
There can be 3 type of requests namely web, ajax and cli. Current request type getting set as request_type custom parameter in transaction. 
Request type can be override using wp_nr_request_type filter.
Ex: Get all transaction for “ajax” request type
SELECT * FROM Transaction WHERE appName = ‘{appName}’ AND request_type = ‘ajax’
</li>
<li>
Transaction Name
Transaction name is getting set as per the main WP_Query parameters using <a href="https://docs.newrelic.com/docs/agents/php-agent/configuration/php-agent-api#api-name-wt" rel="nofollow ugc">newrelic_name_transaction</a>. 
Possible values are Default Home Page, Front Page, Blog Page, Network Dashboard, Dashboard, Single – {post_type}, Page – {pagename}, Date Archive, Search Page, Feed, Archive – {post_type}, Category – {cat_name}, Tag – {tag_name}, Tax – {taxonomy} – {term}
</li>
<li>
Custom Error Logging
Using wp_nr_log_errors function, any plugin/theme can log errors/notices to New Relic for current transaction. 
Note: This function can be used more than once but only last use will be considered to log the error to New Relic. It’s limitation of <a href="https://docs.newrelic.com/docs/agents/php-agent/configuration/php-agent-api#api-notice-error" rel="nofollow ugc">PHP Agent API</a>.
wp_nr_log_errors( ‘Error message’, Exception $exception );
</li>
<li>
Runtime of async tasks
This plugin also tracks runtime of <a href="https://github.com/10up/WP-Gears" rel="nofollow ugc">gearman</a> async tasks. Gearman async task run for a particular hook and it’s runtime can be track using “wp_async_task-{hook}” custom attribute in New Relic Insights.
</li>
</ol>
<h4>Issues</h4>
<ol>
<li>
PHP version 
PHP version 7.3.3 is known to cause issues with this plugin, updating to 7.3.11 or greater appears to resolve these issues. For more details, see <a href="https://github.com/10up/wp-newrelic/issues/39" rel="nofollow ugc">issue#39</a>.
</li>
<li>
Have an issue to report? 
If you identify any errors or have an idea for improving the plugin, please open an <a href="https://github.com/10up/wp-newrelic/issues?stage=open" rel="nofollow ugc">issue</a>. We’re excited to see what the community thinks of this project, and we would love your input!
</li>
</ol>

New Relic Reporting for WordPress

I'm biased, since other members of my team built this, but using it for some clients I'm serving, I can say that the added data - particularly around the page template and user properties - saves significant time in diagnostics.

Essential added data

Just installed the plugin and it works like a charm with NewRelic's service.

Thank you for developing this plugin.

Alternatives to New Relic Reporting for WordPress

Top alternatives