---
title: AWS Health
description: >-
  AWS Health provides ongoing visibility into the state of your AWS resources,
  services, and accounts.
breadcrumbs: Docs > Integrations > AWS Health
---

# AWS Health

{% callout %}
# Important note for users on the following Datadog sites: us2.ddog-gov.com

{% alert level="info" %}
To find out if this integration is available in your organization, see your [Datadog Integrations](https://app.datadoghq.com/integrations) page or ask your organization administrator.

To initiate an exception request to enable this integration for your organization, email [support@ddog-gov.com](mailto:support@ddog-gov.com).
{% /alert %}

{% /callout %}

## Overview{% #overview %}

AWS Health provides ongoing visibility into the state of your AWS resources, services, and accounts. Enable this integration to see AWS Health service events in Datadog:



**Note**: This integration only works for AWS customers with a Business or Enterprise support plan.

## Setup{% #setup %}

### Installation{% #installation %}

If you haven't already, set up the [Amazon Web Services integration](https://docs.datadoghq.com/integrations/amazon_web_services.md) first.

### Metric collection{% #metric-collection %}

1. Add the following permissions to your [Datadog IAM policy](https://docs.datadoghq.com/integrations/amazon_web_services.md#installation) in order to collect AWS Health data. For more information, see the [Health policies](https://docs.aws.amazon.com/health/latest/ug/controlling-access.html) on the AWS website.

| AWS Permission                    | Description                                      |
| --------------------------------- | ------------------------------------------------ |
| `health:DescribeEvents`           | Used to list all health events                   |
| `health:DescribeEventDetails`     | Gets detailed information on health events       |
| `health:DescribeAffectedEntities` | Gets the affected AWS entities for health events |

1. Install the [Datadog - AWS Health integration](https://app.datadoghq.com/integrations/amazon-health).

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

### Metrics{% #metrics %}

The AWS Health integration does not include any metrics.

### Events{% #events %}

The AWS Health integration includes events found in the AWS Personal Health Dashboard. Examples include open issues, scheduled maintenances, and account notifications.

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

The AWS Health integration does not include any service checks.

## Troubleshooting{% #troubleshooting %}

Need help? Contact [Datadog support](https://docs.datadoghq.com/help/).
