Before you start
These fields prepare a future importer; they do not fetch data today.
Use importer settings when you want the project ready for the Rails-side Cloudflare API fetcher once it exists. Manual telemetry is still the working path for sending Pages metrics and deployments into Logister right now.
| What you need | Why it matters |
|---|---|
| Project owner or project admin access | Only project managers should change integration settings. |
| Cloudflare account ID and Pages project name | Identify the Pages project the future fetcher should query. |
| Secret name, not token value | Keeps Cloudflare API tokens in the deploy secret store instead of the settings form. |
Settings path
Open Project > Settings > Integrations.
| Field | Meaning |
|---|---|
| Enable Cloudflare imports | Marks this project as eligible for the future importer. |
| Cloudflare account ID | The account ID from Cloudflare. |
| Pages project name | The Pages project name. |
| Cloudflare project ID | Optional external project ID. |
| Credential reference | Name of a secret such as CLOUDFLARE_API_TOKEN. Do not paste the raw token here. |
Current importer status
Importer jobs currently skip with a fetcher-not-implemented result. Manual HTTP telemetry is the working path today.
Verification
Confirm the settings saved, then test manual telemetry.
- Save the Cloudflare Pages settings.
- Reload
Project > Settings > Integrationsand confirm the account ID, Pages project name, optional project ID, and credential reference are still present. - Do not expect imported Cloudflare rows yet; the fetcher is intentionally not live.
- Send one metric from the manual telemetry guide if you need data in Events or Insights today.
Troubleshooting
Keep credentials out of the settings form.
| Symptom | Likely fix |
|---|---|
| Importer settings are saved but no Cloudflare data appears | Expected for now. Use manual telemetry until the fetcher is implemented. |
| Credential field contains a raw token | Move the token to the deploy secret store and save only the environment variable or secret reference name. |
| Wrong Pages project is represented | Check the Cloudflare account ID and Pages project name against the Cloudflare dashboard before saving again. |
| Manual events still do not appear | Importer settings do not affect manual ingestion. Check API token, endpoint, payload, and the HTTP response. |
Read manual telemetry when you want working data now.