도커(Docker)는 가상화 기술을 통해 애플리케이션을 컨테이너화하고 실행하는 데 많이 사용됩니다. 컨테이너 내에서 발생하는 로그를 호스트 환경으로 전달하여 중앙에서 로그를 수집하고 분석하는 작업은 매우 중요합니다. 이번 포스트에서는 Python을 사용하여 도커 컨테이너와 호스트 간 로깅을 설정하는 방법에 대해 알아보겠습니다.

단계 1: Logging 라이브러리 설치

먼저, 호스트와 컨테이너에서 로그를 캡처하기 위해 Python logging 라이브러리를 설치해야 합니다. 아래 명령을 사용하여 설치할 수 있습니다.

pip install logging

단계 2: 로깅 설정 파일 생성

로깅 설정 파일은 logging.conf와 같은 이름으로 생성할 수 있으며, 다음과 같은 내용을 포함해야 합니다.

[loggers]
keys=root

[handlers]
keys=consoleHandler

[formatters]
keys=plainFormatter

[logger_root]
level=DEBUG
handlers=consoleHandler

[handler_consoleHandler]
class=StreamHandler
level=DEBUG
formatter=plainFormatter
args=(sys.stdout,)

[formatter_plainFormatter]
format=%(asctime)s - %(name)s - %(levelname)s - %(message)s

위 설정 파일은 간단한 형식의 로그를 출력하는 예시입니다. 필요에 따라 설정을 변경할 수 있습니다.

단계 3: 로깅 구성 파일 읽기

이제 Python 코드 내에서 로깅 구성 파일(logging.conf)을 읽고 구성할 수 있습니다. 다음 코드 블록은 logging 모듈을 사용하여 로깅을 구성하는 방법을 보여줍니다.

import logging
import logging.config

logging.config.fileConfig('logging.conf')
logger = logging.getLogger(__name__)

# 예시 로그 출력
logger.debug('디버그 메시지')
logger.info('정보 메시지')
logger.warning('경고 메시지')
logger.error('에러 메시지')
logger.critical('심각한 에러 메시지')

위 코드를 실행하면, 설정 파일에 지정된 로그 수준에 맞게 로그가 출력됩니다.

단계 4: 도커 컨테이너 실행 시 로깅 설정

마지막으로, 도커 컨테이너를 실행하는 명령어에 로깅 설정을 추가해야 합니다. 아래 명령어를 사용하여 로깅 설정 파일을 마운트하고 컨테이너 내부에서 참조할 수 있도록 설정할 수 있습니다.

docker run -v /path/to/logging.conf:/app/logging.conf myapp

위 명령어에서 /path/to/logging.conf 부분은 호스트에서 로깅 설정 파일의 경로로 변경해야 합니다. 이렇게 하면 컨테이너 내부의 /app/logging.conf 경로에 호스트의 설정 파일이 마운트되어 사용됩니다.

도커 컨테이너 내에서 Python 애플리케이션이 실행되는 동안 로그가 출력되며, 호스트에서 설정한 로깅 수준에 따라 로그를 확인할 수 있게 됩니다.

결론

이 포스트에서는 Python을 사용하여 도커 컨테이너와 호스트 간 로깅 설정을 구성하는 방법에 대해 알아보았습니다. 로깅은 애플리케이션의 동작 및 문제 해결에 매우 중요한 역할을 합니다. 로그를 중앙 집중화하여 관리하면 애플리케이션 모니터링과 디버깅이 훨씬 용이해질 수 있습니다.