菜单

创建和管理报告

报告使您能够从任何你的仪表盘和自动生成pdf Grafana邮件安排他们感兴趣的。这是可用在Grafana Grafana云Pro和先进和企业。

如果你有基于角色的访问控制启用,对于一些操作需要有相关权限。指特定的指南了解需要哪些权限。

您所作的改变在一份报告中反映使用仪表板下次发送报告。例如,如果你改变了时间范围在仪表板,然后报告的时间范围也在改变。

最近报道UI的改进,信息参考Grafana报告:我们如何在Grafana改善了用户体验

需求

  • 必须配置SMTP发送报告。指SMTP配置为更多的信息。
  • 图像渲染器插件必须安装或远程渲染服务必须设置。指图像呈现为更多的信息。

访问控制

RBAC启用,需要有相关吗权限创建和管理报告。

创建或更新报告

只有组织默认管理员可以创建报告。您可以自定义谁可以创建报告基于角色的访问控制

  1. 单击报表图标的导航菜单。

    报告选项卡允许您查看、创建和更新你的报告。报表已经一个多步骤的布局。连续的步骤不需要完成,可以通过单击一步跳过的名字。

  2. 选择报告仪表板。

    • 源指示板:选择您想要的仪表板生成报告。
    • 时间范围:(可选)使用自定义报告的时间范围。有关更多信息,请参考报告的时间范围
    • 添加另一个指示板:在报表中添加多个仪表盘。
  3. 报告格式。

    • 选择格式选项报告:至少选择一个选项。附加报告PDF,嵌入仪表板作为一个图像,或者附加CSV文件表的面板数据。
    • 如果你选择PDF格式选项:
      • 选择一个方向的报告:肖像景观
      • 选择一个布局为生成的报告:简单的网格。简单的布局呈现每个面板宽屏在PDF。相同的网格布局呈现PDF面板布置和宽度作为源仪表板。
      • 点击PDF预览查看与您所选择的选项呈现PDF。
  4. 进度报告。

    • 输入调度信息。选择取决于频率选择。
  5. 输入报告信息。所有字段是必需的,除非另有指示。

    • 报告名称:报告的名字像你希望它出现在报告列表。报告名称填充邮件主题行。
    • 收件人:进入电子邮件的人或团队,你想收到报告,逗号或分号隔开。
    • 回复:(可选)出现在的地址回复的电子邮件。
    • 信息:(可选的)消息体的电子邮件报告。
    • 包括一个仪表板链接:从报告中包括仪表板的链接邮件。
    • 发送测试电子邮件:确认配置是否按预期运行。你可以选择发送这封邮件的收件人配置报告,或一组不同的电子邮件地址仅用于测试。
  6. 预览并保存报告。

选择模板变量

注意:可以在Grafana企业7.5版本,后来后面reportVariables8.0及以后版本功能国旗,Grafana企业没有一个功能国旗,和Grafana云Pro和先进

您可以配置报表特定报告的仪表板页面模板变量。您选择的变量将覆盖从仪表板的变量,他们报告的呈现PDF文件时使用。对于使用模板变量的详细信息,请参阅模板和变量部分。

注意:查询变量保存的报告可能成为日期如果该查询的结果变化。例如,如果您的模板变量查询列表添加主机名和一个新的主机名,那么它将不会被包括在报告。如果这发生,所选变量必须手动更新在报告中。如果您选择了所有模板变量的值或如果你一直仪表板的原始变量选择,然后报告保持最新的新值。

呈现一个报告面板或行设置重复的变量

注意:可以在Grafana企业8.0及以后版本,和Grafana云Pro和先进

您可以包括动态仪表盘面板或行,设置重复的变量,报告。设置重复的详细信息面板或行仪表板,请参考重复面板或行

