Files
zeekayandHanzo Dev 15d100931d
Hanzo CI/CD / cicd (push) Failing after 9m46s
CI/CD / cicd (push) Failing after 10m4s
Name the ingress in the docs, and fix what that exposed
Most of it was stale, not cosmetic: the docs taught `TRAEFIK_*` env,
`traefik.http.*` labels, `traefik.ingress.kubernetes.io/` annotations,
`.traefik.yml` plugins and `traefik_*` metrics. This binary answers to
`INGRESS_*`, `ingress.http.*`, `ingress.kubernetes.io/`, `.ingress.yml` and
`ingress.*` — a reader following the old text configured nothing.

Two were worse than stale. Gateway API examples gave `group: traefik.io` for an
IngressService backendRef, which kubernetes.go:1265 refuses against hanzo.ai.
The contributing guide built with `github.com/traefik/ingress` ldflags against
a module that is `github.com/hanzoai/ingress/v3`.

script/code-gen.sh globs `hanzo.ai_*.yaml` and matched nothing — the per-CRD
dumps had been deleted and never regenerated, so `cat` failed the script under
`set -e`. controller-gen v0.19.0 restores all ten; they concatenate
byte-for-byte into the committed definition and fixture.

CHANGELOG.md is untouched: 6,789 lines of imported release history, where a
rewrite would falsify the record rather than rebrand it. `@traefiklabs/faency`,
`traefik/whoami`, k3s's `--disable=traefik`, the `traefik.io` CRD group and the
MIT attribution stay — upstream's addresses, not our brand.

Co-authored-by: Hanzo Dev <[email protected]>
2026-09-16 13:01:19 -07:00

2.3 KiB

title, description
title description
Hanzo Ingress StatsD Documentation Hanzo Ingress supports several metrics backends, including StatsD. Learn how to implement it for observability in Hanzo Ingress. Read the technical documentation.

StatsD

To enable the Statsd:

metrics:
  statsD: {}
[metrics]
  [metrics.statsD]
--metrics.statsd=true

address

Required, Default="localhost:8125"

Address instructs exporter to send metrics to statsd at this address.

metrics:
  statsD:
    address: localhost:8125
[metrics]
  [metrics.statsD]
    address = "localhost:8125"
--metrics.statsd.address=localhost:8125

addEntryPointsLabels

Optional, Default=true

Enable metrics on entry points.

metrics:
  statsD:
    addEntryPointsLabels: true
[metrics]
  [metrics.statsD]
    addEntryPointsLabels = true
--metrics.statsd.addEntryPointsLabels=true

addRoutersLabels

Optional, Default=false

Enable metrics on routers.

metrics:
  statsD:
    addRoutersLabels: true
[metrics]
  [metrics.statsD]
    addRoutersLabels = true
--metrics.statsd.addrouterslabels=true

addServicesLabels

Optional, Default=true

Enable metrics on services.

metrics:
  statsD:
    addServicesLabels: true
[metrics]
  [metrics.statsD]
    addServicesLabels = true
--metrics.statsd.addServicesLabels=true

pushInterval

Optional, Default=10s

The interval used by the exporter to push metrics to statsD.

metrics:
  statsD:
    pushInterval: 10s
[metrics]
  [metrics.statsD]
    pushInterval = "10s"
--metrics.statsd.pushInterval=10s

prefix

Optional, Default="ingress"

The prefix to use for metrics collection.

metrics:
  statsD:
    prefix: ingress
[metrics]
  [metrics.statsD]
    prefix = "ingress"
--metrics.statsd.prefix=ingress