可观测性

本章覆盖：指标查询 / 日志查询 / 仪表盘。 可观测性模块把分散在各处的指标、日志、仪表盘汇聚到统一界面,帮助您从"数字趋势—日志明细—可视化大屏"三个维度快速了解系统运行状况、定位异常。

说明:链路追踪(服务拓扑、调用链 Trace)能力独立成第 7 章「APM 应用性能监控」,本章不再重复,详见第 7 章。

本章各功能位于左侧导航「可观测性」分组下,包含指标查询、日志查询、链路追踪、仪表盘。

指标查询

功能简介

指标查询提供基于 PromQL 的时序指标检索与可视化能力。您可以选择 Prometheus 数据源,输入查询表达式,按时间范围查看指标随时间变化的曲线或明细表格。页面右侧内置"常用 PromQL"场景库,无需记忆语法即可一键套用应用、主机、K8s、容器、中间件等常见查询。

进入路径

左侧主导航 → 可观测性 → 指标查询。页面地址为 /query/metrics。

界面总览

页面左侧上方为"PromQL 查询"区(数据源、时间范围、表达式输入),下方为"Graph"结果区;右侧为"常用 PromQL"场景库。初始未执行查询时,结果区提示"执行查询后在此展示时序趋势与序列"。

执行查询后,结果区绘制出时序曲线:

界面元素说明

字段 / 元素	含义
选择 Prometheus 数据源	下拉选择要查询的指标库(仅列出 Prometheus 类型数据源)
时间范围	查询的时间跨度:最近 15 分钟 / 1 小时 / 6 小时 / 24 小时
步长	采样间隔:自动 / 15s / 30s / 1m / 5m,影响曲线疏密与精度
单位	数值显示单位:原始 / SI short / bytes(1024) / 百分比
PromQL 输入框	输入查询表达式,如 up 或 sum(rate(http_requests_total[5m])) by (service)
▶ 执行查询	按当前条件执行查询;也可在输入框内按 Ctrl/⌘ + 回车执行
历史	下拉查看并快速套用最近执行过的查询
复制按钮	复制当前 PromQL 表达式
刷新数据源	重新拉取数据源列表与指标名(用于新加数据源后同步)
图表 / 表格	结果展示形式切换:曲线图或按序列列出的明细表
来源 / 序列 / 步长 / 状态 / 耗时	结果区元信息:数据源名、返回序列条数、实际步长、查询状态、耗时(毫秒)
常用 PromQL	右侧场景库,可搜索并按"全部/应用/主机/K8s/容器/中间件"筛选,点击卡片即把表达式填入输入框

操作步骤

1. 进入 指标查询 页面。
2. 在「选择 Prometheus 数据源」下拉中选择目标指标库。
3. 设置「时间范围」,如需要可调整「步长」与「单位」。
4. 在输入框中填写 PromQL;不熟悉语法时,可在右侧「常用 PromQL」中搜索或按分类浏览,点击卡片自动填入。
5. 点击「▶ 执行查询」(或按 Ctrl/⌘ + 回车)。
6. 在结果区查看曲线;点击「表格」可切换为逐序列明细(含标签、最新值、时间、样本数)。
7. 需要复用时,点击「历史」下拉可快速回到之前的查询条件。

常见问题 / 注意事项

• 下拉里没有数据源:请确认已在第 5 章登记了 Prometheus 数据源且处于"已启用";新加后可点「刷新数据源」同步。
• 提示无数据:多为时间范围内确无该指标、指标名拼写有误或标签过滤过严;可先用简单表达式(如 up)验证连通性。
• 曲线过密或过疏:通过「步长」调整;时间范围越大建议步长越大,以兼顾性能与可读性。
• 数值不直观:切换「单位」(如流量选 bytes、占比选百分比)可让纵轴与提示更易读。

日志查询

功能简介

日志查询(日志中心)提供对 Elasticsearch(ELK)日志库的检索与分析。您可以选择数据源与索引,按时间范围与 Lucene 语法过滤日志,查看日志数量趋势直方图、逐条日志明细,并借助左侧"字段"面板快速下钻过滤。常用条件可收藏、历史条件可一键套用。

进入路径

左侧主导航 → 可观测性 → 日志查询。页面地址为 /query/logs。

界面总览

页面上方为"查询条件"区与"当前数据源"信息卡;中部为"趋势图"(日志数量直方图);下方为"查询结果",左侧是字段面板,右侧是日志明细表。

界面元素说明

