# README
VMProxy
VMProxy is a stateless reverse proxy which proxies requests to VictoriaMetrics and
optionally adds extra_filters
query based on the provided configuration.
Configuration
See vmproxy --help
for more information.
Extra filters
Extra filters is an extension to VictoriaMetrics which allows filtering access to metrics based on labels.
VMProxy adds extra filters based on configuration provided in a header.
When running vmproxy
with --header-name="X-Proxy-Filter"
, requests to the proxy can send
extra filters configuration in a header called X-Proxy-Filter
.
The value of the header shall be a base64 encoded JSON array of strings.
Example:
Value WyJlbnY9UUEiLCAicmVnaW9uPUVVIl0=
decodes to ["env=QA", "region=EU"]
.
This applies two extra filters:
env=QA
region=EU
Multiple filters are joined with logical OR - such as env=QA OR region=EU
If the header is not present, no extra filters are applied.
Contributing notes
Building
make build
Testing
Run make test
to run tests.