New Relic One transition guide July 2020

Welcome to New Relic One! We’ve streamlined and enhanced your Full-Stack Observability platform to make it open, connected, and programmable. This transition guide explains how to take advantage of new capabilities to achieve the same goals you’re used to doing in New Relic, and more!

We will continue to improve and simplify your experience with the New Relic One platform. As always, we're here to help, and we also want to learn what you like and dislike about your new experience.

Want to view our UI in dark mode? Learn how to switch between a dark or light theme.

NR One transition: feedback icon To give us immediate feedback: At the top of any New Relic One UI page, click the comment icon.

See why it matters

Whether you're a software engineer, part of an operations team, a site reliability engineer, or an executive, you must keep your business running and your customers satisfied. Watch this video (approx. 3:30 minutes) to start making the transition to New Relic One.

With New Relic One, you can quickly and easily:

  • Observe, visualize and troubleshoot your entire software stack. Anticipate, find, and fix problems faster, and understand how your software performance drives business outcomes.
  • Pinpoint outages and performance problems originating from anywhere across your entire software stack to get things up and running in moments.
  • Improve uptime and performance, drive operational efficiency, and accelerate time to market.
  • Instrument everything so you have no blind spots, understand your complex systems quickly so you can act more effectively, and build views and workflows that drive your business.
  • Collect all your telemetry data in one place to power Full-Stack Observability and insights driven by Applied Intelligence so you can confidently improve service reliability and accelerate time to market.

[information icon] Learn more for a successful transition:

Get started

New Relic One is a unified user experience that makes it easier for you to navigate the platform, find and diagnose problems, and take advantage of new, more powerful features. To get started, go to or as applicable.

NR One transition: home page 070120
To customize your New Relic One experience, you can add your favorite apps, teams, and other resources to your homepage.

From the New Relic One homepage, you can:

  • See the current health across your ecosystem.
  • Troubleshoot problems and find patterns in anomalies.
  • Query data and share information with others.
  • Find areas to optimize performance.

If your New Relic One homepage is blank when you first visit it, add your favorite apps, services, teams, etc. to it. Then the homepage will have everything important about your ecosystem's resources in one place, including their current health, alert patterns and violations, and links to more details and resources.

[information icon] Learn more for a successful transition:

Navigate the UI

New Relic One gives you a single platform that unites your telemetry data, connects your full-stack resources, and helps you build more perfect software. We've organized the homepage so you can navigate the UI in any way that best fits your needs.

NR One transition: top nav links
Navigate the UI Tips for a successful transition
Unified view on homepage

