로그: 빌드와 사이트 요청
로그는 무슨 일이 언제 있었는지 알려줘요. 프로젝트의 모든 빌드와 게시, 그리고 지난 하루 동안 사이트 자체 코드를 실행한 모든 요청이 담겨 있어요. 폼, 예약 작업, 페이지가 왜 제대로 동작하지 않는지 파악할 때 쓰세요.
두 가지 로그
| 보기 | 보여 주는 내용 | 얼마나 이전까지 |
|---|---|---|
| Builds | 이 프로젝트의 모든 제작, 변경, 게시와 각각이 거친 단계예요. | 최근 40개 |
| Requests | 사이트에 들어온 요청과 오류를 최신순으로 보여 줘요. | 최근 24시간, 한 번에 최대 100개 |
예약 작업과 웹훅은 각자의 로그를 30일 동안 보관해요. 예약 작업의 Runs와 웹훅의 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 테스트가 방문자를 두 버전으로 나눌 때의 페이지 방문이 해당돼요. 일반 페이지, 사진, 파일은 있는 그대로 제공되므로 나타나지 않아요. 문의 양식으로 보낸 메시지도 나타나지 않아요. 사이트 코드를 거치지 않고 곧바로 Briks로 가기 때문이에요.
각 줄에는 시간, 메서드와 경로(GET은 요청, POST는 전송), 걸린 시간(밀리초), 사이트가 응답한 상태가 표시돼요. 응답이 없으면 없는 대로 표시돼요. 사이트 코드가 직접 남긴 줄에는 메시지와 error, warning 같은 수준이 함께 나와요. 줄을 클릭하면 전체 메시지, 날짜, 요청 ID를 볼 수 있어요.
| 상태 | 무슨 뜻인가요 |
|---|---|
| 2xx, 예: 200 | 성공했어요. |
| 400이나 404 같은 4xx | 요청이 거부되었어요. 요청에 빠졌거나 잘못된 내용이 있거나, 해당 경로에 아무것도 없어요. |
| 500 같은 5xx | 사이트 코드가 응답하는 중에 실패했어요. |
필터
| 필터 | 선택지 | 이럴 때 쓰세요 |
|---|---|---|
| Search | 경로, 메시지, 요청 ID 등 아무 단어 | 경로 하나나 오류 하나를 찾아보세요. |
| 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가 보이면 잠시 후 다시 시도하세요.
오류가 나는 폼 진단하기
항목을 찾아보세요
위치: Settings, Forms
방문자가 보낸 모든 메시지가 여기에 보관되며, 화면에는 최근 100개가 보여요. 각 메시지에는 도착한 시각과 페이지, 그리고 emailed, not emailed 또는 preview가 표시돼요.
이메일로 보냈다고 나오는데 아무것도 도착하지 않았다면
위치: Your inbox
문의 내용은 프로젝트를 만든 사람에게 전달돼요. 그 사람이 떠났다면 워크스페이스의 첫 번째 Owner에게 전달돼요. 스팸 메일함까지 포함해서 해당 받은편지함을 확인해 보세요.
아예 보이지 않는다면
위치: The live site
메시지가 Briks에 전달되지 않았어요. 직접 보내 주세요. 여기서 너무 많은 메시지를 보냈다고 양식이 알려 주면 한도에 도달한 거예요. 방문자 한 명당 10분에 최대 5개, 사이트 전체로는 하루 최대 300개예요.
다른 도구에서 필요하다면
위치: Settings, Webhooks, Deliveries
Status를 Failed로 설정하고 Show를 누르세요. 전송 건을 열어 상대 도구의 응답을 읽고, 고친 뒤 Send again을 누르세요.
실패하는 예약 작업 진단하기
실행 내용 읽기
위치: Settings, Scheduled tasks, Runs
실패한 실행을 열어 보세요. 주소가 답한 내용, 예를 들어 answered 500과 응답의 첫 부분이 나와요.
오류 찾기
위치: Settings, Logs, Requests
작업이 사이트의 경로를 호출한다면
/api/daily-summary같은 경로를 검색하고 Level을 Errors로 설정하세요. 메시지에 코드에서 무엇이 잘못됐는지 나와요.고쳐 달라고 요청하기
위치: Studio
오류를 스튜디오 채팅에 붙여 넣고 작업에 대한 한 문장을 함께 적으세요: 매일 아침 일일 요약 경로가 이 오류로 실패해요. 변경하기를 참고하세요.
다시 시도하세요
위치: Settings, Scheduled tasks
수정이 게시되면 작업의 점 세 개를 열고 Run now를 선택하세요. 결과가 바로 나타나요.
Skipped로 표시된 실행은 실패한 게 아니에요. 프로젝트의 하루 호출 수를 모두 썼다는 뜻이에요. 자정(UTC)이 지나면 실행이 다시 시작돼요. 요금제별 한도는 예약 작업 페이지에 있어요.
느린 페이지 진단하기
Requests는 사이트의 코드를 실행하는 모든 작업의 시간을 보여줘요. 사이트의 경로에서 콘텐츠를 불러오는 페이지가 느리게 느껴질 때 살펴볼 곳이에요. 앱과 대시보드는 보통 이런 방식으로 동작해요.
페이지를 열고 시간을 적어 두세요
위치: The live site
느린 페이지를 직접 한 번 불러와서, 그 요청이 가장 최근 기록에 들어가게 하세요.
소요 시간 보기
위치: Settings, Logs, Requests
그 시간에 이루어진 각 요청 옆의 밀리초를 보세요. 다른 경로는 수백 밀리초인데 한 경로만 몇 초 걸린다면 그곳이 원인이에요.
범위 좁히기
위치: Settings, Logs, Requests
그 라우트의 경로를 검색해서 항상 느린지 가끔만 느린지, 그 옆에 Warnings나 Errors가 나타나는지 확인하세요.
수정 요청하기
위치: Studio
어느 경로가 얼마나 느린지, 그 경로가 보여주는 페이지와 함께 스튜디오에 알려 주세요.
느린 부분이 보이지 않는다면 지연의 원인은 사이트 코드가 아니에요. 페이지, 사진, 파일은 있는 그대로 제공되니, 큰 사진이나 영상처럼 페이지가 담고 있는 것을 살펴보고, 느리게 느껴지는 부분을 스튜디오에서 설명해 주세요.
실제 예시: 저장되지 않게 된 예약 앱
아침 이후 새 예약이 들어오지 않았는데, 양식이 작동하지 않는다는 전화는 계속 걸려 왔어요.
Requests에서 Status를 5xx로 설정하면, 9:12 이후의 POST /api/bookings 요청이 모두 500으로 응답한 것을 볼 수 있어요. 옆의 오류 줄에는 필수 항목이 빠졌다고 적혀 있었어요.
오늘 아침부터 모든 예약이 /api/bookings에서 500 오류로 실패해요. 로그에는 반려동물 크기 필드가 없다고 나와요. 어제 폼에서 그 필드를 뺐거든요.
변경 사항이 게시됐고, Requests의 다음 예약은 200으로 응답했어요.