IoT Gateway远程配置

网关列表
下一步

远程配置（Remote Configuration）是ThingsBoard IoT Gateway的强力功能，允许您直接从ThingsBoard Web界面管理和配置网关。该功能在管理多台网关或无法现场接触网关时特别有用。

本指南将使用以下环境： 1.本地安装的ThingsBoard平台实例（安装方法见此处）。

ThingsBoard IoT Gateway（安装方法见此处）。

网关列表

要远程管理网关，需在ThingsBoard侧边菜单中进入「实体」>「网关」标签页。

网关列表页显示所有网关及其必要信息，包括： -创建日期与时间。 -网关名称。 -状态（在线/离线）。 -已启用连接器数量。 -网关版本。

以及以下导航元素：

启动命令 — 点击后弹出包含启动网关命令的对话框。
网关配置 — 点击后弹出通用网关设置对话框。
连接器 — 点击后进入连接器管理与配置页面。
删除网关 — 点击后弹出网关删除确认对话框。

在此页面可创建新网关，也可按上述参数进行排序。

网关信息页

选中某个网关并点击后，将跳转到该网关的详情页。

仪表板由4个主要组件组成：

网关基本信息，包含以下卡片： -状态（活跃/非活跃）。 -网关名称。 -网关类型。 -设备（活跃/非活跃）。 -连接器（已启用/已禁用），带有连接器页面链接。 -错误数量，带有日志页面链接。

设备是一个表格，包含通过网关连接的设备基本信息： -设备名称。 -设备类型。 -状态（活跃/非活跃）。 -连接器名称。 -连接器类型。 -设备信息按钮，点击后弹出包含设备详细信息的对话框。 -以及筛选和搜索所需设备的元素。

告警是标准告警组件，您将在此接收与所选网关相关的所有告警。

导航面板是一个导航面板，网关的所有其他配置、管理和监控页面均位于此处，包括： -启动命令-包含自动生成的网关启动命令的对话框。
- 通用配置 -网关通用设置页面。
- 连接器配置 -连接器管理与配置页面。
- 日志 -各类日志页面（请注意，该按钮仅在网关启用了远程日志时才处于活跃状态）。
- 统计 -网关通用统计与自定义统计页面。
- 远程Shell -远程Shell页面（请注意，该按钮仅在网关启用了远程Shell时才处于活跃状态）。
- RPC -网关RPC发送页面。

通用配置

点击网关页面导航面板中的通用配置按钮，将跳转到网关的通用设置仪表板。

您可以在基础和高级配置模式之间切换。基础模式提供友好的界面用于配置网关，而高级模式允许您直接编辑JSON格式的配置文件。

基础配置模式

页面包含以下标签页：

General（常规）- 本标签页包含主要设置：

Remote Configuration（远程配置）- 启用网关的远程配置和管理。
Remote Shell（远程 Shell）- 从 Remote Shell 部件启用对网关所在操作系统的远程控制。
Platform host（平台主机）- 平台服务器的主机名或 IP 地址。
Platform port（平台端口）- 平台服务器上 MQTT 服务的端口。
Security type（安全类型）（更多说明请参见此处）- 远程配置目前支持 3 种安全类型：
- Access Token。
- TLS + Access Token。
- Username and Password。
- TLS + Private Key（暂不支持）。
Report strategy（上报策略）（更多说明请参见此处）- 向 ThingsBoard 发送网关状态时的策略：
- On report period（按上报周期）- 在上报周期后发送网关状态。
- On value change（按值变化）- 值变化时发送网关状态。
- On value change or report period（按值变化或上报周期）- 值变化或到达上报周期时发送网关状态。
- On received（按接收）- 从设备接收数据后发送网关状态（默认策略）。

Logs（日志）- 用于设置本地和远程日志的标签页，包含 3 个主要部分：

General log settings（通用日志设置）- 使用 Python logging 模块的常规设置：
- Date format（日期格式）- 日志消息的日期格式。
- Log format（日志格式）- 日志消息格式。
Remote logging（远程日志）- 配置远程日志：
- Remote logs - 启用远程日志及从网关读取日志。
- Log level（日志级别）。
Local logging（本地日志）- 配置本地 logger（Service、Connector、Converter、TB Connection、Storage、Extension）：
- Log level - 各本地 logger 的日志级别：INFO、DEBUG、WARNING、ERROR、CRITICAL、TRACE、NONE。
- File path（文件路径）- 日志文件夹路径。
- Log saving period（日志保存周期）。
- Backup count - 若 Backup count > 0，则轮换时最多保留 Backup count 个文件， oldest 将被删除。

存储 - 提供在将传入数据发送到平台之前进行保存的配置：

