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つのNewRelic製品タイプを提供する必要があります。ミューテーションクエリは、タイプの数値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`
プロ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 サブスクリプションレベルでアカウントごとに月間アクティブユーザー数 100,000 人が許可されます。データの保持期間はサブスクリプションレベルによって異なります。製品 ID の整数形式を使用して、サブスクリプションレベルを識別します。

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

リクエスト例

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	該当なし	該当なし
プロ	66	`DATA_RETENTION_IN_DAYS`	`EVENTS_IN_MILLIONS`
プロアニュアル	69	`DATA_RETENTION_IN_DAYS`	`EVENTS_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アカウントには、1か月あたりのページビュー数に制限がなく、24時間のデータ保持が含まれます。

プロアカウントの価格は、月額500,000ページビューと3か月のデータ保持から始まります。

サブスクリプションレベルの識別には、プロダクトIDの整数形式を使用します。

購読レベル	`products.id`	`unitsOfMeasure.unit`
Lite	76	該当なし
プロ	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
    }
  }
}

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

購読レベル	`products.id`	`unitsOfMeasure.unit.1`
Lite	81	該当なし
プロ	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	`SPANS_IN_MILLIONS`
月間トレース	9210	`SPANS_IN_MILLIONS`

リクエスト例

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。
`products`	製品の配列	影響を受けるアカウントの新しいサブスクリプションを構成する値を表す Product タイプのコレクション。

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

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

例

ここでは、サブスクリプションを作成するための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` および `product_id`	NerdGraphのプロダクトIDは、 Partnership API で使用されているものとは異なります。
Curlリクエストフォーマット	NerdGraph に curl リクエストを行う場合、そのフォーマットは Partnership API とは異なります。 urlのエンドポイントが異なります。必要なAPIキーは、あなたの個人的なAPIキーです。 NerdGraphは、HTTP POSTリクエストにのみ応答します。
サーバーレス`INGESTED_EVENTS`ユニットは数百万単位です	`unitsOfMeasure: [{unit: INGESTED_EVENTS, quantity: 3000 } ]`の送信は、NerdGraphによって3,000百万のイベントとして解釈されます。
インサイトとモバイルは2つの単位が必要	インサイトには`DATA_RETENTION_IN_DAYS`と`EVENTS_IN_MILLIONS`が必要です。モバイルには`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のバリエーション

この機械翻訳は、参考として提供されています。

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

要件 .css-21sua1{background:none;border:none;width:0;padding:0;}

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

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

ヒント

製品のマッピング（productId）

モバイル

インサイト

ブラウザ

シンセティックス

インフラストラクチャー

Lambdaのためのサーバーレス

トレース

ログ

指標

GraphQLの種類

サブスクリプション

製品

測定単位

例

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

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

Partnership APIのバリエーション

要件