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 Overview page in the Servers table, in the column labeled Memory, or in the corresponding chart.
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[]=CPU/User+Time
with values[]=percent
.
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[]=Memory/Physical&values[]=used_mb_by_host&summarize=true'
- Replace
${APP_ID}
and${APIKEY}
with your app ID and your account's API key. - Replace the
${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 REST API key or Admin's 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 ${APIKEY}
with your app ID and your account's API key.
curl -X GET "https://api.newrelic.com/v2/applications/${APP_ID}/metrics/data.json" \ -H "X-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 REST API key or Admin's API key.
- Add your application ID and the
names[]=Memory/Physical
andvalues[]=total_used_mb
metrics in the appropriate fields.
For more help
Additional documentation resources include:
- Using the API Explorer (using the API Explorer's user interface to get data in and data out of New Relic)
- Parts of the API Explorer (a quick reference for how to use each section of the API Explorer)