https://github.com/nachomillangarcia/prometheus_aws_cost_exporter

Exporter for AWS Cost Explorer daily costs
https://github.com/nachomillangarcia/prometheus_aws_cost_exporter

Last synced: 3 months ago
JSON representation

Exporter for AWS Cost Explorer daily costs

• Host: GitHub
• URL: https://github.com/nachomillangarcia/prometheus_aws_cost_exporter
• Owner: nachomillangarcia
• Created: 2018-05-31T11:29:39.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2023-02-15T18:50:15.000Z (over 1 year ago)
• Last Synced: 2024-06-28T07:35:03.101Z (5 months ago)
• Language: Python
• Homepage:
• Size: 11.7 KB
• Stars: 59
• Watchers: 3
• Forks: 27
• Open Issues: 7
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Prometheus AWS Daily Cost Exporter

[![](https://dockerbuildbadges.quelltext.eu/status.svg?organization=nachomillangarcia&repository=prometheus_aws_cost_exporter)](https://hub.docker.com/r/nachomillangarcia/prometheus_aws_cost_exporter/builds/)

## Intro

Are you looking for some system that alerts when your today's spending on AWS exceeds some limit?  That's just what this exporter is made for.

CloudWatch doesn't allow you to track costs in the same day, just past days or monthly predictions.

The exporter is a Python server that connects to AWS Cost Explorer with a customizable period, and exposes last responses as Prometheus metrics.

## Configuration

Configuration is made through environment variables:

| Environment variable        | Description           | Default  |

| ------------- |:-------------:| -----:|

| QUERY_PERIOD      | Period to update metrics, querying AWS Cost Explorer API (0.01$ per request) | 1800 |

| METRIC_TODAY_DAILY_COSTS      | Enable aws_today_daily_costs metric      |   Not set |

| METRIC_YESTERDAY_DAILY_COSTS | Enable aws_yesterday_daily_costs metric      |   Not set |

| METRIC_TODAY_DAILY_USAGE | Enable aws_today_daily_usage metric      |   Not set |

| METRIC_TODAY_DAILY_USAGE_NORM | Enable aws_today_daily_usage_norm metric      |   Not set |

## Quickstart

### IAM permissions

```

{

    "Version": "2012-10-17",

    "Statement": [

        {

            "Sid": "VisualEditor0",

            "Effect": "Allow",

            "Action": "ce:*",

            "Resource": "*"

        }

    ]

}

```

### Docker

Run on localhost

```

docker run -e  METRIC_TODAY_DAILY_COSTS=yes -p 5000:5000 nachomillangarcia/prometheus_aws_cost_exporter:latest

```

Run on public machine

```

docker run -e  METRIC_TODAY_DAILY_COSTS=yes -p 5000:5000 nachomillangarcia/prometheus_aws_cost_exporter:latest --host 0.0.0.0

```

### Kubernetes

Use the provided Helm Chart in this repository to add this service to your Kubernetes cluster

```

cd helm

helm install -e METRIC_TODAY_DAILY_COSTS=yes --name prometheus-aws-cost-exporter --namespace kube-system .

```

To grant necessary AWS IAM permissions, I suggest to use [kube2iam](https://github.com/jtblin/kube2iam). Pod annotations are customizable for this chart, check the README.md in `helm` folder