> ## Documentation Index
> Fetch the complete documentation index at: https://test-8ad8522e-docs-safari-skill-download-jwt.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Application Management

> Learn how to create and manage RUM applications in Flashduty, including app creation, configuration, and permission management

## Overview

A RUM application is a container for frontend performance monitoring data, used to collect, store, and analyze real user experience data from frontend applications. An application represents a monitored frontend project, which can be a website, mobile app, or single-page application.

<Tip>
  We recommend creating RUM applications based on business systems or applications, such as: official website, e-commerce store, admin dashboard, etc.
</Tip>

Each application has its own unique `applicationId` and `clientToken`, used to identify data sources and ensure data security. After the application is created, you need to integrate the SDK into your frontend code to start data collection and monitoring.

## Application Permissions

To meet the data security requirements of different business scenarios, RUM applications provide flexible access level settings:

| Access Level | Visibility                                                           | Applicable Scenarios          |
| ------------ | -------------------------------------------------------------------- | ----------------------------- |
| **Public**   | Visible to all users in the account, can view data and handle Issues | General business applications |
| **Private**  | Only visible to creator, account administrator, and owner account    | Sensitive business data       |

<Note>
  In private applications, if other members need to view content, they can be temporarily authorized to access it by sharing the incident link.
</Note>

## Create Application

<Frame caption="RUM Application Creation Interface">
  <img src="https://docs-cdn.flashcat.cloud/images/png/69baa5066dae4641adf1f769f3aacc54.png" alt="RUM Application Creation Interface" />
</Frame>

You can quickly create an application through the RUM product guide page:

<Steps>
  <Step title="Select Application Type">
    Select the frontend technology type corresponding to the application, currently supporting **JavaScript (JS), Android, iOS, and WeChat Mini Program**.
  </Step>

  <Step title="Set Management Team">
    Specify the management team for this application.

    <Warning>
      Team members have full operational permissions for this application, non-team members only have read-only access to the configuration of this application.
    </Warning>
  </Step>

  <Step title="Configure Geo-information">
    By default, automatic collection of user geo-location data is enabled. To disable automatic collection of client IP or geo-location data, turn off the geo-information collection switch.

    See [Data Collection](/en/rum/others/data-collection).
  </Step>

  <Step title="Configure Alerts">
    By default, alert notifications are automatically enabled to facilitate timely handling of errors.

    See [Issue Alerts](/en/rum/error-tracking/issue-alerts).
  </Step>
</Steps>

## SDK Configuration

<video controls className="w-full aspect-video rounded-xl" src="https://docs-cdn.flashcat.cloud/videos/rum-app-set-sdk.mov" />

You can modify parameters and preview the initialization code in real-time in **Application Configuration > SDK Configuration** to quickly integrate the SDK.

The console provides detailed integration guides for each platform:

* **JavaScript (Web)**: After configuring parameters like service name, preview the `flashcatRum.init()` initialization code in real-time
* **Android**: Shows complete integration steps including adding Gradle dependencies (`cloud.flashcat:dd-sdk-android-core` and `cloud.flashcat:dd-sdk-android-rum`), initializing the SDK in `Application.onCreate()` with RUM enabled, and optional WebView tracking integration
* **iOS**: Shows complete integration steps including adding Swift Package Manager dependency (`fc-sdk-ios`, from version 0.3.0), initializing the SDK in `AppDelegate.didFinishLaunchingWithOptions` with RUM enabled, and optional WebView tracking integration
* **WeChat Mini Program**: Fill in `env`, `service`, `version`, and `sessionSampleRate` in the form, and the `flashcatRum.init()` snippet built on `@flashcatcloud/fc-sdk-miniprogram` is generated and previewed in real time (see "WeChat Mini Program SDK Configuration Assistant" below)

Each platform's SDK configuration page automatically fills in the current application's `applicationId` and `clientToken`, so you can copy the code directly into your project.

<Warning>
  Modifying SDK configuration in application management will not take effect in real-time on integrated clients. All configuration changes need to be updated in your frontend code and redeployed to take effect.
</Warning>

### Service Definition

A service is an independent, deployable code repository that maps to a set of pages.

<Tabs>
  <Tab title="Monolithic Application">
    If your application is built as a whole, your RUM application only needs one service name.

    ```javascript theme={null}
    flashcatRum.init({
      applicationId: 'YOUR_APP_ID',
      clientToken: 'YOUR_CLIENT_TOKEN',
      service: 'my-web-app'  // Single service name
    });
    ```
  </Tab>

  <Tab title="Micro-frontend/Multi-page Application">
    If your browser application is built from multiple independent repositories, set different service names for different modules.

    ```javascript theme={null}
    // Main application
    flashcatRum.init({
      service: 'main-app'
    });

    // Sub-application A
    flashcatRum.init({
      service: 'module-a'
    });
    ```
  </Tab>
</Tabs>

### WeChat Mini Program SDK Configuration Assistant

