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 선택 사항. 세 번째 매개변수가 지속 시간인 경우에만 확장 속성을 전달합니다.
 */
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()
});