/aws-health-tools

The samples provided in AWS Health Tools can help users to build automation and customized alerting in response to AWS Health events.

Primary LanguagePythonApache License 2.0Apache-2.0

AWS Health Tools

Description

The samples provided in AWS Health Tools can help you build automation and customized alerts in response to AWS Health events.

AWS Health provides ongoing visibility into the state of your AWS resources, services, and accounts. The service gives you awareness and remediation guidance for resource performance or availability issues that may affect your applications that run on AWS. AWS Health provides relevant and timely information to help you manage events in progress, as well as be aware of and prepare for planned activities. The service delivers alerts and notifications triggered by changes in the health of AWS resources, so you get near-instant event visibility and guidance to help accelerate troubleshooting.

More information about AWS Health and Personal Health Dashboard (PHD) is available here: http://docs.aws.amazon.com/health/latest/ug/what-is-aws-health.html

NOTE: To get notifications about public events (global events that are not tied to your account), you must have a Business or Enterprise support plan from AWS Support. If you call the AWS Health API from an AWS account that doesn't have a Business or Enterprise support plan, you receive a SubscriptionRequiredException error.

Setup and usage instructions are present for each tool in its respective directory:

Solutions:

AWS Health Aware (AHA) - automated notification solution for sending well-formatted AWS Health Alerts across accounts and regions

Custom Notifications:

AWS Health event SMS notifier
AWS Health event Chime notifier
AWS Health event Amazon Simple Notification Service (SNS) Topic Publisher
AWS Health event Slack notifier
AWS Health event Direct Connect maintenance notifier
AWS Health event Coralogix notifier
AWS Health Abuse event DOS report notifier
AWS Health SHD event Chime/Slack/SNS notifier
AWS Health Organizational View Alerts

Automated Actions:

AWS Codepipeline disable stage transition triggered when AWS Health issue event generated
AWS Health AWS_EC2_INSTANCE_STORE_DRIVE_PERFORMANCE_DEGRADED triggers automated EC2 Instance stop or terminate
AWS Health AWS_ELASTICLOADBALANCING_ENI_LIMIT_REACHED triggers freeing up of unused ENIs
AWS Health AWS_RISK_CREDENTIALS_EXPOSED remediation
AWS Health AWS_EBS_VOLUME_LOST Remediation

Demos:

AWS Health API high availability endpoint

Architecture

License

AWS Health Tools are licensed under the Apache 2.0 License.

Disclaimer: The “AWS__OPERATIONAL_ISSUE” Amazon CloudWatch event type codes are for events where AWS is posting details to specific AWS accountIds. General service health events are not posted to this event type code at this time. Instead they are currently posted to the Service Health Dashboard (SHD) and are visible via the Personal Health Dashboard (PHD) in the AWS management console as well as returned via the AWS Health API.