https://github.com/signiant/ecs_custom_metrics
https://github.com/signiant/ecs_custom_metrics
Last synced: about 1 year ago
JSON representation
- Host: GitHub
- URL: https://github.com/signiant/ecs_custom_metrics
- Owner: Signiant
- License: mit
- Created: 2017-01-30T19:24:54.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2018-05-24T15:11:35.000Z (almost 8 years ago)
- Last Synced: 2025-01-16T02:23:52.116Z (over 1 year ago)
- Language: Python
- Size: 16.6 KB
- Stars: 0
- Watchers: 5
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ecs-custom-metrics
Report Custom ECS Metrics to AWS CloudWatch. The idea is to run a container on an ECS instance in a cluster to report
the custom metrics for that cluster.
## Variables
- FREQUENCY - how often to report metrics (defaults to 300 seconds if not specified)
## Known Issues
Please note that FREQUENCY is a bit of a misnomer, it should probably be called DELAY or something similar. In fact what
happens is that the scripts are run, then the task sleeps for the duration of FREQUENCY. What that means is that if you
wanted to run the scripts every minute for instance (FREQUENCY=60), you may end up missing a run every once in a while,
depending on how long the script(s) take to run. The solution to this is to use a scheduler (coupled with threading) to
make sure the scripts start using the given FREQUENCY.
## Example Docker run
This example runs the metrics collection report scripts (report_task_count_metrics.py and report_scale_down_metric.py)
every 60 seconds. The scripts to run are passed in via the -c option. In this case, the two scripts are contained in
the docker image, but there is no reason why more scripts couldn't be mounted into the container and run as well (see
example 2).
Example 1:
>docker run -d \
> -e "FREQUENCY=60" \
> signiant/ecs_custom_metrics \
> -c "python /report_task_count_metrics.py" \
> -c "python /report_scale_down_metric.py --cpu 40 --mem 40 --min-cluster-size 1"
Example 2:
>docker run -d \
> -e "FREQUENCY=60" \
> -v /path/to/additional_script_to_run.sh:/another_report_script.sh \
> signiant/ecs_custom_metrics \
> -c "python /report_task_count_metrics.py" \
> -c "/bin/bash /another_report_script.sh"