如何在KQL中添加标记时间点的垂直参考线或点？

KQL完全可以实现垂直参考线（或时间点标记），核心思路是通过数据合并的方式，让可视化工具识别并渲染垂直标记，具体实现方式如下：

• 合并参考线数据：使用union操作符将原始时序数据与构造的垂直参考线数据合并。参考线数据需要包含目标时间点，以及覆盖原始数据数值范围的字段值，这样才能形成贯穿整个图表的垂直线。

  示例代码（假设你有一个记录指标的表MetricData，要在2024年5月20日12点添加垂直参考线）：

  // 原始时序数据查询
  MetricData
  | where TimeStamp between (datetime(2024-05-20 00:00:00) .. datetime(2024-05-20 23:59:59))
  | summarize AvgMetric = avg(MetricValue) by bin(TimeStamp, 1h)
  // 合并垂直参考线的构造数据
  | union (
      datatable(TimeStamp:datetime, AvgMetric:dynamic, Series:string) [
          datetime(2024-05-20 12:00:00), dynamic([min(AvgMetric), max(AvgMetric)]), "Vertical Reference"
      ]
  )
  

• 可视化配置：在Kusto Explorer或Azure Monitor的可视化面板中，将新增的Series字段作为系列分组，然后调整该系列的样式（比如设置为虚线、特殊颜色），就能清晰区分原始数据和垂直参考线。

• 时间点标记替代方案：如果只需要标记特定时间点而非贯穿的线，可以构造仅包含单个数值点的数据，通过union合并后，在可视化中设置为散点标记即可。

内容的提问来源于stack exchange，提问作者Michael Fulton