# Integrate Postman with Datadog
[Datadog](https://www.datadoghq.com/) is a monitoring service for cloud-scale applications. It combines data from servers, databases, tools, and services to present a unified view of an entire stack. This integration enables you to configure your [Postman Monitors](/docs/monitoring-your-api/intro-monitors/) to send metrics to Datadog, where you can visualize and compare them with other metrics.
Setting up a Datadog integration requires a Datadog API key and configuring your Postman monitors. After setting up the integration, you can view real-time alerts based on the results of your monitors.
**You can also view Datadog application performance management (APM) metrics in the Postman API Builder.** Viewing APM metrics is a separate integration from sending monitor results to Datadog. Learn more about [viewing Datadog APM metrics](/docs/design-apis/api-builder/observe-apis/datadog-apm/).
## Get your Datadog API key
1. Sign in to [Datadog](https://app.datadoghq.com/). Open your [**Organization Settings**](https://docs.datadoghq.com/account_management/org_settings/) interface, then click [**API Keys**](https://app.datadoghq.com/organization-settings/api-keys).
2. [Create](https://docs.datadoghq.com/account_management/api-app-keys/#add-an-api-key-or-client-token) a Datadog API key, then copy it so you can use it later.
## Configure your Postman Monitors
1. From the **[Home](https://go.postman.co/home)** page, select **[Integrations](https://go.postman.co/integrations)**.
2. Click **Browse All Integrations**, then select **[Datadog](https://go.postman.co/integrations/service/datadog)**.
3. Select **Add Integration** for **Post monitoring results**.
4. Configure your integration settings for Datadog:
* **Nickname** - A nickname for the integration.
* **Choose workspace** - Select the workspace that has your monitor.
* **Choose Monitor** - Select the monitor that sends its results to Datadog.
* **Select Datadog region** - Select the Datadog region you want to use.
* **Datadog API Key** - Enter your [Datadog API key](#get-your-datadog-api-key).
* Select the **Send events for completed runs** or **Send metrics for each run** checkboxes if you don't want to send run events or metrics.
5. Click **Add Integration** to complete the integration.
**You can view your configured integrations on the [Browse Integrations](https://go.postman.co/integrations/browse) page.** You can also view integrations that have been configured for a monitor by opening the monitor and clicking 
**Monitor details** in the right sidebar. Learn more about [viewing or editing integrations](/docs/integrations/intro-integrations/#view-or-edit-integrations).
## View data in Datadog
When your monitor runs, the data starts flowing into Datadog.
Once the data is present in Datadog, you can filter it. You can filter results by monitor name or ID, collection name or UID, user name or ID, and environment name or UID (if present). You can also combine different metrics to create a dashboard.
## Forward Postman metrics
Postman can forward a wide array of monitor metrics to Datadog. The following table lists the metric, its type, and the metric's level. For more information about Datadog's metric collection, see [Datadog's Metrics documentation](https://docs.datadoghq.com/metrics/).
| Metric | Type | Description | Level |
| --------------------------------------- | ----- | ---------------------------------------------------------------------------------------------- | ------- |
| `postman.monitor.run.errors` | Gauge | Total number of errors across all requests in a monitoring run. | Run |
| `postman.monitor.run.failed\_tests` | Gauge | Total number of failed tests across all requests in a monitoring run. | Run |
| `postman.monitor.run.passed\_tests` | Gauge | Total number of passed tests across all requests in a monitoring run. | Run |
| `postman.monitor.run.request\_count` | Gauge | Total number of requests in a monitoring run. | Run |
| `postman.monitor.run.total\_latency` | Gauge | The total latency time for all requests in a monitoring run. | 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. | Run |
| `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. | Run |
| `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. | Run |
| `postman.monitor.request.latency` | Gauge | Latency for each request in a monitoring run. | Request |
| `postman.monitor.request.failed\_tests` | Gauge | Number of failed tests for each request in a monitoring run. | Request |
| `postman.monitor.request.passed\_tests` | Gauge | Number of passed tests for each request in a monitoring run. | Request |
| `postman.monitor.request.bytes` | Gauge | Total bytes sent and received for each request in a monitoring run. | Request |
## Metrics tags
Postman sends tags to Datadog along with each metric and event. Tags enable you to filter the metric based on various parameters such as monitor name or collection name. The following tags are sent by Postman to Datadog:
| Tag | Description |
| ----------- | -------------------------------------------------------------- |
| Region | The region from where the monitor is run. |
| Triggers | What triggered the monitor run: Manual, Webhook, or Scheduled. |
| Run results | Successful, Failure, Error, or Abort. |
| Level | The level the metric is captured for: Run or Request. |
| Status Code | HTTP response code for the request run. |
| Job ID | Monitor's Job ID. |
| Request ID | The request identifier. |
## Update existing integrations
Postman is a Datadog Technology Partner, and Postman's integration is available in Datadog's [Integrations](https://docs.datadoghq.com/integrations/postman/). To enable the partnership, the metrics produced by Postman were renamed, as detailed in the [Forward Postman metrics](#forward-postman-metrics) section. If you have integrations created before the integration listing on Datadog, you must update them to take advantage of the integration listing.
To update existing integrations, do the following:
1. Go to the [Post monitoring results](https://go.postman.co/integrations/service/datadog/monitor_run_datadog) page.
2. Select the integration you want to upgrade.
3. Click **Update Now**, then click **Update Integration** on the confirmation box to upgrade the integration.
4. Click **Confirm**.
The updated integration has the following benefits:
* The Postman metrics for the integration are no longer treated as [Custom Metrics](https://docs.datadoghq.com/metrics/) in Datadog, which means they're free. (Custom metrics on Datadog are [charged](https://docs.datadoghq.com/account_management/billing/custom_metrics/?tab=countrategauge).)
* Datadog provides a default dashboard that you can use to observe the monitor. Change the `monitor_name` variable to the monitor for which you want to observe the dashboard.
