コンテンツにスキップ

待機室のステータスを監視する

待機室のステータスは、ダッシュボードまたはAPIを使用して監視できます。

ダッシュボードに表示されるアクティブユーザーの合計およびキューに入っているユーザーは推定値であることに注意してください。これらのメトリックに対応するデータは、全データセンターから同期されるのにかかる時間の約30秒後にキャッシュされます。したがって、ステータスは、データがクエリされ、集計され、キャッシュの年齢に応じて、過去20〜50秒の範囲になります。

待機室を通過するトラフィックの詳細については、待機室分析を参照してください。

ダッシュボードでのステータス

待機室ダッシュボードを開いて、待機室のリストを表示します。

ステータス列には、待機室の現在の状態が表示されます:

  • キューに入っていない:
    • 待機室は有効ですが、訪問者を待機室に送るためのトラフィック閾値に達していません。
    • アプリケーション内の推定ユーザー数を表示します。
  • キューに入っている:
    • 待機室は有効で、訪問者を待機室に送っています。
    • キューに入っているユーザーの推定数を表示します。
    • ホバーすると、ユーザーの最大待機時間が表示されます。
  • 無効: 待機室は一時停止されています。
  • すべてキュー:
    • すべてのトラフィックを待機室にキューに入れることを強制します。
    • ホバーすると、キューに入っているユーザーの推定数が表示されます。

APIでのステータス

次のエンドポイントをCloudflare APIのベースURLに追加して、構成された待機室でトラフィックがキューに入っているかどうかを確認します:

Terminal window
GET zones/{zone_identifier}/waiting_rooms/{identifier}/status

レスポンスは次の通りです:

  • 訪問者が現在待機室にキューに入っている場合はqueueing
  • 部屋が空であるか、待機室が一時停止されている場合はnot_queueing

構成された待機室が一時停止されているか、トラフィックが待機室に強制的にキューに入れられているかを確認するには、次のエンドポイントをCloudflare APIのベースURLに追加します。

Terminal window
GET zones/{zone_identifier}/waiting_rooms/{identifier}

上記のエンドポイントは、構成された待機室のすべての設定を取得します:

Terminal window
"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": "ウェブショップの待機室",
"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}} 分 {{/waitTimeKnown}} {{^waitTimeKnown}} すべてキューが有効 {{/waitTimeKnown}}"
}

suspendedの値は、待機室がアクティブか一時停止されているかを示します:

  • false: 待機室はアクティブです。
  • true: 待機室は一時停止されています。

queue_allの値は、すべてのトラフィックが待機室に強制的にキューに入れられるかどうかを示します:

  • false: 訪問者は、トラフィックが設定された閾値を超えた場合にのみ待機室に誘導されます。
  • true: すべてのトラフィックが待機室に強制的にキューに入れられ、待機室からオリジンにトラフィックが通過しません。

キューのアクティベーション

待機室は、スケーラビリティを向上させるためにデータセンターのレベルでトラフィックをキューに入れ、各データセンターが独立して意思決定を行えるようにします。

この設計のため、待機室の設定されたトラフィック制限は、待機室がトラフィック量を近くに保つために作業するターゲット値です。待機室は、new_users_per_minuteまたはtotal_active_usersの制限に達する前に、特定のデータセンターからのトラフィックをキューに入れることがあります。

待機室は、各分の間に入るユーザーの割合を継続的に監視し、分の終わりだけでなく、分の始まりでも監視します。したがって、分の始まりに設定されたnew_users_per_minuteの大部分がすでに参加している場合、その分の全体のnew_users_per_minuteの値が達成されていなくても、ユーザーをキューに入れ始めることがあります。

待機室がアクティブにキューに入るのを防ぐために、new_users_per_minuteおよび/またはtotal_active_usersの値を増やしてください。待機室がキューに入れる決定をどのように行うかについての詳細は、私たちのブログ記事を確認してください。