大网数据广告活动
Azure 监控与自动化

包含自定义参数的 Azure Monitor 工作簿

· 52CE 我爱测

使用预先构建的自定义参数化工作簿简化复杂的报表

作者可以通过工作簿为其使用者创建交互式报表和体验。 通过多种方式支持交互。

参数更改

当工作簿用户更新某个参数时,使用该参数的任何控件将自动刷新并重新绘制,以反映新状态。 这是大多数 Azure 门户报告支持交互的方式。 工作簿以直接方式提供此功能,可最大程度地减少用户的工作量。

详细了解工作簿中的参数

网格、磁贴、图表选择

工作簿允许作者构造这种方案:单击网格中的某行可根据该行的内容更新后续图表。

例如,用户有一个网格,其中显示请求列表以及一些统计信息(例如失败计数)。 他们可以对网格进行设置,使得在单击对应于某个请求的行时会在下面生成详细图表,这些图表仅根据该请求进行筛选以更新其内容。

设置在单击网格行时的交互

  1. 单击“编辑”工具栏项,将工作簿切换到编辑模式。

  2. 使用“添加查询”链接将日志查询控件添加到工作簿。

  3. 选择“日志”作为查询类型,并选择资源类型(例如 Application Insights)以及目标资源。

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

    requests
    | summarize AllRequests = count(), FailedRequests = countif(success == false) by Request = name
    | order by AllRequests desc
    
  5. 选择 Run query 查看结果

  6. 选择查询页脚中的“高级设置”图标(齿轮图标)。 此时会打开“高级设置”窗格。

  7. 选中设置:When an item is selected, export a parameter。

  8. 在选中的设置下,选择“添加参数”,然后填写以下信息。

    1. 要导出的字段:Request
    2. 参数名称:SelectedRequest
    3. 默认值:30All requests
  9. 选择“保存”

    显示高级编辑器的屏幕截图,其中包含用于将字段导出为参数的设置。

  10. 选择 Done Editing。

  11. 使用步骤 2 和 3 添加另一个查询控件。

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

    requests
    | where name == '{SelectedRequest}' or 'All Requests' == '{SelectedRequest}'
    | summarize ['{SelectedRequest}'] = count() by bin(timestamp, 1h)
    
  13. 选择 Run query 查看结果。

  14. 将“可视化效果”更改为 Area chart。

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

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

编辑模式下的前两个查询的屏幕截图。

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

在阅读模式下使用网格单击对报表进行屏幕截图。

导出整行的内容

有时需要导出所选行的全部内容,而不只是导出特定的列。 在这种情况下,请不要在上述步骤 7.1 中设置 Field to export 属性。 工作簿会将整行内容作为 JSON 导出到参数。

在引用 KQL 控件时,请使用 todynamic 函数来分析该 JSON 并访问各个列。

网格单元格单击

工作簿允许作者通过一种特殊类型的称为 link renderer 的网格列呈现器来添加交互。 链接呈现器根据单元格的内容将网格单元格转换为超链接。 工作簿支持多种类型的链接呈现器 - 包括允许打开资源概述边栏选项卡、属性包查看器、App Insights 搜索、使用情况、事务跟踪等的呈现器。

使用网格单元格单击设置交互

  1. 单击“编辑”工具栏项,将工作簿切换到编辑模式。

  2. 使用“添加查询”链接将日志查询控件添加到工作簿。

  3. 选择“日志”作为查询类型,并选择资源类型(例如 Application Insights)以及目标资源。

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

    requests
    | summarize Count = count(), Sample = any(pack_all()) by Request = name
    | order by Count desc
    
  5. 选择 Run query 查看结果

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

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

    1. 样本 - 列呈现器:Link,要打开的视图:Cell Details,链接标签:Sample
    2. 计数 - 列呈现器:Bar,调色板:Blue,最小值:0
    3. 请求 - 列呈现器:Automatic
    4. 选择“保存并关闭”以应用更改

    列设置的选项卡的屏幕截图。

  8. 单击网格中的 Sample 链接之一。 此时会打开一个窗格,其中包含采样请求的详细信息。

    采样请求的详细信息窗格的屏幕截图。

