Press "Enter" to skip to content

Primary Menu

If you don’t already have a New Relic account, you can sign up for one here:

Installing and Configuring New Relic for WordPress

Third-Party Software Notice Our support team cannot provide support for third-party software and services. However, if you spot an issue with this article please let us know and we will endeavor to bring it up-to-date ASAP.

Introduction

New Relic One is a powerful full-stack data analysis platform for all your software’s metrics, events, and logs.

Their new pricing model makes their software a lot more accessible than it was previously and now even includes a free tier.

In parts 1, 2, and 3 we’ll walk through how to install New Relic on your GridPane provisioned servers, and then we’ll look at how to finish up the configuration for Nginx and OpenLiteSpeed in their own respective sections (note that the PHP Agent installation on OpenLiteSpeed is done separately). After this there are additional sections on setting up your websites for monitoring in New Relic, and setting up additional logging if you’d like to do so.

Click on the images throughout the article to zoom in.

  • Install Part 1. Get Your New Relic Install Command
  • Install Part 2. Server Preparation
  • Install Part 3. Install New Relic on Your Server
  • Configure New Relic on Nginx
  • Configure New Relic on OpenLiteSpeed
  • Configure Your Websites
  • Add Additional Logs (Optional)
  • Uninstall New Relic

Please note that our support team is not available to answer questions around third-party software that is not a part of the GridPane stack, however, if you think this article needs updating or can be improved, please let us know.

Also, special thanks to Sean Vandermolen for the information he contributed to the GridPane Facebook community on installing New Relic on GridPane. That information provided the foundation for this article.

Install Part 1. Get Your New Relic Install Command

If you don’t already have a New Relic account, you can sign up for one here:

I’d recommend you choose the EU option when signing up.

Inside your New Relic account, click the “Add some data” button to get started:

Guided Install

We’re going to use the Guided Install to monitor your Logs, PHP, MySQL, and Redis:

And now click the “Begin installation” button:

Installation Script

New Relic will now create a 1 line command that you can copy and paste into your server. Before that though, we need to first complete Part 2 below.

Install Part 2. Server Preparation

Before running the New Relic install command you’ve just generated we first need to do some server prep so that both you and the server are ready for the installation process.

MySQL Root Password

If you want New Relic to monitor MySQL, you’ll need to copy your MySQL root password BEFORE running the install commands, as it will ask you for this during the installation process.

You can display your root password in the terminal with this command:

gp mysql -get-pass root

Nginx Server PHP Preparation

Out of the box, the New Relic PHP installer isn’t able to identify the multiple PHP versions installed on the system. To solve for this we can symlink current to PHP directories with the paths that New Relic looks for by default.*

Run the following commands on your server:

mkdir -p /opt/php-7.1/bin /opt/php-7.2/bin /opt/php-7.3/bin /opt/php-7.4/bin /opt/php-8.0/bin /opt/php-8.1/bin
ln -s /usr/bin/php7.1 /opt/php-7.1/bin/php
ln -s /usr/bin/php7.2 /opt/php-7.2/bin/php
ln -s /usr/bin/php7.3 /opt/php-7.3/bin/php
ln -s /usr/bin/php7.4 /opt/php-7.4/bin/php
ln -s /usr/bin/php7.4 /opt/php-8.0/bin/php
ln -s /usr/bin/php7.4 /opt/php-8.1/bin/php

*Again, special thanks to Sean Vandermolen for contributing the above information.

OpenLiteSpeed Server PHP Preparation

Just grab the MySQL password as detailed above.

No additional server preparation is necessary. We will install PHP separately after running the guided install.

Install Part 3. Install New Relic on Your Server

We’re now ready to run the installation script on your server.

Copy the command that was generated by following Install Part 1 above and hit Enter.

Guided Install Rundown

The script will first give you a rundown of the components to be installed (on OpenLiteSpeed the PHP Agent will be missing). Hit Enter to continue.

1. Installing Infrastructure Agent

First up the Infrastructure Agent will run, and its completion ends with:
==> Installing Infrastructure Agent. success.

2. Installing Logs Integration

The Logs Integration will prompt you to confirm whether you want to tail these logs:

Hit Y and then Enter.

If your installation fails here with the following message:

“We encountered an issue during the installation: encountered an error while validating receipt of data for logs-integration: no validation was successful. most recent validation error: reached max validation attempts: no results returned.”

