This release bumps the PHP minimum from 7.3.11 to 8.0 and the WordPress minimum from 4.0 to 6.3.<\/p>"},"ratings":{"1":0,"2":0,"3":0,"4":0,"5":4},"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":2968950,"resolution":"128x128","location":"assets","locale":""},"icon-256x256.png":{"filename":"icon-256x256.png","revision":2968950,"resolution":"256x256","location":"assets","locale":""},"icon.svg":{"filename":"icon.svg","revision":2968950,"resolution":false,"location":"assets","locale":false}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":2968950,"resolution":"1544x500","location":"assets","locale":""},"banner-772x250.png":{"filename":"banner-772x250.png","revision":2968950,"resolution":"772x250","location":"assets","locale":""}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0","1.1","1.2","1.3","1.3.1","1.3.2","1.3.3"],"block_files":[],"assets_screenshots":[],"screenshots":[],"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[130352,130349,130351,130350],"plugin_category":[],"plugin_contributors":[77761,183658,153830,78796,78260],"plugin_business_model":[216239],"class_list":["post-53459","plugin","type-plugin","status-publish","hentry","plugin_tags-apm-reporting","plugin_tags-new-relic","plugin_tags-new-relic-apm-reporting","plugin_tags-new-relic-reporting","plugin_contributors-10up","plugin_contributors-jeffpaul","plugin_contributors-oscarssanchez","plugin_contributors-ritteshpatel","plugin_contributors-tott","plugin_business_model-community","plugin_committers-10up","plugin_committers-10upbot","plugin_support_reps-ankit-k-gupta","plugin_support_reps-dharm1025","plugin_support_reps-dkotter","plugin_support_reps-faisal03","plugin_support_reps-jeffpaul","plugin_support_reps-nomnom99","plugin_support_reps-sumitbagthariya16","plugin_support_reps-tott"],"banners":{"banner":"https:\/\/ps.w.org\/wp-newrelic\/assets\/banner-772x250.png?rev=2968950","banner_2x":"https:\/\/ps.w.org\/wp-newrelic\/assets\/banner-1544x500.png?rev=2968950","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":"https:\/\/ps.w.org\/wp-newrelic\/assets\/icon.svg?rev=2968950","icon":"https:\/\/ps.w.org\/wp-newrelic\/assets\/icon.svg?rev=2968950","icon_2x":false,"generated":false},"screenshots":[],"raw_content":"\n
WP New Relic (WPNR) is designed to use with New Relic APM<\/a> which uses 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.<\/p>\n\n New Relic is a trademark of New Relic, Inc.<\/p>\n\n After activating the plugin, You will see a new option named New Relic<\/strong> 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.<\/p>\n\n Capture URL Parameters: If Capture URLs setting is enabled, it will capture URL parameters for displaying in transaction traces.<\/p>\n\n By default plugin will setup 3 configs.\n- newrelic.appname\n- newrelic.capture_params\n- newrelic.framework (value is wordpress)<\/p>\n\n appname and capture_params config can be override using wp_nr_config filter<\/strong>. wp_nr_setup_config<\/strong> action hook can also be used to setup any extra config.<\/p>\n\n 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<\/a> for more details on how to query events.<\/p>\n\n User<\/strong><\/p>\n\n User attribute is getting set using 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<\/strong>.\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'<\/p><\/li>\n Post ID<\/strong><\/p>\n\n For single post, post ID will be set via post_id<\/strong> custom parameter in transaction.<\/p>\n\n Ex: Get all transactions for a post ID 190.<\/p>\n\n SELECT * FROM Transaction WHERE appName = '{appName}' AND post_id = '190'<\/p>\n\n One can also query for post view count for post 190.<\/p>\n\n SELECT count(*) FROM Transaction WHERE appName = '{appName}' AND post_id = '190'<\/p><\/li>\n Template<\/strong><\/p>\n\n For each request, template being used getting set as template<\/strong> custom parameter in transaction.<\/p>\n\n Ex: You can query all transactions for a particular template as following.<\/p>\n\n SELECT * FROM Transaction WHERE appName = '{appName}' AND template = '{Absolute Template Path}'<\/p><\/li>\n Theme<\/strong><\/p>\n\n Current theme is getting set as theme<\/strong> custom parameter in transaction.<\/p>\n\n Ex: Query all transactions for \"Twenty Fifteen\" theme.<\/p>\n\n SELECT * FROM Transaction WHERE appName = '{appName}' AND theme = 'Twenty Fifteen'<\/p><\/li>\n Request type<\/strong><\/p>\n\n There can be 3 type of requests namely web, ajax and cli. Current request type getting set as request_type<\/strong> custom parameter in transaction.\nRequest type can be override using wp_nr_request_type filter.<\/p>\n\n Ex: Get all transaction for \"ajax\" request type<\/p>\n\n SELECT * FROM Transaction WHERE appName = '{appName}' AND request_type = 'ajax'<\/p><\/li>\n Transaction Name<\/strong><\/p>\n\n Transaction name is getting set as per the main WP_Query parameters using newrelic_name_transaction<\/a>.\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}<\/p><\/li>\n Custom Error Logging<\/strong><\/p>\n\n Using wp_nr_log_errors<\/strong> 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\u2019s limitation of PHP Agent API<\/a>.<\/p>\n\n wp_nr_log_errors( 'Error message', Exception $exception );<\/strong><\/p><\/li>\n Runtime of async tasks<\/strong><\/p>\n\n This plugin also tracks runtime of gearman<\/a> async tasks. Gearman async task run for a particular hook and it\u2019s runtime can be track using \u201cwp_async_task-{hook}\u201d custom attribute in New Relic Insights.<\/p><\/li>\n<\/ol>\n\n PHP version<\/strong>\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<\/a>.<\/p><\/li>\n Have an issue to report?<\/strong>\nIf you identify any errors or have an idea for improving the plugin, please open an issue<\/a>. We're excited to see what the community thinks of this project, and we would love your input!<\/p><\/li>\n<\/ol>\n\n\n Note this release bumps the PHP minimum from 7.3.11 to 8.0 and the WordPress minimum from 4.0 to 6.3.<\/strong>\n* Added:<\/strong> Minimum PHP version check for 7.3.11 (props @bmarshall511<\/a>, @Sidsector9<\/a> via #60<\/a>).\n* Changed:<\/strong> Support Level<\/a> downgraded from Admin Settings<\/h4>\n\n
Basic Config<\/h4>\n\n
New Relic Custom Attributes<\/h4>\n\n
\n
Issues<\/h4>\n\n
\n
\n
1.3.3 - 2024-06-26<\/h4>\n\n
Active<\/code> to Stable<\/code> (props @jeffpaul<\/a>, @dkotter<\/a>, @felipeelia<\/a>, @oscarssanchezz<\/a> via #65<\/a>).\n* Changed:<\/strong> Bump WordPress \"tested up to\" version 6.5 (props @zamanq<\/a>, @jeffpaul<\/a>, @oscarssanchezz<\/a> via #58<\/a>, #66<\/a>).\n* Fixed:<\/strong> Improve compatibility with PHP 8.1 by replacing the deprecated FILTER_SANITIZE_STRING<\/code> (props @burhandodhy<\/a>, @jeffpaul<\/a>, @felipeelia<\/a>, Sven<\/a> via #68<\/a>).<\/p>\n\n1.3.2 - 2022-06-28<\/h4>\n\n
\n