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 确保我们甚至可以处理被截断的数据包。