🚀 우분투 리소스 모니터링 에이전트 구축 가이드

본 가이드는 우분투 서버의 CPU, 메모리, 디스크 사용률을 실시간으로 측정하여 원격 MariaDB(qst-s.iptime.org)에 자동으로 업데이트하는 에이전트 설정 과정을 담고 있습니다.

1. 필수 라이브러리 설치

파이썬에서 리소스 측정 및 DB 연결을 위해 필요한 패키지를 시스템 전체 환경에 설치합니다.

# 패키지 목록 업데이트
sudo apt update

# 리소스 측정(psutil) 및 MariaDB 연결 라이브러리 설치
sudo apt install python3-psutil python3-mysql.connector -y

2. 모니터링 에이전트 코드 작성

/opt 경로에 실행 파일을 생성하고, 최적화된 디버깅 코드를 작성합니다.

파일 생성: sudo nano /opt/resource_agent.py
코드 내용: (아래 내용을 모두 복사해서 붙여넣으세요)

import time
import psutil
import mysql.connector
import sys
from datetime import datetime

# ==========================================
# [설정] MariaDB 접속 정보
# ==========================================
DB_CONFIG = {
    'host': 'qst-s.iptime.org',
    'port': 33063,
    'user': 'qsentech',
    'password': 'qsentech!1233',
    'database': 'paradise'
}

def get_connection():
    return mysql.connector.connect(**DB_CONFIG)

def main():
    print(f"[{datetime.now().strftime('%Y-%m-%d %H:%M:%S')}] 에이전트 작동 시작...")
    
    while True:
        conn = None
        try:
            # 1. 데이터 수집 (CPU는 1초간의 평균값 측정)
            cpu = psutil.cpu_percent(interval=1)
            mem = psutil.virtual_memory().percent
            disk = psutil.disk_usage('/').percent

            # 2. DB 연결 및 쿼리 실행
            conn = get_connection()
            cursor = conn.cursor()

            # idxNo 1: CPU, 2: MEMORY, 3: DISK 업데이트
            updates = [
                ("UPDATE tbl_resource_info SET resValue = %s WHERE idxNo = 1", (str(cpu),)),
                ("UPDATE tbl_resource_info SET resValue = %s WHERE idxNo = 2", (str(mem),)),
                ("UPDATE tbl_resource_info SET resValue = %s WHERE idxNo = 3", (str(disk),))
            ]

            total_affected = 0
            for sql, val in updates:
                cursor.execute(sql, val)
                total_affected += cursor.rowcount

            conn.commit()

            # 3. 로그 출력 (PYTHONUNBUFFERED 설정 시 실시간 확인 가능)
            print(f"[{datetime.now().strftime('%H:%M:%S')}] C:{cpu}% | M:{mem}% | D:{disk}% | Rows:{total_affected}")

        except Exception as e:
            print(f"Error: {e}", file=sys.stderr)
        
        finally:
            if conn and conn.is_connected():
                cursor.close()
                conn.close()

        # 4. 3초 간격 대기
        time.sleep(3)

if __name__ == "__main__":
    main()

3. 시스템 서비스(Systemd) 등록

서버가 재부팅되어도 에이전트가 자동으로 실행되도록 백그라운드 서비스로 등록합니다.

서비스 파일 생성: sudo nano /etc/systemd/system/resource-agent.service
내용 입력:

[Unit]
Description=Paradise Resource Monitoring Agent
After=network.target

[Service]
ExecStart=/usr/bin/python3 /opt/resource_agent.py
Restart=always
RestartSec=5
User=root
# 로그 실시간 확인을 위한 환경변수
Environment=PYTHONUNBUFFERED=1

[Install]
WantedBy=multi-user.target

4. 서비스 활성화 및 관리 명령어

설정을 변경할 때마다 아래 명령어들을 사용하여 적용합니다.

# 1. 시스템 설정 새로고침 (파일 수정 후 필수)
sudo systemctl daemon-reload

# 2. 에이전트 서비스 시작 및 자동실행 등록
sudo systemctl enable --now resource-agent

# 3. 서비스 상태 확인 (초록색 active 확인)
sudo systemctl status resource-agent

# 4. 실시간 로그 모니터링 (DB 업데이트 확인용)
sudo journalctl -u resource-agent -f

5. 최종 확인 방법

우분투 터미널: sudo journalctl -u resource-agent -f 실행 시 업데이트된 줄 수: 3이 뜨는지 확인합니다.