TDengine PI 連接器部署架構(gòu)直連、taosX-Agent 代理與多工廠聚合方案選型指南【免費下載鏈接】TDengineHigh-performance, scalable time-series database designed for Industrial IoT (IIoT) scenarios項目地址: https://gitcode.com/GitHub_Trending/tde/TDengine本指南圍繞 TDengine 數(shù)據(jù)接入組件PI 連接器PI Connector的三種部署架構(gòu)展開taosX 直連Option A、taosX-Agent 代理Option B生產(chǎn)推薦、多 PI 系統(tǒng)聚合Option C。文中完整覆蓋各方案的適用場景、架構(gòu)拓?fù)洹?yōu)劣勢對比并結(jié)合倉庫文檔與組件資料給出 taosX-Agent 部署要點、網(wǎng)絡(luò)端口規(guī)劃與架構(gòu)選型決策表幫助你在 OT/IT 網(wǎng)絡(luò)隔離、多工廠數(shù)據(jù)匯聚等工業(yè)物聯(lián)網(wǎng)場景下選擇正確的部署形態(tài)。PI 連接器的定位與運行前提PI 連接器是 taosX 的一個插件負(fù)責(zé)從 OSIsoft / AVEVA PI 系統(tǒng)中讀取數(shù)據(jù)并寫入 TDengine。它的核心依賴是PI AF SDK而 PI AF SDK僅支持 Windows因此連接器所在的宿主機必須是一臺能夠直連 PI 系統(tǒng)的 Windows 主機。這一Windows-only的依賴決定了整個部署架構(gòu)的基本約束也直接派生出了下文的兩種連接器運行模式運行模式說明內(nèi)嵌于 taosXEmbedded in taosXtaosX 本身部署在可直連 PI 系統(tǒng)的 Windows 主機上連接器作為 taosX 的內(nèi)置插件運行通過 taosX-Agent 代理Via taosX-Agent proxytaosX 部署在其他位置如云端或 IT 數(shù)據(jù)中心PI 系統(tǒng)通過 taosX-Agent 作為代理訪問關(guān)于 PI 連接器依賴的更多前置條件端口、協(xié)議、權(quán)限、軟件依賴可參見 PI 數(shù)據(jù)接入前置條件連接器與 PI 系統(tǒng)交互的具體機制見 連接配置與認(rèn)證。Option AtaosX 直連Direct Connection適用場景taosX 可以直接部署在與 PI 系統(tǒng)同一網(wǎng)段的 Windows 服務(wù)器上。這是最簡單的形態(tài)taosX、PI 連接器子進程與 PI 系統(tǒng)處于同一個 OT 網(wǎng)絡(luò)內(nèi)。架構(gòu)拓?fù)鋑raph LR OT 網(wǎng)絡(luò)PI Data Archive / PI AF Server OT 網(wǎng)絡(luò)taosX 主機Windows含 PI connector 子進程 IT 網(wǎng)絡(luò)/數(shù)據(jù)中心TDengine taosX 主機 -- PI SDK 協(xié)議端口 5450/5457由 PI connector 子進程發(fā)起 -- PI 服務(wù)器 taosX 主機 -- 原生連接寫入 -- TDengine數(shù)據(jù)流為PI connector 子進程通過 PI SDK 協(xié)議端口 5450/5457從 PI 系統(tǒng)拉取數(shù)據(jù)再由 taosX 通過原生連接寫入 TDengine。優(yōu)點架構(gòu)簡單無需額外部署 taosX-Agent運維成本低限制taosX 必須運行在 Windows 上受 PI AF SDK 平臺限制taosX 主機必須同時可達 PI 系統(tǒng)與 TDengineOption BtaosX-Agent 代理模式推薦適用場景taosX 部署在云端或 IT 數(shù)據(jù)中心無法直接連接 PI 系統(tǒng)或者 PI 系統(tǒng)位于隔離的 OT 網(wǎng)絡(luò)中。此時由部署在 OT 網(wǎng)絡(luò)的 taosX-Agent 代理采集。架構(gòu)拓?fù)鋑raph LR OT 網(wǎng)絡(luò)PI Data Archive / PI AF Server OT 網(wǎng)絡(luò)taosX-Agent 主機Windows含 PI connector 子進程 IT 網(wǎng)絡(luò)/云taosXLinux / Windows IT 網(wǎng)絡(luò)/云TDengine taosX-Agent -- PI SDK 協(xié)議端口 5450/5457 -- PI 服務(wù)器 taosX-Agent -- 跨網(wǎng)絡(luò) gRPC -- taosX taosX -- 原生連接寫入 -- TDengine數(shù)據(jù)流為PI connector 子進程在 OT 網(wǎng)絡(luò)內(nèi)通過 PI SDK 協(xié)議采集 PI 數(shù)據(jù)taosX-Agent 通過跨網(wǎng)絡(luò) gRPC 將數(shù)據(jù)轉(zhuǎn)發(fā)給 taosX再由 taosX 寫入 TDengine。優(yōu)點taosX 可以部署在 Linux 上擺脫 PI AF SDK 僅支持 Windows 的限制符合 OT/IT 網(wǎng)絡(luò)分區(qū)的安全合規(guī)要求taosX-Agent 只需要兩個方向的網(wǎng)絡(luò)連通性到 PI 系統(tǒng)、到 taosX限制需要額外部署與維護 taosX-Agent運行 taosX-Agent 的 Windows 主機必須安裝 PI AF SDK:::tiptaosX-Agent 代理模式是生產(chǎn)環(huán)境的推薦部署方案尤其適合 OT/IT 網(wǎng)絡(luò)隔離的工業(yè)場景。 :::Option C多 PI 系統(tǒng)聚合適用場景企業(yè)級部署中多個工廠各自擁有獨立的 PI 系統(tǒng)需要將數(shù)據(jù)匯聚到統(tǒng)一的 TDengine 集群。架構(gòu)拓?fù)鋑raph LR 工廠 1 - OT 網(wǎng)絡(luò)PI 系統(tǒng) 1 工廠 1 - OT 網(wǎng)絡(luò)taosX-Agent 1Windows 工廠 2 - OT 網(wǎng)絡(luò)PI 系統(tǒng) 2 工廠 2 - OT 網(wǎng)絡(luò)taosX-Agent 2Windows 工廠 3 - OT 網(wǎng)絡(luò)PI 系統(tǒng) 3 工廠 3 - OT 網(wǎng)絡(luò)taosX-Agent 3Windows 數(shù)據(jù)中心/云taosX 數(shù)據(jù)中心/云TDengine taosX-Agent 1 -- PI SDK 協(xié)議 -- PI 系統(tǒng) 1 taosX-Agent 2 -- PI SDK 協(xié)議 -- PI 系統(tǒng) 2 taosX-Agent 3 -- PI SDK 協(xié)議 -- PI 系統(tǒng) 3 taosX-Agent 1 -- taosX taosX-Agent 2 -- taosX taosX-Agent 3 -- taosX taosX -- TDengine每個工廠在本地 OT 網(wǎng)絡(luò)部署獨立的 taosX-Agent統(tǒng)一匯聚到數(shù)據(jù)中心/云中的同一套 taosX 與 TDengine。優(yōu)點對多個 PI 系統(tǒng)的數(shù)據(jù)進行統(tǒng)一管理各工廠獨立部署自己的 taosX-Agent互不影響有利于企業(yè)級數(shù)據(jù)分析與監(jiān)控注意事項每個 taosX-Agent 需要獨立安裝 PI AF SDK并為對應(yīng)的 PI 系統(tǒng)配置訪問權(quán)限建議對不同工廠的數(shù)據(jù)使用不同的 TDengine 數(shù)據(jù)庫或超級表前綴避免命名沖突taosX-Agent 部署關(guān)鍵點如果選擇了 Option B 或 Option C以下是 taosX-Agent 部署時需要重點核對的關(guān)鍵點關(guān)鍵點說明操作系統(tǒng)必須是 WindowsPI AF SDK 僅支持 WindowsPI AF SDKtaosX-Agent 主機上必須安裝 PI AF SDKPI AF Client 2018taosX/taosX-Agent 將 PI 連接器作為子進程啟動連接器調(diào)用 PI AF SDK 與 PI 通信服務(wù)賬戶taosX-Agent 服務(wù)的 Windows 身份默認(rèn)Local System → 域中的機器賬戶即連接器呈現(xiàn)給 PI 的身份該身份必須在 PI 側(cè)被授予權(quán)限網(wǎng)絡(luò) - PI 側(cè)taosX-Agent 主機 → PI Data Archive端口 5450taosX-Agent 主機 → PI AF Server端口 5457網(wǎng)絡(luò) - taosX 側(cè)taosX-Agent ? taosX 網(wǎng)絡(luò)連通gRPC安裝方式在 taosExplorer 中點擊Create New Agent獲取 taosX-Agent 安裝指引taosX-Agent 的安裝與配置實操taosX-Agent 是 TDengine TSDB Enterprise 的獨立組件需要單獨下載不包含在 TDengine 安裝包中社區(qū)版不提供。安裝后的關(guān)鍵文件位置如下項目LinuxWindows可執(zhí)行文件/usr/bin/taosx-agentC:\TDengine\taosx-agent.exe配置文件/etc/taos/agent.tomlC:\TDengine\cfg\agent.toml日志目錄/var/log/taos/C:\TDengine\log\服務(wù)名taosx-agentsystemdtaosx-agentWindows 服務(wù)部署流程為在 taosExplorer 的Data In → Agent 標(biāo)簽頁點擊Create New Agent向?qū)梢粋€endpoint和token將其保存到agent.toml配置文件中然后啟動服務(wù)并驗證 Agent 狀態(tài)。詳細(xì)的安裝步驟與排查方法見 taosX-Agent 組件參考。配置文件agent.toml使用 TOML 格式最小必需配置如下# taosX gRPC 服務(wù)地址必填 endpoint http://taosX_host:6055 # 在 Explorer 中創(chuàng)建 Agent 時生成的 Token必填 token your_token常用可選參數(shù)還包括參數(shù)默認(rèn)值說明instanceId—Agent 實例 ID同一臺機器運行多個 Agent 實例時必須唯一compressionfalse是否啟用 Agent 與 taosX 之間的通信數(shù)據(jù)壓縮in_memory_cache_capacity64內(nèi)存中可緩存的最大消息批次數(shù)必須大于 0keep_onlinetruetaosX 服務(wù)不可用或連接丟失時是否保持 Agent 運行并嘗試重連[client_port_range].min/.max49152/65535Agent 連接 taosX 時客戶端端口范圍限制[log]段—日志路徑、級別、輪轉(zhuǎn)、保留天數(shù)等配置完整的agent.toml配置示例見 taosX-Agent 配置參考。架構(gòu)選型決策表根據(jù)實際網(wǎng)絡(luò)環(huán)境與部署條件可按下表快速確定推薦方案條件推薦方案taosX 可以部署在與 PI 系統(tǒng)同一網(wǎng)段的 Windows 主機上Option A直連taosX 在云端或 IT 網(wǎng)絡(luò)PI 在 OT 網(wǎng)絡(luò)Option BtaosX-Agent 代理多個工廠的多個 PI 系統(tǒng)需要匯聚到同一套 TDengineOption C多 PI 聚合嚴(yán)格的 OT/IT 網(wǎng)絡(luò)隔離與安全合規(guī)要求Option B 或 CtaosX-Agent 代理希望 taosX 運行在 Linux 上Option B 或 CtaosX-Agent 代理網(wǎng)絡(luò)與端口規(guī)劃無論采用哪種架構(gòu)PI 側(cè)的網(wǎng)絡(luò)連通性要求是一致的。運行 taosX或 taosX-Agent的主機必須能訪問 PI 系統(tǒng)的以下端口源目的端口協(xié)議說明PI 連接器taosX/taosX-Agent 主機PI Data Archive Server5450/TCPPI AF SDK 專有協(xié)議必需讀取 PI Point 數(shù)據(jù)PI 連接器taosX/taosX-Agent 主機PI AF Server5457/TCPPI AF SDK 專有協(xié)議使用 AF 模式時必需taosX-AgenttaosXtaosX 配置的端口gRPC使用 taosX-Agent 代理模式時必需:::note 上述端口是 PI 系統(tǒng)默認(rèn)值。PI 連接器taosx-pi.exe通過 PI AF SDK 與 PI 系統(tǒng)通信端口由 SDK 內(nèi)部管理連接器中無需手動配置端口但防火墻必須放行這些端口否則 SDK 連接會失敗。若 PI 系統(tǒng)使用非標(biāo)準(zhǔn)端口請與 PI 管理員確認(rèn)實際端口號。 :::在 taosX / taosX-Agent 主機上可用以下命令快速驗證端口連通性# Windows PowerShell Test-NetConnection -ComputerName PI_SERVER_HOST -Port 5450 Test-NetConnection -ComputerName AF_SERVER_HOST -Port 5457# Linux僅用于驗證 taosX ? taosX-Agent 連通性 nc -zv HOST PORTAgent 到 taosX 的 gRPC 端口默認(rèn)為6055部署前同樣建議先驗證Linux 使用nc -zv taosX_host 6055Windows 使用Test-NetConnection -ComputerName taosX_host -Port 6055。服務(wù)賬戶與認(rèn)證要點taosX-Agent 默認(rèn)以 WindowsLocal System賬戶運行在域環(huán)境中對應(yīng)機器賬戶如DOMAIN\machinename$。連接器訪問 PI 時呈現(xiàn)給 PI 的身份就是 taosX-Agent 服務(wù)的 Windows 身份因此該身份必須在 PI 側(cè)獲得授權(quán)在 PI Data Archive 中PI 管理員應(yīng)使用 PI System Management ToolsSMT創(chuàng)建 Mapping將 Windows 賬戶的 SID 映射到具有讀取權(quán)限的PI IdentitySMT → Security → Mappings使用 AF 模式時還需在 PI System ExplorerPSE中為該賬戶授予 AF 數(shù)據(jù)庫及 AF Elements/Attributes 的 Read 與 Read Data 權(quán)限生產(chǎn)環(huán)境建議為 taosX-Agent 配置專用的域服務(wù)賬戶避免使用 Local System 機器賬戶、個人賬戶或高權(quán)限管理員賬戶遵循最小權(quán)限原則僅授予 PI 數(shù)據(jù)讀取權(quán)限。連接配置中的 Username/Password/Domain 字段默認(rèn)留空即可使用 Windows 集成認(rèn)證Kerberos 或 NTLM只有當(dāng)需要以指定 Windows 賬戶覆蓋服務(wù)賬戶身份時才填寫顯式憑據(jù)。更完整的字段說明與認(rèn)證機制見 連接配置與認(rèn)證。高可用與故障轉(zhuǎn)移延伸選擇 Option B 或 Option C 時可以進一步通過多 taosX 實例注冊為引擎中的 Xnode實現(xiàn)任務(wù)級高可用PI 任務(wù)按單實例調(diào)度模型運行在某個最佳 Xnode 上節(jié)點故障后調(diào)度器約在 10–30 秒內(nèi)將任務(wù)重調(diào)度到可用節(jié)點計劃維護時可用DRAIN XNODE id主動遷移任務(wù)。故障期間產(chǎn)生/更新的數(shù)據(jù)可通過重啟補償時間與歷史數(shù)據(jù)回填彌補。詳細(xì)的調(diào)度模型、故障轉(zhuǎn)移行為與生產(chǎn)級推薦架構(gòu)如 TDengine 3 dnodes 三副本 mnode、2–3 個 taosX/Xnode、共享存儲、Agent 指向集群內(nèi)全部 taosX 端點參見 高可用與故障轉(zhuǎn)移Xnode 的注冊與調(diào)度 SQL 語法見 數(shù)據(jù)接入Xnode?？偨Y(jié)選擇 PI 連接器部署架構(gòu)的核心判斷依據(jù)是網(wǎng)絡(luò)拓?fù)渫痪W(wǎng)段內(nèi)可直連時用 Option AOT/IT 隔離、需要 taosX 跑在 Linux 時用 Option B生產(chǎn)推薦多工廠數(shù)據(jù)匯聚時用 Option C。無論哪種方案都必須保證承載 PI 連接器的 Windows 主機安裝了 PI AF SDK、正確配置了服務(wù)賬戶的 PI 側(cè)權(quán)限并放行 5450/5457 端口使用代理模式時還需維護好 Agent 與 taosX 之間的 gRPC 連通性與 Agent 配置。結(jié)合本文的決策表與部署關(guān)鍵點即可為你的工業(yè)數(shù)據(jù)接入場景規(guī)劃出穩(wěn)妥的部署架構(gòu)。【免費下載鏈接】TDengineHigh-performance, scalable time-series database designed for Industrial IoT (IIoT) scenarios項目地址: https://gitcode.com/GitHub_Trending/tde/TDengine創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考