New Relic API キー

データの取り込みに使用されるメインキーは、ライセンスキーと呼ばれます。 APIキーUIおよびNerdGraphでは、このキーはingest - licenseとして参照されることがあります。

ほとんどすべてのNewRelicデータを取り込むには、ライセンスキーが必要です。例外は、ブラウザー監視データ（ブラウザーキーを使用）とモバイル監視データ（モバイルアプリトークンを使用）です。

ライセンスキーは、NewRelicアカウントに関連付けられた40文字の16進文字列です。 New Relicに初めてサインアップすると、単一のアカウントと独自のライセンスキーを持つ組織が作成されます。さらにアカウントが追加されると、各アカウントは独自のライセンスキーで始まります。アカウント用に最初に作成されたライセンスキーは削除できませんが、管理および削除できる追加のライセンスキーを作成できます。これは、キーローテーションなどのセキュリティプラクティスを実装するのに役立ちます。アカウントの元のライセンスキーを削除する必要がある場合は、サポートに連絡してください。

ユーザーがライセンスキーを表示または管理できないように制限するには、これらの機能を持たないロールをユーザーに割り当てます。新しいユーザーモデル。

ブラウザの監視では、ライセンスキーではなく、ブラウザキーを使用してデータを報告します。ブラウザキーは、ブラウザ監視エージェントからのデータをアカウントに関連付けるために使用されます。

アカウント作成時に作成されたオリジナルのブラウザキーを管理・削除することはできませんが、新しいブラウザキーを作成し、そのキーを削除することは可能です。アカウントの最初のブラウザキーを削除する方法については、 サポートにお問い合わせください。.

モバイルモニタリングでは、ライセンスキーではなく、モバイルアプリトークンを使用してデータをレポートします。詳細については、モバイルアプリトークンを参照してください。

New Relic のユーザーキー ("個人用 API キーと呼ばれることもあります)" は、 NerdGraph と弊社の REST API を使用する際に必要です。

ユーザーキーは、特定のNew Relicユーザーと特定のアカウントの両方に紐づいており、譲渡することはできません。ユーザーキーは、キーが関連付けられていた特定のアカウントだけでなく、アクセスを許可されたすべてのアカウントに対してクエリを実行することが可能です。New Relic ユーザーが New Relic で削除されると、そのユーザーキーも無効化され、動作しなくなります。

ユーザーがユーザーキーを表示または管理できないように制限するには、これらの機能を持たないロールをユーザーに割り当てます。新しいユーザーモデル。

データの取り込みに使用される古いNewRelicAPIキーの1つは、Insights挿入キー（挿入キーとも呼ばれます）です。ライセンスキーは同じ機能などに使用されることに注意してください。そのため、このキーよりもライセンスキーをお勧めします。

このキーは、当社の Event API 、 Log API 、 Metric API 、および Trace API 、またはこれらの API を使用する統合を経由してデータを取り込むために使用されます。

空き状況やアクセスに関するヒント

• これらのキーは、特定のユーザーではなくアカウントに関連付けられているため、キーにアクセスできるアカウントの誰もが使用することができます。

• セキュリティのためのベストプラクティスとして、アプリケーションやデータソースごとに異なるInsightsの挿入キーを使用することをお勧めします。

  Insights のインサートキーを見つけて管理するには。 アカウントのドロップダウンから 、 APIキー をクリックします（ APIキーページへの直接リンクを取得 ）。次に Insights insert keys をクリックします。

古いAPIキーの1つにInsightsクエリキーがあり、これは InsightsクエリAPI で使用されています。 New Relic のデータを照会して返すには、 NerdGraph を使用することをお勧めします。

Insights のクエリキーを見つけて管理するには。 アカウントのドロップダウンから 、 API キー をクリックします（ API キーページへの直接リンクを取得 ）。次に、 Insights クエリキー をクリックします。

adminキーは、廃止された古いAPIキーの1つです。 2020年12月4日の時点で、既存のすべての管理者キーがユーザーキーに移行されています。

管理者キーを使用していた場合、そのキーを有効にするために何もする必要はありません。APIキーのUIから自動的にアクセスできるようになり、ユーザーキーとしてラベル付けされ、同じパーミッションが付与されます。ユーザーキーと同じように、同じワークフローで管理することができます。

移行されたすべての管理者キーには、キーテーブルの管理者ユーザーキーから移行されたというメモがあります。

REST APIキーは、 RESTAPIを使用するための古いキーです。現在、RESTAPIキーの代わりにユーザーキーを使用することをお勧めします。ユーザーはアカウント固有ではなくユーザー固有であるため、組織はチームメンバーのアクセスをより細かく制御できます。また、REST APIの代わりに、新しいAPIであるNerdGraphを使用することをお勧めします。

考慮すべきこと

• 各NewRelicアカウントは、RESTAPIキーを1つだけ持つことができます。

• RESTAPIキーの代わりにユーザーキーを使用することをお勧めします。

• 可能であれば、REST API より NerdGraph を使用することをお勧めします。

• 管理者レベルのユーザー権限が必要です。 RESTAPIキーまたはRESTAPIエクスプローラーにアクセスできない場合は、権限がないことが原因である可能性があります。 New Relicアカウントマネージャーに相談するか、代わりにユーザーキーを使用してください。

  REST API キーを見つけて管理するには。 account dropdown から、 API keys をクリックします (get a direct link to the API keys page)。次に、 REST API キー をクリックします。API キーを設定または削除する前に、正しいアカウントに対して設定を行っていることを確認してください。