macOS 애플리케이션 통합¶
Guance 애플리케이션 모니터링은 macOS 애플리케이션의 메트릭 데이터를 수집하여 각 macOS 애플리케이션의 성능을 시각적으로 분석할 수 있도록 합니다.
학습 경로¶
- 최초 통합: 빠른 시작을 먼저 확인하세요.
- 전체 통합: 이 문서를 계속 읽어보세요.
- 초기화 매개변수: SDK 초기화, RUM 구성, 로그 구성, 트레이스 구성을 확인하세요.
- 사용자 정의 기능: 사용자 정의 태그 사용, 데이터 수집 사용자 정의 규칙을 확인하세요.
- 데이터 모델: 애플리케이션 데이터 수집을 확인하세요.
- 문제 해결: 장애 진단을 확인하세요.
전제 조건¶
참고
RUM Headless 서비스를 이미 활성화한 경우 전제 조건이 자동으로 구성되므로 바로 애플리케이션을 통합할 수 있습니다.
애플리케이션 통합¶
- 실제 사용자 모니터링(RUM) > 애플리케이션 생성 > macOS로 이동합니다.
- 애플리케이션 이름을 입력합니다.
- 애플리케이션 ID를 입력합니다.
-
애플리케이션 통합 방식을 선택합니다.
- 공용 네트워크 DataWay: DataKit 수집기 설치 없이 RUM 데이터를 직접 수신합니다.
- 로컬 환경 배포: 전제 조건을 충족한 후 RUM 데이터를 수신합니다.
설치¶
소스 코드 주소: https://github.com/GuanceCloud/datakit-macos
데모: https://github.com/GuanceCloud/datakit-macos/Example
Podfile파일을 구성합니다.
Podfile디렉터리에서pod install을 실행하여 SDK를 설치합니다.
-
PROJECT->Package Dependency를 선택하고Packages섹션에서 +를 클릭합니다. -
팝업 페이지 검색창에
https://github.com/GuanceCloud/datakit-macos를 입력합니다. 이는 코드 저장소 주소입니다. -
Xcode가 패키지를 성공적으로 가져오면 SDK 구성 페이지가 표시됩니다.
Dependency Rule: Up to Next Major Version을 선택하는 것을 권장합니다.
Add To Project: 지원하는 프로젝트를 선택합니다.
구성을 완료한 후 Add Package 버튼을 클릭하고 로딩이 완료될 때까지 기다립니다.
Choose Package Products for datakit-macos팝업에서 SDK를 추가할 타겟을 선택하고Add Package버튼을 클릭하면 SDK가 성공적으로 추가됩니다.
프로젝트가 SPM으로 관리되는 경우 Package.swift에 dependencies를 추가하여 FTMacOSSDK를 종속성으로 추가합니다.
```swift dependencies: [
.package(url: "https://github.com/GuanceCloud/datakit-macos.git", .upToNextMajor(from: "[latest_version]")) ] ```
헤더 파일 추가¶
상세 구성 진입점¶
고급 시나리오¶
자주 묻는 질문¶
충돌 로그 분석¶
충돌 로그 분석 및 dSYM에 대한 자세한 내용은 장애 진단을 참조하세요.
Include of non-modular header inside framework module 오류 발생¶
SDK의 .h 파일에서 종속 라이브러리의 .h 파일을 참조하므로 다음 설정이 필요합니다.
Target -> Build Settings -> CLANG_ALLOW_NON_MODULAR_INCLUDES_IN_FRAMEWORK_MODULES를 YES로 설정합니다.