Overview

Full name
docker.io/prom/statsd-exporter
Registry
docker.io
Namespace
prom
Repository
statsd-exporter
Cached tags
61
Last synced
07/06/2026, 05:29 PM

Introduction

Prometheus 官方 StatsD 指标桥接导出器,监听 UDP/TCP StatsD 报文并转为 Prometheus 文本格式,供 Prometheus 抓取应用自定义指标。

Details

prom/statsd-exporter 将 DogStatsD/StatsD 风格的计数器、计时器与仪表转换为带标签的 Prometheus 指标,应用无需直连 Prometheus SDK 即可上报。与 Telegraf statsd 输入相比与 Prometheus 生态原生集成,暴露 /metrics HTTP 端点。生产应通过 statsd_mapping.yml 规范指标名与标签、限制来源网络,并固定 exporter 版本;无状态可水平扩展,多副本需负载均衡 StatsD UDP 或使用独立实例 per AZ。

快速启动

docker run -d --name statsd-exporter \
  -p 9102:9102 -p 9125:9125/udp \
  docker.io/prom/statsd-exporter:latest

推荐实践

docker run -d --name statsd-exporter \
  --restart unless-stopped \
  -p 9102:9102 -p 9125:9125/udp \
  -v $(pwd)/statsd_mapping.yml:/etc/statsd_mapping.yml \
  docker.io/prom/statsd-exporter:v0.26.1 \
  --statsd.mapping-config=/etc/statsd_mapping.yml

核心参数说明

  • -p 9102:9102 — Prometheus /metrics 抓取端口
  • -p 9125:9125/udp — StatsD 接收端口
  • --statsd.mapping-config — 指标映射规则文件
  • -v .../statsd_mapping.yml:... — 映射配置挂载
  • --restart unless-stopped — 指标桥接持续运行
  • 固定 tag — 与 Prometheus 2.x 兼容

Kubernetes

apiVersion: apps/v1
kind: Deployment
metadata:
  name: statsd-exporter
spec:
  replicas: 2
  selector:
    matchLabels:
      app: statsd-exporter
  template:
    metadata:
      labels:
        app: statsd-exporter
    spec:
      containers:
        - name: exporter
          image: docker.io/prom/statsd-exporter:v0.26.1
          args:
            - --statsd.mapping-config=/etc/statsd_mapping.yml
          ports:
            - containerPort: 9102
            - containerPort: 9125
              protocol: UDP
          volumeMounts:
            - name: mapping
              mountPath: /etc/statsd_mapping.yml
              subPath: statsd_mapping.yml
      volumes:
        - name: mapping
          configMap:
            name: statsd-mapping
---
apiVersion: v1
kind: Service
metadata:
  name: statsd-exporter
  annotations:
    prometheus.io/scrape: "true"
    prometheus.io/port: "9102"
spec:
  selector:
    app: statsd-exporter
  ports:
    - name: metrics
      port: 9102
    - name: statsd
      port: 9125
      protocol: UDP

映射规则放 ConfigMap;UDP Service 需 CNI 支持,Prometheus 按 annotation 或 ServiceMonitor 抓取 9102。

Latest tags (20)

View all 61 tags →
TagArchPushed AtSizeDigestSyncWishAction
docker.io/prom/statsd-exporter
:master-distroless
linux/amd64linux/arm64linux/arm/v7linux/ppc64lelinux/riscv64linux/s390x
2026/07/03 23:009.9 MBsha256:3603a892da0f
docker.io/prom/statsd-exporter
:master
linux/amd64linux/arm64linux/arm/v7linux/ppc64lelinux/riscv64linux/s390x
2026/07/03 22:5910.2 MBsha256:f64dbc178235
docker.io/prom/statsd-exporter
:v0-distroless
linux/amd64linux/arm64linux/arm/v7linux/ppc64lelinux/riscv64linux/s390x
2026/05/28 22:419.9 MBsha256:4ceb71d847ef
docker.io/prom/statsd-exporter
:latest-distroless
linux/amd64linux/arm64linux/arm/v7linux/ppc64lelinux/riscv64linux/s390x
2026/05/28 22:409.9 MBsha256:4ceb71d847ef
docker.io/prom/statsd-exporter
:v0
linux/amd64linux/arm64linux/arm/v7linux/ppc64lelinux/riscv64linux/s390x
2026/05/28 22:3810.2 MBsha256:aa922156ccf9
docker.io/prom/statsd-exporter
:latest
linux/amd64linux/arm64linux/arm/v7linux/ppc64lelinux/riscv64linux/s390x
2026/05/28 22:3710.2 MBsha256:aa922156ccf9
docker.io/prom/statsd-exporter
:v0.30.0-distroless
linux/amd64linux/arm64linux/arm/v7linux/ppc64lelinux/riscv64linux/s390x
2026/05/28 22:369.9 MBsha256:4ceb71d847ef
docker.io/prom/statsd-exporter
:v0.29.0
linux/amd64linux/arm64linux/arm/v7
2026/03/03 13:2310.2 MBsha256:38fdb92e8ddc
docker.io/prom/statsd-exporter
:v0.28.0
linux/amd64linux/arm64/v8linux/arm/v7
2024/10/25 21:5610.0 MBsha256:83ef0e3ab695
docker.io/prom/statsd-exporter
:v0.27.2
linux/amd64linux/arm64/v8linux/arm/v7
2024/10/07 21:359.6 MBsha256:174ecddf471c
docker.io/prom/statsd-exporter
:v0.27.2-pr579
linux/amd64linux/arm64/v8linux/arm/v7
2024/09/16 17:449.6 MBsha256:0d0ccb2fb7b6
docker.io/prom/statsd-exporter
:v0.27.1
linux/amd64linux/arm64/v8linux/arm/v7
2024/08/18 23:399.6 MBsha256:df4be84f2471
docker.io/prom/statsd-exporter
:v0.26.1
linux/amd64linux/arm64/v8linux/arm/v7
2024/03/23 00:129.1 MBsha256:ebd71582f909
docker.io/prom/statsd-exporter
:v0.26.0
linux/amd64linux/arm64/v8linux/arm/v7
2023/12/06 18:028.7 MBsha256:dbb29e085d61
docker.io/prom/statsd-exporter
:v0.25.0
linux/amd64linux/arm64/v8linux/arm/v7
2023/10/24 00:388.8 MBsha256:ca28e3854b4e
docker.io/prom/statsd-exporter
:v0.24.0
linux/amd64linux/arm64/v8linux/arm/v7
2023/06/02 16:088.9 MBsha256:693c01b35205
docker.io/prom/statsd-exporter
:v0.23.3
linux/amd64linux/arm64/v8linux/arm/v7
2023/06/02 15:528.7 MBsha256:d7a8afd5b57b
docker.io/prom/statsd-exporter
:v0.23.1
linux/amd64linux/arm64linux/arm
2023/03/09 02:598.6 MBsha256:51e20a16b034
docker.io/prom/statsd-exporter
:v0.23.0
linux/amd64linux/armlinux/arm64
2022/12/07 18:168.7 MBsha256:d0140fb24008
docker.io/prom/statsd-exporter
:v0.22.8
linux/amd64linux/arm64linux/arm
2022/09/13 22:588.4 MBsha256:e44b1f93c035