你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

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

项目
03/08/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 数据资源管理器仪表板中使用参数。

查看查询

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

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

此时会打开一个窗格，其中包含查询和结果表。
选择“新建查询”选项卡。继续在 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.com/static/d/schema/20/dashboard.json",
  "autoRefresh": { "enabled": true, "defaultInterval": "15m", "minInterval": "5m" },
  "parameters": [ {} ],
  "pages": [ { "name": "Primary", "id": "{GUID}" } ],
  "schema_version": "20"
}

通过文件创建新仪表板

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

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

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

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

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

添加页面

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

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

启用自动刷新

自动刷新是一项功能，可用于自动更新仪表板上的数据，而无需手动重新加载页面或单击刷新按钮。

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

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

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

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