RUM 設定¶

FTSdk.initRUMWithConfig(
        new FTRUMConfig()
            .setRumAppId(RUM_APP_ID)
            .setEnableTraceUserView(true)
            .setDeviceMetricsMonitorType(DeviceMetricsMonitorType.ALL.getValue())
            .setEnableTraceUserAction(true)
            .setEnableTraceUserResource(true)
            .setEnableTrackAppUIBlock(true)
            .setEnableTrackAppCrash(true)
            .setEnableTrackAppANR(true)
            .setExtraMonitorTypeWithError(ErrorMonitorType.ALL.getValue())
);

FTSdk.initRUMWithConfig(
    FTRUMConfig()
        .setRumAppId(RUM_APP_ID)
        .setEnableTraceUserView(true)
        .setDeviceMetricsMonitorType(DeviceMetricsMonitorType.ALL.getValue())
        .setEnableTraceUserAction(true)
        .setEnableTraceUserResource(true)
        .setEnableTrackAppUIBlock(true)
        .setEnableTrackAppCrash(true)
        .setEnableTrackAppANR(true)
        .setExtraMonitorTypeWithError(ErrorMonitorType.ALL.getValue())
)

FTRUMConfig config = new FTRUMConfig()
    .setEnableTrackAppCrash(true)
    .setEnableTrackAppANR(true)
    .setIssueDataProvider(issue -> {
        Map<String, Object> fields = new HashMap<>();
        fields.put("business_scene", sceneStore.current());
        fields.put("historical_issue", issue.isHistorical());
        return fields;
    });

val config = FTRUMConfig()
    .setEnableTrackAppCrash(true)
    .setEnableTrackAppANR(true)
    .setIssueDataProvider { issue ->
        mapOf(
            "business_scene" to sceneStore.current(),
            "historical_issue" to issue.isHistorical
        )
    }

/**
 * Action を追加
 *
 * @param actionName action 名
 * @param actionType action タイプ
 * @param property   追加プロパティ（オプション）
 */
public void startAction(String actionName, String actionType, HashMap<String, Object> property)

/**
 * Action を追加。このデータは Error、Resource、LongTask データと関連付けることはできません。
 *
 * @param actionName action 名
 * @param actionType action タイプ
 * @param duration   ナノ秒、持続時間（オプション）
 * @param property   拡張プロパティ（オプション）
 */
public void addAction(String actionName, String actionType, long duration, HashMap<String, Object> property)

/**
 * action を追加
 *
 * @param actionName action 名
 * @param actionType action タイプ
 * @param property   追加プロパティ（オプション）
 */
fun startAction(actionName: String, actionType: String, property: HashMap<String, Any>)

/**
 * Action を追加
 *
 * @param actionName action 名
 * @param actionType action タイプ
 * @param duration   ナノ秒、持続時間（オプション）
 * @param property   拡張プロパティ（オプション）
 */
fun addAction(actionName: String, actionType: String, duration: Long, property: HashMap<String, Any>)

// シナリオ 1
FTRUMGlobalManager.get().startAction("login", "action_type");

// シナリオ 2: 動的パラメータ
HashMap<String, Object> map = new HashMap<>();
map.put("ft_key", "ft_value");
FTRUMGlobalManager.get().startAction("login", "action_type", map);

// シナリオ 1
FTRUMGlobalManager.get().addAction("login", "action_type");

// シナリオ 2: 動的パラメータ
HashMap<String, Object> map = new HashMap<>();
map.put("ft_key", "ft_value");
FTRUMGlobalManager.get().addAction("login", "action_type", map);

// シナリオ 1
FTRUMGlobalManager.get().startAction("login", "action_type")

// シナリオ 2: 動的パラメータ
val map = HashMap<String, Any>()
map["ft_key"] = "ft_value"
FTRUMGlobalManager.get().startAction("login", "action_type", map)

// シナリオ 1
FTRUMGlobalManager.get().addAction("login", "action_type")

// シナリオ 2: 動的パラメータ
val map = HashMap<String, Any>()
map["ft_key"] = "ft_value"
FTRUMGlobalManager.get().addAction("login", "action_type", map)