警告

  • 呈现重复面板动态变量类型(例如,查询变量)与选定所有值是目前不支持。作为一个解决方案,选择所有的值。
  • 如果你选择不同的模板变量的仪表板的一份报告中重复行,你可能会看到空间底部或缺失值的报告。这是因为从仪表盘面板的尺寸用于生成报告。为了避免这个问题
    • 使用仪表板的原始报告的模板变量,或使仪表板的一个副本
    • 选择新的模板变量
    • 生成一个报告基于复制的仪表板。
  • 呈现的重复面板不支持内部崩溃行报告。

报告的时间范围

注意:你可以设置自定义报告的时间范围Grafana企业7.2 +,Grafana云Pro和先进

默认情况下,报告使用保存的时间范围的仪表板。你可以改变的报告的时间范围:

  • 保存修改时间范围到仪表板。
  • 通过设定一个时间范围时间范围在报告的形式。如果指定自定义时间范围覆盖的时间范围从报告的仪表板。

报告的页眉显示了仪表板的数据的时间范围查询。仪表板设置为使用浏览器的时区使用时区Grafana服务器。

如果时区设置Grafana之间不同的服务器和远程图像渲染器,然后报告的时间范围可能不同页眉和时间轴面板。为了避免这种情况,设置时区为仪表板UTC当使用远程渲染器。每一个仪表板的时区设置是可见的时间范围控制

布局和定位

我们积极发展新的报告布局选项。联系我们参与设计过程中。

布局 取向 支持 描述 预览
简单的 肖像 v6.4 + 生成一个A4页面每页在肖像模式和三个面板。
简单的 景观 v6.7 + 在横向模式生成一个A4页面每页一个面板。
网格 肖像 v7.2 + 生成一个A4页面与板安排在肖像模式一样,最初的仪表板。
网格 景观 v7.2 + 生成一个A4页面与板安排在风景模式一样在最初的仪表板。

CSV导出

注意:可以在Grafana企业8 +的Grafana图像渲染器插件v3.0 +,Grafana云Pro和先进

报告您可以将一个CSV文件附加到电子邮件为每个表面板选择仪表板,以及PDF报告。默认情况下,华禾投资大于10 mb并不阻止电子邮件服务器拒绝电子邮件发送。你可以增加或减少这个极限报告配置

这个特性依赖于相同的插件,支持图像呈现特性。

在CSV文件生成时,暂时写到csv在Grafana文件夹数据文件夹中。

后台作业运行每10分钟并删除临时的CSV文件。您可以配置一个CSV文件多久应该存储在被配置删除temp-data-lifetime设置。这个设置也会影响一个渲染器PNG文件应该保存多久。

调度

注意:可以在Grafana企业8.0及以后版本,和Grafana云Pro和先进。调度器显著改变Grafana企业8.1版本。

计划报告可以发送一次,或重复在每小时,每天,每周,每月或以自定义的间隔发送。你也可以禁用调度通过选择从来没有例如,通过API发送报告。

以后发送现在或时间表

  • 现在发送报告后立即发送你保存它。停止发送报告在未来某个时候,添加一个结束日期。如果你离开结束日期为空,该报告发出了下去。

  • 发送后安排以后的报告。因此,需要开始日期和时间字段。如果你离开结束日期为空,该报告发出了下去。

只发送从星期一到星期五

的报告每小时或每天的频率,你可以选择只把他们从星期一到星期五。

在每月的最后一天

当你每月安排一次报告的频率,并设置开始日期本月29日和31日期间发送的报告只有几个月,这些日期。如果你想要发送的报告每个月,选择在每月的最后一天选项。这种方式,发送报告在每个月的最后一天,无论有多少天在任何给定的月。

发送一个测试邮件

注意:可以在Grafana企业7.0及以后版本,和Grafana云Pro和先进

  1. 在报告中,点击发送测试电子邮件
  2. 电子邮件字段中,输入电子邮件地址或地址你想要测试,由分号隔开。如果你想用电子邮件地址的报告,然后选择使用电子邮件报告复选框。
  3. 点击发送

