콘텐츠로 이동

macOS 애플리케이션 연동


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

읽기 경로

사전 요구 사항

주의

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

로컬 환경에 배포하는 경우 다음 데이터 수신 측 구성을 완료해야 합니다. 퍼블릭 DataWay를 사용하는 경우에는 DataKit을 직접 배포할 필요가 없습니다.

애플리케이션 연동

  1. RUM > 새 애플리케이션 > macOS로 이동합니다.
  2. 애플리케이션 이름을 입력합니다.
  3. 애플리케이션 ID를 입력합니다.
  4. 「연동 방식 선택」에서 Agent 자동 연동 또는 수동 연동을 선택한 후 「연동 설정」을 완료합니다.

연동 방식 선택

애플리케이션 설정 페이지에서 「Agent 자동 연동」 또는 「수동 연동」을 선택한 후 「연동 설정」을 완료합니다. 기존 애플리케이션은 설정 페이지로 바로 이동하여 연동을 계속할 수 있습니다.

연동 방식 사용 사례 작업 진입점
Agent 자동 연동 코딩 어시스턴트가 프로젝트를 분석하고 SDK 연동을 완료하도록 하려는 경우 콘솔에서 생성된 프롬프트를 복사하여 애플리케이션 코드 저장소에서 코딩 어시스턴트에게 전달하여 실행
수동 연동 SDK를 직접 설치하고 파라미터를 구성하려는 경우 데이터 보고 방식을 확인한 후 이 문서와 빠른 시작에 따라 설정 완료

Agent 자동 연동

  1. 현재 애플리케이션의 설정 페이지에서 「Agent 자동 연동」을 선택합니다.
  2. 「연동 설정」의 전체 프롬프트를 복사하고, 현재 애플리케이션의 연동 정보가 사용되는지 확인합니다.
  3. 애플리케이션 코드 저장소에서 코딩 어시스턴트를 열고 프롬프트를 붙여넣으면 Agent가 연동 안내에 따라 프로젝트를 분석하고 SDK 설정을 완료합니다.
  4. 애플리케이션을 빌드하고 실행하여 페이지 방문 등의 작업을 트리거한 후, 현재 애플리케이션의 탐색기에서 데이터 수신을 확인합니다.

페이지에 개인 API Key 또는 임시 인증 코드가 준비되지 않았다는 메시지가 표시되면 안내에 따라 보완한 후 프롬프트를 다시 복사하세요.

수동 연동

애플리케이션 설정 페이지에서 「수동 연동」을 선택하고 데이터 보고 방식을 확인합니다.

  • 퍼블릭 DataWay: RUM 데이터를 직접 수신하며 DataKit 수집기를 설치할 필요가 없습니다.
  • 로컬 환경 배포: 사전 요구 사항을 충족한 후 RUM 데이터를 수신합니다.

아래 설치 및 빠른 시작에 따라 SDK 설치, 초기화 및 검증을 완료하세요. 기존 SDK 설정이 있는 경우 먼저 확인하고 재사용하여 중복 초기화를 방지해야 합니다.

설치

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

Demo: 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를 추가할 Target을 선택하고 Add Package 버튼을 클릭하면 SDK가 성공적으로 추가됩니다.

프로젝트가 SPM으로 관리되는 경우 FTMacOSSDK를 종속성으로 추가하고 Package.swift에 dependencies를 추가합니다.

```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로 설정합니다.

문서 평가

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