AWS health

AWS health

The Amazon Health integration allows StatusGator to ingest your private AWS Health status directly into your StatusGator board and status page. This ensures that service-impacting events detected by AWS are visible to your team and subscribers.

Features

• Private health data ingestion – Import private AWS Health events not published publicly.
• Detailed event visibility – View affected entities, event types, and descriptions in StatusGator.
• Full integration with your boards – Get alerts and display AWS Health issues alongside other monitors.

Set up the Amazon Health integration

1. Create a new IAM user

1. Sign into your AWS account and navigate to IAM.

2. Go to Users and create a new user with a clear name, for example:

   statusgator-aws-private-status.

   Do not enable AWS Management Console access.

2. Create a custom policy

1. On the Set permissions screen, choose Attach policies directly and click Create policy.
2. Under Specify permissions, use the following JSON:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "health:DescribeEvents",
        "health:DescribeEventDetails",
        "health:DescribeAffectedEntities",
        "health:DescribeEventTypes",
        "health:DescribeEventAggregates"
      ],
      "Resource": "*"
    }
  ]
}

3. Give your policy a descriptive name and save it.

3. Attach the policy to the user

1. Apply the newly created policy to the IAM user

2. Finalize user creation.

4. Generate access keys

1. Open the new user’s Security Credentials tab.
2. Create a new access key.
3. For the use case, select Other.

4. (Optional) Add an access key description tag for tracking.

Make sure to securely store the Access Key ID and Secret Access Key, as you will need them to connect AWS Health to StatusGator.

5. Connect to StatusGator

1. In StatusGator, go to Integrations → Private Status Ingestion → Amazon Health → Add.
2. Enter the Access Key ID and Secret Access Key from AWS.

3. Click Save.