EBS CloudWatch Metrics MCP

AWS EBS CloudWatch 지표 계산 MCP 서버입니다. Kiro에서 EBS 볼륨의 성능 지표를 조회하고 분석할 수 있습니다.

기능

• IOPS 계산: 읽기/쓰기 IOPS 평균, 최대, 최소 값 계산

• 처리량 계산: 읽기/쓰기 처리량 (MB/s) 계산

• 스냅샷 조회: 스냅샷 크기 및 목록 조회

• CloudWatch 지표 조회: 모든 EBS CloudWatch 지표 직접 조회

• 고급 지표 계산: I/O 사용률, 지연 시간, 버스팅 IOPS/처리량 등

설치

uvx 사용 (권장)

pip 사용

소스에서 설치

Kiro MCP 설정

.kiro/settings/mcp.json 파일에 다음 설정을 추가하세요:

환경 변수

사용 가능한 도구

1. calculate_iops

EBS 볼륨의 IOPS를 계산합니다.

파라미터:

• volume_id (필수): EBS 볼륨 ID

• start_time (필수): 조회 시작 시간 (ISO 8601)

• end_time (필수): 조회 종료 시간 (ISO 8601)

• period: 지표 수집 간격 (초, 기본값: 300)

• region: AWS 리전

예시:

2. calculate_throughput

EBS 볼륨의 처리량을 계산합니다.

파라미터:

• volume_id (필수): EBS 볼륨 ID

• start_time (필수): 조회 시작 시간 (ISO 8601)

• end_time (필수): 조회 종료 시간 (ISO 8601)

• period: 지표 수집 간격 (초, 기본값: 300)

• region: AWS 리전

3. get_snapshot_size

EBS 스냅샷의 크기를 조회합니다.

파라미터:

• snapshot_id (필수): EBS 스냅샷 ID

• region: AWS 리전

4. list_volume_snapshots

EBS 볼륨의 모든 스냅샷 목록을 조회합니다.

파라미터:

• volume_id (필수): EBS 볼륨 ID

• max_results: 최대 결과 수 (기본값: 100)

• region: AWS 리전

5. get_ebs_metric

특정 EBS CloudWatch 지표를 조회합니다.

파라미터:

• volume_id (필수): EBS 볼륨 ID

• metric_name (필수): CloudWatch 지표 이름

• start_time (필수): 조회 시작 시간 (ISO 8601)

• end_time (필수): 조회 종료 시간 (ISO 8601)

• period: 지표 수집 간격 (초, 기본값: 300)

• statistics: 통계 유형 배열 (기본값: ["Average"])

• region: AWS 리전

지원되는 지표:

• VolumeReadOps - 읽기 작업 수

• VolumeWriteOps - 쓰기 작업 수

• VolumeReadBytes - 읽기 바이트 수

• VolumeWriteBytes - 쓰기 바이트 수

• VolumeTotalReadTime - 총 읽기 시간

• VolumeTotalWriteTime - 총 쓰기 시간

• VolumeIdleTime - 유휴 시간

• VolumeQueueLength - 큐 길이

• VolumeThroughputPercentage - 처리량 백분율

• VolumeConsumedReadWriteOps - 소비된 읽기/쓰기 작업

• BurstBalance - 버스트 잔액 (gp2)

6. list_ebs_metrics

사용 가능한 EBS CloudWatch 지표 목록을 반환합니다.

파라미터: 없음

7. get_advanced_metrics

EBS 볼륨의 고급 성능 지표를 계산합니다.

파라미터:

• volume_id (필수): EBS 볼륨 ID

• start_time (필수): 조회 시작 시간 (ISO 8601)

• end_time (필수): 조회 종료 시간 (ISO 8601)

• period: 지표 수집 간격 (초, 기본값: 300)

• region: AWS 리전

반환되는 고급 지표:

• io_use_percent - I/O 사용률 (%)

• avg_read_latency_ms - 평균 읽기 지연 시간 (ms)

• avg_write_latency_ms - 평균 쓰기 지연 시간 (ms)

• read_io_size_kib - 읽기 I/O 크기 (KiB)

• write_io_size_kib - 쓰기 I/O 크기 (KiB)

• avg_read_iops - 평균 읽기 IOPS

• avg_write_iops - 평균 쓰기 IOPS

• avg_total_iops - 평균 총 IOPS

• avg_read_throughput_mib_s - 평균 읽기 처리량 (MiB/s)

• avg_write_throughput_mib_s - 평균 쓰기 처리량 (MiB/s)

• avg_total_throughput_mib_s - 평균 총 처리량 (MiB/s)

• bursting_read_iops - 버스팅 읽기 IOPS

• bursting_write_iops - 버스팅 쓰기 IOPS

• bursting_total_iops - 버스팅 총 IOPS

• bursting_read_throughput_mib_s - 버스팅 읽기 처리량 (MiB/s)

• bursting_write_throughput_mib_s - 버스팅 쓰기 처리량 (MiB/s)

• bursting_total_throughput_mib_s - 버스팅 총 처리량 (MiB/s)

• burst_balance - BurstBalance (gp2 볼륨만)

필요한 IAM 권한

MCP 서버를 사용하려면 다음 IAM 권한이 필요합니다:

최소 권한 정책

특정 볼륨만 조회하려면 리소스를 제한할 수 있습니다:

라이선스

MIT License