[Swift] 통합 로그 시스템: Logger / OSLog

개요

개발을 진행하다 보면 디버깅을 위해 실제로 어떻게 동작하는지 로그를 확인할 필요가 있다.

대개 간단하게 print()를 사용하는데 print문을 통해 특정 메서드의 실행 여부, 실행 순서, 데이터 확인 등을 확인하기에는 충분하지만 치명적이게 아쉬운 점이 있다.

Xcode에서 앱을 실행하는 환경. Xcode 콘솔을 통해서만 확인이 가능하다는 점이다.

앱 개발을 하면서 개발 환경말고 QA환경, 또는 Release 환경 등 다양한 사람, 다양한 환경에서 사용하다가 발생하는 흔치 않은 이슈가 발생할 때가 있는데 이런 문제를 디버깅해야할 때에도 로그를 확인할 수 있었으면 좋겠다라는 생각이 들곤 한다.

이럴 때 유용한 것이 통합 로깅 시스템이다.

 

장점 (통합 로깅 시스템의 사용 이유)

통합 로깅 시스템에 대해서 톺아보기 위해서 퍼플렉시티에 물어보니 잘 정리해준 표를 그대로 인용 해보았다.

항목	Print문	Logger(통합 로깅 시스템)
목적	빠른 디버깅, 콘솔 출력 (개발자 임시 용도)	운영 환경에서 구조화된 로그, 모니터링, 분석
출력 장소	Xcode 콘솔 (디버깅 세션)	Xcode 콘솔, macOS Console 앱, 디바이스 로그 파일 등
로그 구조화	없음 (평문 메시지)	서브시스템, 카테고리, 로그 레벨 등 구조화
로그 레벨	없음 (모든 로그가 동일하게 출력)	Default, Info, Debug, Error, Fault 등 다중 레벨 지원
프라이버시	모든 정보가 노출됨	사생활 정보 자동 마스킹 가능 (privacy 옵션)
성능	빠르나, 빈번한 호출 시 성능 저하	메시지 병합, lazy interpolation 등으로 높은 성능
검색/필터링	기본 제공 안 됨	Console 앱, log 명령어 등에서 강력한 필터링 가능
운영 환경	디버깅 환경에서만 주로 사용	개발·운영 환경 모두에서 사용, 장애 분석에 유리
커스터 마이즈	거의 불가	로거별 커스터마이즈, 확장 가능
데이터 유실	메모리 부족 등에서 유실될 수 있음	디스크/메모리 이중 저장으로 데이터 유실 최소화
공식 권장	간단한 디버깅용	모든 Apple 플랫폼에서 공식적으로 권장

• 로그 구조화
  • App 구분 / App 내 카테고리(ex: User Event/DataBase 등) 구분 / 로그 레벨 (ex: Debug, Error 등) 구분
• 프라이버시
  • 로그 추출이 가능한 만큼 빌드 타임에 정의한 정적 로그 말고도 데이터를 출력해야하는 데에 있어서(String Interpolation) 공개 여부를 선택 가능

이처럼 정말 다양한 기능들을 제공하여 이를 잘 활용하면 강력한 디버깅 도구가 되어준다.

 

Log를 운영하기 위한 Log 개체 생성하기

• Swift
  • Logger 구조체(struct)를 생성하고 해당 구조체의 메서드를 활용해서 로그 메세지를 생성하는 방식
• Objective-C
  • OSLog 객체(class)를 생성하고 logging 함수에 해당 객체를 넘기는 방식

디버깅에 필요한 정보들을 수집하기 위해 로그를 남기다 보면 정말 많은 로그가 남게 되는데 내가 보고 싶은 로그만 집중해서 볼 수 있게 앱과 관련된 값을 사용하여 로그 개체를 생성할 때 두개의 문자열을 모두 지정한다. 일종의 태그 역할를 달아주는 것.

• SubSystem
  • 앱 또는 앱내의 넓은 기능 영역을 구분(정의)하는 문자열
  • ex) 앱에서 추가 프로세스가 생성되는 경우, 각 프로세스 별 다른 문자열로 구분
  • reverse-DNS notation을 사용하자 → ex) com.example.myapp
• Category
  • ex) UI, Data, Network등을 구분
  • Convention 상관없이 원하는 문자열로 설정
  • 주어진 SubSystem 내부에 특정 컴포넌트나 모듈을 구분(정의)하는 문자열

 

로그 수준 정하기

로그 수준은 로그의 심각도와 중요도를 정의하기 위해 쓰는 것. 로그를 기록할 때마다 로그 수준 값을 지정. 해당 로그 수준에 따라 시스템이 로그를 처리하는 방식이 결정.

메모리 저장 → 로그 수준이 높은 메시지의 경우 Disk에 기록

아래 표는 심각도가 오름차순(낮음→높음)으로 나열

Log level	Disk 저장	참고
Debug	NO	코드 디버깅에만 필요한 자세한 정보 캡처
Info	로그 도구로 수집한 경우에만	문제 해결에 참고하면 좋은 정보 수집용
Notice (Default)	YES (단, 최대 저장한도까지 가능)	문제 해결에 필수적인 정보를 수집. 예를 들어 실패로 이어질 수 있는 정보
Error	YES (단, 최대 저장한도까지 가능)	코드 실행중 발생한 오류를 캡쳐하는 용도.
Fault	YES (단, 최대 저장한도까지 가능)	코드의 오류 및 버그에 대한 정보를 캡쳐

 

 

Log 파일 추출

sudo log collect --device-name 'apple의 iPhone'  --start '2025-08-27 12:00:00' --output extractLog.logarchive

iOS APP을 기준으로 로그를 추출하고자 하는 디바이스와 Mac에 연결한 뒤, Mac에서 터미널을 열어 위와 같은 log collect를 수행하면 Disk에 저장된 log를 추출할 수 있다.

 

---

References

Explore logging in Swift - WWDC20 - 비디오 - Apple Developer

Logging | Apple Developer Documentation