Integrate Postman with New Relic

New Relic is an application performance management solution to monitor real-time and trending data for your processes or web apps. Using Postman's New Relic integration, you can send Postman Monitor results to New Relic.

Setting up a New Relic monitor integration requires you to get an API key (Ingest License key) from New Relic and configure your Postman monitors. After you set up the integration, you can view real-time alerts based on the results of your monitors.

You can also view New Relic application performance management (APM) metrics in the Postman API Builder. Viewing APM metrics is a separate integration from sending monitor results to New Relic and uses a different New Relic API key. Learn more about viewing New Relic APM metrics.

Retrieve your New Relic Ingest License key

To retrieve your Ingest License key from New Relic, do the following:

Sign in to New Relic.
Select your avatar, then select API Keys.
Select the three dots next to the INGEST - LICENSE key and then select Copy key ID.

Get a New Relic Ingest key

There are different types of API keys in New Relic. Use an Ingest License key for Postman Monitor integration. For more information on API Keys in New Relic, see the New Relic API keys documentation.

Configure the New Relic integration

From the Home page select Integrations.
Select Browse All Integrations, and then search for New Relic.
There are two New Relic integrations available in Postman. Next to the option labeled Post monitoring results, select Add Integration.
Enter a Nickname for the integration.
Select the workspace with the monitor you want to use.
Select the monitor you want to use.
For New Relic API key, enter the Ingest License key you copied from New Relic.
Select a New Relic region. New Relic offers the US and EU region instances. See the New Relic data center documentation for more information.
Select Add Integration.

You can view your configured integrations on the Browse Integrations page. You can also view integrations that have been configured for a monitor by opening the monitor and selecting Monitor details in the right sidebar. Learn more about viewing or editing integrations.

Visualize your data with the Postman quickstart

New Relic I/O (Instant Observability) has integrations that bundle observability tools to help you get started with monitoring your stack. The Postman quickstart provides you with an out-of-the-box dashboard with a suggested view for API monitoring.

To visualize your data with the Postman quickstart, do the following:

Install the Postman quickstart in New Relic I/O.
If you don't have a New Relic account, follow the sign up instructions to get started for free. Check your email for a link to continue to the next step.
Select an account, then select Begin installation.
Under Postman (manual install) select Done if you've already completed the steps in the Configure New Relic integration section.
Select See your data.
You can visualize your Postman API data on the New Relic dashboard.

Visualize Postman API data in New Relic

Manually view and query data in New Relic

When your monitor runs, Postman starts sending metrics data to New Relic. Once the data is present in New Relic, you can query and display metrics.

In New Relic, select Metrics and Events and then select Metrics. To view Postman Monitor results, search for metrics that begin with "postman". You can create queries to customize the graph displayed. New Relic also has a query builder to help you construct advanced searches.

You can add one or more charts to a dashboard, tracking key metrics over time. For more information, see the New Relic dashboard documentation.

Metrics pushed to New Relic

Postman pushes the following metrics and their values to New Relic. Run-level metrics are valid for the entire run (for example, the number of errors). Request-level metrics send data for each request in the collection used by the monitor. You can filter for each specific request using the dimensions passed along with the metric.

Metric	Description
`postman.monitor.request.failedtests`	The number of failed tests written in the Postman post-response script for a request.
`postman.monitor.request.passedtests`	The number of passed tests written in the Postman post-response script for a request.
`postman.monitor.request.requestbytes`	The total number of bytes exchanged in a request.
`postman.monitor.request.totallatency`	The total latency of a request.
`postman.monitor.run.errors`	The total number of errors (such as DNS resolution errors) that occurred while running the requests.
`postman.monitor.run.failedtests`	The number of failed tests written in the Postman post-response script, across all requests in a collection.
`postman.monitor.run.httpstatus2xx`, `postman.monitor.run.httpstatus4xx`, `postman.monitor.run.httpstatus5xx`	The total count of these returned status codes for your APIs within a collection.
`postman.monitor.run.passedtests`	The number of failed tests written in the Postman post-response script, across all requests in a collection.
`postman.monitor.run.requestcount`	The number of requests in the collection.
`postman.monitor.run.totalbytes`	The total number of bytes exchanged while running the monitor.
`postman.monitor.run.totallatency`	The total latency after running all the requests in the collection.
`postman.monitor.run.warnings`	The total number of warnings after running all the requests in the collection.

Dimension attributes

You can use several attributes as dimensions when viewing metrics in New Relic. For example, add monitor.name or user.name to show separate lines for the monitor or user in the graph. The following example pivots latency data with regions:

New Relic filters