앱 ID 및 측정항목 타임슬라이스 데이터 나열(v2)

다음은 New Relic REST API(v2)를 사용하여 특정 애플리케이션 ID 및 API 키 에 대한 메트릭 이름 및 평균 값을 가져오는 방법의 예입니다. 예는 또한 다른 시간 범위 를 보여줍니다.

데이터를 수집할 때 반환되는 값은 지정한 기간과 데이터가 저장되는 방식의 영향을 받을 수 있습니다. 자세한 정보는 메트릭 타임슬라이스 데이터 추출 을 참조하십시오.

중요

예제에서는 뉴렐릭의 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")에 대한 처음 두 요소는 다음과 같습니다.

{
  "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"

출력은 모든 앱 ID 목록 에 표시된 것과 동일하지만 특정 애플리케이션에 대해서만 표시됩니다.

측정항목 이름 나열 지침

애플리케이션에 사용 가능한 메트릭 이름을 나열하는 것은 매우 집중적인 작업일 수 있으며 필요한 경우에만 사용해야 합니다. 많은 수의 측정항목 이름을 나열하면 다른 용도뿐만 아니라 응답성에 부정적인 영향을 미칠 수 있으며 과부하 보호 를 호출할 수 있습니다.

사용을 최적화하려면 다음 지침을 따르십시오.

측정항목 이름 나열	지침
측정항목 이름	필요한 메트릭 이름을 신중하게 고려하십시오. 측정항목 이름의 일부를 알고 있는 경우 `name=` 필터를 사용하여 반환되는 데이터의 양을 제한합니다. 이 필터는 단순 문자 일치(정규 표현식 사용 불가)이지만 검색되는 데이터의 양을 크게 줄일 수 있습니다.
은닉처	메트릭 이름을 얻은 후에는 나중에 사용할 수 있도록 이 목록을 캐싱하는 것이 좋습니다. 대부분의 경우 메트릭 이름은 휘발성이 아니며 재사용할 수 있어 처리 시간을 절약할 수 있습니다.

앱의 측정항목 이름 나열

애플리케이션에 사용할 수 있는 메트릭 이름을 보려면 다음을 수행하십시오.

bash

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

$API_KEY API 키로 바꿉니다.

출력은 다음과 유사합니다. 여기에는 사용 가능한 여러 메트릭 이름 중 두 가지와 해당 값이 표시됩니다. 이 목록은 길 수 있습니다. 측정항목 이름을 나열하기 위한 지침 을 고려하십시오.

{
  "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'

이 예와 같이 단일 호출로 동일한 메트릭 이름에서 여러 값을 가져올 수 있습니다.

{
  "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
            }
          }
        ]
      }
    ]
  }
}

요청된 모든 값 필드를 공유하지 않는 여러 메트릭에서 값을 요청하는 경우 한 번에 하나의 메트릭 이름에서만 값을 가져올 수 있습니다.

예를 들어, 두 개의 측정항목 이름을 포함하도록 명령을 변경하면(두 개의 "names[]=" 조건과 해당 "values[]=" 조건 사용) 첫 번째 측정항목 이름( 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 나열

측정항목 이름 나열 지침

앱의 측정항목 이름 나열

앱의 메트릭 타임슬라이스 데이터 값 가져오기

하나의 측정항목 이름, 여러 값

여러 메트릭 이름, 개별 값

사용자의 편의를 위해 제공되는 기계 번역입니다.

앱 ID 및 측정항목 타임슬라이스 데이터 나열(v2)

중요

모든 애플리케이션 ID 나열 .css-21sua1{background:none;border:none;width:0;padding:0;}

이름으로 앱 ID 나열

측정항목 이름 나열 지침

앱의 측정항목 이름 나열

앱의 메트릭 타임슬라이스 데이터 값 가져오기

여러 메트릭 이름, 개별 값

모든 애플리케이션 ID 나열