4.9.5. 예외 처리 및 오류 로깅 시스템 구축

자동매매 시스템은 24시간 운영됩니다. 예상치 못한 오류가 발생할 수 있습니다. 네트워크 문제, API 응답 오류, 데이터 손실 등이 있습니다. 이러한 오류를 효과적으로 처리해야 합니다. 오류 발생 시 시스템 중단을 최소화해야 합니다. 오류 원인을 신속하게 파악해야 합니다. 이를 위해 예외 처리 및 오류 로깅 시스템이 필수적입니다.

예외 처리는 프로그램 실행 중 발생하는 예외 상황에 대처하는 기술입니다. 오류 발생 시 프로그램이 강제 종료되는 것을 방지합니다. 오류 메시지를 출력하거나, 오류를 복구하는 코드를 실행합니다. 로깅 시스템은 프로그램의 실행 과정을 기록하는 시스템입니다. 오류, 경고, 정보 메시지 등을 파일이나 데이터베이스에 저장합니다. 로그 분석을 통해 시스템 문제를 진단하고 개선할 수 있습니다.

잘 설계된 예외 처리 및 로깅 시스템은 시스템 안정성을 크게 향상시킵니다. 개발 및 유지보수 효율성을 높입니다. 자동매매 시스템의 신뢰도를 높이는 데 기여합니다. 이 섹션에서는 파이썬을 이용하여 예외 처리 및 로깅 시스템을 구축하는 방법을 설명합니다.

단계 1: 기본 예외 처리 구현

파이썬의 try-except 구문을 사용하여 예외를 처리합니다. try 블록에는 예외가 발생할 가능성이 있는 코드를 작성합니다. except 블록에는 예외 발생 시 실행할 코드를 작성합니다.

try:
    # 예외가 발생할 가능성이 있는 코드
    result = 10 / 0  # 0으로 나누는 오류 발생
except ZeroDivisionError as e:
    # ZeroDivisionError 예외 처리
    print(f"오류 발생: {e}")
    result = 0  # 오류 발생 시 기본값 설정

print(f"결과: {result}")

위 코드는 0으로 나누는 오류를 발생시킵니다. ZeroDivisionError 예외가 발생하면 except 블록이 실행됩니다. 오류 메시지를 출력하고, result 변수에 0을 할당합니다.

단계 2: 다양한 예외 유형 처리

여러 종류의 예외를 처리할 수 있습니다. 각 예외 유형에 따라 다른 처리 방식을 적용할 수 있습니다.

try:
    # 예외가 발생할 가능성이 있는 코드
    data = int(input("숫자를 입력하세요: "))
    result = 10 / data
except ZeroDivisionError as e:
    print(f"0으로 나눌 수 없습니다: {e}")
    result = 0
except ValueError as e:
    print(f"잘못된 입력입니다: {e}")
    result = None
except Exception as e:
    # 그 외 모든 예외 처리
    print(f"알 수 없는 오류 발생: {e}")
    result = None

print(f"결과: {result}")

위 코드는 사용자로부터 숫자를 입력받습니다. ValueError (잘못된 입력), ZeroDivisionError (0으로 나눔), Exception (그 외 모든 예외)을 처리합니다.

단계 3: 로깅 모듈 설정

파이썬의 logging 모듈을 사용하여 로그를 기록합니다. 로그 레벨, 로그 포맷, 로그 파일 등을 설정할 수 있습니다.

import logging

# 로깅 설정
logging.basicConfig(
    filename='autotrade.log',  # 로그 파일 이름
    level=logging.INFO,         # 로그 레벨 (DEBUG, INFO, WARNING, ERROR, CRITICAL)
    format='%(asctime)s - %(levelname)s - %(message)s'  # 로그 포맷
)

# 로그 메시지 기록
logging.debug("디버그 메시지")
logging.info("정보 메시지")
logging.warning("경고 메시지")
logging.error("오류 메시지")
logging.critical("심각한 오류 메시지")

위 코드는 autotrade.log 파일에 로그를 기록합니다. 로그 레벨은 INFO로 설정되어 있습니다. DEBUG 레벨의 로그는 기록되지 않습니다.

