Overview#

This project demonstrates basic cloud infrastructure monitoring using the AWS SDK for Python (boto3). The tool queries EC2 instances and reports information such as instance IDs, current status, and launch time.

The goal of the project is to explore how infrastructure engineers and developers interact with cloud APIs to inspect and monitor computing resources.

Features#

• Retrieve EC2 instance metadata
• Display instance IDs and instance state
• Show instance launch time
• Generate simple usage reports
• Command-line interface for quick infrastructure inspection

Technologies Used#

• Python
• AWS EC2
• boto3 (AWS SDK for Python)
• AWS CLI
• Git

Project Structure#

1
cloud-ec2-monitor/
2
│
3
├── monitor.py
4
├── usage_report.txt
5
├── requirements.txt
6
├── README.md
7
└── .gitignore

Setup#

1
git clone https://github.com/BerkGozek/cloud-monitor.git
2
cd cloud-monitor

1
python3 -m venv .venv
2
source .venv/bin/activate

1
pip install -r requirements.txt

1
aws configure

1
AWS Access Key ID
2
AWS Secret Access Key
3
Default region name (example: us-east-1)
4
Default output format (json recommended)

Running the Tool#

Run the monitoring script:

1
python monitor.py

To generate a usage report file:

1
python monitor.py > usage_report.txt

Example Output#

1
Instance ID: i-0123456789abcdef0
2
Status: running
3
Launch Time: 2026-03-10T14:22:31Z

Use Case#

This tool simulates a lightweight infrastructure monitoring workflow used by cloud engineers and DevOps teams to inspect compute resources in a cloud environment.

It demonstrates how developers can use Python to interact with cloud APIs and retrieve operational data from infrastructure services.

Future Improvements#

Potential improvements for this project include:

• Support for additional AWS services (S3, Lambda, RDS)
• Automatic report generation and logging
• Monitoring alerts for instance state changes
• Command-line arguments for filtering or selecting regions
• Integration with monitoring dashboards