アプリIDとメトリックのタイムスライスデータを一覧表示（v2）

ここでは、New Relic REST API (v2) を使用して、特定のアプリケーション ID と API キーのメトリック名と平均値を取得する例を紹介します。また、この例では、異なる時間範囲を示しています。

データを取得する際、指定した期間やデータの保存方法によって、返される値が影響を受ける場合があります。詳しくは、メトリック・タイムスライス・データの抽出をご覧ください。

重要

例では New Relic の REST API v2 を使用していますが、メトリックタイムスライスクエリを実行するにはNRQL 関数を使用することをお勧めします。各 API 値は、同等の NRQL 関数にマッピングできます。これらの API の例に基づいて NRQL クエリを作成する方法については、ドキュメントを参照してください。

すべてのアプリケーションIDをリストアップ

また、New RelicのREST API Explorer を使って、この例と同じメトリックのタイムスライスデータをアプリの情報として取得することもできます。

すべてのアプリのIDを表示するには、次のコマンドを使用します。

bash

$curl -X GET 'https://api.newrelic.com/v2/applications.json' \
>     -H "Api-Key:$API_KEY" -i

$API_KEYをAPI キーに置き換えます。

出力はデータの配列となり、要素はアプリケーションとそれに関連するデータです。例えば、アプリID 96785 ("GreatTimes Staging") と 1622 ("GreatTimes Prod") の最初の2つの要素を示しています。

{
  "applications": [
    {
      "id": 96785,
      "name": "GreatTimes Staging",
      "language": "ruby",
      "health_status": "gray",
      ...
    },
    {
      "id": 1622,
      "name": "GreatTimes Prod",
      "language": "ruby",
      "health_status": "green",
      ...
    }
  ]
}

アプリIDを名前で一覧表示

名前がわかっている場合に特定のアプリの ID を表示するには、次のコマンドで$NAMEと$API_KEY名前をAPI キーに置き換えます。

bash

$curl -X GET 'https://api.newrelic.com/v2/applications.json' \
>     -H "Api-Key:$API_KEY" -i \
>     -d "filter[name]=$NAME"

出力は、 list all app IDs の例で示したものと同じですが、特定のアプリケーションについてのみ出力されます。

メートル表示のガイドライン

アプリケーションで利用可能なメトリック名をリストアップすることは、非常に集中的な操作となるため、必要な場合にのみ使用してください。多数のメトリック名をリストアップすると、他の用途と同様に、応答性に悪影響を及ぼす可能性があり、過負荷保護を起動することになるかもしれません。

以下のガイドラインに従って、最適な使い方をしてください。

メトリクス名の一覧表示	ガイドライン
メトリック名	必要なメトリック名を慎重に検討してください。メトリック名の一部がわかっている場合は、 `name=`フィルタを使用して、返されるデータの量を制限してください。このフィルターは単純な文字の一致 (正規表現は使用できません) ですが、取得するデータの量を大幅に削減できます。
キャッシュ	メトリック名を取得したら、このリストを今後のためにキャッシュすることを検討してください。ほとんどの場合、メトリック名は揮発性ではないため、再利用することで処理時間を短縮することができます。

アプリのメトリック名の一覧

お使いのアプリケーションで利用可能なメトリック名を表示するには

bash

$curl -X GET "https://api.newrelic.com/v2/applications/${APP_ID}/metrics.json" \
>     -H "Api-Key:$API_KEY" -i

$API_KEYをAPI キーに置き換えます。

出力は以下のようになります。これは、利用可能な多くのメトリック名のうちの2つとその値を示しています。これらのリストは長いかもしれません。メトリック名のリストを作成する際には、ガイドラインをご検討ください。

{
  "metrics": [
    {
      "name": "ActiveRecord/Account/create",
      "values": [
        "average_response_time",
        "calls_per_minute",
        "call_count",
        "min_response_time",
        "max_response_time",
        "average_exclusive_time",
        "average_value",
        "requests_per_minute",
        "standard_deviation"
      ]
    },
    ...
    {
      "name": "Apdex/members/destroy",
      "values": [
        "s",
        "t",
        "f",
        "count",
        "score",
        "value",
        "threshold",
        "threshold_min"
      ]
    },
    ...
  ]
}