最后保存版本的报告将被发送到选定的电子邮件。您可以使用它来验证电子邮件工作,确保报告生成和显示为你期待。

暂停一个报告

注意:可以在Grafana企业8.0及以后版本,和Grafana云Pro和先进

您可以暂停发送的报告报告列表视图通过单击暂停图标。发送的报告将不会根据其计划通过点击恢复按钮,直到恢复报告行。

添加多个仪表盘的报告

注意:可以在Grafana企业9.0及以后版本,和Grafana云Pro和先进

您可以添加多个仪表盘的报告。额外的仪表板将呈现为新页面在同一个PDF文件,或额外的图片如果你选择嵌入图像在你的报告邮件。您不能添加相同的仪表板的一份报告很多次了。

仪表板作为图像嵌入到一个报告

注意:可以在Grafana企业9.0及以后版本,和Grafana云Pro和先进

您可以发送一个报告电子邮件与仪表板的图像嵌入到电子邮件,而不是附加的PDF。在这种情况下,电子邮件收件人能看到仪表板一眼就不用打开PDF。

仪表板导出为PDF

您可以生成并保存任何仪表板的PDF文件。

注意:可以在Grafana企业6.7及以后版本,和Grafana云Pro和先进

  1. 在右上角的仪表板你想导出为PDF,单击分享仪表板图标。

  2. 在PDF选项卡上,选择导出仪表板布局选项:肖像景观

  3. 点击保存为PDF呈现仪表板为PDF文件。

    Grafana打开PDF文件浏览器在一个新窗口或选项卡。

通过API发送一份报告

您可以通过编程方式发送报告发送报告端点的HTTP api

显示配置

生成报告时,每个小组分别呈现之前被收集在一个PDF。您可以配置的每块面板呈现超时和数量同时呈现的面板。

面板更清晰,你可以设定一个比例因子呈现图像。然而,更高的比例因子提高了生成的PDF文件的大小。

您还可以指定自定义字体,支持不同的Unicode脚本。DejaVu字体是默认用于PDF呈现。

这些选项是可用的配置文件。

[报告]#使用这个选项启用或禁用报告功能。当残疾,没有报告生成和UI是隐藏的。默认情况下,启用了报告。启用= true #为每个面板呈现请求超时rendering_timeout = 10 #设置最大并发数调用渲染服务concurrent_render_limit = 4 #设置渲染图像的比例因子。2是足够的监控决议# 4对印刷材料会更好。bob彩票中奖计划设定一个更高的价值影响性能和内存image_scale_factor = 2 #以兆字节为单位设置最大文件大小为CSV附件max_attachment_size_mb = 10 #路径目录包含字体文件fonts_path = # TrueType字体文件的名称与普通font_regular = DejaVuSansCondensed风格。ttf # TrueType字体文件的名称与大胆的风格font_bold = DejaVuSansCondensed-Bold。ttf #的名称用斜体样式font_italic = DejaVuSansCondensed-Oblique.ttf TrueType字体文件

报告的设置

注意:可以在Grafana企业7.2及以后版本,和Grafana云Pro和先进

您可以配置设置在组织范围内报告设置选项卡上的报告页面。设置应用于当前组织的所有报告。

您可以定制品牌的选择。

报告品牌:

  • 公司标志URL:公司标志显示在报告PDF。默认为Grafana标志。

电子邮件的品牌:

  • 公司标志URL:公司标志显示在报告PDF。默认为Grafana标志。
  • 电子邮件页脚:切换,使报告邮件页脚。选择发送的没有一个
  • 页脚的链接文字:文本链接的报告邮件页脚。默认为Grafana
  • 页脚的链接网址:报告的链接邮件页脚。

诊断报告

解决和得到更多的日志信息,启用调试日志记录在配置文件中。指配置为更多的信息。

(日志)过滤器=报告:调试