---
title: Postman
description: Analyze metrics and generate events in Datadog from Postman Monitoring runs.
breadcrumbs: Docs > Integrations > Postman
---

# Postman
Supported OS 
## Overview{% #overview %}

[Postman](https://www.postman.com/) is an API platform that simplifies the steps of building an API and streamlines collaboration so you can create better APIs-faster.

This integration helps you stay on top of your monitors' health. It enables you to:

- Analyze the metrics of Postman Monitoring runs in Datadog

- Generate events for successful and failed monitoring runs.

## Setup{% #setup %}

You can find detailed instructions in [Postman's documentation](https://learning.postman.com/docs/integrations/available-integrations/datadog/). Postman Integrations require a Postman [Team, Business, or Enterprise plan](https://www.postman.com/pricing/).

### Configuration{% #configuration %}

1. Generate a Datadog [API key](https://app.datadoghq.com/organization-settings/api-keys).
1. Sign in to your Postman account and navigate to the [Datadog integration](https://go.postman.co/integrations/service/datadog).
1. Select "Add Integration."
1. To send your monitor metrics and events to Datadog:
   - Name your new integration.
   - Select the monitor whose data you would like to send to Datadog.
   - Enter your Datadog API key.
   - Select the Datadog region you would like to use.
   - Optionally choose if you want to send events, metrics or both for each run.
1. Then select "Add Integration" to finish setting up the integration.



## Data Collected{% #data-collected %}

### Metrics{% #metrics %}

|  |
|  |
| **postman.monitor.run.errors**(gauge)            | The total number of errors across all requests in a monitoring run                            |
| **postman.monitor.run.failed\_tests**(gauge)     | The total number of failed tests across all requests in a monitoring run                      |
| **postman.monitor.run.passed\_tests**(gauge)     | Total number of passed tests across all requests in a monitoring run                          |
| **postman.monitor.run.request\_count**(gauge)    | Total number of requests in a monitoring run                                                  |
| **postman.monitor.run.total\_latency**(gauge)    | The total latency time for all requests in a monitoring run                                   |
| **postman.monitor.request.bytes**(gauge)         | Total bytes sent and received for each request in a monitoring run                            |
| **postman.monitor.request.failed\_tests**(gauge) | Number of failed tests for each request in a monitoring run                                   |
| **postman.monitor.request.passed\_tests**(gauge) | Number of passed tests for each request in a monitoring run                                   |
| **postman.monitor.request.latency**(gauge)       | The latency for each request in a monitoring run                                              |
| **postman.monitor.run.http\_status\_2xx**(gauge) | Total number of requests in a monitoring run that return an HTTP status code in the 200 range |
| **postman.monitor.run.http\_status\_4xx**(gauge) | Total number of requests in a monitoring run that return an HTTP status code in the 400 range |
| **postman.monitor.run.http\_status\_5xx**(gauge) | Total number of requests in a monitoring run that return an HTTP status code in the 500 range |

### Service Checks{% #service-checks %}

Postman does not include any service checks.

### Events{% #events %}

An event is generated each time a monitor runs in Postman. The severity of the event is based on the tests in the Postman monitor:

| Severity | Description                                                           |
| -------- | --------------------------------------------------------------------- |
| `Low`    | If all the tests pass                                                 |
| `Normal` | If some tests fail, or an error occurs in the execution of any event. |

## Troubleshooting{% #troubleshooting %}

Need help? Contact [Postman Support](https://www.postman.com/support/).