リクエスト上限超過をルーティングの二重起動から切り分ける
今回やったこと
Workers と Pages Functions の日次リクエストを合算した値が上限を超えたとき、アクセスを一律に bot と決めつけず、同じ閲覧が複数の実行枠を消費していないかを調べた。2026年8月26日UTCの集計では、合計110,176件となり、Workers Free の日次100,000件を超過していた。Cloudflareの公式ドキュメントによれば、Pages Functions のリクエストは Workers Free の枠に合算して数えられ、日次枠は UTC 0時にリセットされる。したがってこの合計は、両者に共通する1つの日次枠に対する消費量である。原因の中心は、旧記事URLへのアクセスを処理する Worker が Pages へ subrequest を送る一方で、Functions 側も同じパスで起動していたことだった。
この記録は、当時のPull Requestの記載(Cloudflare GraphQL Analyticsによる2026-08-26 UTCの実測)と、Pages Functionsミドルウェアおよびルート設定に残したコメントに基づく。集計値だけを見て料金プランを上げたり、利用者の User-Agent を遮断したりする前に、リクエストの経路を分解した事例である。
合計値の内訳を見る
Analytics上、Workers と Pages Functions は別々の系列として数えられるが、Free プランの日次枠は共有される。旧記事のパスを受けた Worker が Pages に問い合わせ、そのリクエストが Functions の対象にも含まれていれば、利用者から見た1回のアクセスが複数の実行として現れる。合計値だけでは、実際の閲覧が増えたのか、内部の転送が重複して計上されたのかを区別できない。
当日の消費元は次のとおりで、旧記事ルーターと Pages Functions の2系列で大半を占めていた(通常日の8月25日は合計54,257件)。
| 消費元 | 2026-08-26 | 2026-08-25 |
|---|---|---|
| Pages Functions(対象サイト) | 64,948件 | 38,623件 |
| 旧記事ルーター(Worker) | 42,258件 | 12,138件 |
| コメントAPIなど他のWorker | 約2,200件 | 約2,200件 |
| 合計 | 110,176件 | 54,257件 |
時間別の件数は両者で相関しており、相関係数は0.77(0.769)だった。ただし日内変動は両者に共通して現れるため、この値は因果関係を示さず、二重起動を疑う手がかりにとどまる。決め手はコード上の経路である。旧記事ルーターは Pages を呼ぶ前に必ず subrequest を送る実装で、その subrequest が Functions の起動対象に含まれていた。ミドルウェアのコメントには、旧記事処理が Pages へ subrequest を出す構造と、1アクセスで Worker と Function の両方が消費される問題が記録されている。
調査では、他の大きな数値もそのまま「無駄」とは扱わなかった。集計によると、early hints を名乗るUser-Agentの20,205件はすべて504で、Workerには到達していなかった。これはゾーン側の /archives/* の件数63,465件には含まれるが、そこから差し引くと43,260件となり、Workerの実起動42,254件とほぼ一致する。つまり Early Hints は Workers の消費に含まれず、削減対象にならない。Safariの13,453件は、ゾーン側で数えたUser-Agent別の件数で、Workerに届いた分に含まれる実読者のアクセスである。5記事に集中し、全件HTTP 200・日本国内発だったため、実読者と判断した。User-Agent を理由にSafariを遮断するのではなく、経路と応答を見て原因を分けた。botとして副作用なく落とせると切り分けられたのは1日4,241件だった。
起動範囲を狭めて確かめる
修正では、Functions の対象を指定する _routes.json の exclude に /archives/* を追加した。現在の設定は include: ["/*"] に対して、/archives/* を明示的に除外している。ミドルウェアにも、旧記事ルーターが Pages に問い合わせるため二重に枠を使っていたこと、除外を外すと日次枠を消費することがコメントとして残っている。
{
"include": ["/*"],
"exclude": [
"/archives/*",
"/_astro/*",
"/img/*"
]
}
この変更は「Functionsを全体停止する」のではなく、静的な旧記事解決に必要のない起動だけを避ける考え方である。ルート設定と実際のミドルウェアを照合し、除外後も必要な経路が残るかを確認する。設定ファイルだけを直して終わりにせず、Analyticsで変更前後のWorkersとFunctionsの数字を別々に見ると、二重起動の解消とアクセス減少を取り違えにくい。
修正後の見込みとして、上限超過日は約67,900件、通常日は約42,000件と、当時のPull Requestに試算が記録されている(実測ではなく、内訳から差し引いた見積もり)。これは当時の集計にもとづく見込みであり、現在の負荷を保証する数値ではない。実際に採用する際は、同じ期間幅、同じルート定義、同じ集計条件で再計測する必要がある。
やってみてわかったこと
リクエスト上限に近づいたときは、ユーザー種別を先に疑うよりも、1回の操作がどの実行環境を何度通るかを図にする方が対処を絞りやすい。合算値の増加が二重起動なら、利用者を止めずにルーティングだけを直せる可能性がある。一方、相関だけで原因を断定することはできず、コード上の転送経路と変更後の計測を合わせる必要がある。
判断の順序は、サービス別のカウントを分離する、時間別に動きを比べる、コードで subrequest と起動条件を確認する、対象パスだけ除外して再計測する、となる。今回のように実読者と内部転送が混じる状況では、単一の User-Agent や総数を遮断条件にしないことが、利用者への副作用を避ける助けになる。
更新履歴
- 2026-09-29: 起稿。測定値は対象日を明記。
- 2026-11-14: 公開後レビューの指摘を受けて、Workers と Pages Functions が日次枠を共有することの公式ドキュメント上の根拠、消費元の内訳、Early Hints・Safariの件数がどの集計に属するかを補足。「別々に数えられる」の表現を、枠は共有であることが分かる形に訂正。