Connect Grafana.
Use your Grafana stack to connect Prometheus, Loki, or Pyroscope. Select the data sources Perfloop can query.
Access you need
- service-account tokenCreate a Grafana service account with query access. Restrict it to the data sources you plan to connect when your Grafana edition supports data-source permissions.
- selected data sourcesChoose the Prometheus, Loki, or Pyroscope data sources Perfloop may read. Each is identified by its unique ID (UID).
- Grafana stack URLEnter your Grafana stack URL. Queries go through Grafana, which connects to the underlying data source.
Setup
1 · create the service account
Create a dedicated Grafana service account and token with query access to the intended data sources.
2 · load the data sources
In Perfloop Setup, select Grafana. Enter the stack URL and token, then load the visible data sources.
3 · select and connect
Select the data sources to connect. Perfloop validates every selected source before it saves the connection.
Data Perfloop reads
- Data-source metadata. The picker receives UID, name, type, and support status for sources visible to the service account.
- Provider query results. Selected Prometheus and Loki results retain their own dialect and response fields.
- Profile data. Selected Pyroscope sources can return profile lists and merged pprof files through Grafana.
Query limits
- Perfloop queries only the data sources you select. Restrict the service account in Grafana too, so its token cannot access other data sources.
- Choose a Pyroscope data source to read profiles. Prometheus and Loki sources cannot supply profiles.
- Queries go through Grafana to the data source you selected.
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
Replace the connection in Setup to rotate the token, stack URL, or complete UID list. Revoke the service-account token in Grafana to stop later reads.
Removing access does not delete connection details or results already stored in Perfloop.
Provider documentation
Security questions: security@perfloop.ai
