Connect Axiom.
Connect the Axiom datasets or saved views you want Perfloop to use. It reads field names and query aggregates such as counts and percentiles. Raw events stay in Axiom.
Access you need
- advanced api token · query readCreate a Custom advanced API token. Give it Query read access only for the datasets or views you want to connect. Do not use a personal access token. Axiom documents this in its token guide.
- datasets or saved viewsEnter each dataset or saved-view name exactly.
- Axiom endpointUse the base URL for your Axiom deployment. The default is https://api.axiom.co.
Setup
1 · create the token
In Axiom, open Settings → API tokens → New API token. Select Advanced, then Custom. Grant Query read only for the exact resources you plan to connect. Add an expiration date if your policy requires one.
2 · choose your datasets or views
Prefer a saved view or sanitized dataset that omits payloads, personal data, secrets, and any field value that must not appear in an aggregate grouping.
3 · connect in perfloop
On your Perfloop Setup page, enter the Axiom deployment URL, the token, and one row per dataset or view. Perfloop checks access to each resource. It saves the connection only when all checks pass.
Data Perfloop reads
- Schema metadata. Perfloop reads field names and types.
- Aggregate results. Perfloop reads aggregate query results from one connected dataset or view at a time, within a set time window.
- Grouping values. Queries can group results by fields in the connected dataset or view. These groups can expose individual field values. Use a saved view or sanitized dataset that excludes values you do not want Perfloop to receive.
Perfloop can store query definitions and aggregate results.
Work on a repo uses only datasets or views assigned to that repo. To assign one, contact us with the repo and the dataset or view name. Until a repo has an assignment, its work runs without telemetry. Saving the source again in Setup removes its assignments; contact us to restore them. Use a separate dataset or saved view for each repo; an aggregate query does not remove private values from a shared dataset.
Credentials and network access
Perfloop encrypts your token and uses it only to query the datasets or views you connect. Models and execution sandboxes do not receive the token.
Use a public HTTPS endpoint with a valid certificate. For a private Axiom endpoint, contact us to arrange access to that address.
Change or remove access
In Setup, select Edit on the source's row under Configured sources, change the token or resource list, then select Save connection. The current connection remains active unless the replacement passes validation. Revoke or delete the token in Axiom to disconnect Perfloop and stop new reads. Revocation does not delete product records or stored connection metadata; deleting the workspace removes them.
Provider documentation
Security questions: security@perfloop.ai