← Cloudflare Waiting Room / waiting-room / how-to
Sledování stavu čekárny
Stav svých čekáren můžete sledovat pomocí dashboard nebo API.
Upozorňujeme, že Total active users a Uživatelé ve frontě zobrazené na dashboardu i prostřednictvím koncových bodů API jsou odhady. Data odpovídající každé z těchto metrik jsou po synchronizaci ze všech datových center po celém světě ukládána do mezipaměti přibližně na 30 sekund. Zobrazený stav proto odpovídá stavu starému 20 až 50 sekund, v závislosti na přesném okamžiku dotazu, agregace dat a stáří mezipaměti.
Viz Analytika Waiting Room s dalšími podrobnostmi o provozu procházejícím vaší čekárnou.
Stav na dashboardu
Otevřete Waiting Room dashboardu zobrazíte seznam svých čekáren.
Stav sloupec zobrazuje aktuální stav čekárny:
- Frontování neprobíhá:
- Čekárna je zapnutá, ale zatím nedosáhla prahové hodnoty provozu potřebné k odesílání návštěvníků do čekárny.
- Zobrazuje odhadovaný počet uživatelů v aplikaci.
- Řazení do fronty:
- Čekárna je zapnutá a odesílá návštěvníky do čekárny.
- Zobrazuje odhadovaný počet uživatelů ve frontě.
- Po přejetí myší zobrazí maximální očekávanou čekací dobu pro uživatele.
- Disabled: Čekárna je pozastavena.
- Queue-all:
- Vynutí zařazení veškerého provozu do fronty v čekárně.
- Po přejetí myší zobrazí odhadovaný počet uživatelů ve frontě.
Stav v API
Zkontrolujte, zda se provoz řadí do fronty v nakonfigurované čekárně tak, že k základní URL adrese Cloudflare API připojíte následující koncový bod:
Požadovaná oprávnění API tokenu
Alespoň jeden z následujících oprávnění tokenu je povinné:Waiting Rooms ReadWaiting Rooms Write
curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/waiting_rooms/$WAITING_ROOM_ID/status" \
--request GET \
--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"Odpověď vypadá takto:
queueingpokud jsou návštěvníci aktuálně zařazeni do fronty v čekárně.not_queueingpokud je čekárna prázdná nebo pozastavená.
Chcete-li zjistit, zda je nakonfigurovaná čekárna pozastavená nebo zda je provoz do čekárny vynuceně řazen do fronty, připojte k základní URL adrese API Cloudflare následující endpoint.
Požadovaná oprávnění API tokenu
Alespoň jeden z následujících oprávnění tokenu je povinné:Waiting Rooms ReadWaiting Rooms Write
curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/waiting_rooms/$WAITING_ROOM_ID" \
--request GET \
--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"Výše uvedený endpoint načte všechna nastavení pro nakonfigurovanou čekárnu:
"success": true,
"errors": [],
"messages": [],
"result": {
"id": "REDACTED",
"created_on": "2014-01-01T05:20:00.12345Z",
"modified_on": "2014-01-01T05:20:00.12345Z",
"name": "shop_waiting_room",
"description": "Waiting room for webshop",
"suspended": false,
"host": "shop.example.com",
"path": "/shop",
"queue_all": true,
"new_users_per_minute": 200,
"total_active_users": 300,
"session_duration": 1,
"disable_session_renewal": false,
"json_response_enabled": false,
"queueing_method": "random",
"cookie_attributes": {
"samesite": "auto",
"secure": "auto"
},
"custom_page_html": "{{#waitTimeKnown}} {{waitTime}} mins {{/waitTimeKnown}} {{^waitTimeKnown}} Queue all enabled {{/waitTimeKnown}}"
}Hodnota suspended určuje, zda je čekárna aktivní, nebo pozastavená:
false: Čekárna je aktivována.true: Čekárna je pozastavena.
Hodnota queue_all určuje, zda je veškerý provoz nucen čekat ve frontě v čekárně:
false: Návštěvníci se do čekárny přesměrují pouze tehdy, když provoz překročí nakonfigurovanou prahovou hodnotu.true: Veškerý provoz je nucen čekat ve frontě v čekárně a žádný provoz z čekárny nepokračuje na origin server.
Aktivace řazení do fronty
Waiting Room řadí provoz do fronty na úrovni datového centra, což zvyšuje škálovatelnost, protože každé datové centrum rozhoduje samostatně.
Vzhledem k tomuto návrhu jsou nakonfigurované limity provozu čekárny cílovými hodnotami, kterým se čekárna snaží co nejvíce přiblížit. Čekárna může začít řadit provoz z konkrétního datacentra do fronty ještě předtím, než dosáhne limitu new_users_per_minute nebo total_active_users.
Waiting Room navíc průběžně sleduje rychlost vstupu uživatelů v průběhu celé minuty, nejen na jejím konci. Pokud tedy na začátku dané minuty vstoupí velká část nastaveného new_users_per_minute hodnota již dosažena, můžeme začít řadit uživatele do fronty, i když celkový new_users_per_minute hodnota dosažená za danou minutu není naplněna.
Chcete-li zabránit tomu, aby čekárna aktivně řadila uživatele do fronty, zvyšte hodnoty pro new_users_per_minute a/nebo total_active_users. Další informace o tom, jak Waiting Room rozhoduje o řazení do fronty, najdete v blogový příspěvek ↗.