콘텐츠로 이동

macOS 애플리케이션 통합


Guance 애플리케이션 모니터링은 macOS 애플리케이션의 메트릭 데이터를 수집하여 각 macOS 애플리케이션의 성능을 시각적으로 분석할 수 있도록 합니다.

학습 경로

전제 조건

참고

RUM Headless 서비스를 이미 활성화한 경우 전제 조건이 자동으로 구성되므로 바로 애플리케이션을 통합할 수 있습니다.

애플리케이션 통합

  1. 실제 사용자 모니터링(RUM) > 애플리케이션 생성 > macOS로 이동합니다.
  2. 애플리케이션 이름을 입력합니다.
  3. 애플리케이션 ID를 입력합니다.
  4. 애플리케이션 통합 방식을 선택합니다.

    • 공용 네트워크 DataWay: DataKit 수집기 설치 없이 RUM 데이터를 직접 수신합니다.
    • 로컬 환경 배포: 전제 조건을 충족한 후 RUM 데이터를 수신합니다.

설치

소스 코드 주소: https://github.com/GuanceCloud/datakit-macos

데모: https://github.com/GuanceCloud/datakit-macos/Example

  1. Podfile 파일을 구성합니다.
   target 'yourProjectName' do

   # Pods for your project
   pod 'FTMacOSSDK', '~>[latest_version]'

   end
  1. Podfile 디렉터리에서 pod install을 실행하여 SDK를 설치합니다.
  1. PROJECT -> Package Dependency를 선택하고 Packages 섹션에서 +를 클릭합니다.

  2. 팝업 페이지 검색창에 https://github.com/GuanceCloud/datakit-macos를 입력합니다. 이는 코드 저장소 주소입니다.

  3. Xcode가 패키지를 성공적으로 가져오면 SDK 구성 페이지가 표시됩니다.

Dependency Rule: Up to Next Major Version을 선택하는 것을 권장합니다.

Add To Project: 지원하는 프로젝트를 선택합니다.

구성을 완료한 후 Add Package 버튼을 클릭하고 로딩이 완료될 때까지 기다립니다.

  1. 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]")) ] ```

헤더 파일 추가

#import "FTMacOSSDK.h"
import FTMacOSSDK

상세 구성 진입점

고급 시나리오

자주 묻는 질문

충돌 로그 분석

충돌 로그 분석 및 dSYM에 대한 자세한 내용은 장애 진단을 참조하세요.

Include of non-modular header inside framework module 오류 발생

SDK의 .h 파일에서 종속 라이브러리의 .h 파일을 참조하므로 다음 설정이 필요합니다.

Target -> Build Settings -> CLANG_ALLOW_NON_MODULAR_INCLUDES_IN_FRAMEWORK_MODULES를 YES로 설정합니다.

문서 평가

이 페이지가 도움이 되었나요?