工作簿时间参数

借助时间参数,可以设置分析的时间上下文,几乎所有的报表都会使用该上下文。 时间参数的设置和使用很简单。 可以使用它们指定要在下拉列表中显示的时间范围。 还可以创建自定义时间范围。

创建时间参数

  1. 从编辑模式下的空工作簿开始操作。

  2. 选择“添加参数”>“添加参数”。

  3. 在打开的新参数窗格中,输入:

    • 参数名称:TimeRange
    • 参数类型:Time range picker
    • 必需:checked
    • 可用时间范围:Last hourLast 12 hoursLast 24 hoursLast 48 hoursLast 3 daysLast 7 daysAllow custom time range selection
  4. 选择“保存”以创建参数。

    Screenshot that shows a time range parameter in read mode.

这是工作簿在阅读模式下的样子。

引用时间参数

可以使用绑定、KQL 或文本引用时间参数。

使用绑定引用时间参数

  1. 选择“添加查询”以添加查询控件,然后选择 Application Insights 资源。

  2. 大多数工作簿控件支持“时间范围”范围选取器。 打开“时间范围”下拉列表,然后选择底部“时间范围参数”组中的 {TimeRange}

    • 此控件会将时间范围参数绑定到图表的时间范围。
    • 现在示例查询的时间范围为“过去 24 小时”。
  3. 运行查询以查看结果。

    Screenshot that shows a time range parameter referenced via bindings.

使用 KQL 引用时间参数

  1. 选择“添加查询”以添加查询控件,然后选择 Application Insights 资源。

  2. 打开“时间范围”下拉列表,然后选择“时间范围”组中的 Set in query。 在 KQL 中,使用参数 | where timestamp {TimeRange} 输入时间范围筛选器:

    • 此参数可根据查询评估时间扩展为 | where timestamp > ago(1d)
    • 此选项是参数的时间范围值。
  3. 运行查询以查看结果。

    Screenshot that shows a time range referenced in KQL.

采用文本引用时间参数

  1. 向工作簿添加文件控件。
  2. 在 Markdown 中,输入 The chosen time range is {TimeRange:label}
  3. 选择“完成编辑”。
  4. 文本控件将显示文本:所选的时间范围为“过去 24 小时”。

时间参数选项

参数 说明 示例
{TimeRange} 时间范围标签 过去 24 小时
{TimeRange:label} 时间范围标签 过去 24 小时
{TimeRange:value} 时间范围值 > ago (1d)
{TimeRange:query} 时间范围查询 > ago (1d)
{TimeRange:start} 时间范围开始时间 2019/3/20 下午 4:18
{TimeRange:end} 时间范围结束时间 2019/3/21 下午 4:18
{TimeRange:grain} 时间范围粒度 30 分钟

在查询中使用参数选项

requests
| make-series Requests = count() default = 0 on timestamp from {TimeRange:start} to {TimeRange:end} step {TimeRange:grain}

后续步骤

Azure 工作簿入门