/**
 * view 開始
 *
 * @param viewName 現在のページ名
 * @param property 追加プロパティ（オプション）
 */
public void startView(String viewName, HashMap<String, Object> property)

/**
 * view 終了
 *
 * @param property 追加プロパティ（オプション）
 */
public void stopView(HashMap<String, Object> property)

/**
 * 現在の view の loading_time 指標を更新します。単位はナノ秒です。
 *
 * @param duration duration
 */
public void updateLoadTime(long duration)

/**
 * view 開始
 *
 * @param viewName 現在のページ名
 * @param property 追加プロパティ（オプション）
 */
fun startView(viewName: String, property: HashMap<String, Any>)

/**
 * view 終了
 *
 * @param property 追加プロパティ（オプション）
 */
fun stopView(property: HashMap<String, Any>)

/**
 * 現在の view の loading_time 指標を更新します。単位はナノ秒です。
 *
 * @param duration duration
 */
fun updateLoadTime(duration: Long)

@Override
protected void onResume() {
    super.onResume();

    // シナリオ 1
    FTRUMGlobalManager.get().startView("Current Page Name");

    // シナリオ 2: 動的パラメータ
    HashMap<String, Object> map = new HashMap<>();
    map.put("ft_key", "ft_value");
    map.put("ft_key_will_change", "ft_value");
    FTRUMGlobalManager.get().startView("Current Page Name", map)
}

@Override
protected void onPause() {
    super.onPause();

    // シナリオ 1
    FTRUMGlobalManager.get().stopView();

    // シナリオ 2 : 動的パラメータ
    HashMap<String, Object> map = new HashMap<>();
    map.put("ft_key_will_change", "ft_value_change"); // ft_key_will_change の値は stopView 時に ft_value_change に更新されます
    FTRUMGlobalManager.get().stopView(map);

}

override fun onResume() {
    super.onResume()

    // シナリオ 1
    FTRUMGlobalManager.get().startView("Current Page Name")

    // シナリオ 2: 動的パラメータ
    val map = HashMap<String, Any>()
    map["ft_key"] = "ft_value"
    map["ft_key_will_change"] = "ft_value"
    FTRUMGlobalManager.get().startView("Current Page Name", map)
}

override fun onPause() {
    super.onPause()

    // シナリオ 1
    FTRUMGlobalManager.get().stopView()

    // シナリオ 2 : 動的パラメータ
    val map = HashMap<String, Any>()
    map["ft_key_will_change"] = "ft_value_change" // ft_key_will_change の値は、stopView 時に ft_value_change に変更されます
    FTRUMGlobalManager.get().stopView(map)
}

/**
 * エラー情報を追加
 *
 * @param log       ログ
 * @param message   メッセージ
 * @param errorType エラータイプ, ErrorType
 * @param state     プログラム実行状態
 * @param dateline  発生時間、ナノ秒（オプション）
 * @param property  追加プロパティ（オプション）
 */
public void addError(String log, String message, long dateline, ErrorType errorType,
                     AppState state, HashMap<String, Object> property)

/**
 * エラー情報を追加
 *
 * @param log       ログ
 * @param message   メッセージ
 * @param errorType エラータイプ, String
 * @param state     プログラム実行状態
 * @param dateline  発生時間、ナノ秒（オプション）
 * @param property  追加プロパティ（オプション）
 */
public void addError(String log, String message, long dateline, String errorType,
                     AppState state, HashMap<String, Object> property)

/**
 * エラー情報を追加
 *
 * @param log       ログ
 * @param message   メッセージ
 * @param errorType エラータイプ, ErrorType
 * @param state     プログラム実行状態
 * @param dateline  発生時間、ナノ秒（オプション）
 * @param property  追加プロパティ（オプション）
 */
fun addError(log: String, message: String, dateline: Long, errorType: ErrorType, state: AppState, property: HashMap<String, Any>)

/**
 * エラー情報を追加
 *
 * @param log       ログ
 * @param message   メッセージ
 * @param errorType エラータイプ, String
 * @param state     プログラム実行状態
 * @param dateline  発生時間、ナノ秒（オプション）
 * @param property  追加プロパティ（オプション）
 */
fun addError(log: String, message: String, dateline: Long, errorType: String, state: AppState, property: HashMap<String, Any>)

// シナリオ 1:
FTRUMGlobalManager.get().addError("error log", "error msg", ErrorType.JAVA, AppState.RUN);

// シナリオ 2: 発生したエラーを遅延記録する場合、ここでの時間は通常、エラーが発生した時間です
FTRUMGlobalManager.get().addError("error log", "error msg", 16789000000000000000L, ErrorType.JAVA, AppState.RUN);

// シナリオ 3：動的パラメータ
HashMap<String, Object> map = new HashMap<>();
map.put("ft_key", "ft_value");
FTRUMGlobalManager.get().addError("error log", "error msg", ErrorType.JAVA, AppState.RUN, map);

// シナリオ 1:
FTRUMGlobalManager.get().addError("error log", "error msg", ErrorType.JAVA, AppState.RUN)

// シナリオ 2: 発生したエラーを遅延記録する場合、ここでの時間は通常、エラーが発生した時間です
FTRUMGlobalManager.get().addError("error log", "error msg", 16789000000000000000, ErrorType.JAVA, AppState.RUN)

// シナリオ 3：動的パラメータ
val map = HashMap<String, Any>()
map["ft_key"] = "ft_value"
FTRUMGlobalManager.get().addError("error log", "error msg", ErrorType.JAVA, AppState.RUN, map)

/**
 * 長時間タスクを追加
 *
 * @param log      ログ内容
 * @param duration 持続時間、ナノ秒
 * @param property 追加プロパティ（オプション）
 */
public void addLongTask(String log, long duration, HashMap<String, Object> property)

/**
 * 長時間タスクを追加
 *
 * @param log      ログ内容
 * @param duration 持続時間、ナノ秒
 * @param property 追加プロパティ（オプション）
 */
fun addLongTask(log: String, duration: Long, property: HashMap<String, Any>)

// シナリオ 1
FTRUMGlobalManager.get().addLongTask("error log", 1000000L);

// シナリオ 2: 動的パラメータ
HashMap<String, Object> map = new HashMap<>();
map.put("ft_key", "ft_value");
FTRUMGlobalManager.get().addLongTask("", 1000000L, map);

// シナリオ 1
FTRUMGlobalManager.get().addLongTask("error log", 1000000L)

// シナリオ 2: 動的パラメータ
val map = HashMap<String, Any>()
map["ft_key"] = "ft_value"
FTRUMGlobalManager.get().addLongTask("", 1000000L, map)

/**
 * resource 開始
 *
 * @param resourceId リソース ID
 * @param property   追加プロパティ（オプション）
 */
public void startResource(String resourceId, HashMap<String, Object> property)

/**
 * resource 終了
 *
 * @param resourceId リソース ID
 * @param property   追加プロパティ（オプション）
 */
public void stopResource(final String resourceId, HashMap<String, Object> property)

/**
 * ネットワーク転送内容を設定
 *
 * @param resourceId resourceId
 * @param params params
 * @param netStatusBean netStatusBean
 */
public void addResource(String resourceId, ResourceParams params, NetStatusBean netStatusBean)

/**
 * resource 開始
 *
 * @param resourceId リソース ID（オプション）
 */
fun startResource(resourceId: String, property: HashMap<String, Any>)

/**
 * resource 終了
 *
 * @param resourceId リソース ID
 * @param property   追加プロパティ（オプション）
 */
fun stopResource(resourceId: String, property: HashMap<String, Any>)

/**
 * ネットワーク転送内容を設定
 *
 * @param resourceId resourceId
 * @param params params
 * @param netStatusBean netStatusBean
 */
fun addResource(resourceId: String, params: ResourceParams, netStatusBean: NetStatusBean)

// シナリオ 1
// リクエスト開始
FTRUMGlobalManager.get().startResource("resourceId");

// ...

// リクエスト終了
FTRUMGlobalManager.get().stopResource("resourceId");

