RUM Configuration¶

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())
)

/**
 * Add Action
 *
 * @param actionName action name
 * @param actionType action type
 * @param property   additional property parameters (optional)
 */
public void startAction(String actionName, String actionType, HashMap<String, Object> property)

/**
 * Add Action. This type of data cannot be associated with Error, Resource, LongTask data.
 *
 * @param actionName action name
 * @param actionType action type
 * @param duration   nanoseconds, duration (optional)
 * @param property   extended properties (optional)
 */
public void addAction(String actionName, String actionType, long duration, HashMap<String, Object> property)

/**
 * Add action
 *
 * @param actionName action name
 * @param actionType action type
 * @param property   additional property parameters (optional)
 */
fun startAction(actionName: String, actionType: String, property: HashMap<String, Any>)

/**
 * Add Action
 *
 * @param actionName action name
 * @param actionType action type
 * @param duration   nanoseconds, duration (optional)
 * @param property   extended properties (optional)
 */
fun addAction(actionName: String, actionType: String, duration: Long, property: HashMap<String, Any>)

// Scenario 1
FTRUMGlobalManager.get().startAction("login", "action_type");

// Scenario 2: Dynamic parameters
HashMap<String, Object> map = new HashMap<>();
map.put("ft_key", "ft_value");
FTRUMGlobalManager.get().startAction("login", "action_type", map);

// Scenario 1
FTRUMGlobalManager.get().addAction("login", "action_type");

// Scenario 2: Dynamic parameters
HashMap<String, Object> map = new HashMap<>();
map.put("ft_key", "ft_value");
FTRUMGlobalManager.get().addAction("login", "action_type", map);

// Scenario 1
FTRUMGlobalManager.get().startAction("login", "action_type")

// Scenario 2: Dynamic parameters
val map = HashMap<String, Any>()
map["ft_key"] = "ft_value"
FTRUMGlobalManager.get().startAction("login", "action_type", map)

// Scenario 1
FTRUMGlobalManager.get().addAction("login", "action_type")

// Scenario 2: Dynamic parameters
val map = HashMap<String, Any>()
map["ft_key"] = "ft_value"
FTRUMGlobalManager.get().addAction("login", "action_type", map)

/**
 * view start
 *
 * @param viewName current page name
 * @param property additional property parameters (optional)
 */
public void startView(String viewName, HashMap<String, Object> property)

/**
 * view end
 *
 * @param property additional property parameters (optional)
 */
public void stopView(HashMap<String, Object> property)

/**
 * Update the current view loading_time metric, unit nanoseconds
 *
 * @param duration duration
 */
public void updateLoadTime(long duration)

/**
 * view start
 *
 * @param viewName current page name
 * @param property additional property parameters (optional)
 */
fun startView(viewName: String, property: HashMap<String, Any>)

/**
 * view end
 *
 * @param property additional property parameters (optional)
 */
fun stopView(property: HashMap<String, Any>)

/**
 * Update the current view loading_time metric, unit nanoseconds
 *
 * @param duration duration
 */
fun updateLoadTime(duration: Long)

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

    // Scenario 1
    FTRUMGlobalManager.get().startView("Current Page Name");

    // Scenario 2: Dynamic parameters
    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();

    // Scenario 1
    FTRUMGlobalManager.get().stopView();

    // Scenario 2 : Dynamic parameters
    HashMap<String, Object> map = new HashMap<>();
    map.put("ft_key_will_change", "ft_value_change"); // The value of ft_key_will_change will be updated to ft_value_change when stopView is called.
    FTRUMGlobalManager.get().stopView(map);

}

override fun onResume() {
    super.onResume()

    // Scenario 1
    FTRUMGlobalManager.get().startView("Current Page Name")

    // Scenario 2: Dynamic parameters
    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()

    // Scenario 1
    FTRUMGlobalManager.get().stopView()

    // Scenario 2 : Dynamic parameters
    val map = HashMap<String, Any>()
    map["ft_key_will_change"] = "ft_value_change" // The value of ft_key_will_change will be updated to ft_value_change when stopView is called.
    FTRUMGlobalManager.get().stopView(map)
}

/**
 * Add error information
 *
 * @param log       log
 * @param message   message
 * @param errorType error type, ErrorType
 * @param state     program running state
 * @param dateline  occurrence time, nanoseconds (optional)
 * @param property  additional properties (optional)
 */
public void addError(String log, String message, long dateline, ErrorType errorType,
                     AppState state, HashMap<String, Object> property)

/**
 * Add error information
 *
 * @param log       log
 * @param message   message
 * @param errorType error type, String
 * @param state     program running state
 * @param dateline  occurrence time, nanoseconds (optional)
 * @param property  additional properties (optional)
 */
public void addError(String log, String message, long dateline, String errorType,
                     AppState state, HashMap<String, Object> property)

/**
 * Add error information
 *
 * @param log       log
 * @param message   message
 * @param errorType error type, ErrorType
 * @param state     program running state
 * @param dateline  occurrence time, nanoseconds (optional)
 * @param property  additional properties (optional)
 */
fun addError(log: String, message: String, dateline: Long, errorType: ErrorType, state: AppState, property: HashMap<String, Any>)

/**
 * Add error information
 *
 * @param log       log
 * @param message   message
 * @param errorType error type, String
 * @param state     program running state
 * @param dateline  occurrence time, nanoseconds (optional)
 * @param property  additional properties (optional)
 */
fun addError(log: String, message: String, dateline: Long, errorType: String, state: AppState, property: HashMap<String, Any>)

