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

New Relic REST API(v2)の概要

New Relic's REST APIを使用して、New Relicツールからデータを取得し、データを同ツールにプッシュし、設定を含め、機能を削除できます。APIエクスプローラーを使用して、REST APIを介して利用できるデータを理解したり、cURLコマンドを取得したり、JSON応答を表示したりすることもできます。

ヒント

API、およびその他のオブザーバビリティプラットフォームを使用するには、New Relicファミリーに参加してください。サインアップして、わずか数秒で無料アカウントを作成できます。次に、毎月最大で100GBのデータを無料で取り込みます。期間無制限です。

セットアップ

REST APIコマンド構造は、次のテンプレートに従います。

curl  -X GET <URL> -H "Api-Key:$API_KEY" -d '<PAYLOAD>'

GETコマンドは、クエリの目的に応じてPOSTまたはDELETEにもなり得ます。

プレースホルダーを理解するには、読み進めてください。

ヒント

当社の例では、cURLを共通のコマンドラインツールとして使用し、REST APIからメトリックタイムスライスのデータを引き出します。ただし、RESTリクエストには、あらゆる方法を使用できます。curlコマンドには、すべてのリクエストメカニズムに関連性のあるターゲットURL、ヘッダ情報、およびデータが含まれます。

URL

APIコールには、データにアクセスする場所を指定するURLが必要になります。プレースホルダ<URL>は、リクエストされているデータのタイプに応じて変化する適切なURLに置き換える必要があります。通常、URLはこのテンプレートに従います。

https://api.newrelic.com/v2/applications/$APP_ID/metrics/data.json

$APPIDは、データがリクエストされているアプリケーションまたは製品そのものを指定します。このパラメーターに続く情報は、リクエストするデータに応じて異なります。

EUリージョンのアカウントがある場合は、次のURLになります:

api.eu.newrelic.com/v2/applications/$APP_ID/metrics/data.json

ヒント

.json.xmlに置き換えることで、JSONの代わりにXMLデータを取得できます。

APIキー$API_KEY

New Relic APIコールにはAPIキーが必要です。これはいくつかのAPIキーの1つです。

  • ユーザーキー:これが推奨されます。これは当社の最新のキー実装で、REST APIキーよりも制限が少なくなっています。ユーザーキーは、NerdGraph APIでも使用されます。
  • REST APIキー:これは当社の古いキー実装です。この詳細については、「REST APIキー」をご覧ください。このキーを使用する場合、必要なヘッダーはApi-Keyではなく、X-Api-Keyです。
  • New Relicパートナーシップアカウントをお持ちの場合、別のキーを使用します。「パートナーシップ認証」をご覧ください。

REST APIの例では、当社はUnixシェルプログラミングのAPIキープレースホルダー$API_KEYを使用しています。コールを作成する時は、このプレースホルダーとその他のユーザー固有の変数を置き換えてください。

クエリの詳細(ペイロード)

<PAYLOAD>には、次を定義するクエリの詳細が含まれています:

  • クエリするメトリック名および取得する値
  • メトリックスを取得するために定義された時間範囲
  • (オプション):概要で使用するメトリックタイムスライスの平均

REST APIの使用事例については、以下を参照してください。

その他のヘルプ

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

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