Get load average values on a host (v2)


New Relic Servers is no longer available. For infrastructure monitoring, please use New Relic Infrastructure. For how to switch to Infrastructure from Servers, see the transition guide.

Load average is the value that appears on the Servers Overview page when you mouse over the Load average chart. This document gives an example of how to use the New Relic REST API (v2) to find the load average value for a specific server ID and REST API key.

When acquiring data, the values returned will be affected by the time period you specify and the way the data is stored. For more information, see Extracting metric timeslice data For more about load average, see Servers chart descriptions.

Load average, last 30 minutes

To get the load average values recorded for each minute during the last 30 minutes, use the metric name System/Load. For example:

curl -X GET "${SERVER_ID}/metrics/data.json" \
     -H "X-Api-Key:${API_KEY}" -i \
     -d 'names[]=System/Load&values[]=average_value'

To get an "average of the averages" (summarize), change this command to:

curl -X GET "${SERVER_ID}/metrics/data.json" \
     -H "X-Api-Key:${API_KEY}" -i \
     -d 'names[]=System/Load&values[]=average_value&summarize=true' 

Load average, specific time range

To get the load average values for an arbitrary time range, add the time period to the command. For example:

curl -X GET "${SERVER_ID}/metrics/data.json" \
     -H "X-Api-Key:${API_KEY}" -i \
     -d 'names[]=System/Load&values[]=average_value&from=2014-01-06T18:26:59+00:00&to=2014-01-13T18:26:59+00:00'

The exact time periods returned will depend on the length and age of the data requested.

For more help

Additional documentation resources include:

New Relic Servers is unavailable as of May 15, 2018. For more information: