Monitors continuously track the health and performance of your APIs. With Postman, you can stay up to date on what's happening across all monitors in your workspace. Or you can review individual monitors to examine test results and performance over time.
You can view your monitors in Postman by navigating to your workspace and selecting Monitors in the sidebar. Select your monitor to open a tab detailing its latest performance.
Monitors in team workspaces are visible to all members of the workspace.
You can use the monitor summary to understand how your APIs have performed over time. Each monitor run is represented by a bar in the graph. By default, this displays the monitor's Run summary view.
The upper section charts your monitor's average response time for each run, while the lower section visualizes the number of failed tests for each run across all regions. To view the exact values for failed percentage and response time, hover over each run individually.
A red bar indicates that either tests failed or errors occurred during the run. For more information, view your Console Log.
You can select Individual requests to break down your monitor summary into separate requests.
You can use filters to identify recurring patterns in your monitoring runs by selecting particular requests, run types, results, and regions (if applicable).
You can Clear Filters to return to your original dashboard view.
You can filter by request to compare an individual request's response time in different runs. Select All Requests under Filter By, then select your request.
You can filter by run type to compare how the response time changes between manual runs, scheduled runs, and webhook runs. Select Type: All, then select the type of run you'd like to analyze further.
Manual runs are initiated in Postman or are triggered by the Postman API. Scheduled runs are initiated by the schedule you set when creating or editing your monitor. Webhook runs are initiated by integrations you've created.
Each run is labeled based on its result:
You can filter by run result to compare how your runs with the same result have differed. Select Run result: All, then select one or more types of run results to view.
You can filter by region to compare how runs within different regions have varied. Select All Regions, then select a region to view.
This feature is available if you selected multiple regions when you created or last edited your monitor. To learn more about regions, see Add regions.
You can filter by mathematical formula to view the average, sum, minimum, and maximum response time for each run:
Select Average to open the menu, then select an option. To view the calculated response time value, you can hover over each run individually.
You can review past run results to understand what happened at a particular point in time. To do so, select Go to in the upper-left corner of the monitor summary or request split graph. Select the time and date, then select Apply to view a specific run.
To revert the view to your most recent runs, select the time and date you defined in the upper-left corner of the graph, then select Reset.
Select Test Results to get more detailed information on your tests, including which passed or failed, the response codes, and the response times.
If your monitor is configured to run in multiple regions, you can view the test results for a particular region by selecting it from Region.
Select Console Log to view monitor run details along with the console.log
statements that run as part of your pre-request and post-response scripts in the Postman Console. Run details specify the various stages of a monitor run such as preparing run, running, rerunning (if applicable), and the run result, along with error and test failure information. Selecting a request in the Console Log will open it in a tab, allowing you to review and edit the request as needed.
If your monitor is configured to run in multiple regions, you can view the Console logs for a particular region by selecting it from Region.
You can use the Console to both troubleshoot issues and learn more about an individual run's behavior.
Monitor run logs are retained for a period of six months. If you select a monitor run that's outside the retention period, you can view the number of failed tests and errors. Other monitor run details will no longer be available. To request this information, contact Postman support.
You can view a monitor's activity by selecting the activity feed icon in the upper-right corner.
You can check these logs to learn when a monitor was created, edited, paused, or resumed running, and which team member performed each action.
You can view details about a monitor by selecting the information icon in the upper-right corner. Here you can view a monitor's ID, creator, creation date and time, collection, environment, and integration options.
Learn how to troubleshoot your monitors and check out Postman monitoring FAQs.
Last modified: 2024/07/01