Fritzbox 输入插件

此插件使用设备 TR-064 接口，从 AVM 设备（路由器、中继器等）收集状态信息。

引入版本: Telegraf v1.35.0 标签: network, iot 操作系统支持: all

全局配置选项

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

配置

# Gather fritzbox status
[[inputs.fritzbox]]
  ## URLs of the devices to query including login credentials
  urls = [ "http://user:password@fritz.box:49000/" ]

  ## The information to collect (see README for further details).
  # collect = [
  #   "device",
  #   "wan",
  #   "ppp",
  #   "dsl",
  #   "wlan",
  # ]

  ## The http timeout to use.
  # timeout = "10s"

  ## Optional TLS Config
  # tls_ca = "/etc/telegraf/ca.pem"
  # tls_cert = "/etc/telegraf/cert.pem"
  # tls_key = "/etc/telegraf/key.pem"
  # tls_key_pwd = "secret"
  ## Use TLS but skip chain & host verification
  # insecure_skip_verify = false

收集选项

以下收集选项可用

device : 收集已配置设备的设备信息，如型号名称、软件版本、运行时间等。将创建 fritzbox_device 指标。

wan : 收集已配置设备的通用 WAN 连接状态，如比特率、传输字节数等。将创建 fritzbox_wan 指标。

ppp : 收集已配置设备的 PPP 连接参数，如比特率、运行时间等。将创建 fritzbox_ppp 指标。

dsl : 收集已配置设备的 DSL 线状态和统计信息。将创建 fritzbox_dsl 指标。

wlan : 收集所有 WLAN 的状态和关联设备数量。将创建 fritzbox_wlan 指标。

hosts : 收集 Mesh 网络的详细信息，包括连接的节点、它们在网络中的角色以及它们的连接带宽。将创建 fritzbox_hosts 指标。

Metrics

默认情况下，字段名直接源自相应的 接口规范。

• fritzbox_device
  • 标签 (tags)
    • source - 设备名称（已从中查询此指标的设备）
    • service - 用于查询此指标的服务 ID
  • 字段 (fields)
    • uptime (uint) - 设备的运行时间（秒）。
    • model_name (string) - 设备的型号名称。
    • serial_number (string) - 设备的序列号。
    • hardware_version (string) - 设备的硬件版本。
    • software_version (string) - 设备的软件版本。
• fritzbox_wan
  • 标签 (tags)
    • source - 设备名称（已从中查询此指标的设备）
    • service - 用于查询此指标的服务 ID
  • 字段 (fields)
    • layer1_upstream_max_bit_rate (uint) - WAN 接口的最大上行链路比特率（比特/秒）
    • layer1_downstream_max_bit_rate (uint) - WAN 接口的最大下行链路比特率（比特/秒）
    • upstream_current_max_speed (uint) - WAN 接口的当前最大上行链路传输速率（字节/秒）
    • downstream_current_max_speed (uint) - WAN 接口的当前最大下行链路数据速率（字节/秒）
    • total_bytes_sent (uint) - 通过 WAN 接口发送的总字节数（字节）
    • total_bytes_received (uint) - 通过 WAN 接口接收的总字节数（字节）
• fritzbox_ppp
  • 标签 (tags)
    • source - 设备名称（已从中查询此指标的设备）
    • service - 用于查询此指标的服务 ID
  • 字段 (fields)
    • uptime (uint) - PPP 连接的运行时间（秒）
    • upstream_max_bit_rate (uint) - 为 PPP 连接协商的最大上行链路比特率（比特/秒）
    • downstream_max_bit_rate (uint) - 为 PPP 连接协商的最大下行链路比特率（比特/秒）
• fritzbox_dsl
  • 标签 (tags)
    • source - 设备名称（已从中查询此指标的设备）
    • service - 用于查询此指标的服务 ID
    • status - DSL 线状态（Up 或 Down）
  • 字段 (fields)
    • upstream_curr_rate (uint) - 当前 DSL 上行链路速率（kbits/秒）
    • downstream_curr_rate (uint) - 当前 DSL 下行链路速率（kbits/秒）
    • upstream_max_rate (uint) - 最大 DSL 上行链路速率（kbits/秒）
    • downstream_max_rate (uint) - 最大 DSL 下行链路速率（kbits/秒）
    • upstream_noise_margin (uint) - 上行链路噪声裕度（db）
    • downstream_noise_margin (uint) - 下行链路噪声裕度（db）
    • upstream_attenuation (uint) - 上行链路衰减（db）
    • downstream_attenuation (uint) - 下行链路衰减（db）
    • upstream_power (uint) - 上行链路功率
    • downstream_power (uint) - 下行链路功率
    • receive_blocks (uint) - 接收的块
    • transmit_blocks (uint) - 传输的块
    • cell_delin (uint) - 单元格分界计数
    • link_retrain (uint) - 链路重训次数
    • init_errors (uint) - 初始化错误
    • init_timeouts (uint) - 初始化超时
    • loss_of_framing (uint) - 帧丢失错误
    • errored_secs (uint) - 连续出错秒数
    • severly_errored_secs (uint) - 连续严重出错秒数
    • fec_errors (uint) - 本地调制解调器前向纠错错误
    • atuc_fec_errors (uint) - 远程 DSLAM 前向纠错错误
    • hec_errors (uint) - 本地调制解调器头部错误控制错误
    • atuc_hec_errors (uint) - 远程 DSLAM 头部错误控制错误
    • crc_errors (uint) - 本地调制解调器循环冗余校验错误
    • atuc_crc_errors (uint) - 远程 DSLAM 循环冗余校验错误