字段 / 元素	含义
数据源	下拉选择日志库(仅列出 Elasticsearch 类型数据源)
时间	查询时间范围:最近 15 分钟 / 1 小时 / 6 小时 / 24 小时
数量	单次取回的最大日志条数,默认 500,可填 1–1000
索引	检索的索引或索引模式,如 logs-*;选择数据源后会自动带出其配置的索引模式
Lucene 查询	过滤表达式,如 service.name:"payment" AND level:error;下方提供"查询语法帮助"链接
查询日志	按当前条件执行检索
收藏 / 历史·收藏	「收藏」保存当前查询条件;「历史/收藏」打开弹窗查看并套用历史或收藏条件
当前数据源卡	展示所选数据源的类型、接入地址、索引模式,以及时间字段(@timestamp)
趋势图	按时间分桶的日志数量直方图;点击某柱可缩放到该时间区间重新查询
查询结果表	逐条日志,列含"时间""级别""MESSAGE";点击行可展开查看完整原始字段
字段面板	基于本次取回日志统计的字段列表,展开某字段可见高频取值,点击「+」把该取值加入过滤条件
已返回 N 条 / 来源	结果区元信息:本次返回条数与数据源名(受"数量"限制,非全量总数)

操作步骤

1. 进入 日志查询 页面。
2. 在「数据源」下拉中选择 Elasticsearch 日志库,页面会自动带出其索引模式。
3. 设置「时间」范围与「数量」上限;如需限定索引,可在「索引」中选择或输入模式(如 logs-*)。
4. 在「Lucene 查询」中填写过滤条件(可留空表示不额外过滤),点击「查询日志」。
5. 查看"趋势图"了解日志量分布;点击某柱可放大到该时段。
6. 在结果表中点击任意一行展开完整日志内容;借助左侧「字段」面板点击「+」可快速追加过滤条件后再次查询。
7. 常用条件点击「收藏」保存;下次通过「历史/收藏」一键「套用」。

常见问题 / 注意事项

• 下拉里没有数据源:请确认已登记并启用 Elasticsearch 数据源;新加后点「刷新数据源」同步。
• 统计口径:字段面板与"已返回 N 条"均基于本次取回的日志(受"数量"限制),并非全量统计;如需更全,请提高「数量」或缩小时间范围。
• 查不到日志:检查索引/索引模式是否正确、时间范围是否覆盖、Lucene 条件是否过严;可先清空过滤条件验证连通性。
• 语法帮助:Lucene 查询语法可点击输入框下方的"查询语法帮助"链接参考。

仪表盘

功能简介

仪表盘用于把外部 Grafana 看板集中登记并内嵌到平台中,实现"一处入口、按分类浏览"的可视化大屏管理。登记后点击看板名称即可在平台内直接查看,无需在多个系统间切换。

进入路径

左侧主导航 → 可观测性 → 仪表盘。页面地址为 /query/dashboards。

界面总览

页面顶部为分类筛选与"新建看板"按钮,下方为看板列表(名称、分类、URL、操作);点击某看板名称,会在下方内嵌展示该 Grafana 大屏。

新建看板时弹出配置面板:

界面元素说明

列表与筛选

字段 / 元素	含义
分类筛选	顶部分段控件,"全部"或按已有分类过滤看板
新建看板	打开看板登记面板(需数据源写入权限)
名称	看板名称,点击可在页面内嵌打开该看板
分类	看板所属分类,未填写时显示"未分类"
URL	看板的 Grafana 地址
操作	「编辑」修改登记信息,「删除」移除看板(二次确认)

新建 / 编辑看板面板字段

字段	含义
名称	看板显示名称,如"节点概览"
分类	归类标签,可从已有分类中选择或直接输入新分类,默认"未分类"
Grafana 看板 URL	Grafana 看板地址,如 http://grafana.example.nip.io/d/uid/name;需 Grafana 开启匿名访问与允许内嵌(allow_embedding),平台才能内嵌显示
描述	看板说明(可选)

操作步骤

1. 进入 仪表盘 页面,点击「新建看板」。
2. 在配置面板中填写「名称」,选择或输入「分类」。
3. 在「Grafana 看板 URL」中粘贴目标 Grafana 看板地址,按需填写「描述」。
4. 点击「创建」保存;列表中出现该看板。
5. 点击看板「名称」,即可在页面下方内嵌查看该大屏;查看完点击「关闭」收起。
6. 需要调整时,在操作列点击「编辑」;不再使用点击「删除」并确认。

常见问题 / 注意事项

• 看板内嵌显示空白或被拒绝:通常是目标 Grafana 未开启匿名访问或未允许内嵌(allow_embedding);请联系 Grafana 管理员开启后再试。
• 主题自适应:内嵌看板会自动跟随平台的明暗主题显示,无需在 URL 中额外指定。
• URL 建议:填写 Grafana 中该看板的完整分享地址;若地址含权限令牌等敏感参数,请谨慎登记。
• 无"新建看板"按钮:该操作需数据源写入权限,仅有查看权限的用户只能浏览已登记看板。