로깅 개요
AIBudsLogSDK는 AIBuds SDK 모듈과 앱에서 공통으로 사용하는 프로세스 전역 로깅 진입점을 제공합니다. 현재 활성화된 LogService는 메시지를 기록하고, 보관된 로그를 내보내며, 만료된 항목을 정리합니다.
기능 개요
로그 출력 방식
AIBuds 로그 레벨 및 출력 대상 설정
로그 내보내기
저장된 AIBuds 로그를 단일 파일 또는 크기가 제한된 여러 파일로 내보내기
만료된 로그 삭제
최대 보관 기간 또는 기준 날짜에 따라 저장된 로그 정리
AI를 활용해 구현
AI로 구현
AI로 이 워크플로 구현
공식 “AIBuds 로그 관리” 스킬을 사용해 앱에 맞게 구현하세요.
https://docs-aibuds.github.io/ko/skills/manage-aibuds-logs을 읽고 지침을 따르세요. 이 스킬로 “AIBuds 로그 관리”을 이 iOS 프로젝트에 구현하고 검증하세요.로깅 구조
LogConfiguration에서는 다음 항목을 설정합니다.
| 설정 | 기본값 | 용도 |
|---|---|---|
level | .info | 기본 로거가 기록할 최소 로그 레벨입니다. |
destination | .xlfacility | 현재 사용할 출력 대상입니다. |
logsDirectory | .aibuds/logs | Documents 디렉터리를 기준으로 한 로그 파일 저장 경로입니다. |
maxFileSize | 10,000,000 bytes | 개별 로그 파일의 최대 크기입니다. |
logFileMaxAge | 3 days | 로그 정리에 적용할 보관 기간입니다. |
LogDestination은 .console, .oslogger, .file, .xlfacility을 지원합니다. 한 번에 하나의 출력 대상만 활성화됩니다.
통합 흐름
- 앱 실행 초기에 로그 레벨, 출력 대상, 저장 경로 및 보관 기간을 설정합니다.
.xlfacility을 사용하는 경우 로그를 기록하기 전에AIBudsXLFacility플러그인을 설치합니다.AIBudsLogSDK.logService를 통해 메시지를 기록하거나, AIBuds 모듈이 동일한 서비스를 사용하도록 합니다.- 현재 활성화된
LogService를 통해 로그를 내보내거나 정리합니다.
주요 동작
- Console 및 OS Logger 출력 대상은 로그 내보내기를 지원하지 않습니다.
- File 및 XLFacility 출력 대상은 로그 내보내기와 보관 기간에 따른 정리를 지원합니다.
- 별도의 서비스를 설치하지 않으면
AIBudsLogSDK.logService는 기본 제공DefaultLogger를 반환합니다. - 플러그인을 설정하지 않은 상태에서
.xlfacility을 선택하면 Console에 오류가 출력되며, XLFacility를 통한 저장 또는 내보내기를 사용할 수 없습니다.