EBS CloudWatch Metrics MCP

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

기능

• IOPS 계산: 읽기/쓰기 IOPS 평균, 최대, 최소 값 계산
• 처리량 계산: 읽기/쓰기 처리량 (MB/s) 계산
• 스냅샷 조회: 스냅샷 크기 및 목록 조회
• CloudWatch 지표 조회: 모든 EBS CloudWatch 지표 직접 조회
• 고급 지표 계산: I/O 사용률, 지연 시간, 버스팅 IOPS/처리량 등

설치

uvx 사용 (권장)

uvx ebs-cloudwatch-metrics-mcp

pip 사용

pip install ebs-cloudwatch-metrics-mcp

소스에서 설치

git clone https://github.com/your-repo/ebs-cloudwatch-metrics-mcp.git
cd ebs-cloudwatch-metrics-mcp
pip install -e .

Kiro MCP 설정

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

{
  "mcpServers": {
    "ebs-cloudwatch-metrics": {
      "command": "uvx",
      "args": ["ebs-cloudwatch-metrics-mcp"],
      "env": {
        "AWS_PROFILE": "default",
        "AWS_REGION": "ap-northeast-2"
      }
    }
  }
}

환경 변수

사용 가능한 도구

1. calculate_iops

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

파라미터:

• volume_id (필수): EBS 볼륨 ID
• start_time (필수): 조회 시작 시간 (ISO 8601)
• end_time (필수): 조회 종료 시간 (ISO 8601)
• period: 지표 수집 간격 (초, 기본값: 300)
• region: AWS 리전

예시:

calculate_iops(
  volume_id="vol-1234567890abcdef0",
  start_time="2024-01-01T00:00:00Z",
  end_time="2024-01-02T00:00:00Z"
)

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 권한이 필요합니다:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "cloudwatch:GetMetricStatistics",
        "cloudwatch:ListMetrics"
      ],
      "Resource": "*"
    },
    {
      "Effect": "Allow",
      "Action": [
        "ec2:DescribeSnapshots",
        "ec2:DescribeVolumes"
      ],
      "Resource": "*"
    }
  ]
}

최소 권한 정책

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

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "cloudwatch:GetMetricStatistics"
      ],
      "Resource": "*",
      "Condition": {
        "StringEquals": {
          "cloudwatch:namespace": "AWS/EBS"
        }
      }
    },
    {
      "Effect": "Allow",
      "Action": [
        "ec2:DescribeSnapshots"
      ],
      "Resource": "*",
      "Condition": {
        "StringEquals": {
          "ec2:VolumeId": "vol-1234567890abcdef0"
        }
      }
    }
  ]
}

라이선스

MIT License