絡接口流量、狀態(tài)與告警的完整實現(xiàn))
可觀測性指標監(jiān)控【免費下載鏈接】windows_exporterPrometheus exporter for Windows machines項目地址https://gitcode.com/gh_mirrors/wi/windows_exporter點擊查看免費下載本文圍繞 windows_exporter 的net采集器展開它默認啟用從 Performance Counter 對象Network Interface與 Win32 APIGetAdaptersAddresses兩個數(shù)據(jù)源為每臺 Windows 主機的每個網(wǎng)絡適配器暴露收發(fā)包計數(shù)、錯誤/丟棄計數(shù)、當前帶寬以及 IP 地址與操作狀態(tài)等指標。讀完本文你將掌握nic標簽的命名規(guī)則、--collector.net.nic-include等三個命令行參數(shù)的行為邊界、全部 16 項指標的語義以及用于計算接口利用率、配置高水位告警的 PromQL 寫法并能對照源碼理解采集鏈路PDH 計數(shù)器讀取、適配器地址枚舉、標簽緩存與指標緩存的實現(xiàn)細節(jié)。windows_exporter 網(wǎng)絡監(jiān)控儀表盤一、采集器概覽net采集器用于暴露網(wǎng)絡接口network interface相關的指標其基本信息如下與 docs/collector.net.md 中的定義一致屬性值指標名前綴net完整指標以windows_開頭如windows_net_bytes_received_total數(shù)據(jù)源Performance countersNetwork Interface對象與 Win32 APIGetAdaptersAddresses是否默認啟用是從源碼結(jié)構(gòu)看采集器由 internal/collector/net/net.go 中的Collector實現(xiàn)它內(nèi)部分為兩個子采集器sub collectormetrics通過 PDHPerformance Data Helper讀取Network Interface性能計數(shù)器對象產(chǎn)出流量、包、隊列與帶寬類指標nic_info遍歷GetAdaptersAddresses返回的適配器鏈表產(chǎn)出接口描述、MAC 地址、IP 地址與操作狀態(tài)類指標。這種拆分由--collector.net.enabled參數(shù)控制見下文并在 pkg/collector/config.go 中以Net net.Config字段接入整體配置結(jié)構(gòu)。二、配置參數(shù)Flags--collector.net.nic-include若給定只有接口名匹配該包含正則的適配器其指標才會被上報。默認值.匹配所有非空接口名。--collector.net.nic-exclude若給定接口名不匹配該排除正則的適配器才會被上報。即一個接口必須同時“匹配 include 且不匹配 exclude”才進入輸出。默認值空正則不排除任何接口。--collector.net.enabled逗號分隔的子采集器列表可選取值為metrics、nic_info。默認值metrics,nic_info兩者都啟用。在 internal/collector/net/net.go 的NewWithFlags中可以看到這三個 flag 的注冊與解析邏輯有幾個值得注意的實現(xiàn)細節(jié)正則是全量錨定匹配的。用戶輸入的正則會被包成^(?:%s)$再編譯net.go#L178-L186。這意味著--collector.net.nic-includeIntel并不會匹配所有包含 Intel 的接口而是要求整個接口名恰好等于 Intel要做子串匹配應寫成.*Intel.*。非法子采集器會啟動失敗。Build階段會對CollectorsEnabled做白名單校驗出現(xiàn)未知取值時返回錯誤unknown sub collector: ...net.go#L207-L214這一行為在 internal/collector/lifecycle_test.go 中有對應測試覆蓋。nic_info屬于實驗特性。啟用nic_info時采集器構(gòu)建階段會輸出一條日志提示“nic/addresses collector is in an experimental state”其配置與指標未來可能變化net.go#L324-L328。配置結(jié)構(gòu)體本身定義在 net.go#L48-L62其中NicInclude/NicExclude以*regexp.Regexp形式存儲CollectorsEnabled為字符串切片均可通過命令行 flag 或配置注入。三、接口命名規(guī)則nic標簽這是使用 include/exclude 正則之前必須先理解的一點原文檔說明如下nic標簽的值是適配器在Network Interface性能計數(shù)器對象中的實例名。它由適配器的 Description 字符串轉(zhuǎn)換而來(與)替換為[與]#、/與\替換為_。例如轉(zhuǎn)換后可能得到Intel[R] PRO_1000 MT Network Connection _2。include 與 exclude 表達式匹配的就是這個轉(zhuǎn)換后的名字而不是設備管理器里看到的原始描述。這一規(guī)則在源碼中由一個固定的替換器實現(xiàn)internal/collector/net/net.go#L64-L68var nicNameReplacer strings.NewReplacer((, [, ), ], #, _, /, _, \\, _)collectNICInfo中對每個適配器執(zhí)行nicNameReplacer.Replace(...Description)net.go#L480保證性能計數(shù)器路徑與GetAdaptersAddresses路徑產(chǎn)生一致的nic值。另外windows_net_nic_info的mac標簽對于沒有物理地址的適配器如 loopback為空字符串。從源碼看formatPhysicalAddress 按PhysicalAddressLength截取物理地址字節(jié)以冒號分隔的大寫十六進制輸出長度為 0 時直接返回空串。四、指標全表下表完整繼承自 docs/collector.net.md并在“對應計數(shù)器”一列補充了源碼中 internal/collector/net/types.go#L39-L55perfDataCounterValues結(jié)構(gòu)體的perfdata標簽所聲明的Network Interface計數(shù)器名稱指標名描述類型標簽對應計數(shù)器perfdata 標簽windows_net_bytes_received_total接口接收的總字節(jié)數(shù)counternicBytes Received/secwindows_net_bytes_sent_total接口發(fā)送的總字節(jié)數(shù)counternicBytes Sent/secwindows_net_bytes_total接口收發(fā)合計的總字節(jié)數(shù)counternicBytes Total/secwindows_net_output_queue_length_packets輸出隊列長度以包計。超過 2 即可能出現(xiàn)延遲gaugenicOutput Queue Lengthwindows_net_packets_outbound_discarded_total未檢測到錯誤卻被丟棄的出站包總數(shù)counternicPackets Outbound Discardedwindows_net_packets_outbound_errors_total因錯誤而無法發(fā)送的包總數(shù)counternicPackets Outbound Errorswindows_net_packets_received_discarded_total未檢測到錯誤卻被丟棄的入站包總數(shù)counternicPackets Received Discardedwindows_net_packets_received_errors_total因錯誤而無法接收的包總數(shù)counternicPackets Received Errorswindows_net_packets_received_total接口接收的總包數(shù)counternicPackets Received/secwindows_net_packets_received_unknown_total因未知或不支持協(xié)議而被丟棄的入站包總數(shù)counternicPackets Received Unknownwindows_net_packets_total接口收發(fā)合計的總包數(shù)counternicPackets/secwindows_net_packets_sent_total接口發(fā)送的總包數(shù)counternicPackets Sent/secwindows_net_current_bandwidth_bytes接口當前帶寬的估計值字節(jié)/秒gaugenicCurrent Bandwidthwindows_net_nic_address_info常量值 1標簽攜帶接口地址信息gaugenic,address,family—GetAdaptersAddresseswindows_net_nic_info常量值 1標簽攜帶接口基本信息gaugenic,friendly_name,mac—GetAdaptersAddresseswindows_net_nic_operation_status按 RFC 2863 的 IfOperStatus 定義的接口操作狀態(tài)gaugenic,status—GetAdaptersAddresses關于計數(shù)器類型有一點容易被計數(shù)器名誤導雖然 PDH 側(cè)計數(shù)器叫 Bytes Received/sec 等每秒速率名采集器卻以pdh.CounterTypeRaw方式讀取net.go#L319-L322即以 Raw 100NS 計數(shù)器暴露為累計值counter 類型因此查詢速率時必須用rate()或increase()。windows_net_current_bandwidth_bytes有一個單位換算細節(jié)Current Bandwidth計數(shù)器原始值單位是bit/秒源碼中除以 8 后再上報為 byte/秒net.go#L452-L457這正是文檔將其描述為“字節(jié)/秒”的原因。windows_net_nic_operation_status的status標簽取值映射定義在 internal/collector/net/types.go#L28-L36與 RFC 2863 一致up、down、testing、unknown、dormant、not present、lower layer down。實現(xiàn)上對每個取值都輸出一條 series當前狀態(tài)對應的取值為 1其余為 0net.go#L558-L571這樣可以直接用windows_net_nic_operation_status{statusup} 1判斷鏈路是否可用。windows_net_nic_address_info的family標簽取值為ipv4/ipv6由 types.go#L24-L27 的映射表給出。五、采集鏈路實現(xiàn)剖析5.1 性能計數(shù)器路徑metrics子采集器metrics子采集器在Build階段創(chuàng)建一個泛型 PDH 采集器c.perfDataCollector, err pdh.NewCollectorperfDataCounterValues), pdh.CounterTypeRaw, Network Interface, pdh.InstancesAll)net.go#L319-L322它訂閱Network Interface對象的全部實例pdh.InstancesAll每次 scrape 時collect依次執(zhí)行讀取計數(shù)器值 → 按 include/exclude 正則過濾實例名 → 通過labelcache的 scrape 上下文批量生成 const metricnet.go#L353-L461。其中過濾邏輯為“排除匹配 或 包含不匹配 即跳過”net.go#L362-L365與第二節(jié)描述的語義一致。labelcache的作用是復用同一 scrape 內(nèi)相同的標簽組合降低重復創(chuàng)建標簽對的開銷這一緩存機制在 internal/labelcache 中實現(xiàn)并有配套測試。5.2GetAdaptersAddresses路徑nic_info子采集器collectNICInfonet.go#L463-L514的核心流程帶緩沖復用的系統(tǒng)調(diào)用。adapterAddresses函數(shù)net.go#L642-L667調(diào)用windows.GetAdaptersAddressesflags 為GAA_FLAG_SKIP_MULTICAST | GAA_FLAG_SKIP_DNS_SERVER即跳過組播地址與 DNS 服務器地址首次調(diào)用以推薦的 15000 字節(jié)為初始緩沖遇到ERROR_BUFFER_OVERFLOW時按系統(tǒng)要求的長度重試。緩沖在Collector結(jié)構(gòu)體中跨 scrape 復用adapterAddressesBuf字段既避免重復分配也為下一次調(diào)用提供了尺寸提示。逐適配器過濾與取值。遍歷鏈表時對Description做nicNameReplacer轉(zhuǎn)換并與計數(shù)器路徑共用同一套 include/exclude 過濾friendly_name取FriendlyName字段原文mac由formatPhysicalAddress格式化。僅當接口 Up 時收集地址。只有OperStatus IfOperStatusUp的適配器才會枚舉FirstUnicastAddress與FirstAnycastAddress鏈表且只保留全局單播global unicast地址鏈路本地地址如 IPv6 的fe80::會被IsGlobalUnicast()過濾掉net.go#L516-L542、net.go#L577-L609。指標級緩存。nicMetricCache會對“自上次 scrape 以來信息未變化的適配器”直接復用上一輪構(gòu)建好的nic_info、nic_operation_status與nic_address_info指標對象緩存鍵之外還比較nicValuesfriendly_name、MAC、operStatus 及編碼后的地址串任一變化都會觸發(fā)重建net.go#L104-L122、net.go#L502-L508。源碼注釋明確指出地址查詢每次 scrape 仍會執(zhí)行緩存省的是對象分配而非系統(tǒng)調(diào)用。測試方面internal/collector/net/net_test.go 使用testutils.TestCollector對默認配置做通用采集器測試internal/collector/net/net_internal_test.go 與 internal/collector/net/net_bench_test.go 分別補充包內(nèi)測試與基準測試。六、PromQL 示例與實用查詢查詢發(fā)送流量速率rate(windows_net_bytes_sent_total{instancelocalhost}[2m])計算接口利用率百分比以文檔中的 Hyper-V 適配器為例rate(windows_net_bytes_total{instancelocalhost, nicMicrosoft Hyper-V Network Adapter _2}[2m]) / windows_net_current_bandwidth_bytes{instancelocalhost, nicMicrosoft Hyper-V Network Adapter _2} * 100注意windows_net_current_bandwidth_bytes是“估計值”某些虛擬或無速率上報能力的適配器該值為 0 或長期不變倉庫自帶儀表盤在計算利用率時因此使用了 0守衛(wèi)例如 contrib/mixin/dashboards/network.libsonnet 中的rate(windows_net_bytes_total{job~$job, instance$instance, nic~$nic}[$__rate_interval]) / (windows_net_current_bandwidth_bytes{job~$job, instance$instance, nic~$nic} 0)即“沒有上報鏈路速率的接口不顯示”。同一文件還給出了吞吐、錯誤/丟棄包等面板的現(xiàn)成查詢編譯產(chǎn)物可直接查看 dashboard/windows-exporter-network.json。艦隊Fleet級預計算規(guī)則如果管理大量主機倉庫的 mixin 提供了 net 相關 record 規(guī)則定義在 contrib/mixin/rules/rules.libsonnet包括windows:net_received_bytes:rate/windows:net_sent_bytes:rate按 nic 選擇器對windows_net_bytes_*_total做rate預計算windows:net_received_utilization:ratio/windows:net_sent_utilization:ratio收發(fā)方向各自的利用率windows:net_received_errors:rate、windows:net_received_discarded:rate、windows:net_outbound_errors:rate、windows:net_outbound_discarded:rate四類異常包速率供告警與 Top-N 面板復用。這些指標也驅(qū)動了 fleet 儀表盤的“Top 25 發(fā)送/接收主機”“利用率最高主機”“異常包最多主機”等面板contrib/mixin/dashboards/fleet.libsonnet并配套了規(guī)則與告警的測試用例contrib/mixin/tests/rules.test.yaml、contrib/mixin/tests/alerts.test.yaml 中以nicEthernet的windows_net_packets_*_errors_total序列為輸入。七、告警配置示例原文檔給出的告警示例可直接用于 Prometheus 的prometheus.rules- alert: NetInterfaceUsage expr: rate(windows_net_bytes_total[2m]) / windows_net_current_bandwidth_bytes * 100 95 for: 10m labels: severity: high annotations: summary: Network Interface Usage (instance {{ $labels.instance }}) description: Network traffic usage is greater than 95% for interface {{ $labels.nic }}\n VALUE {{ $value }}\n LABELS: {{ $labels }}使用提示表達式對每臺主機、每個nic標簽序列獨立求值{{ $labels.nic }}可直接定位告警接口windows_net_current_bandwidth_bytes為 0 的接口會產(chǎn)生Inf若環(huán)境中存在此類接口建議像 mixin 那樣加 0守衛(wèi)或改用windows_net_output_queue_length_packets、錯誤包速率等指標做輔助告警結(jié)合第四節(jié)的狀態(tài)指標可以進一步用windows_net_nic_operation_status{statusdown} 1表達“鏈路中斷”類告警此寫法為基于指標語義的建議倉庫內(nèi)未提供對應現(xiàn)成規(guī)則。八、已知限制不采集路由信息。原文檔明確說明Route information is not collected此前文檔中列出的windows_net_route_info指標實際上從未被上報現(xiàn)已從支持的指標列表中移除。nic_info子采集器含windows_net_nic_address_info目前處于實驗狀態(tài)啟動時會有相應日志提示其配置與指標在未來版本可能變化。windows_net_current_bandwidth_bytes是接口當前帶寬的估計值來源于性能計數(shù)器Current Bandwidthbit/秒源碼中已換算為 byte/秒并非精確值。九、延伸閱讀文檔原文docs/collector.net.md核心實現(xiàn)internal/collector/net/net.go、internal/collector/net/types.go測試internal/collector/net/net_test.go、internal/collector/lifecycle_test.go配置接入pkg/collector/config.goPDH 采集框架internal/pdh儀表盤源與產(chǎn)物contrib/mixin/dashboards/network.libsonnet、dashboard/windows-exporter-network.json網(wǎng)絡運行手冊docs/runbooks/windowsnetworkerrors.md、docs/runbooks/windowsnetworkdiscards.md贊分享可觀測性指標監(jiān)控【免費下載鏈接】windows_exporterPrometheus exporter for Windows machines項目地址https://gitcode.com/gh_mirrors/wi/windows_exporter點擊查看免費下載相關推薦windows_exporter license collector 詳解監(jiān)控 Windows 授權狀態(tài)的指標、告警與 slc.dll 實現(xiàn)原理windows_exporter license collector 詳解監(jiān)控 Windows 授權狀態(tài)的指標、告警與 slc.dll 實現(xiàn)原理 本文圍繞 w可觀測性指標監(jiān)控windows_exporter 的 cpu 采集器詳解基于 Windows 性能計數(shù)器的 CPU 監(jiān)控指標、PromQL 查詢與告警實踐windows_exporter 的 cpu 采集器詳解基于 Windows 性能計數(shù)器的 CPU 監(jiān)控指標、PromQL 查詢與告警實踐 本文圍繞 wind可觀測性指標監(jiān)控windows_exporter memory collector 深度解析Windows 內(nèi)存指標采集原理、完整指標清單與監(jiān)控告警實踐windows_exporter memory collector 深度解析Windows 內(nèi)存指標采集原理、完整指標清單與監(jiān)控告警實踐 本篇以 window可觀測性指標監(jiān)控創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考 windows_exporter net 采集器詳解：Windows 網(wǎng)絡接口流量、狀態(tài)與告警的完整實現(xiàn)
可觀測性指標監(jiān)控【免費下載鏈接】windows_exporterPrometheus exporter for Windows machines項目地址https://gitcode.com/gh_mirrors/wi/windows_exporter點擊查看免費下載本文圍繞 windows_exporter 的net采集器展開它默認啟用從 Performance Counter 對象Network Interface與 Win32 APIGetAdaptersAddresses兩個數(shù)據(jù)源為每臺 Windows 主機的每個網(wǎng)絡適配器暴露收發(fā)包計數(shù)、錯誤/丟棄計數(shù)、當前帶寬以及 IP 地址與操作狀態(tài)等指標。讀完本文你將掌握nic標簽的命名規(guī)則、--collector.net.nic-include等三個命令行參數(shù)的行為邊界、全部 16 項指標的語義以及用于計算接口利用率、配置高水位告警的 PromQL 寫法并能對照源碼理解采集鏈路PDH 計數(shù)器讀取、適配器地址枚舉、標簽緩存與指標緩存的實現(xiàn)細節(jié)。windows_exporter 網(wǎng)絡監(jiān)控儀表盤一、采集器概覽net采集器用于暴露網(wǎng)絡接口network interface相關的指標其基本信息如下與 docs/collector.net.md 中的定義一致屬性值指標名前綴net完整指標以windows_開頭如windows_net_bytes_received_total數(shù)據(jù)源Performance countersNetwork Interface對象與 Win32 APIGetAdaptersAddresses是否默認啟用是從源碼結(jié)構(gòu)看采集器由 internal/collector/net/net.go 中的Collector實現(xiàn)它內(nèi)部分為兩個子采集器sub collectormetrics通過 PDHPerformance Data Helper讀取Network Interface性能計數(shù)器對象產(chǎn)出流量、包、隊列與帶寬類指標nic_info遍歷GetAdaptersAddresses返回的適配器鏈表產(chǎn)出接口描述、MAC 地址、IP 地址與操作狀態(tài)類指標。這種拆分由--collector.net.enabled參數(shù)控制見下文并在 pkg/collector/config.go 中以Net net.Config字段接入整體配置結(jié)構(gòu)。二、配置參數(shù)Flags--collector.net.nic-include若給定只有接口名匹配該包含正則的適配器其指標才會被上報。默認值.匹配所有非空接口名。--collector.net.nic-exclude若給定接口名不匹配該排除正則的適配器才會被上報。即一個接口必須同時“匹配 include 且不匹配 exclude”才進入輸出。默認值空正則不排除任何接口。--collector.net.enabled逗號分隔的子采集器列表可選取值為metrics、nic_info。默認值metrics,nic_info兩者都啟用。在 internal/collector/net/net.go 的NewWithFlags中可以看到這三個 flag 的注冊與解析邏輯有幾個值得注意的實現(xiàn)細節(jié)正則是全量錨定匹配的。用戶輸入的正則會被包成^(?:%s)$再編譯net.go#L178-L186。這意味著--collector.net.nic-includeIntel并不會匹配所有包含 Intel 的接口而是要求整個接口名恰好等于 Intel要做子串匹配應寫成.*Intel.*。非法子采集器會啟動失敗。Build階段會對CollectorsEnabled做白名單校驗出現(xiàn)未知取值時返回錯誤unknown sub collector: ...net.go#L207-L214這一行為在 internal/collector/lifecycle_test.go 中有對應測試覆蓋。nic_info屬于實驗特性。啟用nic_info時采集器構(gòu)建階段會輸出一條日志提示“nic/addresses collector is in an experimental state”其配置與指標未來可能變化net.go#L324-L328。配置結(jié)構(gòu)體本身定義在 net.go#L48-L62其中NicInclude/NicExclude以*regexp.Regexp形式存儲CollectorsEnabled為字符串切片均可通過命令行 flag 或配置注入。三、接口命名規(guī)則nic標簽這是使用 include/exclude 正則之前必須先理解的一點原文檔說明如下nic標簽的值是適配器在Network Interface性能計數(shù)器對象中的實例名。它由適配器的 Description 字符串轉(zhuǎn)換而來(與)替換為[與]#、/與\替換為_。例如轉(zhuǎn)換后可能得到Intel[R] PRO_1000 MT Network Connection _2。include 與 exclude 表達式匹配的就是這個轉(zhuǎn)換后的名字而不是設備管理器里看到的原始描述。這一規(guī)則在源碼中由一個固定的替換器實現(xiàn)internal/collector/net/net.go#L64-L68var nicNameReplacer strings.NewReplacer((, [, ), ], #, _, /, _, \\, _)collectNICInfo中對每個適配器執(zhí)行nicNameReplacer.Replace(...Description)net.go#L480保證性能計數(shù)器路徑與GetAdaptersAddresses路徑產(chǎn)生一致的nic值。另外windows_net_nic_info的mac標簽對于沒有物理地址的適配器如 loopback為空字符串。從源碼看formatPhysicalAddress 按PhysicalAddressLength截取物理地址字節(jié)以冒號分隔的大寫十六進制輸出長度為 0 時直接返回空串。四、指標全表下表完整繼承自 docs/collector.net.md并在“對應計數(shù)器”一列補充了源碼中 internal/collector/net/types.go#L39-L55perfDataCounterValues結(jié)構(gòu)體的perfdata標簽所聲明的Network Interface計數(shù)器名稱指標名描述類型標簽對應計數(shù)器perfdata 標簽windows_net_bytes_received_total接口接收的總字節(jié)數(shù)counternicBytes Received/secwindows_net_bytes_sent_total接口發(fā)送的總字節(jié)數(shù)counternicBytes Sent/secwindows_net_bytes_total接口收發(fā)合計的總字節(jié)數(shù)counternicBytes Total/secwindows_net_output_queue_length_packets輸出隊列長度以包計。超過 2 即可能出現(xiàn)延遲gaugenicOutput Queue Lengthwindows_net_packets_outbound_discarded_total未檢測到錯誤卻被丟棄的出站包總數(shù)counternicPackets Outbound Discardedwindows_net_packets_outbound_errors_total因錯誤而無法發(fā)送的包總數(shù)counternicPackets Outbound Errorswindows_net_packets_received_discarded_total未檢測到錯誤卻被丟棄的入站包總數(shù)counternicPackets Received Discardedwindows_net_packets_received_errors_total因錯誤而無法接收的包總數(shù)counternicPackets Received Errorswindows_net_packets_received_total接口接收的總包數(shù)counternicPackets Received/secwindows_net_packets_received_unknown_total因未知或不支持協(xié)議而被丟棄的入站包總數(shù)counternicPackets Received Unknownwindows_net_packets_total接口收發(fā)合計的總包數(shù)counternicPackets/secwindows_net_packets_sent_total接口發(fā)送的總包數(shù)counternicPackets Sent/secwindows_net_current_bandwidth_bytes接口當前帶寬的估計值字節(jié)/秒gaugenicCurrent Bandwidthwindows_net_nic_address_info常量值 1標簽攜帶接口地址信息gaugenic,address,family—GetAdaptersAddresseswindows_net_nic_info常量值 1標簽攜帶接口基本信息gaugenic,friendly_name,mac—GetAdaptersAddresseswindows_net_nic_operation_status按 RFC 2863 的 IfOperStatus 定義的接口操作狀態(tài)gaugenic,status—GetAdaptersAddresses關于計數(shù)器類型有一點容易被計數(shù)器名誤導雖然 PDH 側(cè)計數(shù)器叫 Bytes Received/sec 等每秒速率名采集器卻以pdh.CounterTypeRaw方式讀取net.go#L319-L322即以 Raw 100NS 計數(shù)器暴露為累計值counter 類型因此查詢速率時必須用rate()或increase()。windows_net_current_bandwidth_bytes有一個單位換算細節(jié)Current Bandwidth計數(shù)器原始值單位是bit/秒源碼中除以 8 后再上報為 byte/秒net.go#L452-L457這正是文檔將其描述為“字節(jié)/秒”的原因。windows_net_nic_operation_status的status標簽取值映射定義在 internal/collector/net/types.go#L28-L36與 RFC 2863 一致up、down、testing、unknown、dormant、not present、lower layer down。實現(xiàn)上對每個取值都輸出一條 series當前狀態(tài)對應的取值為 1其余為 0net.go#L558-L571這樣可以直接用windows_net_nic_operation_status{statusup} 1判斷鏈路是否可用。windows_net_nic_address_info的family標簽取值為ipv4/ipv6由 types.go#L24-L27 的映射表給出。五、采集鏈路實現(xiàn)剖析5.1 性能計數(shù)器路徑metrics子采集器metrics子采集器在Build階段創(chuàng)建一個泛型 PDH 采集器c.perfDataCollector, err pdh.NewCollectorperfDataCounterValues), pdh.CounterTypeRaw, Network Interface, pdh.InstancesAll)net.go#L319-L322它訂閱Network Interface對象的全部實例pdh.InstancesAll每次 scrape 時collect依次執(zhí)行讀取計數(shù)器值 → 按 include/exclude 正則過濾實例名 → 通過labelcache的 scrape 上下文批量生成 const metricnet.go#L353-L461。其中過濾邏輯為“排除匹配 或 包含不匹配 即跳過”net.go#L362-L365與第二節(jié)描述的語義一致。labelcache的作用是復用同一 scrape 內(nèi)相同的標簽組合降低重復創(chuàng)建標簽對的開銷這一緩存機制在 internal/labelcache 中實現(xiàn)并有配套測試。5.2GetAdaptersAddresses路徑nic_info子采集器collectNICInfonet.go#L463-L514的核心流程帶緩沖復用的系統(tǒng)調(diào)用。adapterAddresses函數(shù)net.go#L642-L667調(diào)用windows.GetAdaptersAddressesflags 為GAA_FLAG_SKIP_MULTICAST | GAA_FLAG_SKIP_DNS_SERVER即跳過組播地址與 DNS 服務器地址首次調(diào)用以推薦的 15000 字節(jié)為初始緩沖遇到ERROR_BUFFER_OVERFLOW時按系統(tǒng)要求的長度重試。緩沖在Collector結(jié)構(gòu)體中跨 scrape 復用adapterAddressesBuf字段既避免重復分配也為下一次調(diào)用提供了尺寸提示。逐適配器過濾與取值。遍歷鏈表時對Description做nicNameReplacer轉(zhuǎn)換并與計數(shù)器路徑共用同一套 include/exclude 過濾friendly_name取FriendlyName字段原文mac由formatPhysicalAddress格式化。僅當接口 Up 時收集地址。只有OperStatus IfOperStatusUp的適配器才會枚舉FirstUnicastAddress與FirstAnycastAddress鏈表且只保留全局單播global unicast地址鏈路本地地址如 IPv6 的fe80::會被IsGlobalUnicast()過濾掉net.go#L516-L542、net.go#L577-L609。指標級緩存。nicMetricCache會對“自上次 scrape 以來信息未變化的適配器”直接復用上一輪構(gòu)建好的nic_info、nic_operation_status與nic_address_info指標對象緩存鍵之外還比較nicValuesfriendly_name、MAC、operStatus 及編碼后的地址串任一變化都會觸發(fā)重建net.go#L104-L122、net.go#L502-L508。源碼注釋明確指出地址查詢每次 scrape 仍會執(zhí)行緩存省的是對象分配而非系統(tǒng)調(diào)用。測試方面internal/collector/net/net_test.go 使用testutils.TestCollector對默認配置做通用采集器測試internal/collector/net/net_internal_test.go 與 internal/collector/net/net_bench_test.go 分別補充包內(nèi)測試與基準測試。六、PromQL 示例與實用查詢查詢發(fā)送流量速率rate(windows_net_bytes_sent_total{instancelocalhost}[2m])計算接口利用率百分比以文檔中的 Hyper-V 適配器為例rate(windows_net_bytes_total{instancelocalhost, nicMicrosoft Hyper-V Network Adapter _2}[2m]) / windows_net_current_bandwidth_bytes{instancelocalhost, nicMicrosoft Hyper-V Network Adapter _2} * 100注意windows_net_current_bandwidth_bytes是“估計值”某些虛擬或無速率上報能力的適配器該值為 0 或長期不變倉庫自帶儀表盤在計算利用率時因此使用了 0守衛(wèi)例如 contrib/mixin/dashboards/network.libsonnet 中的rate(windows_net_bytes_total{job~$job, instance$instance, nic~$nic}[$__rate_interval]) / (windows_net_current_bandwidth_bytes{job~$job, instance$instance, nic~$nic} 0)即“沒有上報鏈路速率的接口不顯示”。同一文件還給出了吞吐、錯誤/丟棄包等面板的現(xiàn)成查詢編譯產(chǎn)物可直接查看 dashboard/windows-exporter-network.json。艦隊Fleet級預計算規(guī)則如果管理大量主機倉庫的 mixin 提供了 net 相關 record 規(guī)則定義在 contrib/mixin/rules/rules.libsonnet包括windows:net_received_bytes:rate/windows:net_sent_bytes:rate按 nic 選擇器對windows_net_bytes_*_total做rate預計算windows:net_received_utilization:ratio/windows:net_sent_utilization:ratio收發(fā)方向各自的利用率windows:net_received_errors:rate、windows:net_received_discarded:rate、windows:net_outbound_errors:rate、windows:net_outbound_discarded:rate四類異常包速率供告警與 Top-N 面板復用。這些指標也驅(qū)動了 fleet 儀表盤的“Top 25 發(fā)送/接收主機”“利用率最高主機”“異常包最多主機”等面板contrib/mixin/dashboards/fleet.libsonnet并配套了規(guī)則與告警的測試用例contrib/mixin/tests/rules.test.yaml、contrib/mixin/tests/alerts.test.yaml 中以nicEthernet的windows_net_packets_*_errors_total序列為輸入。七、告警配置示例原文檔給出的告警示例可直接用于 Prometheus 的prometheus.rules- alert: NetInterfaceUsage expr: rate(windows_net_bytes_total[2m]) / windows_net_current_bandwidth_bytes * 100 95 for: 10m labels: severity: high annotations: summary: Network Interface Usage (instance {{ $labels.instance }}) description: Network traffic usage is greater than 95% for interface {{ $labels.nic }}\n VALUE {{ $value }}\n LABELS: {{ $labels }}使用提示表達式對每臺主機、每個nic標簽序列獨立求值{{ $labels.nic }}可直接定位告警接口windows_net_current_bandwidth_bytes為 0 的接口會產(chǎn)生Inf若環(huán)境中存在此類接口建議像 mixin 那樣加 0守衛(wèi)或改用windows_net_output_queue_length_packets、錯誤包速率等指標做輔助告警結(jié)合第四節(jié)的狀態(tài)指標可以進一步用windows_net_nic_operation_status{statusdown} 1表達“鏈路中斷”類告警此寫法為基于指標語義的建議倉庫內(nèi)未提供對應現(xiàn)成規(guī)則。八、已知限制不采集路由信息。原文檔明確說明Route information is not collected此前文檔中列出的windows_net_route_info指標實際上從未被上報現(xiàn)已從支持的指標列表中移除。nic_info子采集器含windows_net_nic_address_info目前處于實驗狀態(tài)啟動時會有相應日志提示其配置與指標在未來版本可能變化。windows_net_current_bandwidth_bytes是接口當前帶寬的估計值來源于性能計數(shù)器Current Bandwidthbit/秒源碼中已換算為 byte/秒并非精確值。九、延伸閱讀文檔原文docs/collector.net.md核心實現(xiàn)internal/collector/net/net.go、internal/collector/net/types.go測試internal/collector/net/net_test.go、internal/collector/lifecycle_test.go配置接入pkg/collector/config.goPDH 采集框架internal/pdh儀表盤源與產(chǎn)物contrib/mixin/dashboards/network.libsonnet、dashboard/windows-exporter-network.json網(wǎng)絡運行手冊docs/runbooks/windowsnetworkerrors.md、docs/runbooks/windowsnetworkdiscards.md贊分享可觀測性指標監(jiān)控【免費下載鏈接】windows_exporterPrometheus exporter for Windows machines項目地址https://gitcode.com/gh_mirrors/wi/windows_exporter點擊查看免費下載相關推薦windows_exporter license collector 詳解監(jiān)控 Windows 授權狀態(tài)的指標、告警與 slc.dll 實現(xiàn)原理windows_exporter license collector 詳解監(jiān)控 Windows 授權狀態(tài)的指標、告警與 slc.dll 實現(xiàn)原理 本文圍繞 w可觀測性指標監(jiān)控windows_exporter 的 cpu 采集器詳解基于 Windows 性能計數(shù)器的 CPU 監(jiān)控指標、PromQL 查詢與告警實踐windows_exporter 的 cpu 采集器詳解基于 Windows 性能計數(shù)器的 CPU 監(jiān)控指標、PromQL 查詢與告警實踐 本文圍繞 wind可觀測性指標監(jiān)控windows_exporter memory collector 深度解析Windows 內(nèi)存指標采集原理、完整指標清單與監(jiān)控告警實踐windows_exporter memory collector 深度解析Windows 內(nèi)存指標采集原理、完整指標清單與監(jiān)控告警實踐 本篇以 window可觀測性指標監(jiān)控創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考