次のようにname=フィルターを指定して、メトリクス名の出力をフィルターし、より小さなリストを返します。

bash

$curl -X GET "https://api.newrelic.com/v2/applications/${APP_ID}/metrics.json" \
>     -H "Api-Key:$API_KEY" -i \
>     -d "name=Controller/welcome/index"

$API_KEYをAPI キーに置き換えます。

アプリの指標となるタイムスライスのデータ値を取得する

アプリケーションのメトリックタイムスライスデータを表示するには

bash

$curl -X GET "https://api.newrelic.com/v2/applications/${APP_ID}/metrics/data.json" \
>     -H "Api-Key:$API_KEY" -i \
>     -d 'names[]=EndUser&values[]=call_count&values[]=average_response_time&summarize=true'

この例のように、1回の呼び出しで同じメトリック名から複数の値を取得することができます。

{
  "metric_data": {
    "from": "2014-05-20T23:41:15+00:00",
    "to": "2014-05-21T00:11:15+00:00",
    "metrics": [
      {
        "name": "EndUser",
        "timeslices": [
          {
            "from": "2014-05-20T23:39:00+00:00",
            "to": "2014-05-21T00:08:59+00:00",
            "values": {
              "call_count": 724,
              "average_response_time": 2110
            }
          }
        ]
      }
    ]
  }
}

要求したすべての値のフィールドを共有していない複数のメトリックから値を要求した場合、一度に1つのメトリック名からしか値を取得できません。

たとえば、(2 つの"names[]="条件と対応する"values[]="条件を使用して) 2 つのメトリック名が含まれるようにコマンドを変更すると、最初のメトリック名 ( EndUser ) に関連付けられた値のみが返されます。

bash

$curl -X GET "https://api.newrelic.com/v2/applications/${APP_ID}/metrics/data.json" \
>     -H "Api-Key:$API_KEY" -i \
>     -d "names[]=EndUser&names[]=EndUser/Apdex&values[]=call_count&values[]=average_response_time&values[]=score&summarize=true"

この例のEndUser名にはcall_countとaverage_response_timeの値が関連付けられていますが、関連付けられていません。 score.

{
  "metric_data": {
    "from": "2014-05-20T23:41:15+00:00",
    "to": "2014-05-21T00:11:15+00:00",
    "metrics": [
      {
        "name": "EndUser",
        "timeslices": [
          {
            "from": "2014-05-20T23:39:00+00:00",
            "to": "2014-05-21T00:08:59+00:00",
            "values": {
              "call_count": 724,
              "average_response_time": 2110
            }
          }
        ]
      },
      {
        "name": "EndUser/Apdex",
        "timeslices": [
          {
            "from": "2015-03-31T20:33:00+00:00",
            "to": "2015-03-31T21:02:59+00:00",
            "values": {}
          }
        ]
      }
    ]
  }
}

この機械翻訳は、参考として提供されています。

アプリIDとメトリックのタイムスライスデータを一覧表示（v2）

重要

すべてのアプリケーションIDをリストアップ

アプリIDを名前で一覧表示

メートル表示のガイドライン

アプリのメトリック名の一覧

アプリの指標となるタイムスライスのデータ値を取得する

1つのメトリック名、複数の値

複数のメトリック名、個々の値

この機械翻訳は、参考として提供されています。

アプリIDとメトリックのタイムスライスデータを一覧表示（v2）

重要

すべてのアプリケーションIDをリストアップ .css-21sua1{background:none;border:none;width:0;padding:0;}

アプリIDを名前で一覧表示

メートル表示のガイドライン

アプリのメトリック名の一覧

アプリの指標となるタイムスライスのデータ値を取得する

複数のメトリック名、個々の値

すべてのアプリケーションIDをリストアップ