RUM 設定¶

import {
  DetectFrequency,
  DeviceMetricsMonitorType,
  ErrorMonitorType,
  FTSDK,
  FTRUMConfig
} from '@guancecloud/ft_sdk/Index';

const rumConfig = new FTRUMConfig()
  .setRumAppId('your-app-id')
  .setSamplingRate(1.0)
  .setSessionErrorSampleRate(1.0)
  .setEnableTraceUserAction(true)
  .setEnableTraceUserView(true)
  .setEnableTraceUserResource(true)
  .setEnableTrackAppUIBlock(true)
  .setEnableTrackAppANR(true)
  .setEnableTrackAppCrash(true)
  .setEnableTraceWebView(true)
  .setDeviceMetricsMonitorType(DeviceMetricsMonitorType.ALL, DetectFrequency.DEFAULT)
  .setExtraMonitorTypeWithError(ErrorMonitorType.ALL)
  .addGlobalContext('rum_channel', new String('official'));

FTSDK.installRUMConfig(rumConfig);

/**
 * View のライフサイクルを開始します。
 *
 * @param viewName View 名。
 * @param property オプションの拡張属性。
 */
startView(viewName: string, property?: Record<string, object>): Promise<void>

/**
 * 現在の View のライフサイクルを終了します。
 *
 * @param property オプションの拡張属性。
 */
stopView(property?: Record<string, object>): Promise<void>

/**
 * 現在の View の読み込み時間を更新します。
 *
 * @param loadTime 読み込み時間。単位はナノ秒です。
 */
updateLoadTime(loadTime: number): void

import { FTRUMGlobalManager } from '@guancecloud/ft_sdk/Index';

@Entry
@Component
struct ProductPage {
  async aboutToAppear() {
    // ケース 1:
    await FTRUMGlobalManager.getInstance().startView('ProductPage');

    // ケース 2: 拡張属性を指定する場合
    const viewProperty: Record<string, object> = { page_category: new String('product'), page_id: new String('12345') };
    await FTRUMGlobalManager.getInstance().startView('ProductPage', viewProperty);

  }

  async aboutToDisappear() {
    // ケース 1:
    await FTRUMGlobalManager.getInstance().stopView();

    // ケース 2:
    const stopViewProperty: Record<string, object> = { view_duration: new Number(1000) };
    await FTRUMGlobalManager.getInstance().stopView(stopViewProperty);
  }

  build() {
    Column() {
      Text('Product Page');
    }
  }
}

/**
 * 完了済みの Action を追加します。このデータは Error、Resource、LongTask には関連付けられません。
 *
 * @param actionName Action 名。
 * @param actionType Action タイプ。例: `click`。
 * @param durationOrProperty オプション。number を渡すと継続時間（ナノ秒）を表し、Record を渡すと拡張属性を表します。
 * @param property オプション。3 番目の引数が継続時間の場合のみ拡張属性を渡します。
 */
addAction(
  actionName: string,
  actionType: string,
  durationOrProperty?: number | Record<string, object>,
  property?: Record<string, object>
): void

/**
 * Action を開始します。SDK が終了タイミングを管理し、前後で発生した Resource、LongTask、Error データを関連付けます。
 *
 * @param actionName Action 名。
 * @param actionType Action タイプ。例: `click`。
 * @param property オプションの拡張属性。
 */
startAction(
  actionName: string,
  actionType: string,
  property?: Record<string, object>
): void

import { FTRUMGlobalManager } from '@guancecloud/ft_sdk/Index';

// ケース 1:
FTRUMGlobalManager.getInstance().addAction('buy_button_click', 'click');

// ケース 2: 拡張属性を指定する場合
const actionProperty: Record<string, object> = {
  product_id: new String('product_id'),
  product_name: new String('product_name')
};
FTRUMGlobalManager.getInstance().addAction('buy_button_click', 'click', actionProperty);

// ケース 1:
FTRUMGlobalManager.getInstance().startAction('buy_button_click', 'click');

// ケース 2: 拡張属性を指定する場合
const startActionProperty: Record<string, object> = {
  product_id: new String('product_id'),
  product_name: new String('product_name')
};
FTRUMGlobalManager.getInstance().startAction('buy_button_click', 'click', startActionProperty);

/**
 * Error を報告します。
 *
 * @param log エラーログまたはスタック情報。
 * @param message メッセージ。
 * @param errorType エラータイプ。`ErrorType` 列挙型または文字列を渡せます。
 * @param state エラー発生時のアプリの実行状態。
 * @param property オプションの拡張属性。
 */
addError(
  log: string,
  message: string,
  errorType: string | ErrorType,
  state: AppState,
  property?: Record<string, object> | null
): void

