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

在 Grafana 中可视化 Azure 数据资源管理器中的数据

Grafana 是一个分析平台，可在其中查询和可视化数据，然后基于可视化效果创建和共享仪表板。 Grafana 提供了 Azure 数据资源管理器 插件，使你能够连接到 Azure 数据资源管理器中的数据并将其可视化。 该插件适用于 Azure 托管 Grafana 和自承载 Grafana。

本文介绍如何 将群集配置为 Grafana 的数据源 ，以及如何 在 Grafana 中可视化 Azure 托管 Grafana 和自承载 Grafana 中的数据。 若要按照本文中的示例进行操作， 请引入 StormEvents 示例数据。 StormEvents 示例数据集包含 来自国家环境信息中心与天气相关的数据。

先决条件

• 对于 Azure 托管 Grafana，为 Azure 帐户和 Azure 托管 Grafana 实例。
• 对于自承载 Grafana、适用于操作系统的 Grafana 版本 5.3.0 或更高版本和适用于 Grafana 的 Azure 数据资源管理器插件。 需要插件 3.0.5 或更高版本才能使用 Grafana 查询生成器。
• Azure 数据资源管理器群集和数据库。 可以 创建免费群集 或 创建完整群集。 若要确定哪种方案最适合你，检查功能比较。

配置数据源

若要将 Azure 数据资源管理器 配置为数据源，请按照 Grafana 环境的步骤进行操作。

Microsoft 托管 Grafana

将托管标识添加到“查看者”角色

默认情况下，托管 Grafana 为每个新工作区创建系统分配的托管标识。 可以使用它访问 Azure 数据资源管理器群集。

1. 在 Azure 门户中，转到 Azure 数据资源管理器群集。

2. 在“ 概述 ”部分中，选择包含 StormEvents 示例数据的数据库。

   

3. 选择 “权限>”“添加>查看器”。

   

4. 在搜索框中，输入托管 Grafana 工作区名称。

5. 在搜索结果中，选择与工作区名称匹配的结果，然后选择 “选择”。

   

将 Azure 数据资源管理器 设置为 Grafana 数据源

托管 Grafana 工作区预安装了 Azure 数据资源管理器 插件。

1. 在Azure 门户，转到托管 Grafana 工作区。

2. 在 “概述”下，选择 “终结点 ”链接以打开 Grafana UI。

3. 在 Grafana 的左侧菜单中，选择齿轮图标。 然后选择“ 数据源”。

   

4. 选择“Azure 数据资源管理器数据源”。

   

5. 在“连接详细信息”中，输入 Azure 数据资源管理器群集 URL。

   

6. 选择“保存并测试”。

自承载 Grafana

创建服务主体

可以在 Azure 门户 或使用 Azure CLI 命令行体验创建服务主体。 创建服务主体后，将获取四个连接属性的值，这些属性将在后续步骤中使用。

Azure 门户

1. 按照Azure 门户文档中的说明进行操作。 使用以下特定信息：

   1. 在将应用程序分配给角色部分，将“读取者”的角色类型分配给 Azure 数据资源管理器群集 。

   2. 在 “获取登录值 ”部分中，复制步骤中涵盖的三个属性的值： 目录 ID (租户 ID) 、 应用程序 ID 和 密码。

2. 在 Azure 门户中，选择“订阅”。 然后复制在其中创建了服务主体的订阅的 ID。

   

Azure CLI

1. 使用以下命令创建服务主体。 设置适用范围和角色类型 reader。

   az ad sp create-for-rbac --name "https://{UrlToYourDashboard}:{PortNumber}" --role "reader" \
                            --scopes /subscriptions/{SubID}/resourceGroups/{ResourceGroupName}
   

   有关详细信息，请参阅 使用 Azure CLI 创建 Azure 服务主体。

2. 命令返回结果集，如以下示例所示。 复制 、 password和 tenant 属性的值appId。

   {
     "appId": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
     "displayName": "{UrlToYourDashboard}:{PortNumber}",
     "name": "https://{UrlToYourDashboard}:{PortNumber}",
     "password": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
     "tenant": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
   }
   

3. 获取订阅列表：

   az account list --output table
   

   复制相应的订阅 ID。

   

将服务主体添加到“查看者”角色

有了服务主体后，可以将其添加到 Azure 数据资源管理器 数据库中的“查看者”角色。 可在 Azure 门户中的“权限”下执行此任务，也可以使用管理命令在“查询”下执行此任务 。

Azure 门户：权限

1. 在 Azure 门户中，转到 Azure 数据资源管理器群集。

2. 在“ 概述 ”部分中，选择包含 StormEvents 示例数据的数据库。

   

3. 选择“权限”>“添加”。

   

4. 在“ 添加数据库权限”下，选择“ 查看者 ”角色，然后选择“ 选择主体”。

   

5. 搜索创建的服务主体。 选择主体，然后选择 “选择”。

   

6. 选择“保存”。

   

管理命令：查询

1. 在Azure 门户，转到 Azure 数据资源管理器 群集，然后选择“查询”。

   

2. 在查询窗口中运行以下命令。 使用Azure 门户或 Azure CLI 中的应用程序 ID 和租户 ID。

   .add database {TestDatabase} viewers ('aadapp={ApplicationID};{TenantID}')
   

   命令返回结果集。 在以下示例中，第一行适用于数据库中的现有用户。 第二行适用于刚添加的服务主体。

   

指定属性并测试连接

将服务主体分配给“查看者”角色后，现在可以在 Grafana 实例中指定属性，并测试与 Azure 数据资源管理器的连接。

