foomo/pagespeed_exporter

Google Pagespeed在线指标的Prometheus导出器

镜像概述

该镜像为Prometheus导出器，用于获取Google Pagespeed在线指标，支持配置多个目标网页，将性能数据转换为Prometheus可采集的格式，方便集成到监控系统中进行性能分析和可视化。

核心功能与特性

• 支持配置Google Pagespeed API密钥，获取权威性能数据
• 支持多目标网页监控，可通过纯文本或JSON格式定义目标
• 支持指定移动/桌面策略，未指定时默认同时采集两种策略数据
• 可集成Prometheus采集指标，搭配Grafana进行可视化（提供预设仪表盘）
• 支持Docker部署及Kubernetes/Helm安装，适应不同环境需求

使用场景

适用于网站管理员、DevOps团队监控网页性能，如加载速度、***评分等关键指标，帮助优化网站用户体验。

使用方法

前置准备

需获取Google API密钥以使用Pagespeed API，创建方法参考Google官方文档。

Docker运行示例

直接运行

bash
docker run -p "9271:9271" --rm foomo/pagespeed-exporter -api-key {API_KEY} -targets https://google.com,https://prometheus.io

使用环境变量运行

bash
docker run -p "9271:9271" --rm \
    --env PAGESPEED_API_KEY={API_KEY} \
    --env PAGESPEED_TARGETS=https://google.com,https://prometheus.io \
    foomo/pagespeed-exporter

Docker Compose示例

bash
git clone git@github.com:foomo/pagespeed-exporter.git
cd pagespeed-exporter/example
docker-compose up -d

启动后，应用将运行在localhost:3000，Grafana用户名admin，密码s3cr3t。首次采集后，仪表盘将加载数据，可通过Grafana仪表盘9510查看。

参数配置说明

注意：仅当每秒检测超过2个目标时，才需要Google API密钥。

目标配置方式

纯文本格式

直接列出目标URL：

https://github.com/foomo/pagespeed-exporter
https://mysite.com/test?test=true

JSON格式（支持额外参数）

可指定策略（仅支持mobile/desktop，未指定则同时采集两种）、参数等：

json
{"url":"https://github.com/foomo/pagespeed-exporter","campaign":"test","locale":"en","source":"source"}
{"url":"https://mysite.com/test?test=true","strategy":"mobile"}

集成Prometheus

在Prometheus配置中添加任务，示例：

yaml
- job_name: pagespeed_exporter_probe
  metrics_path: /probe
  relabel_configs:
    - source_labels: [__address__]
      target_label: __param_target
    - source_labels: [__param_target]
      target_label: instance
    - target_label: __address__
      replacement: "pagespeed_exporter:9271"
  static_configs:
    - targets:
        - 'https://example.com/'  # 纯文本目标
        - '{"url":"https://example.com/","strategy":"mobile"}'  # JSON格式目标

集成Kubernetes/Helm

使用Helm chart安装：

bash
helm install helm/pagespeed-exporter

验证部署：

bash
kubectl get pods  # 查看Pod状态
kubectl exec -ti <pod-name> -- sh  # 进入Pod
apk add curl  # 安装curl
curl localhost:9271/metrics  # 查看指标

指标说明

理解指标可参考：

• https://github.com/GoogleChrome/***/blob/master/docs/understanding-results.md
• Google Pagespeed API文档

Grafana仪表盘

提供预设仪表盘，可在Grafana官网获取，展示Pagespeed性能指标。

!https://github.com/foomo/pagespeed_exporter/raw/assets/dashboard.png?raw=true