FAQ
本页汇总使用 Bonree ONE 时最常见的问题。建议先确认当前选择的环境、资源域和时间范围，再按问题分类进行排查。
平台与账号
Bonree ONE 是什么？
Bonree ONE 是一体化智能可观测平台，用于统一采集和关联用户体验、应用服务、日志、调用链、基础设施、网络、事件与告警等数据。您可以通过统一视图发现异常，并结合拓扑、指标、日志和调用链定位问题。更多介绍请参见 Bonree ONE 是什么。
Bonree ONE 支持哪些部署方式？
平台支持公有云 SaaS 服务和私有化部署。公有云账号需通过 Bonree 官网或服务热线申请；私有化部署由 Bonree 团队根据部署规模和资源需求协助实施。中国内地与其他地区的公有云平台相互隔离，请使用申请账号时对应的平台地址登录。详情请参见 账户开通。
主账户和 IAM 用户有什么区别？
主账户代表一个租户，是 License、环境、用户和权限的管理主体，默认具备平台管理权限。IAM 用户是组织成员使用的平台账号，其可见功能和数据范围由角色、环境和资源域共同决定。
IAM 用 户登录时需选择 IAM 用户登录，并填写所属主账户及 IAM 用户的登录信息；使用主账户登录模式无法识别 IAM 用户。详情请参见 创建和管理 IAM 用户。
如何快速找到需要的功能？
打开应用中心后，输入功能名称或关键词进行检索。您还可以收藏高频菜单，将其固定到左侧导航；最近访问的功能会自动显示在“最近使用”区域。平台支持切换新旧导航模式，详情请参见 导航使用。
IAM 用户无法登录或提示已冻结，怎么办？
请联系主账户管理员在 IAM 用户列表中确认账号状态。管理员可执行重置密码、解冻或修改用户信息等操作。如果平台启用了“超期未登录用户冻结”，长期未登录的 IAM 用户会被自动冻结，解冻后才能重新登录。详情请参见 安全设置。
权限、环境与资源域
环境、资源域和角色分别控制什么？
| 概念 | 控制内容 | 使用建议 |
|---|---|---|
| 环境 | 租户内的数据隔离范围，不同环境的数据相互隔离 | 可按生产、测试或独立业务单元划分 |
| 资源域 | 单个环境内的数据查询范围，通过标签条件收纳资源 | 用于更细粒度的数据权限管理 |
| 角色 | 用户可访问的功能以及可执行的操作 | 可使用 Viewer、Create、Admin 预置角色，也可自定义角色 |
为用户授权时，环境和资源域决定能看到哪些数据，角色决定能使用哪些功能以及能执行哪些操作。详情请参见 资源域概念与使用 和 认识 ONE 的角色概念。
登录后看不到菜单或数据，如何排查？
按以下顺序检查：
- 确认用户已绑定至少一条权限策略；没有权限策略的 IAM 用户无法查看受控功能和数据。
- 确认角色包含目标菜单及所需的查看、创建或编辑权限。
- 切换到数据所属的环境，并确认当前资源域包含目标资源。
- 将资源域切换为全部，查看用户有权限的所有资源域数据并集。
- 重新登录，使最新权限和数据范围生效。
管理员可在用户详情的“权限范围”中查看权限来源。详情请参见 为 IAM 用户配置权限。
资源已经上报，为什么在资源域中看不到？
资源域通过标签条件收纳资源。请确认资源携带的标签满足资源域的查询条件，同时确认当前页面选择了正确的环境和资源域。如果无需在环境内进一步隔离数据，可由管理员为用户授权预置的 Admin resource 资源域，以查看该环境下的全部资源。
环境之间数据完全隔离，平台暂不支持跨环境迁移历史数据。请在首次上报数据前完成环境规划，避免同一业务的历史数据分散在不同环境中。
一个用户加入多个 IAM 群组后，权限如何计算？
用户最终权限为个人权限与其加入的所有 IAM 群组权限的并集。人员职责变化时，建议通过调整群组成员关系统一变更权限，减少逐个用户配置的工作量。详情请参见 创建和管理 IAM 群组。
修改用户权限后，为什么用户被自动退出？
这是正常的安全机制。为保证权限调整立即生效，管理员修改用户权限后，正在登录的对应用户会被自动退出；用户重新登录后将按新权限使用平台。
License 与用量
功能不可用或数据停止上报，是否与 License 有关？
可能有关。请前往 License 管理检查对应计费项是否已导入、是否在有效期内、是否已经超量，以及当前环境是否已分配配额。License 过期或超量会导致对应计费项不可用。详情请参见 License 申请。
License 的“默认分配”和“自定义分配”有什么区别？
- 默认分配：所有环境共享计费项总量，用完为止。
- 自定义分配：为一个或多个环境设置独立上限；未被分配配额的环境无法使用该计费项。
切换为自定义分配前，请确认所有需要继续上报数据的环境均已分配配额。详情请参见 配额管理。
导入多个 License 后，配额如何计算？
同一计费模块下的相同计费项会叠加；不同模块的计费项可同时生效、互不影响。计费项总量可能因其中某个 License 到期而下降，请同时关注到期提醒。
用量统计是实时的吗？
不是。用量由各计费组件按计费周期上报后汇总，存在一定 延迟。用量统计适合查看趋势、配额风险和后续对账，不建议作为实时故障排查的唯一依据。详情请参见 用量统计。
为什么月活消耗量不是所选时间范围内的设备去重数？
月活按自然月统计。选择跨月时间范围时，页面展示的是范围内各自然月月活数量之和，而不是将整个时间范围内的设备 ID 统一去重后计算出的数量。
数据接入与业务观测
SmartAgent、SmartGate 和 ONE SDK 分别用于什么场景？
| 组件 | 主要用途 |
|---|---|
| SmartAgent | 采集服务端应用、主机、进程、容器和网络等可观测数据 |
| SmartGate | 集中采集、数据流控以及云和虚拟化环境监控 |
| ONE SDK | 采集 Web、移动端等终端应用的真实用户体验数据 |
具体能力请参见 Bonree Agent。
完成探针或数据源配置后仍看不到数据，如何排查？
- 确认探针、SDK 或数据接入任务处于正常运行状态。
- 确认对应 License 计费项有效且未超量。
- 确认数据上报到了当前选择的环境。
- 确认资源标签满足当前资源域条件，或将资源域切换为全部。
- 调整页面时间范围，避免因采集延迟或时间窗口过短遗漏数据。
如果仅部分用户看不到数据，而主账户可以看到，通常应优先检查用户的数据权限和资源域配置。
业务链路卡片和拓扑节点的颜色代表什么？
绿色表示链路或节点处于正常监控状态；红色表示当前存在告警或异常状态。卡片中的关键指标用于快速判断链路健康情况，点击链路下钻后可查看节点状态、持续中告警和异常实体等信息。
是否支持同步第三方数据源中的链路图？
支持。管理员可配置外部数据源及同步地址，通过外部数据同步将第三方链路图同步到业务观测。同步前请确认数据源配置有效；同步过程中不要关闭弹窗或刷新浏览器，同一账号一次只能执行一个同步任务。详情请参见 分析业务观测。
如何从业务链路继续定位根因？
进入异常业务链路并点击下钻，先通过关键指标、持续中告警和异常实体判断影响范围，再在拓扑中定位红色异常节点。点击异常节点后，可继续关联分析指标、接口、告警、日志、调用链和调用关系，逐步缩小问题范围。详情请参见 分析业务观测。
告警与通知
已经产生告警，为什么没有收到通知？
告警规则产生告警并不代表一定会发送消息。请依次确认：
- 告警规则已启用，且生效时间和检测范围正确。
- 告警规则已关联通知策略；未关联时告警仅记录、不发送通知。
- 通知策略的过滤条件能够匹配当前告警。
- 通知渠道已启用，接收人或接收组信息完整有效。
- 当前规则或通知策略未处于告警屏蔽时段。
如何减少重复告警和非业务时段的通知干扰？
在通知策略中配置聚合规则、重复通知间隔和最大通知次数；维护、发布或压测期间，可按告警规则或通知策略创建临时屏蔽。屏蔽结束后建议及时检查规则状态，避免遗漏真实异常。详情请参见 告警屏蔽。
排查问题时建议记录平台版本、当前环境、资源域、时间范围、异常对象名称和告警时间。上述信息有助于管理员或技术支持快速复现和定位问题。