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

使用报告和图像呈现（预览版）

项目
10/26/2023

本指南介绍如何从 Azure 托管 Grafana 中的仪表板创建报表。可以配置为定期或按需将这些报表通过电子邮件发送给目标收件人。

生成 PDF 格式的报表需要 Grafana 的图像呈现功能，该功能可将仪表板面板捕获为 PNG 图像。 Azure 托管 Grafana 会自动为实例安装图像呈现器。

重要

报告和图像呈现目前为预览版。有关 beta 版本、预览版或尚未正式发布的版本的 Azure 功能所适用的法律条款，请参阅 Microsoft Azure 预览版的补充使用条款。

图像呈现性能

图像呈现是一项 CPU 密集型操作。假设数据查询在 1 秒内完成，则一个 Azure 托管 Grafana 实例需要大约 10 秒来呈现一个面板。 Grafana 软件最多允许使用 200 秒来生成整个报表。如果在 PDF 报表中使用仪表板，则每个仪表板的面板不应超过 20 个。如果计划在报表中包含其他项目（例如，CSV），则可能需要进一步减少面板数量。

注意

如果呈现请求超过 200 秒的限制，你将看到“图像呈现超时”错误。

对于警报中的屏幕捕获，Grafana 软件仅允许在超时前 30 秒拍摄面板图像快照。在此时间范围内，最多可以拍摄三个屏幕截图。如果警报量突然激增，即使启用了屏幕捕获，某些警报也可能没有屏幕截图。

注意

重载 Grafana 图像呈现器可能会导致它变得不稳定。可以通过仅在这些警报规则中设置仪表板 UID 和面板 ID 批注来减少必须包含屏幕截图的警报数。

先决条件

若要执行本指南中的步骤，必须做好以下准备：

具有活动订阅的 Azure 帐户。免费创建帐户。
标准计划中的 Azure 托管 Grafana 实例。如果你没有实例，请创建一个新实例。
一个 SMTP 服务器。如果你没有服务器，建议使用 Twilio SendGrid 的 Azure 电子邮件 API。
通过电子邮件发送 Azure 托管 Grafana 实例的设置。配置 SMTP 设置。

设置报表

若要创建新报表，请执行以下步骤。

在 Azure 门户，打开你的 Azure 托管 Grafana 工作区并选择“终结点”URL。
在 Grafana 门户中，转到“报告”>“报表”，选择 “+ 创建新报表”。
完成 Grafana UI 中的剩余步骤。

将仪表板导出为 PDF

注意

Grafana UI 可能会定期更改。本文介绍给定时间的 Grafana 界面和用户流。在阅读本文档时，你的体验可能与示例略有不同。如果是这样，请参阅 Grafana Labs 文档。

若要创建新报表，请执行以下步骤。

在 Azure 门户，打开你的 Azure 托管 Grafana 工作区并选择“终结点”URL。
在 Grafana 门户中，转到要导出的仪表板。
单击“共享仪表板”图标。
在“PDF”选项卡中选择布局选项。
选择“另存为 PDF”进行导出。

在警报中使用图像

Grafana 允许屏幕捕获触发警报的面板。收件人可以直接在通知消息中查看面板图像。 Azure 托管 Grafana 当前配置为将这些屏幕截图上传到实例上的本地存储。只有支持的联络点表的“从磁盘上传”列中的联络点列表可以接收图像。此外，屏幕截图的拍摄时间限制为 30 秒。如果无法及时完成屏幕截图，则不会包含在相应的警报中。仅针对规则中包含仪表板 UID 和面板 ID 批注的警报拍摄屏幕截图。可以使用这些批注选择性地禁用屏幕捕获。

后续步骤

本操作指南介绍了如何使用报告和图像呈现。若要了解如何创建和配置 Grafana 仪表板，请参阅创建仪表板。