Google Pagespeed在线指标的Prometheus导出器

镜像概述

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

核心功能与特性

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

使用场景

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

使用方法

前置准备

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

Docker运行示例

直接运行

docker run -p "9271:9271" --rm foomo/pagespeed-exporter -api-key {API_KEY} -targets [***]

使用环境变量运行

docker run -p "9271:9271" --rm \
    --env PAGESPEED_API_KEY={API_KEY} \
    --env PAGESPEED_TARGETS=[***] \
    foomo/pagespeed-exporter

Docker Compose示例

git clone ***:foomo/pagespeed-exporter.git
cd pagespeed-exporter/example
docker-compose up -d

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

参数配置说明

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

目标配置方式

纯文本格式

直接列出目标URL：

[***]
[***]

JSON格式（支持额外参数）

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

{"url":"[***]","campaign":"test","locale":"en","source":"source"}
{"url":"[***]","strategy":"mobile"}

集成Prometheus

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

- 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:
        - '[***]  # 纯文本目标
        - '{"url":"[***]","strategy":"mobile"}'  # JSON格式目标

集成Kubernetes/Helm

使用Helm chart安装：

helm install helm/pagespeed-exporter

验证部署：

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

指标说明

理解指标可参考：

• ***结果解读
• Google Pagespeed API文档

Grafana仪表盘

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

!仪表盘示例