Monitors

Monitors

Objectives

  • Learn how to run your collections at regular intervals (Pro feature but there’s a free version. 1000 API calls per month for free)
  • Receive email notifications from Postman

Monitoring is a way to stay up to date on the health and performance of your APIs. Postman's built-in monitoring service helps you consolidate. Monitors can be scheduled as frequently as every 5 minutes and will run through each request in your collection, similar to the collection runner.

The value of monitors lies on your test scripts. When running your collection, a monitor will use your tests to validate the responses it's receiving. When one of these tests fail, you can automatically receive an email notification or configure the available integrations to receive alerts in tools like Slack.

You can use Postman monitoring with any Paid or Free plan type.

Creating a Monitor

In Postman, select any Collection, hover over the collection name and click the three dots menu, and choose Monitor Collection

You will then need to give your Monitor a name. For the rest of the configurations, let's leave it default for now. But know that you can edit it anytime and customise it to serve what you need. When you're ready, just click the big Create button. And that's it!

You can either wait for it to run as per its schedule or trigger a run manually.

Basic Monitor Configurations

  1. When creating or editing a monitor, you can choose to receive email notifications for run failures and errors. You can define up to five recipients and configure when you would like to stop failure notifications for consecutive run failures.
  2. You can configure your monitor to run as often as you would like, automatically. This could be up to every five minutes for a status page or a basic check once a week on your endpoints.
  3. You can allow Postman to auto-select a region for your monitor or you can opt to select your regions manually. Postman offers multiple regions to choose from, enabling you to accurately track uptime and reliability on a global scale, without the need to procure your own regional servers.
  4. You have the option to Retry if run fails. If this is enabled and a failure occurs during a run, Postman will automatically rerun the failed request to avoid false alarms due to transient issues.
  5. You can configure a Request timeout if you'd like to make sure all of your requests run within a certain amount of time. By default, requests do not have a timeout value, however each monitor run has a timeout of five minutes. 
  6. You can add a Delay between requests to your monitor. This will insert a delay between all requests in your collection.
  7. You can use Don't follow redirects to reject URL redirection for requests run via a monitor.


Next