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 checks every selector 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.
Repo access
Work on a repo uses only the selected scopes assigned to that repo. To assign them, contact us with the repo and their names. Until a repo has an assignment, its work runs without telemetry. Saving the connection again in Setup removes its assignments; contact us to restore them.
Credentials and network access
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 VictoriaMetrics the internet cannot reach, run the Perfloop relay in your network and enter relay://name as the endpoint. The provider credential then lives in the relay configuration; leave the Authorization field in Setup empty.
Change or remove access
In Setup, select Edit on the source's row under Configured sources, 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