Skip to main content
APIContext
Talk to salesStart free
Start HereGuidesConceptsCLIReferenceChangelog

Postman Collection Monitors

If you have your monitors and tests in PostmanPostman, duplicating effort to add them to APImetrics can seem like a daunting task.

To solve this problem, we offer the option to manage your collections in Postman but take advantage of running calls through our data centers (only available for Google, AWS and Azure locations) and generate analysis and insight using APImetrics.

For this to work, you will need to configure a Postman API key (which is covered in the working with Postman guide) AND generate an APImetrics API key - if you do not have an APImetrics API key, you can generate this when you link Postman and APImetrics.

Importing APIs also available

If you'd rather import your API definitions from Postman or a variety of other formats, see the Importing Monitors and Importing from Postman pages.

Postman Monitoring uses the Postman API

Make sure your Postman subscription has enough quota

Setup​

To get started, on the Monitor Postman Collection page, click "Configure a new Postman Collection monitor".

Configured Postman collections page with no collections monitored and a Configure a new Postman Collection monitor button

You may need to generate an APImetrics API key - click "Generate Auth Settings" to continue.

Configure a new Postman collection monitor screen prompting to generate APImetrics API authentications via Generate Auth Settings

Select your Collection and Environment​

Select your Postman Collection step listing available collections such as Problem APIs, Postman Echo and APImetrics APIs

Select the Collection you wish to monitor. On the next page select the Environment (if any) you wish to use.

On the last page, there are some optional parameters you may add or change. Once happy, press "Create new monitor" to create the monitor.

Optional Parameters form with globals, folder, timeout and redirect fields and a Create new monitor button

The collection will appear under your Configured Postman collection list at the top.

Configured Postman collections list showing the Postman Echo collection with a New Schedule option

Start monitoring​

Schedule your collection

You must schedule the collection to start monitoring

Select a schedule to start monitoring. The schedule must be a Postman-only schedule as the Postman monitors are only available on a sub-set of our locations.

Schedule picker with the Postman Sched schedule selected and a delete button

You can use the Add Schedule button to create a new schedule:

Edit Schedule dialog setting name, frequency, regions and Postman-only Schedule toggled On

Once the Collection monitoring starts, your account will be populated with the monitors in the collection, and the results will appear. Note that you cannot edit the monitors in APImetrics - you must save any changes to the Collection from Postman.

Ensure timing accuracy

As we’re running the Postman Collections “natively”, it re-uses connections when running sequential calls in a collection. This means that will see DNS lookup, TCP connection time and SSL handshake values will appear as 0ms for subsequent monitors. In order to avoid that, add a “Connection: close” header to the monitors in the Collection. This is purely optional, but will mean we get more accurate timings.