mrnetops/fastly-exporter

fastly-exporter

镜像概述和主要用途

该程序从Fastly实时分析API获取数据，并将其转换为https://prometheus.io可采集的指标。它能动态添加新服务、移除旧服务，并反映服务元数据（如名称和版本）的变化，满足Fastly服务监控的基本需求。

核心功能和特性

• 动态服务管理：自动发现并处理Fastly服务的添加、移除及元数据变更
• 灵活的服务过滤：支持按服务ID、名称正则白名单/黑名单筛选服务，以及服务分片部署
• 指标过滤能力：可通过正则表达式筛选需要导出的指标
• 多部署方式：提供二进制、Docker及源码编译多种获取方式
• 完整监控栈集成：包含Docker Compose配置，可快速部署fastly-exporter+Prometheus+Grafana监控栈

使用场景和适用范围

适用于需要监控Fastly CDN服务实时性能指标的场景，特别是：

• 运维团队监控Fastly服务健康状态和性能
• 需将Fastly数据集成到Prometheus监控系统的环境
• 多服务环境下的精细化指标采集和分析

获取方式

二进制文件

前往https://github.com/peterbourgon/fastly-exporter/releases下载对应平台的二进制文件。

Docker

可从Docker Hub获取https://hub.docker.com/r/mrnetops/fastly-exporter镜像：

bash
docker pull docker.xuanyuan.run/mrnetops/fastly-exporter

源码

若已安装Go环境，可从源码安装最新版本：

bash
go get github.com/peterbourgon/fastly-exporter/cmd/fastly-exporter

使用方法和配置说明

基本使用

简单场景下，仅需提供Fastly API令牌。点击此处了解如何创建API令牌。令牌可通过-token标志或FASTLY_API_TOKEN环境变量提供。

bash
fastly-exporter -token XXX

此命令将收集令牌可访问的所有Fastly服务实时统计数据，并在127.0.0.1:8080/metrics提供Prometheus指标。

服务过滤

默认导出令牌可访问的所有服务，可通过以下方式筛选：

• 指定服务ID：使用-service标志指定服务ID（服务ID可在Fastly控制台顶部找到）
• 名称白名单：使用-service-whitelist '^Production'仅包含名称匹配正则的服务
• 名称黑名单：使用-service-blacklist '.*TEST.*'排除名称匹配正则的服务
• 服务分片：对于包含大量服务的令牌，可使用-service-shard在多个实例间分配服务。例如3个实例分片部署：

bash
fastly-exporter [通用标志] -service-shard 1/3
fastly-exporter [通用标志] -service-shard 2/3
fastly-exporter [通用标志] -service-shard 3/3

指标过滤

默认导出Fastly实时统计API提供的所有指标，可通过以下方式筛选：

• 指标白名单：使用`-metric-whitelist 'bytes_total仅导出名称匹配正则的指标
• 指标黑名单：使用-metric-blacklist imgopto排除名称匹配正则的指标

过滤语义

• 同一标志重复使用时，条件为OR关系。例如：-service A -service B将包含服务A和B
• 不同标志（针对同一过滤目标）组合时，条件为AND关系。例如：`-metric-whitelist 'bytes_total将仅导出名称以bytes_total结尾且不包含imgopto的指标

Docker部署

基本Docker运行

bash
docker run -p 8080:8080 docker.xuanyuan.run/mrnetops/fastly-exporter -token $MY_TOKEN

Docker Compose完整栈

仓库包含Docker Compose文件，可启动完整监控栈（fastly-exporter + Prometheus + Grafana + Fastly仪表板）：

bash
env FASTLY_API_TOKEN=$MY_TOKEN docker-compose up

通过http://localhost:3000访问Grafana仪表板。

!https://raw.githubusercontent.com/peterbourgon/fastly-exporter/master/compose/Fastly-Dashboard.png%60%E4%BB%85%E5%AF%BC%E5%87%BA%E5%90%8D%E7%A7%B0%E5%8C%B9%E9%85%8D%E6%AD%A3%E5%88%99%E7%9A%84%E6%8C%87%E6%A0%87

• 指标黑名单：使用__CODE_TOKEN_14__排除名称匹配正则的指标

过滤语义

• 同一标志重复使用时，条件为OR关系。例如：__CODE_TOKEN_15__将包含服务A和B
• 不同标志（针对同一过滤目标）组合时，条件为AND关系。例如：__CODE_TOKEN_16__将仅导出名称以bytes_total结尾且不包含imgopto的指标

Docker部署

基本Docker运行

bash
docker run -p 8080:8080 docker.xuanyuan.run/mrnetops/fastly-exporter -token $MY_TOKEN

Docker Compose完整栈

仓库包含Docker Compose文件，可启动完整监控栈（fastly-exporter + Prometheus + Grafana + Fastly仪表板）：

bash
env FASTLY_API_TOKEN=$MY_TOKEN docker-compose up

通过__CODE_TOKEN_17__访问Grafana仪表板。

!https://raw.githubusercontent.com/peterbourgon/fastly-exporter/master/compose/Fastly-Dashboard.png -metric-blacklist imgopto`将仅导出名称以bytes_total结尾且不包含imgopto的指标

Docker部署

基本Docker运行

bash
docker run -p 8080:8080 docker.xuanyuan.run/mrnetops/fastly-exporter -token $MY_TOKEN

Docker Compose完整栈

仓库包含Docker Compose文件，可启动完整监控栈（fastly-exporter + Prometheus + Grafana + Fastly仪表板）：

bash
env FASTLY_API_TOKEN=$MY_TOKEN docker-compose up

通过__CODE_TOKEN_17__访问Grafana仪表板。

!https://raw.githubusercontent.com/peterbourgon/fastly-exporter/master/compose/Fastly-Dashboard.png%60%E4%BB%85%E5%AF%BC%E5%87%BA%E5%90%8D%E7%A7%B0%E5%8C%B9%E9%85%8D%E6%AD%A3%E5%88%99%E7%9A%84%E6%8C%87%E6%A0%87

• 指标黑名单：使用__CODE_TOKEN_14__排除名称匹配正则的指标

过滤语义

• 同一标志重复使用时，条件为OR关系。例如：__CODE_TOKEN_15__将包含服务A和B
• 不同标志（针对同一过滤目标）组合时，条件为AND关系。例如：__CODE_TOKEN_16__将仅导出名称以bytes_total结尾且不包含imgopto的指标

Docker部署

基本Docker运行

bash
docker run -p 8080:8080 docker.xuanyuan.run/mrnetops/fastly-exporter -token $MY_TOKEN

Docker Compose完整栈

仓库包含Docker Compose文件，可启动完整监控栈（fastly-exporter + Prometheus + Grafana + Fastly仪表板）：

bash
env FASTLY_API_TOKEN=$MY_TOKEN docker-compose up

通过__CODE_TOKEN_17__访问Grafana仪表板。

!https://raw.githubusercontent.com/peterbourgon/fastly-exporter/master/compose/Fastly-Dashboard.png