内存存储 - 将数据保存到 RAM 内存。
文件存储 - 将接收到的数据保存到硬盘。
SQLITE - 将数据保存到 .db 文件。

GRPC - 提供 GRPC 配置：

Server port（服务器端口）- GRPC 服务器监听传入连接的网络端口。
Keep alive permit without calls（无调用时允许保活）- 允许服务器在没有活动 RPC 调用时仍保持 GRPC 连接。
Keep alive（保活）- 无活动 RPC 调用时，两次连续 keepalive ping 之间的时长（毫秒）。
Max pings without data（无数据时最大 ping 数）- 服务器在认为连接失效前，可发送且未收到任何数据的 keepalive ping 最大数量。
Keep alive timeout（保活超时）- 服务器在认为连接失效前等待 keepalive ping 响应的最长时间（毫秒）。
Min time between pings（ping 最小间隔）- 服务器在两次 keepalive ping 之间应等待的最短时间（毫秒）。
Min ping interval without data（无数据时最小 ping 间隔）- 在无数据收发时，服务器在两次 keepalive ping 之间应等待的最短时间（毫秒）。

Statistics（统计）- 在此标签页可配置通用统计及自定义统计：

General statistics（通用统计）- 启用/禁用网关统计（machine、storage、connector）。
Custom statistics（自定义统计）- 启用/禁用使用自定义命令收集统计。
Statistic send period（统计发送周期，秒）- 发送统计的时间周期。
Custom send period（自定义发送周期，秒）- 发送自定义统计的时间周期。
Commands（命令）- 用于收集附加统计的命令（添加新命令请点击 “Add command” 按钮）：
- Timeseries name（时序名称）- 网关 telemetry key 名称。
- Timeout（超时，秒）- 命令执行超时。
- Command（命令）- 命令结果将作为 client attribute 的值使用（例如 “/bin/sh -c ipconfig getifaddr en0”）。
- Advanced settings（高级设置）：
  - Install command（安装命令）- 用于安装所需包的命令（例如 “apt-get install -y curl”）。

Other（其他）- 在此标签页可配置附加网关参数：

Checking device activity（检查设备活动）- 启用对各连接设备活动的监控：
- Inactivity timeout（无活动超时，秒）- 设备无活动多久后网关将断开该设备。
- Inactivity check period（无活动检查周期，秒）- 设备活动检查的周期。
Advanced（高级）- 附加网关设置：
- Min pack send delay（最小包发送延迟，毫秒）- 发送数据包之间的延迟（降低此值会增加 CPU 占用）。
- QoS - MQTT 消息的服务质量（0 - 最多一次，1 - 至少一次）。
- Check connectors’ configuration（检查 Connector 配置，秒）- 检查 connector 配置是否有更改的周期。
- Max payload size in bytes（最大 payload 大小，字节）- 定义网关一次可处理的最大消息，确保性能稳定并避免超大数据引发错误。
- Min packet size to send（最小发送包大小）- 定义网关将传输的最小消息大小，避免发送过小或不完整的数据包。

高级配置模式

高级模式允许您直接编辑JSON格式的配置文件，适用于配置基础模式中不可用的复杂设置。

连接器配置

点击网关页面导航面板中的连接器配置按钮，将跳转到连接器配置页面。

页面由两个主要部分组成： -连接器列表-此处显示所有已创建连接器的基本信息和控制元素： -启用-启用或禁用连接器。 -连接器名称。 -连接器类型。 -配置状态-显示远程配置是否与本地配置同步。 -连接器状态-若为”绿色”表示无错误且连接器正常运行；若为”红色”表示连接器运行异常。 -操作： - RPC -通过网关向连接器发送RPC的仪表板。 -日志-连接器日志仪表板。 -删除连接器。 -连接器配置-用于配置连接器的字段。

您还可以点击页面右上角的+按钮创建新连接器。

日志

点击网关页面导航面板中的日志按钮，将跳转到日志页面。

仪表板实时显示网关主要日志信息（通用、服务、连接、存储、扩展）： -创建时间。 -级别。 -消息。

统计

点击网关页面导航面板中的统计按钮，将跳转到统计页面。

在右侧边栏中，您可以在存储、机器和自定义统计之间切换。此外，您可以在页面右下角实时查看网关状态。

存储统计

存储统计显示网关使用的存储信息。页面包含以下组件： -存储消息数-显示网关存储中存储的消息总数。 -来自平台的消息-显示从平台接收的消息总数。 -推送数据点图表-显示推送到平台的遥测和属性数据点总数。 -消息图表-显示网关处理的消息总数： -从存储拉取的消息-从存储拉取的消息总数。 -推送到平台的消息-推送到平台的消息总数。 -发送到平台的消息-发送到平台的消息总数。