[서버 기초] 서버 로그란? 에러 추적부터 실전 로그 분석까지!

---

💡 “에러가 났다… 그런데 어디서?”

웹사이트가 갑자기 멈췄어요.
사용자들은 "왜 안 돼요?"라며 불만 폭주! 😱

그럴 땐 개발자는 가장 먼저 로그(log)를 확인합니다.

서버가 남긴 기록 속에 문제의 원인이 숨어 있으니까요!

이번 편에서는 서버 로그란 무엇인지, 어떻게 확인하고 활용하는지 쉽게 알려드릴게요!

---

📄 서버 로그란?

서버 로그(Log)는

서버에서 일어난 일들을 시간 순으로 기록한 텍스트 파일입니다.

📦 예를 들어:

• 누가 언제 어떤 요청을 보냈는지
• 에러가 언제 어디서 발생했는지
• 서버가 어떤 응답을 했는지

이런 정보들이 모두 기록돼 있어요.

---

🔍 왜 로그가 중요할까?

✅ 에러 발생 원인을 찾기 위해
✅ 성능 저하나 공격 흔적 파악
✅ 사용자 요청 이력 확인
✅ 시스템 동작 상태 모니터링

즉, 로그는 서버의 블랙박스입니다! 🧠

---

🧾 서버 로그의 종류

로그 종류설명

로그 종류	설명
Access Log	누가 언제 어떤 요청을 했는지 기록 (예: GET /home)
Error Log	에러 발생 정보 기록 (예: DB 연결 실패)
Application Log	앱 내부 로직 처리 기록 (예: 로그인 성공 여부, DB 쿼리 수행 등)
System Log	서버 자체의 시스템 로그 (예: CPU, 메모리, 디스크 상태 등)

---

📦 예시 로그 살펴보기

✅ Access Log (nginx 기준)

127.0.0.1 - - [30/Mar/2025:10:15:42 +0900] "GET /home HTTP/1.1" 200 532

• IP: 127.0.0.1
• 요청 시간: 3월 30일 10시 15분
• 요청 경로: /home
• 응답 코드: 200 (성공)

---

❌ Error Log (Node.js 예시)

[ERROR] [2025-03-30T10:18:02Z] DB connection failed: timeout

• 시간: 2025년 3월 30일 10:18
• 문제: DB 연결 실패
• 원인: 타임아웃 발생

---

🛠️ 로그를 보는 방법은?

1. 로컬 서버
   • 터미널에 console.log()나 logger.error() 등 출력 확인
   • 로그 파일 경로: /logs/app.log, error.log 등
2. 운영 서버 (리눅스 기준)
   • tail -f /var/log/nginx/error.log
   • journalctl -u node-app.service
3. 로그 관리 도구 사용
   • PM2: Node.js 로그 실시간 확인
   • Logstash + Kibana(ELK): 시각화 및 분석
   • Sentry, Datadog, New Relic: 모니터링 툴

---

🔧 실전 팁! 로그 분석 체크리스트

✅ 에러가 발생한 시간
✅ 어떤 요청(URL)이 문제였는지
✅ 어떤 에러 코드/메시지가 나왔는지
✅ 동시 접속 수나 응답 시간이 평소보다 높았는지
✅ 최근 변경된 코드나 배포 내역이 있는지

---

📌 로그 잘 쓰는 습관이 중요해요!

• console.log()만 쓰지 말고,
• 로그 수준(level)을 나누자!

레벨	의미
info	일반적인 정보 로그
warn	주의가 필요한 상황
error	실제 에러 발생 시 기록
debug	상세한 디버깅 정보 (개발 중에만 사용)

---

🧠 정리 한마디!

• 서버 로그는 개발자의 눈이에요
• Access / Error / Application 로그를 통해
  시스템 상태와 에러 원인을 파악할 수 있어요
• 잘 정리된 로그는 실무의 ‘반 이상’입니다!

---

📌 다음 예고: “서버와 데이터베이스는 어떻게 연결될까?”

• DB 연결이란 실제로 무슨 일이 일어나는 걸까?
• 백엔드에서 DB를 다루는 기본 개념
• 연결 문자열, 쿼리 처리, ORM까지 차근차근!

 

[서버 기초] 서버와 데이터베이스는 어떻게 연결될까?