1. 在 Grafana 的左侧菜单中，选择齿轮图标。 然后选择“ 数据源”。

   

2. 选择“添加数据源”。

3. 在“数据源/新建”页上，输入数据源的名称，然后选择“Azure 数据资源管理器数据源”类型。

   

4. 在“设置连接详细信息”>中，以 格式https://{ClusterName}.{Region}.kusto.windows.net输入群集的名称。 输入Azure 门户或 Azure CLI 中的其他值。 使用以下映射信息作为指南。

   Grafana UI	Azure 门户	Azure CLI
   订阅 ID	订阅 ID	SubscriptionId
   租户 ID	Directory ID	tenant
   客户端 ID	应用程序 ID	appId
   客户端机密	密码	password

   

5. 选择“保存并测试”。

   如果测试成功，请转到下一部分。 如果遇到任何问题，检查 Grafana 中指定的值，并查看前面的步骤。

优化查询

可以使用两个功能进行查询优化：

• 优化仪表板查询呈现性能
• 启用弱一致性

若要执行优化，请在“数据源”>“设置”>“查询优化”中，执行所需的更改 。

优化仪表板查询呈现性能

当一个或多个用户多次呈现仪表板或视觉对象时，Grafana 默认会向 Azure 数据资源管理器发送至少一个查询。 启用查询结果缓存以提高仪表板呈现性能并减少 Azure 数据资源管理器 群集上的负载。

在指定的时间范围内，Azure 数据资源管理器将使用结果缓存来检索以前的结果，并且不会运行不必要的查询。 当多个用户使用同一仪表板时，使用此功能可以显著减少资源负载并提高性能。

若要启用结果缓存呈现，请在“ 查询优化 ”窗格中执行以下操作：

1. 关闭 “使用动态缓存”。
2. 在“缓存最大有效期”中，输入要使用缓存结果的分钟数。

启用弱一致性

群集配置为具有强一致性。 此默认配置保证查询结果与群集中的所有更改一起处于最新状态。

启用弱一致性时，查询结果在更改群集后可能会有 1 到 2 分钟的滞后时间。 但是，弱一致性可能会增加视觉呈现时间。 如果即时一致性不重要，并且性能处于边际状态，请启用弱一致性以提高性能。 有关详细信息，请参阅 查询一致性。

若要启用弱一致性，请在“查询优化”窗格中，选择“数据一致性弱>”。

可视化数据

已完成将 Azure 数据资源管理器 配置为 Grafana 的数据源。 现在，可以可视化数据了。

以下基本示例同时使用查询生成器模式和查询编辑器的原始模式。 建议查看 Azure 数据资源管理器 的写入查询，以获取针对数据集运行的其他查询的示例。

1. 在 Grafana 的左侧菜单上，选择加号图标。 然后选择“ 仪表板”。

   

2. 在“添加”选项卡下选择“图形”。

   

3. 在图形窗格中，选择“ 面板标题>编辑”。

   

4. 在窗格底部，选择“ 数据源”，然后选择配置的数据源。

   

查询生成器模式

使用查询生成器模式定义查询。

1. 在数据源下，选择“ 数据库 ”，然后从下拉列表中选择数据库。

2. 选择“ 从 ”，然后从下拉列表中选择表。

   

3. 定义表后，筛选数据：

   1. 选择 + “ 筛选位置 () 右侧，选择表中的一列或多列。
   2. 对于每个筛选器，使用适用的运算符定义值。 此选择类似于在 Kusto 查询语言 中使用 where 运算符。

4. 选择要在表中显示的值：

   1. 选择+“值”列的右侧，选择将在窗格中显示的值列。

   2. 对于每个值列，设置聚合类型。

      可以设置一个或多个值列。 此选择等同于使用 summarize 运算符。

5. 选择 + “ 分组依据 (汇总) 右侧选择一列或多列，这些列将用于将值排列成组。 此选择等效于 运算符中的 summarize 组表达式。

6. 选择“运行查询”。

   

   提示

   在查询生成器中完成设置时，将创建Kusto 查询语言查询。 此查询显示使用图形查询编辑器构造的逻辑。

7. 选择 “编辑 KQL ”以移动到原始模式。 使用Kusto 查询语言的灵活性和功能编辑查询。

原始模式

使用原始模式编辑查询。

1. 在查询窗格中，粘贴以下查询，然后选择“ 运行”。 查询按天对示例数据集的事件计数进行桶存储。

   StormEvents
   | summarize event_count=count() by bin(StartTime, 1d)
   

   

2. 该图不显示任何结果，因为它的作用域默认为 (，) 过去六小时的数据。 在顶部菜单上，选择“过去 6 小时”。

   

3. 指定涵盖 2007 年（StormEvents 示例数据集中包含的年份）的自定义范围。 然后，选择“应用” 。

   

   现在，图表显示了 2007 年的数据，按日统计。

   

4. 在顶部菜单上，选择保存图标： 。

要切换到查询生成器模式，请选择“切换到生成器”。 Grafana 会将查询转换为查询生成器中的可用逻辑。 查询生成器逻辑有限，因此可能会丢失对查询所做的手动更改。

创建警报

1. 在 “主页仪表板”中，选择“ 警报>通知通道 ”以创建新的通知通道。

   

2. 输入名称并在 “新建通知通道”下键入，然后选择“ 保存”。

   

3. 在仪表板，从下拉列表中选择“编辑”。

   

4. 选择警铃图标以打开“警报”窗格。 选择“ 创建警报”，然后完成警报的属性。

   

5. 选择“保存仪表板”图标以保存所做的更改。

相关内容

• Azure 数据资源管理器的编写查询