Note: Please go to docs.rightscale.com to access the current RightScale documentation set. Also, feel free to Chat with us!
Home > Guides > Dashboard Users Guide > Report > New Relic > Actions > Adding New Relic to your RightScale Account

Adding New Relic to your RightScale Account

Objective

Overview of how to add New Relic to your RightScale account so that you can monitor, troubleshoot and optimize your Java, Ruby, .NET, PHP and Python applications. New Relic installation RightScripts are available in the MultiCloud Marketplace (Python RightScripts are available upon request to rightscale@newrelic.com).  To learn more, visit our New Relic partner page.  

Table of Contents

Prerequisites

You will need a New Relic account.  If you do not have a New Relic account, follow the sign up instructions below. New Relic currently supports Java, Ruby, .NET, PHP and Python applications.  To learn more about New Relic, visit their website and/or our New Relic partner page.

Steps

Sign up for New Relic

As a RightScale customer, you get New Relic Standard free of charge through our partnership. To sign up for your free New Relic accout, follow these simple steps:

  1. Login or go to your RightScale Dashboard
  2. Go to Reports -> New Relic
  3. Create a new account or enter existing New Relic credentials

 

Once you create a new New Relic Account, you will receive a API key and a temporary password.  Make sure to update your password the first time you log in to your account.  Once you have your API key, click the Use Existing New Relic Credentials button and enter your API key.

All new accounts start with a free 14-day trial of their Professional level of service.  If you wish to upgrade to Pro you will need to contact New Relic.  You cannot upgrade your New Relic subscription within the RightScale Dashboard.

Add "APP New Relic RPM" RightScript to ServerTemplates

Before you can see any data from New Relic in your Dashboard, you will need to add the appropriate New Relic RightScript to your ServerTemplates:

  1. Go to Design -> MultiCloud Marketplace -> ServerTemplates
  2. Search for the "New Relic Performance Monitoring Toolbox" ServerTemplate and import it to your 'Local' view
  3. When you import the ServerTemplate, the New Relic RightScripts will become available to your account
  4. The ServerTemplate contains different RightScripts that you can add to your ServerTemplates:
  • APP New Relic RPM for PHP: Installs and configures the New Relic PHP agent and a local proxy daemon.  Supported versions for PHP are 5.2 and higher on Apache 2.2 or 2.4.
  • APP New Relic RPM for Java Tomcat: For use with Tomcat5 & Tomcat6 ServerTemplates.  Installs New Relic RPM for Java and configures it for use with Tomcat.
  • APP New Relic RPM for .NET: Installs and configures the New Relic agent to monitor .NET applications.  Supported versions are 2.0 and above running on Windows Server 2003, Windows Server 2008, Windows Vista, Windows 7 and Windows Azure.
  • APP New Relic RPM for Ruby: To use the New Relic agent for your Ruby on Rails application, please see the New Relic support docs
    on how to add it to your application.
  • Python: Contact New Relic.


In the example below we will add the "APP New Relic RPM for PHP" RightScripts to a PHP application server:

Add the "APP New Relic RPM for PHP" RightScript as a boot script to the ServerTemplate that is being used to run your PHP application servers.  This will automatically deploy the New Relic agent when a new server is launched with that ServerTemplate.   (RightScale is the publisher.)

If your PHP application is already running on a server, you can add it as an operational script under the "Scripts" tab and run the action on the running server. 

run_script.png

 

You will also need to define the following input value for the new script.  You can either manually enter the key or create a credential for it.

  • NR_LICENSE_KEY: Enter your New Relic License key.
     

enter_key.png

View New Relic Monitoring Data

After you've added the New Relic RightScript and the appropriate input value, New Relic can now monitor your application(s). To view your New Relic data:

  1. Go to Reports -> New Relic.
  2. You should now see a list of your application(s) in your deployment.  You will only see the names of the applications that are on servers where you've run the New Relic RightScriptA Host is a server and an Instance is an instance of an application.

    nr_rightscale_applist.png

  3. Select an application name to view the monitoring data from New Relic.  The link will open in the same browser window.  You may want to open it in a new tab or window.
  4. Once you've logged in, be sure to change your password if you haven't already.  Click the Profile link at the top-right and update your password.
  5. Use the buttons and navigation at the top to view different performance data and graphs.

newrelic_screenshot.png

 

You must to post a comment.
Last modified
16:44, 13 Jun 2013

Tags

Classifications

This page has no classifications.

Announcements

None


© 2006-2014 RightScale, Inc. All rights reserved.
RightScale is a registered trademark of RightScale, Inc. All other products and services may be trademarks or servicemarks of their respective owners.