This code contains Prometheus Exporter which monitors status of AWS Services ( Service Health Dashboard ) as AWS does not provide public APIs for this. The only possible solution is to use Health API/Personal health Dashboard, but for this you must be subscribed to AW Business supportplan.
This exporter scrapes AWS Status web-page and provides metrics per continent/region/service.
usage: aws_service_health_exporter.py [-h] [-p PORT] [-t DELAY]
Prometheus exporter for AWS Service Health Dashboard.
optional arguments:
-h, --help show this help message and exit
-p PORT address on which to expose metrics (default "8000")
-t DELAY refresh rate for metrics in seconds (default "5")
# HELP AWSServiceHealthDashboard1 Metrics for all AWS Services
# TYPE AWSServiceHealthDashboard1 gauge
aws_service_health{continent="EU",region="Frankfurt",service="Amazon API Gateway",status="Service is operating normally"} 4.0
aws_service_health{continent="EU",region="Ireland",service="Amazon API Gateway",status="Service is operating normally"} 4.0
aws_service_health{continent="EU",region="London",service="Amazon API Gateway",status="Service is operating normally"} 4.0
aws_service_health{continent="EU",region="Paris",service="Amazon API Gateway",status="Service is operating normally"} 4.0
aws_service_health{continent="EU",region="Stockholm",service="Amazon API Gateway",status="Service is operating normally"} 4.0
aws_service_health{continent="EU",region="Frankfurt",service="Amazon AppStream 2.0",status="Service is operating normally"} 4.0
aws_service_health{continent="EU",region="Ireland",service="Amazon AppStream 2.0",status="Service is operating normally"} 4.0
aws_service_health{continent="EU",region="Frankfurt",service="Amazon Athena",status="Service is operating normally"} 4.0
aws_service_health{continent="EU",region="Ireland",service="Amazon Athena",status="Service is operating normally"} 4.0
aws_service_health{continent="EU",region="London",service="Amazon Athena",status="Service is operating normally"} 4.0
aws_service_health{continent="EU",region="Global",service="Amazon Chime",status="Service is operating normally"} 4.0
aws_service_health{continent="EU",region="Frankfurt",service="Amazon Cloud Directory",status="Service is operating normally"} 4.0
aws_service_health{continent="EU",region="Ireland",service="Amazon Cloud Directory",status="Service is operating normally"} 4.0
aws_service_health{continent="EU",region="London",service="Amazon Cloud Directory",status="Service is operating normally"} 4.0
| Label | Values | Description |
|---|---|---|
| continent | EU NA SA AP ME |
Continent in which service is operating |
| region | AWS reference | Region in which service is operating |
| service | AWS reference | AWS service name |
| status | Service is operating normally Informational message Service degradation Service disruption |
Status of AWS service |
Prometheus metric value for each AWS service can be between between 1 and 4. Metric values are described below:
| Value | Description |
|---|---|
| 4 | Service is operating normally |
| 3 | Informational message |
| 2 | Service degradation |
| 1 | Service disruption |
To configure this exporter on Prometheus server, add below job to
/etc/prometheus/prometheus.yml file:
scrape_configs:
- job_name: 'aws_service_health_exporter'
scrape_interval: 5s
static_configs:
- targets: ['localhost:8888']
You can then build and run this exporter as Docker image:
$ docker build -t my-python-app .
$ docker run -it --rm --name aws_service_health_exporter aws_service_health_exporter
You can configure this exporter to run as AWS Lambda function. To run
this module as Lambda, configure Handler as lambda_handler.lambda_handler
and map this Lambda Function to AWS Application Load Balancer. Then in
Prometheus configuration change target to AWS Application Load Balancer
DNS name.