NerdGraphチュートリアルパートナーおよびリセラーのサブスクリプション

NerdGraph API のサブスクリプションプロビジョニング機能は、 New Relic パートナーとして、お客様のアカウントにサブスクリプションを作成することができます。また、 Partner API よりも広範囲の New Relic 製品にアクセスすることができます。

要件

New Relicの担当者から特に指示がない限り、サブスクリプションのプロビジョニングを調整するためにNerdGraphを使用しない必要があります。
パートナーアカウントで、弊社のオリジナル価格モデルをご利用の方に限ります。

NerdGraphのプロビジョニング機能と、 Partnership API は、両者がサポートする製品（APM、Mobile、Insights、Browser、Synthetics、Infrastructure）に関しては互換性があります。NerdGraphを使用して新しい製品のサブスクリプションを作成した場合、Partnership APIを使用してアカウントを更新することはできなくなります。

はじめに：エンドポイントとAPIキー

NerdGraphの基礎知識については、 Introduction to NerdGraph をご覧ください。

NerdGraphのプロビジョニング機能は、 organizationProvisioningUpdatePartnerSubscription という変異を使用しています。以下は、特定のアカウントにサブスクリプションを変更するリクエストの例です。

curl -v -d'{"query": "mutation { organizationProvisioningUpdatePartnerSubscription(accountId: PARTNER_ACCOUNT_ID, affectedAccountId: ACCOUNT_ID, 
products: [{id: 9200, name: \"Traces\", unitsOfMeasure: [{unit: SPANS_IN_MILLIONS, quantity: 40}]}]) {enqueued errors {message path } } }"}' -H'Content-type: application/json' -H'Api-key: YOUR_USER_KEY' https://api.newrelic.com/graphql

あるアカウントの製品サブスクリプション

NerdGraphでは、アカウントの個々の製品サブスクリプションをアップグレードまたはダウングレードすることはできません。代わりに、APIでは、アカウントのすべての製品サブスクリプションの構成を置き換える（add ）必要があります。

ヒント

製品構成が含まれていない場合、NerdGraphは自動的に無料の製品（利用可能な場合）をアカウントにプロビジョニングします。

製品のマッピング（productId）

アカウント作成コールのたびに、少なくとも 1 つの New Relic 製品タイプを指定する必要があります。変異クエリでは、タイプを表す数値 productId のみを受け付けます。

アカウントあたりの許容ホスト数とデータ保持期間は、APMの価格体系のサブスクリプションレベルによって異なります。例えば、APMでは、Liteアカウントの場合、許可されるホストの数は無制限ですが、データ保持期間は24時間のみです。

さらに、価格設定とデータ保持は、ホストに基づく価格モデルを選択するか、コンピュートユニット（CU）に基づくを選択するかによって異なります。プロダクトIDの整数形式を使用して、サブスクリプションレベルとプランの種類を識別します。

購読レベル	`products.id`	`unitsOfMeasure.unit`
Lite	18	該当なし
スタンダード	41	`HOSTS`
スタンダード・アニュアル	38	`HOSTS`
プロ（ホスト）	42	`HOSTS`
プロ年次（ホスト）	39	`HOSTS`
エンタープライズ	43	`HOSTS`
エンタープライズ・アニュアル	40	`HOSTS`

CU（Compute Unit）に基づく価格設定モデルを選択した場合、これらのプロダクトIDの整数形式を使用して、サブスクリプションレベルとプランの種類を識別します。

購読レベル	`products.id`	`unitsOfMeasure.unit`
Pro CU	126	`COMPUTE_UNIT`
プロ年間CU	127	`COMPUTE_UNIT`
APM Essentials CU	128	`COMPUTE_UNIT`
APM Essentials Annual CU	129	`COMPUTE_UNIT`

リクエスト例

5台のホストを持つAPM Pro

mutation {
  organizationProvisioningUpdatePartnerSubscription (
    accountId: :PARTNER_ACCOUNT_ID,
    affectedAccountId: :ACCOUNT_ID,
    products: [
      {
        id: 42,
        unitsOfMeasure: [
          {
            unit: HOSTS,
            quantity: 5
          }
        ]
      }
    ]
  ) {
    enqueued
    errors {
      message
      path
    }
  }
}

3000台のコンピュートユニットを搭載したAPM Pro CU

mutation {
  organizationProvisioningUpdatePartnerSubscription (
    accountId: PARTNER_ACCOUNT_ID,
    affectedAccountId: ACCOUNT_ID,
    products: [
      {
        id: 126,
        unitsOfMeasure: [
          {
            unit: COMPUTE_UNIT,
            quantity: 3000
          }
        ]
      }
    ]
  ) {
    enqueued
    errors {
      message
      path
    }
  }
}

New Relic Mobile の料金体系 Enterprise サブスクリプションレベルでは、1 アカウントあたり月間 100,000 人のアクティブユーザーを許可します。データ保持量はサブスクリプションレベルによって異なります。サブスクリプションレベルの識別には、プロダクト ID の整数形式を使用します。

購読レベル	`products.id`	`unitsOfMeasure.unit.1`	`unitsOfMeasure.unit.2`
Lite	49	該当なし	該当なし
エンタープライズ	54	`APPS`	`ユーザー`
エンタープライズ・アニュアル	55	`APPS`	`ユーザー`

リクエスト例

1つのアプリと10万人の月間アクティブユーザーを持つモバイルエンタープライズ

mutation {
  organizationProvisioningUpdatePartnerSubscription (
    accountId: PARTNER_ACCOUNT_ID,
    affectedAccountId: ACCOUNT_ID,
    products: [
      {
        id: 54,
        unitsOfMeasure: [
          {
            unit: APPS,
            quantity: 1
          },
          {
            unit: USERS,
            quantity: 100000
          }
        ]
      }
    ]
  ) {
    enqueued
    errors {
      message
      path
    }
  }
}

New Relic Insights は、保存可能なイベント数と関連するデータ保持ポリシーに基づいて料金体系を設定しています。例えば、Insights Freeのデータ保持は1日です。

購読レベル	`products.id`	`unitsOfMeasure.unit.1`	`unitsOfMeasure.unit.2`
無料	67	該当なし	該当なし
なし	65	該当なし	該当なし
Pro	66	`データ保持日数`	`イベント_in_millions`
プロ・アニュアル	69	`データ保持日数`	`イベント_in_millions`

リクエスト例

Insights Pro（7日間のデータ保存、2,500万イベントを含む

mutation {
  organizationProvisioningUpdatePartnerSubscription (
    accountId: PARTNER_ACCOUNT_ID,
    affectedAccountId: ACCOUNT_ID,
    products: [
      {
        id: 66,
        unitsOfMeasure: [
          {
            unit: DATA_RETENTION_IN_DAYS,
            quantity: 7
          },
          {
            unit: EVENTS_IN_MILLIONS,
            quantity: 25
          }
        ]
      }
    ]
  ) {
    enqueued
    errors {
      message
      path
    }
  }
}

New Relic Browser の料金体系では、サブスクリプションレベルに関わらず、アプリのユーザー数を無制限に増やすことができます。ただし、月あたりの許容ページビュー数とデータ保持期間はサブスクリプションレベルによって異なります。例えば、以下のようになります。

Liteアカウントでは、月間のページビュー数が無制限で、24時間のデータ保持が可能です。
Proアカウントの価格は、月間50万ページビュー、3ヶ月間のデータ保持からとなっています。
サブスクリプションレベルの識別には、プロダクトIDの整数形式を使用します。
購読レベル
products.id
unitsOfMeasure.unit
Lite
76
該当なし
Pro
72
PAGE_VIEWS
プロ・アニュアル
73
PAGE_VIEWS
リクエスト例
50万ページビューのブラウザプロ
```
mutation {
  organizationProvisioningUpdatePartnerSubscription (
    accountId: PARTNER_ACCOUNT_ID,
    affectedAccountId: ACCOUNT_ID,
    products: [
      {
        id: 42,
        unitsOfMeasure: [
          {
            unit: PAGE_VIEWS,
            quantity: 500000
          }
        ]
      }
    ]
  ) {
    enqueued
    errors {
      message
      path
    }
  }
}
```

購読レベル	`products.id`	`unitsOfMeasure.unit`
Lite	76	該当なし
Pro	72	`PAGE_VIEWS`
プロ・アニュアル	73	`PAGE_VIEWS`

New Relic Synthetics の価格体系、デフォルトの許容監視チェック数とデータ保持期間は、サブスクリプションレベルによって異なります。サブスクリプションレベルの識別には、プロダクト ID の整数形式を使用します。

購読レベル	`products.id`	`unitsOfMeasure.unit.1`
Lite	81	該当なし
Pro	77	`CHECKS`
プロ・アニュアル	78	`CHECKS`

リクエスト例

1万枚のチェックが付いたシンセサイザー・プロ

mutation {
  organizationProvisioningUpdatePartnerSubscription (
    accountId: PARTNER_ACCOUNT_ID,
    affectedAccountId: ACCOUNT_ID,
    products: [
      {
        id: 77,
        unitsOfMeasure: [
          {
            unit: CHECKS,
            quantity: 10000
          }
        ]
      }
    ]
  ) {
    enqueued
    errors {
      message
      path
    }
  }
}

New Relic Infrastructure の料金体系では、デフォルトのインスタンス数とデータ保持期間がサブスクリプションレベルによって異なります。 Infrastructure のイベントは、Insights でクエリを実行できても、New Relic Insights のクォータにはカウントされません。

New Relic Infrastructure では、Compute Units (CU) のみに基づいたの価格モデルを提供しています。サブスクリプションレベルの識別には、プロダクト ID の整数形式を使用します。

購読レベル	`products.id`	`unitsOfMeasure.unit`
インフラなし	142	該当なし
インフラストラクチャー・プロ（CU）	134	`COMPUTE_UNIT`
インフラ・プロ・アニュアル（CU）	135	`COMPUTE_UNIT`
インフラストラクチャー・エッセンシャルズ（CU）	136	`COMPUTE_UNIT`
インフラストラクチャー・エッセンシャルズ年間（CU）	137	`COMPUTE_UNIT`

リクエスト例

5,000台のコンピュートユニットを備えたInfrastructure Pro

mutation {
  organizationProvisioningUpdatePartnerSubscription (
    accountId: PARTNER_ACCOUNT_ID,
    affectedAccountId: ACCOUNT_ID,
    products: [
      {
        id: 134,
        unitsOfMeasure: [
          {
            unit: COMPUTE_UNIT,
            quantity: 5000
          }
        ]
      }
    ]
  ) {
    enqueued
    errors {
      message
      path
    }
  }
}

購読レベル	`products.id`	`unitsOfMeasure.unit.1`
サーバーレスの年次	9010	`ingested_events`
月刊サーバーレス	9000	`ingested_events`

リクエスト例

数百万件のイベントを3,000件取り込んだサーバーレスマンスリー

mutation {
  organizationProvisioningUpdatePartnerSubscription (
    accountId: PARTNER_ACCOUNT_ID,
    affectedAccountId: ACCOUNT_ID,
    products: [
      {
        id: 9000,
        unitsOfMeasure: [
          {
            unit: INGESTED_EVENTS,
            quantity: 3000
          }
        ]
      }
    ]
  ) {
    enqueued
    errors {
      message
      path
    }
  }
}

購読レベル	`products.id`	`unitsOfMeasure.unit.1`
トレース・アニュアル	9200	`スパン-イン-ミリオン`
月間トレース	9210	`スパン-イン-ミリオン`

リクエスト例

3,000スパンの年間トレース数は百万単位

mutation {
  organizationProvisioningUpdatePartnerSubscription (
    accountId: PARTNER_ACCOUNT_ID,
    affectedAccountId: ACCOUNT_ID,
    products: [
      {
        id: 9200,
        unitsOfMeasure: [
          {
            unit: SPANS_IN_MILLIONS,
            quantity: 3000
          }
        ]
      }
    ]
  ) {
    enqueued
    errors {
      message
      path
    }
  }
}

購読レベル	`products.id`	`unitsOfMeasure.unit.1`
ログの年次コミット - 8日	9110	`GB_PER_DAY`
ログの年次コミット - 15日	9111	`GB_PER_DAY`
ログの年次コミット - 30日	9112	`GB_PER_DAY`
ログマンスリーコミット - 8日間	9100	`GB_PER_DAY`
ログマンスリーコミット - 15日	9101	`GB_PER_DAY`
ログマンスリーコミット - 30日	9102	`GB_PER_DAY`

リクエスト例

8日間のデータ保持と1日あたり100ギガバイトのログ

mutation {
  organizationProvisioningUpdatePartnerSubscription (
    accountId: PARTNER_ACCOUNT_ID,
    affectedAccountId: ACCOUNT_ID,
    products: [
      {
        id: 9100,
        unitsOfMeasure: [
          {
            unit: GB_PER_DAY,
            quantity: 100
          }
        ]
      }
    ]
  ) {
    enqueued
    errors {
      message
      path
    }
  }
}

購読レベル	`products.id`	`unitsOfMeasure.unit.1`
メトリクスアニュアル・コミット	9310	`DPM`
メトリクスマンスリーコミット	9300	`DPM`

リクエスト例

メトリクス月間コミットメント 50データポイント/分

mutation {
  organizationProvisioningUpdatePartnerSubscription (
    accountId: PARTNER_ACCOUNT_ID,
    affectedAccountId: ACCOUNT_ID,
    products: [
      {
        id: 9300,
        unitsOfMeasure: [
          {
            unit: DPM,
            quantity: 50
          }
        ]
      }
    ]
  ) {
    enqueued
    errors {
      message
      path
    }
  }
}

GraphQLの種類

NerdGraphのプロビジョニング機能は、以下のGraphQLタイプを使用する。

名前	タイプ	説明
`account_id`	整数	影響を受けるアカウントが所属するパートナーシップのパートナーアカウントの数値ID。
`affected_account_id`	整数	製品欄に記載された変更が適用されるアカウントの数値ID。
`製品`	製品の配列	影響を受けるアカウントの新しいサブスクリプションを構成する値を表す Product タイプのコレクション。

名前	タイプ	説明
`Id`	整数	サブスクリプションに追加される製品の数値ID。
`名前`	文字列	サブスクリプションに追加する製品の名前。
`測定単位`	測定単位の配列	この単一製品のUnit of Measureタイプのコレクション。

名前	タイプ	説明
`量`	整数	サブスクリプションに適用されるユニットの量を示す数値。
`ユニット`	文字列	製品に適用されるユニットの名称（製品ラインによって異なります）。

例

ここでは、サブスクリプションを作成するためのAPIコールと、そのJSONレスポンスの例を示します。

mutation {
  organizationProvisioningUpdatePartnerSubscription (
    accountId: PARTNER_ACCOUNT_ID,
    affectedAccountId: ACCOUNT_ID,
    products: [
      {
        id: 9410,
        unitsOfMeasure: [{unit: INCIDENT_EVENTS, quantity: 50}]
      },
      {
        id: 42,
        unitsOfMeasure: [{unit: HOSTS, quantity: 5 }]
      },
      {
        id: 42,
        unitsOfMeasure: [{unit: PAGE_VIEWS, quantity: 500000}]
      },
      {
        id: 134,
        unitsOfMeasure: [{unit: COMPUTE_UNIT, quantity: 5000}]
      },
      {
        id: 66,
        unitsOfMeasure: [
          {unit: DATA_RETENTION_IN_DAYS, quantity: 7 },
          {unit: EVENTS_IN_MILLIONS, quantity: 25 }
        ]
      },
      {
        id: 9100,
        unitsOfMeasure: [{unit: GB_PER_DAY, quantity: 100 } ]
      },
      {
        id: 9300,
        unitsOfMeasure: [{unit: DPM, quantity: 50 }
        ]
      },
      {
        id: 54,
        unitsOfMeasure: [
          {unit: APPS, quantity: 1 },
          {unit: USERS, quantity: 100000 }
        ]
      },
      {
        id: 9000,
        unitsOfMeasure: [{unit: INGESTED_EVENTS, quantity: 3000 } ]
      },
      {
        id: 77,
        unitsOfMeasure: [{unit: CHECKS, quantity: 10000 } ]
      },
      {
        id: 9200,
        unitsOfMeasure: [{unit: SPANS_IN_MILLIONS, quantity: 3000 } ]
      }
    ]
  ) {
    enqueued
    errors {
      message
      path
    }
  }
}

このクエリは、以下を返します：

{
  "data": {
    "organizationProvisioningUpdatePartnerSubscription": {
      "enqueued": true,
      "errors": []
    }
  }
}

mutation {
    organizationProvisioningUpdatePartnerSubscription (
      accountId: :PARTNER_ACCOUNT_ID,
      affectedAccountId: :ACCOUNT_ID,
      products: [
        {
          id: 9110,
          unitsOfMeasure: [
            {
              unit: GB_PER_DAY,
              quantity: 100
            },
            {
              unit: DATA_RETENTION_IN_DAYS,
              quantity: 8
            }

          ]
        }
      ]
    ) {
      enqueued
      errors {
        message
        path
      }
  }
}

このクエリは、以下を返します：

{
  "data": {
    "organizationProvisioningUpdatePartnerSubscription": {
      "enqueued": true,
      "errors": []
    }
  }
}

レスポンス: NerdGraph があなたのリクエストを受け取り、それが正しいフォーマットであることを確認すると、次のようなメッセージが返ってきます。これは、あなたのメッセージが正常に処理された、あるいは適用されたことを意味するものではありませんが、正しい形式であることが検証され、処理のために待ち受けています。

{
  "data": {
    "organizationProvisioningUpdatePartnerSubscription": {
      "enqueued": true,
      "errors": []
    }
  }
}

Partnership APIのバリエーション

これらは、NerdGraphのプロビジョニング機能とPartner APIとの主な違いであり、Partner APIを頻繁に使用する方には知っておいていただきたいものです。

機能	説明
APIキー	NerdGraphでは、ユーザーキーを使用しています。 Partner API は、 Partnership API key を使用しています。
`productId` and `product_id`	NerdGraphのプロダクトIDは、 Partnership API で使用されているものとは異なります。
Curlリクエストフォーマット	NerdGraph に curl リクエストを行う場合、そのフォーマットは Partnership API とは異なります。 urlのエンドポイントが異なります。必要なAPIキーは、あなたの個人的なAPIキーです。 NerdGraphは、HTTP POSTリクエストにのみ応答します。
サーバーレス `INGESTED_EVENTS` 単位は百万円です。	sending `unitsOfMeasure:[{unit: INGESTED_EVENTS, quantity: 3000 } ]` は NerdGraph では 3,000 百万イベントと解釈されます。
インサイトとモバイルは2つの単位が必要	Insightsには `DATA_RETENTION_IN_DAYS` および `EVENTS_IN_MILLIONS` Mobileには `APPS` および `USERS` が必要です。
ログのデータ保持の単位がproductIDで決まる	これは製品名で指定されています。ログの年次コミット - 8日｜プロダクトID:9110 ログの年次コミット - 15日｜プロダクトID:9111 ログの年次コミット - 30日｜プロダクトID:9112 Logs Monthly Commit - 8 Days｜プロダクトID:9100 Logs Monthly Commit - 15 Days｜プロダクトID:9101 Logs Monthly Commit - 30 Days｜プロダクトID:9102

本書は、お客様のご参考のために原文の英語版を機械翻訳したものです。

NerdGraphチュートリアルパートナーおよびリセラーのサブスクリプション

要件

はじめに：エンドポイントとAPIキー

あるアカウントの製品サブスクリプション

ヒント

製品のマッピング（productId）

APM

リクエスト例

モバイル

リクエスト例

インサイト

リクエスト例

ブラウザ

リクエスト例

シンセティック

リクエスト例

インフラストラクチャ

リクエスト例

Lambdaのためのサーバーレス

リクエスト例

トレース

リクエスト例

ログ

リクエスト例

メトリクス

リクエスト例

GraphQLの種類

サブスクリプション

製品

測定単位

例

多くの製品でサブスクリプションを作成（既存のものを交換）する

1つの製品でサブスクリプションを作成（既存のものを置き換える） - Logs

Partnership APIのバリエーション