• Log inStart now

Now that we've migrated this site's content to docs.newrelic.com, we're EOLing this site on June 21st 2024.

Subscribe to your New Relic application

Course

This lesson is part of a course that teaches you how to build a New Relic application from the ground up. If you haven't already, check out the course introduction.

Each lesson in the course builds upon the last, so make sure you've completed the last lesson, Publish your New Relic application, before starting this one.

In the last lesson, you published your A/B test app to the Instant Observability catalog. You then submitted your app's description, metadata, documentation, and screenshots. Now, it's time to subscribe your account to the published app.

Subscribe to your application

Now that your application is published, you can view it by visiting the Add data page of New Relic:

Navigate to Add data

From here, you can subscribe to applications.

Step 1 of 4

From the catalog, click your app:

Your app in the catalog

Tip

If you don't see your app in the catalog, you may have to refresh the page or clear your browser cache.

This opens the app's About page and shows the details you submitted to the catalog in the last lesson:

App details

Step 2 of 4

At the top left of this page, click Add this app:

Add this app

This opens the Account access view.

Step 3 of 4

From Account access, select the account you want to subscribe to the application and the channel to subscribe to. Finally, select Update 1 account:

Subscribe

Here, you only had one version tag to subscribe to. In other projects, you may have other versions with other tags.

Technical detail

Notice that the web UI uses the term "channel" instead of "tag". This is a relic of an older version of New Relic apps. With later versions of nr1, we've moved toward "tags" terminology. Eventually, the UI will also use "tags".

Step 4 of 4

Navigate to the Apps page, and see the AbTest app under Your apps:

Your apps

From there, you can click your app and use it like you did when you were serving it locally!

Tip

If you don't see the app under Your apps, you may have to refresh the page or clear your browser cache.

It's important to note that you can subscribe to applications in the catalog with the nr1 CLI. Read our documentation to learn more.

Unsubscribe from your application

The process for unsubscribing from an application is similar to that of subscribing.

Step 1 of 3

Click the "i" icon on your app launcher:

App details from the launcher

Here, you see the same app details you saw when your app was in the catalog.

Step 2 of 3

Click Manage access:

Manage access

This opens the Account access view.

Step 3 of 3

From Account access, deselect the account you want to unsubscribe from the app, and select Update 1 account:

Unsubscribe

If you navigate back to Apps, you will see your app is no longer under Your apps, but can be found again in the Instant Observability catalog.

Throughout this course, you've built a New Relic application from the ground up. You've used the nr1 CLI to create a Nerdpack, launcher, and Nerdlet. You've used many components from the SDK. You've learned how to publish, tag, subscribe, and unsubscribe to and from apps in the Instant Observability catalog. You've also learned how to submit metadata to the catalog.

Next steps

Now that you know how to build a New Relic application, you can read the SDK documentation to learn more about all the components you can use to create apps for your own purposes.

Course

This lesson is the final part of a course that teaches you how to build a New Relic application from the ground up. Congratulations on making it to the end!

Copyright © 2024 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.