czerwonk/atlas_exporter

atlas_exporter

用于RIPE Atlas测量结果的指标导出器，可将DNS、Ping、Traceroute等多种类型的测量数据转换为Prometheus兼容指标，支持实时更新和性能指标分析。

备注

• 目前为早期版本，将逐步添加更多功能
• 当前仅使用测量的最后一个结果
• 所需Go版本为1.11及以上

流式API

自0.8版本起，atlas_exporter支持通过RIPE Atlas流式API（[***]

直方图

自1.0版本起，atlas_exporter提供以下测量类型的往返时间（RTT）直方图：

• DNS
• Ping
• Traceroute
• HTTP

桶可在配置文件中自定义（见下文）。该功能依赖获取每个测量的更新，因此必须使用流式API模式。直方图指标允许计算特定指标的百分位数（如RTT），便于监控服务级别目标（例如基于90%请求的Ping RTT阈值）。

更多信息：[***]

Docker使用

启动服务器（普通模式）

bash
docker run -d --restart unless-stopped -p 9400:9400 czerwonk/atlas_exporter

配置文件模式

bash
docker run -d -e CONFIG=/tmp/config.yml -v /tmp/config.yml:/tmp/config.yml --restart unless-stopped -p 9400:9400 czerwonk/atlas_exporter 

使用方法

启动服务器

普通模式

bash
./atlas_exporter

配置文件模式

bash
./atlas_exporter -config.file config.yml

配置文件

以下示例配置用于获取测量ID为8772164的结果：

yaml
measurements:
  - id: 8772164  # 测量ID
    timeout: 120s  # 超时时间
histogram_buckets:  # 直方图桶配置
  ping:
    rtt:
      - 5.0
      - 10.0
      - 25.0
      - 50.0
      - 100.0
filter_invalid_results: true  # 过滤无效结果

调用指标接口

配置文件模式

bash
curl http://127.0.0.1:9400/metrics

临时指定测量ID

bash
curl http://127.0.0.1:9400/metrics?measurement_id=8772164

返回结果示例（部分）：

# HELP atlas_traceroute_hops 跳数
# TYPE atlas_traceroute_hops gauge
atlas_traceroute_hops{asn="1101",dst_addr="8.8.8.8",dst_name="8.8.8.8",ip_version="4",measurement="8772164",probe="6031"} 9
atlas_traceroute_hops{asn="11051",dst_addr="8.8.8.8",dst_name="8.8.8.8",ip_version="4",measurement="8772164",probe="17833"} 8
...

功能特性

• Ping测量：成功率、最小/最大/平均延迟、丢包率、包大小
• Traceroute测量：成功率、跳数、RTT
• NTP测量：延迟、偏差、NTP版本
• DNS测量：成功率、RTT
• HTTP测量：状态码、RTT、HTTP版本、头部大小、响应体大小
• SSL证书测量：告警、RTT

Prometheus配置

临时模式（Ad-Hoc Mode）

yaml
  - job_name: 'atlas_exporter'
    scrape_interval: 5m
    static_configs:
      - targets:
        - 7924888  # 测量ID
        - 7924886  # 测量ID
    relabel_configs:
      - source_labels: [__address__]
        regex: (.*)(:80)?
        target_label: __param_measurement_id
        replacement: ${1}
      - source_labels: [__param_measurement_id]
        regex: (.*)
        target_label: instance
        replacement: ${1}
      - source_labels: []
        regex: .*
        target_label: __address__
        replacement: atlas-exporter.mytld:9400  # atlas_exporter地址

配置文件模式

yaml
  - job_name: 'atlas_exporter'
    scrape_interval: 5m
    static_configs:
      - targets:
          - atlas-exporter.mytld:9400  # atlas_exporter地址

第三方组件

本软件使用以下项目的组件：

• RIPE Atlas API的Go绑定（https://github.com/DNS-OARC/ripeatlas%EF%BC%89
• Prometheus Go客户端库（https://github.com/prometheus/client_golang%EF%BC%89

许可协议

(c) Daniel Czerwonk, 2017。基于LGPL3许可协议。

相关链接

• Prometheus：[***]
• RIPE Atlas项目：[***]
• RIPE Labs文章：[***]