Get average CPU usage per host for an app

You can use the New Relic REST API (v2) to get the average CPU usage for your application on a single host. This value appears on the APM Overview page in the Servers table, in the column labeled CPU usage.

Get CPU usage for a host

To get the average CPU usage for one of your app's hosts, use a single command to obtain the metric names[]=CPU/User+Time with values[]=percent. This example shows the time range for the default time period (last 30 minutes):

curl -X GET "https://api.newrelic.com/v2/applications/${APP_ID}/hosts/${HOST_ID}/metrics/data.json" \
     -H "X-Api-Key:${API_KEY}" -i \
     -d 'names[]=CPU/User+Time&values[]=percent&summarize=true'
  • Replace ${APP_ID} and ${API_KEY} with your app ID and your account's API key.
  • Replace the ${HOST_ID} with the host id of your target host.

For additional detail:

To get the same information from the New Relic API Explorer (v2), select Application Hosts > GET Metric Data, and include your REST API key or Admin's API key. Add your application ID, host id, and the names[]=CPU/User Time and values[]=percent metrics in the appropriate fields.

Get CPU usage for the entire app

To get the average CPU usage for your application, use a command similar to the one in the previous example but without the reference to the host_id:

curl -X GET "https://api.newrelic.com/v2/applications/${APP_ID}/metrics/data.json" \
     -H "X-Api-Key:${API_KEY}" -i \
     -d 'names[]=CPU/User+Time&values[]=percent&summarize=true'
  • Replace ${APP_ID} and ${API_KEY} with your app ID and your account's API key.

For additional detail:

To get the same information from the New Relic API Explorer (v2), select Applications > GET Metric Data, and include your REST API key or Admin's API key. Add your application ID, and the names[]=CPU/User Time and values[]=percent metrics in the appropriate fields.

For more help

Additional documentation resources include:

Recommendations for learning more: