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.
Important
While the examples utilize New Relic's REST API v2, we recommend using NRQL functions for executing metric timeslice queries. Each API value can be mapped to an equivalent NRQL function. To learn how to create NRQL queries based on these API examples, refer to our documentation.
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.
Conseil
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.
Conseil
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.