La API REST de New Relic (v2) pagina algunas respuestas por motivos de rendimiento. Esto se debe a que devolver todo el conjunto de datos puede ser factible para algunas consultas, pero prohibitivo para otras que devuelven una gran cantidad de datos.
Requisitos y limitaciones
Retorno de datos métricos:
- La paginación ya no está disponible para la salida métrica para algunos clientes (desuso a partir de diciembre de 2020).
- Devuelve hasta 3000 resultados por celda. Para resultados grandes, recomendamos limitar la consulta utilizando el ID de la aplicación u otro atributo.
El orden de clasificación de los datos devueltos es indeterminado. No asuma ni confíe en un orden en particular.
Los datos devueltos por página dependen de los datos que se solicitan. El número de páginas depende del número de objetos JSON necesarios para completar la lista.
Importante
Antes de enumerar nombres métricos, consulte las pautas para enumerar nombres métricos.
Solicitar una página específica
Para especificar una página, agregue el parámetro page=
a la consulta. He aquí un ejemplo:
curl -X GET 'https://api.newrelic.com/v2/alerts_incidents.json?page=3' \
-H "Api-Key:$API_KEY" -i
En REST API Explorer, puede cambiar rápidamente la página que se está viendo.
Ejemplos de encabezados de enlaces que muestran el recuento de páginas
La llamada API devuelve el encabezado Link
si los datos están paginados. Esto indica el número de páginas y la página que se está viendo. Esta línea también aparece en la parte superior de Response
en el Explorador de API REST.
Importante
El encabezado Enlace solo aparecerá si los datos de salida están paginados.
Sugerencia
La referencia rel="last"
no se mostrará al realizar llamadas al extremo de infracción (https://api.newrelic.com/v2/alerts_violations.json
). Para determinar la página final al realizar llamadas a este extremo, busque la ausencia de una referencia rel="next"
.
Para obtener esta línea utilizando algunas implementaciones de curl
, es posible que deba incluir la opción -v
.
curl -v -X GET 'https://api.newrelic.com/v2/applications/$APP_ID/...'
New Relic utiliza el formato estándar RFC 5988 para enlaces.