You should be able to solve this by running the following:

apt install td-agent-bit

Once installed, you can try the guided install again.

3. Installing Golden Signal Alerts

If you’d like New Relic to email you when the outlined alerts take place, hit Y and then Enter.

This will notify the email attached to your New Relic account.

4. Installing Memcached Open Source Integration

During the Memcached install, just hit Enter.

5. Installing MySQL Open Source Integration

The MySQL install will prompt you for the password that we ran the command for during the Install Part 2 section above.

Paste this and hit Enter. Entering passwords doesn’t give visual feedback on the command line, so it’s fine to hit Enter even though it doesn’t display.

6. Installing PHP Agent Installer for Debian

OpenLiteSpeed Note: In multiple tests while writing this article, the guided install does not attempt to install the PHP Agent on OLS. We’ll configure this separately in the OpenLiteSpeed section that follows.

The PHP installer will ask for a server name. Here you may want to enter your server name and then hit Enter. This will attempt to add your server name as the newrelic.appname inside the newrelic.ini files for each version of PHP.

NOTE: Chances are it won’t change everything on Nginx so we’ll look at this in the following Nginx section.

The installer will then ask if you want to restart PHP. Hit y and then Enter.

Next, it will ask if you want to install the PHP Agent. Hit Y and then Enter.

7. Installing Redis Open Source Integration

All of the defaults are correct for Redis. Hit Enter for each option to complete the installation process.

8. Installation Complete!

Redis is the final component of the installation process. Once it’s complete you’ll see a summary:

Also, during the process, you’ll see each component being updated inside your New Relic account:

And once complete:

You can now click the “See your data” button to head to the server’s APM info.

Configure New Relic on Nginx

With New Relic installed, we now need to update/configure a few things to finish up.

1. “20-newrelic.ini” Removal

After the installation process is complete, if you run:

php -v

You may see a warning that reads: PHP Warning: Module ‘newrelic’ already loaded in Unknown on line 0 .

This same warning will also show up when restarting any version of PHP.

This is due to the additional 20-newrelic.ini inside the /etc/php/7.*/fpm/conf.d .
(* meaning 7.1, 7.2, 7.3, 7.4).

Remove these with this command:

rm /etc/php/7.*/fpm/conf.d/20-newrelic.ini

And also the following to clear any that exist inside /etc/php/7.*/cli/conf.d :

rm /etc/php/7.*/cli/conf.d/20-newrelic.ini

2 . Update Application Name and License Key inside newrelic.ini files

If you run the following command you’ll likely find that the New Relic install process didn’t set your server name and/or license in every newrelic.ini file:

grep -inr "newrelic.appname newrelic.appname PHP Application" /etc/php/7.1/cli/conf.d/newrelic.ini:112:newrelic.appname = "PHP Application" /etc/php/7.1/fpm/conf.d/newrelic.ini:112:newrelic.appname = "PHP Application" /etc/php/7.2/mods-available/newrelic.ini:112:newrelic.appname = "PHP Application" /etc/php/7.2/cli/conf.d/newrelic.ini:112:newrelic.appname = "PHP Application" /etc/php/7.2/fpm/conf.d/newrelic.ini:112:newrelic.appname = "PHP Application" /etc/php/7.3/mods-available/newrelic.ini:112:newrelic.appname color: #000000;">steve-server-ngx" /etc/php/7.3/cli/conf.d/newrelic.ini:112:newrelic.appname = "PHP Application" /etc/php/8.0/mods-available/newrelic.ini:112:newrelic.appname = "PHP Application" /etc/php/7.4/mods-available/newrelic.ini:112:newrelic.appname = "PHP Application" /etc/php/7.4/cli/conf.d/newrelic.ini:112:newrelic.appname = "PHP Application" /etc/php/7.4/fpm/conf.d/newrelic.ini:112:newrelic.appname = "PHP Application"

Check the license with:

grep -inr "newrelic.license #configure-websites">Configure Your Websites section for details, then once done, reboot your server.

Configure New Relic on OpenLiteSpeed

As noted above, during my tests with OpenLiteSpeed, the Guided Install does not attempt to install the PHP Agent on OLS servers. We’ll now configure this manually.

1. Copy Your License Key

There will be multiple occasions where you will need your New Relic License Key below. Head over to your New Relic account, click your profile in the top right, and select “API Keys” from the dropdown.

