一、产品概述
运营分析把分散在 CMDB、监控、告警、日志及业务系统中的多源数据，整合到同一分析空间，用仪表盘、拓扑图、架构图、大屏、报表五种载体表达，帮助团队从”看见数据”走到”理解关系、发现风险、支撑决策”。它把分析串成一条线：接数据 → 搭载体 → 看 / 定位 → 沉淀复用。
主要功能入口：
- 视图（View）：主工作台。左侧目录树组织分析资产，右侧编辑 / 查看仪表盘、拓扑图、架构图。
- 管理 / 设置（Settings）：数据源管理、命名空间管理（多为管理员使用）。
边界说明： 数据来自 CMDB / 监控 / 告警 / 日志等模块（平台已内置对应数据源）；组织与权限由 系统管理 维护。运营分析适合“统一观察、关系表达、专题复盘与决策支撑”，超大规模实时计算 / 复杂算法建模建议结合专门数据平台。
二、核心概念与术语
| 概念 | 说明 |
|---|---|
| 目录 | 树形组织分析资产，最多 3 层；同父目录下名称不可重复 |
| 仪表盘 / 拓扑图 / 架构图 / 大屏 / 报表 | 五种分析对象：看指标趋势 / 看关系与状态 / 看资源结构 / 做监控中心大屏 / 做周期性报表 |
| 内置视图 | 平台预置的目录、仪表盘、拓扑图、架构图；可直接查看和参考，但不建议直接当作业务专用页面使用 |
| 数据源 | 一条取数配置，可按 NATS、MySQL、PostgreSQL、REST API、Excel、Prometheus 等页面支持的方式接入，并配置参数模板、可用图表类型和标签 |
| 连接库 | 由管理员集中维护并复用数据库或 REST 连接，避免多个数据源重复填写连接凭据 |
| 命名空间 | 一个数据入口连接（经 NATS），含域名、账号、密码、TLS 开关 |
| 参数模板 | 数据源所需参数，分”固定值”（配置时定死）与”可编辑值”（使用者在页面调） |
| 值映射 | 把原始值按规则显示成更容易理解的文字或颜色，例如把状态码映射为”正常/异常” |
| 单位格式 | 统一控制数值显示单位，如字节、百分比、速率、时长等，减少人工换算 |
| 统一筛选 / 全局时间 | 仪表盘画布级的统一筛选项，可联动驱动多个组件刷新 |
| 画布订阅（报告订阅） | 在仪表盘 / 大屏查看页，按周期把当前画布渲染为 PDF，并通过邮件发送；界面入口名称为「画布订阅」 |
| 组织（团队） | 数据与权限的归属单元。分析资产与数据源按组织隔离。由 系统管理 维护 |
常见技术名词速查（在后文看到不懂的词，回这里查）：
| 名词 | 通俗解释 |
|---|---|
| NATS | 平台用的消息总线；命名空间通过它连接不同区域的数据入口，实现”边缘自治、中心可见” |
| TLS | 加密连接开关；生产环境的命名空间建议开启 |
| 直连数据源 | 管理员可直接接入 MySQL、PostgreSQL、REST API 或 Excel 数据，让外部结果直接进入分析画布 |
| 内置数据源 / 数据源标签 | 平台预置的 CMDB / 告警 / 监控 / 日志 / 业务 / 其他 数据源与标签，开箱即用 |
原理提示： 普通用户多数场景直接使用平台内置数据源与命名空间即可，无需改底层。需要扩展时，管理员可按产品页面配置当前支持的数据源，并可通过「连接库」复用数据库或 REST 连接；是否允许、可填字段和预览方式，以页面实际显示为准。
三、五种分析载体与数据接入
五种分析载体（按表达目标选）：
| 载体 | 用途 | 常用元素 |
|---|---|---|
| 仪表盘 | 指标趋势观察、日常巡检、专题运营 | 折线图、柱状图、饼图、单值图、排行榜、表格、仪表盘、事件表格 + 全局时间 / 统一筛选 |
| 拓扑图 | 关系定位、故障影响范围、运行态观察 | 图标 / 文本 / 单值 / 图表节点 + 连线（支持数据绑定与定时刷新）；可叠加「网络状态拓扑」专用组件 |
| 架构图 | 系统架构展示、资源盘点、变更沟通 | 平台 / CMDB / 云资源图标 + 分层边界（偏静态） |
| 大屏 | 监控中心、运营驾驶舱、对外展示屏 | 仪表盘组件 + 画布级统一筛选；可叠加「3D 机房」专用组件 |
| 报表 | 周报 / 月报 / 周期性业务统计 | 表格 + 图表 + 时间范围筛选；适合定期导出与归档 |
数据接入（多为管理员）： 可按产品页面提供的数据源类型配置取数。NATS 类通常通过命名空间连接不同区域的数据入口；数据库、REST API、Excel、Prometheus 等类型更适合接入专题分析数据。MySQL、PostgreSQL、REST 连接可先进入「设置 → 连接库」集中维护，再由数据源复用。单个数据源可关联多个命名空间，平台会按页面配置汇总返回；现场可用的数据源类型与参数项，以产品页为准。
数据转换边界： REST API 与 Excel 数据源可按需启用数据转换，把原始结果整理成组件可用结构。转换脚本属于受控高级能力，应先用预览确认输入输出，不要在脚本中固化密钥、动态地址或与当前环境绑定的临时值；可用语法和资源限制以产品内说明为准。
Excel 数据源限制： 导入文件仅支持
.xlsx，单文件不超过 2 MB；超过限制的 Excel 请先在客户端做拆分或转为数据源服务。数据库预览限制： 数据库类（MySQL / PostgreSQL）数据源在保存前预览时，只允许单条 SELECT 或按表限量拉取，不会把整表一次性拉到平台。请勿依赖预览页查全表。
普通用户优先使用内置数据源；真实连接参数以产品「设置 → 数据源 / 命名空间」页为准。
四、通用流程
- 规划目录： 视图 → 左侧目录树 → 新建目录（按业务域 / 专题 / 团队组织，≤3 层）。
- 建分析对象： 在目标目录新建 仪表盘 / 拓扑图 / 架构图 / 大屏 / 报表（首次建议先从仪表盘验证数据）。
- 配组件 / 画布： 仪表盘添加组件 → 选数据源（优先内置）→ 按参数模板补参数 → 选图表类型；拓扑 / 架构图拖拽节点、连线、按需绑定数据。
- 保存验证： 保存后切换查看模式，确认数据正确、权限可见范围符合预期。
- （可选）调整网络状态拓扑布局： 进入布局编辑模式，移动节点后保存；系统按当前展示模式分别保留布局。需要恢复时使用“重置布局”，不要通过删除组件清空布局。
- （可选）画布订阅： 在仪表盘 / 大屏查看模式，点工具栏「画布订阅」，配置接收邮箱、邮件渠道与发送周期；可用「立即测试」验证投递。大屏支持在订阅前显式刷新快照；拓扑图、架构图、报表画布暂不支持。
关于“普通用户 vs 管理员”： 看数据、搭页面用内置数据源即可，无需进设置页改底层。只有接入新业务系统、新增区域 / 集群、调参数模板等场景，才需管理员扩展数据源 / 命名空间。画布订阅依赖组织内已配置的邮件渠道（见 系统管理），渠道未就绪时无法创建订阅。
关于入口名称： 部分界面中的英文 View / Settings 即「视图 / 设置」，按本指南中文名对应即可。
五、新手第一课：5 分钟做出第一个有数据的仪表盘
第一次使用，建议用内置数据源做一个仪表盘，验证平台能支撑你的分析表达。
第 0 步：先确认两件事。 ① 你属于哪个组织、对要用的数据源所属团队有查看权限（不清楚问管理员）；② 平台已内置 CMDB / 监控 / 告警 / 日志 等数据源，开箱即用，无需自己配。
第 1 步：建目录与仪表盘。 进入 视图，在左侧目录树新建一个目录（如「稳定性总览」），在其上点「新建仪表盘」，填名称进编辑页。
第 2 步：加一个组件。 点画布「添加组件」，在配置面板选一个内置数据源；系统自动加载它的参数模板。
第 3 步：填参数、选图表。 按模板补必要参数（如时间范围、对象范围），选图表类型（趋势用折线、关键值用单值）。
第 4 步：保存验证。 点「保存」，切到查看模式，看到数据即表示成功。
若没数据，按顺序排查： ① 数据源是否已启用；② 参数（尤其时间范围）是否填对；③ 你是否有该数据源所属团队的查看权限；④ 命名空间连接是否正常（咨询管理员）。
下一步： 想表达依赖关系 / 系统结构，建拓扑图 / 架构图；内置数据源不够用时，请管理员在 设置 → 数据源 / 命名空间 扩展（见第八章）。
六、产品介绍
一、产品简介
WeOpsX 运营分析是面向轻量级运维场景打造的统一数据可视化与运营决策工作台。它将分散在 CMDB、监控、告警、日志及业务系统中的多源数据整合到同一分析空间，通过仪表盘、拓扑图、架构图三种分析载体，帮助团队实现从「看见数据」到「理解关系、发现风险、支撑决策」的完整分析闭环。基于命名空间机制，运营分析还可以连接不同区域的 NATS 数据入口，在多地域 WeOpsX 通过 NATS 组网后，由主区域统一汇聚和展示各边缘区域数据，形成“边缘自治、中心可见”的分析能力。
与传统报表工具不同，WeOpsX 运营分析更关注分析资产的长期沉淀与团队协同复用：
- 目录化管理：支持以树形目录组织仪表盘、拓扑图和架构图，让分析成果按业务域、专题和场景有序沉淀
- 多源数据融合：单个数据源可关联多个命名空间，平台自动并行拉取并聚合返回，即使个别数据源异常也不影响整体分析
- 边缘自治组网：可通过命名空间连接不同区域的 NATS 服务，在各区域 WeOpsX 保持本地自治的同时，由主区域统一获取并展示跨区域数据
- 安全可控共享：结合细粒度权限控制与组织维度数据隔离，让分析资产既能跨团队共享，也能在安全边界内可控访问
二、核心优势
- 统一数据分析入口：通过数据源与命名空间管理能力，把 CMDB、监控、告警、日志及业务接口统一纳入同一工作台，告别多系统来回切换的信息割裂
- 五种分析载体协同表达：同一分析空间内同时支持仪表盘（指标趋势）、拓扑图（关系定位）、架构图（资源结构）、大屏（监控中心 / 驾驶舱）、报表（周期归档），覆盖从观察到决策的完整分析链路
- 目录化资产沉淀：支持多层级目录组织分析资产，让临时报表进化为可长期复用的团队知识库，避免分析成果散落在个人页面中
- 智能数据聚合机制：多命名空间并行取数，单点异常自动降级，请求自动携带用户与团队上下文，保障数据权限语义一致性
- 边缘自治与中心汇聚兼得：通过命名空间绑定不同区域 NATS，主区域可在不破坏各边缘区域独立运行的前提下统一获取和展示多地域数据
- 企业级安全接入：命名空间支持 TLS 加密连接、密码 AES 加密存储，满足企业级数据安全与合规要求
- 开箱即用的内置能力：系统预置 CMDB、告警、监控、日志、业务等数据源标签和常用数据模板，降低初次使用门槛
三、核心能力全景
1. 目录化的分析工作台
采用左侧目录树 + 右侧内容区的经典双栏布局，统一管理目录、仪表盘、拓扑图、架构图四类分析对象。支持按业务系统、运维专题或治理目标建立最多 3 层目录结构，让分析内容具备清晰的归属关系，便于团队协同与资产复用。
2. 面向指标观察的仪表盘
基于网格自由布局组合多种可视化组件，支持折线图、柱状图、饼图、单值图等图表类型。通过全局时间选择器和公共过滤条件，可统一驱动多个组件联动刷新，适合承载日常巡检、专题运营和趋势对比等场景。
3. 面向关系定位的拓扑图
提供可视化画布用于表达对象关系、依赖链路和节点状态。支持图标节点、基础图形、文本节点、单值节点、图表节点等多种节点类型，可配置连线、标签和样式，并支持节点级数据绑定与定时刷新，让拓扑图从静态结构图升级为动态状态观测画布。
4. 面向资源表达的架构图
专为系统架构展示、资源盘点和变更沟通设计。支持平台资源、CMDB 图标及多类云资源图标，可在同一画布中组织视图、颜色和结构层次，帮助技术与非技术角色快速建立共同理解。
5. 灵活的数据源与命名空间管理
- 数据源管理：定义 REST API 取数路径、参数模板（支持字符串、数字、布尔、日期、时间范围类型）、可用图表类型和数据源标签
- 命名空间管理：维护连接地址、账号、TLS 开关等连接信息，支持密码加密存储与生命周期管理
- 一对多关联：单个数据源可关联多个命名空间，实现跨环境、跨域数据统一分析
注意：
运营分析更适合承担「统一观察、关系表达、专题复盘与决策支撑」的角色。对于超大规模实时计算或复杂算法建模场景，建议结合专门的数据平台协同使用。
四、典型应用场景
1. 运营全景总览
将资源变化、告警趋势、服务状态和业务关键指标整合进统一工作台。通过仪表盘集中呈现关键指标，通过拓扑图展示对象关系，帮助值班人员与管理层在同一视图下建立一致认知，快速把握系统整体健康度。
2. 故障影响范围定位
当核心服务异常时，单一指标往往难以说明影响范围。通过拓扑图组合单值节点与图表节点，处理人可以直观看到异常节点、上下游依赖和关联状态变化，辅助判断故障是局部波动还是链路级影响，缩短 MTTR。
3. 架构盘点与变更沟通
将分散在文档、表格和脑图中的架构信息统一沉淀为可维护的架构图。便于技术团队复盘资源关系，也便于向非研发角色汇报系统结构与变更影响边界，提升跨团队协作效率。
4. 团队分析资产沉淀
通过目录化组织和权限控制，把例行巡检看板、专题分析页、架构对照图逐步沉淀为团队公共资产，形成可继承、可复用、可持续优化的运维分析体系，避免人员变动导致的知识流失。
五、为什么选择 WeOpsX 运营分析
| 维度 | 传统报表工具 | WeOpsX 运营分析 |
|---|---|---|
| 数据整合 | 单源数据展示 | 多命名空间聚合，请求自带权限上下文 |
| 分析表达 | 单一图表类型 | 仪表盘+拓扑图+架构图，覆盖多元场景 |
| 资产管理 | 个人页面散落 | 目录化组织，支持 3 层层级沉淀 |
| 协作共享 | 权限控制粗放 | 细粒度操作权限 + 组织维度数据隔离 |
| 安全接入 | 基础连接能力 | TLS 加密 + 密码加密存储 + 启停管理 |
对于希望快速建立统一运营分析入口、或已有多个数据系统但缺少统一表达方式的团队，WeOpsX 运营分析提供了一套开箱即用、可持续演进的轻量级解决方案。它不是一页孤立的看板，而是能够陪伴团队持续成长的运营分析工作台。
七、功能介绍
1. 分析视图（View）
分析视图是运营分析的主工作台，采用左侧目录树 + 右侧内容区的双栏布局，负责承载目录管理、分析对象切换和具体内容展示。相比单页报表工具，WeOpsX 运营分析更强调「资产化管理」，让团队能够围绕业务场景持续沉淀可复用的分析资产。
1.1 目录与分析资产管理
核心定位
目录是分析资产的组织载体，决定了团队如何沉淀内容、如何共享页面，以及如何把临时分析转化为长期可复用资产。平台通过树形目录统一管理目录、仪表盘、拓扑图、架构图、大屏、报表六类对象，支持多层级结构，便于按业务域、专题或职责范围进行组织。
核心能力
- 统一树形组织：在同一目录树中统一管理多类分析对象（仪表盘 / 拓扑图 / 架构图 / 大屏 / 报表），避免内容散落在多个孤立页面
- 三级层级约束：目录层级上限为 3 层，在灵活性与可维护性之间取得平衡
- 同父目录唯一性：同一父目录下目录名称唯一，防止命名冲突导致的检索困难
- 就地创建与维护：支持在目录树中直接新增、编辑、删除目录和分析对象，减少页面切换成本
- 删除保护机制：目录下存在子对象时不可直接删除，避免误操作破坏已沉淀的分析结构
- 未保存变更提醒：切换分析对象或离开页面时，系统对未保存变更进行二次确认，防止编辑成果丢失
- 启用/停用控制：目录支持状态管理，停用后不在目录树中展示，便于软删除与归档
- 内置视图保护：系统预置的内置目录、仪表盘、拓扑图、架构图可作为参考基线，但不建议直接修改；如要长期使用，建议复制后再按本团队场景调整
界面指引：
当前建议补充「目录树与内容区」截图，展示左侧目录树、右侧内容区以及仪表盘/拓扑图/架构图的切换关系。
- 图表解读：目录树不是简单导航栏，而是分析资产的管理入口。通过目录层级与权限配置，实现分析成果的团队级沉淀与可控共享。
1.2 仪表盘
核心定位
仪表盘是面向指标观察的核心载体，适合承载资源总览、趋势对比、专题观察等场景。基于网格布局自由组合多种可视化组件，是运营分析中最适合做日常巡检和运营总览的展示形态。
核心能力
- 网格化自由布局：支持拖拽调整组件位置与大小，灵活组织页面结构
- 多图表类型支持：
- 折线图：适合趋势观察、时序对比
- 柱状图：适合分类对比、排名展示
- 饼图：适合占比分析、构成展示
- 单值图：适合关键指标、核心状态展示
- 排行榜：适合看 TopN 排名和波动
- 表格：适合明细列表、事件清单、记录型结果展示
- 仪表盘：适合表达阈值、利用率和等级区间
- 事件表格：适合展示事件流、告警明细、记录清单
- 卡片列表、雷达图、事件时间线、关系拓扑：适合概览卡片、多维对比、事件过程和关系网络；具体可选组件以当前页面为准
- 专用场景组件：
- 网络状态拓扑： 走专用场景组件入口，按已勾选设备形成闭集拓扑，自动复用配置管理中的网络拓扑与实例权限，并叠加 告警中心 当前活跃告警，适合在网络类场景直接展示“拓扑 + 状态”。节点数量上限以页面提示为准
- 3D 机房： 在大屏场景叠加 CMDB配置管理 中已维护的机房布局、机柜摆放和设备 U 位占用，并按机柜类型（计算 / 网络 / 存储 / 安全 / 其他 / 未分类）显示图例与机柜顶贴图——前提是配置管理中已维护好机房 / 机柜 / 设备位置数据，并在机柜实例上正确填写机柜类型
- 画布级统一筛选（关键字 + 时间范围）： 仪表盘与大屏画布上可配置统一的”关键字 + 时间范围”筛选条件，一处配置联动整张画布刷新；参数生效优先级：固定参数 > 统一筛选参数 > 组件私有参数 > 数据源默认参数——同一参数多处出现时按这个顺序解析，避免”配了不生效”
- 全局时间驱动：当页面包含时间型参数时，可通过顶部全局时间选择器统一驱动多个组件联动刷新，便于跨指标横向对比
- 数据源模板复用：组件配置时可复用数据源中定义的参数模板，自动识别固定值、可编辑值等参数类型，降低重复配置成本
- 公共过滤条件：支持配置页面级公共过滤器，统一作用于页面内多个组件
- 值映射与数值格式：可把原始值转换为更直观的文字、颜色和单位展示；趋势图、柱状图、饼图等组件也可按页面配置进制换算和小数位数
- 表格列可预设：表格类页面既可按返回结果自动成列，也可由管理员预设常用列和列名
- 保存与周期刷新：仪表盘、大屏、拓扑图、网络拓扑提供统一的手动刷新与周期刷新控件。周期刷新时保留当前数据，待新结果返回后更新，减少值班大屏闪烁；可选间隔以页面为准
- 仪表盘链接分享：查看自己有权管理的仪表盘时，可通过「分享」生成并复制访问链接，便于临时审阅或跨团队沟通
- 画布订阅：在查看模式工具栏点击「画布订阅」，可为当前仪表盘或大屏创建邮件订阅。支持每天 / 每周 / 每月发送，也可先选「暂不调度（仅手动测试）」；创建时会带上当前画布的统一筛选口径。可用「立即测试」验证投递，也可用「更新快照」把后续执行刷新为当前筛选。输出为 PDF 邮件附件，每个订阅对应一个接收邮箱
界面指引：
当前建议补充「仪表盘编辑页」截图，展示网格布局、组件配置面板、全局时间选择器区域。
- 图表解读：仪表盘的价值在于将零散指标组织成可读的运营视图，通过时间轴对齐和布局编排，帮助用户快速建立对系统状态的宏观认知。
1.3 拓扑图
核心定位
拓扑图是面向关系定位的核心载体，用于表达对象之间的连接关系、依赖链路和状态分布。当问题不仅体现在数值变化，还需要理解「问题在哪里、与谁相关、影响范围多大」时，拓扑图比纯数字看板更能帮助处理人建立问题上下文。
核心能力
- 五类节点灵活编排：
- 图标节点：使用预设图标表达资源类型
- 基础图形：矩形、圆形等几何图形表达抽象节点
- 文本节点：纯文本说明与标注
- 单值节点：绑定数据源展示关键指标数值，支持阈值配色
- 图表节点：在节点内嵌迷你图表，展示趋势变化
- 连线与标签表达：支持配置有向/无向边、边标签、线型样式，用于描述上下游依赖、网络路径或逻辑关联
- 节点级数据绑定：单值节点和图表节点可绑定数据源，让拓扑图具备动态状态表达能力
- 定时自动刷新：支持配置刷新频率（如 30 秒、1 分钟），让关键状态持续更新
- 编辑辅助工具：
- 缩放与适配画布：支持放大缩小、一键适配可视区域
- 撤销重做：编辑操作可回溯，降低误操作成本
- 迷你图浏览：画布缩略图辅助定位，便于在大图中快速导航
- 右键菜单：节点与画布右键菜单提供快捷操作
界面指引：
当前建议补充「拓扑图编辑页」截图，展示左侧节点工具栏、中间画布区域、右侧属性编辑面板。
- 图表解读：拓扑图的核心价值在于「结构与状态同屏可见」。通过节点、连线、数据绑定的组合，把原本需要多张图表才能表达的信息浓缩在一张画布中。
1.4 架构图
核心定位
架构图是面向资源结构表达的专用载体，适合用于系统架构展示、资源盘点、方案评审和变更前后的结构对比。相比拓扑图关注动态关系，架构图更关注静态资源结构的清晰表达。
核心能力
- 多资源图标体系：
- 平台资源图标：WeOpsX 内置平台组件图标
- CMDB 图标库：与配置管理联动的资源图标
- 云资源图标：支持 AWS、阿里云、腾讯云等多类云资源图标
- 统一画布编排：在同一画布中组织视图、图标、颜色和结构层次，支持分层展示不同类型资源
- 结构克隆与复用：架构图配置可保存为模板，类似场景可快速复制改编
- 跨角色沟通友好：图形化表达降低理解门槛，适合技术评审、管理汇报等需要多方协作的场景
- 版本化维护：架构图作为长期资产可持续维护更新，避免每次评审都从零绘制
界面指引：
当前建议补充「架构图编辑页」截图，展示图标库、画布编排区域、属性配置面板。
- 图表解读：架构图帮助团队把「脑中的架构」转化为「可见的图纸」，是技术债务盘点、上云规划、架构评审等场景的有效沟通工具。
1.5 大屏
核心定位
大屏是面向监控中心、运营驾驶舱、对外展示屏的核心载体，适合用大尺寸屏幕做”一屏总览 + 持续刷新”的场景。与仪表盘相比，大屏更强调画面冲击力和画布级筛选统一性。
核心能力
- 画布级统一筛选（关键字 + 时间范围）： 见 §1.2 仪表盘章节”画布级统一筛选”说明，参数优先级一致（固定参数 > 统一筛选参数 > 组件私有参数 > 数据源默认参数）
- 3D 机房专用组件： 叠加 CMDB配置管理 的机房 / 机柜 / 设备位置数据，展示机柜摆放、U 位占用和设备摘要，并按机柜类型显示图例与机柜顶贴图——前提是配置管理中已维护机房 / 机柜 / 设备位置数据，并在机柜实例上正确填写机柜类型
- 网络状态拓扑组件： 见 §1.2 仪表盘章节”专用场景组件”，可在大屏画布中直接摆放
- 大屏适配的画布与排版： 支持更高分辨率画布、组件全屏铺满，适合在 2K / 4K 大屏展示
- 画布订阅： 与仪表盘共用同一套「画布订阅」能力。在大屏查看模式工具栏打开「画布订阅」，可按周期把当前大屏渲染为 PDF 并邮件发送；支持手动测试与快照更新
使用提示
大屏中如要叠加 3D 机房，请确认 CMDB配置管理 中机房、机柜、设备位置数据完整且机柜类型已填写；如要叠加网络状态拓扑，请确认配置管理中已纳管目标网络设备且资产实例已建模。
1.6 报表
核心定位
报表是面向周报 / 月报 / 周期性业务统计的专用载体，适合”定期跑数据、定期归档、定期发出去”的场景。与仪表盘相比，报表更强调结构化输出与时间范围归一。
核心能力
- 结构化布局： 表格 + 图表 + 时间范围筛选在同一画布中组织，适合按”周期 + 维度”生成可读文档
- 时间范围归一： 可锁定时间范围（如”本月””上一季度”）作为参数默认值，避免每次手选
- 导出与归档： 支持导出为可外发格式，便于归档与跨团队同步
使用提示
报表参数建议优先使用固定参数锁住时间范围；临时手动调整可走”统一筛选参数”或”组件私有参数”覆盖。
与「画布订阅」的区别： 此处的「报表」是一种分析画布类型；「画布订阅 / 报告订阅」是把仪表盘或大屏按周期渲染为 PDF 并邮件发送的能力。当前报表画布暂不支持画布订阅。
2. 设置中心（Settings）
设置中心用于管理运营分析的底层接入能力，决定页面能连什么数据、如何连以及谁可以用。它不是附属配置页，而是整个分析工作台可用性和复用性的基础。
2.1 数据源管理
核心定位
数据源管理解决的是「数据从哪里来、如何被复用、适合以什么方式展示」的问题。它将取数路径、参数模板、标签归类、图表类型和归属团队统一纳入一个配置入口，是实现标准化分析资产的前提。
核心能力
- 多类数据源接入：支持按 NATS、MySQL、PostgreSQL、REST API、Excel、Prometheus 等页面提供的类型扩展数据
- Excel 限制： 仅支持
.xlsx，单文件不超过 2 MB - 数据库预览限制： MySQL / PostgreSQL 在保存前预览只允许单条 SELECT 或按表限量拉取，不会把整表拉到平台
- Excel 限制： 仅支持
- 数据源字段 schema 化 + 预览回填： 数据源级可维护默认返回字段结构（字段名、显示名、类型、描述、排序），预览成功后可一键回填到字段 schema；表格组件优先采用数据源字段定义，配表头时不必逐列手动调整
- 多命名空间关联：单个数据源可关联多个命名空间，实现跨环境、跨域取数后统一汇总展示
- 参数模板配置：支持五类参数类型：
- 字符串：文本型过滤条件
- 数字：数值型参数
- 布尔：开关型参数
- 日期：日期选择器
- 时间范围：时间段选择器，常用于全局时间驱动
- 参数值类型：支持固定值（不可编辑）与可编辑值（用户可调整）两种模式
- 图表类型约束：可为数据源限定可用图表类型，如折线图、柱状图、饼图、单值图、排行榜、表格、仪表盘、事件表格，帮助页面设计者快速选择合适展示方式
- 表格默认列定义：可为表格类数据源预设默认列、列名与显示顺序，减少每个页面重复配置
- 标签化治理：支持关联多个数据源标签（如 CMDB、监控、告警、日志、业务、其他），便于后续检索、筛选和权限控制
- 团队归属控制：可为数据源配置归属团队，实现组织维度的数据可见性隔离
- 启用状态管理：支持启用/停用切换，停用后不可在新建组件时选用，但不影响已配置的历史组件
- 保存前预览：支持在保存前做连接测试或样例预览，便于先确认数据结构是否符合预期
- 连接库复用：MySQL、PostgreSQL、REST 连接可集中维护后供多个数据源引用；连接地址、账号和凭据以连接库页面为准，不在分析组件中重复固化
- 可选数据转换：REST API 与 Excel 数据源可在预览阶段按需转换结果；转换失败时保留原配置供修改，不应把未验证的结果直接用于生产大屏
界面指引：
当前建议补充「数据源列表与编辑抽屉」截图，展示名称、REST API、命名空间关联、标签选择、图表类型勾选和参数模板配置区域。
- 图表解读：数据源页的本质是把零散接口能力沉淀成标准化分析资产。配置越规范，后续仪表盘和画布的复用成本越低。
2.2 命名空间管理
核心定位
命名空间管理用于维护外部数据环境的连接上下文，解决的是「平台通过什么连接方式访问外部数据能力」的问题。每个命名空间代表一个独立的数据环境，如不同集群、不同区域或不同业务线的数据入口。
核心能力
- 连接信息统一维护：集中管理命名空间名称、NATS 命名空间（消息主题前缀）、账号、密码和域名信息
- TLS 安全连接：支持在命名空间级别启用 TLS（
tls://协议），满足企业级网络安全要求 - 密码加密存储： 命名空间密码在保存时自动进行 AES 加密，数据库中不存储明文；编辑命名空间时，前端密码框只回显掩码占位符，如未改动直接保存，平台会以 PATCH 形式保留原密码密文——所以”看到密码框空也别紧张，那是掩码而不是真的清空”
- 动态协议适配：系统根据
enable_tls字段自动选择nats://或tls://协议构建连接 URL - 连接容错机制：单个命名空间连接异常不阻断其他命名空间数据返回，保证分析页面可用性
- 生命周期管理：支持新增、编辑、删除和启用/停用状态管理，便于持续维护数据访问链路
- 多数据源复用：命名空间配置完成后，可被多个数据源重复引用，减少重复配置
界面指引：
当前建议补充「命名空间列表与编辑抽屉」截图，展示名称、NATS 命名空间、账号、密码、域名、TLS 开关等配置项。
- 图表解读：命名空间是数据接入的安全网关。TLS 支持与密码加密机制确保即使在外网环境也能安全访问内部数据能力。
八、操作指引（快速入门）
一、前置条件
在开始使用 WeOpsX 运营分析前，建议确认以下准备项：
- 平台账号与权限：已具备可访问 WeOpsX 平台的账号，并拥有运营分析模块的查看权限。如需创建分析资产，需额外申请目录、仪表盘或数据源等操作权限。
- 内置数据环境：平台默认已初始化内置命名空间和数据源标签（CMDB、告警、监控、日志、业务、其他），普通用户开箱即用，无需额外配置。
- 分析目标明确：建议提前明确本次希望验证的分析场景，例如：
- 资源总览类（用仪表盘展示主机、应用数量）
- 趋势分析类（用折线图展示告警趋势）
- 关系定位类（用拓扑图展示服务依赖）
- 架构表达类（用架构图展示系统结构）
- 团队归属确认：确认需要对哪些团队开放该分析资产，便于后续设置归属范围。
注意：
运营分析默认提供可直接使用的内置数据源与命名空间。普通用户无需进入设置页调整底层接入；仅当内置能力无法满足业务需求时，才建议由管理员补充或修改相关配置。
二、第一步：规划目录并创建分析资产
操作路径：视图 → 左侧目录树 → 「+」按钮或右键菜单
进入运营分析后，建议先在视图页规划目录结构，再创建具体的分析对象。合理的目录规划是后续资产沉淀和团队协作的基础。
2.1 推荐目录组织方式
| 组织维度 | 示例 | 适用场景 |
|---|---|---|
| 按业务域 | 电商 / 支付 / 履约 / 基础平台 | 多业务线独立运维 |
| 按分析专题 | 稳定性总览 / 容量治理 / 告警复盘 / 架构盘点 | 专题化运维分析 |
| 按团队职责 | 平台运维 / 业务运维 / SRE / 安全 | 职责边界清晰 |
2.2 创建目录的操作步骤
- 在视图页左侧目录树空白处或目标目录上右键，选择「新建目录」
- 填写目录名称（同父目录下名称不可重复）
- 填写描述信息（可选，建议填写便于后续理解目录用途）
- 点击保存，目录即创建成功
2.3 目录规划注意事项
- 层级控制：目录层级上限为 3 层，规划时注意控制深度，避免过度嵌套
- 命名规范：建议使用「业务域_场景」或「团队_专题」格式，如「电商_稳定性总览」
- 目录 vs 分析对象：目录适合放长期沉淀的分析主题，不要把一次性任务固化为独立层级
- 删除保护：目录下存在子目录或分析对象时不可直接删除，需先清空内容
- 内置内容处理方式：若要基于系统预置页面继续建设，建议复制后再改，避免把公共基线直接改成某个团队的专用页面
界面指引：
当前建议补充「视图页目录树」截图，展示左侧目录树、新建入口、右键菜单。
- 图表解读：目录树是团队分析资产的组织入口。先把目录结构规划清楚，后续新增的仪表盘、拓扑图和架构图才更容易复用与沉淀。
三、第二步：创建首个分析对象
使用前置条件
- 数据接入方式： 普通用户直接用平台内置数据源（CMDB / 监控 / 告警 / 日志 等），无需配置底层；仅当内置不满足时，由管理员在「设置」扩展数据源 / 命名空间（见第八章管理员扩展指南）。
- 权限： 需对所用数据源所属组织有查看权限；创建分析资产需目录 / 仪表盘 / 数据源等操作权限。
- 数据源： 组件绑定数据源后按其参数模板取数；若命名空间连接异常，数据会为空，可咨询管理员。
操作路径：视图 → 选择目标目录 → 点击「新建仪表盘」/「新建拓扑图」/「新建架构图」
如果是第一次验证，建议优先从仪表盘开始，因为它最适合快速确认内置数据源是否满足当前分析需求。如果你的目标是表达依赖关系或系统架构，可直接从拓扑图或架构图开始。
3.1 创建仪表盘（推荐首选）
步骤说明
- 进入创建页面：在目标目录上点击「新建仪表盘」，填写名称和描述后进入编辑页
- 添加第一个组件：
- 点击画布区域的「添加组件」
- 在组件配置面板中选择数据源（建议优先选择内置数据源）
- 系统会自动加载该数据源配置的参数模板
- 配置参数：
- 根据数据源模板补充必要过滤项（如时间范围、对象范围）
- 固定值参数会自动填充，可编辑参数需手动选择或输入
- 选择图表类型：根据数据特性选择合适图表：
- 折线图：趋势类数据（如告警数量随时间变化）
- 柱状图：分类对比类数据（如各业务线主机数量）
- 饼图：占比类数据（如告警级别分布）
- 单值图：关键指标（如总主机数、未恢复告警数）
- 状态时间线：适合展示状态切换过程（如正常、异常、恢复）
- 文本：适合展示页面说明、值班提示、口径说明
- 调整布局：拖拽组件调整位置和大小，组织成易读的页面结构
- 保存页面：点击顶部「保存」按钮，完成首个仪表盘创建
配置建议
- 优先使用内置数据源：平台已预置 CMDB、监控、告警等常用数据源，无需从零配置
- 控制页面复杂度：首个页面建议先做「最小可用版本」，验证数据正确性后再逐步丰富
- 启用全局时间：若页面包含多个时间型组件，建议启用全局时间选择器，便于统一筛选
- 状态值先做值映射：如页面里有状态码、布尔值、等级值，建议优先配置值映射，让页面直接展示“正常/异常”等用户易懂结果
- 统一单位表达：涉及容量、速率、百分比、时长的页面，建议优先使用平台提供的单位格式，减少手工解释
界面指引：
当前建议补充「新建仪表盘」截图，展示组件配置面板、数据源选择、参数填写、图表类型选择。
- 图表解读：快速入门阶段的重点不是搭底座，而是先用现成能力做出第一个可用页面，验证平台是否能支撑当前团队的分析表达需求。
3.2 创建拓扑图
适用场景
- 展示服务之间的调用关系
- 表达网络拓扑结构
- 定位故障影响范围
- 展示告警在系统中的传播路径
步骤说明
- 进入创建页面：在目标目录上点击「新建拓扑图」，填写名称和描述后进入画布编辑页
- 添加核心节点：
- 从左侧工具栏拖拽「图标节点」到画布，表示关键服务或资源
- 使用「文本节点」添加说明文字
- 建立连接关系：
- 选中节点，点击连接点拖拽到目标节点，创建连线
- 双击连线可添加标签（如调用关系、延迟数值）
- 绑定状态数据（可选）：
- 添加「单值节点」或「图表节点」
- 在属性面板中绑定数据源，配置阈值配色
- 设置刷新频率，让节点状态定时更新
- 优化布局：
- 使用「适配画布」按钮调整整体可视区域
- 使用「撤销/重做」调整不满意的操作
- 保存页面：点击顶部「保存」按钮
配置建议
- 先画最小可用图：首版只放核心节点（如网关、核心服务、数据库），验证思路后再扩展
- 善用标签：连线上添加标签说明关系类型，提升图谱可读性
- 动态节点聚焦：对需要重点监控的节点绑定单值数据源，用颜色区分健康状态
3.3 创建架构图
适用场景
- 系统架构评审与展示
- 资源盘点与上云规划
- 技术债务梳理
- 跨团队技术方案沟通
步骤说明
- 进入创建页面：在目标目录上点击「新建架构图」，填写名称和描述后进入画布编辑页
- 选择图标体系：
- 从左侧图标库选择合适图标（云资源、平台组件、CMDB 资源等）
- 拖拽到画布并调整位置
- 组织层次结构：
- 使用「基础图形」绘制分层边界（如网络层、应用层、数据层）
- 通过颜色区分环境（如生产环境红色、测试环境绿色）
- 添加说明元素：
- 使用「文本节点」添加分层说明、注意事项
- 使用连线和标签表达组件间关系
- 保存页面：点击顶部「保存」按钮
配置建议
- 先确定表达目标：明确是展示「逻辑架构」还是「物理部署」，避免同一张图承担过多目标
- 统一图标口径：同一类资源使用相同图标，保证团队内部表达一致
- 分层展示：跨云、跨平台场景建议分层展示，避免单屏信息过载
界面指引：
当前建议补充「视图页」截图，展示左侧目录树、右侧内容区以及仪表盘/拓扑图/架构图的切换关系。
- 图表解读：视图页是运营分析的主工作台。左侧负责组织资产，右侧负责编辑和查看内容，二者配合后才形成真正可复用的分析空间。
四、第三步：保存并验证分析结果
操作路径：视图 → 当前分析对象 → 保存 → 切换查看模式验证
完成组件或画布配置后，应及时保存并验证结果，确认页面是否已经具备团队共享价值。
4.1 保存前检查清单
| 检查项 | 检查内容 | 通过标准 |
|---|---|---|
| 数据来源 | 组件绑定的数据源是否正确 | 数据来自预期的内置或自定义数据源 |
| 数据准确性 | 返回结果是否符合分析目标 | 数值、趋势与预期一致 |
| 图表适配性 | 图表类型是否适合当前数据 | 趋势用折线、对比用柱状、占比用饼图 |
| 参数通用性 | 参数配置是否足够通用 | 其他用户接手时无需重新理解底层逻辑 |
| 命名清晰度 | 目录、页面、组件命名是否清晰 | 通过名称即可理解用途，无需额外说明 |
| 权限合理性 | 团队归属和权限是否设置合理 | 应看的人能看到，不应看的人不可见 |
4.2 验证与迭代
- 数据验证：切换不同时间范围、过滤条件，确认数据响应正常
- 权限验证：切换到其他团队成员账号（或咨询管理员），确认可见范围符合预期
- 场景验证：邀请同事一起查看，收集反馈并迭代优化
- 持续维护：为重点页面设置维护责任人，确保分析资产长期可用
4.3 配置画布订阅（可选）
适用于需要定期把仪表盘 / 大屏结果邮件发出去的场景（如值班周报、管理层巡检）。拓扑图、架构图、报表画布暂不支持。
操作路径：视图 → 打开目标仪表盘或大屏 → 切换到查看模式 → 工具栏「画布订阅」
- 创建订阅：点「创建订阅」，填写订阅名称、接收邮箱，并选择组织内已配置的邮件渠道。
- 配置周期：选择每天 / 每周 / 每月，并设置时区与发送时刻；也可选「暂不调度（仅手动测试）」。
- 保存并测试：保存后点「立即测试」，在列表中查看「最近测试执行」状态；计划任务到期后可看「最近计划执行」。
- 维护订阅：可编辑名称 / 收件人 / 周期，切换启用或暂停；筛选条件变化后可用「更新快照」刷新后续执行口径（仅影响后续执行）。
前置与边界：
- 需要对该仪表盘 / 大屏具备查看权限，且组织内已配置可用的邮件渠道。
- 每个订阅对应 1 个接收邮箱，输出为 PDF 附件；不支持钉钉 / 企微等非邮件渠道。
- 普通用户只能管理自己创建的订阅；编辑模式与分享页不显示入口。
- 执行时按创建者当前权限实时取数；若创建者权限失效，对应执行会失败。失败原因可在执行状态标签中查看。
五、结果验证与闭环建议
完成以上步骤后，建议按以下方式确认已经形成完整闭环：
- 资产沉淀验证：在视图页确认目录结构、分析对象已成功保存，可在目录树中正常浏览
- 数据查询验证：在页面中确认数据源返回结果稳定，筛选条件和时间范围能正常工作
- 权限边界验证：切换到其他团队成员视角，确认页面共享边界符合预期
- 场景落地验证：以真实运维场景（如值班巡检、故障复盘）试用首个看板或画布，而非停留在一次性验证页面
进阶优化建议
如果首个分析对象已验证可用，建议继续以下优化：
- 建立命名规范：为高频分析场景建立统一的目录命名规范，如「业务域_场景_视角」
- 设置维护责任人：为重点页面指定维护责任人，定期更新数据范围与展示逻辑
- 沉淀模板：将通用分析模式保存为团队模板，便于快速复制创建类似页面
- 权限分级：根据团队分工细化权限配置，如业务团队仅能查看业务域分析资产
六、管理员扩展指南
在大多数场景下，普通用户直接使用平台内置的数据源与命名空间即可。仅在以下情况下，建议由管理员进入设置页补充底层配置：
- 现有内置数据源无法覆盖新的业务分析场景（如需要接入第三方业务系统数据）
- 需要新增特定命名空间对接新的数据环境（如新增集群、新增区域）
- 需要调整参数模板、图表类型限制或团队可见范围
6.1 创建命名空间
操作路径：设置 → 命名空间 → 新建
| 配置项 | 说明 | 示例 |
|---|---|---|
| 名称 | 命名空间的显示名称 | 生产环境集群A |
| NATS命名空间 | 消息主题前缀 | WeOpsX_prod |
| 账号 | NATS连接账号 | ops_analysis |
| 密码 | NATS连接密码（自动加密） | * |
| 域名 | NATS服务器地址 | nats.example.com:4222 |
| 启用TLS | 是否使用TLS加密连接 | 是（生产环境建议开启） |
安全提示：
生产环境强烈建议启用 TLS，密码在保存时会自动加密，数据库中不存储明文。
6.2 创建数据源
操作路径：设置 → 数据源 → 新建
| 配置项 | 说明 | 示例 |
|---|---|---|
| 名称 | 数据源的显示名称 | 主机资源统计 |
| 数据源类型 | 取数方式 | REST API / MySQL / PostgreSQL / Excel / NATS |
| 连接信息 / 取数配置 | 地址、查询语句、接口路径、Excel 文件等 | /api/cmdb/hosts/statistics |
| 命名空间 | 关联的数据来源 | 生产环境集群A |
| 标签 | 数据源分类标签 | CMDB |
| 图表类型 | 支持的展示形式 | 折线图、柱状图、单值图、表格 |
| 默认列（可选） | 表格类数据源的默认列与列名 | 主机名、所属组织、状态 |
| 参数模板 | 接口所需参数 | time_range、app_id |
配置建议：
参数模板建议按「固定值」与「可编辑值」区分，固定值在配置时确定，可编辑值留给使用者在分析页面调整。
Excel 类型建议使用页面支持的文件格式与大小限制；数据库或接口预览如失败，优先检查账号权限、查询条件和网络连通性。
七、常见问题（FAQ）
Q1：为什么我的仪表盘没有数据？
- 检查数据源是否已启用
- 检查命名空间连接是否正常（可咨询管理员）
- 检查参数配置是否正确，特别是时间范围
- 检查当前用户是否有该数据源所属团队的查看权限
Q2：如何分享我创建的仪表盘给团队其他人？
- 需要长期协作时，优先设置正确的「所属团队」并确认成员具备查看权限，成员可从目录树进入。
- 需要临时审阅时，可在仪表盘查看页点击「分享」生成链接；系统会自动复制，复制失败时可从提示中手动复制。
- 分享链接为长期有效链接，目前不能逐条撤销，请只发给可信人员；如需整体失效，请联系管理员调整原仪表盘或相关访问配置。
- 分享页面只提供查看能力，不应把它当作编辑授权方式。
Q3：拓扑图和架构图有什么区别？
- 拓扑图：侧重表达动态关系和实时状态，支持数据绑定和定时刷新，适合故障定位和运行态观察
- 架构图：侧重表达静态资源结构和系统分层，适合架构评审和方案沟通
Q4：目录层级上限可以调整吗？
- 当前目录层级上限固定为 3 层，这是为了平衡灵活性与可维护性。如需更深层级，建议通过命名规范来体现层级关系。
Q5：数据源关联多个命名空间时，数据如何展示？
- 系统会并行向各命名空间取数，并按命名空间名称分区返回。前端组件可选择展示全部数据或仅展示特定命名空间数据。
Q6：配置了画布订阅但收不到邮件，怎么排查？
- 确认组织内邮件渠道已配置且可用（可咨询管理员）
- 确认订阅状态为「启用」，且发送周期 / 时区配置正确
- 在订阅列表查看「最近测试执行 / 最近计划执行」状态与失败原因
- 确认创建者仍对该仪表盘 / 大屏具备查看权限
- 确认当前打开的是仪表盘或大屏的查看模式（报表、拓扑图、架构图暂不支持画布订阅）