工作簿配置选项

可以使用“设置”选项卡中的设置配置工作簿以满足需求。如果查询或指标步骤显示基于时间的数据,则“高级设置”选项卡上会提供更多设置。

工作簿设置

工作簿设置包含以下选项卡,可帮助你配置工作簿。

“设置”选项卡 说明
资源 此选项卡包含在此工作簿中显示为默认选择的资源。
标记为“所有者”的资源是保存工作簿的位置,以及在浏览时看到的工作簿和模板的位置。 无法移除所有者资源。
可以通过选择“添加资源”来添加默认资源。 可以通过选择一个或多个资源并选择“删除选定的资源”来移除资源。 添加和移除资源后,选择“应用更改”。
版本 此选项卡包含此工作簿的所有可用版本的列表。 选择版本并使用工具栏比较、查看或还原版本。 以前的工作簿版本在 90 天内可用。
  • 比较:将以前工作簿的 JSON 与最近保存的版本进行比较。
  • 查看:在上下文窗格中打开工作簿的所选版本。
  • 还原:使用所选版本的内容保存工作簿的新副本,并覆盖任何现有当前内容。 你将收到确认此操作的提示。

Style 在此选项卡上,可以为整个工作簿设置填充和间距样式。 可能的选项包括“宽”、“标准”、“窄”和“无”。 默认样式设置为“标准”。
Pin 处于固定模式期间,可以选择“固定工作簿”以将此工作簿中的组件固定到仪表板。 选择“链接到工作簿”可将此工作簿的静态链接固定到仪表板上。 可以在工作簿中选择特定组件进行固定。
受信任的主机 在此选项卡上,可以启用受信任的源或将此工作簿标记为在此浏览器中受信任。 有关详细信息,请参阅受信任的主机

“版本”选项卡

Screenshot that shows the versions tab of the workbook's Settings pane.

版本比较

Screenshot that shows version comparison in the Compare Workbook Versions screen.

受信任的主机

启用受信任的源或将此工作簿标记为在此浏览器中受信任。

控制 定义
将工作簿标记为“受信任” 如果启用,此工作簿可以调用任何终结点,无论主机是否标记为受信任。 如果工作簿是新工作簿、保存的现有工作簿或显式标记为受信任工作簿,则工作簿受信任。
URL 网格 用于显式添加受信任主机的网格。

时间刷

时间范围刷使用户可以在图表上“刷取”或“推移”区域,并将该区域输出作为参数值。

Screenshot that shows workbook time-brush settings.

还可以选择仅在显式刷取范围时才导出参数:

  • 如果清除此设置(默认),则参数始终具有值。 未刷取参数时,值是图表中显示的完整时间范围。
  • 如果选择此设置,则在用户刷取参数之前,参数没有值。 仅在用户刷取参数后才设置值。

在指标图表中刷取

在指标图表上启用时间刷时,可以通过在时间图表上拖动鼠标来“刷取”时间。

Screenshot of a metrics time-brush in progress.

刷取停止后,指标图表会放大到该区域,并将范围导出为时间范围参数。 右上角工具栏上的图标处于活动状态,可将时间范围重置回其原始的非缩放时间范围。

在查询图表中刷取

在查询图表上启用时间刷时,会显示可以拖动的指示器,你还可以在时间图表上刷取范围。

Screenshot of time-brushing a query chart.

刷取停止后,查询图表会将该区域显示为时间范围参数,但不会放大。 此行为与指标图表的行为不同。 由于用户编写的查询的复杂性,工作簿可能无法正确地直接在查询内容中更新查询使用的范围。 如果查询在使用时间范围参数,则可以改用全局参数来获取此行为。

右上角工具栏上的图标处于活动状态,可将时间范围重置回其原始的非缩放时间范围。

交互性

可通过多种方式在工作簿中创建交互式报表和体验:

  • 参数:当更新某个参数时,使用该参数的任何控件都会自动刷新并重新绘制,以反映新值。 此行为是大多数 Azure 门户报表支持交互性的方式。 工作簿以直接方式提供此功能,可最大程度地减少用户的工作量。
  • 网格、磁贴和图表选择:可以构造以下方案:在网格中选择某行可基于该行的内容更新后续图表。 例如,你可能有一个网格,其中显示请求列表以及一些统计信息(例如失败计数)。 可以对其进行设置,以便如果选择某个请求的对应行,以下详细图表会更新为仅显示该请求。 了解如何设置网格行单击
  • 网格单元格单击:可以使用称为链接呈现器的特殊类型的网格列呈现器来添加交互。 链接呈现器根据单元格的内容将网格单元格转换为超链接。 工作簿支持多种链接呈现器,包括打开资源概述窗格、属性包查看器以及 Application Insights 搜索、使用情况和事务跟踪的呈现器。 了解如何设置网格单元格单击
  • 条件可见性:可以基于参数的值使控件出现或消失。 这样,你便可以根据用户输入或遥测状态生成不同外观的报表。 例如,当没有问题时,你可以向使用者显示摘要。 还可以在出现问题时显示详细信息。 了解如何设置条件可见性
  • 导出具有多重选择的参数:选择一行或多行时,可以从查询和指标工作簿组件导出参数。 了解如何在网格和图表中设置多重选择