In the previous UI experience, you had to go to separate pages to view your applications (via or view your hosts and integrations (via The new UI combines all of your full-stack monitoring needs on a single homepage for fast, easy access.

When you go to or, you see links to all of your resources. You can also query your telemetry data, create charts, and share your dashboards from here.

Entity explorer

The entity explorer link in the top nav takes you to all of your services, hosts, applications, and groups. You can quickly search and filter, select favorites, review metadata, and get color-coded health status at a glance.

If you need to copy your GUID in the metadata and it truncates, use CMD C (Mac) or CTRL C (Windows).

Global search

You can search across all apps and resources with the global search feature at the top of the homepage. You can also search across all data types reporting to New Relic. Whether it's a dashboard, an application, a host, a synthetic script, or a cloud service, one search can find them all.

Online help

To view documentation and support resources directly in the UI: At the top of any page, click the question [question icon] icon.

Customizable experience NR One transition: extend icon 070620

We've moved the app launchers to their own experience. From the homepage, click the apps icon, then:

  • Add favorite apps and entities so they are easily in sight.
  • Add others in your account if you are a Nerdpack manager.
  • Browse the New Relic One Catalog of publicly available apps and apps that you create directly in the UI.
  • Download the CLI to build your own apps.
UI views toggle

If the original UI view has a feature or functionality you want, or if New Relic One presents a feature that you preferred in the original view, you can toggle between experiences at the top right of the page.

[information icon] Learn more for a successful transition:

New Relic One has multiple ways to query and chart your data from the Dashboards link on the top nav. That's why Insights is not listed there. However, you can still access your old Insights dashboards and data from the More dropdown at the top of the homepage, or simply click Dashboards. Learn more about how to make the transition from Insights to New Relic One.

Get started with instrumentation

NR One transition: add more icon 070620 Get data from your stack flowing into New Relic from a single location, and stay up to date with the latest agents, integrations, and reporting services.

  • If you're already using New Relic One: At the top of the UI, click Add more, then search for or select whatever you want.
  • If your New Relic One homepage is blank: Click Add more data, then search for or select whatever you want.
NR One transition: Add more data page
When you click Add more, New Relic One presents a unified page where you can extend your instrumentation with any programming languages and frameworks you need.

The UI immediately provides interactive steps to select the languages and frameworks you need.

Extend your instrumentation Comments
Front-end and back-end monitoring

Programming languages, frameworks, and customer experience monitoring for:

  • Back-end (C, Go, Java, .NET, Node.js, PHP, Python, Ruby)
  • Front-end (browsers or synthetic monitors)
  • Mobile (Android, iOS, tvOS) applications
Cloud and platform technologies

Cloud computing, container orchestration, and serverless technologies, including Amazon Web Services (AWS), Amazon ECS, Microsoft Azure, Google Cloud Platform, Kubernetes, and Lambda

Host operating systems

Linux and Windows systems, including Amazon Linux, CentOS, CoreOS, Debian, RHEL, SLES, Ubuntu, and Windows Servers

Log ingestion

Plugins for log aggregators and log forwarders, including Fluentd, AWS Cloudwatch, Logstash, Fluent Bit, and AWS FireLens


Data stores, message brokers, proxy servers, and other services

Open source monitoring systems

Integrations to other telemetry collection systems, such as JMX, Nagios, Prometheus, SNMP, StatsD, Kamon, Micrometer, and OpenTelemetry

[information icon] Learn more for a successful transition:

Explore your data

Collect, explore, and alert on all your metrics, events, logs, and traces from any source with our open and unified telemetry database. Automatic integrations for open-source tools enable easy setup, eliminating the cost and complexities of hosting, operating, and managing additional monitoring systems or data stores.

To use a single resource where you can explore any data type, including metrics, events, logs, and traces: At the top of any New Relic One page, click the Query your data icon.

NR One transition: explore data

We offer several ways to help you explore your data:

  • If you don't want to use NRQL, use the data explorer to navigate your data and create customized visualizations.
  • If you're new to running queries, go to the query builder, where you can run queries and build charts using our assisted (basic) mode.
  • If you're comfortable with running NRQL or PromQL-type queries, try the query builder's advanced mode.
  • If you want to run multiple queries, include TIMESERIES.
NR One transition: data explorer
From the New Relic One data explorer page, you can navigate all data types, or you can click query builder to query, visualize, and share this data.

[information icon] Learn more for a successful transition:

If you feel more comfortable navigating from Insights while making the transition from Insights to New Relic One: At the top of any New Relic One page, select More > Insights.

Troubleshoot more efficiently

Everything is interconnected with New Relic One. The relationships between your apps, services, and alerts are all combined in a single, unified user interface. You get a holistic picture of your entire technology ecosystem, especially when problems are detected.

NR One transition: Alerts and AI 070620
New Relic One's Alerts & AI link gives you a single starting point to identify, troubleshoot, and prevent problems across your ecosystem before they impact your customers.

For example:

  • New Relic Diagnostics automatically detects common problems with New Relic agents and suggests troubleshooting steps. It can also attach troubleshooting data to your support ticket automatically.
  • Alerts will notify you when things that matter to you are going wrong, while Applied Intelligence and muting rules help you screen out items you don't want to see.
  • Workloads give you the tools to group and monitor entities in ways that make sense to you. This helps you to understand your complex systems, detect issues, and understand how and why something goes wrong, so you can resolve problems quickly.

[information icon] Learn more for a successful transition:

Use developer resources

New Relic was founded by developers for developers, and that mindset is still a cornerstone of our mission. We have centralized our resources to deliver the code where you can more easily access, customize, and contribute to it.

NR One transition:

For example,, our developer hub, helps you build apps and other solutions. You can customize the data you want to see, visualized the way you want to see it.

The developer site is open source, and we welcome your input and requests for content! We have a growing selection of guides to help you get started and try out several development tasks to:

  • Collect data
  • Automate workflows
  • Build apps
  • Use the New Relic API Explorer or NerdGraph API Explorer

NR One transition:

Through, we are creating a community of developers and a library of open source projects (more than 180 at last count). This site will help you get the precise data you need and visualize it the way you most want to see it.

We also recognize developer expertise and leaders in the technical community through our developer champion program. Check it out and get involved!

[information icon] Learn more for a successful transition:

New Relic feature end-of-life announcements

Many changes to your UI experience are related to functions and features that reached end of life (EOL). For more information, including action items to help you make a successful transition from your EOL experience to your new experience in New Relic One, see the July 2020 EOL announcements.

For more help

If you need more help, check out these support and learning resources: