| 4.2及以上版本 |
在ThingsBoard中,您可以将已生成的报表附加到通过可用渠道发送给用户的系统通知(仅限Web、Email或Slack)。 这样可以将事件通知与完整报表配对,收件人可以即时打开、查看或下载。
重要:如果收件人是客户用户,报表只能附加到通过Email或Slack发送的通知。 直接在Web UI中查看报表仅适用于租户用户。
适用场景:
- 当发生关键告警时自动发送报表。
- 定期发送摘要,无需手动运行调度器。
- 将系统事件(如数据更新)与最新的分析内容相结合。
示例:向“新告警通知”模板添加报表
让我们通过现有的”新告警通知“模板,了解如何将报表附加到通知。 该模板用于在创建新告警时向租户管理员发送告警。
我们将进行以下修改:
- 添加另一种推送方式 — Email(在现有的Web通知之外)。
- 附加包含详细告警信息的PDF报表到邮件中。
首先,创建用于生成PDF报表的模板。
我们将在模板中添加一个组件 — 告警表 — 用于显示创建的告警及其详情。
- 从左侧菜单进入”报表“页面 — 默认会进入”模板“标签页。
- 点击右上角的”+ 添加报表模板“按钮,选择”创建新报表模板“。
- 在弹窗中填写以下内容:
- 将其名称设为”新告警“。
- 选择PDF报表格式。
- 选择报表作为模板类型。
- 点击”添加“以创建报表模板并打开报表构建器界面。
在报表构建器中配置报表:
- 找到并将”告警表“组件拖入报表的内容区域。
- 在”告警来源“部分,点击”新建“实体别名按钮。
- 使用”源实体“筛选器 — 这样,表格将从触发通知的实体接收数据。
- 应用筛选器以仅显示活动告警。
- 保存组件。
- 点击右上角的”保存“以保存您的模板配置。
- Name it "New alarm".
- Choose PDF report format.
- Choose Report as the template type.
- Click "Add" to create the report template and open the Report Builder interface.
- Click "Save" in the top-right corner to store your template configuration.
现在,修改“新告警通知”模板。
- 进入”通知中心“页面的”模板“标签页。
- 找到”新告警通知“模板,点击以打开编辑。
- 添加另一种通知推送方式 — Email。
- 启用”附加报表“选项。
- 选择之前创建的新告警模板。
- 指定代表其生成报表的用户账户:john.doe@thingsboard.io(John Doe — 租户管理员)。
- 点击”下一步“。
- 输入将随PDF报表一起通过邮件发送的主题和消息。
- 点击”保存“按钮保存对模板的修改。
Specify the user account on whose behalf the report will be generated: john.doe@thingsboard.io (John Doe — Tenant Administrator). Click "Next".
修改“新告警通知”模板后,建议测试一切是否按预期工作。
首先,确保已为设备配置告警创建规则。 您可以在文档相关章节找到配置此类规则的说明(查看链接)。
通过为设备发布超过告警创建规则中定义的阈值的遥测数据来触发告警。 最简单的方法是使用ThingsBoard中的检查连接性功能。
检查通知:
您应立即在ThingsBoard Web UI中看到通知。
同时将向所有租户管理员发送邮件,并附上包含告警详情的PDF报表。用户可以在浏览器中打开并查看报表或下载。