工作簿时间参数
借助时间参数,可以设置分析的时间上下文,几乎所有的报表都会使用该上下文。 时间参数的设置和使用很简单。 可以使用它们指定要在下拉列表中显示的时间范围。 还可以创建自定义时间范围。
创建时间参数
从编辑模式下的空工作簿开始操作。
选择“添加参数”>“添加参数”。
在打开的新参数窗格中,输入:
- 参数名称:
TimeRange
- 参数类型:
Time range picker
- 必需:
checked
- 可用时间范围:
Last hour
、Last 12 hours
、Last 24 hours
、Last 48 hours
、Last 3 days
、Last 7 days
和Allow custom time range selection
。
- 参数名称:
选择“保存”以创建参数。
这是工作簿在阅读模式下的样子。
引用时间参数
可以使用绑定、KQL 或文本引用时间参数。
使用绑定引用时间参数
选择“添加查询”以添加查询控件,然后选择 Application Insights 资源。
大多数工作簿控件支持“时间范围”范围选取器。 打开“时间范围”下拉列表,然后选择底部“时间范围参数”组中的
{TimeRange}
:- 此控件会将时间范围参数绑定到图表的时间范围。
- 现在示例查询的时间范围为“过去 24 小时”。
运行查询以查看结果。
使用 KQL 引用时间参数
选择“添加查询”以添加查询控件,然后选择 Application Insights 资源。
打开“时间范围”下拉列表,然后选择“时间范围”组中的
Set in query
。 在 KQL 中,使用参数| where timestamp {TimeRange}
输入时间范围筛选器:- 此参数可根据查询评估时间扩展为
| where timestamp > ago(1d)
。 - 此选项是参数的时间范围值。
- 此参数可根据查询评估时间扩展为
运行查询以查看结果。
采用文本引用时间参数
- 向工作簿添加文件控件。
- 在 Markdown 中,输入
The chosen time range is {TimeRange:label}
。 - 选择“完成编辑”。
- 文本控件将显示文本:所选的时间范围为“过去 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}