Skip to content

ThingsBoard 租户 ​

正文与配图来自原稿。界面以系统管理员登录后的操作为准;访问地址按你的环境替换(示例为 http://localhost:8080)。

1、租户的概念 ​

目前,有很多的系统都是以多租户的形式来设计的,目的是为了实现数据隔离,ThingsBoard 中也是如此。但是 ThingsBoard 把租户又抽象成了一种实体,后续还会讲解其它的实体。

用官方的语言解释租户:您可以将租户视为一个单独的业务实体——它是拥有或生产设备和资产的个人或组织;租户可能有多个租户管理员用户和数以百万计的客户、设备和资产。

举个例子说明:例如某网约车公司,公司有很多管理层领导,公司旗下有很多的网约车。

  • 网约车公司 → 代表租户
  • 管理层领导 → 代表租户的管理员
  • 网约车 → 相当于资产

2、如何创建租户 ​

2.1、打开登录页面 ​

text
http://localhost:8080/login

系统默认的系统层登录账号和密码就是:

text
sysadmin@thingsboard.org / sysadmin

系统层登录页

2.2、首页 ​

首页展示了当前系统层的所有菜单模块,点击某一个模块即可快速进入模块中。

系统层首页

2.3、租户 ​

2.3.1、新增 ​

选择租户菜单进入到租户管理页面,选择右上角的【+】图标即可创建一个新的租户。其它信息可以不用填写,根据个人意愿,然后点击【添加】按钮即可创建成功。

新增租户

填写租户信息并添加

注意事项

这里租户是没有验证名称重复的,也就是说可以创建两个相同的 tenant 租户。虽然数据库中的 id 不一样,但是如果有时候业务需要根据租户名称查询租户,这样就会把相同的都查询出来,也不好区分,因此建议尽量避免创建相同名称的租户。

同名租户示意

数据库表结构:

租户相关表结构

2.3.2、搜索 ​

点击右上角的【搜索】按钮,可以进行搜索租户。注意:只能搜索租户的名称,也就是 title(标题)。因为在数据库表里新增了一个 search_text 字段,里面的内容就是 title(标题)字段的内容,如下图:

按 title / search_text 搜索租户

2.3.3、删除 ​

选中每一条数据,右上方就会显示删除按钮,即可进行删除操作。

删除租户

2.3.4、详情页面 ​

点击数据就会弹出侧边栏,第一个选项就是详情。如果需要修改详情信息,直接点击右边红色的编辑按钮,即可进行编辑操作。

租户详情侧边栏

2.3.5、属性 ​

ThingsBoard 抽象了一套组件,几乎实体都包含:详情、属性、遥测、告警、事件、关联。

租户层的属性只能是服务端属性,因为服务端属性是用来描述这个租户的一些其它信息,例如这个租户(公司或机构)在哪个地方、规模多大等,就应该写在属性里面。有时候业务场景中会将租户的属性获取到,再添加到设备上报数据的 metadata 中。

租户服务端属性

2.3.6、遥测 ​

遥测是不支持新增的,支持搜索字段的【键名】(通常叫字段的 key)。很多人可能会说这里不会上报遥测,一般业务可能确实不会出现租户有遥测的情况,但是我们遇到过这种场景——不光租户,客户也会有遥测:当时是代码自定义一些业务,然后借用 ThingsBoard 的 WebSocket(ws)接口,将自定义的数据推到当前租户和客户的遥测里面。这里只想告诉你:可以使用 ws 的接口推送数据到这里。

租户遥测

具体调哪个接口可以实现推送,可以贴图告诉大家:

通过 WS 接口推送遥测示意

2.3.7、告警 ​

告警这个东西在租户层要想看到,只有当前租户下的设备或者资产触发的告警往租户层冒。这个是可以配置的,具体配置后续在租户层的设备配置里面配置告警规则再给大家讲解。

2.3.8、事件 ​

事件主要是记录一些异常或者日志信息,系统层创建租户这里几乎不会出现。

2.3.9、关联 ​

系统层用得相对较少,后续在租户层讲解设备、资产的时候详细讲解。

2.3.10、创建租户管理员 ​

在租户列表,点击右侧的【人像】按钮,即可进入创建租户管理员的界面。

进入租户管理员列表

新建:

租户管理员列表 / 新建入口

点击【添加】按钮弹出:

添加租户管理员

拷贝激活链接:

拷贝激活链接

然后在新的浏览器页面打开链接,就会弹出叫你输入密码的输入框:

激活链接设置密码

输入密码之后点击保存,即可进入到租户层的首页:

设置密码成功

租户层首页

同理,在租户管理页点击数据也会有右侧的抽屉弹出来,内容几乎都差不多,根据自己的业务是否需要。

租户管理员详情抽屉


补充(辅) ​

  • 系统管理员管「租户」;租户管理员才进入租户空间管理设备、资产、客户等。
  • 默认账号登录后请尽快改密;生产环境勿使用默认密码。
  • 实体侧栏中的「详情 / 属性 / 遥测 / 告警 / 事件 / 关联」在设备、资产等实体上也会反复出现,租户是理解这套模型的第一站。

相关文章 ​