• /
  • ログイン
  • 無料アカウント

New Relic API keys

New Relic has several different APIs that each require their own type of API key to use. This resource describes our API keys, what they're used for, and how to access them.

Manage API keys in UI

Here's a direct link to the API keys UI page. To find this from the New Relic UI:

  1. From the account dropdown, select Account settings.
  2. Select API keys.

Overview of API keys

The table below summarizes our available API keys and their uses.

重要

Some keys are able to be used by more than one API. If you're using a specific API, see the docs for that API to understand which keys are required and recommended.

Key type

What it's for

Where to access

User key

(Also known as a "personal API key")

Used for NerdGraph (our GraphQL API) and for accessing REST API endpoints (dependent on user permissions).

API keys UI

License key

Allows ingestion of data from APM agents, the infrastructure agent, and some other data-ingest APIs.

API keys UI

Insights insert key

(Also known as a "Insert key")

Allows ingestion of events via HTTPS request from our metric, log, trace, and event APIs and the tools that use those APIs.

Go to the API keys UI and click Insights insert key.

Browser key

Allows ingestion of browser monitoring data.

API keys UI

Mobile key

(aka "mobile app token")

Allows mobile monitoring data to be sent to New Relic.

See Mobile app token.

REST API key

Note: we recommend using the user key instead because it has fewer limitations. The REST API key is for using our REST APIs for Alerts, APM, Browser, Infrastructure alerts, as well as Mobile REST APIs and the API Explorer.

Go to the API keys UI and click REST API key.

Admin API key

重要

As of December 4, 2020, all existing admin keys have been migrated to be user keys.

For more information, see Admin key and User key below.

API keys UI (will appear as user keys)

Insights query key

(aka "Query key")

This key allows use of the Insights query API. Note: we now recommend using NerdGraph to query New Relic data.

Go to the API keys UI and click Insights query key.

User key

New Relic user keys (previously referred to as "personal API keys") are required for NerdGraph (our GraphQL API), which allows you to query most New Relic data and do some types of configuration. User keys also let you use our REST API, with restrictions based on your permissions.

The instructions below are for managing keys in the UI. For managing keys via API, see Manage keys with NerdGraph.

ヒント

In December 2020, user keys supplanted Admin API keys. For details, see Admin API key.

License key

New Relic license keys allow the ingestion of data from APM agents, the infrastructure agent, and some other data-ingest APIs. If you're using a specific API, see the docs for that API to understand which keys are required or recommended.

The instructions below are for managing keys in the UI. For managing keys via API, see Manage keys with NerdGraph.

Browser key

The browser key allows the ingestion of data from New Relic browser monitoring.

The instructions below are for managing keys in the UI. For managing keys via API, see Manage keys with NerdGraph.

REST API key

重要

We recommend using a user key to use the REST API because that key has fewer limitations.

You can use a REST API key with our REST API and the API Explorer. For parent accounts with sub-accounts, each sub-account must use its own REST API key.

Availability: Each New Relic account can have only one REST API key.

Insights insert key

The Insights insert key (aka the "Insert key") is required for the ingestion of data via our Event API, Log API, Metric API, and Trace API, or via tools that use those APIs.

Tips on availability and access:

  • Because these keys are associated with an account and not a specific user, anyone in the account with access to a key can use it.
  • As a best practice for security purposes, we recommend you use different Insights insert keys for different applications or different data sources.

Insights query key

The Insights query key is used for our Insights query API: we now recommend using NerdGraph for querying New Relic data.

Admin key

重要

As of December 4, 2020, all existing admin keys have been migrated to be user keys.

You don’t need to do anything for existing admin keys to remain active. They will be automatically accessible via the API keys UI, labeled as user keys, and granted identical permissions. You can manage them as you would any user key via the same workflow.

All migrated admin keys will have a note that says “Migrated from an admin user key” in the key table, so you’ll be able to find them easily.

その他のヘルプ

さらに支援が必要な場合は、これらのサポートと学習リソースを確認してください:

問題を作成するこのページを編集する
Copyright © 2020 New Relic Inc.