使用 Azure 数据资源管理器仪表板直观显示数据

项目
09/09/2024

Azure 数据资源管理器是一项快速且高度可缩放的数据探索服务，适用于日志和遥测数据。在 Azure 数据资源管理器 Web 应用程序中以端到端方式探索数据，从数据引入开始，运行查询，最后构建仪表板。

仪表板是磁贴的集合，可选择按页面进行组织，其中每个磁贴都有一个基础查询和一个可视化表示形式。使用 Web UI，可以将 Kusto 查询语言 (KQL) 查询作为视觉对象以原生方式导出到仪表板，然后根据需要修改其基础查询和视觉对象格式设置。除了便于数据浏览外，这种完全集成的 Azure 数据资源管理器仪表板体验还提供改进的查询和可视化效果性能。

重要

你的数据是安全的。有关用户的仪表板和仪表板相关元数据是使用 Microsoft 管理的密钥静态加密的。

下图显示了一个示例 Azure 数据资源管理器仪表板：

先决条件

Microsoft 帐户或 Microsoft Entra 用户标识。无需 Azure 订阅。
创建 Azure 数据资源管理器群集和数据库。
登录到 Azure 数据资源管理器 Web UI 并添加与群集的连接。

创建新的仪表板

在导航栏中选择“仪表板”>“新建仪表板”。
输入仪表板名称，然后选择“创建”。

添加数据源

单个仪表板可以显示来自一个或多个群集的视觉对象。

选择“更多”菜单 [...] >“数据源”
在“数据源”窗格中，选择“+ 新建数据源”。
在“创建新数据源”窗格中：
1. 输入数据源名称。
2. 输入“群集 URI”区域，然后选择“连接” 。
3. 从下拉列表中选择“数据库”。
4. 输入查询结果缓存最大期限值，以便在此数据源的所有查询上启用查询结果缓存。最大期限可以秒、小时或天为单位。
5. 选择“创建” 。

添加磁贴

仪表板磁贴使用 Kusto 查询语言代码片段来检索数据和呈现视觉对象。每个磁贴/查询可支持一个视觉对象。

从仪表板画布或在顶部菜单栏中选择“添加磁贴”。
在“查询”窗格中，
1. 从下拉菜单中选择数据源。
2. 键入查询，然后选择“运行”。有关生成使用参数的查询的详细信息，请参阅在查询中使用参数。
3. 选择“视觉对象”。
在“视觉对象”选项卡中，选择“视觉对象类型”以选择视觉对象的类型。
选择“应用更改”，将视觉对象固定到仪表板。
可以重设视觉对象的大小，然后选择“保存”图标。

从查询固定磁贴

还可以从 Web UI 的查询选项卡固定查询。

若要固定查询：

创建并运行要在仪表板中可视化其输出的查询。
选择“共享”>“固定到仪表板”。
在“固定到仪表板”窗格中：
1. 提供一个“磁贴名称”。
2. 从查询数据源自动填充“数据源名称”。
3. 选择“如果可能，请使用现有数据源”。
4. 选择“新建”。
5. 输入“仪表板名称”。
6. 选择“创建后查看仪表板”复选框（如果是新仪表板）。
7. 选择“固定”

使用参数

参数可以显著提高仪表板呈现性能，使你能够在查询中尽可能早地使用筛选器值。将参数包含在与磁贴关联的查询中时，将启用筛选。有关如何设置和使用不同类型的参数的详细信息，请参阅在 Azure 数据资源管理器仪表板中使用参数。

磁贴图例

可以更改图例在磁贴中的位置，并使用图例与数据交互。

更改图例位置

如果在仪表板上拥有编辑权限，则可以更改磁贴中图例的位置。切换到“编辑”模式，然后选择“编辑磁贴”铅笔图标。在“视觉对象格式”窗格中的“图例”下，可以选择位置首选项。

与你的数据进行交互

可以使用图例与磁贴中的数据进行交互。可以通过选择图例中的特定项来更改要查看的数据。使用 Ctrl 从所选内容添加或删除项目，按住 Shift 以选择范围。未选择的项目将显示为灰色。

使用“搜索”按钮可以搜索和筛选项目。

使用“反转”按钮来反转所选内容。

使用向上和向下箭头可以通过以下方式浏览列表：

当选择一个项目时，可以使用向上和向下箭头选择上一个或下一个项目。
选择多个项后，可以使用向上和向下箭头更改磁贴上突出显示的项目。

显示用于使用图例与数据交互的按钮的屏幕截图。

查看查询

可以在编辑或查看模式下查看查询。只能在编辑模式下编辑磁贴的基础查询。在查看模式下，可以在新的查询选项卡中修改查询，而无需更改仪表板磁贴的基础查询。

浏览到仪表板。
在要浏览的磁贴上，选择“更多菜单 [...]”>“查看查询”。

将打开一个窗格，其中包含查询和结果表。
选择“新查询选项卡”。继续在 Azure 数据资源管理器 Web UI 查询窗格中编辑查询。

视图查询窗格的屏幕截图，其中查询位于屏幕的上半部分，结果位于下半部分。

注意

