New Relic's REST APIを使用して、New Relicツールからデータを取得し、データを同ツールにプッシュし、設定を含め、機能を削除できます。APIエクスプローラーを使用して、REST APIを介して利用できるデータを理解したり、cURLコマンドを取得したり、JSON応答を表示したりすることもできます。
ヒント
API、およびその他のオブザーバビリティプラットフォームを使用するには、New Relicファミリーに参加してください。サインアップして、わずか数秒で無料アカウントを作成できます。次に、毎月最大で100GBのデータを無料で取り込みます。期間無制限です。
セットアップ
REST APIコマンド構造は、次のテンプレートに従います。
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の使用事例については、以下を参照してください。
- APMの例(New Relic APMのメトリックタイムスライスを取得する方法)
- ブラウザの例(New Relic Browserのメトリックタイムスライスを取得する方法)
- Infrastructureアラートの例
- プラグインの例(New Relicプラグインセントラルからプラグインに関する情報とメトリックタイムスライス データを取得する方法)
- アラートの例(アラート条件の作成や通知チャネルの設定など)
その他のヘルプ
さらに支援が必要な場合は、これらのサポートと学習リソースを確認してください:
- Explorers Hubを参照して、コミュニティから支援を受け、ディスカッションに参加してください。
- 当社のサイトで回答を見つけ、サポートポータルの使用方法について学びます。
- Linux、Windows、およびmacOSのトラブルシューティングツールであるNew Relic Diagnosticsを実行します。
- New Relicのデータセキュリティとライセンスドキュメントを見直してください。