New Relic の APM では、アプリケーションに関連するエンティティに ID を割り当てています。これらは、さまざまな視点から操作やパフォーマンスに関する情報を収集するために使用されます。これらの ID は、 New Relic の REST API を通して返すことができます。
IDは以下のものが考えられます。
- インストルメント化された各アプリのアプリケーション ID
$APP_ID - 各ホストのホスト ID
$HOST_ID - アプリのインスタンスが複数ある場合はインスタンス ID
$INSTANCE_ID
これらの ID を New Relic API Explorer にリストアップするには、 API キー が必要です。
API Explorerの使用
API Explorerを使用して、特定の製品のすべてのプロダクトIDのリストを返すことができます。
- one.newrelic.com > All capabilities > APM & services > (アプリを選択)に移動します。
- rpm.newrelic.com/api/explore のAPI Explorerにアクセスし、 Select an account のドロップダウンからアカウント名を選択します。
- サイドバーから、 （製品カテゴリー）を選択> GETリスト.を選択 Send Request.
- Response を参照して、プロダクト ID を探します。
REST APIコールに配置したプロダクトIDを使用してください。
アプリケーションIDの一覧
によって監視される各アプリ エージェントに名前が割り当てられます。 固有の$APP_IDもその名前に関連付けられています。$APP_IDは取得の基本です アプリに関する情報。 $APP_ID一覧表示と使用、および概要データの取得について詳しくは、 アプリ ID の一覧表示をご覧ください。
ホストIDの一覧表示
$HOST_IDは、アプリを実行している特定のホストの APM データを取得するために使用されます。物理サーバーには複数のホストがある場合があります。たとえば、物理サーバー上で実行されている Web サーバー プログラムは、複数の仮想ホストを持つように構成されている場合があります。
ホストと物理サーバーのIDは同じではありません。ホストのIDはそれぞれ固有のもので、異なる項目を表しています。
$HOST_IDを使用して、ホストのサマリー メトリックと特定のメトリック タイムスライス値を取得します。利用可能な指標の詳細については、次を参照してください。
- rpm.newrelic.com にアクセスしてください。
- API Explorer にアクセスし、 Select an account のドロップダウンからアカウント名を選択します。
- API Explorerの アプリケーションホスト ページにアクセスします。 rpm.newrelic.com/api/explore/application_hosts/names.
インスタンスIDの一覧
インスタンス ID の意味は、使用している New Relic 言語エージェントによって異なります。この ID は REST API から一覧できます。Java の場合、APM の Overview ページから インスタンス ID (JVM) を表示することもできます。
エージェント | インスタンスIDが表す |
|---|---|
Go | アプリ名を報告するホスト上のGoプログラム |
Java | Java仮想マシン(JVM) |
.NET | .NET Framework のエージェントの場合、これは |
Node.js | ワーカープロセス |
PHP | デーモンエージェント |
Ruby | 個々のRubyワーカープロセス |
Python | マスタープロセスとワーカープロセス |
{INSTANCE_ID}を使用して、インスタンスのサマリー メトリックと特定のメトリック タイムスライス値を取得できます。使用可能なメトリックの詳細については、 REST API エクスプローラーのアプリケーション インスタンスページを使用してください。
REST API アプリケーションリストの例
次の例は、 APP_IDを使用してアプリケーションのすべての ID 情報を見つける方法を示しています。EU アカウントをお持ちの場合、エンドポイントはhttps://api.eu.newrelic.comで始まります。
curl -X GET 'https://api.newrelic.com/v2/applications.json' \
-H "Api-Key:$API_KEY" -i \
-d 'filter[ids]=1441' <----<<<< {APP_ID}結果の出力例は、5 つのサーバーで実行されています。1 つのサーバーが 2 つの仮想ホストをホストしており、合計 6 つのホストがあります。出力には、アプリケーションのapplication_instancesとapplication_hostsをリストするlinksセクションが含まれます。
{ "applications": [ { "id": 1441, <----<<<< {APP_ID} "name": "RPM Combined Production", "language": "ruby", "health_status": "green", "reporting": true, "last_reported_at": "2015-11-10T23:19:47+00:00", "application_summary": { . . . }, "end_user_summary": { . . . }, "settings": { . . . }, "links": { "application_instances": [ <---<<<< {INSTANCE_ID} list 21790, 24810, 27948, 35120, 35121, 35122, 186288, 247253, 247254, 247255, 247256 ], "application_hosts": [ <---<<<< {HOST_ID} list 21788, 24808, 34966, 186283, 247245, 286551 ] } } ],. . .