New Relic REST API(v2)는 성능상의 이유로 일부 응답에 페이지를 매깁니다. 일부 쿼리에서는 전체 데이터 세트를 반환하는 것이 가능하지만 매우 많은 양의 데이터를 반환하는 다른 쿼리에서는 불가능하기 때문입니다.
요구 사항 및 제한 사항
측정항목 데이터 반환:
- 일부 고객의 메트릭 출력에 더 이상 페이지 매김을 사용할 수 없습니다(2020년 12월부터 사용 중단).
- 셀당 최대 3000개의 결과를 반환합니다. 큰 출력의 경우 애플리케이션 ID 또는 다른 속성을 사용하여 쿼리 범위를 좁히는 것이 좋습니다.
반환된 데이터의 정렬 순서는 불확실합니다. 특정 순서를 가정하거나 의존하지 마십시오.
페이지당 반환되는 데이터는 요청된 데이터에 따라 다릅니다. 페이지 수는 목록을 완성하는 데 필요한 JSON 개체 수에 따라 다릅니다.
중요
메트릭 이름을 나열하기 전에 메트릭 이름 나열 지침 을 참조하십시오.
특정 페이지 요청
페이지를 지정하려면 쿼리에 page= 매개변수를 추가합니다. 다음은 예입니다.
curl -X GET 'https://api.newrelic.com/v2/alerts_incidents.json?page=3' \
-H "Api-Key:$API_KEY" -iREST API Explorer에서 보고 있는 페이지를 빠르게 변경할 수 있습니다.
페이지 수를 보여주는 링크 헤더 예
데이터에 페이지가 매겨진 경우 API 호출은 Link 헤더를 반환합니다. 이것은 페이지 수와 보고 있는 페이지를 나타냅니다. 이 줄은 REST API 탐색기의 Response 상단에도 나타납니다.
중요
링크 헤더는 출력 데이터에 페이지가 매겨진 경우에만 나타납니다.
팁
위반 엔드포인트(https://api.newrelic.com/v2/alerts_violations.json)를 호출할 때 rel="last" 참조가 표시되지 않습니다. 이 엔드포인트를 호출할 때 최종 페이지를 결정하려면 rel="next" 참조가 없는지 확인하십시오.
curl 의 일부 구현을 사용하여 이 줄을 얻으려면 -v 옵션을 포함해야 할 수 있습니다.
curl -v -X GET 'https://api.newrelic.com/v2/applications/$APP_ID/...'New Relic은 링크에 RFC 5988 표준 형식을 사용합니다.