• fritzbox_wlan
  • 标签 (tags)
    • source - 设备名称（已从中查询此指标的设备）
    • service - 用于查询此指标的服务 ID
    • wlan - WLAN 的 SSID（名称）
    • channel - 此 WLAN 使用的频道
    • band - 此 WLAN 使用的频段（MHz）
    • status - WLAN 线状态（Up 或 Down）
  • 字段 (fields)
    • total_associations (uint) - 连接到此 WLAN 的设备数量。
• fritzbox_hosts
  • 标签 (tags)
    • source - 已从中查询此指标的设备名称
    • service - 用于查询此指标的服务 ID
    • node - 连接到 Mesh 网络的节点名称
    • node_role - 节点在网络中的角色（“master”= Mesh 主节点，“slave”= Mesh 从节点，“client”= 客户端）
    • node_ap - 该节点连接到的接入点的名称
    • node_ap_role - 接入点在网络中的角色（“master”= Mesh 主节点，“slave”= Mesh 从节点）
    • link_type - 对等连接的链路类型（“WLAN”或“LAN”）
    • link_name - 连接的链路名称
  • 字段 (fields)
    • max_data_rate_tx (uint) - 连接的最大传输速率（kbits/秒）
    • max_data_rate_rx (uint) - 连接的最大接收速率（kbits/秒）
    • cur_data_rate_tx (uint) - 连接的最大传输速率（kbits/秒）
    • cur_data_rate_rx (uint) - 连接的当前接收速率（kbits/秒）

示例输出

fritzbox_device,service=DeviceInfo1,source=fritz.box uptime=2058438i,model_name="Mock 1234",serial_number="123456789",hardware_version="Mock 1234",software_version="1.02.03" 1737003520174438000

fritzbox_wan,service=WANCommonInterfaceConfig1,source=fritz.box layer1_upstream_max_bit_rate=48816000i,layer1_downstream_max_bit_rate=253247000i,upstream_current_max_speed=511831i,downstream_current_max_speed=1304268i,total_bytes_sent=129497283207i,total_bytes_received=554484531337i 1737003587690504000

fritzbox_ppp,service=WANPPPConnection1,source=fritz.box uptime=369434i,upstream_max_bit_rate=44213433i,downstream_max_bit_rate=68038668i 1737003622308149000

fritzbox_dsl,service=WANDSLInterfaceConfig1,source=fritz.box,status=Up downstream_curr_rate=249065i,downstream_max_rate=249065i,downstream_power=513i,init_timeouts=0i,atuc_crc_errors=13i,errored_secs=25i,atuc_hec_errors=0i,upstream_noise_margin=80i,downstream_noise_margin=60i,downstream_attenuation=140i,receive_blocks=490282831i,transmit_blocks=254577751i,init_errors=0i,crc_errors=53i,fec_errors=0i,hec_errors=0i,upstream_max_rate=48873i,upstream_attenuation=80i,upstream_power=498i,cell_delin=0i,link_retrain=2i,loss_of_framing=0i,upstream_curr_rate=46719i,severly_errored_secs=0i,atuc_fec_errors=0i 1737003645769642000

fritzbox_wlan,band=2400,channel=13,service=WLANConfiguration1,source=fritz.box,ssid=MOCK1234,status=Up total_associations=11i 1737003673561198000

fritzbox_hosts,node=device#17,node_ap=device#1,node_ap_role=master,node_role=slave,link_name=AP:2G:0,link_type=WLAN,service=Hosts1,source=fritz.box cur_data_rate_tx=216000i,cur_data_rate_rx=216000i,max_data_rate_tx=216000i,max_data_rate_rx=216000i 1737003707257394000
fritzbox_hosts,node=device#24,node_ap=device#17,node_ap_role=slave,node_role=client,link_name=LAN:1,link_type=LAN,service=Hosts1,source=fritz.box max_data_rate_tx=1000000i,max_data_rate_rx=1000000i,cur_data_rate_tx=0i,cur_data_rate_rx=0i 1737003707257248000