アプリケーションID、ホストID、インスタンスIDのリスト

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のリストを返すことができます。

1. one.newrelic.com > All capabilities > APM & services > (select an app)

   に移動します。

2. rpm.newrelic.com/api/exploreのAPIエクスプローラーにアクセスし、 次に、

   Select an account

   ドロップダウンからアカウント名を選択します。

3. サイドバーから

   (product category) > GET List

   を選択します。

   Send Request

   を選択します。

4. Response

   を参照して製品 ID を見つけます。

REST APIコールに配置したプロダクトIDを使用してください。

アプリケーションIDの一覧

APMエージェントによって監視される各アプリには名前が割り当てられます。 その名前には一意の$APP_IDも関連付けられています。 $APP_IDは、アプリに関するAPM情報を取得するための基本です。 $APP_ID一覧表示と使用、および概要データの取得の詳細については、 「アプリ ID の一覧表示」を参照してください。

ホストIDの一覧表示

$HOST_IDは、アプリを実行している特定のホストの APM データを取得するために使用されます。物理サーバーには複数のホストがある場合があります。たとえば、物理サーバー上で実行されている Web サーバー プログラムは、複数の仮想ホストを持つように構成されている場合があります。

ホストと物理サーバーのIDは同じではありません。ホストのIDはそれぞれ固有のもので、異なる項目を表しています。

$HOST_IDを使用して、ホストのサマリー メトリックと特定のメトリック タイムスライス値を取得します。利用可能な指標の詳細については、次を参照してください。

1. rpm.newrelic.com

   に移動します。

2. API エクスプローラーに移動し、

   Select an account

   ドロップダウンからアカウント名を選択します。

3. rpm.newrelic.com/api/explore/application_hosts/namesにある API Explorer の

   Application host

   ページに移動します。

{
  "application_hosts": [
    {
      "id": 34966,      <---<<< {HOST_ID}
      "application_name": "Combined Production",
      "host": "prod-app-10.com",
      "language": "ruby",
      "health_status": "green",
      "application_summary": {
        . . .
      },
      "links": {
        "application": 1234,   <---<<< {APP_ID}
        "application_instances": [
          13512     <---<<< {INSTANCE_ID}
        ],
      }
    },
    {
      "id": 9999999,      <---<<< {HOST_ID}
      "application_name": "Combined Production",
      "host": "prod-app-11.com",
      "language": "ruby",
      "health_status": "green",
      "application_summary": {
        ". . .
      },
      "links": {
        "application": 1234,   <---<<< {APP_ID}
        "application_instances": [
          186288     <---<<< {INSTANCE_ID}
        ],
      }
    },
. . .

インスタンスIDの一覧

InstanceID の意味は、使用されているNew Relic言語エージェントによって異なります。 この ID は REST API から一覧表示できます。 Java JVMの場合、APM のOverview ページから インスタンス ID ( ) を表示すること もできます。

{INSTANCE_ID}を使用して、インスタンスのサマリー メトリックと特定のメトリック タイムスライス値を取得できます。使用可能なメトリックの詳細については、 REST API エクスプローラーのアプリケーション インスタンスページを使用してください。

{
  "application_instances": [
    {
      "id": 35120,     <---<<< {INSTANCE_ID}
      "application_name": "Combined Production",
      "host": "prod-app-10.com",
      "language": "ruby",
      "health_status": "green",
      "application_summary": {
        . . .
      },
      "links": {
        "application": 1441,   <---<<< {APP_ID}
        "application_host": 34966,    <---<<< {HOST_ID}
      }
    },
    {
      "id": 186288,     <---<<< {INSTANCE_ID}
      "application_name": "Combined Production",
      "host": "prod-app-11.com",
      "language": "ruby",
      "health_status": "green",
      "application_summary": {
        . . .
      },
      "links": {
        "application": 1441,   <---<<< {APP_ID}
        "application_host": 186283,    <---<<< {HOST_ID}
      }
    },
. . .

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
        ]
      }
    }
  ],
. . .