macOS 애플리케이션 연동¶
Guance 애플리케이션 모니터링은 각 macOS 애플리케이션의 메트릭 데이터를 수집하여 각 macOS 애플리케이션의 성능을 시각적으로 분석할 수 있습니다.
읽기 경로¶
- 최초 연동: 먼저 연동 방식 선택을 참고하세요. 수동 연동은 빠른 시작을 참고할 수 있습니다.
- 전체 연동: 이 문서를 계속 읽어 보세요.
- 초기화 파라미터: SDK 초기화, RUM 설정, Log 설정, Trace 설정을 확인하세요.
- 사용자 정의 기능: 사용자 정의 태그 사용, 데이터 수집 사용자 정의 규칙을 확인하세요.
- 데이터 모델: 애플리케이션 데이터 수집을 확인하세요.
- 문제 해결: 문제 해결을 확인하세요.
사전 요구 사항¶
주의
RUM Headless 서비스를 이미 활성화한 경우 사전 요구 사항이 자동으로 구성되므로 애플리케이션을 바로 연동할 수 있습니다.
로컬 환경에 배포하는 경우 다음 데이터 수신 측 구성을 완료해야 합니다. 퍼블릭 DataWay를 사용하는 경우에는 DataKit을 직접 배포할 필요가 없습니다.
애플리케이션 연동¶
- RUM > 새 애플리케이션 > macOS로 이동합니다.
- 애플리케이션 이름을 입력합니다.
- 애플리케이션 ID를 입력합니다.
- 「연동 방식 선택」에서 Agent 자동 연동 또는 수동 연동을 선택한 후 「연동 설정」을 완료합니다.
연동 방식 선택¶
애플리케이션 설정 페이지에서 「Agent 자동 연동」 또는 「수동 연동」을 선택한 후 「연동 설정」을 완료합니다. 기존 애플리케이션은 설정 페이지로 바로 이동하여 연동을 계속할 수 있습니다.
| 연동 방식 | 사용 사례 | 작업 진입점 |
|---|---|---|
| Agent 자동 연동 | 코딩 어시스턴트가 프로젝트를 분석하고 SDK 연동을 완료하도록 하려는 경우 | 콘솔에서 생성된 프롬프트를 복사하여 애플리케이션 코드 저장소에서 코딩 어시스턴트에게 전달하여 실행 |
| 수동 연동 | SDK를 직접 설치하고 파라미터를 구성하려는 경우 | 데이터 보고 방식을 확인한 후 이 문서와 빠른 시작에 따라 설정 완료 |
Agent 자동 연동¶
- 현재 애플리케이션의 설정 페이지에서 「Agent 자동 연동」을 선택합니다.
- 「연동 설정」의 전체 프롬프트를 복사하고, 현재 애플리케이션의 연동 정보가 사용되는지 확인합니다.
- 애플리케이션 코드 저장소에서 코딩 어시스턴트를 열고 프롬프트를 붙여넣으면 Agent가 연동 안내에 따라 프로젝트를 분석하고 SDK 설정을 완료합니다.
- 애플리케이션을 빌드하고 실행하여 페이지 방문 등의 작업을 트리거한 후, 현재 애플리케이션의 탐색기에서 데이터 수신을 확인합니다.
페이지에 개인 API Key 또는 임시 인증 코드가 준비되지 않았다는 메시지가 표시되면 안내에 따라 보완한 후 프롬프트를 다시 복사하세요.
수동 연동¶
애플리케이션 설정 페이지에서 「수동 연동」을 선택하고 데이터 보고 방식을 확인합니다.
- 퍼블릭 DataWay: RUM 데이터를 직접 수신하며 DataKit 수집기를 설치할 필요가 없습니다.
- 로컬 환경 배포: 사전 요구 사항을 충족한 후 RUM 데이터를 수신합니다.
아래 설치 및 빠른 시작에 따라 SDK 설치, 초기화 및 검증을 완료하세요. 기존 SDK 설정이 있는 경우 먼저 확인하고 재사용하여 중복 초기화를 방지해야 합니다.
설치¶
소스 코드: https://github.com/GuanceCloud/datakit-macos
Demo: 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를 추가할 Target을 선택하고Add Package버튼을 클릭하면 SDK가 성공적으로 추가됩니다.
프로젝트가 SPM으로 관리되는 경우 FTMacOSSDK를 종속성으로 추가하고 Package.swift에 dependencies를 추가합니다.
```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로 설정합니다.