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 中带特殊字符的内容要先编码,否则目标页解析参数会失败,表现为点击后跳转到空结果。
跳转目标要带时间范围参数,避免落在默认时间窗造成上下文错位,看日志时尤其明显。
下钻链路要控制在两跳以内:链路过长会让人忘记起点,也增加维护成本。