A API REST da New Relic (v2) pagina algumas respostas, por motivos de desempenho. Isso ocorre porque retornar todo o conjunto de dados pode ser viável para algumas consultas, mas proibitivo para outras que retornam uma quantidade muito grande de dados.
Requisitos e limitações
retorno de dados métricos:
- A paginação não está mais disponível para saída métrica para alguns clientes (descontinuação a partir de dezembro de 2020).
- Retorna até 3.000 resultados por célula. Para resultados grandes, recomendamos restringir a consulta usando o ID do aplicativo ou outro atributo.
A ordem de classificação dos dados retornados é indeterminada. Não assuma ou confie em uma ordem específica.
Os dados retornados por página dependem de quais dados são solicitados. O número de páginas depende do número de objetos JSON necessários para completar a lista.
Importante
Antes de listar nomes de métricas, consulte as diretrizes para listagem de nomes de métricas.
Solicite uma página específica
Para especificar uma página, adicione o parâmetro page=
à consulta. Aqui está um exemplo:
curl -X GET 'https://api.newrelic.com/v2/alerts_incidents.json?page=3' \
-H "Api-Key:$API_KEY" -i
No REST API Explorer, você pode alterar rapidamente a página que está sendo visualizada.
Exemplos de cabeçalho de link mostrando contagem de páginas
A chamada de API retornará o cabeçalho Link
se os dados forem paginados. Isso indica o número de páginas e a página que está sendo visualizada. Essa linha também aparece na parte superior de Response
no REST API Explorer.
Importante
O cabeçalho do link só aparecerá se os dados de saída forem paginados.
Dica
A referência rel="last"
não será mostrada ao realizar chamadas para o endpoint de cumprimento (https://api.newrelic.com/v2/alerts_violations.json
). Para determinar a página final ao fazer chamadas para este endpoint, procure a ausência de uma referência rel="next"
.
Para obter esta linha usando algumas implementações de curl
, pode ser necessário incluir a opção -v
.
curl -v -X GET 'https://api.newrelic.com/v2/applications/$APP_ID/...'
A New Relic usa o formato padrão RFC 5988 para links.