常见问题¶
仪表板¶
观测云目前提供 Grafana dashboard json template 如何转换为观测云仪表板 JSON 模版的 node 脚本？
npm 下载：
使用方式：
$ npm install -g @cloudcare/guance-front-tools
# show usage information
$ grafanaCovertToGuance
# run task
$ grafanaCovertToGuance -d examples/grafana.json -o examples/guance.json
Keywords：
none
查看器¶
为什么查看器搜索栏无法使用 JSON 格式？
使用 JSON 搜索需要满足以下三个条件：
- 站点为“中国区1（杭州）”、“中国区3（张家口）”、以及“中国区4（广州）”
- 工作空间需要在
2022年6月23日后创建 - 仅可在日志查看器中使用
定时报告¶
为什么定时报告邮件会报错 414？
最终发送到目标邮箱里的定时报告中，图片链接的生成是根据所在仪表板的对应图表迭代视图变量等参数拼接而成。若出现视图变量内容过长，则有可能导致生成的图片链接过长，从而引发 414 报错问题。
内置视图¶
为什么绑定了但详情页不显示？
请检查：
- 确认绑定的是用户视图（系统视图需先克隆）
- 确认字段名和
value值与查看器数据一致 - 检查
value匹配模式是否正确（通配*vs 具体值）
一个查看器可以绑定多个视图吗？
可以。当多个字段匹配到不同视图时，按优先级顺序展示。若同一字段匹配到多个视图，仅显示第一个。
为什么我的图表显示“暂无数据”？
可能原因：
- 时间范围选择不对，尝试扩大时间范围
- 筛选条件过于严格，检查标签和关键字是否正确
- 数据还未上报，确认 DataKit 采集器正常运行
图表里的“锁定时间”是什么意思？
锁定时间表示该图表固定查询某个时间段的数据，不会随仪表板顶部的时间选择器变化。适合用来对比历史基线数据。
组合图表和单个图表有什么区别？
组合图表将多个图表放在同一个卡片内，通过 Tab 切换查看，节省空间且便于关联分析。适合同一指标的不同维度对比（如 CPU 使用率的 TOP10 容器和 TOP10 进程）。
视图变量怎么配置才能生效？
创建视图变量后，需要在图表查询中引用该变量（如 host::tag），图表右上角才会出现筛选下拉框。
分享的图表链接别人打不开怎么办？
请检查分享设置：
- 确认选择了“公开分享”而非“加密分享”
- 检查链接是否在有效期内
- 确认对方网络可以访问控制台
查看器¶
为什么查看器搜索栏无法使用 JSON 格式？
使用 JSON 搜索需要满足以下三个条件：
- 站点为“中国区1（杭州）”、“中国区3（张家口）”、以及“中国区4（广州）”
- 工作空间需要在
2022年6月23日后创建 - 仅可在日志查看器中使用
查看器与仪表板的使用场景分别是什么？
| 维度 | 仪表板 | 查看器 |
|---|---|---|
| 数据粒度 | 聚合数据（趋势、统计值） | 明细数据（单条日志、单个链路） |
| 核心用途 | 监控大盘、趋势分析、汇报展示等 | 故障排查、安全审计、数据探索等 |
| 交互模式 | 可视化图表、变量筛选等 | 搜索过滤、高亮、上下文展开等 |
查看器的筛选条件和仪表板为什么不互通？
查看器的筛选仅作用于当前查看器页面，仪表板的筛选（视图变量）作用于该仪表板内的所有图表。两者是独立的。
为什么我的图表显示“暂无数据”？
可能原因：
- 时间范围选择不对，尝试扩大时间范围
- 筛选条件过于严格，检查标签和关键字是否正确
- 数据还未上报，确认 DataKit 采集器正常运行
图表里的“锁定时间”是什么意思？
锁定时间表示该图表固定查询某个时间段的数据，不会随仪表板顶部的时间选择器变化。适合用来对比历史基线数据。
组合图表和单个图表有什么区别？
组合图表将多个图表放在同一个卡片内，通过 Tab 切换查看，节省空间且便于关联分析。适合同一指标的不同维度对比（如 CPU 使用率的 TOP10 容器和 TOP10 进程）。
视图变量怎么配置才能生效？
创建视图变量后，需要在图表查询中引用该变量（如 host::tag），图表右上角才会出现筛选下拉框。
分享的图表链接别人打不开怎么办？
请检查分享设置：
- 确认选择了“公开分享”而非“加密分享”
- 检查链接是否在有效期内
- 确认对方网络可以访问控制台
查看器¶
为什么查看器搜索栏无法使用 JSON 格式？
使用 JSON 搜索需要满足以下三个条件：
- 站点为“中国区1（杭州）”、“中国区3（张家口）”、以及“中国区4（广州）”
- 工作空间需要在
2022年6月23日后创建 - 仅可在日志查看器中使用
查看器与仪表板的使用场景分别是什么？
| 维度 | 仪表板 | 查看器 |
|---|---|---|
| 数据粒度 | 聚合数据（趋势、统计值） | 明细数据（单条日志、单个链路） |
| 核心用途 | 监控大盘、趋势分析、汇报展示等 | 故障排查、安全审计、数据探索等 |
| 交互模式 | 可视化图表、变量筛选等 | 搜索过滤、高亮、上下文展开等 |
查看器的筛选条件和仪表板为什么不互通？
查看器的筛选仅作用于当前查看器页面，仪表板的筛选（视图变量）作用于该仪表板内的所有图表。两者是独立的。
如何快速找到某台主机的所有日志？
在日志查看器搜索框输入 host:主机名，或点击主机列表的“查看日志”快捷入口。
定时报告¶
为什么定时报告邮件会报错 414？
最终发送到目标邮箱里的定时报告中，图片链接的生成是根据所在仪表板的对应图表迭代视图变量等参数拼接而成。若出现视图变量内容过长，则有可能导致生成的图片链接过长，从而引发 414 报错问题。
报告发送后收不到邮件怎么办？
请检查：
- 通知对象的邮箱地址是否正确
- 邮件是否被拦截到垃圾箱
- 仪表板中是否存在数据量过大的图表导致生成失败
报告里的图表显示空白是什么原因？
通常是数据查询时间范围过长或图表计算复杂导致生成超时。建议缩小时间范围或简化查询条件。
内置视图¶
为什么绑定了但详情页不显示？
请检查：
- 确认绑定的是用户视图（系统视图需先克隆）
- 确认字段名和
value值与查看器数据一致 - 检查
value匹配模式是否正确（通配*vs 具体值）
一个查看器可以绑定多个视图吗？
可以。当多个字段匹配到不同视图时，按优先级顺序展示。若同一字段匹配到多个视图，仅显示第一个。
绑定后视图的时间范围可以调整吗？
视图默认显示"最近 15 分钟"，但您可以在视图内手动调整时间范围。调整仅影响当前查看，不会保存。
笔记¶
笔记里插入的图表数据会实时更新吗？
不会。插入笔记时图表会保存当前查询结果，后续数据变化不会自动同步。如需最新数据，需要重新插入图表。
导出的笔记 JSON 可以在其他工作空间使用吗？
可以。通过“导入笔记 JSON” 功能，可将笔记迁移到其他工作空间，但关联的数据源需要重新配置。
其他¶
P99 的峰位计算逻辑说明
观测云通过获取一段时间内某个指标的所有值，将这些值从小到大排序，然后根据数据点数 * 99% 来确定 P99 对应的数据点位置，并返回该位置的值。这里所说的“所有值”指的是存储在数据库中的原始数据点。
对于指标数据的百分位查询，观测云的处理方式会因使用的数据引擎而异。如果数据库本身不支持百分位查询功能，观测云会通过代码将数据拉取到本地进行额外处理来实现这一功能。而对于非指标类数据（如日志、APM、RUM 等），百分位查询则是通过数据库的原生功能来支持的。
快照和截图有什么区别？
快照保存的是可交互的数据状态（支持切换时间、下钻分析），截图只是静态图片。分享排查问题时建议用快照。