Here you’ll see 3 options. We need the License key in the middle – click the 3 dots on the right-hand side and then click Copy Key.

2. PHP Agent Setup

Run the following commands in order:

echo 'deb http://apt.newrelic.com/debian/ newrelic non-free' | sudo tee /etc/apt/sources.list.d/newrelic.list
wget -O- https://download.newrelic.com/548C16BF.gpg | sudo apt-key add -
sudo apt-get update

2. Install the PHP Agent

Now we’re ready to run the installation. Run the following command:

sudo apt-get install newrelic-php5

The install will begin and then ask you to confirm you want to proceed. Type Y and hit Enter:

Paste your license key and hit Enter:

Give your server name a hit Enter:

The installation will complete shortly after.

3. Configure PHP Monitoring

For each version of PHP, we’re going to run through the same process. We’ll start with PHP 7.4.

Run the following two commands:

export NR_INSTALL_PATH=/usr/local/lsws/lsphp74/bin
newrelic-install

This will display the following options. Hit 1 and then Enter:

Now enter your license key and hit Enter:

You’ll now see 7.4 as an option. Hit 2 and then Enter to complete the installation for PHP 7.4.

Confirmation of successful installation will follow:

Now repeat the same steps for PHP 7.3 and 7.2 if you need them:

export NR_INSTALL_PATH=/usr/local/lsws/lsphp73/bin
newrelic-install
export NR_INSTALL_PATH=/usr/local/lsws/lsphp74/bin
newrelic-install

4. Update the Application Name Inside newrelic.ini Files

If you run the following, you should find that New Relic inside of /etc/php is already using the name you entered in step 2 above:

grep -inr "newrelic.appname newrelic.appname my-ols-server"
/etc/php/7.2/mods-available/newrelic.ini:112:newrelic.appname
/etc/php/7.3/mods-available/newrelic.ini:112:newrelic.appname
/etc/php/8.0/mods-available/newrelic.ini:112:newrelic.appname
/etc/php/7.4/mods-available/newrelic.ini:112:newrelic.appname

However, in the newrelic.ini files that have just been created, they will still be called “PHP Application”:

grep -inr "newrelic.appname newrelic.appname PHP Application"
/usr/local/lsws/lsphp74/etc/php/7.4/mods-available/newrelic.ini:112:newrelic.appname color: #ff0000;">PHP Application"
/usr/local/lsws/lsphp73/etc/php/7.3/mods-available/newrelic.ini:112:newrelic.appname color: #ff0000;">PHP Application"

To add your application name you’ll need to edit each file.

Edit them each with nano, for example:

nano /etc/php/7.4/mods-available/newrelic.ini

The “newrelic.appname” is located on line 112. Scroll down, change the name, then save the file with CTRL+O, followed by Enter. Then exit the file with CTRL+X.

Repeat for the remaining files.

5. Restart OpenLiteSpeed

We’re now set up. Next, run the following commands to finish up PHP service monitoring:

systemctl restart lsws
killall lsphp

6. Configure Your Websites

You’re now ready to configure your WordPress websites. See the following section for details, then once done, reboot your server.

Configure Your Websites

To monitor your websites as their own individual apps you can give them their own appname inside their individual .user.ini files.

You can edit a websites .user.ini file with the following command (replacing site.url with your domain name):

nano /var/www/site.url/htdocs/.user.ini

At the bottom of the file add the following and customize it for your website:

newrelic.appname = ""
newrelic.appname = ";"
newrelic.appname = "steve.com"
newrelic.appname = "steve.com;steve-server-ngx"

This pumps site-specific data to an app called “steve.com” inside New Relic, and if you also use the server-wide app name it will collect data for all your websites.

Save the file with CTRL+X followed by Enter. Exit nano with CTRL+X.

Repeat for your other websites.

10up Plugin

10up also have a free WordPress plugin that could potentially make this part easier for you. You can learn more about it here:

Reboot Your Server

Now everything has been configured, you just need to reboot your server. Before this, you could also follow the section below to add additional logs if you wish to do, then reboot after that.

Reboot your server with following command:

sudo reboot

New Relic is now setup on your server.

Add Additional Logs (Optional)

You may also want to push additional logs to New Relic as well.

To do this edit the logging.yml file with:

nano /etc/newrelic-infra/logging.d/logging.yml

