Partnership accounts, users, and subscriptions

Organizations with New Relic partnership accounts have access to an enhanced hierarchical way of organizing their master accounts and sub-accounts. This describes basic concepts and features available with a New Relic partnership.

Partnerships with New Relic

There are two types of partnerships:

  • A partnership: A service provider who partners with New Relic in offering New Relic products to their customers. Heroku is one example of a New Relic partner.
  • A customer partnership: a New Relic customer with a large, complex account hierarchy that uses New Relic's partnership account structure. (New Relic contacts customers whose account structures would benefit from such a change.)

Partnerships are identified by a numeric PARTNER_ID. In some cases, a New Relic customer may have more than one partnership; for example, when one section of New Relic users must be managed differently from another.

  • Partnerships are administered by a partnership owner account. The account that owns a partnership functions differently from a regular account.
  • If multiple partnerships have been set up, each has a unique PARTNER_ID.

Account hierarchy

New Relic partnership organizations are comprised of the partnership owning account, partnerships, master accounts, and sub-accounts. A partnership can have multiple master accounts and sub-accounts.

To understand how sub-accounts and master accounts scale with EU region accounts, see EU region account hierarchy.

If you do not have a partnership organization, you can only have one master account. For more information, see Manage apps or users with sub-accounts.

partnership-hierarchy.png
All master accounts and sub-accounts roll-up to your partnership account.

Partnership owner accounts

The partnership owner account is the entity that is used to administer a partnership. It is used to control which users manage accounts under partnerships, have access to the partner API, and manage other aspects of the partnership.

Do not monitor your own applications from the partnership owner account. Instead, create an account within the partnership and monitor apps from that account.

Users on the partnership owner account (POA) can access accounts under their partnership(s) and enjoy User level privileges. Admins on the POA can can access accounts under their partnership(s) and enjoy Admin level privileges, including permission to manage users. However, the Owner of the POA will still only have Admin level access on the accounts under the partnership. That means that they cannot enable SAML SSO, change the account owner, cancel the account via the UI, etc.

The partnership owner account enjoys special privileges, and it lets you exercise the capabilities defined in your partnership agreement with New Relic. For example, you may use your partnership owner account with the New Relic Partnership API to set up and manage users on your accounts or to view your customers' performance data in the New Relic UI.

Many of the Partnership API calls return an account status as part of the XML.

Sub-accounts with partnerships

Sub-accounts behave differently than other New Relic accounts provisioned through your partnership:

Sub-accounts Comments
Account creation
  • Sub-accounts cannot be created through the Partnership API. Instead, you must create sub-accounts through the New Relic user interface.
  • In order to group accounts through the New Relic user interface, your partnership must have Admin privileges, and the account must have the appropriate subscription level. If you have any questions about partnership privileges or subscription levels, contact your New Relic account representative.
  • Sub-accounts do not have a New Relic subscription of their own. They inherit the master account's subscription.
Billing
  • Billing is applied at the master account level.
  • Exception: Reseller partnerships are presented with consolidated billing for all accounts under the partnership.
Permissions
  • Admin-level users on a master account have the ability to create, modify, and delete sub-accounts for the master account.
  • Users that have been granted access permissions on a master account automatically inherit the same level of access for all sub-accounts. This is also true for add-on roles.
  • Exception: Sub-account users will not receive alert emails or weekly report emails unless they are explicitly granted permission on these sub-accounts.

Account users

You can use the Partnership user API to add and maintain your customer users. An account must always have at least one person (the Owner) associated with it. For security purposes, you cannot change an Account Owner via the Partnership user API. This must be done on the Users page in our UI.

In addition, a specific user may be associated with multiple accounts. For example, many New Relic users have accounts through a partnership, and they also have accounts they created directly with New Relic.

Partnership pricing

Accounts within a partnership organization may have different levels of access to New Relic products.

Many of the Partnership API calls return a subscription status as part of the XML.

For accounts set up through a partnership:

  • An account can have multiple New Relic products associated with it. However, only one subscription per product may be active at any time. For example, a user may have both an Essentials subscription and a higher service level Pro Trial subscription. When the Pro Trial subscription expires, the service level returns to the Essentials subscription.
  • Promotions may appear as a subscription change.
  • Several factors affect starting and stopping subscriptions, including how New Relic handles pricing and billing.

For more help

Recommendations for learning more: