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 Summary page in the Hosts 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 "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 API key. - Replace the
$HOST_ID
with the host id of your target host.
For additional detail:
- Remove
summarize=true
to obtain detailed time series data. - Specify a different time range.
Tip
To get the same information from the New Relic API Explorer (v2), select Application Hosts > GET Metric Data, and include your 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 "Api-Key:$API_KEY" -i \> -d 'names[]=CPU/User+Time&values[]=percent&summarize=true'
For additional detail:
- Remove
summarize=true
to obtain detailed time series data. - Specify a different time range.
Tip
To get the same information from the New Relic API Explorer (v2), select Applications > GET Metric Data, and include your API key. Add your application ID, and the names[]=CPU/User Time
and values[]=percent
metrics in the appropriate fields.