greymd / cw-fs-url

cw-fs-url

Generate a CloudWatch Metrics URL for EBS/EFS IOPS, Throughput, and Latency calculations using metric math.

Usage

$ python3 cw-fs-url.py --help
usage: cw-fs-url.py [-h] --from START_TIME --to END_TIME --ids RESOURCE_IDS --service {ebs,efs}
                    --metric {mibs,iops,latency} --region REGION [--period PERIOD]

Generate a CloudWatch Metrics URL for EBS/EFS IOPS and Throughput calculation.

options:
  -h, --help            show this help message and exit
  --from START_TIME     Start time in ISO8601 format.
  --to END_TIME         End time in ISO8601 format.
  --ids RESOURCE_IDS    Comma-separated list of EBS volume IDs or EFS filesystem IDs.
  --service {ebs,efs}   Set service type
  --metric {mibs,iops,latency}
                        Set metric type. mibs denotes Throughput in MiB/s; latency denotes ms/op
  --region REGION       AWS region.
  --period PERIOD       Set 60, 300, 3600 or any multiple of 60 [default: 300]

Supported Metric Patterns

• EBS Throughput in MiB/s
• EBS IOPS (Input/Output Operations Per Second)
• EBS Latency
• EFS Throughput in MiB/s
• EFS IOPS

---

• EBS metrics are calculated in alignment with Amazon CloudWatch metrics for Amazon EBS - Amazon Elastic Compute Cloud.
• EFS metrics are calculated in alignment with Using metric math with Amazon EFS - Amazon Elastic File System.

Usage Examples

EBS Throughput

$ python3 cw-fs-url.py \
--service ebs \
--metric mibs \
--region eu-west-1 \
--from 2023-01-01T00:00:00.000Z \
--to 2023-01-01T23:00:00.000Z \
--ids vol-aaa,vol-bbb,vol-ccc

EFS Throughput

$ python3 cw-fs-url.py \
--service efs \
--metric mibs \
--region eu-west-1 \
--from 2023-01-01T00:00:00.000Z \
--to 2023-01-01T23:00:00.000Z \
--ids fs-aaa,fs-bbb,fs-ccc