/**
 * 発生時刻を指定して Error を報告します。
 *
 * @param log エラーログまたはスタック情報。
 * @param message メッセージ。
 * @param dateline エラー発生時刻。単位はナノ秒です。
 * @param errorType エラータイプ。`ErrorType` 列挙型または文字列を渡せます。
 * @param state エラー発生時のアプリの実行状態。
 * @param property オプションの拡張属性。
 */
addError(
  log: string,
  message: string,
  dateline: number,
  errorType: string | ErrorType,
  state: AppState,
  property?: Record<string, object> | null
): void

import { FTRUMGlobalManager, ErrorType, AppState } from '@guancecloud/ft_sdk/Index';
import { systemDateTime } from '@kit.BasicServicesKit';

// ケース 1:
FTRUMGlobalManager.getInstance().addError('error log', 'error message', ErrorType.CUSTOM, AppState.RUN);

// ケース 2: 遅延報告の場合は、エラーが実際に発生した時刻（単位: ナノ秒）を渡します。
const errorTimeNs = systemDateTime.getTime(true);
FTRUMGlobalManager.getInstance().addError('error log', 'error message', errorTimeNs, ErrorType.CUSTOM, AppState.RUN);

// ケース 3: 拡張属性を指定する場合。
const errorProperty: Record<string, object> = {
  module: new String('checkout'),
  action: new String('submit_order')
};
FTRUMGlobalManager.getInstance().addError('error log', 'error message', ErrorType.CUSTOM, AppState.RUN, errorProperty);

/**
 * LongTask を報告します。
 *
 * @param log ブロッキング発生時のログまたはスタック情報。
 * @param duration ブロッキングの継続時間。単位はナノ秒です。
 * @param property オプションの拡張属性。
 */
addLongTask(log: string, duration: number, property?: Record<string, string | number | boolean>): void

import { FTRUMGlobalManager } from '@guancecloud/ft_sdk/Index';

const durationMs = 350;
const durationNs = durationMs * 1000000;
const stack = new Error('checkout render long task').stack ?? 'Stack trace not available';

// ケース 1:
FTRUMGlobalManager.getInstance().addLongTask(stack, durationNs);

// ケース 2: 拡張属性を指定する場合。
const longTaskProperty: Record<string, string | number | boolean> = {
  module: 'checkout',
  operation: 'render_order_list',
  threshold_ms: 200
};
FTRUMGlobalManager.getInstance().addLongTask(stack, durationNs, longTaskProperty);

/**
 * Resource のライフサイクルを開始します。
 *
 * @param resourceId リソースの一意の識別子。`stopResource`、`addResource` と同じ値を使用する必要があります。
 * @param property オプションの拡張属性。
 */
startResource(resourceId: string, property?: Record<string, object>): void

/**
 * Resource のライフサイクルを終了します。
 *
 * @param resourceId リソースの一意の識別子。`startResource` と同じ値を使用する必要があります。
 * @param property オプションの拡張属性。
 */
stopResource(resourceId: string, property?: Record<string, object>): void

/**
 * Resource のリクエスト、レスポンス、ネットワークパフォーマンスデータを補足します。
 *
 * @param resourceId リソースの一意の識別子。`startResource`、`stopResource` と同じ値を使用する必要があります。
 * @param resourceParams リソースの詳細。URL、リクエスト方式、レスポンスステータス、レスポンス長、拡張属性など。
 * @param netStatusBean ネットワークパフォーマンスデータ。DNS、TCP、TTFB、レスポンス所要時間など。
 */
addResource(resourceId: string, resourceParams: ResourceParams, netStatusBean: NetStatusBean): void

import {
  FTRUMGlobalManager,
  ResourceParams,
  NetStatusBean
} from '@guancecloud/ft_sdk/Index';

const resourceId = 'https://api.example.com/data';

// ケース 1:
// リクエスト開始
FTRUMGlobalManager.getInstance().startResource(resourceId);

// リクエスト終了後に、リクエスト、レスポンス、ネットワークパフォーマンスデータを補足します。
const resourceParams = new ResourceParams();
resourceParams.setUrl(resourceId);
resourceParams.setResourceStatus(200);
resourceParams.setResponseContentLength(1024);
resourceParams.resourceType = 'xhr';

const netStatusBean = new NetStatusBean();
netStatusBean.setResourceHostIP('192.168.1.1');
netStatusBean.setDNSTime(10000000);
netStatusBean.setTcpTime(20000000);
netStatusBean.setTTFB(50000000);
netStatusBean.setResponseTime(100000000);

FTRUMGlobalManager.getInstance().stopResource(resourceId);
FTRUMGlobalManager.getInstance().addResource(resourceId, resourceParams, netStatusBean);

