Connect VictoriaMetrics.
Connect metrics from VictoriaMetrics through its Prometheus-compatible API. Use labels to choose the services and environments Perfloop can read.
Access you need
- read-only authorizationCreate a credential that can use the VictoriaMetrics query API. Enter the complete Authorization header value. Do not grant write or administration access.
- label selectorsEnter a selector such as
{service="api",env="prod"}. Every query must contain these filters. - HTTPS endpointEnter your query endpoint URL. For a cluster, include the tenant path, such as /select/42/prometheus when your deployment uses one.
Setup
1 · create a read credential
Create a dedicated credential for the compatible read endpoint or its authenticating gateway.
2 · set the endpoint and scopes
In Perfloop Setup, select VictoriaMetrics. Enter the HTTPS endpoint, complete Authorization value, and one exact label selector for each service or environment.
3 · connect to Perfloop
Perfloop validates every selector through the saved endpoint before it saves the connection.
Data Perfloop reads
- Discovery metadata. Metric names and labels for the services and environments you selected.
- Metric results. Instant and range responses keep VictoriaMetrics label maps, exact values, warnings, and provider fields.
- Stored results. Perfloop can retain the query without credentials and its response with its source and time window.
Query limits
- Requests must keep the registered selector. Unsupported MetricsQL extensions are refused.
- A query can cover up to seven days, including any lookback used by a function such as rate().
- Results keep VictoriaMetrics values and cache information so measurements can be checked against the source.
Credentials and network access
If you enter a token in Setup, your browser sends it to Perfloop over HTTPS. Tokens from provider authorization go directly to Perfloop.
Perfloop encrypts the credential and uses it only for requests within your connection's scope. Models and execution sandboxes do not receive it.
Use a public HTTPS endpoint with a valid certificate. For a private endpoint, contact us to arrange access to that address. You cannot enable private network access from Setup.
Change or remove access
Select Edit connection in Setup, change the credential, endpoint, or selector list, then select Save connection. The current connection remains active if replacement validation fails. Revoke the credential in your provider to stop later reads.
Removing access does not delete connection details or results already stored in Perfloop.
Provider documentation
Security questions: security@perfloop.ai
