9 月，NanoMQ 繼續保持穩步更新，最新的 [0.12.1 版本](https://github.com/emqx/nanomq/releases/tag/0.12.1)已於近日正式釋出。此版本依舊帶來了豐富的更新：橋接功能中增加了上下線事件和連線狀態監控能力；重構升級了原有的日誌系統；配置檔案得到了簡化，將多個配置檔案合併整理為統一的單一檔案。

## 橋接連線狀態事件訊息

IoT 應用中，弱網狀態下時常出現網路不穩定的情況，需要一個可靠的途徑來偵測當前裝置的聯網狀態以及與雲端的連通性。為此，[NanoMQ](https://www.emqx.com/zh/products/nanomq) 提供了利用橋接連線來探測網路連線狀態的能力。當使用者在邊緣側使用 NanoMQ 橋接到雲端時，NanoMQ 會建立一個 MQTT 連線到指定的雲端 Broker，基於 MQTT 的長連線特性，本地網路裡的裝置可以利用此連線來判斷網路狀態。
[![1](http://img.blog.itpub.net/blog/2022/10/10/b8f8f3c113deb811.png?x-oss-process=style/bb)](https://www.emqx.com/zh/blog/nanomq-newsletter-202209)

如上圖所示，當本地網路中斷或其他故障導致橋接連線斷開時，NanoMQ 會檢測到橋接連線斷開的情況，並將其轉化為一個客戶端上下線事件訊息釋出到系統主題中。網路恢復後橋接連線自動重連，也會釋出一個上線事件訊息到系統主題。本地的客戶端和其他服務可以根據收到的此訊息進行對應的應急處理，還可以配置多個橋接目標來作為備選服務避免因為雲端服務中斷導致的誤判。

### 如何獲取橋接上下線事件訊息

目前 NanoMQ 的橋接狀態事件支援所有的橋接方式，包括 MQTT 3.1.1/5.0 和 MQTT over QUIC。 上下線事件訊息的系統主題分別為 `$SYS/brokers/disconnected` 和 `$SYS/brokers/connected`。事件訊息同樣也支援作為一個標準 Publish 訊息被以 WebHook 的方式獲取。這裡以一個 MQTT over QUIC 橋接配置為例，示範如何獲取橋接連線的上下線訊息：

若橋接配置為(只摘錄部分相關)：

```ini
bridge.mqtt.emqx.clientid=quic_client
bridge.mqtt.emqx.keepalive=5
bridge.mqtt.emqx.quic_keepalive=120
bridge.mqtt.emqx.clean_start=false
bridge.mqtt.emqx.username=quic_bridge
bridge.mqtt.emqx.password=passwd
```

使用 NanoMQ 命令列工具訂閱對應主題，那麼當本地網路中斷時，橋接斷開就會觸發：

```awk
nanomq_cli sub --url mqtt-tcp://localhost:1883 -t '$SYS/brokers/connected'
connect_cb: mqtt-tcp://localhost:1883 connect result: 0 
$SYS/brokers/connected: {"username":"quic_bridge", "ts":1664277443551,"proto_name":"MQTT","keepalive":5,"return_code":"0","proto_ver":4,"client_id":"quic_client", "clean_start":0}
```

那麼當本地網路恢復時，橋接重連成功就會觸發：

```awk
nanomq_cli sub --url mqtt-tcp://localhost:1883 -t '$SYS/brokers/disconnected'
connect_cb: mqtt-tcp://localhost:1883 connect result: 0 
$SYS/brokers/disconnected: {"username":"quic_bridge","ts":1664277394014,"reason_code":"8b","client_id":"quic_client"}
```

可見上下線事件訊息中的客戶端 ID 和使用者名稱/密碼都與橋接配置中的一致，可以此來區分本地客戶端和橋接客戶端。目前橋接連線狀態與普通 MQTT 客戶端是共享同一個系統主題，NanoMQ 也考慮為橋接網路狀態單獨設立一個系統主題，以及作為雲邊訊息匯流排加入標準的網路健康監控功能。歡迎廣大使用者提交相關 Issue 和功能申請。

### 新增 QUIC 傳輸層的 Keep Alive 引數配置

QUIC 內建了一個連線保持機制，為了讓使用者能夠更細顆粒度的控制 MQTT 和 QUIC 的超時時間，NanoMQ 的橋接功能把兩者的超時設定都暴露為可設定狀態，後續還會開放更多的 QUIC 傳輸層引數供使用者調優。

```ini
## Ping: interval of a downward bridging connection via QUIC.
bridge.mqtt.emqx.quic_keepalive=120
```

## 配置檔案簡化

在 0.12 版本之前，NanoMQ 每個模組都有一個獨立的配置檔案，需要單獨開啟每個檔案進行修改配置，啟動較為繁瑣。從0.12 版本開始，我們將正式統一合併所有的配置項到 nanomq.conf， 並且為每個模組單獨增加了分組。

需要注意的是，之前的命令列引數中指定橋接配置檔案和使用者名稱密碼檔案路徑的功能被廢棄。

```ada
  --bridge <path>            The path of a specified bridge configuration file 
  --auth <path>              The path of a specified authorize configuration file
```

此修改不影響 ZeroMQ 閘道器的配置檔案（nanomq_gatewaty.conf 屬於 nanomq_cli）和容器部署情況下透過環境變數指定配置檔案的方式。

## 日誌系統重構

日誌配置示例：

```clean
## ------------------ Logging Config ------------------ ##
## - file: 輸出日誌到檔案
## - console: 輸出日誌到命令列
## - syslog: 輸出日誌到 syslog系統
## Value: file | console | syslog 支援並列配置
log.to=file,console,syslog

## 若配置了輸出日誌到檔案，則在此指定檔案路徑
log.dir=/tmp

## 若配置了輸出日誌到檔案，則在此指定檔名
log.file=nanomq.log

## 單個日誌檔案的最大大小，若超過則會滾動更新
## 支援單位引數: KB | MB | GB
log.rotation.size=10MB

## 最大儲存的滾動更新的日誌檔案個數
log.rotation.count=5
```

## NanoSDK 增加更多 API 封裝

此前 NanoSDK 的 API 多為 NNG 的風格，需要使用者自己組裝 MQTT 訊息併傳送來完成訂閱和接觸訂閱的操作。從 NanoSDK 0.7.5 開始，NanoSDK 裡新增了以下更方便、封裝程度更高的 MQTT API：
[![](http://img.blog.itpub.net/blog/2022/10/10/3cc08a1e4b10bce7.png?x-oss-process=style/bb)](https://www.emqx.com/zh/blog/nanomq-newsletter-202209)

具體使用方式請參閱 [NanoSDK Doc](https://github.com/emqx/NanoSDK/blob/0.7.5/docs/man/libnng.3.adoc#mqtt-message-handling)。

## 即將到來

規則引擎的訊息重發布功能和規則熱更新將在下一個版本中正式釋出。同時會為 NanoMQ 增加 Reload 命令來進行配置檔案熱更新，為 MQTT over QUIC 橋接功能增加多次重連失敗可以自動切換為標準 TCP 的功能（Fallback to TCP），來保證在不支援 QUIC 的網路下保持橋接連線功能正常。

>版權宣告： 本文為 EMQ 原創，轉載請註明出處。
>
>原文連結：[https://www.emqx.com/zh/blog/nanomq-newsletter-202209](https://www.emqx.com/zh/blog/nanomq-newsletter-202209)</path></path>

新增橋接連線狀態監控、重構日誌系統

相關文章