バックエンドとデータ
ログとエラー
管理 → ログで、アプリのバックエンドで起きていることを確認できます。公開中のアプリとプレビューのエラーを見て直す方法や、公開したサイトが動かなくなったときの通知についても説明します。
ときには、うまくいかないこともあります。ページが表示されなくなったり、キーが使えなくなったり、データに思いがけない変化が起きたりします。このページでは、どこを見ればよいか、そしてコードを読まなくても問題を直してもらう方法を説明します。
管理 → ログ
管理タブを開いて、ログを選びます。アプリが自分でエラーを報告する設定になっている場合は、2つのタブが表示されます。最初に開くのがあなたのアプリです(公開中のアプリのエラーをご覧ください)。もうひとつはアクティビティです。
アクティビティは、アプリのバックエンドで起きたことの記録で、新しいものが上に並びます。たとえば、次のようなときに記録が追加されます。
- AIがアプリ用のテーブルを作ったとき
- SQLエディタでクエリが実行されたとき
- シークレットが追加、変更、削除されたとき
- ストレージでフォルダが作られたとき、またはファイルやフォルダが削除されたとき
- データを巻き戻したとき、またはバックアップから戻したとき
- クレジットが足りなくなったために、アプリのデータベースや公開ページが一時停止されたとき、そして再開されたとき
それぞれの記録には、起きた時刻(今日より前のものは日付も)、レベル(情報、警告、エラー、デバッグ)、どこから出たものか、短いメッセージが表示されます。くわしい内容がある記録は、クリックすると詳細を見られます。
ログを絞り込む・追いかける
- メッセージを検索… に言葉を入力すると、その言葉を含む記録を探せます。
- 過去1時間、過去24時間、過去7日で、期間を選べます。
- すべて、情報、警告、エラー、デバッグで、レベルごとに絞り込めます。問題だけを見たいときはエラーを選びます。
- ライブにすると、新しい記録が発生するたびに追加されます。リストを動かしたくないときはクリックして一時停止中に切り替え、もう一度クリックすると再開します。更新ボタンを押すと、リストを読み込み直します。
選んだ期間に何も起きていなければ、この期間のログはありませんと表示されます。
ログに残るのはバックエンドの動きで、アプリへのアクセスすべてが残るわけではありません。公開中のアプリに誰が訪れているかを知りたいときは、アナリティクスを使ってください。
ビルド中のエラー
ほとんどの問題は、ビルド中にプレビューで見つかります。
- プレビューでエラーが起きました。 ページが正しく表示されなかったという意味です。直すをクリックすると、AIが修復のビルドを実行します。ほかのビルドと同じようにクレジットを使います。チャットで困っていることを伝えても大丈夫です。
- 動くけれど、思っていた動きと違う。 目に見えていることと、本来こうなってほしいことを伝えてください。具体的であるほど、うまくいきます。
授業のページで「今すぐ予約」を押しても何も起きません。予約を保存して、確認メッセージを表示してほしいです。
アプリにエラーメッセージが出ているときは、それをそのままチャットに貼り付けてください。AIが正確な文言から原因を探せます。
Buildliyは、ビルドのたびにアプリをチェックして、表示されないページがあれば修復を試みてから、あなたに引き渡します。くわしくはビルドのチェックのしくみをご覧ください。
公開中のアプリのエラー
新しいアプリは、自分のエラーを管理 → ログに報告します。報告されるのは、アプリのサーバーで起きた問題と、訪問者のブラウザで起きたエラーです。報告するのは公開したアプリだけで、プレビューは対象外です。そのため、エラーが表示され始めるのは公開したあとになります。エラー報告が追加される前に公開したアプリは、もう一度公開してください。
管理 → ログを開いて、あなたのアプリを選びます。エラーごとに1枚のカードが表示されます。
- エラーまたは警告と、エラーのメッセージ。
- 選んだ期間に何回起きたか(たとえば「12回発生しました」)、最後に起きた時刻、起きたページ、そしてサーバー側で起きたのか訪問者のブラウザ上で起きたのか。
- 詳細を表示で、技術的な詳細(ある場合)。
上部で過去24時間、過去7日間、過去14日間から選べます。同じエラーがまた起きたときは、新しいカードが増えるのではなく、そのカードの回数に加えられます。このタブを開いている間、リストは自動で更新されます。
直すをクリックすると、そのエラーを直してほしいという依頼が、エラーの詳細つきでチャット欄に入ります。内容を確認して送信を押すまでは、何も送られません。送信すると通常のビルドが実行されてクレジットを使い、直した内容は、もう一度公開したときに公開中のサイトに反映されます。
エラー報告そのものにはクレジットはかかりません。タブにも書かれているとおり、「訪問者のメールアドレス、パスワード、キー、トークンは、保存される前に隠されます。エラーは14日間保存されます。あなたとチームメンバーが見られます。」報告には、訪問者のリクエストと一緒に送られたフォームのデータやCookieは含まれません。ページのアドレスも、「?」より後ろの部分を除いて保存されます。
以前に作ったアプリの場合は、AIにエラー報告の追加を頼んでから、もう一度公開してください。
公開中のアプリのエラーが「管理 → ログ」に表示されるように、エラー報告を設定してください。
公開中のサイトのヘルスチェック
アプリを公開すると、Buildliyは1時間ごとに公開中のサイトをチェックします。チェックのたびに、ホームページと、アプリのほかのページを最大2つ読み込みます(ログイン、アカウント、管理者のページなどは対象外です)。
2回続けてチェックに失敗すると、その問題について1回だけ通知が届きます。
- チャットで、公開中のサイトに問題がありますというタイトルのカードが表示されます。何が起きたか、いつ最初に気づいたか、そして「1時間ごとに確認しています。」と書かれています。
- メールで、件名「公開中のサイトに問題があります」のメールが届きます。
カードでは、次のことができます。
- 詳細を見るをクリックすると、サイトのアドレス、失敗したページ、チェックしたページ、最後にチェックした時刻を確認できます。
- 直すをクリックすると、AIに原因を探して直してもらえます。通常のビルドが実行されるので、クレジットを使います。直した内容は、もう一度公開したときに公開中のサイトに反映されます。
- 隠すをクリックすると、カードを閉じます。
サイトが元どおり動くようになると、チャットに「公開中のサイトが復旧しました。」と短く表示されます。問題についてメールが届いていた場合は、「公開中のサイトが復旧しました」というメールも届きます。公開タブ(ワークスペースメニュー → 公開)にも、「公開中のサイト: 正常 · 20分前に確認」のように最新の結果が表示されます。
ひとつの問題につき、問題のメールと「復旧しました」のメールは、それぞれ最大1通ずつです。止まったり動いたりを繰り返すサイトからメールが大量に届かないように、Buildliyは、そのアプリについて最後に公開中のサイトのメールを送ってから1日以内は、新しい問題のメールを送りません。1日たっても問題が続いていれば、そのときにメールが届きます。チャットのカードには、すべての問題が表示されます。
クレジットが足りなくなってサイトが一時停止されている場合、カードには一時停止中であることが表示され、直すは表示されません。ビルドし直しても、一時停止されたサイトは再開しないからです。クレジットを追加すると、自動で元に戻ります。クレジットと利用状況をご覧ください。
助けが必要なとき
AIが何度か試しても問題を直せないときは、よくある原因と次の手順を問題を解決するで確認するか、ヘルプを見るからチームに連絡してください。