Errors Total

Prometheus counter for proxy errors classified by cause, covering filter rejections, timeouts, unreachable upstreams and internal faults

Versions marked “overview” do not contain this page. Selecting one opens that version’s documentation overview.

Category: Practical
Task: Prometheus counter for proxy errors classified by cause, covering filter rejections, timeouts, unreachable upstreams and internal faults

Prerequisites: The product runtime and any backend services referenced by this configuration.

Run it: Use ghcr.io/praxis-proxy/praxis:0.7.2 and follow the first reverse-proxy tutorial to mount and start the configuration.

This configuration comes from the selected release. The example has not been run here; external services are not bundled.

Download the source file.

# Errors Total
#
# Prometheus counter for proxy errors classified by cause, covering filter
# rejections, timeouts, unreachable upstreams and internal faults. Counted
# once per request against the first cause, so retries do not multiply the
# total. Scraped via the admin /metrics endpoint.
#
admin:
  address: "127.0.0.1:9901"

insecure_options:
  allow_private_endpoints: true

listeners:
  - name: web
    address: "127.0.0.1:8080"
    filter_chains:
      - routing

filter_chains:
  - name: routing
    filters:
      - filter: router
        routes:
          - path_prefix: "/broken/"
            cluster: unreachable
          - path_prefix: "/"
            cluster: backend
      - filter: load_balancer
        clusters:
          - name: backend
            endpoints:
              - "127.0.0.1:3000"
          # Nothing listens here: requests to /broken/ fail to connect and
          # are counted as praxis_errors_total{type="upstream_unavailable"}.
          - name: unreachable
            endpoints:
              - "127.0.0.1:3999"