When the application type is **WeChat Mini Program**, **Application Configuration > SDK Configuration** displays a dedicated Mini Program integration wizard: fill in the form on the left and a ready-to-copy initialization snippet is generated on the right in real time.

#### Form Fields

| Field               | Description                                          | Validation                                       | Default |
| ------------------- | ---------------------------------------------------- | ------------------------------------------------ | ------- |
| `env`               | Environment variable, e.g. `prod`, `dev`             | Letters, digits, underscore only; up to 24 chars | —       |
| `service`           | Service name; all events default to this tag         | Letters, digits, underscore only; up to 24 chars | —       |
| `version`           | Version number, useful for filtering during analysis | Letters, digits, `.` only; up to 24 chars        | `1.0.0` |
| `sessionSampleRate` | Session sample rate (percentage)                     | Integer in range `0–100`                         | `10`    |

<Note>
  No save action is needed — the preview snippet updates as you type. `applicationId` and `clientToken` are filled in automatically by the system; you do not need to set them by hand.
</Note>

#### Two-Step Integration

<Steps>
  <Step title="Add Dependency">
    Install the SDK in your Mini Program project and run the npm build through WeChat DevTools:

    ```bash theme={null}
    npm install @flashcatcloud/fc-sdk-miniprogram
    ```
  </Step>

  <Step title="Copy the Initialization Snippet">
    Use the copy button at the top-right of the right-hand code block, then paste the generated snippet into your Mini Program's `app.js`:

    ```typescript theme={null}
    import { flashcatRum } from '@flashcatcloud/fc-sdk-miniprogram';

    flashcatRum.init({
      applicationId: "<APPLICATION_ID>",
      clientToken: "<CLIENT_TOKEN>",
      service: "<SERVICE_NAME>",
      env: "<ENV_NAME>",
      version: "1.0.0",
      sessionSampleRate: 10
    });
    ```
  </Step>
</Steps>

For the full SDK capabilities, collection toggles, and event reporting model, see [WeChat Mini Program SDK Integration](/en/rum/sdk/wechat-miniprogram/sdk-integration).

## Tracing Settings

Tracing settings allow you to link RUM data with your backend distributed tracing system, enabling full-chain observability from frontend user operations to backend service calls.

<Steps>
  <Step title="Enable Tracing">
    In the "Tracing Settings" tab of the application details, turn on the Tracing switch. If a redirect link has not been configured yet, the system will prompt you to set up the link first.
  </Step>

  <Step title="Configure Redirect Link">
    Set the redirect link for your tracing system. You can use the `${trace_id}` variable in the link, which the system will automatically replace with the actual Trace ID when redirecting.

    For example: `https://your-tracing-system.com/trace/${trace_id}`

    <Note>
      The redirect link must start with `http://` or `https://`.
    </Note>
  </Step>
</Steps>

Once configured, clicking a Trace ID link opens the trace details in a popup within the current page, without leaving the RUM Explorer, allowing you to quickly troubleshoot frontend-backend correlation issues.

## Privacy Settings

Privacy settings allow you to control the scope of user privacy data collected by the RUM SDK, meeting data compliance requirements for different regions.

| Setting                      | Description                                                                                | Associated Fields                            |
| ---------------------------- | ------------------------------------------------------------------------------------------ | -------------------------------------------- |
| **Geo-location Information** | Controls whether to collect user country, province, city, and other geographic information | `@geo_country`, `@geo_province`, `@geo_city` |
| **IP Address**               | Controls whether to collect user IPv4 and IPv6 addresses                                   | `@geo_ip_v4`, `@geo_ip_v6`                   |

<Warning>
  After disabling geo-location or IP address collection, the related filter and analysis dimensions will no longer be available. Please adjust carefully based on your business requirements and compliance needs.
</Warning>

## Delete Application

If you no longer need an application, you can find the delete button at the bottom of the "Basic Info" tab in the application details.

<Warning>
  After deleting an application:

  * No new events will be received
  * The application's Client Token will be immediately revoked
  * Previously collected RUM event data can still be manually exported, or you can contact the support team to restore the deleted application

  This operation requires the **RUM Application Delete** permission.
</Warning>

## Next Steps

<CardGroup cols={3}>
  <Card title="SDK Integration Guide" icon="code" href="/en/rum/sdk/web/sdk-integration">
    Learn how to integrate RUM SDK
  </Card>

  <Card title="Advanced Configuration" icon="sliders" href="/en/rum/sdk/web/advanced-config">
    Learn about advanced configuration options for the SDK
  </Card>

  <Card title="Analytics Dashboard" icon="chart-line" href="/en/rum/analytics/web">
    View and analyze RUM data
  </Card>

  <Card title="WeChat Mini Program SDK" icon="mobile-screen-button" href="/en/rum/sdk/wechat-miniprogram/sdk-integration">
    Learn how to integrate the RUM SDK into a WeChat Mini Program
  </Card>
</CardGroup>