Get host memory used for an application

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 Hosts 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[]=Memory/Physical 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:

To obtain the same information from the New Relic API Explorer (v2):

  1. Select Application Hosts > GET Metric Data, and include your REST API key or Admin's API key.
  2. Add your application ID, host id, and the names[]=Memory/Physical and values[]=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:

To obtain the same information from the New Relic API Explorer (v2):

  1. Select Applications > GET Metric Data, and include your REST API key or Admin's API key.
  2. Add your application ID and the names[]=Memory/Physical and values[]=total_used_mb metrics in the appropriate fields.

For more help

Additional documentation resources include:

Recommendations for learning more: