백엔드와 데이터
로그와 오류
관리 → 로그에서 앱 백엔드에서 일어나는 일을 확인하고, 게시된 앱과 미리보기의 오류를 보고 고치세요. 게시한 사이트가 작동을 멈추면 알림도 받을 수 있어요.
가끔 문제가 생길 수 있어요. 페이지가 열리지 않거나, 키가 작동하지 않거나, 데이터가 예상과 다르게 바뀌기도 해요. 이 페이지에서는 어디를 보면 되는지, 코드를 읽지 않고도 문제를 해결하는 방법을 알려 드려요.
관리 → 로그
관리 탭을 열고 로그를 선택하세요. 앱이 자체 오류를 보고하는 경우에는 탭이 두 개 보여요. 먼저 열리는 내 앱(게시된 앱의 오류 참고)과 활동이에요.
활동은 앱 백엔드에서 일어난 일을 최신순으로 쌓아 둔 기록이에요. 예를 들어 이런 일이 있을 때 기록이 남아요.
- AI가 앱에 테이블을 만들었을 때
- SQL 편집기에서 쿼리를 실행했을 때
- 비밀 값을 추가하거나 바꾸거나 삭제했을 때
- Storage에서 폴더를 만들었거나, 파일과 폴더를 삭제했을 때
- 데이터를 되감았거나 백업에서 다시 복원했을 때
- 계정의 크레딧이 떨어져서 앱의 데이터베이스나 게시한 페이지가 일시중지되었을 때, 그리고 다시 시작되었을 때
각 기록에는 일어난 시각(오늘 이전이면 날짜도 함께), 수준(정보, 경고, 오류, 디버그), 어디에서 났는지, 짧은 메시지가 표시돼요. 기록을 클릭하면 자세한 내용이 있는 경우 더 볼 수 있어요.
로그 걸러서 보고 따라가기
- 메시지 검색…에 입력한 단어가 들어 있는 기록을 찾아 줘요.
- 최근 1시간, 최근 24시간, 최근 7일로 기간을 정해요.
- 전체, 정보, 경고, 오류, 디버그로 수준별로 걸러 볼 수 있어요. 문제만 보고 싶다면 오류를 고르세요.
- 실시간을 켜면 새 기록이 생기는 대로 추가돼요. 목록이 움직이지 않게 하고 싶을 땐 클릭해서 일시정지됨으로 바꾸고, 다시 클릭하면 이어져요. 새로고침 버튼을 누르면 목록을 다시 불러와요.
고른 기간에 아무 일도 없었다면 이 기간에는 로그가 없어요라고 표시돼요.
로그에는 백엔드에서 일어난 일이 기록되고, 앱에 누가 들어왔는지까지 모두 기록되지는 않아요. 게시된 앱의 방문자를 보려면 애널리틱스를 이용하세요.
만드는 중에 생기는 오류
대부분의 문제는 앱을 만드는 동안 미리보기에서 나타나요.
- 미리보기에 문제가 생겼어요. 페이지가 제대로 열리지 않았다는 뜻이에요. 고치기를 클릭하면 AI가 복구 빌드를 실행해요. 다른 빌드와 똑같이 크레딧이 들어요. 아니면 채팅에 무엇이 잘못됐는지 직접 설명해도 돼요.
- 작동은 하는데 원하는 방식이 아니에요. 지금 보이는 모습과 원했던 모습을 설명해 주세요. 구체적일수록 좋아요.
수업 페이지에서 "지금 예약하기"를 눌러도 아무 일도 일어나지 않아요. 예약이 저장되고 확인 화면이 나와야 해요.
앱에 오류 메시지가 보이면 그대로 복사해서 채팅에 붙여 넣으세요. AI가 정확한 문구를 보고 원인을 찾을 수 있어요.
Buildliy는 빌드할 때마다 앱을 확인하고, 열리지 않는 페이지가 있으면 직접 고쳐 보고 나서 돌려드려요. 빌드 확인 방식을 참고하세요.
게시된 앱의 오류
새 앱은 자체 오류를 관리 → 로그에 보고해요. 앱 서버에서 생긴 문제와 방문자의 브라우저에서 생긴 오류가 모두 해당돼요. 미리보기가 아니라 게시한 앱만 보고하기 때문에, 오류는 게시한 뒤부터 나타나기 시작해요. 오류 보고 기능이 추가되기 전에 게시했다면 다시 게시하세요.
관리 → 로그를 열고 내 앱을 선택하세요. 오류마다 카드가 하나씩 있어요.
- 오류 또는 경고, 그리고 오류 메시지
- 고른 기간에 몇 번 일어났는지(예: "12번 발생했어요"), 마지막으로 일어난 때, 일어난 페이지, 그리고 서버에서 일어났는지 방문자의 브라우저에서 일어났는지
- 기술적인 세부 내용이 있다면 볼 수 있는 자세히 보기
위쪽에서 최근 24시간, 최근 7일, 최근 14일 중에서 고르세요. 같은 오류가 다시 일어나면 새 카드가 생기지 않고 기존 카드에 횟수로 더해져요. 목록을 열어 두면 저절로 새로고침돼요.
고치기를 클릭하면 그 오류를 고쳐 달라는 요청이 오류의 세부 내용과 함께 채팅창에 입력돼요. 내용을 확인하고 보내기를 누르기 전에는 아무것도 전송되지 않아요. 전송하면 일반 빌드가 실행되어 크레딧이 들고, 고친 내용은 다시 게시해야 게시된 사이트에 반영돼요.
오류 보고에는 크레딧이 들지 않아요. 탭에 적힌 그대로, "방문자의 이메일, 비밀번호, 키, 토큰은 저장되기 전에 가려져요. 오류는 14일 동안 보관돼요. 나와 팀원들이 볼 수 있어요." 방문자의 요청과 함께 전송된 양식 데이터나 쿠키는 보고에 절대 포함되지 않고, 페이지 주소에서 "?" 뒤에 오는 부분은 빼고 저장돼요.
예전에 만든 앱이라면 AI에게 오류 보고를 추가해 달라고 한 다음 다시 게시하세요.
게시된 앱의 오류가 관리 → 로그에 보이도록 오류 보고를 설정해 주세요.
게시된 사이트 상태 확인
앱을 게시하면 Buildliy가 1시간마다 게시된 사이트를 확인해요. 확인할 때마다 홈페이지와, 앱의 다른 페이지 최대 두 개를 열어 봐요(로그인, 계정, 관리자 페이지 같은 곳은 건너뛰어요).
연달아 두 번 실패하면 Buildliy가 그 문제에 대해 한 번 알려 드려요.
- 채팅에서 게시한 사이트에 문제가 있어요라는 제목의 카드로 알려요. 무엇이 잘못됐는지, 처음 언제 알아챘는지, 그리고 "저는 1시간마다 확인해요."라는 문구가 담겨 있어요.
- 이메일로 "게시된 사이트에 문제가 있어요"라는 제목으로 알려요.
카드에서는 이런 일을 할 수 있어요.
- 자세히 보기를 클릭하면 사이트 주소, 실패한 페이지, 확인한 페이지, 마지막으로 확인한 시각을 볼 수 있어요.
- 고치기를 클릭하면 AI에게 원인을 찾아 고쳐 달라고 요청해요. 일반 빌드가 실행되므로 크레딧이 들어요. 고친 내용은 다시 게시해야 게시된 사이트에 반영돼요.
- 숨기기를 클릭하면 카드를 닫아요.
사이트가 다시 정상으로 돌아오면 채팅에 "게시한 사이트가 다시 열려요."라는 짧은 안내가 나와요. 문제에 대해 이메일을 받았다면 "게시된 사이트가 다시 정상이에요"라는 제목의 이메일도 받아요. 출시 탭(워크스페이스 메뉴 → 출시)에서도 "게시된 사이트: 정상 · 20분 전에 확인"처럼 가장 최근 결과를 볼 수 있어요.
문제 하나당 문제 이메일은 최대 한 번, "다시 정상" 이메일도 최대 한 번만 받아요. 계속 접속이 끊기는 사이트 때문에 이메일이 쏟아지지 않도록, Buildliy는 그 앱에 대해 마지막으로 보낸 게시된 사이트 이메일 이후 하루 안에는 새 문제 이메일을 보내지 않아요. 그 뒤에도 문제가 그대로라면 그때 이메일이 가요. 채팅 카드에는 모든 문제가 표시돼요.
계정의 크레딧이 떨어져서 사이트가 일시중지된 경우에는, 카드에 사이트가 일시중지되었다고 나오고 고치기는 보이지 않아요. 다시 빌드해도 일시중지된 사이트가 다시 켜지지는 않기 때문이에요. 크레딧을 충전하면 저절로 다시 열려요. 크레딧과 사용량을 참고하세요.
도움이 필요할 때
AI가 몇 번 시도해도 문제를 고치지 못한다면, 흔한 원인과 다음 단계는 문제 해결에서, 팀에 문의하려면 도움 받기에서 확인하세요.