INTEGRITY Dokumentace

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:

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é:
Získat stav čekárny
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:

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é:
Podrobnosti o čekárně
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á:

Hodnota queue_all určuje, zda je veškerý provoz nucen čekat ve frontě v čekárně:

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 ↗.