czerwonk/bird_exporter

bird_exporter

镜像概述和主要用途

bird_exporter是一个针对bird路由守护进程的指标导出器，专门用于与Prometheus监控系统配合，收集并暴露bird路由协议的关键运行指标，如BGP会话状态、OSPF邻居计数、前缀数量等，帮助管理员监控网络路由状态。

核心功能和特性

• BGP监控：会话状态、导入/导出/过滤前缀计数、路由状态变化
• OSPF监控：邻居数量、接口计数、运行状态、协议运行时间
• 多协议支持：支持BGP、OSPF、Kernel、Static、Device、Direct等协议指标
• 双版本兼容：支持bird 1.x和2.0+版本（2.0+需使用-bird.v2参数）
• 灵活指标格式：提供新旧两种指标格式，新格式更符合Prometheus最佳实践
• 可配置参数：支持自定义socket路径、端口等配置

使用场景和适用范围

适用于运行bird路由守护进程的网络设备（如路由器、网关），需监控路由协议运行状态的场景，尤其适合需要通过Prometheus+Grafana构建网络监控dashboard的环境。

使用方法和配置说明

前置要求

• bird路由守护进程需与bird_exporter安装在同一台机器
• 运行bird_exporter的用户需有权限访问bird的unix socket文件
• bird配置需添加以下内容以获取准确的运行时间信息：

  timeformat protocol     iso long;
  

重要配置说明

bird 2.0+ 用户注意事项

bird 2.0+版本支持在单个守护进程中处理IPv4和IPv6，使用时需：

• 添加-bird.v2参数启用2.0+支持
• 此时将通过同一socket查询IPv4和IPv6，忽略-bird.ipv4、-bird.ipv6和-bird.socket6参数
• IP协议版本由通道信息自动确定

指标格式

• 旧格式（默认）：协议特定指标前缀为协议名，如bgp4_session_prefix_count_import
• 新格式（推荐）：更通用的命名规范，包含协议类型和IP版本标签，如bird_protocol_prefix_import_count{proto="BGP",ip_version="4"}
• 启用新格式：添加-format.new=true参数

默认端口

默认监听端口为9324（自0.7.1版本起变更，原9200端口与Elasticsearch冲突）

Socket路径

默认socket路径：

• bird（IPv4）：/var/run/bird.ctl
• bird6（IPv6）：/var/run/bird6.ctl 可通过参数自定义：
• --bird.socket：指定bird socket路径
• --bird.socket6：指定bird6 socket路径

运行命令示例

bash
# 基本运行（使用默认配置，旧指标格式）
bird_exporter

# 启用新指标格式
bird_exporter -format.new=true

# 针对bird 2.0+版本运行
bird_exporter -bird.v2=true

# 自定义socket路径
bird_exporter -bird.socket=/custom/path/bird.ctl -bird.socket6=/custom/path/bird6.ctl

# 指定监听端口
bird_exporter -web.listen-address=:9090

Grafana仪表盘

可使用社区贡献的BIRD RS Dashboard：

• 地址：[***]
• 截图：!https://github.com/czerwonk/bird_exporter/blob/master/grafana/img/bird_exporter.png

第三方组件

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

许可证

MIT许可证（详见LICENSE）

相关链接

• Prometheus：[***]
• Bird路由守护进程：[***]