Wireguard 输入插件

此插件使用 wgctrl 库 收集本地 Wireguard 服务器的统计信息。该插件报告 Wireguard 接口设备及其对等节点的仪表盘指标。

引入于： Telegraf v1.14.0 标签： network 操作系统支持： all

全局配置选项

插件支持其他全局和插件配置设置，用于修改指标、标签和字段，创建别名以及配置插件顺序等任务。更多详情请参阅 CONFIGURATION.md。

配置

# Collect Wireguard server interface and peer statistics
[[inputs.wireguard]]
  ## Optional list of Wireguard device/interface names to query.
  ## If omitted, all Wireguard interfaces are queried.
  # devices = ["wg0"]

故障排除

错误：操作不允许

当使用 Wireguard 的内核空间实现（而不是其用户空间实现）时，Telegraf 通过 netlink 与模块通信。这要求 Telegraf 要么以 root 身份运行，要么 Telegraf 二进制文件具有 CAP_NET_ADMIN 能力。

要为此 Telegraf 二进制文件添加此能力（以允许在默认用户 telegraf 下进行此通信）

sudo setcap CAP_NET_ADMIN+epi $(which telegraf)

注意：此能力是二进制文件本身的属性。如果 Telegraf 二进制文件被轮换（例如，通过系统包管理器安装新版本的 Telegraf），则需要重新应用此属性。

错误：枚举 Wireguard 设备时出错

这通常发生在配置文件中指定的设备名称无效时。请确保 sudo wg show 命令成功执行，并且配置文件中的设备名称与该命令打印出的名称匹配。

Metrics

• wireguard_device

  • 标签 (tags)
    • name (接口设备名称，例如 wg0)
    • type (Wireguard 隧道类型，例如 linux_kernel 或 userspace)
  • 字段 (fields)
    • listen_port (整数，接口正在监听的 UDP 端口)
    • firewall_mark (整数，设备的当前防火墙标记)
    • peers (整数，与设备关联的对等点数量)

• wireguard_peer

  • 标签 (tags)
    • device (关联的接口设备名称，例如 wg0)
    • public_key (对等点的公钥，例如 NZTRIrv/ClTcQoNAnChEot+WL7OH7uEGQmx8oAN9rWE=)
  • 字段 (fields)
    • persistent_keepalive_interval_ns (整数，keepalive 间隔（以纳秒为单位）；如果未设置则为 0)
    • protocol_version (整数，Wireguard 协议版本号)
    • allowed_ips (整数，此对等点的允许 IP 数量)
    • last_handshake_time_ns (整数，此对等点最后一次握手的 Unix 时间戳（以纳秒为单位）)
    • rx_bytes (整数，从此对等点接收的字节数)
    • tx_bytes (整数，传输到此对等点的字节数)
    • allowed_peer_cidr (字符串，允许的对等点 CIDR 的逗号分隔列表)

示例输出

wireguard_device,host=WGVPN,name=wg0,type=linux_kernel firewall_mark=51820i,listen_port=58216i 1582513589000000000
wireguard_device,host=WGVPN,name=wg0,type=linux_kernel peers=1i 1582513589000000000
wireguard_peer,device=wg0,host=WGVPN,public_key=NZTRIrv/ClTcQoNAnChEot+WL7OH7uEGQmx8oAN9rWE= allowed_ips=2i,persistent_keepalive_interval_ns=60000000000i,protocol_version=1i,allowed_peer_cidr=192.168.1.0/24,10.0.0.0/8 1582513589000000000
wireguard_peer,device=wg0,host=WGVPN,public_key=NZTRIrv/ClTcQoNAnChEot+WL7OH7uEGQmx8oAN9rWE= last_handshake_time_ns=1582513584530013376i,rx_bytes=6484i,tx_bytes=13540i 1582513589000000000