数据分析
# 数据分析
可以查看某一设备在某一时间段某个遥测点的历史数据曲线和极值，便于分析。
# 视频教程
# 1 概述
本章介绍数据分析模块的用途、典型场景与常用术语。
# 1.1 功能简介
数据分析用于回看某个测点在一段时间内的历史数据。选定设备、测点与时间段后，本模块会给出这段区间内的：
- 历史曲线——按采样间隔画出的数值走势；
- 统计结果——超上限次数、超下限次数、区间最大值、区间最小值；
- 极值分析——这段区间内的高点与低点，可按月、日、时三个粒度查看；
- 明细数据——逐条的时间与值，可导出。
模块下有两个菜单：
| 菜单 | 用途 |
|---|---|
| 数据分析 | 查询测点历史曲线与极值 |
| 设备配置 | 维护"设备/产品有哪些属性可以被分析"，是数据分析能选到测点的前提 |
# 1.2 应用场景
| 场景 | 做法 |
|---|---|
| 排查某次异常 | 选定测点与出问题的时间段，查看历史曲线与极值 |
| 看一天内的波动 | 采样间隔选1天，时间段取当天，看整体走势 |
| 看某个时段的细节 | 采样间隔选15分钟，时间段收窄到出问题的那几小时 |
| 判断是否频繁越限 | 看超上限次数与超下限次数 |
| 导出给他人分析 | 查询后点击导出，把明细数据带走 |
| 找出极端工况 | 用极值分析的月/日/时三个粒度找出高点与低点出现的时间 |
# 1.3 术语表
| 术语 | 含义 |
|---|---|
| 测点 | 设备上被采集的一个量，如温度、湿度；只有开启了记录历史曲线的测点才能查到历史数据 |
| 采样间隔 | 历史曲线的取点密度，可选 15分钟 / 30分钟 / 1小时 / 1天 |
| 区间 | 查询的开始时间到结束时间 |
| 超上限次数 | 区间内数值高于上限的次数 |
| 超下限次数 | 区间内数值低于下限的次数 |
| 区间最大值 / 最小值 | 区间内出现的最高值与最低值 |
| 极值分析 | 把区间内的最高点（极大值）与最低点（极小值）单独列出来 |
| 极值个数 | 极值分析里取多少个极值点，下限为 5 |
| 夜间计算 | 极值分析的取值说明，见 7.1 极值曲线与粒度 |
| 维度类型 | 设备配置里选择"按产品"还是"按设备"来配置属性 |
# 3 前提条件
| 项目 | 要求 |
|---|---|
| 账号权限 | 当前账号需具备数据分析菜单及其下查询/导出按钮的权限 |
| 测点已开历史曲线 | 要查询的测点必须已开启记录历史曲线，否则查询不到任何数据 |
| 测点已配置属性 | 测点所属设备需在设备配置中配置过属性，否则选择测点下拉里选不到 |
| 时间段内确有数据 | 所选区间内设备确实产生过数据 |
| 浏览器 | Chrome、Edge 等主流浏览器，建议分辨率 1920×1080 及以上 |
重要 查询设备对应的测点必须开启记录历史曲线，否则无法查询。这通常是"选了测点却没有曲线"的首要原因。
# 4 进入数据分析模块
操作步骤：
- 登录 IoTCenter 平台。
- 在左侧菜单中找到业务功能使用指南下的数据分析。
- 展开后可见数据分析与设备配置两个菜单，默认进入数据分析。
# 5 界面说明
页面分为左右两栏：左侧是设备分组树，右侧自上而下是查询条件区与结果区。
# 5.1 设备分组树
左栏顶部为标题数据分析(N)，N 为当前范围内的设备数；标题右侧为搜索设备名称输入框。
下方是按分组展开的设备树，每个分组名后带一个数字，表示该分组下的设备数量。点击分组前的箭头可以展开或收起。
# 5.2 查询条件区
在设备树中点选一台设备后，右栏顶部出现该设备的查询条件。
| 控件 | 说明 |
|---|---|
| 设备名 | 显示当前选中的设备 |
| 选择测点 | 选择要分析的测点，提示语为选择测点 |
| 采样间隔 | 15分钟 / 30分钟 / 1小时 / 1天，四选一 |
| 开始时间 | 区间的起点，提示语为开始时间 |
| 结束时间 | 区间的终点，提示语为结束时间 |
| 查询 | 按当前条件取数并绘图 |
# 5.3 结果区
点击查询后，下方依次给出：
操作步骤：
- 统计卡——超上限次数 / 超下限次数 / 区间最大值 / 区间最小值；
- 历史曲线——标题为历史曲线的折线图；
- 导出按钮；
- 结果表格——列为时间与值；
- 极值分析——极大值与极小值两块面板。
没有数据时，图与表位置显示暂无数据提示。
# 6 查询设备测点数据
# 6.1 选择设备与测点
操作步骤：
- 在左侧设备树中展开分组，点击目标设备。
- 在右栏选择测点下拉中选择要分析的测点。
提示 测点较多时，可以先用左栏顶部的搜索设备名称把设备筛出来，再选测点。
# 6.2 选择时间段与采样间隔
操作步骤：
- 在开始时间与结束时间中选择查询区间。
- 在 15分钟 / 30分钟 / 1小时 / 1天 中选择一个采样间隔。
| 采样间隔 | 适用情形 |
|---|---|
| 15分钟 | 区间很短、要看细节 |
| 30分钟 | 看半天到一天内的波动 |
| 1小时 | 看几天内的走势 |
| 1天 | 看长期趋势，区间可以取得很长 |
说明 采样间隔决定曲线的取点密度，不影响表格里的明细值。同一个区间换一个采样间隔，曲线形状会变细或变粗，但统计卡与明细数据不变。
- 点击查询。
# 6.3 查看曲线与统计
查询完成后，结果区给出这段时间的完整视图。
先看四张统计卡判断"有没有异常"，再看历史曲线判断"异常发生在什么时候"，最后在时间/值表格里定位到具体那一条。
# 6.4 导出数据
结果区右上角有导出按钮。点击后会把当前查询到的数据导出成文件，便于在表格软件里进一步分析。
提示 导出的是当前查询条件下的结果。想导出别的区间，请先改条件并重新查询，再导出。
# 7 极值分析
极值分析在结果区最下方，分为极大值与极小值两块面板，各自独立绘图。
# 7.1 极值曲线与粒度
每块面板的标题（极大值 / 极小值）右侧有一行小字夜间计算，是该面板取值的说明。
面板顶部有 月 / 日 / 时 三个按钮，用于切换统计粒度：
| 粒度 | 含义 |
|---|---|
| 月 | 按月份归集极值 |
| 日 | 按日归集极值 |
| 时 | 按小时归集极值 |
在这块面板里，可以按粒度看到对应时间段内的极值，曲线中同时给出上限与下限两条参考线。
没有可用的极值数据时，面板显示暂无极大值或暂无极小值。
# 7.2 调整极值个数
面板标题右侧会出现极值个数输入框，用于控制取多少个极值点。
| 项目 | 说明 |
|---|---|
| 极值个数 | 取值范围从 5 起。输入框不允许填小于 5 的值 |
| 出现条件 | 只有当该面板的极值点数量多于 5 个时，极值个数输入框才会出现 |
说明 极值点本来就不足 5 个时，面板上不会出现极值个数输入框，这是正常的——此时所有极值点都已经画在图上，没有可调的余地。
# 8 设备配置
设备配置用于决定"哪些属性可以在数据分析里被查询"。它是一个独立菜单，进入方式：数据分析 › 设备配置。
页面顶部的维度类型：决定按什么口径来配置属性。
# 8.1 维度类型
| 维度类型 | 含义 | 后续步骤 |
|---|---|---|
| 按产品 | 同型号产品共用一套属性配置 | 两步：1 产品配置 → 2 设备配置 |
| 按设备 | 逐台设备单独配置属性 | 一步：直接在设备树上勾选设备后配置属性 |
切换维度类型后，页面下方的内容会随之变化。
# 8.2 按产品配置
选择按产品时，页面按 1 产品配置 → 2 设备配置 两步进行。
第 1 步 产品配置
操作步骤：
- 在产品名称中选择要配置的产品。
- 在选择属性区域中勾选该产品需要暴露的属性。
- 点击下一步进入第 2 步。
第 2 步 设备配置
- 在设备树上选择该配置要应用到的设备。
- 点击确认保存；中途放弃可点击取消。
提示 属性项较多时，可使用全选一次性勾选当前分组下的全部属性，再按需取消个别项。
# 8.3 按设备配置
选择按设备时，页面分为左右两栏。
| 区域 | 内容 |
|---|---|
| 左栏 | 标题设备名称，下方为带勾选框的设备树，可逐级展开 |
| 右栏 | 标题选择属性，下方为可折叠的属性分组 |
操作步骤：
操作步骤：
- 在左栏设备树中勾选目标设备。
- 在右栏选择属性中展开分组，勾选需要暴露的属性。
- 点击确认保存。
说明 右栏的选择属性内容取决于左栏勾了哪些设备。一台设备都没勾时，选择属性下是空的，这属正常现象。
# 9 参数说明
# 9.1 查询条件字段
| 字段 | 是否必选 | 说明 |
|---|---|---|
| 设备 | 必选 | 在左侧设备树中点选 |
| 选择测点 | 必选 | 提示语"选择测点"；只有开启历史曲线的测点才有数据 |
| 采样间隔 | 必选 | 15分钟 / 30分钟 / 1小时 / 1天，默认 15分钟 |
| 开始时间 | 必选 | 提示语"开始时间" |
| 结束时间 | 必选 | 提示语"结束时间" |
# 9.2 统计卡
| 统计项 | 含义 |
|---|---|
| 超上限次数 | 区间内数值高于上限的次数 |
| 超下限次数 | 区间内数值低于下限的次数 |
| 区间最大值 | 区间内出现的最高值 |
| 区间最小值 | 区间内出现的最低值 |
# 9.3 结果表格
| 列 | 含义 |
|---|---|
| 时间 | 该条数据的时间点 |
| 值 | 该时间点测点的数值 |
表格底部为分页条，可切换每页条数并翻页。
# 9.4 极值面板
| 项目 | 说明 |
|---|---|
| 极大值 / 极小值 | 两块独立面板，分别展示高点与低点 |
| 夜间计算 | 面板标题右侧的小字说明 |
| 月 / 日 / 时 | 极值的统计粒度，默认月 |
| 极值个数 | 取多少个极值点，最小 5；仅在极值点多于 5 个时出现 |
| 上限 / 下限 | 极值曲线中的两条参考线 |
# 9.5 设备配置字段
| 字段 | 说明 |
|---|---|
| 维度类型 | 按产品 / 按设备 |
| 产品名称 | 按产品时选择要配置的产品 |
| 设备名称 | 按产品第 2 步、或按设备时选择要应用配置的设备 |
| 设备编号 | 设备在平台中的编号 |
| 选择属性 | 勾选该设备/产品需要暴露的属性，支持全选 |
| 下一步 / 上一步 | 按产品两步流程中的前后切换 |
| 确认 / 取消 | 保存或放弃本次配置 |
# 10 约束与注意事项
# 10.1 测点必须开启「记录历史曲线」
这是数据分析能否查到数据的前提。下拉里能选到测点、但查询后暂无数据时，优先检查该测点是否开启了记录历史曲线。
# 10.2 采样间隔不改变明细数据
采样间隔只影响历史曲线的取点密度。统计卡与时间/值表格反映的是区间内的实际数据，换采样间隔不会改变它们。
# 10.3 极值个数下限为 5
极值个数输入框的最小值是 5，无法填更小的值。当该面板极值点本身就不足 5 个时，输入框不出现。
# 10.4 按产品与按设备是两套口径
维度类型选按产品时，配置作用在同型号的所有设备上；选按设备时只作用于勾选的那几台。切换维度类型前请确认影响范围。
# 10.5 配置改动会影响可分析范围
在设备配置里取消勾选某个属性后，该属性在选择测点里可能就不再出现。调整配置前请确认没有其他人正在使用它。
# 10.6 查询区间越长，取数越多
区间取得过长且采样间隔很小时，返回的数据量会很大，页面出图与导出都会变慢。看长期趋势时请把采样间隔调到1小时或1天。
# 11 常见问题
# 11.1 操作类问题
Q1：选了测点，查询后显示「暂无数据」？
依次确认：
操作步骤：
- 该测点是否开启了记录历史曲线——这是最常见的原因；
- 开始时间与结束时间是否填反了，或区间内设备确实没有数据；
- 设备在该时间段内是否在线。
Q2：为什么「选择测点」下拉里选不到想要的测点？
该测点所属设备的属性可能还没有在设备配置中配置。请先到设备配置里把该属性勾上。
Q3：换了采样间隔，为什么统计卡的数字没变？
采样间隔只影响历史曲线的取点密度，超上限次数 / 超下限次数 / 区间最大值 / 区间最小值以及明细数据都是按区间内实际数据算的，与采样间隔无关。
Q4：极值面板上没有「极值个数」输入框？
只有当该面板的极值点数量多于 5 个时，输入框才会出现。极值点本身不足 5 个时无框可调，属正常现象。
Q5：极值曲线里的「上限」「下限」是什么？
是该测点配置的上下限参考线，用于快速判断极值是否越限。
Q6：导出的数据是全部数据还是当前页？
导出的是当前查询条件下的数据，不是页面上的当前分页。需要导出别的区间时，请改条件并重新查询后再导出。
Q7：设备树里那一栏数字（如「数据分析(0)」）是什么意思？
括号里的数字是当前范围内的设备数量。数字为 0 表示该范围内没有设备，此时右侧不会出现可选测点。
# 11.2 错误提示对照
| 提示 | 含义 | 处理建议 |
|---|---|---|
| 暂无数据 | 当前条件查不到数据 | 检查测点是否开启历史曲线、时间区间是否正确 |
| 暂无历史数据 | 该区间内没有历史记录 | 放宽时间区间或换采样间隔后重试 |
| 暂无测点数据 | 该测点没有可用的数据 | 确认测点已启用且设备在线 |
| 暂无记录曲线的测点 | 该设备下没有开启历史曲线的测点 | 到测点配置中开启记录历史曲线 |
| 暂无极大值 / 暂无极小值 | 区间内没有可用的极值 | 放宽时间区间后重试 |
| 无权限 / 403 | 账号没有数据分析或对应按钮权限 | 联系管理员授权 |