[AWS] Boto3를 이용해 CloudWatch에서 메트릭 데이터 가져오기

Cloud/Amazon Cloud

[AWS] Boto3를 이용해 CloudWatch에서 메트릭 데이터 가져오기

__Evening 2023. 4. 13. 16:07

안녕하세요

이번 시간에는 Python에서 제공하는 라이브러리인 Boto3를 이용해 CloudWatch에서

메트릭 데이터를 가져오는 실습을 진행하겠습니다.

1. Boto3로 CloudWatch에서 메트릭 데이터 가져오기(+matplotlib를 이용한 시각화)

import boto3
import matplotlib.pyplot as plt
import datetime
import pytz

# AWS 계정의 액세스 키와 시크릿 키
ACCESS_KEY = 'your_access_key'
SECRET_KEY = 'your_secret_key'
REGION_NAME = 'your_region'

# CloudWatch 클라이언트 생성
session = boto3.Session(
    aws_access_key_id=ACCESS_KEY,
    aws_secret_access_key=SECRET_KEY,
    region_name=REGION_NAME
)

cloudwatch = session.client('cloudwatch')

# 한국 표준시 설정
KST = pytz.timezone('Asia/Seoul')

# 메트릭 데이터 조회
now = datetime.datetime.now(tz=pytz.utc).astimezone(KST)
utc_offset = datetime.timedelta(hours=9)
start_time = (now - datetime.timedelta(hours=1)).isoformat()
end_time = now.isoformat()
response = cloudwatch.get_metric_data(
    MetricDataQueries=[
        {
            'Id': 'm1',
            'MetricStat': {
                'Metric': {
                    'Namespace': 'AWS/EC2',
                    'MetricName': 'CPUUtilization',
                    'Dimensions': [
                        {
                            'Name': 'InstanceId',
                            'Value': instance_id
                        },
                    ]
                },
                'Period': 300,
                'Stat': 'Average',
                'Unit': 'Percent'
            },
            'ReturnData': True
        },
    ],
    StartTime=start_time,
    EndTime=end_time
)

print(response)

# 데이터 시각화
timestamps = response['MetricDataResults'][0]['Timestamps']
values = response['MetricDataResults'][0]['Values']

# 그래프 생성
timestamps_kst = [timestamp.astimezone(KST) for timestamp in timestamps]
plt.figure(figsize=(10, 5))
plt.plot(timestamps_kst, values)
plt.xlabel('Time')
plt.ylabel('CPU Utilization (%)')
plt.title('EC2 CPU Utilization')
plt.show()
plt.savefig('./graph/cpu_util.png')

다음 코드에서 Access Key, Secret Key, Region 값을 Session 값에 설정한 후 Cloudwacth client를 이용할 수 있는데

client를 이용하여 Cloudwatch 데이터를 get_metric_data 함수로 가져올 수 있습니다.

2. get_metric_data() 함수와 속성 값

get_metric_data()	AWS CloudWatch Metrics API를 사용하여 하나 이상의 메트릭 데이터 포인트 집합을 검색하는 함수
MetricDataQueries	CloudWatch 메트릭 데이터를 조회하기 위한 필수 매개변수
Id	이 요청을 식별하기 위한 문자열 ID
MetricStat	조회할 메트릭에 대한 정보를 담은 객체
Metric	조회할 메트릭에 대한 정보를 담은 객체
Namespace	조회할 메트릭의 네임스페이스
MetricName	조회할 메트릭의 이름
Dimensions	조회할 메트릭의 디멘젼 정보(옵션)
Period	메트릭 데이터의 간격을 초 단위로 지정
Stat	조회할 메트릭의 통계 종류를 지정(예: Sum, Average, Maximum, Minimum 등)
Unit	조회할 메트릭의 단위를 지정(옵션, 예: igabits/Second, Gigabits, Percent, Terabits, Bits, Kilobits, Megabytes/Second, Kilobytes, Megabits/Second, Terabytes, Bytes, Count, Gigabytes, Milliseconds, Count/Second, Gigabytes/Second, None, Terabytes/Second, Bytes/Second, Megabits, Kilobytes/Second, Megabytes, Microseconds, Kilobits/Second, Terabits/Second, Bits/Second, Seconds)
ReturnData	조회 결과를 반환할 지 여부를 지정
StartTime	메트릭 데이터를 가져올 시작 시간 지정
EndTime	메트릭 데이터를 가져올 끝 시간 지정

위에서 response 값을 출력해보면 다음과 같은 MetricDataResults를 확인할 수 있는데 여기서 중요한 것은 Values 값입니다. Values 값이 실제 지표의 상태를 단위로서 나타낸 값이기 때문에 저의 경우 [Unit: Percent]이기 때문에 0.2%, 0.33% 등의 값이 그래프에 표시됩니다.