단계 4: 예외 처리와 로깅 통합

예외 발생 시 오류 메시지를 로그에 기록합니다. 오류 발생 시간, 오류 유형, 오류 내용 등을 기록합니다.

import logging

# 로깅 설정 (이전 단계와 동일)
logging.basicConfig(
    filename='autotrade.log',
    level=logging.INFO,
    format='%(asctime)s - %(levelname)s - %(message)s'
)

try:
    # 예외가 발생할 가능성이 있는 코드
    data = int(input("숫자를 입력하세요: "))
    result = 10 / data
except ZeroDivisionError as e:
    logging.error(f"0으로 나누는 오류 발생: {e}")
    result = 0
except ValueError as e:
    logging.error(f"잘못된 입력 오류 발생: {e}")
    result = None
except Exception as e:
    logging.exception("알 수 없는 오류 발생") # 스택 트레이스 기록
    result = None

print(f"결과: {result}")

위 코드는 예외 발생 시 logging.error() 또는 logging.exception()을 사용하여 로그를 기록합니다. logging.exception()은 스택 트레이스를 함께 기록합니다. 오류 발생 원인을 분석하는 데 유용합니다.

단계 5: 사용자 정의 예외 정의

자동매매 시스템에 특화된 예외를 정의할 수 있습니다. 예를 들어, API 요청 제한 초과, 잔고 부족 등의 예외를 정의할 수 있습니다.

class APILimitExceededError(Exception):
    """API 요청 제한 초과 예외"""
    pass

class InsufficientBalanceError(Exception):
    """잔고 부족 예외"""
    pass

try:
    # API 요청
    # ...
    if api_request_count > API_REQUEST_LIMIT:
        raise APILimitExceededError("API 요청 제한 초과")

    # 주문 실행
    # ...
    if balance < order_amount:
        raise InsufficientBalanceError("잔고 부족")

except APILimitExceededError as e:
    logging.warning(f"API 요청 제한 초과: {e}")
except InsufficientBalanceError as e:
    logging.error(f"잔고 부족: {e}")
except Exception as e:
    logging.exception("알 수 없는 오류 발생")

위 코드는 APILimitExceededError와 InsufficientBalanceError 예외를 정의합니다. API 요청 제한 초과 또는 잔고 부족 시 해당 예외를 발생시킵니다.

단계 6: 로그 파일 관리

로그 파일이 너무 커지지 않도록 관리해야 합니다. 로그 파일 로테이션을 설정하여 오래된 로그 파일을 자동으로 삭제하거나 압축합니다.

import logging
import logging.handlers

# 로깅 설정
log_filename = 'autotrade.log'
log_level = logging.INFO
log_format = '%(asctime)s - %(levelname)s - %(message)s'

# 로깅 핸들러 설정 (RotatingFileHandler)
log_handler = logging.handlers.RotatingFileHandler(
    filename=log_filename,
    maxBytes=1024 * 1024,  # 1MB
    backupCount=5         # 최대 5개 파일까지 백업
)
log_handler.setFormatter(logging.Formatter(log_format))

# 로거 생성 및 핸들러 추가
logger = logging.getLogger()
logger.setLevel(log_level)
logger.addHandler(log_handler)

# 로그 메시지 기록
logger.info("자동매매 시스템 시작")

위 코드는 RotatingFileHandler를 사용하여 로그 파일 로테이션을 설정합니다. 로그 파일 크기가 1MB를 초과하면 새로운 로그 파일을 생성합니다. 최대 5개 파일까지 백업합니다.

요약

이 섹션에서는 자동매매 시스템의 안정성을 높이기 위한 예외 처리 및 오류 로깅 시스템 구축 방법을 설명했습니다. try-except 구문을 사용하여 예외를 처리하고, logging 모듈을 사용하여 로그를 기록합니다. 사용자 정의 예외를 정의하고, 로그 파일 로테이션을 설정합니다. 이러한 기술을 통해 시스템 오류를 효과적으로 관리하고, 오류 발생 시 신속하게 대처할 수 있습니다.