New Relic organizations set up as partnership accounts have access to an enhanced hierarchical way of organizing their account structure.
There are two types of New Relic organizations that are able to use our partnership account structure and the Partnership API:
- An actual partnership: A partnership refers to managed service providers or resellers, who offer New Relic products to their customers. Heroku is one example of such a New Relic partner.
- A customer partnership: some of our larger organizations also make use of our partnership account structure. We call these customers "customer partnerships."
Use of our partnership account structure requires prior approval and set up by New Relic representatives. For customer partnerships, New Relic contacts organizations that would benefit from such a structure.
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 consist 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.
All master accounts and sub-accounts roll up to your partnership account.
The partnership owner account (POA) is the entity that is used to administer a partnership. It controls 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 can access accounts under their partnerships and enjoy User level privileges.
- Admins on the POA can access accounts under their partnerships and enjoy Admin level privileges, including permission to manage users.
- The Owner of the partnership owner account will still only have Admin level access on accounts under the partnership. That means that the owner 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 behave differently than other New Relic accounts provisioned through your partnership:
For security purposes, you cannot change an account Owner with the Partnership user API. Instead, you must change the account Owner from the Users page in the New Relic 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.