We hope you've heard the news that the New Relic One observability platform is now programmable. As the central component of an observability platform, we believe programmability gives you the ability to connect your observability data to your business, so you can make data-driven decisions—on your terms. To that end, New Relic One gives you the same tools our own engineers use to build the curated experiences you know and love. With these tools, you can build and deploy custom applications on New Relic One that connect your observability data, gathered from myriad sources—including third-party open-source data—all in one place.

To show you the art of the possible—and to inspire your own app creations—we worked with members of the New Relic community to build a handful of open source applications … and then we (and all of you!) kept going. In fact, new apps are coming in every day. And we hope to see app contributions by New Relic users continue.

In this blog series, we’ll highlight the most popular apps available today. The best part: They’re all open source and ready to be deployed right now!

In this edition, we cover:

  • Status Pages
  • GitHub Integration
  • Groundskeeper
  • Customer Journey

Status Page

Status Page aggregates system status and incident summaries, Statuspage.io style, from multiple providers within a single dashboard. Normally, this is information you’d track down one provider at a time, but Status Page makes it easy to check the status of your key dependencies in one place, at a single glance.


Status Page brings together system status and incident report data from key dependencies—making it accessible to your team instantly and easily.

Fork or deploy the Status Pages app from GitHub.

Specific requirements for this app

All you need to get up and running are some status pages you’d like to monitor. Popular options include:

Also, keep in mind that currently Status Page can pull in data only from status modules backed by Statuspage.io and Google Status pages.

GitHub Integration

Having the right information at your fingertips makes a big difference when you’re under the gun to understand a service and resolve an incident. The GitHub Integration connects your New Relic One apps and services to the repos containing relevant documentation, readme files, runbooks, and other essential information.

Associate any service or application with its GitHub repository as a one-time action, and you can quickly see that application's readme file, as well as a list of active source code contributors.


The GitHub Integration gives you quick access to the documentation for an app or service, including relevant readme files.

GitHub Integration also displays a list of the most active contributors to a project, giving you easier access to additional problem-solving resources.

Using the GitHub Integration involves a simple, one-time association between any service or application, and its repository.

You'll also need to create or use a personal access token, as a one-time setup step, to ensure data security and integrity.

Fork or deploy the GitHub Integration app from GitHub.

Note: Integration with GitHub requires that you create or use a private access token as a one-time setup step. See GitHub's doc on access tokens for full instructions.

Specific requirements for this app

  1. A GitHub (either public or private enterprise instance) organization and access to New Relic One.
  2. The ability to generate a personal access token in GitHub.

Agent Groundskeeper

Agent Groundskeeper displays real-time version information for the New Relic APM agents running across your software estate.

See which services are up to date (with various upgrade SLO time windows), which are out of date, and which have instances deployed with different versions. Quickly and easily zoom in on your estate by filtering on tags, and search by account, language, and app name.


Agent Groundskeeper gives you real-time version information for every APM agent running anywhere within an enterprise environment.

Fork or deploy the Agent Groundskeeper app from GitHub.

Specific requirements for this app

  1. New Relic APM Agent(s) installed and the related access to New Relic One.
  2. (Recommended) Add customer-defined labels to your APM applications to make use of New Relic One tag filtering. See our documentation here.

Customer Journey

Think of this app sort of as a NRQL funnel query on steroids. This application is designed to allow devops teams, product managers, and digital marketers to examine a number of pre-defined measures in a side-by-side comparison between cohorts (columns) of users through a set of steps (rows) where ...

  • Rows equal Steps in a workflow
  • Columns categorize a Series or cohort of users
  • Measures define the Stats that you want to observe for each Series and Step

The application employs three visualizations to examine, compare, and present its results:

  1. Multi-series Funnel: This visualization combines a third-party funnel library with the New Relic One NerdGraph query to execute three New Relic NRQL queries in the same GraphQL request. The results are aligned into one data set that is delivered to the funnel visualization.
  2. Data panels: For each row (Step) and column (Series), the app renders a set of measurements (Stat). Those calculations can apply KPI thresholds to color-code the information. Each panel is also clickable, leading to a more detailed overview.
  3. Detail Nerdlet: For any Journey, Series, and Step, there's a Nerdlet that will display the more detailed KPIs as well as a timeseries view of the the given Stats for the selected row and column.

Customer Journey can apply KPI thresholds to color-code important information. Each panel is also clickable, leading to a more detailed overview.

 


A Nerdlet will display more detailed KPIs as well as a timeseries view of the given Stats for a selected row and column.

Fork or deploy Customer Journey from GitHub.

Specific requirements for this app

  1. Access to New Relic One.
  2. Configuring the journeyConfig.js.

What are you waiting for? Deploy these apps now!

To deploy any of these apps you need:

Once you have these requirements in place, deploying an application locally—in this example, Status Pages—is as easy as running a few commands:

nr1 nerdpack:clone -r https://github.com/newrelic/nr1-status-pages.git

cd nr1-status-pages

nr1 nerdpack:serve

Or you could download, configure, and deploy an account-specific instance of Status Pages to your New Relic account using the following commands:

nr1 nerdpack:clone -r https://github.com/newrelic/nr1-status-pages

cd nr1-status-pages

nr1 nerdpack:publish

nr1 nerdpack:deploy -c STABLE

nr1 nerdpack:subscribe -c STABLE

Then go to the homepage of one.newrelic.com and select the app's launcher (unless otherwise noted above).

Check out these other resources for using—and building!—New Relic One applications

While we’d love you to use any of the applications we’ve built, we also created plenty of resources to help you build your own New Relic One applications:

[embed]https://www.youtube.com/watch?v=FhEwaZuY81o[/embed]

Contribute to these open source projects

We welcome contributions to any of our open source applications. If you’d like to contribute, please review our Contributors Guide. Keep in mind that when you submit your pull request, you'll need to sign our Contributor License Agreement (CLA). If you'd like to execute our corporate CLA, or if you have any questions, please drop us an email at opensource@newrelic.com.

Be sure to check in regularly! We’ll preview more of our very best apps in future editions of this series.