jacksontj/promxy

Health v2 · maintenance only

Adoption not part of the score

1320 stars · 161 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

Promxy is an aggregating proxy written in Go that makes multiple Prometheus shards appear as a single API endpoint. It merges duplicate time-series data from HA Prometheus hosts and provides unified PromQL query federation without requiring sidecars or changes to existing Prometheus infrastructure.

Use cases

• run highly available prometheus with merged data from duplicate hosts
• give grafana a single datasource for multiple prometheus servers
• run globally aggregated promql queries across prometheus shards
• fill gaps in timeseries caused by prometheus restarts or upgrades
• simplify prometheus operations when scaling beyond one host

When to choose

• you run multiple identical prometheus hosts for HA and want them to appear as one endpoint
• you need cross-shard promql aggregation without sidecars or custom prometheus builds
• you want to reduce grafana datasource confusion across many prometheus instances

When to avoid

• you run a single prometheus instance with no HA requirements
• you need full clustering or long-term storage rather than query federation
• you rely on prometheus features promxy does not proxy

Facets

service · maturity active

proxy monitoring http-server api-gateway monitoring time-series self-hosted go self-hosted cli prometheus promql high-availability grafana query-federation time-series-database devops linux docker

Member repositories

For agents

markdown · JSON · MCP: product_card(name="jacksontj/promxy")