콘텐츠로 이동

빠른 시작

이 문서는 HarmonyOS RUM SDK의 최단 연동 경로를 제공하여, 검증 가능한 데이터 보고를 빠르게 완료할 수 있도록 합니다.

앱은 Agent 자동 연동 및 수동 연동을 지원합니다. 다음 단계에서는 수동 연동의 최소 구성을 설명합니다.

사전 준비

  1. 실제 사용자 모니터링(RUM)에서 HarmonyOS 앱을 생성하고 RUM App ID를 가져옵니다.
  2. 보고 방식을 확인합니다:
    • 로컬 환경 배포: datakitUrl을 준비합니다
    • 공용 네트워크 DataWay: datawayUrl 및 clientToken을 준비합니다
  3. 설치 방식을 선택합니다:
    • 타사 저장소가 구성된 경우: ohpm을 통해 @guancecloud/ft_sdk를 직접 설치합니다
    • 로컬 HAR 사용: ft_sdk.har를 다운로드하고 oh-package.json5에서 @guancecloud/ft_sdk를 의존성 이름으로 사용합니다
  4. @kit.NetworkKit 기반 HTTP 인터셉터 체인 기능을 사용하려면 @guancecloud/ft_sdk_ext를 추가로 설치하거나 ft_sdk_ext.har를 다운로드합니다. 이 기능은 HarmonyOS API 22 이상이 필요합니다.
  5. Native Crash를 수집하려면 @guancecloud/ft_native를 추가로 설치하거나 ft_native.har를 다운로드합니다.
  6. 바이트코드 HAR을 사용하는 경우 프로젝트는 HarmonyOS API 12 이상을 사용해야 하며, 루트 디렉터리의 build-profile.json5에서 useNormalizedOHMUrl을 활성화해야 합니다. 전체 구성 및 난독화 설명은 바이트코드 HAR 빌드 구성을 참조하십시오.

연동 단계

  1. 타사 저장소를 사용하는 경우 ohpm install @guancecloud/ft_sdk를 실행합니다.
  2. 로컬 HAR을 사용하는 경우 HAR 파일을 프로젝트의 libs 디렉터리에 배치하고 oh-package.json5에서 scoped 의존성을 선언합니다. ft_sdk_ext.har도 함께 사용하는 경우 프로젝트 루트 디렉터리의 oh-package.json5에서 overrides를 통해 @guancecloud/ft_sdk를 로컬 HAR로 재정의한 후 ohpm install을 실행해야 합니다.
  3. 앱 시작 시 FTSDKConfig를 초기화합니다.
  4. FTRUMConfig를 초기화하고 View, Action, Resource, ANR 및 Crash 수집을 활성화합니다.
  5. 디버그 로그를 활성화하고 앱을 실행한 후 페이지 열기 또는 네트워크 요청을 한 번 트리거합니다.
  6. 콘솔로 돌아가 RUM 데이터가 성공적으로 보고되었는지 확인합니다.

최소 의존성 방식

  • ohpm을 통해 핵심 SDK를 설치합니다:
ohpm install @guancecloud/ft_sdk
  • 로컬 HAR을 사용하는 경우 oh-package.json5에 최소 의존성을 추가합니다:
{
  "dependencies": {
    "@guancecloud/ft_sdk": "file:../libs/ft_sdk.har"
  }
}

최소 의존성으로 먼저 연동하여 기본 데이터 보고가 정상 동작하는 것을 확인한 후, 필요에 따라 확장 패키지를 추가하는 것을 권장합니다.

최소 초기화 예시

import { AbilityConstant, UIAbility, Want } from '@kit.AbilityKit';

import { FTSDK, FTSDKConfig, FTRUMConfig, EnvType, SDKLogLevel } from '@guancecloud/ft_sdk/Index';


export default class EntryAbility extends UIAbility {
  onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
    // 로컬 환경 배포 시 FTSDKConfig.builder(datakitUrl)로 변경할 수 있습니다
    const sdkConfig = FTSDKConfig.builder(datawayUrl, clientToken)
      .setDebug(true)
      .setSdkLogLevel(SDKLogLevel.D)
      .setServiceName('Your-App-Name')
      .setEnv(EnvType.PROD);

    FTSDK.install(sdkConfig, this.context);

    const rumConfig = new FTRUMConfig()
      .setRumAppId('your-app-id')
      .setSessionSamplingRate(100)
      .setEnableTraceUserAction(true)
      .setEnableTraceUserView(true)
      .setEnableTraceUserResource(true)
      .setEnableTrackAppANR(true)
      .setEnableTrackAppCrash(true);

    FTSDK.installRUMConfig(rumConfig);
  }
}

연동 성공 여부 확인

  1. setDebug(true)를 활성화한 상태로 유지합니다.
  2. 페이지를 열거나 네트워크 요청을 한 번 발생시킵니다.
  3. hilog에서 [FT-SDK]를 검색하여 SDK 초기화 및 데이터 보고 흐름이 정상인지 확인합니다.
  4. Guance 콘솔로 돌아가 해당 RUM 데이터가 나타나는지 확인합니다.

네트워크 요청을 검증할 때는 Resource 자동 추적에 따라 해당 RCP, Axios 또는 NetworkKit 인터셉터를 마운트해야 합니다. setEnableTraceUserResource(true)만 활성화해서는 모든 비즈니스 요청을 추적할 수 없습니다.

다음 단계

문서 평가

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