コンテンツにスキップ

クイックスタート

本記事では、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. デバッグログを有効にし、アプリケーションを実行して、ページを 1 回開くかネットワークリクエストを 1 回発生させます
  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. ページを開くか、ネットワークリクエストを 1 回発行します
  3. hilog で [FT-SDK] を検索し、SDK の初期化とデータ送信の流れが正常であることを確認します
  4. Guance コンソールに戻り、対応する RUM データが表示されることを確認します

ネットワークリクエストを検証する場合、Resource 自動追跡に従って、対応する RCP、Axios または NetworkKit インターセプターを組み込む必要があります。setEnableTraceUserResource(true) を有効にするだけでは、すべての業務リクエストは追跡されません。

次のステップ

フィードバック

このページは役に立ちましたか?