Subscribe to a Nerdpack

Subscribe to a Nerdpack to use it in the New Relic platform. Unsubscribe from Nerdpacks you no longer use.

Update your CLI

Before you run any commands, ensure that you have the latest version of the CLI:

bash
$
nr1 update

Check your permissions

To subscribe to a Nerdpack, you need:

Publish your Nerdpack

You need to publish Nerdpacks that you create before you can subscribe to them:

  1. Publish your Nerdpack
  2. Tag your Nerdpack if it's published and doesn't yet have a tag

Subscribe to a Nerdpack

Subscribe to a published Nerdpack, with either the web UI or the nr1 CLI, to use it in your account. Subscribing allows you to select the tagged version you want to use as well as the account you want to subscribe with. This lets you control what Nerdpacks you use in your account.

Tip

When the tag you've subscribed to gets an update, New Relic updates your Nerdpack automatically.

Step 1 of 6

From New Relic homepage, navigate to Add data in the top navigation bar:

Navigate to the Add data

Step 2 of 6

Find your published Nerdpack using the apps filter or search bar:

Published Nerdpack

All published Nerdpacks are shown here. However, the one you're looking for maybe filtered out. Adjust the filter to find the Nerdpack you're looking for:

Navigate to Apps & Visualizations

Step 3 of 6

Select the Nerdpack you want to add to your New Relic account:

Select a Nerdpack

Step 4 of 6

Click Add this app:

Select Add this app

This button says Manage access if you're already subscribed to the Nerdpack.

Step 5 of 6

Select the account to subscribe with and the tagged version to subscribe to. Then, update your account(s):

Subscribe to the Nerdpack

Tip

In the web UI, and some places in the CLI, we refer to tags as channels. This is a relic of a past implementation of Nerdpack versioning. Ignoring historical and implementation details, consider them to be synonyms.

Now you, and members of the accounts you've subscribed with, can launch the Nerdpack from New Relic.

Step 6 of 6

If you subscribed to an app, find it under Your apps:

Your apps

If you subscribed to a visualization, find it under Custom visualizations:

Navigate to Custom visualizations

Subscribe from the command line

If you've published your own Nerdpack, it may be quicker to subscribe to your Nerdpack with the nr1 CLI.

Step 1 of 3

Navigate to your Nerdpack's root directory:

bash
$
cd my-awesome-nerdpack

For simplicity, this guide refers to your Nerdpack as my-awesome-nerdpack.

Step 2 of 3

Ensure that your Nerdpack was published and tagged:

bash
$
nr1 nerdpack:info
Id: ab123c45-678d-9012-efg3-45hi6jkl7890
Region: us
Account ID: 1234567
Local version: 1.0.0
Subscription Model: OWNER_AND_ALLOWED
Version Count: 1
Version  Date               Tags
-------  -----------------  ------
1.0.0    a few seconds ago  STABLE

You should see at least one published version with a tag. It doesn't have to be STABLE. You can subscribe to any tagged version.

Step 3 of 3

Subscribe to your Nerdpack:

bash
$
nr1 nerdpack:subscribe --channel=STABLE
Subscribed account 1234567 to the nerdpack ab123c45-678d-9012-efg3-45hi6jkl7890 on the STABLE channel

Here, you've subscribed to the STABLE tag. You can also subscribe to DEV and BETA tags from the CLI, but the subscription command doesn't allow for arbitrary tags. To subscribe to any other tagged version, you need to use the web UI.

Similar to the web UI, the term channel nr1 nerdpack:subscribe is a reference to an older implementation of Nerdpack versions.

Technical detail

nr1 nerdpack:subscribe is an alias for nr1 subscription:set.

Read the nr1 subscription:set documentation to learn more. Or, view the nr1 help page:

bash
$
nr1 subscription:set --help

Unsubscribe from a Nerdpack

Unsubscribe from a Nerdpack to remove it from your account.

Step 1 of 4

From New Relic, navigate to Apps in top navigation bar:

Navigate to the Apps page

Step 2 of 4

Click the "i" icon next to the Nerdpack you're subscribed to:

Navigate to the Apps page

This opens the detail page.

Step 3 of 4

Click Manage access:

Manage access

Step 4 of 4

Deselect the accounts you want to unsubscribe with. Then, update those accounts:

Unsubscribe from your app

Unsubscribe using the command line

Quickly unsubscribe your CLI profile from Nerdpacks.

Step 1 of 3

Navigate to your Nerdpack's root directory:

bash
$
cd my-awesome-nerdpack
Step 2 of 3

View your profile's subscriptions:

bash
$
nr1 subscription:list
Listing subscribed deployed nerdpacks on your account:
Version  UUID                                  Name              Date         User
-------  ------------------------------------  ----------------  -----------  -------
0.6.4    384de6e5-8e57-4d56-9d13-299ee7ae8641  Account Maturity  a month ago  2774472
Step 3 of 3

Unsubscribe from the Nerdpack with the UUID:

bash
$
nr1 nerdpack:unsubscribe --nerdpack-id=384de6e5-8e57-4d56-9d13-299ee7ae8641
Unsubscribed account 1234567 from the nerdpack 384de6e5-8e57-4d56-9d13-299ee7ae8641 on the STABLE channel.

Tip

nr1 nerdpack:unsubscribe is an alias for nr1 subscription:unset.

Read the nr1 subscription:unset documentation to learn more. Or, view the nr1 help page:

bash
$
nr1 subscription:unset --help

Resolve issues with accessing your published Nerdpack

Sometimes, when you subscribe to a Nerdpack, you may run into issues. Whether you can't subscribe or see duplicate subscriptions in your account, consider some common solutions for resolving these issues.

Tag your Nerdpack version

When you subscribe to an Nerdpack, you choose a specific tag. So, if the Nerdpack you're trying to subscribe to isn't tagged, or doesn't have the tag you're targeting, tag your release version:

bash
$
nr1 nerdpack:subscribe --channel=DEV
›   Error: Nerdpack ab123c45-678d-9012-efg3-45hi6jkl7890 is not deployed to channel DEV. You have to deploy it first
›   Code: PACKAGE_NOT_DEPLOYED
$
nr1 nerdpack:tag --tag=DEV
✔  Tagged ab123c45-678d-9012-efg3-45hi6jkl7890 version 1.0.0 as DEV.
$
nr1 nerdpack:subscribe --channel=DEV
Subscribed account 1234567 to the nerdpack ab123c45-678d-9012-efg3-45hi6jkl7890 on the DEV channel.

If you subscribe without a --channel argument, the default channel is STABLE, so make sure you have a STABLE version in this case:

bash
$
nr1 nerdpack:subscribe
›   Error: Nerdpack ab123c45-678d-9012-efg3-45hi6jkl7890 is not deployed to channel STABLE. You have to deploy it first
›   Code: PACKAGE_NOT_DEPLOYED

Subscribe with the web UI

When you subscribe with the CLI, you pass a --channel argument to select a tag. A channel is, for all intents and purposes, a tag. This term is a relic of a past implementation of Nerdpack versioning.

However, while the terms are synonymous, using --channel is limited in the CLI. When you subscribe with a --channel, you can only choose between DEV, BETA, and STABLE. So, to subscribe to a different tag, use the web UI:

bash
$
nr1 nerdpack:subscribe --channel=QA
›   Error: Expected --channel=QA to be one of: DEV, BETA, STABLE
›   See more help with --help
›   Code: UNKNOWN

Subscribe to QA on the web