VMProxy is a stateless reverse proxy which proxies requests to VictoriaMetrics and optionally adds extra_filters query based on the provided configuration.

See vmproxy --help for more information.

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.

make build

Run make test to run tests.