使用此流对查询所做的任何编辑都不会反映在原始仪表板中。

使用“共享”菜单授予对仪表板的权限（以便 Microsoft Entra 用户或 Microsoft Entra 组访问该仪表板），更改用户的权限级别以及共享仪表板链接。

重要

若要访问仪表板，仪表板查看者需要以下各项：

用于访问仪表板的链接
仪表板权限
Azure 数据资源管理器群集中基础数据库的访问权限

管理权限

选择仪表板顶部栏中的“共享”菜单项。
从下拉列表中选择“管理权限”。

授予权限

在“仪表板权限”窗格中向用户授予权限：

在“添加新成员”中输入 Microsoft Entra 用户或 Microsoft Entra 组。
在“权限级别”中选择以下值之一：“可查看”或“可编辑” 。
选择添加。

管理仪表板权限。

更改用户权限级别

在“仪表板权限”窗格中更改用户权限级别：

使用搜索框或滚动用户列表来查找用户。
根据需要更改“权限级别”。

若要共享仪表板链接，请执行以下操作之一：

选择“共享”，然后选择“复制链接”
或在“仪表板权限”窗口中，选择“复制链接” 。

导出仪表板

使用文件菜单将仪表板导出到 JSON 文件。在以下情况下，导出仪表板可能非常有用：

版本控制：可使用该文件将仪表板还原到先前版本。
仪表板模板：可将该文件用作创建新仪表板的模板。
手动编辑：可编辑该文件来修改仪表板。该文件可导入回仪表板。

若要导出仪表板，请在仪表板中选择“文件”>“导出到文件”。

仪表板的屏幕截图，其中显示了导出到文件选项。

该文件包含 JSON 格式的仪表板数据，下面的代码片段显示了文件的大致内容。

{
  "id": "{GUID}",
  "eTag": "{TAG}",
  "title": "Dashboard title",
  "tiles": [
    {
      "id": "{GUID}",
      "title": "Tile title",
      "query": "{QUERY}",
      "layout": { "x": 0, "y": 7, "width": 6, "height": 5 },
      "pageId": "{GUID}",
      "visualType": "line",
      "dataSourceId": "{GUID}",
      "visualOptions": {
        "xColumn": { "type": "infer" },
        "yColumns": { "type": "infer" },
        "yAxisMinimumValue": { "type": "infer" },
        "yAxisMaximumValue": { "type": "infer" },
        "seriesColumns": { "type": "infer" },
        "hideLegend": false,
        "xColumnTitle": "",
        "yColumnTitle": "",
        "horizontalLine": "",
        "verticalLine": "",
        "xAxisScale": "linear",
        "yAxisScale": "linear",
        "crossFilterDisabled": false,
        "crossFilter": { "dimensionId": "dragX-timeRange", "parameterId": "{GUID}" },
        "multipleYAxes": {
          "base": { "id": "-1", "columns": [], "label": "", "yAxisMinimumValue": null, "yAxisMaximumValue": null, "yAxisScale": "linear", "horizontalLines": [] },
          "additional": []
        },
        "hideTileTitle": false
      },
      "usedParamVariables": [ "{PARAM}" ]
    }
  ],
  "dataSources": [ {} ],
  "$schema": "https://dataexplorer.azure.cn/static/d/schema/20/dashboard.json",
  "autoRefresh": { "enabled": true, "defaultInterval": "15m", "minInterval": "5m" },
  "parameters": [ {} ],
  "pages": [ { "name": "Primary", "id": "{GUID}" } ],
  "schema_version": "20"
}

通过文件创建新仪表板

你可以使用仪表板文件来创建新仪表板，如下所示：

在主仪表板页中，选择“新建仪表板”>“从文件导入”。
选择要导入的文件。
输入仪表板名称，然后选择“创建”。

通过文件更新或还原现有仪表板

你可以更新现有仪表板或还原以前的版本，如下所示：

在仪表板中，选择“文件”>“替换为文件”。
选择该文件以更新仪表板。
选择“保存更改”。

添加页面

页面是磁贴的可选容器。可以使用页面将磁贴组织成逻辑组，例如按数据源或主题区域。还可以使用页面创建具有多个视图的仪表板，例如具有从摘要页钻取到详细信息页面的仪表板。

在左侧 “页面”窗格中，选择“+ 添加页面”。
若要命名页面，请选择垂直“更多菜单[...]”>“重命名页面”。
向页面添加磁贴。

启用自动刷新

通过自动刷新功能，你可自动更新仪表板上的数据，而无需手动重新加载页面，也无需单击“刷新”按钮。

数据库编辑者可设置默认的自动刷新速率。编辑者和查看者都可以在查看仪表板时更改自动刷新的实际速率。

仪表板中自动刷新可用的不同时间间隔的屏幕截图。

然而，数据库编辑者可能希望限制任何查看者可设置的最小刷新速率，以减少集群负载。设置最小刷新速率后，数据库用户无法设置低于最小值的刷新速率。

选择“更多”菜单 [...]>“自动刷新”。
切换选项以启用“自动刷新”。
为“最小时间间隔”和“默认刷新率”选择值。
选择“应用”，然后保存仪表板。

通过