Jenkins 모니터링 및 운영

시스템 상태 확인

Jenkins 관리 → 시스템 정보(System Information)

항목	확인 내용
시스템 속성	JVM 버전, OS, 메모리
환경 변수	서버 환경 변수
플러그인 목록	설치된 플러그인 버전

---

시스템 로그

Jenkins 관리 → 시스템 로그(System Log)

• All Jenkins Logs: 전체 로그
• 사용자 정의 로그 레코더 추가 가능 (특정 플러그인 디버깅)

# Docker 컨테이너 로그
docker logs -f jenkins

# 직접 설치 시
sudo journalctl -u jenkins -f
sudo tail -f /var/log/jenkins/jenkins.log

---

빌드 큐 관리

**빌드 큐(Build Queue)**가 쌓이면 에이전트 부족 또는 빌드 실패 신호입니다.

대기 중인 빌드 확인

대시보드 왼쪽 하단 **빌드 실행 상태(Build Executor Status)**에서 확인

빌드 강제 종료

빌드 페이지 → X 버튼 클릭 (Abort)

또는 REST API:

curl -X POST http://admin:TOKEN@jenkins/job/my-job/1/stop

---

디스크 정리

오래된 빌드 자동 삭제

각 Job 설정에서 오래된 빌드 버리기 활성화:

옵션	권장값
보관할 빌드 일수	30
보관할 최대 빌드 수	50

Workspace 정리

// 빌드 전 워크스페이스 초기화
stage('Clean') {
    steps {
        cleanWs()
    }
}

대용량 파일 확인

# Jenkins 홈 디스크 사용량 확인
du -sh /var/jenkins_home/jobs/*/builds | sort -rh | head -20

---

성능 튜닝

JVM 메모리 설정

# /etc/default/jenkins 또는 Docker 환경 변수
JAVA_OPTS="-Xmx4g -Xms2g -XX:+UseG1GC"

동시 빌드 수 조정

Jenkins 관리 → 시스템 설정 → Executors

• Master 노드의 Executor 수를 0으로 설정하고 에이전트에서만 빌드 실행 권장

플러그인 로딩 최적화

사용하지 않는 플러그인은 비활성화하여 시작 속도와 메모리 사용량을 개선합니다.

---

업그레이드 절차

1. 현재 상태 백업 (ThinBackup 또는 수동 백업)
2. LTS 릴리즈 노트 확인
3. 스테이징 환경에서 먼저 업그레이드 테스트
4. 프로덕션 업그레이드 진행

# Docker 환경 업그레이드
docker pull jenkins/jenkins:lts
docker stop jenkins
docker rm jenkins
docker run -d --name jenkins \
  -p 8080:8080 -p 50000:50000 \
  -v jenkins_home:/var/jenkins_home \
  jenkins/jenkins:lts