NOTE: New Relic Servers and Legacy Alerts are going away on or before May 15, 2018. Check out our post in the Online Technical Community for more information.

Get load average values on a host (v2)


For the latest, most advanced host monitoring, check out New Relic Infrastructure.

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:

Discuss New Relic Servers in the New Relic Online Technical Community! Troubleshoot and ask questions, or discuss Servers for Linux or Servers for Windows in detail.

If you need additional help, get support at