公開先でエラーを起こし、ログから原因を見つけて直す
練習用の500エラーを起こし、画面のリクエストIDとCloudflareのログを照合してから、設定を直します。
目次
エラーの原因は、プログラムが動いたときの記録であるログから調べられます。この実習では、練習用のプログラムにわざとエラーを起こし、画面とログを見比べてから設定を直します。
Cloudflare実習の教材を使います。Node.js 24.22.1 / Wrangler 4.158.0、macOSで実行確認しました。WindowsではVS Codeのコマンド入力欄でコマンドプロンプトを選びます。作業フォルダーは emdash-cloudflare-labs です。
操作するのは staging の練習用Workerだけです。自分の本番サイトへ、エラーを起こすコードを入れる必要はありません。
1. 正常な状態を見ておく
ブラウザーで 検証用URLの末尾に /check を付けて開きます。例えば、自分のURLが https://weekend-cf-lab-staging.example.workers.dev なら、その後ろに /check を付けます。example は例なので、自分のURLを使ってください。
{
"ok": true,
"environment": "staging",
"release": "v1"
}実際には他の項目も出ます。ok: true が、正常に処理が終わった印です。
2. 練習用のエラーを有効にする
VS Codeで wrangler.jsonc を開きます。env → staging → vars の中にある、次の設定を探します。
"DEMO_FAILURE": "off"この行の off を on に変えて保存します。production-demo 側は off のままにします。
"DEMO_FAILURE": "on"DEMO_FAILURE はこの教材だけの練習用設定です。CloudflareやEmDashに元からある設定名ではありません。変えた設定を公開先へ送ります。
npx wrangler deploy --env stagingローカルのファイルを保存しただけでは、公開先は変わりません。命令が成功するまで待ってください。
3. ログを見る画面を開く
同じフォルダーのコマンド入力欄で実行します。
npx wrangler tail --env staging --format pretty接続完了の表示が出たら、そのままにしておきます。入力待ちに戻らないのは、公開先から届く記録を待っているためです。
tail では接続後の記録を見ます。先にエラーを起こしてから開いた場合は、次の手順でもう一度ページを読み込んでください。過去の記録を調べるときは、Cloudflareの対象Workerの画面からLogsを確認します。保存期間や記録量は契約・設定によって異なります。
4. 画面とログを照合する
ブラウザーへ戻り、検証用URLの /check を再読み込みします。今度はHTTP 500という失敗の応答になり、本文は次の形になります。
{
"error": "LAB_ERROR",
"requestId": "リクエストごとに変わるID"
}requestId は、今回の1回のアクセスを見分ける番号です。実際には英数字のIDが表示されます。これを控え、コマンド入力欄に戻ります。
lab_error と書かれたログを探すと、同じ requestId と、次のメッセージが見つかります。
DEMO_FAILURE: 練習用のエラーです| ログの項目 | 確かめること |
|---|---|
environment | staging の記録か |
path | 今開いた /check か |
requestId | 画面に出たIDと同じか |
message | 何が原因で失敗したか |
教材のコードは、起きたエラーを受け取り、失敗を示す500の応答を返します。そのため、ログ全体の実行結果だけを見て判断せず、HTTPの状態・lab_error・画面の結果を合わせて確認します。
5. 設定を直し、成功を確認する
ログ表示を Control + C で止めます。wrangler.jsonc の検証用 DEMO_FAILURE を off に戻して保存し、もう一度公開します。
npx wrangler deploy --env staging
npx wrangler tail --env staging --format prettyブラウザーで /check を再読み込みします。ok: true が出て、そのアクセスのログに lab_error がなければ修正できています。本番役URLの /check も開き、こちらは引き続き正常に応答することを確認しましょう。
「設定を直したつもりなのに変わらない」場合は、ファイルを保存したか、deploy が成功したか、開いているURLが検証用か、の順に見直します。
ログに何を残す?
教材の src/worker.js は、環境名・処理したパス・リクエストID・エラーの理由を記録します。秘密情報やCookieの値、送信内容を丸ごと記録する作りにはしていません。
設定ファイルではWorkers Logsを有効にし、処理を追うためのTracesも別に指定しています。Cloudflare公式スキル(別タブで開く)を参考にしていますが、この実習で実際に照合するのは tail のログです。実際のサイトでは、アクセス数と必要な記録量に合わせて、ログを残す割合を決めます。
EmDashで使うときは
EmDashの公開先でログを見るときも、対象のWorkerと環境を選び、失敗した操作を1回再現して調べます。記事の保存なら保存、画像なら画像を開く操作、というように分けると原因を追いやすくなります。
今回の DEMO_FAILURE や requestId の出し方は教材の実装です。EmDash標準でまったく同じメッセージが出るわけではありません。実際のエラー文は、日時・操作・URLとともに控えます。トラブルの切り分けも参照してください。
終了するとき・次回続けるとき
Control + C でログの表示を止めます。公開先のWorkerは動き続けます。次回は tail の命令を再実行してから、対象の操作を行います。
DEMO_FAILURE が off の状態で公開できたら、次の秘密情報の登録へ進めます。