Note: This repository is not actively maintained anymore!

This is a simple server that scrapes the AWS Status (via the AWS Health API) and exports it via HTTP for Prometheus consumption. That allows you to alert on certain AWS status updates or to just make them visible on your dashboards.

Note that in order to scrape the AWS Health API your AWS account has to have a Business or Enterprise support plan. See the official documentation for details.

make

./aws-health-exporter --aws.region=eu-west-1

The aws-health-exporter exports just one metric (event count) and you want to filter by the included labels.

Example

# This gives us a list of all `open` events in region `us-east-1` of type `issue`
aws_health_events{status_code="open", region="us-east-1", category="issue"}

The labels match the corresponding AWS Event content - for a more detailed and up-to-date explanation see the offical documention here

You can deploy this exporter using the jimdo/aws-health-exporter Docker Image.

Example

docker pull jimdo/aws-health-exporter
docker run -p 9383:9383 jimdo/aws-health-exporter

The aws-health-exporter requires AWS credentials to access the AWS Health API. For example you can pass them via env vars using -e AWS_ACCESS_KEY_ID=${AWS_ACCESS_KEY_ID} -e AWS_SECRET_ACCESS_KEY=${AWS_SECRET_ACCESS_KEY} options.