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
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 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:
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.
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.