Below is an example of how this might look if you add some additional logs (don’t forget to replace site.url with your domain if using as a template):

 logs: - name: alternatives.log file: /var/log/alternatives.log - name: cloud-init.log file: /var/log/cloud-init.log - name: auth.log file: /var/log/auth.log - name: dpkg.log file: /var/log/dpkg.log - name: newrelic-cli.log file: /root/.newrelic/newrelic-cli.log attributes: newrelic-cli: true - name: mysql.error.log file: /var/log/mysql/error.log attributes: logtype: mysql-error - name: site.url.access.log file: /var/log/nginx/site.url.access.log attributes: logtype: nginx - name: site.url.error.log file: /var/log/nginx/site.url.error.log attributes: logtype: nginx-error  
GridPane Logs

You can view all of your available logs in this article, including their file paths:

New Relic Documentation

For more info on logging and New Relic, check out there documentation here:

Uninstall New Relic

New Relic is likely something you’ll want to stick with. It’s a serious tool for serious workloads.

If you do want to remove it though, the following are the commands to remove the Infrastructure Agent and PHP Agent.

1. Uninstall the infrastructure agent

Run the following command:

sudo apt-get remove newrelic-infra

More information can be found here:

2. Uninstall the PHP agent

Run the following command:

apt-get remove newrelic-php5

And attempt to clean up any remaining configuration files with:

newrelic-install purge
apt-get remove --purge newrelic

More details can be found here:

“WordPress”də necə bloq açım?

WordPress PHP ve MySQL-ilə qurulmuş bloq sistemdir. WordPress ən güvənli, pulsuz bloq sistem (platforma) kimi dünyada yayılmışdır. Güvənli olduğuna baxmayaraq zəif cəhətlərindən biri sürətinin aşağı olmasıdır. Amma buna baxmayaraq dünyaca məşhurlaşmış bir sistem sayılır. WordPress-də bloq yaratmaq onu idarə etmək üçün sizə məlumat vermək istərdim. Bloqun idarəsi çox sadədir.

WordPress blog yaratmaq ucun:

http://en.wordpress.com adresə baxmaq lazımdı. Burada gördüyünüz kimi START THE BLOG var. Buraya daxil olandan sonra qeydiyyat səhifəsini görürsünüz. Gördüyünüz forumda bloqunuzun adını, parol və emailinizi yazırsınız. WordPress sizin bloqunuzu email vasitəsilə aktiv edəcək. Bunun üçün email-ə gələn məktubu açırsınız və orada gördüyünüz linkə daxil olursuz. Bu zaman sizin bloqunuz aktivləşmiş olacaq. Bundan sonra qeydiyyat səhifəsinə qayıdıb adınızı, soyadınızı və özünüz haqda qısa məlumatları yazıb qeydiyyatı bitirirsiniz.

Qeydiyyat bitmişdir. Bloqa daxil olmaq üçün bloqunuzun adını yazıb bloqa daxil oluruq.

Login parol daxil olunub, səhifəmizi görürük.

Bloqu idarə etmək üçün idarə panelimizə daxil oluruq.

Bunun üçün aşağıdakı ünvana daxil olursunuz.

Daxil edib idarə panelinə daxil olursunuz.

Bloqumda necə yazı yaza bilərəm?

Gördüyünüz kimi burada new post var. Buradan siz səhifənizdə Post yarada bilərsiniz. Bloqa mətn əlavə edib, mətnin başlığını, tam mətnini və bu mətnə şəkil əlavə edə bilərsiniz. Bundan başqa buradan siz səhifədə mətn yerinə text, link və şəkil əlavə edə bilərsiniz. Postları dəyişmək və ya silmək istəyirsinizsə edit funksiyasının köməyilə bunu edə bilərsiniz. Bu səhifəyə daxil olarkən gürürsünüz ki, burada blogda olan postların qısa başlığı, müəllifi, hansı kateqoriyaya aid olması və yaradılması tarixi göstərilib. Siz istədiyiniz postu dəyişib, silə bilərsiniz. Posta istədiyiniz tarixi vermək də mümkündür. Bunun üçün panelin sağ tərəfində Preview Change bölməsində publish on funksiyasına edit etmək lazım gələcək.

Bloqumda necə kateqoriya yarada bilərəm?

Bloqunuza kateqoriya əlavə etmək də mümkündür. Bunun üçün Post menyusundan Categories funksiyasına daxil olub kateqoriya yaradırsınız. Kateqoriyanın adını yazıb Add Category edirsiniz.

Bloquma necə şəkil əlavə edə bilərəm?

Bunun üçün media funksiyasından istifadə edəcəksiniz. İstədiyiniz şəkli kompyuterinizdən seçib onu bloqa daxil edirsiniz. Şəkili upload etdikdən sonra şəkil haqqında qısa başlığı, təsvirini və şəkilaltı imzanızı yazıb əməliyyatı tamamlayırsınız.

Bloqdakı yazılarımda başqa saytlara və ya bloqlara keçid vermək üçün nə etməliyəm?

Burada Link funksiyasından istifadə edəcəksiniz. Bloqunuza yerləşdiriləcək saytın və ya bloqun adını, adresini, təsvirini, və hansı kateqoriyaya aid olduğunu daxil edirsiniz. Bundan başqa istəsəniz ki, daxil etdiyiniz link başqa səhifədə açılsın bunun üçün Target bölməsindən _blank aktiv edirsiniz. Bu zaman linki tıklayanda link başqa səhifədə açılacaq.

Bloqda səhifələr düzəltmək üçün nə etməliyəm?

Bu bloqun ən önəmli funksiyalarindan biridir. Səhifə yaratmaq üçün Page funksiyasından istifadə etmək lazımdır. Buradan add new seçib yeni səhifə yaratmaq mümkündür. Yeni səhifənin adını daxil edirsiz ve səhifənin tam mətnini daxil edib save düyməsini sıxırsınız. Bu zaman dəyişikliklər yadda saxlanılır. Bunları səhifədə görmək üçün isə publish düyməsini sıxırsınız.

Bloqdakı şərhləri necə redaktə edim?

Bloqunuzda yazılarınıza verilən şərhlərə baxmaq üçün Comment funkiyasından istifadə edirsiniz. Buradan bloqdaki yazılara verilən şərhləri görə bilərsiniz. Bundan başqa yazılarınıza verilən şərhləri bloqunuzda görmək istəmədikdə onları silə bilərsiniz və ya şərhləri dəyişib səhifənizdə göstərə bilərsiniz.

Bloqumda necə sorğu göstərə bilərəm?

Blogunuzda sorğu göstərmək istəyirsinizsə poll funkiyasından istifadə edirsiniz. Buradan add new seçib sorğu yaradırsınız. Sorğunun sualını daxil edib ,sonra cavablarınızı istədiyiniz sayda daxil edə bilərsiniz. Bundan başqa sorğunuzun görünüşünü(dizayn) dəyişdirə bilərsiniz.

Bloqumun görünüşünü (dizayn) dəyişmək üçün nə etməliyəm?

Bloqunuzun görünüşünü dəyişmək istəyirsinizsə, Appearance menyusundan Theme funksiyasını seçirsiniz. Themaya daxil olduqda burada temaları və onlar haqqında qısaca məlumatlar göstərilir. Hər hansı birini seçib böyük ölçüdə baxa və onu səhifəniz üçün aktiv edə bilərsiniz.

Bloqumda özüm haqqımda məlumatı necə dəyişə bilərəm?

Settings-in alt funksiyalarından general funksiyasını görürsünüz. Bura baxdıqda görürürük ki, bloq haqqında əsas məlumatlarımız buradadır. Bloqunuzun adı, şəkiliniz, bloqun idarə panelinin dili və s. Buradan istədiyiniz dəyişiklik apara bilərsiniz. Yazdığınız postun formatını dəyişmək, yazının uzunluğu, bir səhifədə neçə postun görünməsini settings-dən idarə edə bilərsiniz. Yüklədiyiniz şəkillərin bloqa çıxmasından öncə onun ölçülərini buradan tənzimləmək mümkündür.

Əgər siz bloqunuzun ləğv edilməsini istəyirsinizsə, Delete Blog bölməsinə keçib orada bloqunuzu silə bilərsiniz.

Mənbə : Medialaw.az

Bunları da oxuyun :

P.S. Yazının müəllifi Etibar Salmanlıdır. Onun yazısını öz bloqumda paylaşmaqda məqsəd hamıya yardımçı olmaqdır.

Comments are closed, but trackbacks and pingbacks are open.