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 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):

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:

• 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):

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:

• 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)