// Scenario 1:
FTRUMGlobalManager.get().addError("error log", "error msg", ErrorType.JAVA, AppState.RUN);

// Scenario 2: Record an error that occurred earlier. The time here is usually the time the error occurred.
FTRUMGlobalManager.get().addError("error log", "error msg", 16789000000000000000L, ErrorType.JAVA, AppState.RUN);

// Scenario 3: Dynamic parameters
HashMap<String, Object> map = new HashMap<>();
map.put("ft_key", "ft_value");
FTRUMGlobalManager.get().addError("error log", "error msg", ErrorType.JAVA, AppState.RUN, map);

// Scenario 1:
FTRUMGlobalManager.get().addError("error log", "error msg", ErrorType.JAVA, AppState.RUN)

// Scenario 2: Record an error that occurred earlier. The time here is usually the time the error occurred.
FTRUMGlobalManager.get().addError("error log", "error msg", 16789000000000000000, ErrorType.JAVA, AppState.RUN)

// Scenario 3: Dynamic parameters
val map = HashMap<String, Any>()
map["ft_key"] = "ft_value"
FTRUMGlobalManager.get().addError("error log", "error msg", ErrorType.JAVA, AppState.RUN, map)

/**
 * Add long task
 *
 * @param log      log content
 * @param duration duration, nanoseconds
 * @param property additional property parameters (optional)
 */
public void addLongTask(String log, long duration, HashMap<String, Object> property)

/**
 * Add long task
 *
 * @param log      log content
 * @param duration duration, nanoseconds
 * @param property additional property parameters (optional)
 */
fun addLongTask(log: String, duration: Long, property: HashMap<String, Any>)

// Scenario 1
FTRUMGlobalManager.get().addLongTask("error log", 1000000L);

// Scenario 2: Dynamic parameters
HashMap<String, Object> map = new HashMap<>();
map.put("ft_key", "ft_value");
FTRUMGlobalManager.get().addLongTask("", 1000000L, map);

// Scenario 1
FTRUMGlobalManager.get().addLongTask("error log", 1000000L)

// Scenario 2: Dynamic parameters
val map = HashMap<String, Any>()
map["ft_key"] = "ft_value"
FTRUMGlobalManager.get().addLongTask("", 1000000L, map)

/**
 * resource start
 *
 * @param resourceId resource Id
 * @param property   additional property parameters (optional)
 */
public void startResource(String resourceId, HashMap<String, Object> property)

/**
 * resource end
 *
 * @param resourceId resource Id
 * @param property   additional property parameters (optional)
 */
public void stopResource(final String resourceId, HashMap<String, Object> property)

/**
 * Set network transmission content
 *
 * @param resourceId resourceId
 * @param params params
 * @param netStatusBean netStatusBean
 */
public void addResource(String resourceId, ResourceParams params, NetStatusBean netStatusBean)

/**
 * resource start
 *
 * @param resourceId resource Id (optional)
 */
fun startResource(resourceId: String, property: HashMap<String, Any>)

/**
 * resource end
 *
 * @param resourceId resource Id
 * @param property   additional property parameters (optional)
 */
fun stopResource(resourceId: String, property: HashMap<String, Any>)

/**
 * Set network transmission content
 *
 * @param resourceId resourceId
 * @param params params
 * @param netStatusBean netStatusBean
 */
fun addResource(resourceId: String, params: ResourceParams, netStatusBean: NetStatusBean)

// Scenario 1
// Request start
FTRUMGlobalManager.get().startResource("resourceId");

// ...

// Request end
FTRUMGlobalManager.get().stopResource("resourceId");

// Finally, after the request ends, send request-related data metrics
ResourceParams params = new ResourceParams();
params.setUrl("https://truewatch.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);

// Scenario 2: Dynamic parameter usage
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"); // The value of ft_key_will_change will be updated to ft_value_change when stopResource is called.
FTRUMGlobalManager.get().stopResource(uuid, map);

// Scenario 1
// Request start
FTRUMGlobalManager.get().startResource("resourceId")

// Request end
FTRUMGlobalManager.get().stopResource("resourceId")

// Finally, after the request ends, send request-related data metrics
val params = ResourceParams()
params.url = "https://truewatch.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)

// Scenario 2: Dynamic parameter usage
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"
)
// The value of ft_key_will_change will be updated to ft_value_change when stopResource is called.

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

/**
 * Bind user information
 *
 * @param id user ID
 */
public static void bindRumUserData(@NonNull String id)

/**
 * Bind user information
 */
public static void bindRumUserData(@NonNull UserData data)

/**
 * Unbind user information
 */
public static void unbindRumUserData()

/**
 * Bind user information
 *
 * @param id user ID
 */
fun bindRumUserData(id: String)

/**
 * Bind user information
 *
 * @param data user information
 */
fun bindRumUserData(data: UserData)

/**
 * Unbind user information
 */
fun unbindRumUserData()

// This method can be called after successful user login to bind user information.
FTSdk.bindRumUserData("001");

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

// This method can be called after user logout to unbind user information.
FTSdk.unbindRumUserData();

// This method can be called after successful user login to bind user information.
FTSdk.bindRumUserData("001")

// Bind more user data
val userData = UserData()
userData.name = "test.user"
userData.id = "test.id"
userData.email = "[email protected]"
val extMap = HashMap<String, String>()
extMap["ft_key"] = "ft_value"
userData.setExts(extMap)
FTSdk.bindRumUserData(userData)

// This method can be called after user logout to unbind user information.
FTSdk.unbindRumUserData()