czerwonk/junos_exporter

junos_exporter

镜像概述和主要用途

junos_exporter是一个针对运行JunOS系统设备的Prometheus指标导出器，通过SSH协议收集设备性能数据。该项目旨在提供一种简洁、高效的监控方案，替代高复杂度的通用SNMP导出器，特别适用于需要快速抓取JunOS设备指标的场景（如网络运维、性能监控）。最初由Freifunk社区成员开发，以解决通用SNMP导出器在性能上的不足，实现对网络设备的高效监控。

重要说明

版本 < 0.7 用户注意事项

0.7版本修复了所有BGP相关指标前缀的拼写错误，使用旧版本的用户需相应更新监控查询语句。

版本 < 0.5 用户注意事项

0.5版本用SSH替代了SNMP，这是一个破坏性变更（指标名称保持不变）。所有SNMP相关参数已移除，用户需查看新的SSH相关参数并更新服务配置。

核心功能和特性

支持的指标

• 接口：传输/接收字节数、错误数、丢包数、速率
• 路由：按路由表和协议统计的路由数量
• 告警：告警计数
• BGP：消息计数、每对等体前缀数、会话状态
• OSPFv2/OSPFv3：邻居数量
• 接口诊断：光信号状态
• ISIS：邻接数量、路由器总数
• NAT：服务NAT的所有可用统计数据
• 环境：温度、风扇和PEM电源统计
• 路由引擎：路由引擎性能统计
• 存储：总块数、可用块数、已用块数及使用率百分比
• 防火墙过滤器：计数器和策略器（需超出只读权限的显式授权）
• L2电路：隧道状态、隧道数量统计
• 接口队列：队列统计数据
• 电源：功耗统计
• LDP：邻居数量、会话数量及会话状态（状态映射：0="不存在"，1="运行中"）

L2电路状态代码说明

0:EI -- 封装无效
1:MM -- MTU不匹配
2:EM -- 封装不匹配
3:CM -- 控制字不匹配
4:VM -- VLAN ID不匹配
5:OL -- 无出标签
6:NC -- 接口封装非CCC/TCC
7:BK -- 备份连接
8:CB -- 接收的信元束大小错误
9:LD -- 本地站点信号关闭
10:RD -- 远程站点信号关闭
11:XX -- 未知
12:NP -- 接口硬件不存在
13:Dn -- 关闭
14:VC-Dn -- 虚拟电路关闭
15:Up -- 运行中
16:CF -- 呼叫接纳控制失败
17:IB -- TDM比特率不兼容
18:TM -- TDM配置错误
19:ST -- 备用连接
20:SP -- 静态伪线
21:RS -- 远程站点备用
22:HS -- 热备用连接

使用场景和适用范围

适用于需要监控运行JunOS系统的Juniper网络设备的场景，尤其适合：

• 替代通用SNMP导出器以提升监控性能
• 网络运维团队监控设备接口流量、路由状态、BGP会话等关键指标
• 需要高效抓取多台JunOS设备指标的大型网络环境（如ISP、企业网络、社区网络）

详细使用方法和配置说明

安装方式

二进制安装

bash
go get -u github.com/czerwonk/junos_exporter

Docker部署

bash
docker run -d --restart unless-stopped \
  -p 9326:9326 \
  -e SSH_KEYFILE=/ssh-keyfile \
  -v /opt/junos_exporter_keyfile:/ssh-keyfile:ro \
  -v /opt/junos_exporter_config.yml:/config.yml:ro \
  czerwonk/junos_exporter

认证方式

支持SSH密钥认证和密码认证：

• 密钥认证：通过-ssh.keyfile=<文件路径>启用，指定私钥文件
• 密码认证：通过-ssh.password=<密码字符串>启用，或在配置文件中设置password: <密码字符串>

认证优先级：SSH密钥 > 命令行密码 > 配置文件密码。未指定有效认证方式时，程序将报错退出。

目标参数

默认情况下，访问/metrics端点时会抓取所有配置的目标。也可通过target参数指定单个目标，例如：http://localhost:9326/metrics?target=1.2.3.4。指定的目标需存在于配置文件或-ssh.targets参数中，或通过-config.ignore-targets标志忽略目标检查。

Prometheus配置示例

yaml
scrape_configs:
  - job_name: 'junos'
    static_configs:
      - targets:
        - 192.168.1.2  # 目标设备
    relabel_configs:
      - source_labels: [__address__]
        target_label: __param_target
      - source_labels: [__param_target]
        target_label: instance
      - target_label: __address__
        replacement: 127.0.0.1:9326  # junos_exporter的地址和端口

配置文件

支持通过YAML配置文件定义目标和特性开关，示例：

yaml
devices:
  - host: router1          # 设备主机名或IP
    key_file: /path/to/key # SSH私钥文件路径
  - host: router2
    username: exporter     # SSH用户名
    password: secret       # SSH密码

features:                  # 启用/禁用指标采集功能
  alarm: true              # 告警指标
  environment: true        # 环境指标（温度、风扇等）
  bgp: true                # BGP指标
  ospf: true               # OSPF指标
  isis: true               # ISIS指标
  nat: true                # NAT指标
  l2circuit: true          # L2电路指标
  ldp: true                # LDP指标
  routes: true             # 路由指标
  routing_engine: true     # 路由引擎指标
  firewall: false          # 防火墙过滤器指标（默认禁用）
  interfaces: true         # 接口指标
  interface_diagnostic: true # 接口诊断指标
  interface_queue: true    # 接口队列指标
  storage: true            # 存储指标
  accounting: true         # 计费指标
  ipsec: true              # IPsec指标
  fpc: true                # FPC指标
  rpki: true               # RPKI指标
  rpm: false               # RPM指标（默认禁用）
  satellite: true          # 卫星指标
  system: true             # 系统指标
  power: true              # 电源指标

动态接口标签

0.9.5版本引入从接口描述中提取动态标签的功能，标签名需满足：

• 不以数字开头
• 仅包含A-Z、a-z、0-9、_
• 自动转为小写
• 不与导出器内置标签冲突

可通过-dynamic-interface-labels=false禁用该功能。

标签提取示例

• 标签标记：描述为XYZ [prod] → 标签prod="1"
• 键值对标记：描述为XYZ [peer=202739] → 标签peer="202739"

Grafana仪表盘

提供示例Grafana仪表盘（grafana_dashboard.json），包含设备/接口选择等变量，可直接导入使用。

第三方组件

使用以下项目组件：

• Prometheus Go客户端库（https://github.com/prometheus/client_golang%EF%BC%89

许可证

MIT许可证（详见LICENSE）

相关链接

• Prometheus：[***]
• JunOS：[***]