工作簿配置选项
可以使用“设置”选项卡中的设置配置工作簿以满足需求。如果查询或指标步骤显示基于时间的数据,则“高级设置”选项卡上会提供更多设置。
工作簿设置
工作簿设置包含以下选项卡,可帮助你配置工作簿。
“设置”选项卡 | 说明 |
---|---|
资源 | 此选项卡包含在此工作簿中显示为默认选择的资源。 标记为“所有者”的资源是保存工作簿的位置,以及在浏览时看到的工作簿和模板的位置。 无法移除所有者资源。 可以通过选择“添加资源”来添加默认资源。 可以通过选择一个或多个资源并选择“删除选定的资源”来移除资源。 添加和移除资源后,选择“应用更改”。 |
版本 | 此选项卡包含此工作簿的所有可用版本的列表。 选择版本并使用工具栏比较、查看或还原版本。 以前的工作簿版本在 90 天内可用。
|
Style | 在此选项卡上,可以为整个工作簿设置填充和间距样式。 可能的选项包括“宽”、“标准”、“窄”和“无”。 默认样式设置为“标准”。 |
Pin | 处于固定模式期间,可以选择“固定工作簿”以将此工作簿中的组件固定到仪表板。 选择“链接到工作簿”可将此工作簿的静态链接固定到仪表板上。 可以在工作簿中选择特定组件进行固定。 |
受信任的主机 | 在此选项卡上,可以启用受信任的源或将此工作簿标记为在此浏览器中受信任。 有关详细信息,请参阅受信任的主机。 |
“版本”选项卡
版本比较
受信任的主机
启用受信任的源或将此工作簿标记为在此浏览器中受信任。
控制 | 定义 |
---|---|
将工作簿标记为“受信任” | 如果启用,此工作簿可以调用任何终结点,无论主机是否标记为受信任。 如果工作簿是新工作簿、保存的现有工作簿或显式标记为受信任工作簿,则工作簿受信任。 |
URL 网格 | 用于显式添加受信任主机的网格。 |
时间刷
时间范围刷使用户可以在图表上“刷取”或“推移”区域,并将该区域输出作为参数值。
还可以选择仅在显式刷取范围时才导出参数:
- 如果清除此设置(默认),则参数始终具有值。 未刷取参数时,值是图表中显示的完整时间范围。
- 如果选择此设置,则在用户刷取参数之前,参数没有值。 仅在用户刷取参数后才设置值。
在指标图表中刷取
在指标图表上启用时间刷时,可以通过在时间图表上拖动鼠标来“刷取”时间。
刷取停止后,指标图表会放大到该区域,并将范围导出为时间范围参数。 右上角工具栏上的图标处于活动状态,可将时间范围重置回其原始的非缩放时间范围。
在查询图表中刷取
在查询图表上启用时间刷时,会显示可以拖动的指示器,你还可以在时间图表上刷取范围。
刷取停止后,查询图表会将该区域显示为时间范围参数,但不会放大。 此行为与指标图表的行为不同。 由于用户编写的查询的复杂性,工作簿可能无法正确地直接在查询内容中更新查询使用的范围。 如果查询在使用时间范围参数,则可以改用全局参数来获取此行为。
右上角工具栏上的图标处于活动状态,可将时间范围重置回其原始的非缩放时间范围。
交互性
可通过多种方式在工作簿中创建交互式报表和体验:
- 参数:当更新某个参数时,使用该参数的任何控件都会自动刷新并重新绘制,以反映新值。 此行为是大多数 Azure 门户报表支持交互性的方式。 工作簿以直接方式提供此功能,可最大程度地减少用户的工作量。
- 网格、磁贴和图表选择:可以构造以下方案:在网格中选择某行可基于该行的内容更新后续图表。 例如,你可能有一个网格,其中显示请求列表以及一些统计信息(例如失败计数)。 可以对其进行设置,以便如果选择某个请求的对应行,以下详细图表会更新为仅显示该请求。 了解如何设置网格行单击。
- 网格单元格单击:可以使用称为链接呈现器的特殊类型的网格列呈现器来添加交互。 链接呈现器根据单元格的内容将网格单元格转换为超链接。 工作簿支持多种链接呈现器,包括打开资源概述窗格、属性包查看器以及 Application Insights 搜索、使用情况和事务跟踪的呈现器。 了解如何设置网格单元格单击。
- 条件可见性:可以基于参数的值使控件出现或消失。 这样,你便可以根据用户输入或遥测状态生成不同外观的报表。 例如,当没有问题时,你可以向使用者显示摘要。 还可以在出现问题时显示详细信息。 了解如何设置条件可见性。
- 导出具有多重选择的参数:选择一行或多行时,可以从查询和指标工作簿组件导出参数。 了解如何在网格和图表中设置多重选择。
设置网格行单击
选择“编辑”,以确保处于编辑模式。
选择“添加查询”,将日志查询控件添加到工作簿。
选择日志查询类型、资源类型和目标资源。
使用查询编辑器输入用于分析的 KQL:
requests | summarize AllRequests = count(), FailedRequests = countif(success == false) by Request = name | order by AllRequests desc
选择“运行查询”以查看结果。
选择“高级设置”以打开“高级设置”窗格。
选中“选择项时,将导出参数”复选框。
选择“添加参数”并填写以下信息:
- 要导出的字段:
Request
- 参数名称:
SelectedRequest
- 默认值:
All requests
- 要导出的字段:
可选。 如果要导出所选行的整个内容而不是特定列,请将“要导出的字段”保留为未设置状态。 整个行的内容会作为 JSON 导出到参数。 在引用 KQL 控件时,请使用
todynamic
函数来分析该 JSON 并访问各个列。选择“保存”。
选择“完成编辑”。
如前面的步骤所示,添加另一个查询控件。
使用查询编辑器输入用于分析的 KQL。
requests | where name == '{SelectedRequest}' or 'All Requests' == '{SelectedRequest}' | summarize ['{SelectedRequest}'] = count() by bin(timestamp, 1h)
选择“运行查询”以查看结果。
将“可视化效果”更改为“面积图”。
选择要在第一个网格中选中的行。 请注意,下面的面积图已根据所选请求筛选了内容。
在编辑模式下,生成的报表如此示例所示:
下图显示了基于相同原理的、处于只读模式的更精致交互式报表。 报表使用网格单击来导出参数,而这些参数又在两个图表和一个文本块中使用。
设置网格单元格单击
选择“编辑”,以确保处于编辑模式。
选择“添加查询”,将日志查询控件添加到工作簿。
选择日志查询类型、资源类型和目标资源。
使用查询编辑器输入用于分析的 KQL:
requests | summarize Count = count(), Sample = any(pack_all()) by Request = name | order by Count desc
选择“运行查询”以查看结果。
选择“列设置”打开“设置”窗格。
在“列”部分,设置:
- 示例
- 列呈现器:
Link
- 要打开的视图:
Cell Details
- 链接标签:
Sample
- 列呈现器:
- 计数
- 列呈现器:
Bar
- 调色板:
Blue
- 最小值:
0
- 列呈现器:
- 请求
- 列呈现器:
Automatic
- 列呈现器:
- 示例
选择“保存并关闭”以应用更改。
在网格中选择“示例”链接以打开包含示例请求详细信息的窗格。
链接呈现器操作
了解链接操作如何工作以增强工作簿交互性。
设置条件可见性
按照设置网格行单击部分中的步骤来设置两个交互式控件。
使用以下值添加新参数:
- 参数名称:
ShowDetails
- 参数类型:
Drop down
- 必需:
checked
- 从以下位置获取数据:
JSON
- JSON 输入:
["Yes", "No"]
- 参数名称:
选择“保存”以提交更改。
将参数值设置为
Yes
。在带有面积图的查询控件中,选择“高级设置”(齿轮图标)。
如果“ShowDetails”设置为
Yes
,请选择“使此项目有条件可见”。选择“完成编辑”以提交更改。
在工作簿工具栏上,选择“完成编辑”。
将“ShowDetails”的值切换为
No
。 请注意下面的图表已消失。
下图显示了“ShowDetails”为 Yes
的情况:
下图显示了“ShowDetails”为 No
的隐藏情况:
在网格和图表中设置多重选择
选择一行或多行时,查询和指标组件可以导出参数。
- 在显示网格的查询组件中,选择“高级设置”。
- 选中“选择这些项时,将导出参数”复选框。
- 选中“允许选择多个值”复选框。
- 显示的可视化效果将允许多选,导出的参数值将是值的数组,类似于使用多选下拉参数时的情况。
- 如果处于清除状态,则显示可视化效果仅捕获最后一个所选项,并且一次仅导出单个值。
- 对要导出的每个参数使用“添加参数”。 此时会出现一个弹出窗口,其中包含用于要导出的参数的设置。
启用单选后,可以指定要导出原始数据的哪个字段。 字段包括参数名称、参数类型以及未选择任何内容时所要使用的默认值。
启用多选后,可指定要导出原始数据的哪个字段。 字段包括参数名称、参数类型、quote with 和分隔符。 在查询中替换箭头值时,使用 quote with 和分隔符值将其转换为文本。 在多选中,如果未选中任何值,则默认值为空数组。
注意
对于多选,仅导出唯一值。 例如,看不到输出数组值,如“1,1,2,1”。 数组输出将为“1,2”。
如果在导出设置中将“要导出的字段”保留为空,则数据中的所有可用字段都将导出为键:值对的字符串化 JSON 对象。 对于网格和标题,字符串包含网格中的字段。 对于图表,可用字段会是 x、y、系列和标签(具体取决于图表类型)。
虽然默认行为是将参数导出为文本,但如果知道字段是订阅或资源 ID,请以导出参数类型形式使用该信息。 随后可以在需要这些参数类型的下游位置使用这类参数。