Forgalmi statisztika a projektedhez (per-project analytics)
Cloudflare-alapú forgalmi adatok minden Cloud-projekthez: napi requests, bandwidth, top országok. Setup és értelmezés.
A /app/cloud/<slug> projekt-oldalon van egy Forgalmi statisztikák
(utolsó 7 nap) szekció, ami Cloudflare GraphQL Analytics
API-ból kérdezi le az adatokat. Mit mutat, hogyan értelmezed, és
mi van, ha “Analytics függőben” üzenetet látsz.
Mit mutat
Per-projekt szinten, az utolsó 7 napra:
- Napi request-szám SVG bar-chart-on (összes HTTP-kérés a
<slug>.promnet.huhostra) - Összes request 7 nap alatt
- Összes átvitt bandwidth (edge response bytes)
- Top 5 ország kérések szerint csökkenő sorrendben
Az adatok kb. 1-2 óra késéssel érkeznek a Cloudflare-től. Ami “most” történik, az 1-2 óra múlva lesz látható.
Miért nem lát adatot a “Analytics függőben”?
Több ok lehet — a státusz-üzenet is mutatja melyik:
1. “Zone-ID nincs beállítva (PROMNET_ZONE_ID)”
A CF Pages env-vars közül hiányzik a PROMNET_ZONE_ID. Ez a
promnet.hu zóna ID-ja a Cloudflare-en — ezt a *.promnet.hu
subdomain-forgalom kérdezéséhez kell.
Megoldás: a CF dashboardon Workers & Pages → promnet-v18 →
Settings → Environment variables alatt add hozzá Production
környezethez, érték = a promnet.hu zóna ID-ja (32 karakteres
hex, a CF zone-overview oldalon a jobb sidebar-ban látszik).
Új deploy után életbe lép.
2. “CF API token nincs konfigurálva”
A CLOUDFLARE_API_TOKEN env-var hiányzik. Ez a token a teljes
PromNET-platformhoz kell (zone-create, R2 management, analytics).
3. “Analytics: HTTP 401” / “HTTP 403”
A token van, de nincs Zone Analytics: Read jogosultsága. A CF GraphQL Analytics API egyik permissionöt igényli:
- Account → Account Analytics: Read (preferált — minden zónára)
- VAGY Zone → Analytics: Read + Zone → Zone: Read
Token-szerkesztés: dash.cloudflare.com/profile/api-tokens.
4. “Analytics: GraphQL: …”
A query syntactically lefutott, de a CF visszadobta. Két leggyakoribb:
- “unknown field” — a CF API verziófrissített és a régi mezőnév már nincs. Mi karban tartjuk a query-t — ha látod, írj nekünk.
- “User-id not authorized” — a token authorizálva van, de a zóna nem tartozik az account_id-hoz.
5. “A projekt még nincs élesben”
A projekted státusza még draft — nincs deploy-olt tartalom, így
a host nem szerepel a CF Analytics-ben. Töltsd fel az első fájlt
és térj vissza ide pár óra múlva.
A diagram értelmezése
A bar-chart x-tengelyén a 7 nap, y-tengelyén a daily request count.
A magasság a MAX(daily_requests) arányában van (nem abszolút —
relatív a saját 7-napos csúcsodhoz).
Color-code:
- PromNET-piros bar-ok: napi requests
- Halványabb pirossal: bandwidth-overlay (átvitt bytes)
- Tooltip-en hover: pontos szám + dátum
Mi NEM látszik
A jelenlegi MVP-statisztika:
- ❌ Egyedi látogatók (CF nem ad publikus ‘unique visitors’ az ingyenes Analytics-tieren — fizetős CF Web Analytics + JS-tag igényli)
- ❌ Top URL-k (path-szintű bontás)
- ❌ Browser / OS bontás
- ❌ Real-time (utolsó 1 perc)
Ezek a következő sprint-ben jönnek, ha értelmes lesz a forgalmad egyáltalán mérni.
Fizetős vs ingyenes
A jelenlegi statisztika a CF zone-szintű GraphQL dataset-ből
jön, ami ingyen elérhető minden CF-zóna-tulajdonosnak. A
PromNET-en ez a promnet.hu zóna, így minden <slug>.promnet.hu
forgalom adata szerepel itt.
Ha mélyebb analytics kell (per-page, real-time, demographic),
ahhoz a CF Web Analytics fizetős plan kellene, vagy 3rd-party
(Plausible, Fathom). PromNET-en könnyű beilleszteni — a Plausible
script-tag a HTML <head>-ben elég.
Saját domain analytics
Ha a projekt-domain-edet (pl. pelda.hu) PromNET-en bekötötted,
a pelda.hu is a promnet.hu zóna alatt él? Nem — saját zónája
van. A jelenlegi analytics csak a <slug>.promnet.hu host-ra fut.
A saját-domain analytics-szel a következő sprint foglalkozik: ott a saját CF-zóna-ID-d alapján fut majd a query.
Hibajelentés / kérdés
Ha az “Analytics: …” hibaüzenet után sem érted mit kell tenni, küldj egy threadet a /community/cloud-tarhely kategóriába a státusz-üzenettel és a projekt-slug-gal — végignézzük.