工作簿时间参数Workbook time parameters

时间参数使用户可以设置分析的时间上下文,几乎所有的报表都会使用它。Time parameters allow users to set the time context of analysis and is used by almost all reports. 时间参数的设置和使用相对简单 - 允许作者指定要在下拉列表中显示的时间范围,包括自定义时间范围的选项。It is relatively simple to setup and use - allowing authors to specify the time ranges to show in the drop-down, including the option for custom time ranges.

创建时间参数Creating a time parameter

  1. 从编辑模式下的空工作簿开始操作。Start with an empty workbook in edit mode.

  2. 从工作簿内的链接中选择“添加参数”。Choose Add parameters from the links within the workbook.

  3. 单击蓝色的“添加参数”按钮。Click on the blue Add Parameter button.

  4. 在弹出的“新建参数”窗格中,输入:In the new parameter pane that pops up enter:

    1. 参数名称:TimeRangeParameter name: TimeRange
    2. 参数类型:Time range pickerParameter type: Time range picker
    3. 必需:checkedRequired: checked
    4. 可用时间范围:过去 1 小时、过去 12 小时、过去 24 小时、过去 48 小时、过去 3 天、过去 7 天,以及允许自定义时间范围选择Available time ranges: Last hour, Last 12 hours, Last 24 hours, Last 48 hours, Last 3 days, Last 7 days and Allow custom time range selection
  5. 从工具栏中选择“保存”以创建参数。Choose 'Save' from the toolbar to create the parameter.

    显示创建时间范围参数的图像

这就是工作簿在读取模式下的外观。This is how the workbook will look like in read-mode.

在读取模式下显示时间范围参数的图像

引用时间参数Referencing a time parameter

通过绑定的方式Via Bindings

  1. 向工作簿添加查询控件,然后选择 Application Insights 资源。Add a query control to the workbook and select an Application Insights resource.

  2. 大多数工作簿控件支持“时间范围”范围选取器。Most workbook controls support a Time Range scope picker. 打开“时间范围”下拉列表,然后选择底部时间范围参数组中的 {TimeRange}Open the Time Range drop-down and select the {TimeRange} in the time rang parameters group at the bottom.

  3. 这会将时间范围参数绑定到图表的时间范围。This binds the time range parameter to the time range of the chart. 现在示例查询的时间范围为“过去 24 小时”。The time scope of the sample query is now Last 24 hours.

  4. 运行查询以查看结果Run query to see the results

    显示通过绑定引用时间范围参数的图像

在 KQL 中In KQL

  1. 在工作簿中添加查询控件,然后选择 Application Insights 资源。Add a query control to the workbook and select an Application Insights resource.

  2. 在 KQL 中,输入使用以下参数的时间范围筛选器:| where timestamp {TimeRange}In the KQL, enter a time scope filter using the parameter: | where timestamp {TimeRange}

  3. 这会将查询计算时间扩大到 | where timestamp > ago(1d),这就是参数的时间范围值。This expands on query evaluation time to | where timestamp > ago(1d), which is the time range value of the parameter.

  4. 运行查询以查看结果Run query to see the results

    显示在 KQL 中引用时间范围的图像

在文本中In Text

  1. 向工作簿添加文件控件。Add a text control to the workbook.
  2. 在 Markdown 中,输入 The chosen time range is {TimeRange:label}In the markdown, enter The chosen time range is {TimeRange:label}
  3. 选择“完成编辑”Choose Done Editing
  4. 文本控件将显示文本:所选的时间范围为“过去 24 小时”The text control will show text: The chosen time range is Last 24 hours

时间参数选项Time parameter options

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

在查询中使用参数选项Using parameter options in a query

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

后续步骤Next steps

  • 开始详细了解工作簿丰富的可视化效果选项。Get started learning more about workbooks many rich visualizations options.
  • 控制并共享对工作簿资源的访问权限。Control and share access to your workbook resources.