链接呈现器操作

链接操作 单击时的操作
Generic Details 在属性网格上下文选项卡中显示行值
Cell Details 在属性网格上下文选项卡中显示单元格值。当单元包含带有信息的动态类型(例如,包含位置、角色实例等请求属性的 JSON)时,此操作非常有用。
Cell Details 在属性网格上下文选项卡中显示单元格值。当单元包含带有信息的动态类型(例如,包含位置、角色实例等请求属性的 JSON)时,此操作非常有用。
Custom Event Details 使用单元格中的自定义事件 ID (itemId) 打开 Application Insights 搜索详细信息
* Details 类似于自定义事件详细信息,只是在依赖项、异常、页面视图、请求和跟踪方面不同。
Custom Event User Flows 打开围绕单元格中自定义事件名称构建的 Application Insights 用户流体验
* User Flows 类似于自定义事件用户流,只是在异常、页面视图和请求方面不同
User Timeline 使用单元格中的用户 ID (user_Id) 打开用户时间线
Session Timeline 针对单元中的值打开 Application Insights 搜索体验(例如,当单元格中的值为 abc 时,搜索文本“abc”)
Resource overview 根据单元格中的资源 ID 值在门户中打开资源的概述

条件可见性

工作簿允许用户根据参数的值显示或隐藏某些控件。 这样,作者便可以根据用户输入或遥测状态生成不同外观的报告。 例如,当一切顺利时,只向使用者显示摘要;遇到问题时显示完整详细信息。

使用条件可见性设置交互

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

  2. 在顶部添加一个新参数:

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

    选择“添加参数”按钮后,将显示“编辑参数”窗格。

  3. 将参数值设置为 Yes

    “完成编辑”按钮上方是下拉菜单,可在其中设置参数值

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

  5. 选中设置 Make this item conditionally visible

    1. 如果 ShowDetails 参数值 equals Yes,则显示此项
  6. 选择“完成编辑”以提交更改。

  7. 在工作簿工具栏上选择“完成编辑”以进入读取模式。

  8. 将参数 ShowDetails 的值切换为 No。 请注意下面的图表已消失。

下图显示了当 ShowDetails 为 Yes 时的内容可视情况

显示当图表可见时的条件可见性的屏幕截图

下图显示了当 ShowDetails 为 No 时的内容隐藏情况

显示当图表隐藏时的条件可见性的屏幕截图

网格和图表中的多个选择的交互

选中一行(或多行)时,查询和指标步骤也可以导出一个或多个参数。

显示具有多个参数的导出参数设置的屏幕截图。

  1. 在显示网格的查询步骤中,转到“高级设置”。
  2. 选中 When items are selected, export parameters 复选框。 此时将显示其他控件。
  3. 选中 allow selection of multiple values 复选框。
    1. 显示的可视化效果将允许多选,导出的参数值将是值的数组,类似于使用多选下拉参数时的情况。
    2. 如果未选中,则显示可视化效果将仅遵循选中的最后一个项目。 一次仅导出一个值。
  4. 对于要导出的每个参数,请使用“添加参数”按钮。 此时将出现一个弹出窗口,其中包含要导出的参数的设置。

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

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

Note: 对于多选,将仅导出唯一值,你将不会看到“1,1,2,1”等输出数组值,而将看到“1,2”输出值。

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

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

后续步骤

  • 开始详细了解工作簿丰富的可视化效果选项。
  • 控制并共享对工作簿资源的访问权限。

历史资料。此文对应 2022-08-12 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / Azure 中文运维文档历史快照
适用范围
历史中文快照 2022-08-12;详见原文产品版本;文档日期 07/20/2020
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。