◾️ BBxPing 面板 - 在 Grafana 上点亮地球 / Blackbox Exporter & Prometheus

Bene说道：

安装方式

1️⃣ Grafana & Prometheus

Node Information 发布页已提及，故不赘述。

2️⃣ Blackbox Exporter

可以参考以下两种方式：

官方 Docker

docker run --rm \
  -p 9115/tcp \
  --name blackbox_exporter \
  -v $(pwd):/config \
  quay.io/prometheus/blackbox-exporter:latest --config.file=/config/blackbox.yml

@midori 制作的二进制安装脚本

bash <(curl -sSLf "https://raw.githubusercontent.com/midori01/common-scripts/main/blackbox-exporter/install.sh")

⭐️ Label 标签系统介绍

必填 - 不可自定义

ip: 可选 IPv4 / IPv6

code: 应填入目标 IP 所在地的城市代码或机场代码 (如 LAX)，如果 code 的机场代码有被收录进 Grafana 的机场列表中，目标 IP 会在地图上展示

Anycast 目标 IP 的话，应当在 code 填入 ANYCAST (唯一写法)

应填 - 可自定义

name: 将在 DESTINATION 折线图 和 PACKET LOSS RATE 柱状图 中展示目标名称
city: 将在顶栏选取框中出现相应城市名称选项 (如 Los Angeles)，以及其他 Panel 的名称提及
isp: 将在顶栏选取框中出现相应运营商名称选项 (如 China Mobile)，以及其他 Panel 的名称提及

选填 - 不可自定义

domestic: 目前只有 true，填入你本国 IP的 label 里，暂时用来排除本国线路以获得"总体国际线路延迟"结果

Prometheus 配置示例

与 Node Exporter 不同，Blackbox Exporter 需要在主控机器为每个分机建立一个 job 来管理配置。目前也有在一个 job 里面管理所有机器的方法，但不一定适用于多测试点的面板，感兴趣可以尝试。本帖将只提及传统的配置方式。

1️⃣ /etc/prometheus/prometheus.yml

有多少台机器就加入多少个 job

  - job_name: "Instance 1"
    metrics_path: '/probe'
    params:
      module: [icmp]
    file_sd_configs:
      - files:
        - '/etc/prometheus/blackbox/*.yml'
    relabel_configs:
        - source_labels: [__address__]
          target_label: __param_target
        - source_labels: [__param_target]
          target_label: instance
        - target_label: __address__
          replacement: localhost:9115 # 机器 IP:9115(blackbox 默认端口，需在每台分机为主控地址开放此端口)

1. 使用 file_sd_configs 来动态加载配置，不仅不再需要为每个 job 配置冗长的 IP 列表，还实现了无需重启 Prometheus 便更新测试 IP 列表
2. file_sd_configs 需自己新建，此处以 /etc/prometheus/blackbox/*.yml 为例，支持借助通配符加载多个文件
3. file_sd_configs 支持 json 格式，本文以 yaml 格式举例

技巧

不支持 IPv6 的机器可以在 relabel_configs 下面加上

        - source_labels: [ip]
          regex: 'IPv6'
          action: drop

意味着不再 ping 带有 IPv6 标签的目标
也可以通过这个方式进行更精细的筛选，高度自定义

2️⃣ /etc/prometheus/blackbox/example.yml

本国 IP

    - targets:
        - v4.EXAMPLE-pek.com # 或 IPv4 IP
      labels:
        name: 'PEK | China Mobile'
        code: 'PEK'
        city: 'Beijing'
        isp: 'China Mobile'
        ip: 'IPv4'
        domestic: 'true'

    - targets:
        - v6.EXAMPLE-pek.com # 或 IPv6 IP
      labels:
        name: 'PEK | China Mobile'
        code: 'PEK'
        city: 'Beijing'
        isp: 'China Mobile'
        ip: 'IPv6'
        domestic: 'true'

VPS IP

    - targets:
        - v4.EXAMPLE-vps.com
      labels:
        name: 'LAX | DMIT Pro'
        code: 'LAX'
        city: 'Los Angeles'
        ip: 'IPv4'

    - targets:
        - v6.EXAMPLE-vps.com
      labels:
        name: 'LAX | DMIT Pro'
        code: 'LAX'
        city: 'Los Angeles'
        ip: 'IPv6'

Anycast IP

    - targets:
        - 8.8.8.8
      labels:
        name: 'GOOGLE'
        code: 'ANYCAST'
        ip: 'IPv4'

    - targets:
        - 2001:4860:4860::8888
      labels:
        name: 'GOOGLE'
        code: 'ANYCAST'
        ip: 'IPv6'

至此，在重启一遍 Prometheus 后将可以正常运行了。