ログ:ビルドとサイトへのリクエスト
ログには、いつ何が起きたかが残ります。プロジェクトのすべてのビルドと公開、そして直近1日にサイト独自のコードを実行したすべてのリクエストです。フォーム、定期タスク、ページの動作がおかしい理由を調べるときに使います。
2種類のログ
| 表示 | 表示される内容 | どこまでさかのぼるか |
|---|---|---|
| Builds | このプロジェクトのすべてのビルド、変更、公開と、それぞれが経たステップです。 | 最新の40件 |
| Requests | サイトへのリクエストとエラーを、新しい順に表示します。 | 過去24時間分を、一度に最大100件まで |
定期タスクとWebhookには、それぞれ30日間保存される専用のログがあります。定期タスクの Runs と、Webhookの Deliveries です。フォームから送信されたメッセージは Settings、Forms に保存されます。
ビルド
各項目には、依頼内容(依頼の文言のまま)、依頼した人、日時、かかった時間が表示されます。人が開始したものでない場合は、Briksと表示されます。右側にはステータスが表示されます:
| ステータス | 意味 |
|---|---|
| Waiting | ほかの作業の後ろで待機中です。 |
| Running | 現在進行中です。 |
| Done | 完了しました。 |
| Failed | 最後まで終わらずに止まりました。 |
| Stopped | 完了する前に停止されました。 |
項目をクリックすると、各ステップとその発生時刻が表示されます。うまくいかなかったステップは赤で表示されます。失敗した項目の最後には「It did not finish. Nothing on the live site changed, and no credits were charged for it.」と表示されます。
同じ作業をプレビューを横に見ながらリアルタイムで確認したい場合は、スタジオを使ってください。ビルドを見守るをご覧ください。
リクエスト
Requests には、サイト独自のコードが動いた呼び出しが表示されます。具体的には、/api ルートへのアクセスと、A/Bテストで訪問者を2つのバージョンに振り分けている間のページ訪問です。通常のページ、画像、ファイルはそのまま配信されるため、表示されません。お問い合わせフォームから送られたメッセージも表示されません。これらはサイトのコードを通さず、直接 Briks に届くためです。
各行には、時刻、メソッドとパス（GETは何かを求め、POSTは何かを送ります）、かかった時間（ミリ秒）、サイトが返したステータス（返答がない場合もあります）が表示されます。サイトのコード自身が書いた行には、メッセージと、errorやwarningなどのレベルが表示されます。行をクリックすると、メッセージ全文、日付、リクエストIDが見られます。
| ステータス | 意味 |
|---|---|
| 200などの2xx | うまくいきました。 |
| 4xx(400や404など) | リクエストは受け付けられませんでした。内容に不足や誤りがあるか、そのパスに何も存在しません。 |
| 500などの5xx | サイトのコードが応答中に失敗しました。 |
フィルター
| フィルター | 選択肢 | できること |
|---|---|---|
| Search | 任意の語句:パス、メッセージ、リクエストID | 1つのルートや1つのエラーを探します。 |
| Level | All levels、Errors、Warnings | コードが報告した問題だけを表示します。 |
| Status | Any status、Succeeded、4xx、5xx | 拒否または失敗したリクエストだけを表示します。 |
条件を設定してShowを押してください。ページのアドレスに条件が残るので、絞り込んだ表示をブックマークできます。No requests in the last dayは、24時間のあいだサイトのコードが一度も実行されなかったという意味です。ページにLogs cannot be read right nowと出たら、1分ほど待ってからもう一度お試しください。
失敗するフォームを診断する
エントリーを探す
場所: Settings, Forms
訪問者が送ったメッセージはすべてここに保管され、画面には最新の100件が表示されます。それぞれに、届いた日時と送信元のページ、そしてemailed、not emailed、previewのいずれかが表示されます。
メール送信済みと表示されたのに届かないとき
場所: Your inbox
エントリーは、プロジェクトを作成した人に届きます。その人が退会している場合は、ワークスペースの最初のOwnerに届きます。迷惑メールフォルダーも含めて、その受信箱を確認してください。
まったく見つからない場合
場所: The live site
メッセージがBriksに届きませんでした。ご自身で送信してください。ここから送られたメッセージが多すぎるとフォームに表示された場合は、上限に達しています。上限は、1人の訪問者につき10分間で5件まで、サイト全体で1日300件までです。
ほかのツールに必要な場合
場所: Settings, Webhooks, Deliveries
Status を Failed にして Show を押します。配信を開いて相手のツールの応答を確認し、問題を直したら Send again を押してください。
失敗する定期タスクの原因を調べる
実行内容を読む
場所: Settings, Scheduled tasks, Runs
失敗した実行を開きます。たとえば「answered 500」のように、アドレスが返した応答と、その冒頭部分が表示されます。
エラーを見つける
場所: Settings, Logs, Requests
タスクがサイト上のルートを呼び出す場合は、
/api/daily-summaryのようなそのパスを検索し、Level を Errors にします。メッセージには、コードのどこで問題が起きたかが表示されます。もう一度試す
場所: Settings, Scheduled tasks
修正が公開されたら、タスクの三つの点を開いて Run now を選びます。結果はすぐに表示されます。
Skipped と表示された実行は失敗ではありません。そのプロジェクトのその日の呼び出し回数を使い切ったということです。実行は UTC の午前0時を過ぎると再開します。プランごとの上限は定期タスクのページにあります。
表示が遅いページを診断する
Requests は、サイトのコードを動かす処理すべての時間を計測します。サイトのルートから内容を読み込むページが遅いと感じるときは、ここを見てください。アプリやダッシュボードは、たいていこの方式で動きます。
ページを開いて時刻を控えましょう
場所: The live site
遅いページを一度ご自身で読み込んでおくと、そのリクエストが最新のものに含まれます。
所要時間を確認する
場所: Settings, Logs, Requests
そのときに行われた各リクエストの横にあるミリ秒を見てください。ほかが数百ミリ秒なのに、1つのルートだけが数秒かかっていれば、それが原因です。
絞り込む
場所: Settings, Logs, Requests
そのルートのパスを検索して、常に遅いのか、時々だけ遅いのか、そして隣にWarningsやErrorsが表示されていないかを確認します。
修正を依頼する
場所: Studio
どのルートが、どのくらい遅いのか、そのルートが表示するページとあわせてスタジオに伝えてください。
遅い項目が見つからなければ、遅延の原因はサイトのコードではありません。ページ、画像、ファイルはそのまま配信されるため、大きな画像や動画など、ページの中身を確認し、遅いと感じる点をスタジオで伝えてください。
実例: 保存されなくなった予約アプリ
午前中から新しい予約が1件も入っていませんでしたが、フォームが反応しないという電話は鳴り続けていました。
Requests で Status を 5xx にすると、9:12以降の POST /api/bookings がすべて500で応答していました。その横のエラー行には、必須項目が足りないと表示されていました。
今朝から、/api/bookings で予約がすべて500エラーになります。ログには、ペットのサイズの項目がないと出ています。この項目は昨日、フォームから削除しました。
変更が公開され、Requests の次の予約は 200 を返しました。