17739643369
52%

Ran 15 Sep 2025 04:23PM UTC

Jobs 1

Files 558

Run time 2min

Badge

Embed ▾

Committed 15 Sep 2025 04:17PM UTC coverage: 54.361% (-0.09%) from 54.449%

Build # 17739643369

Build Type

push

github

Committed by

web-flow

Commit Message

feat : http probe listeners & basic component health checks (#5822)

## Summary

This adds basic health checks to pomerium core components to report them
as running / terminating or in an error state.

The health check service reloads on configuration, and binds to a
predetermined port `28080` on the machine's hostname.

## Related issues


[ENG-2849](https://linear.app/pomerium/issue/ENG-2849/implement-core-health-checks)

## User Explanation

Users can enable health checks based on http probes, for example in
Kubernetes deployments like:
```
livenessProbe:
      httpGet:
        path: /healthz
        port: 28080
      initialDelaySeconds: 3
      periodSeconds: 60
      failureThreshold: 10
startupProbe:
      httpGet:
        path: /startupz
        port: 28080
      initialDelaySeconds: 3
      periodSeconds: 60
      failureThreshold: 10
readinessProbe:
      httpGet:
        path: /readyz
        port: 28080
      initialDelaySeconds: 3
      periodSeconds: 60
      failureThreshold: 10
```
## Checklist

- [X] reference any related issues
- [X] updated unit tests
- [X] add appropriate label (`enhancement`, `bug`, `breaking`,
`dependencies`, `ci`)
- [X] ready for review

Coverage Stats

103 of 256 new or added lines in 13 files covered. (40.23%)

45 existing lines in 14 files now uncovered.

26815 of 49328 relevant lines covered (54.36%)

88.55 hits per line

Uncovered Changes

Lines	Coverage	∆	File
63	2.55	-0.43%	pkg/envoy/envoy.go
31	0.0	0.0%	pkg/cmd/pomerium/pomerium.go
25	63.18	1.11%	internal/controlplane/server.go
14	0.0	0.0%	internal/testenv/environment.go
5	0.0	0.0%	internal/zero/telemetry/telemetry.go
5	62.9	-0.32%	pkg/storage/file/pebble.go
5	78.72	-0.77%	pkg/storage/postgres/backend.go
3	69.57	-0.08%	config/options.go
1	80.95	0.0%	internal/databroker/config_source.go
1	45.13	2.14%	pkg/grpc/databroker/databroker.go

Coverage Regressions

Lines	Coverage	∆	File
7	93.69	-3.21%	config/options_databroker.go
7	72.3	-4.73%	pkg/grpcutil/client_manager.go
7	78.72	-0.77%	pkg/storage/postgres/backend.go
3	86.96	-3.26%	pkg/health/deduplicate.go
3	14.29	-23.21%	pkg/health/provider.go
3	66.03	0.0%	pkg/storage/file/iterate.go
3	85.53	0.0%	pkg/storage/postgres/iterate.go
2	62.14	0.0%	internal/databroker/server_clustered_follower.go
2	92.78	-1.11%	internal/fileutil/watcher.go
2	89.19	-5.41%	pkg/fanout/fanout.go
2	90.91	0.0%	pkg/fanout/receive.go
2	83.9	-0.98%	pkg/ssh/channel.go
1	0.0	0.0%	internal/testenv/environment.go
1	2.55	-0.43%	pkg/envoy/envoy.go

Jobs

ID	Job ID	Ran	Files	Coverage
1	17739643369.1	15 Sep 2025 04:23PM UTC	558	54.36	GitHub Action Run

pomerium / pomerium / 17739643369
52%

README BADGES
x

Markdown

Textile

RDoc

HTML

Rst

Uncovered Changes

Coverage Regressions

Jobs

Source Files on build 17739643369

pomerium / pomerium / 17739643369 52%

README BADGES x

Markdown

Textile

RDoc

HTML

Rst

Uncovered Changes

Coverage Regressions

Jobs

Source Files on build 17739643369

pomerium / pomerium / 17739643369
52%

README BADGES
x