应用管理

​

概述

​

应用权限

​

创建应用

​

SDK 配置

• JavaScript（Web）：配置服务名等参数后，实时预览 flashcatRum.init() 初始化代码
• Android：展示完整的集成步骤，包括添加 Gradle 依赖（cloud.flashcat:dd-sdk-android-core 和 cloud.flashcat:dd-sdk-android-rum）、在 Application.onCreate() 中初始化 SDK 并启用 RUM，以及可选的 WebView 追踪集成
• iOS：展示完整的集成步骤，包括添加 Swift Package Manager 依赖（fc-sdk-ios，版本 0.6.0 起）、在 AppDelegate.didFinishLaunchingWithOptions 中初始化 SDK 并启用 RUM，以及可选的 WebView 追踪集成
• Flutter：Flutter SDK 封装了 Android/iOS 原生 SDK，一次集成即可同时监控两端，详见 Flutter SDK 接入
• 微信小程序：通过表单填写 env、service、version、sessionSampleRate 后，实时预览基于 @flashcatcloud/miniprogram-rum 的 flashcatRum.init() 初始化代码（参见下方「微信小程序 SDK 配置助手」）
• Electron：提供分步接入向导——主进程安装 @flashcatcloud/electron-sdk 并在 app.whenReady() 中完成初始化（必须在创建任何窗口之前，顺序不对时 SDK 不报错但采集不到数据）；如需采集窗口内的页面浏览、用户操作、网络请求与 JS 错误，渲染进程可选接入 @flashcatcloud/browser-rum，数据经 IPC 桥交由主进程统一上报；使用 Vite / webpack / esbuild 打包主进程时，还可加入对应插件以保留 SDK 的运行时依赖。详见 Electron SDK 接入
• React Native：提供四步接入向导——安装 @flashcatcloud/mobile-react-native 与导航库对应的视图采集包（@flashcatcloud/mobile-react-navigation 或 @flashcatcloud/mobile-react-native-navigation）并执行 pod install；用 withDatadogMetroConfig 包装 Metro 配置，让 release 构建的 bundle 与 sourcemap 带上 Debug ID；在应用入口尽早初始化 SDK（serviceName 必填，否则 Android 与 iOS 会拆成两个服务）；在导航容器就绪后开启自动视图采集。详见 React Native SDK 接入

​

服务定义

flashcatRum.init({
  applicationId: 'YOUR_APP_ID',
  clientToken: 'YOUR_CLIENT_TOKEN',
  service: 'my-web-app'  // 单一服务名称
});

// 主应用
flashcatRum.init({
  service: 'main-app'
});

// 子应用 A
flashcatRum.init({
  service: 'module-a'
});

​

微信小程序 SDK 配置助手

​

表单字段

​

两步集成

npm install @flashcatcloud/miniprogram-rum

import { flashcatRum } from '@flashcatcloud/miniprogram-rum';

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

​

Link 集成

​

内置 Tracing

​

添加外部链接

​

可用变量

​

查看关联 Link

• RUM 查看器事件详情：右上角显示 关联 Link 下拉入口，适用于会话、视图、操作、错误和资源等事件详情
• 错误事件详情：详情区域内嵌展示匹配的关联 Link 卡片，支持复制或打开链接
• Issue 错误样本：在错误样本下方展示匹配的关联 Link，便于从 Issue 直接跳转到日志、链路追踪或其他排障系统

​

隐私设置

​

远程配置

​

配置项

​

条件规则

• 匹配条件支持 env、app_version、sdk 三个维度，条件之间为 AND 精确匹配；SDK 未上报的维度永不匹配该规则。单个匹配值最长 256 字节。
• 规则自上而下求值，第一条完全匹配的规则生效；规则的覆盖值叠加在默认配置之上，规则未设置的字段沿用默认配置。
• 每个应用最多 20 条规则。

​

发布与生效

• 发布前页面会逐项展示新版本与线上配置的差异，并可查看原始 JSON。发布时可填写选填的「变更说明」（最长 255 字，例如「大促期间降低采样率」），随版本保存并展示于变更历史。确认后发布生成新版本。
• 生效方式固定为「下一个新会话生效」：进行中的会话不受影响，新会话逐步使用新配置；支持远程配置的客户端通常在发布后约 4 小时内完成切换。
• 「立即生效」（新配置到达客户端时结束当前会话、立即按新配置开启新会话）为协议预留能力，当前控制台版本暂不支持选择，后续版本开放。紧急场景（需要立刻止血或放量采集）可调用 SDK 的 stopSession() 主动结束当前会话，让配置随新会话尽快生效。
• 协议还预留了「前台刷新」（refresh_on_foreground）开关：开启后客户端每次回到前台时重新拉取配置，而非等待轮询。默认关闭——所有客户端集中在回前台的时刻请求配置，形同发布 herd，会冲击配置端点，仅适合确实需要分钟级生效的应用。该开关暂不可在控制台设置，将随后续版本开放。

​

版本历史与采用情况

• 变更历史保留最近 50 个版本，更早的版本将自动清理且无法回滚。每条历史展示操作人与变更说明（如填写）。你可以将任一保留中的历史版本回滚为当前配置，回滚同样会生成新版本。
• 回滚产生的新版本带内容等价标注：若其配置内容与历史上某个更早版本完全相同，历史列表会标注该版本与那个最早相同内容的版本等价——版本号跳变不代表配置内容发生了变化。
• 发布面板按最近到达的采样会话展示采用情况与采用进度，状态标签为「等待新会话」（刚发布，尚无会话按当前版本开始）、「生效中」（部分会话已切换）、「最近会话已切换」（窗口内到达的会话均已在当前版本）、「未收到配置」（最近会话均未上报配置版本，常见为 SDK 未开启远程配置或版本过低）、「暂无数据」（窗口内暂无新会话）、「未检测到生效」（发布已超过约 8 小时仍未切到当前版本）；进度条中未上报配置版本的会话段标为「未上报」（SDK 版本过低或尚未拉取过配置）。点击查看明细可跳转到事件浏览器查看这批样本会话。窗口内采样会话少于 20 条时，面板只展示实际会话数、不估算占比（占比由采样率放大估算，样本过少时结果没有意义）。

​

删除应用

​

下一步