设置网格行单击

  1. 选择“编辑”,以确保处于编辑模式。

  2. 选择“添加查询”,将日志查询控件添加到工作簿。

  3. 选择日志查询类型、资源类型和目标资源。

  4. 使用查询编辑器输入用于分析的 KQL:

    requests
    | summarize AllRequests = count(), FailedRequests = countif(success == false) by Request = name
    | order by AllRequests desc
    
  5. 选择“运行查询”以查看结果。

  6. 选择“高级设置”以打开“高级设置”窗格。

  7. 选中“选择项时,将导出参数”复选框。

  8. 选择“添加参数”并填写以下信息:

    • 要导出的字段:Request
    • 参数名称:SelectedRequest
    • 默认值:All requests

    Screenshot that shows the Advanced Settings workbook editor with settings for exporting fields as parameters.

  9. 可选。 如果要导出所选行的整个内容而不是特定列,请将“要导出的字段”保留为未设置状态。 整个行的内容会作为 JSON 导出到参数。 在引用 KQL 控件时,请使用 todynamic 函数来分析该 JSON 并访问各个列。

  10. 选择“保存”。

  11. 选择“完成编辑”。

  12. 如前面的步骤所示,添加另一个查询控件。

  13. 使用查询编辑器输入用于分析的 KQL。

    requests
    | where name == '{SelectedRequest}' or 'All Requests' == '{SelectedRequest}'
    | summarize ['{SelectedRequest}'] = count() by bin(timestamp, 1h)
    
  14. 选择“运行查询”以查看结果。

  15. 将“可视化效果”更改为“面积图”。

  16. 选择要在第一个网格中选中的行。 请注意,下面的面积图已根据所选请求筛选了内容。

在编辑模式下,生成的报表如此示例所示:

Screenshot that shows workbooks with the first two queries in edit mode.

下图显示了基于相同原理的、处于只读模式的更精致交互式报表。 报表使用网格单击来导出参数,而这些参数又在两个图表和一个文本块中使用。

Screenshot that shows a workbook report using grid clicks.

设置网格单元格单击

  1. 选择“编辑”,以确保处于编辑模式。

  2. 选择“添加查询”,将日志查询控件添加到工作簿。

  3. 选择日志查询类型、资源类型和目标资源。

  4. 使用查询编辑器输入用于分析的 KQL:

    requests
    | summarize Count = count(), Sample = any(pack_all()) by Request = name
    | order by Count desc
    
  5. 选择“运行查询”以查看结果。

  6. 选择“列设置”打开“设置”窗格。

  7. 在“列”部分,设置:

    • 示例
      • 列呈现器:Link
      • 要打开的视图:Cell Details
      • 链接标签:Sample
    • 计数
      • 列呈现器:Bar
      • 调色板:Blue
      • 最小值:0
    • 请求
      • 列呈现器:Automatic
  8. 选择“保存并关闭”以应用更改。

    Screenshot that shows the Edit column settings pane.

  9. 在网格中选择“示例”链接以打开包含示例请求详细信息的窗格。

    Screenshot that shows the Details pane of the sample request.

了解链接操作如何工作以增强工作簿交互性。

设置条件可见性

  1. 按照设置网格行单击部分中的步骤来设置两个交互式控件。

  2. 使用以下值添加新参数:

    • 参数名称:ShowDetails
    • 参数类型:Drop down
    • 必需:checked
    • 从以下位置获取数据:JSON
    • JSON 输入:["Yes", "No"]
  3. 选择“保存”以提交更改。

    Screenshot that shows editing an interactive parameter in workbooks.

  4. 将参数值设置为 Yes

    Screenshot that shows setting an interactive parameter value in a workbook.

  5. 在带有面积图的查询控件中,选择“高级设置”(齿轮图标)。

  6. 如果“ShowDetails”设置为 Yes,请选择“使此项目有条件可见”。

  7. 选择“完成编辑”以提交更改。

  8. 在工作簿工具栏上,选择“完成编辑”。

  9. 将“ShowDetails”的值切换为 No。 请注意下面的图表已消失。

下图显示了“ShowDetails”为 Yes 的情况:

Screenshot that shows a workbook with a conditional component that's visible.

下图显示了“ShowDetails”为 No 的隐藏情况:

Screenshot that shows a workbook with a conditional component that's hidden.

在网格和图表中设置多重选择

选择一行或多行时,查询和指标组件可以导出参数。

Screenshot that shows the workbooks export parameters settings with multiple parameters.

  1. 在显示网格的查询组件中,选择“高级设置”。
  2. 选中“选择这些项时,将导出参数”复选框。
  3. 选中“允许选择多个值”复选框。
    • 显示的可视化效果将允许多选,导出的参数值将是值的数组,类似于使用多选下拉参数时的情况。
    • 如果处于清除状态,则显示可视化效果仅捕获最后一个所选项,并且一次仅导出单个值。
  4. 对要导出的每个参数使用“添加参数”。 此时会出现一个弹出窗口,其中包含用于要导出的参数的设置。

启用单选后,可以指定要导出原始数据的哪个字段。 字段包括参数名称、参数类型以及未选择任何内容时所要使用的默认值。

启用多选后,可指定要导出原始数据的哪个字段。 字段包括参数名称、参数类型、quote with 和分隔符。 在查询中替换箭头值时,使用 quote with 和分隔符值将其转换为文本。 在多选中,如果未选中任何值,则默认值为空数组。

注意

对于多选,仅导出唯一值。 例如,看不到输出数组值,如“1,1,2,1”。 数组输出将为“1,2”。

如果在导出设置中将“要导出的字段”保留为空,则数据中的所有可用字段都将导出为键:值对的字符串化 JSON 对象。 对于网格和标题,字符串包含网格中的字段。 对于图表,可用字段会是 x、y、系列和标签(具体取决于图表类型)。

虽然默认行为是将参数导出为文本,但如果知道字段是订阅或资源 ID,请以导出参数类型形式使用该信息。 随后可以在需要这些参数类型的下游位置使用这类参数。