測(cè):Modbus TCP+SNMP集成落地全記錄)
做樓宇自控和動(dòng)環(huán)監(jiān)控時(shí)間長(zhǎng)了你會(huì)發(fā)現(xiàn)溫濕度監(jiān)測(cè)這種最基礎(chǔ)的需求反而是最考驗(yàn)整合功力的活。傳感器本身不復(fù)雜難的是怎么把散落在各樓層弱電間、機(jī)房、配電室的幾十個(gè)點(diǎn)位用一種低成本但不失專業(yè)的方式統(tǒng)一接入樓宇現(xiàn)有的管理系統(tǒng)。我在一個(gè)實(shí)際項(xiàng)目中構(gòu)建了一套基于Modbus TCP/UDP和SNMP協(xié)議的樓宇自控溫濕度監(jiān)測(cè)系統(tǒng)采集層走M(jìn)odbus上送層走SNMP一套鏈路下來(lái)數(shù)據(jù)穩(wěn)定、對(duì)接順暢這篇文章就是這套系統(tǒng)的完整落地記錄包括方案選型、寄存器踩坑、MIB定義、網(wǎng)管平臺(tái)聯(lián)調(diào)和問(wèn)題排查給正在做類似弱電集成或動(dòng)環(huán)改造的同行一個(gè)參考。1. 方案選型為什么是Modbus TCP/UDP加SNMP這套組合1.1 傳統(tǒng)溫濕度監(jiān)測(cè)方案在樓宇場(chǎng)景中的真實(shí)痛點(diǎn)很多人第一次接觸樓宇溫濕度監(jiān)測(cè)第一反應(yīng)是買一批帶LCD屏的傳感器各自接RS485總線到一臺(tái)串口服務(wù)器再用某個(gè)廠商的上位機(jī)軟件看曲線。這種方案在小型機(jī)房勉強(qiáng)能跑但放到真正的樓宇自控場(chǎng)景里問(wèn)題就來(lái)了。RS485總線是手拉手的菊花鏈拓?fù)渲虚g任何一個(gè)節(jié)點(diǎn)接錯(cuò)線、短路或者設(shè)備死機(jī)輕則某一段失聯(lián)重則整條總線癱瘓。更麻煩的是如果節(jié)點(diǎn)分布在不同樓層你得沿橋架拉一整根手拉手的通信線施工麻煩不說(shuō)后期排查故障基本靠猜。另一個(gè)痛點(diǎn)在于數(shù)據(jù)孤立。傳統(tǒng)品牌溫濕度傳感器的上位機(jī)軟件往往自成一套數(shù)據(jù)存在它自己的數(shù)據(jù)庫(kù)里樓宇的BA網(wǎng)管平臺(tái)看不到動(dòng)環(huán)監(jiān)控平臺(tái)也看不到。于是運(yùn)維人員每天得打開(kāi)兩三個(gè)不同的軟件才能把溫濕度、空調(diào)、UPS狀態(tài)看全這在實(shí)際使用中幾乎沒(méi)有可操作性時(shí)間一長(zhǎng)監(jiān)控就成了擺設(shè)。我在這個(gè)項(xiàng)目里就是被這類問(wèn)題逼著做了一次徹底的技術(shù)選型。1.2 Modbus TCP/UDP負(fù)責(zé)采集層的關(guān)鍵考量選擇Modbus作為采集層協(xié)議最大的理由不是它性能多強(qiáng)而是它生態(tài)足夠大。樓宇溫濕度傳感器、水浸傳感器、RTU轉(zhuǎn)以太網(wǎng)的網(wǎng)關(guān)、邊緣計(jì)算網(wǎng)關(guān)幾乎市面上所有工業(yè)級(jí)環(huán)境監(jiān)測(cè)設(shè)備都內(nèi)置Modbus協(xié)議棧支持Modbus TCP或Modbus UDP訪問(wèn)。你不用擔(dān)心某個(gè)傳感器買回來(lái)協(xié)議不兼容Modbus就是這行的“通用語(yǔ)言”。Modbus TCP/UDP相對(duì)傳統(tǒng)RS485的優(yōu)勢(shì)主要有三個(gè)。第一是布線以太網(wǎng)線走弱電橋架非常成熟交換機(jī)端口隨處可接點(diǎn)位的增刪改都只需要網(wǎng)線一根不需要像RS485那樣講究節(jié)點(diǎn)距離和手拉手順序。第二是可靠性Modbus TCP基于TCP協(xié)議自帶確認(rèn)和重傳機(jī)制數(shù)據(jù)包丟失會(huì)自動(dòng)補(bǔ)償只要網(wǎng)絡(luò)不中斷采集基本不會(huì)出幺蛾子。第三是速率以太網(wǎng)交換機(jī)的吞吐能力遠(yuǎn)非串行總線可比一個(gè)采集程序輪詢幾十個(gè)點(diǎn)位時(shí)間開(kāi)銷完全可以忽略。這個(gè)方案里Modbus TCP和UDP都有存在意義。大多數(shù)工業(yè)傳感器同時(shí)支持兩種方式訪問(wèn)TCP適合點(diǎn)對(duì)點(diǎn)持續(xù)輪詢UDP則適合對(duì)實(shí)時(shí)性要求更高的局部場(chǎng)景而且UDP在單包交互上更輕。不過(guò)坦率講樓宇溫濕度監(jiān)測(cè)這種每秒一次甚至10秒一次的頻率TCP和UDP的實(shí)時(shí)性差別體感為零所以主采集鏈路選TCPUDP作為備用通道和兼容特殊設(shè)備的方式這樣最穩(wěn)妥。1.3 SNMP協(xié)議負(fù)責(zé)上送層的關(guān)鍵考量如果說(shuō)Modbus解決的是“怎么把數(shù)據(jù)從傳感器讀出來(lái)”那SNMP解決的就是“怎么把數(shù)據(jù)交給樓上管理平臺(tái)”。樓宇自控領(lǐng)域有個(gè)很現(xiàn)實(shí)的情況機(jī)房的精密空調(diào)、UPS電源、配電柜監(jiān)測(cè)模塊幾乎都標(biāo)配SNMP Agent網(wǎng)管平臺(tái)通過(guò)輪詢這些設(shè)備的OID節(jié)點(diǎn)來(lái)掌握運(yùn)行狀態(tài)。溫濕度監(jiān)測(cè)數(shù)據(jù)如果能變成SNMP的OID節(jié)點(diǎn)就能直接塞進(jìn)同一個(gè)平臺(tái)不需要再單獨(dú)維護(hù)一套軟件。這是整個(gè)方案的核心邏輯不引入新的監(jiān)控平臺(tái)最大化復(fù)用現(xiàn)有網(wǎng)管體系。配電房里的空調(diào)壞了網(wǎng)管平臺(tái)報(bào)警同時(shí)附帶的溫度曲線可能已經(jīng)提前一兩天顯示異常這種統(tǒng)一視角對(duì)運(yùn)維的價(jià)值非常大。SNMP的Trap機(jī)制還能把溫濕度越限事件主動(dòng)推送給平臺(tái)不是每次都要靠平臺(tái)輪詢才能發(fā)現(xiàn)這對(duì)告警場(chǎng)景非常關(guān)鍵。一定要理解我們?cè)跇怯钭钥乩镆隨NMP不是因?yàn)樗冗M(jìn)而是因?yàn)樗呀?jīng)被各種網(wǎng)管平臺(tái)廣泛支持是真正打通“最后一公里”的橋。1.4 系統(tǒng)整體拓?fù)渑c數(shù)據(jù)流走向整個(gè)系統(tǒng)的拓?fù)浣Y(jié)構(gòu)并不復(fù)雜大致分成三層。采集層由分布在各個(gè)場(chǎng)點(diǎn)的溫濕度傳感器組成傳感器通過(guò)網(wǎng)線接到樓層交換機(jī)只要設(shè)備支持Modbus TCP/UDP默認(rèn)IP配置好就能訪問(wèn)。對(duì)于個(gè)別點(diǎn)位還要兼容老式RS485傳感器的情況我加了一組Modbus RTU轉(zhuǎn)TCP的串口服務(wù)器把老舊傳感器也統(tǒng)一成以太網(wǎng)設(shè)備接入。匯聚層是一臺(tái)運(yùn)行Linux的采集服務(wù)器我用的是一臺(tái)頂替下來(lái)的舊PC安裝了Python環(huán)境和SNMP服務(wù)。采集腳本按照配置的IP和寄存器地址以Modbus TCP方式輪詢所有傳感器把讀到的原始寄存器值換算成實(shí)際的溫度、濕度數(shù)據(jù)并維護(hù)一份最新的緩存文件或內(nèi)存字典。接入層就是SNMP Agent負(fù)責(zé)把緩存中的溫濕度數(shù)值暴露成自定義OID節(jié)點(diǎn)。樓宇網(wǎng)管平臺(tái)配置好社區(qū)字符串和OID列表按設(shè)定的周期輪詢即可。數(shù)據(jù)流方向是傳感器→交換機(jī)→采集服務(wù)器→SNMP Agent→網(wǎng)管平臺(tái)全程閉環(huán)。這套結(jié)構(gòu)最巧妙的地方在于采集和上送邏輯完全解耦即使將來(lái)更換網(wǎng)管平臺(tái)只需要重新定義OID映射采集層一點(diǎn)不用動(dòng)。2. 數(shù)據(jù)采集層Modbus TCP/UDP讀溫濕度寄存器的硬核細(xì)節(jié)2.1 先查清楚傳感器寄存器映射和數(shù)據(jù)類型我在項(xiàng)目開(kāi)始前向傳感器廠商要了一份寄存器映射表這份表是整個(gè)系統(tǒng)能不能寫對(duì)代碼的命根子動(dòng)手前必須先啃透。常見(jiàn)的溫濕度傳感器溫度值一般放在保持寄存器或輸入寄存器里地址可能從0開(kāi)始也可能從某個(gè)偏移開(kāi)始比如0x0065這類地址。功能碼通常是03讀保持寄存器或者04讀輸入寄存器這兩個(gè)功能碼功能類似但有些設(shè)備實(shí)現(xiàn)不一樣選錯(cuò)就無(wú)法讀到數(shù)據(jù)。比地址更坑的是數(shù)據(jù)格式。有的傳感器用單個(gè)16位寄存器存一個(gè)整數(shù)溫度值有的用兩個(gè)16位寄存器拼成32位IEEE 754浮點(diǎn)數(shù)。溫度值尤其要注意正負(fù)一個(gè)帶符號(hào)的負(fù)溫度在寄存器里顯示為0xFFFF的補(bǔ)碼形式如果不按帶符號(hào)整數(shù)解析直接當(dāng)無(wú)符號(hào)數(shù)讀出來(lái)就是個(gè)65535這種天文數(shù)字。我在項(xiàng)目里選用的傳感器是單寄存器存儲(chǔ)溫度縮放系數(shù)0.01濕度縮放系數(shù)0.1也就是說(shuō)寄存器原始值2534代表實(shí)際溫度25.34℃原始值623代表濕度62.3%RH。這里強(qiáng)烈建議先把單個(gè)傳感器接到測(cè)試環(huán)境用Modbus調(diào)試工具比如Modbus Poll人工讀取一遍所有寄存器核對(duì)數(shù)值是否符合現(xiàn)場(chǎng)儀表顯示。不要信任出廠默認(rèn)參數(shù)因?yàn)楹芏鄠鞲衅鞒鰪S時(shí)寄存器地址可以撥碼調(diào)整和說(shuō)明書不一定完全一致。這一步提前做了后面寫代碼就少走大量彎路。2.2 用pymodbus實(shí)現(xiàn)TCP與UDP雙模式讀取采集程序我用的Python加pymodbus庫(kù)這個(gè)庫(kù)是目前Python生態(tài)里最主流的Modbus協(xié)議實(shí)現(xiàn)接口穩(wěn)定、文檔全、坑也少。按項(xiàng)目需求我需要同時(shí)支持TCP和UDP兩種模式pymodbus的ModbusTcpClient和ModbusUdpClient可以干凈利落地解決這個(gè)問(wèn)題。先看TCP模式的標(biāo)準(zhǔn)讀取代碼核心流程是創(chuàng)建客戶端、連接、讀寄存器、關(guān)閉連接from pymodbus.client import ModbusTcpClient client ModbusTcpClient(192.168.10.21, port502, timeout3) if not client.connect(): raise RuntimeError(無(wú)法連接傳感器) # 讀保持寄存器起始地址0x0065101讀2個(gè)寄存器從站地址unit1 resp client.read_holding_registers(address0x0065, count2, unit1) if resp.isError(): raise RuntimeError(fModbus讀取失敗: {resp}) temp_raw resp.registers[0] hum_raw resp.registers[1] print(f原始值: 溫度{temp_raw}, 濕度{hum_raw}) client.close()UDP模式幾乎一樣只需要把TCP客戶端替換為UDP客戶端from pymodbus.client import ModbusUdpClient client ModbusUdpClient(192.168.10.21, port502, timeout3) resp client.read_holding_registers(address0x0065, count2, unit1) if not resp.isError(): print(resp.registers) client.close()注意UDP模式里沒(méi)有顯式connect而是直接發(fā)送請(qǐng)求等響應(yīng)因?yàn)閁DP本身是無(wú)連接的pymodbus對(duì)UDP的實(shí)現(xiàn)是單包請(qǐng)求-響應(yīng)模式。這里有個(gè)細(xì)節(jié)實(shí)際項(xiàng)目中一般不會(huì)每次都新建連接而是建立一個(gè)連接池或復(fù)用同一個(gè)客戶端對(duì)象因?yàn)門CP每次握手成本高頻繁開(kāi)關(guān)連接對(duì)設(shè)備也是一種壓力。我在輪詢循環(huán)里是初始化一次客戶端然后在循環(huán)中反復(fù)使用同一個(gè)連接。多傳感器輪詢時(shí)我寫了一個(gè)讀取函數(shù)把傳感器IP和寄存器配置放進(jìn)一個(gè)列表逐個(gè)調(diào)用。這個(gè)方案的點(diǎn)位規(guī)模在32個(gè)左右串行輪詢完全夠用。如果點(diǎn)位到了幾百個(gè)可以把輪詢改成異步并發(fā)但那是另一層復(fù)雜度了中小型樓宇暫時(shí)不需要。2.3 輪詢周期、超時(shí)和重試該怎么算輪詢周期的選擇直接影響設(shè)備負(fù)載和網(wǎng)絡(luò)占用。工業(yè)級(jí)溫濕度傳感器一般響應(yīng)時(shí)間在幾十毫秒到幾百毫秒之間樓宇環(huán)境溫度變化本身是分鐘級(jí)的完全不需要毫秒級(jí)采集。我的經(jīng)驗(yàn)是將每個(gè)點(diǎn)位的輪詢周期設(shè)置在10秒到30秒之間有告警需求的機(jī)房點(diǎn)位用10秒普通倉(cāng)儲(chǔ)區(qū)用30秒。超時(shí)時(shí)間的計(jì)算邏輯是這樣的傳感器正常響應(yīng)比如50毫秒但你要給異常留出足夠余量設(shè)成3秒是合理選擇。太短的話設(shè)備偶發(fā)慢響應(yīng)就會(huì)誤判為故障太長(zhǎng)的話一旦某臺(tái)設(shè)備不在線輪詢線程就會(huì)卡在這里很久。再配合重試機(jī)制我用的是固定間隔重試3次間隔1秒3次全部失敗就把該點(diǎn)位標(biāo)記為離線并繼續(xù)輪詢下一個(gè)點(diǎn)位。這樣單臺(tái)設(shè)備故障不會(huì)拖垮整個(gè)輪詢鏈路。我算過(guò)一臺(tái)采集服務(wù)器在32個(gè)點(diǎn)位、每個(gè)點(diǎn)位讀2個(gè)寄存器、單次往返約100毫秒的場(chǎng)景下完整輪詢一輪的時(shí)間是32乘以0.1秒也就是3.2秒左右。即便按最保守估算10秒的輪詢周期也留了3倍以上余量完全不會(huì)出現(xiàn)數(shù)據(jù)堆積或輪詢?nèi)蝿?wù)追趕的情況。如果你的點(diǎn)位特別多或者網(wǎng)絡(luò)鏈路比較差輪詢周期要相應(yīng)拉長(zhǎng)否則不同點(diǎn)位的采集時(shí)間戳落差會(huì)很大在網(wǎng)管平臺(tái)上看曲線就不準(zhǔn)了。2.4 TCP模式與UDP模式各自的坑與選型建議TCP模式最常見(jiàn)的坑是連接假死。傳感器設(shè)備長(zhǎng)時(shí)間沒(méi)有請(qǐng)求時(shí)有些型號(hào)會(huì)主動(dòng)斷開(kāi)TCP連接但客戶端側(cè)不知道后續(xù)read請(qǐng)求會(huì)等到超時(shí)才報(bào)錯(cuò)。解決方法是給socket加TCP keepalive或者在每次讀取之前判斷連接是否斷開(kāi)、必要時(shí)重連。我在采集程序里加了一個(gè)重連邏輯讀取異常時(shí)先做三次快速重試都不行再?gòu)?qiáng)制重建連接。UDP模式的坑更多集中在事務(wù)匹配上。Modbus UDP報(bào)文頭里帶Transaction ID每次請(qǐng)求要遞增客戶端在收響應(yīng)時(shí)要用事務(wù)ID和從站地址校驗(yàn)是否匹配防止把上一個(gè)請(qǐng)求的遲到的響應(yīng)當(dāng)成這一次的結(jié)果。pymodbus底層已經(jīng)做了這個(gè)處理但如果你是自己裸寫協(xié)議棧這個(gè)問(wèn)題必須重視。UDP丟包沒(méi)有協(xié)議層的自動(dòng)重傳所以必須自己做超時(shí)重試。我在UDP讀取時(shí)固定做3次重試并遞增事務(wù)ID實(shí)測(cè)在基礎(chǔ)網(wǎng)絡(luò)質(zhì)量比較好的局域網(wǎng)里丟包率很低一次讀取失敗的概率大概在2%以下。還有一個(gè)選型建議值得單獨(dú)說(shuō)。如果所有傳感器都已經(jīng)支持Modbus TCP沒(méi)必要為了“先進(jìn)”去用UDP如果有些傳感器只開(kāi)放了UDP接口那就單獨(dú)給這類設(shè)備走UDP采集其余統(tǒng)一走TCP。不要讓一個(gè)采集程序?yàn)榱思嫒菪园炎约焊愕锰珡?fù)雜分兩條采集通道反而更清爽。3. 數(shù)據(jù)上送層把Modbus數(shù)據(jù)翻譯成SNMP能識(shí)別的OID3.1 SNMP網(wǎng)管模型與OID樹(shù)的基本邏輯SNMP的邏輯其實(shí)很簡(jiǎn)單它定義了一套“被管對(duì)象”的樹(shù)形結(jié)構(gòu)每個(gè)對(duì)象用OID對(duì)象標(biāo)識(shí)符表示網(wǎng)管平臺(tái)作為管理端不斷向設(shè)備Agent發(fā)起查詢請(qǐng)求Agent返回OID對(duì)應(yīng)的值。OID是一個(gè)一串點(diǎn)分十進(jìn)制數(shù)字的路徑比如.1.3.6.1.4.1.9.9.205這個(gè)路徑下可能就是一個(gè)具體的設(shè)備狀態(tài)節(jié)點(diǎn)。在樓宇自控場(chǎng)景里網(wǎng)管平臺(tái)就是NMS采集服務(wù)器上的SNMP服務(wù)就是Agent。我們要做的事情就是自定義幾個(gè)有意義的OID節(jié)點(diǎn)并把溫濕度數(shù)據(jù)掛上去這樣網(wǎng)管平臺(tái)通過(guò)OID就能直接讀到溫度值完全不用關(guān)心底層是Modbus還是別的協(xié)議。這就是一種協(xié)議封裝和屏蔽對(duì)上層是透明的特別適合運(yùn)維體系已經(jīng)成熟的樓宇。SNMP協(xié)議版本上v1已經(jīng)過(guò)時(shí)v2c是現(xiàn)在使用最普遍的版本它使用明文Community字符串做簡(jiǎn)單認(rèn)證v3引入了用戶密碼和加密安全可控但配置復(fù)雜。樓宇網(wǎng)管平臺(tái)如果比較老可能只支持v2c我對(duì)接時(shí)優(yōu)先兼容v2c同時(shí)用IP白名單和復(fù)雜Community來(lái)做安全補(bǔ)償具體會(huì)在后面單獨(dú)說(shuō)。3.2 自定義MIB文件給溫濕度點(diǎn)位定義“合法身份證”光有OID還不夠網(wǎng)管平臺(tái)要正確解析OID的含義還需要配套MIB文件。MIB文件本質(zhì)是一個(gè)用ASN.1語(yǔ)法寫的對(duì)象定義說(shuō)明書它把OID數(shù)值路徑對(duì)應(yīng)成人類可讀的名稱、數(shù)據(jù)類型、讀寫權(quán)限、描述信息。可以說(shuō)MIB文件就是SNMP世界的身份證。我不能直接用廠商私有OID段因?yàn)槠髽I(yè)的OID編號(hào)是有分配的偷用大廠的OID段會(huì)造成沖突。標(biāo)準(zhǔn)做法是找上級(jí)機(jī)構(gòu)申請(qǐng)一個(gè)企業(yè)號(hào)比如.1.3.6.1.4.1后面的數(shù)字就是企業(yè)號(hào)。項(xiàng)目里我按企業(yè)內(nèi)部規(guī)范申請(qǐng)了一個(gè)測(cè)試段的號(hào)段然后定義一個(gè)節(jié)點(diǎn)樹(shù)把溫濕度都掛在自定義節(jié)點(diǎn)下面。一個(gè)典型的溫濕度MIB定義長(zhǎng)這樣myBuilding-MIB DEFINITIONS :: BEGIN IMPORTS enterprises, OBJECT-TYPE, Integer32 FROM SNMPv2-SMI; myEnterprise OBJECT IDENTIFIER :: { enterprises 99999 } myProduct OBJECT IDENTIFIER :: { myEnterprise 1 } sensorRoot OBJECT IDENTIFIER :: { myProduct 1 } sensorName OBJECT-TYPE SYNTAX OCTET STRING (SIZE (0..64)) MAX-ACCESS read-only STATUS current DESCRIPTION 溫濕度傳感器點(diǎn)位名稱 :: { sensorRoot 1 } temperatureScaled OBJECT-TYPE SYNTAX Integer32 MAX-ACCESS read-only STATUS current DESCRIPTION 溫度單位0.01攝氏度如2534代表25.34℃ :: { sensorRoot 2 } humidityScaled OBJECT-TYPE SYNTAX Integer32 MAX-ACCESS read-only STATUS current DESCRIPTION 濕度單位0.1%RH如623代表62.3%RH :: { sensorRoot 3 } END這里有幾個(gè)細(xì)節(jié)值得注意。類型按實(shí)際數(shù)據(jù)選溫度濕度用整數(shù)類型傳縮放后的數(shù)值這樣在網(wǎng)管平臺(tái)顯示時(shí)不會(huì)出現(xiàn)浮點(diǎn)精度問(wèn)題。描述字段一定要寫清楚單位和縮放系數(shù)否則分不清1.2534還是2534。我看過(guò)太多人MIB里把溫度的單位亂寫最后平臺(tái)顯示25.34℃還是2534℃全靠人力猜。3.3 輕量級(jí)Agent方案用snmpd的pass機(jī)制對(duì)接采集腳本網(wǎng)管平臺(tái)只認(rèn)SNMP服務(wù)所以需要在采集服務(wù)器上運(yùn)行一個(gè)SNMP Agent。最省心的方案不是自己寫一個(gè)Agent程序而是直接用Linux自帶的snmpd用它提供的pass指令把指定OID段外包給一個(gè)外部腳本處理。這個(gè)方案部署極其輕量不需要改snmpd源碼也不用后臺(tái)常駐一個(gè)自寫Agent服務(wù)特別適合用Python采集、點(diǎn)位幾十個(gè)這種規(guī)模。snmpd配置里加上一行表示當(dāng)網(wǎng)管平臺(tái)請(qǐng)求.1.3.6.1.4.1.99999節(jié)點(diǎn)下的任何OID時(shí)都調(diào)用/usr/local/bin/sensor_read.py這個(gè)腳本pass .1.3.6.1.4.1.99999 /usr/local/bin/sensor_read.py腳本的邏輯是接收參數(shù)OID根據(jù)OID判斷返回哪個(gè)傳感器的哪個(gè)值。腳本從采集程序?qū)懞玫木彺嫖募镒x取最新溫濕度數(shù)據(jù)按snmpd規(guī)定的三行格式返回第一行是要返回的完整OID第二行是類型integer、string、gauge等第三行是值。#!/usr/bin/env python3 import sys import json # 讀取采集程序維護(hù)的緩存文件 with open(/var/run/sensor_cache.json, r, encodingutf-8) as f: data json.load(f) oid sys.argv[1] if oid .1.3.6.1.4.1.99999.1.2.0: print(.1.3.6.1.4.1.99999.1.2.0) print(integer) print(str(data[temperature])) elif oid .1.3.6.1.4.1.99999.1.3.0: print(.1.3.6.1.4.1.99999.1.3.0) print(integer) print(str(data[humidity])) elif oid .1.3.6.1.4.1.99999.1.1.0: print(.1.3.6.1.4.1.99999.1.1.0) print(string) print(三層機(jī)房A1點(diǎn)位) else: sys.exit(1)pass腳本的一個(gè)要點(diǎn)是執(zhí)行時(shí)間不能太長(zhǎng)snmpd默認(rèn)給外部腳本的處理時(shí)間非常有限如果腳本里還在做網(wǎng)絡(luò)請(qǐng)求很容易被snmpd判定超時(shí)。我特意讓采集進(jìn)程單獨(dú)跑持續(xù)把最新數(shù)據(jù)寫入json文件pass腳本只讀本地文件不碰任何網(wǎng)絡(luò)這樣響應(yīng)速度幾乎為零延遲聯(lián)調(diào)非常順暢。3.4 完整Agent方案用pysnmp直接發(fā)布OID值可選如果你遇到的情況比較特殊比如不允許在服務(wù)器上裝系統(tǒng)的snmpd擴(kuò)展或者需要更靈活的OID發(fā)布邏輯可以考慮用pysnmp自己實(shí)現(xiàn)一個(gè)SNMP Agent。這個(gè)方案更重但自由度也更高適合采集和上送邏輯需要深度耦合的場(chǎng)景。用pysnmp注冊(cè)O(shè)ID值非常簡(jiǎn)單它提供CommandResponder模式你定義好每個(gè)OID的獲取方法后在循環(huán)中監(jiān)聽(tīng)UDP 161端口即可。核心代碼大致是編寫一個(gè)回調(diào)函數(shù)根據(jù)請(qǐng)求的OID從緩存字典里取當(dāng)前溫度濕度值返回。比起pass腳本方式pysnmp方案勝在Agent完全可控Trap報(bào)文隨時(shí)能發(fā)適合做過(guò)自定義輪詢模式或頻繁上報(bào)的場(chǎng)景但對(duì)開(kāi)發(fā)者要求更高調(diào)試也更復(fù)雜。從項(xiàng)目交付角度看除非你對(duì)pysnmp很熟悉否則我更推薦先上snmpd加pass的方案因?yàn)樗銐蚍€(wěn)定、足夠簡(jiǎn)單而且snmpd本身的并發(fā)和性能處理已經(jīng)很成熟。后續(xù)如果要擴(kuò)展告警聯(lián)動(dòng)再考慮用Python寫Trap發(fā)送腳本不用推翻現(xiàn)有體系。3.5 Community與訪問(wèn)安全別把數(shù)據(jù)裸奔在局域網(wǎng)里SNMP v2c的Community字符串就是密碼如果你用默認(rèn)的public等于把整棟樓的溫濕度數(shù)據(jù)裸奔在局域網(wǎng)里任何人用網(wǎng)管軟件掃一下就能看到所有點(diǎn)位。我在配置里做了三件事設(shè)置足夠復(fù)雜的只讀Community比如混合大小寫加數(shù)字的隨機(jī)串在snmpd配置里顯式限定允許訪問(wèn)的網(wǎng)管平臺(tái)IP其他主機(jī)一律拒絕訪問(wèn)網(wǎng)絡(luò)層再做隔離傳感器采集網(wǎng)段和辦公網(wǎng)段在交換機(jī)上做ACL控制只開(kāi)放網(wǎng)管平臺(tái)到采集服務(wù)器的161端口。SNMP v3雖然是更安全的選擇用用戶名密碼加加密的方式代替明文Community但在樓宇網(wǎng)管的實(shí)際對(duì)接中我發(fā)現(xiàn)許多老平臺(tái)的v3實(shí)現(xiàn)不太穩(wěn)定配置復(fù)雜度也高。我做的是v2c為主、加上IP白名單兜底的方案既保證了兼容性又堵住了最明顯的安全漏洞。如果你所在環(huán)境對(duì)安全要求高且網(wǎng)管平臺(tái)支持v3那就用v3這里沒(méi)有一刀切的標(biāo)準(zhǔn)。4. 聯(lián)調(diào)驗(yàn)證從命令行到樓宇網(wǎng)管平臺(tái)的完整對(duì)接4.1 用snmpwalk驗(yàn)證OID與數(shù)值換算配置完snmpd后第一步當(dāng)然是用命令行工具自己驗(yàn)證。我在服務(wù)器上執(zhí)行snmpwalk指定社區(qū)字符串、目標(biāo)IP和根OID看能不能正確拉出全部溫濕度數(shù)據(jù)snmpwalk -v2c -c MySite2024 127.0.0.1 .1.3.6.1.4.1.99999輸出大約是SNMPv2-SMI::enterprises.99999.1.1.0 STRING: 三層機(jī)房A1點(diǎn)位 SNMPv2-SMI::enterprises.99999.1.2.0 INTEGER: 2350 SNMPv2-SMI::enterprises.99999.1.3.0 INTEGER: 6122350代表23.50℃612代表61.2%RH我把這個(gè)值和現(xiàn)場(chǎng)手持儀表的讀數(shù)比對(duì)了下差值在允許范圍內(nèi)說(shuō)明Modbus讀取、單位換算、OID發(fā)布這條鏈路的數(shù)據(jù)一致性是對(duì)的。這里提醒一個(gè)容易忽略的細(xì)節(jié)驗(yàn)證時(shí)不要只看一次要連續(xù)測(cè)幾輪確認(rèn)數(shù)值是隨采集周期動(dòng)態(tài)更新的而不是snmpd緩存了一個(gè)死值。命令行驗(yàn)證通過(guò)后再測(cè)試Trap。我用snmptrap命令模擬一條越限告警發(fā)送到網(wǎng)管平臺(tái)確認(rèn)平臺(tái)的SNMP Trap接收端口能收到事件。這一步很重要因?yàn)楹芏囗?xiàng)目做完了數(shù)據(jù)輪詢才發(fā)現(xiàn)告警通道沒(méi)通等于少了一條腿。測(cè)試通過(guò)后整個(gè)SNMP對(duì)接鏈路的前半段才算真正完成。4.2 網(wǎng)管平臺(tái)導(dǎo)入MIB與監(jiān)控項(xiàng)創(chuàng)建接下來(lái)進(jìn)入網(wǎng)管平臺(tái)操作。每家平臺(tái)的操作界面不一樣但邏輯都差不多。先把自定義的MIB文件導(dǎo)入平臺(tái)平臺(tái)解析后就能在OID樹(shù)里看到我們定義的點(diǎn)位名稱、類型和單位。然后新建一個(gè)監(jiān)控主機(jī)添加監(jiān)控項(xiàng)填寫采集服務(wù)器的IP、SNMP版本、社區(qū)字符串和要監(jiān)控的OID。我建議監(jiān)控項(xiàng)建立時(shí)就把顯示格式配好比如把溫度OID的顯示格式設(shè)置成除以100顯示兩位小數(shù)這樣平臺(tái)界面上看到的就是23.50℃而不是原始整數(shù)2350。雖然MIB描述里已經(jīng)寫了單位是0.01℃但顯示格式在平臺(tái)側(cè)可以進(jìn)一步優(yōu)化。如果沒(méi)有這一步很多平臺(tái)的表格里會(huì)直接顯示2350運(yùn)維人員看到數(shù)字還要心算體驗(yàn)很差。監(jiān)控項(xiàng)建好后讓平臺(tái)拉到采集服務(wù)器的OID值確認(rèn)數(shù)據(jù)刷新周期與采集周期匹配。一般平臺(tái)默認(rèn)輪詢間隔是1分鐘或5分鐘我設(shè)的采集周期是10秒這樣平臺(tái)每次拉取拿到的都是相對(duì)實(shí)時(shí)的數(shù)據(jù)數(shù)據(jù)曲線的分辨率也有了保障。此時(shí)從網(wǎng)管平臺(tái)角度這個(gè)溫濕度點(diǎn)位就和一臺(tái)空調(diào)、一臺(tái)UPS沒(méi)有任何區(qū)別都只是SNMP OID的一個(gè)節(jié)點(diǎn)。4.3 告警閾值、回滯與聯(lián)動(dòng)擴(kuò)展溫濕度監(jiān)測(cè)的價(jià)值不止于看曲線更在于越限告警。平臺(tái)里給溫度OID配置上下閾值比如機(jī)房環(huán)境溫度上限26℃下限18℃濕度上限70%RH下限30%RH。配置的時(shí)候一定要加上回滯Hysteresis比如報(bào)警觸發(fā)溫度高于26℃,恢復(fù)溫度設(shè)為24℃。這樣當(dāng)溫度在26℃附近抖動(dòng)時(shí)不會(huì)頻繁觸發(fā)告警又解除告警把值班人員煩死?;販木唧w數(shù)值可以參考管理要求的精度上下浮動(dòng)1-2℃我在機(jī)房里用的是恢復(fù)閾值比報(bào)警閾值收斂1℃的做法實(shí)測(cè)誤報(bào)率下降明顯。除了展示與告警這套系統(tǒng)還可以做聯(lián)動(dòng)擴(kuò)展。比如當(dāng)Modbus采集到某點(diǎn)位溫度持續(xù)超過(guò)28℃時(shí)采集程序通過(guò)Modbus TCP向一臺(tái)受控空調(diào)發(fā)送指令強(qiáng)制開(kāi)啟制冷。再比如當(dāng)濕度低于臨界值時(shí)通過(guò)SNMP Trap通知平臺(tái)平臺(tái)觸發(fā)加濕器啟停。由于采集層和支持層邏輯是解耦的所以我可以在采集程序里直接加寫Modbus寄存器的邏輯不必改動(dòng)SNMP那部分非常方便。5. 實(shí)戰(zhàn)排坑運(yùn)行半年遇到的典型問(wèn)題與處理記錄5.1 問(wèn)題實(shí)錄Modbus連接周期性掉線系統(tǒng)上線兩個(gè)月后運(yùn)維反饋某幾個(gè)點(diǎn)位的數(shù)據(jù)間斷性缺失現(xiàn)象是網(wǎng)管平臺(tái)看到數(shù)值20分鐘內(nèi)不刷新然后又有新數(shù)據(jù)。排查過(guò)程是先看采集日志發(fā)現(xiàn)這些點(diǎn)位每次都在TCP連接上拋超時(shí)異常重連后恢復(fù)。進(jìn)一步抓包發(fā)現(xiàn)傳感器一側(cè)的TCP連接被設(shè)備在空閑一段時(shí)間后主動(dòng)斷開(kāi)而采集程序一直在復(fù)用舊socket自然收不到響應(yīng)。解決方法是加一個(gè)兩層防護(hù)。第一層是TCP keepalive探測(cè)打開(kāi)socket的SO_KEEPALIVE選項(xiàng)讓系統(tǒng)定期發(fā)送探測(cè)包維持通道活躍第二層是采集程序?qū)用娴倪B接狀態(tài)檢查在每次發(fā)送前檢查連接對(duì)象是否可用不可用則自動(dòng)重連。這樣做了之后這類掉線問(wèn)題基本消失。還有一例是某個(gè)傳感器的電源模塊老化導(dǎo)致的間歇性重啟TCP連接頻繁斷換了電源模塊后恢復(fù)。所以遇到掉線問(wèn)題先檢查程序重連邏輯再檢查設(shè)備側(cè)電源和網(wǎng)絡(luò)硬件別一開(kāi)始就懷疑協(xié)議寫錯(cuò)了。5.2 問(wèn)題實(shí)錄寄存器讀數(shù)出現(xiàn)“負(fù)值”和亂碼聯(lián)調(diào)階段有個(gè)傳感器的濕度讀出來(lái)偶爾是65535或者-1溫度倒是正常。排查后發(fā)現(xiàn)這個(gè)傳感器有多個(gè)寄存器地址段我讀的地址在某些型號(hào)里是未啟用的保留區(qū)讀取時(shí)返回0xFFFF如果按無(wú)符號(hào)數(shù)解析就是65535按有符號(hào)解析就是-1。解決方法是重新核對(duì)寄存器映射表把讀取地址調(diào)整到正確的濕度寄存器并在程序里加了一個(gè)合法性檢查讀到0xFFFF或0x7FFF這類邊界值時(shí)視為無(wú)效數(shù)據(jù)不參與換算和上送避免網(wǎng)管平臺(tái)出現(xiàn)離譜的告警。另一個(gè)容易踩的坑是字節(jié)序。不同廠商的傳感器在32位浮點(diǎn)存儲(chǔ)時(shí)大小端順序可能不同。我一開(kāi)始讀某個(gè)型號(hào)的浮點(diǎn)溫度數(shù)值總是差著十萬(wàn)八千里后來(lái)把兩個(gè)16位寄存器的高低位交換才正常。代碼里如果是自己拼浮點(diǎn)寄存器記得先看一下廠家的字節(jié)序說(shuō)明或者在調(diào)試階段實(shí)際比對(duì)一下寄存器原始值和設(shè)備LCD顯示值的關(guān)系。5.3 問(wèn)題實(shí)錄SNMP超時(shí)、OID值不刷新有一次平臺(tái)側(cè)反饋某點(diǎn)位數(shù)值一直不變我開(kāi)始以為傳感器壞了結(jié)果用Modbus工具直接讀傳感器是好的而且溫度在變。接著用命令行snmpwalk手動(dòng)查OID返回值確實(shí)刷新了但平臺(tái)拿到的卻始終是舊值。細(xì)細(xì)排查之后發(fā)現(xiàn)是平臺(tái)配置的輪詢間隔是5分鐘而采集服務(wù)器到網(wǎng)管平臺(tái)之間恰好有一臺(tái)設(shè)備的ACL策略把SNMP請(qǐng)求鏡像到了備用機(jī)導(dǎo)致平臺(tái)實(shí)際讀取的是另一臺(tái)服務(wù)器的快照。這是網(wǎng)絡(luò)層路由策略導(dǎo)致的偶發(fā)問(wèn)題清除冗余策略后恢復(fù)正常。這種情況提醒我排查SNMP數(shù)據(jù)不刷新時(shí)要先確認(rèn)平臺(tái)輪詢到的是不是我們配置的那臺(tái)采集服務(wù)器再查Agent本身的OID值是否更新。還有一個(gè)常見(jiàn)原因是snmpd的pass腳本執(zhí)行太慢。如果腳本里有外部調(diào)用或耗時(shí)的解析邏輯snmpd等待超時(shí)后會(huì)返回空值平臺(tái)就會(huì)認(rèn)為讀取失敗并保留舊值。所以我強(qiáng)調(diào)pass腳本只做本地緩存數(shù)據(jù)的讀取采集邏輯單獨(dú)拆出去這個(gè)拆分從實(shí)戰(zhàn)看非常值。5.4 運(yùn)維期的心得與建議系統(tǒng)穩(wěn)定運(yùn)行半年后我復(fù)盤了一些值得固化為制度的東西。首先是點(diǎn)位命名規(guī)范我按照“樓棟-樓層-功能區(qū)-編號(hào)”的規(guī)則命名比如“A-03-MDF-01”這樣在網(wǎng)管平臺(tái)做故障定位時(shí)可以快速跳轉(zhuǎn)。命名這種工作瑣碎但特別重要?jiǎng)e等點(diǎn)位超過(guò)50個(gè)再回頭補(bǔ)。其次是傳感器定期校準(zhǔn)我要求現(xiàn)場(chǎng)每半年用標(biāo)準(zhǔn)溫濕度計(jì)比對(duì)一次偏差超標(biāo)的點(diǎn)位在平臺(tái)上設(shè)置漂移補(bǔ)償這對(duì)計(jì)量準(zhǔn)確性有要求的場(chǎng)景非常關(guān)鍵。還有就是要給采集服務(wù)器和傳感器網(wǎng)絡(luò)做一個(gè)總體的備份策略。采集服務(wù)器本身是一臺(tái)舊PC萬(wàn)一硬盤掛了整個(gè)系統(tǒng)就瞎了。我給服務(wù)器開(kāi)了定時(shí)備份把采集腳本、snmpd配置、緩存文件都納入備份范圍。傳感器網(wǎng)絡(luò)則做了物理鏈路的標(biāo)簽管理每根網(wǎng)線兩端都貼了標(biāo)簽方便后期排查。這套系統(tǒng)我做下來(lái)最深的體會(huì)是技術(shù)選型只是起點(diǎn)真正考驗(yàn)人的是把整個(gè)鏈路的數(shù)據(jù)從源頭到平臺(tái)變成可信任、可維護(hù)、可持續(xù)運(yùn)行的東西這需要很多看似瑣碎的細(xì)節(jié)積累。