首页/云/可观测性速查/Data links:数据点下钻跳转
Grafana 与看板53 条

Data links:数据点下钻跳转

给数据点或表格行挂可点击链接:从异常点跳到日志检索、追踪详情或工单页面;URL 用内置变量携带上下文与时间范围。

可观测性速查云更新于 2026-10-13

Data links 是什么

Data links 给数据点或表格行挂上可点击的链接:从异常点直接跳到日志检索、追踪详情或工单页面。URL 里用内置变量携带上下文(当前值、字段名、序列名、时间范围),跳转后目标页自动带上正确的筛选条件,避免手工复制粘贴。

基本信息

作用数据点与表格行下钻跳转
变量${__value.raw}、${__field.name}、${__data.fields.X}
时间变量${__from} / ${__to} / ${__url_time_range}
定义位置字段默认配置或 Field overrides
适用面板时序、Table、Stat 等
常见目标日志平台、追踪系统、工单系统

典型使用场景

  • 从错误率异常点跳到对应时间段的日志检索页
  • 在实例清单表格里点击某行打开该实例的详情看板
  • 从慢请求点跳转到链路追踪的查询页
  • 一键创建工单并带上服务名与时间范围
  • 从聚合面板跳到实例级看板,完成逐步下钻
  • 把监控指标与内部运维平台打通,缩短处置路径

链接变量用法

链接变量用法
# 示例 URL(跳到日志检索页并带上时间范围)
/logs?service=${__data.fields.service}&from=${__from}&to=${__to}

# 常用内置变量
${__value.raw}        # 当前点的值
${__field.name}       # 字段名
${__series.name}      # 序列名
${__url_time_range}   # 当前时间范围参数
${__data.fields.X}    # 表格指定列的值
${__from} / ${__to}   # 时间范围起止(毫秒时间戳)

常用变量

变量取值典型用途
${__value.raw}当前数据点值作为搜索关键字
${__field.name}字段名区分指标来源
${__data.fields.X}表格某列的值按行跳转
${__url_time_range}时间范围参数保持上下文一致
${__from} / ${__to}起止时间自定义时间参数格式
Data links 支持定义在字段默认配置里,也可在 Field overrides 里只给某一列添加,后者适合表格中个别列的定向跳转。
URL 中带特殊字符的内容要先编码,否则目标页解析参数会失败,表现为点击后跳转到空结果。
跳转目标要带时间范围参数,避免落在默认时间窗造成上下文错位,看日志时尤其明显。
下钻链路要控制在两跳以内:链路过长会让人忘记起点,也增加维护成本。

易错点

  • URL 中带特殊字符的内容要先编码,否则目标页解析失败
  • 链接跳转的看板要带时间范围参数,避免落在默认时间窗造成上下文错位
  • 变量名写错时链接会带着字面量跳转,目标页查不到数据却看不出哪里错
  • 给所有列都加链接会让表格变得杂乱,只对关键列添加体验更好
  • 下钻目标站点变更后链接会失效,需要定期巡检关键看板的跳转可用性

数据来源与参考

  • Grafana 官方文档 · Data links
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