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に移動します。
- Serversドロップダウンから、米国または EU ベースの API URL を選択します。
- Authorize をクリックし、ユーザーAPIキーを入力して、もう一度 Authorize をクリックします。
- 使用可能な API 関数の 1 つを展開します: GET 、 PUT 、 DELETE 。
- (オプション) APIコールに Parameters 値を追加して、応答をフィルタリングします (v2 の説明と要件についてはUIを参照してください)。
- Media typeドロップダウンから、リクエストの形式（JSON または XML）を選択します。
- Try it outをクリックし、次にExecuteクリックします。
製品IDを一覧表示する
特定の製品のすべての製品 ID のリストを返すには:
GET /applications.jsonドロップダウンをクリックします。- Try it out [試してみる]をクリックし、 Execute 「実行」をクリックします。
- 応答を参照してすべての製品 ID を表示します。
特定の製品 ID を見つけたら、後で他の REST API呼び出しで使用するためにそれをコピーします。
アプリケーションIDの一覧
エージェントによって監視される各アプリには名前が割り当てられます。 その名前には一意の$APP_IDも関連付けられています。 $APP_IDは、アプリに関する情報を取得するための基本です。 $APP_ID一覧表示と使用、および概要データの取得の詳細については、 「アプリ ID の一覧表示」を参照してください。
ホストIDの一覧表示
$HOST_IDは、アプリを実行している特定のホストの APM データを取得するために使用されます。物理サーバーには複数のホストがある場合があります。たとえば、物理サーバー上で実行されている Web サーバー プログラムは、複数の仮想ホストを持つように構成されている場合があります。
ホストと物理サーバーのIDは同じではありません。ホストのIDはそれぞれ固有のもので、異なる項目を表しています。
$HOST_IDを使用して、ホストのサマリー メトリックと特定のメトリック タイムスライス値を取得します。利用可能な指標の詳細については、次を参照してください。
- rpm.newrelic.comに移動します。
- API エクスプローラーに移動し、 Select an accountドロップダウンからアカウント名を選択します。
- rpm.newrelic.com/api/explore/application_hosts/namesにある API Explorer のApplication hostページに移動します。
インスタンスIDの一覧
InstanceID の意味は、使用されているNew Relic言語エージェントによって異なります。 この ID は REST API から一覧表示できます。 Java JVMの場合、APM のOverview ページから インスタンス ID ( ) を表示すること もできます。
エージェント | インスタンス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 ] } } ],. . .