[Spring] Log, ELK

로그(Log)

• 시스템이나 애플리케이션에서 발생한 이벤트, 동작, 상태 등을 기록한 정보
• 주로 디버깅, 모니터링, 문제 해결, 성능 분석 등을 목적으로 사용됩니다.

로그의 주요 목적

1. 디버깅: 시스템에서 발생한 문제를 추적하고, 코드의 흐름을 파악하기 위해 사용.
2. 모니터링: 시스템이나 애플리케이션의 상태와 성능을 실시간으로 관찰.
3. 에러 추적: 발생한 오류를 기록하고, 문제의 원인을 찾아 수정.
4. 성능 분석: 시스템 성능을 분석하여 최적화 및 개선할 수 있는 부분을 찾아냄.

 

로그 레벨의 주요 종류

1. TRACE
   • 설명: 가장 낮은 수준의 로그 레벨입니다. 매우 세밀한 정보를 기록합니다. 주로 코드 실행의 세부 사항, 변수 값, 메서드 호출 등의 정보를 포함합니다.
   • 용도: 디버깅할 때 코드 흐름을 추적하기 위해 사용됩니다.
   • 예시: 메서드가 호출될 때마다 변수 값을 출력하는 로그.
2. DEBUG
   • 설명: 개발 중에 주로 사용되는 로그 레벨로, 프로그램의 흐름을 추적하고, 변수나 상태 정보 등을 기록합니다. TRACE보다 약간 더 높은 수준입니다.
   • 용도: 문제를 디버깅하거나 시스템이 어떻게 동작하는지 확인할 때 사용됩니다.
   • 예시: 데이터베이스 쿼리 실행 전후, HTTP 요청/응답의 내용, 중요한 변수 값 등을 기록하는 로그.
3. INFO
   • 설명: 애플리케이션의 정상적인 동작을 나타내는 중요한 정보들을 기록합니다. 프로그램의 주요 상태 변경이나 중요한 이벤트가 발생할 때 사용됩니다.
   • 용도: 시스템의 중요한 흐름이나 상태를 모니터링할 때 사용됩니다. 예를 들어, 서버가 정상적으로 시작되었거나, 사용자 요청을 성공적으로 처리한 경우 기록합니다.
   • 예시: "서버가 성공적으로 시작되었습니다.", "사용자가 로그인했습니다." 등의 로그.
4. WARN
   • 설명: 경고 레벨로, 문제가 발생할 수 있는 상황이나 예기치 않은 동작을 기록합니다. 시스템은 여전히 정상적으로 동작할 수 있지만, 잠재적인 문제가 있을 수 있음을 나타냅니다.
   • 용도: 시스템 성능이나 안정성에 문제가 있을 수 있는 상황을 모니터링할 때 사용됩니다.
   • 예시: 디스크 공간이 부족할 때, 외부 API 호출이 지연될 때 등의 경고.
5. ERROR
   • 설명: 심각한 문제나 예외가 발생했을 때 기록되는 로그입니다. 프로그램이 정상적으로 동작하지 않거나, 예기치 않은 오류가 발생했을 때 사용됩니다.
   • 용도: 시스템의 중요한 기능이 실패했을 때 문제를 추적하고 해결하기 위해 사용됩니다.
   • 예시: 데이터베이스 연결 실패, 파일 읽기 오류, 네트워크 연결 실패 등의 로그.
6. FATAL (또는 SEVERE)
   • 설명: 가장 높은 수준의 로그 레벨로, 시스템이나 애플리케이션이 실행을 지속할 수 없는 심각한 오류를 나타냅니다. 이 오류가 발생하면 시스템은 대부분 즉시 중단되어야 합니다.
   • 용도: 프로그램이나 시스템이 치명적인 오류로 인해 더 이상 정상적으로 동작할 수 없을 때 기록됩니다.
   • 예시: JVM 예외로 인한 애플리케이션 크래시, 시스템 종료 등의 상황.

 