// ケース 2: 拡張属性を指定する場合。以下は独立したリクエストです。使用する際は、ケース 1 の startResource と stopResource の呼び出しを置き換えてください。
const startResourceProperty: Record<string, object> = {
  request_source: new String('checkout')
};
FTRUMGlobalManager.getInstance().startResource(resourceId, startResourceProperty);

const stopResourceProperty: Record<string, object> = {
  response_cache: new Boolean(false)
};
FTRUMGlobalManager.getInstance().stopResource(resourceId, stopResourceProperty);

import { rcp } from '@kit.RemoteCommunicationKit';
import { createFTRCPTrackConfig } from '@guancecloud/ft_sdk/Index';

const session = rcp.createSession(
  createFTRCPTrackConfig({
    baseAddress: 'https://api.example.com'
  })
);

// GET リクエスト
const request = new rcp.Request('/data', 'GET');
const response = await session.fetch(request);

// POST リクエスト
const headers: rcp.RequestHeaders = { 'Content-Type': 'application/json' };
const postRequest = new rcp.Request('/data', 'POST', headers, { name: 'test' });
const postResponse = await session.fetch(postRequest);

import { createFTRCPTrackConfig } from '@guancecloud/ft_sdk/Index';

import { rcp } from '@kit.RemoteCommunicationKit';
import { RCPTraceInterceptor, RCPResourceInterceptor } from '@guancecloud/ft_sdk/Index';

const session = rcp.createSession({
  baseAddress: 'https://api.example.com',
  interceptors: [
    new RCPTraceInterceptor(),
    new RCPResourceInterceptor()
  ],
  requestConfiguration: {
    tracing: {
      collectTimeInfo: true
    }
  }
});

import { http } from '@kit.NetworkKit';
import { createFTHttpInterceptorChain } from '@guancecloud/ft_sdk_ext/Index';

const request = http.createHttp();
const interceptorChain = createFTHttpInterceptorChain();
interceptorChain.apply(request);

try {
  const response = await request.request('https://httpbin.org/get', {
    method: http.RequestMethod.GET,
    header: {
      'Accept': 'application/json'
    }
  });
} finally {
  request.destroy();
}

import { http } from '@kit.NetworkKit';
import { createFTHttpInterceptorChain } from '@guancecloud/ft_sdk_ext/Index';

const request = http.createHttp();
const interceptorChain = createFTHttpInterceptorChain({
  interceptors: [
    new CustomAfterInterceptor()//カスタムを追加
  ]
});
interceptorChain.apply(request);

[
  new HttpInitialRequestInterceptor(),
  new HttpFinalResponseInterceptor(),
  new CustomAfterInterceptor()
]

import { http } from '@kit.NetworkKit';
import {
  HttpInitialRequestInterceptor,
  HttpFinalResponseInterceptor
} from '@guancecloud/ft_sdk_ext/Index';

const request = http.createHttp();
const interceptorChain = new http.HttpInterceptorChain();
interceptorChain.addChain([
  new CustomBeforeInterceptor(),
  new HttpInitialRequestInterceptor(),
  new HttpFinalResponseInterceptor()
]);
interceptorChain.apply(request);

import axios from '@ohos/axios';
import { applyFTAxiosTrack } from '@guancecloud/ft_sdk/Index';

const client = axios.create({
  timeout: 10000
});

applyFTAxiosTrack(client);

import axios from '@ohos/axios';
import { applyFTAxiosTrack } from '@guancecloud/ft_sdk/Index';

const client = axios.create({
  timeout: 10000
});

applyFTAxiosTrack(client);

client.interceptors.request.use((config) => {
  config.headers = {
    ...(config.headers || {}),
    Authorization: 'Bearer <token>',
    'X-Signature': 'signed-value'
  };
  return config;
});

client.interceptors.response.use((response) => {
  return response;
});

import axios from '@ohos/axios';
import {
  createFTHttpInterceptorChain,
  applyFTAxiosChainMethodBridge
} from '@guancecloud/ft_sdk_ext/Index';

const client = axios.create({
  timeout: 10000,
  interceptorChain: createFTHttpInterceptorChain()
});

applyFTAxiosChainMethodBridge(client);

const response = await client.post('https://api.example.com/data', {
  source: 'axios',
  message: 'ft auto track'
});

import axios from '@ohos/axios';
import { createFTHttpInterceptorChain } from '@guancecloud/ft_sdk_ext/Index';

const response = await axios.request({
  url: 'https://httpbin.org/post',
  method: 'post',
  data: {
    source: 'axios',
    message: 'ft auto track'
  },
  responseType: 'string',
  interceptorChain: createFTHttpInterceptorChain()
});