[{"name":"New Relic Reporting for WordPress","slug":"wp-newrelic","version":"1.3.3","author":"10up","author_profile":"https://profiles.wordpress.org/10up/","requires":"6.3","tested":"6.5.5","requires_php":"8.0","requires_plugins":[],"rating":100,"ratings":{"1":0,"2":0,"3":0,"4":0,"5":4},"num_ratings":4,"support_threads":0,"support_threads_resolved":0,"downloaded":91587,"last_updated":"2024-06-26 9:00pm GMT","added":"2016-12-02","homepage":"https://wordpress.org/plugins/wp-newrelic","sections":{"description":"

WP New Relic (WPNR) is designed to use with New Relic APM which uses New Relic PHP Agent API 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.

Admin Settings

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.

Basic Config

By default plugin will setup 3 configs.
\n– newrelic.appname
\n– newrelic.capture_params
\n– 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.

New Relic Custom Attributes

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 NRQL reference for more details on how to query events.

\n
User
\n
User attribute is getting set using newrelic_set_user_attributes. If user is logged in, user ID will be set to user attribute and if not it will be set to not-logged-in.
\nEx: In New Relic Insights you can query transactions for non-logged in users as
\nSELECT * FROM Transaction WHERE appName = ‘{appName}’ AND user = ‘not-logged-in’
\n
\n
Post ID
\n
For single post, post ID will be set via post_id custom parameter in transaction.
\n
Ex: Get all transactions for a post ID 190.
\n
SELECT * FROM Transaction WHERE appName = ‘{appName}’ AND post_id = ‘190’
\n
One can also query for post view count for post 190.
\n
SELECT count(*) FROM Transaction WHERE appName = ‘{appName}’ AND post_id = ‘190’
\n
\n
Template
\n
For each request, template being used getting set as template custom parameter in transaction.
\n
Ex: You can query all transactions for a particular template as following.
\n
SELECT * FROM Transaction WHERE appName = ‘{appName}’ AND template = ‘{Absolute Template Path}’
\n
\n
Theme
\n
Current theme is getting set as theme custom parameter in transaction.
\n
Ex: Query all transactions for “Twenty Fifteen” theme.
\n
SELECT * FROM Transaction WHERE appName = ‘{appName}’ AND theme = ‘Twenty Fifteen’
\n
\n
Request type
\n
There can be 3 type of requests namely web, ajax and cli. Current request type getting set as request_type custom parameter in transaction.
\nRequest type can be override using wp_nr_request_type filter.
\n
Ex: Get all transaction for “ajax” request type
\n
SELECT * FROM Transaction WHERE appName = ‘{appName}’ AND request_type = ‘ajax’
\n
\n
Transaction Name
\n
Transaction name is getting set as per the main WP_Query parameters using newrelic_name_transaction.
\nPossible 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}
\n
\n
Custom Error Logging
\n
Using wp_nr_log_errors function, any plugin/theme can log errors/notices to New Relic for current transaction.
\nNote: 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 PHP Agent API.
\n
wp_nr_log_errors( ‘Error message’, Exception $exception );
\n
\n
Runtime of async tasks
\n
This plugin also tracks runtime of gearman 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.
\n

Issues

\n
PHP version
\nPHP 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 issue#39.
\n
\n
Have an issue to report?
\nIf you identify any errors or have an idea for improving the plugin, please open an issue. We’re excited to see what the community thinks of this project, and we would love your input!
\n

\n","installation":"

First, you will need to install and configure New Relic PHP agent on server.
Activate the plugin in WordPress.
Enjoy!

\n","changelog":"

1.3.3 – 2024-06-26

Note this release bumps the PHP minimum from 7.3.11 to 8.0 and the WordPress minimum from 4.0 to 6.3.
\n* Added: Minimum PHP version check for 7.3.11 (props @bmarshall511, @Sidsector9 via #60).
\n* Changed: Support Level downgraded from Active to Stable (props @jeffpaul, @dkotter, @felipeelia, @oscarssanchezz via #65).
\n* Changed: Bump WordPress “tested up to” version 6.5 (props @zamanq, @jeffpaul, @oscarssanchezz via #58, #66).
\n* Fixed: Improve compatibility with PHP 8.1 by replacing the deprecated FILTER_SANITIZE_STRING (props @burhandodhy, @jeffpaul, @felipeelia, Sven via #68).

1.3.2 – 2022-06-28

Changed: Bump WordPress version “tested up to” 6.0 (props @lukecav, @burhandodhy, @jeffpaul via #45, #49).

View historical changelog details here.

\n"},"short_description":"New Relic APM reports for WordPress.","download_link":"https://downloads.wordpress.org/plugin/wp-newrelic.1.3.3.zip","screenshots":[],"tags":{"apm-reporting":"APM Reporting","new-relic":"New Relic","new-relic-apm-reporting":"New Relic APM Reporting","new-relic-reporting":"New Relic Reporting"},"versions":{"1.0":"https://downloads.wordpress.org/plugin/wp-newrelic.1.0.zip","1.1":"https://downloads.wordpress.org/plugin/wp-newrelic.1.1.zip","1.2":"https://downloads.wordpress.org/plugin/wp-newrelic.1.2.zip","1.3":"https://downloads.wordpress.org/plugin/wp-newrelic.1.3.zip","1.3.1":"https://downloads.wordpress.org/plugin/wp-newrelic.1.3.1.zip","1.3.2":"https://downloads.wordpress.org/plugin/wp-newrelic.1.3.2.zip","1.3.3":"https://downloads.wordpress.org/plugin/wp-newrelic.1.3.3.zip","trunk":"https://downloads.wordpress.org/plugin/wp-newrelic.zip"},"donate_link":"","icons":{"1x":"https://ps.w.org/wp-newrelic/assets/icon.svg?rev=2968950","svg":"https://ps.w.org/wp-newrelic/assets/icon.svg?rev=2968950"}},{"name":"Gigaom New Relic","slug":"go-newrelic","version":"0.3","author":"Gigaom","author_profile":"https://profiles.wordpress.org/misterbisson/","requires":"3.5.1","tested":"4.0.38","requires_php":false,"requires_plugins":[],"rating":100,"ratings":{"1":0,"2":0,"3":0,"4":0,"5":4},"num_ratings":4,"support_threads":0,"support_threads_resolved":0,"downloaded":11575,"last_updated":"2014-11-04 2:34pm GMT","added":"2013-05-24","homepage":"http://wordpress.org/plugins/go-newrelic/","sections":{"description":"

Supports both New Relic APM and Browser monitoring to give a clear picture of how your site performs both on the server and in the browser.

Application Performance Monitoring (APM)

Automatically detects if the APM extensions are installed on the server. If so, the plugin will start reporting into the New Relic account associated with the license key used when installing the extension.

There’s no UI, but the plugin automatically sets the app name and other configuration values ideally for each request. The app name is based on the blog’s name. User-facing and dashboard activity are reported as separate apps so you can set different QoS and alert settings for each. Even cron and admin-ajax activity are separated out for individual tracking.

Each blog in a multi-site installation is tracked separately, using the name of the blog as the app name.

Browser monitoring (RUM)

Real user monitoring (browser monitoring) is automatically enabled if the APM extension is active, but in situations where the APM extension can’t be used, the plugin can still be used to track browser performance.

This mode requires some configuration:

Get the tracking JavaScript from New Relic.
Go to your WordPress dashboard -> Settings -> New Relic Settings and paste in the JavaScript
Go to the New Relic dashboard to see your site reporting performance data!

The plugin extracts the configuration details from the JS and inserts them with a clean copy of the JS on each page (this cannot be used to inject arbitrary JS into the page).

Due to limitations of the Browser monitoring service/API, Browser-only monitoring does not include all the data or separate reporting of activity in separate apps as APM does.

In the WordPress.org plugin repo

Here: https://wordpress.org/plugins/go-newrelic/

Fork me!

This plugin is on Github: https://github.com/gigaOM/go-newrelic

\n","installation":"

Install and activate New Relic’s PHP agent, https://docs.newrelic.com/docs/php/new-relic-for-php#installation
The web server should appear in New Relic’s dashboard
Download and activate this plugin from https://wordpress.org/plugins/go-newrelic/
Go back to the New Relic dashboard and enjoy monitoring each WordPress blog (and different aspects of each blog)
Follow the Gigaom engineering team at http://kitchen.gigaom.com and https://github.com/gigaom/

\n","screenshots":"

$\"New$
New Relic application list, showing two blogs. Each WordPress blog is reported as four applications in New Relic to separate reader, writer, cron, and admin-ajax activity for better detail and fine-grained control.
$\"New$
New Relic application overview, showing performance history for a single app.

"},"short_description":"Configures New Relic to better track performance, errors, and uptime of WordPress sites, including multisite","download_link":"https://downloads.wordpress.org/plugin/go-newrelic.zip","screenshots":{"1":{"src":"https://ps.w.org/go-newrelic/trunk/screenshot-1.png?rev=1573792","caption":"New Relic application list, showing two blogs. Each WordPress blog is reported as four applications in New Relic to separate reader, writer, cron, and admin-ajax activity for better detail and fine-grained control."},"2":{"src":"https://ps.w.org/go-newrelic/trunk/screenshot-2.png?rev=1573792","caption":"New Relic application overview, showing performance history for a single app."}},"tags":{"monitoring":"monitoring","newrelic":"newrelic","performance-monitoring":"performance monitoring","server-monitoring":"server monitoring","telemetry":"telemetry"},"versions":[],"donate_link":"","icons":{"default":"https://s.w.org/plugins/geopattern-icon/go-newrelic.svg"}}]