You can use the New Relic REST API (v2) to obtain the average memory usage for your application on a single host. This value appears on the APM Summary page in the Hosts table, in the column labeled Memory, or in the corresponding chart.
Importante
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 memory usage for a host
To obtain the average Memory usage for one of your app's hosts, use the following command to obtain the metric names[]=Memory/Physical
with values[]=percent
.
$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[]=Memory/Physical&values[]=used_mb_by_host&summarize=true'
- Replace
$APP_ID
and$API_KEY
with your app ID and your API key. - Replace
$HOST_ID
with the host id of your target host.
This example shows the time range for the default time period (last 30 minutes). For additional detail:
- Remove the
summarize=true
to obtain detailed time series data. - Specify a different time range.
To obtain 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[]=Memory/Physical
andvalues[]=used_mb_by_host
metrics in the appropriate fields.
Get memory usage for the entire app
To obtain the average Memory usage for your application, use a command similar to the one in the previous example, but remove the reference to hosts and $HOST_ID
. Replace $APP_ID
and $API_KEY
with your app ID and your API key.
$curl -X GET "https://api.newrelic.com/v2/applications/$APP_ID/metrics/data.json" \> -H "Api-Key:$API_KEY" -i \> -d 'names[]=Memory/Physical&values[]=total_used_mb&summarize=true'
For additional detail:
- Remove the
summarize=true
to obtain detailed time series data. - Specify a different time range.
To obtain 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[]=Memory/Physical
andvalues[]=total_used_mb
metrics in the appropriate fields.