// 最後に、リクエスト終了後、リクエスト関連のデータ指標を送信
ResourceParams params = new ResourceParams();
params.setUrl("https://guance.com");
params.setResponseContentType(response.header("Content-Type"));
params.setResponseConnection(response.header("Connection"));
params.setResponseContentEncoding(response.header("Content-Encoding"));
params.setResponseHeader(response.headers().toString());
params.setRequestHeader(request.headers().toString());
params.setResourceStatus(response.code());
params.setResourceMethod(request.method());

NetStatusBean bean = new NetStatusBean();
bean.setTcpStartTime(60000000);
// ...

FTRUMGlobalManager.get().addResource("resourceId", params, bean);

// シナリオ 2 ：動的パラメータの使用
HashMap<String, Object> map = new HashMap<>();
map.put("ft_key", "ft_value");
map.put("ft_key_will_change", "ft_value");

FTRUMGlobalManager.get().startResource("resourceId", map);

// ...
HashMap<String, Object> map = new HashMap<>();
map.put("ft_key_will_change", "ft_value_change"); // ft_key_will_change の値は、stopResource 時に ft_value_change に変更されます
FTRUMGlobalManager.get().stopResource(uuid, map);

// シナリオ 1
// リクエスト開始
FTRUMGlobalManager.get().startResource("resourceId")

// リクエスト終了
FTRUMGlobalManager.get().stopResource("resourceId")

// 最後に、リクエスト終了後、リクエスト関連のデータ指標を送信
val params = ResourceParams()
params.url = "https://guance.com"
params.responseContentType = response.header("Content-Type")
params.responseConnection = response.header("Connection")
params.responseContentEncoding = response.header("Content-Encoding")
params.responseHeader = response.headers.toString()
params.requestHeader = request.headers.toString()
params.resourceStatus = response.code
params.resourceMethod = request.method

val bean = NetStatusBean()
bean.tcpStartTime = 60000000
// ...
FTRUMGlobalManager.get().addResource("resourceId", params, bean)

// シナリオ 2 ：動的パラメータの使用
val map = hashMapOf<String, Any>(
    "ft_key" to "ft_value",
    "ft_key_will_change" to "ft_value"
)
FTRUMGlobalManager.get().startResource("resourceId", map)

// ...
val map = hashMapOf<String, Any>(
    "ft_key_will_change" to "ft_value_change"
)
// ft_key_will_change の値は、stopResource 時に ft_value_change に変更されます

FTRUMGlobalManager.get().stopResource(uuid, map)

/**
 * ユーザー情報をバインド
 *
 * @param id ユーザー ID
 */
public static void bindRumUserData(@NonNull String id)

/**
 * ユーザー情報をバインド
 */
public static void bindRumUserData(@NonNull UserData data)

/**
 * ユーザー情報をアンバインド
 */
public static void unbindRumUserData()

/**
 * ユーザー情報をバインド
 *
 * @param id ユーザー ID
 */
fun bindRumUserData(id: String)

/**
 * ユーザー情報をバインド
 *
 * @param data ユーザー情報
 */
fun bindRumUserData(data: UserData)

/**
 * ユーザー情報をアンバインド
 */
fun unbindRumUserData()

// ユーザーログイン成功後にこのメソッドを呼び出してユーザー情報をバインドできます
FTSdk.bindRumUserData("001");

UserData userData = new UserData();
userData.setName("test.user");
userData.setId("test.id");
userData.setEmail("test@mail.com");
Map<String, String> extMap = new HashMap<>();
extMap.put("ft_key", "ft_value");
userData.setExts(extMap);
FTSdk.bindRumUserData(userData);

// ユーザーログアウト後にこのメソッドを呼び出してユーザー情報をアンバインドできます
FTSdk.unbindRumUserData();

// ユーザーログイン成功後にこのメソッドを呼び出してユーザー情報をバインドできます
FTSdk.bindRumUserData("001")

// ユーザーの詳細データをバインド
val userData = UserData()
userData.name = "test.user"
userData.id = "test.id"
userData.email = "test@mail.com"
val extMap = HashMap<String, String>()
extMap["ft_key"] = "ft_value"
userData.setExts(extMap)
FTSdk.bindRumUserData(userData)

// ユーザーログアウト後にこのメソッドを呼び出してユーザー情報をアンバインドできます
FTSdk.unbindRumUserData()