tzsp_packetstream_exporter

tzsp_packetstream_exporter

此應用程式匯出有關透過 TZSP 接收的資料包流的指標。目標是測量 IPv4 層級上可見的資料流類型，而無需深入了解資料包詳細資訊。

先決條件

系統需求：

• .NET核心3.1
• TShark（Wireshark 的命令列變體）
  • 在 Ubuntu 上， tshark軟體包就足夠了。
  • 在 Windows 上，安裝完整版本的 Wireshark。
• 運行時暫存檔案目錄中有 2 GB 可用空間。

tshark命令必須在新終端機中可用。您可能需要在 PATH 環境變數中註冊安裝目錄。

該應用程式僅執行資料包流的分析，而不是初始擷取。您需要設定路由器來擷取封包流並將其以 TZSP 格式提供給此應用程式。

MikroTik RouterOS 內建了對 TZSP 封包擷取的支援。您也可以使用sniff-tzsp操作定義 MikroTik 防火牆 mangle 規則，以對捕獲的流量進行詳細過濾。

快速啟動

1. 設定到將運行此應用程式的伺服器的 TZSP 封包流。為流選擇任意埠號，例如 1234。
2. 作為tzsp_packetstream_exporter --interface eth0 --listen-port 1234執行應用程式（有關更多信息，請參閱--help ）。
3. 導航至 http://hostname:9184/metrics 以探索可用的指標。
4. 在 Prometheus 配置中註冊hostname:9184作為抓取目標。
5. 如果使用 Grafana，請安裝範本儀表板。

普羅米修斯抓取配置範例：

  - job_name : ' my_packet_analysis '
    static_configs :
      - targets :
        - hostname:9184

相容性

僅分析 IPv4 封包 - IPv6 被忽略。

如何分析多個並行資料包流？

您可以將多個 TZSP 流定向到同一個分析器，無論是在同一連接埠還是單獨的連接埠上（使用多個--listen-port選項）。輸出指標帶有一個標籤，指示資料到達的偵聽連接埠。

（任何作業系統）為什麼我在啟動時會收到與權限相關的錯誤？

tshark：無法在子進程中執行 /usr/bin/dumpcap：權限被拒絕

運行應用程式的使用者必須擁有使用 TShark 所需的權限。在Linux 上，您可能需要將使用者新增至wireshark群組，具體取決於系統配置。

(Windows) 為什麼我在啟動時收到與權限相關的錯誤？

如果您的使用者無權在指定連接埠上發布結果，則應用程式可能會在 Windows 上引發存取拒絕異常。您可以使用netsh命令授予自己所需的權限：

netsh http add urlacl url=http://+:9184/metrics user=DOMAINuser

這裡需要指定的連接埠號碼是發布端口，預設為9184。

為什麼這個應用程式需要 TShark，為什麼不打開一個套接字並監聽？

TZSP 協定的實作可以在某些情況下截斷資料包，這可能會導致作業系統將它們過濾掉，並且永遠不會將它們交給偵聽應用程式。使用 TShark 確保我們甚至可以處理被截斷的資料包。