---

로그 살펴보기

 

 

• PID: 자바 스프링부트 애플리케이션의 프로세스 아이디입니다. 만약 여러 애플리케이션의 로그가 하나의 파일에 함께 수집된다면, 프로세스 아이디를 통해 각 애플리케이션의 로그를 구분할 수 있습니다.
• 스레드 이름: 로그를 기록한 스레드의 이름입니다. "NIO"로 시작하는 스레드는 비동기적으로 로그가 기록될 때 생성되며, 여러 개의 "NIO" 스레드가 함께 로그를 기록할 수 있습니다.
• 패키지 + 클래스: 로그가 어떤 패키지와 클래스에서 발생했는지를 나타냅니다.

 

---

로그 레벨의 사용 순서

• 로그 레벨은 우선순위가 있으며, 우선순위가 낮을수록 더 세부적인 로그를 기록합니다.
• 따라서 로그 레벨의 순서는 TRACE < DEBUG < INFO < WARN < ERROR < FATAL입니다. 이 순서대로 기록되는 로그가 필터링됩니다. 예를 들어, 로그 레벨을 INFO로 설정하면 INFO, WARN, ERROR, FATAL 레벨의 로그만 기록되고, DEBUG나 TRACE 레벨의 로그는 기록되지 않습니다.

 

---

 

Logback은 자바에서 널리 사용되는 로깅 프레임워크로, SLF4J와 함께 사용됩니다. @Slf4j 애너테이션을 활용하면 코드에서 손쉽게 로깅 기능을 구현할 수 있어 효율적인 로그 관리와 디버깅을 지원합니다.

Logback(로그백)

• 가장 많이 사용되고 있는 로깅 프레임워
• 로그를 남길수 있게 만들어주는 도구

 

@Slf4j

• SLF4J는 로깅 프레임워크에 의존하지 않고 로깅 인터페이스를 제공하므로, 실제 로깅 프레임워크(Logback, Log4j, java.util.logging 등)는 SLF4J의 구현체를 사용하여 로깅을 처리합니다.
• 따라서 Logback에서 Log4j 또는 다른 프레임워크로 바꾸더라도, @Slf4j 어노테이션을 그대로 사용할 수 있습니다.

 

 

---

로그 수집이 필요한 이유

서비스에서 발생한 로그는 Logback에 의해 관리되고, 설정된 출력 대로 콘솔이나 파일 등에 기록됩니다. 예를 들어, 서버에서 애플리케이션을 실행하면 로그 메시지는 설정에 따라 콘솔에 출력되거나, 로그 파일로 저장됩니다.

 

로그를 확인해야 하는 상황이 생기면, 개인 PC에서 SSH로 서버에 접속하여 로그 파일을 검색해야 합니다. 하지만 서버가 여러 대일 경우, 각각의 서버에 접속해 로그를 확인하는 방식은 점점 비효율적이고 번거로워집니다.

 

 

 

각각의 서버에서 발생한 로그를 중앙화된 저장소에 모아 관리하기 위해, Elasticsearch를 활용한 로그 수집 시스템을 구축합니다. 이를 위해 Logstash를 사용하여 로그를 Elasticsearch에 저장하고, Kibana를 통해 저장된 로그를 쉽게 검색하고 시각화할 수 있습니다.

정리하자면, 로그는 애플리케이션 실행 후 문제 해결을 위해 파일 형태로 저장되며, Logback을 사용하여 로그를 파일에 기록하고, Logstash를 통해 Elasticsearch로 전송합니다. 이처럼 ELK 스택(Elasticsearch, Logstash, Kibana)을 활용하면 효율적인 로그 관리와 분석이 가능합니다.

 

 

 

[참고]

https://inf.run/qfoUB

개발자에게 필요한 로그 관리 강의 | 이준형(Foo) - 인프런

 

https://devlog-wjdrbs96.tistory.com/351

[Java] Checked Exception vs Unchecked Exception 정리