---
title: "로그: 빌드와 사이트 요청 | Briks"
url: https://briks.dev/ko/docs/logs
description: "빌드 로그와 최근 하루의 사이트 요청을 읽고, 수준이나 상태로 걸러 실패하는 폼과 작업, 느린 페이지를 찾아요."
last_updated: 2026-10-08
---

# 로그: 빌드와 사이트 요청

로그는 무슨 일이 언제 있었는지 알려줘요. 프로젝트의 모든 빌드와 게시, 그리고 지난 하루 동안 사이트 자체 코드를 실행한 모든 요청이 담겨 있어요. 폼, 예약 작업, 페이지가 왜 제대로 동작하지 않는지 파악할 때 쓰세요.

읽는 데 5분 2026년 10월 8일 스튜디오 기준으로 확인함

## 두 가지 로그

어디에

1. Projects
2. Your project
3. Settings
4. Logs

| 보기 | 보여 주는 내용 | 얼마나 이전까지 |
| --- | --- | --- |
| **Builds** | 이 프로젝트의 모든 제작, 변경, 게시와 각각이 거친 단계예요. | 최근 40개 |
| **Requests** | 사이트에 들어온 요청과 오류를 최신순으로 보여 줘요. | 최근 24시간, 한 번에 최대 100개 |

예약 작업과 웹훅은 각자의 로그를 30일 동안 보관해요. [예약 작업](https://briks.dev/ko/docs/crons) 의 **Runs** 와 [웹훅](https://briks.dev/ko/docs/webhooks) 의 **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.

같은 작업을 미리보기와 나란히 실시간으로 보려면 스튜디오를 쓰세요. [빌드 지켜보기](https://briks.dev/ko/docs/watching-a-build) 를 참고하세요.

## 요청

**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** 가 보이면 잠시 후 다시 시도하세요.

## 오류가 나는 폼 진단하기

1. 항목을 찾아보세요

   위치: Settings, Forms

   방문자가 보낸 모든 메시지가 여기에 보관되며, 화면에는 최근 100개가 보여요. 각 메시지에는 도착한 시각과 페이지, 그리고 **emailed**, **not emailed** 또는 **preview** 가 표시돼요.

2. 미리보기라고 나온다면

   위치: Settings, Forms

   사이트가 프로덕션에 게시되지 않아서 문의 내용은 저장되지만 이메일로 전송되지 않아요. [프로덕션에 게시하기](https://briks.dev/ko/docs/publish-to-production) 를 참고하세요.

3. 이메일로 보냈다고 나오는데 아무것도 도착하지 않았다면

   위치: Your inbox

   문의 내용은 프로젝트를 만든 사람에게 전달돼요. 그 사람이 떠났다면 워크스페이스의 첫 번째 Owner에게 전달돼요. 스팸 메일함까지 포함해서 해당 받은편지함을 확인해 보세요.

4. 아예 보이지 않는다면

   위치: The live site

   메시지가 Briks에 전달되지 않았어요. 직접 보내 주세요. 여기서 너무 많은 메시지를 보냈다고 양식이 알려 주면 한도에 도달한 거예요. 방문자 한 명당 10분에 최대 5개, 사이트 전체로는 하루 최대 300개예요.

5. 다른 도구에서 필요하다면

   위치: Settings, Webhooks, Deliveries

   **Status** 를 **Failed** 로 설정하고 **Show** 를 누르세요. 전송 건을 열어 상대 도구의 응답을 읽고, 고친 뒤 **Send again** 을 누르세요.

데이터베이스에 저장되는 폼

앱의 예약 요청처럼 데이터베이스에 저장되는 폼은 사이트 자체 코드로 실행돼요. 전송 내역은 **Requests** 에 나타나요. 해당 경로를 검색하고 **Status** 를 **5xx** 로 설정하면 실패한 건을 찾을 수 있어요.

## 실패하는 예약 작업 진단하기

1. 실행 내용 읽기

   위치: Settings, Scheduled tasks, Runs

   실패한 실행을 열어 보세요. 주소가 답한 내용, 예를 들어 answered 500과 응답의 첫 부분이 나와요.

2. 오류 찾기

   위치: Settings, Logs, Requests

   작업이 사이트의 경로를 호출한다면 `/api/daily-summary` 같은 경로를 검색하고 **Level** 을 **Errors** 로 설정하세요. 메시지에 코드에서 무엇이 잘못됐는지 나와요.

3. 고쳐 달라고 요청하기

   위치: Studio

   오류를 스튜디오 채팅에 붙여 넣고 작업에 대한 한 문장을 함께 적으세요: 매일 아침 일일 요약 경로가 이 오류로 실패해요. [변경하기](https://briks.dev/ko/docs/making-changes) 를 참고하세요.

4. 다시 시도하세요

   위치: Settings, Scheduled tasks

   수정이 게시되면 작업의 점 세 개를 열고 **Run now** 를 선택하세요. 결과가 바로 나타나요.

**Skipped** 로 표시된 실행은 실패한 게 아니에요. 프로젝트의 하루 호출 수를 모두 썼다는 뜻이에요. 자정(UTC)이 지나면 실행이 다시 시작돼요. 요금제별 한도는 [예약 작업](https://briks.dev/ko/docs/crons) 페이지에 있어요.

## 느린 페이지 진단하기

**Requests** 는 사이트의 코드를 실행하는 모든 작업의 시간을 보여줘요. 사이트의 경로에서 콘텐츠를 불러오는 페이지가 느리게 느껴질 때 살펴볼 곳이에요. 앱과 대시보드는 보통 이런 방식으로 동작해요.

1. 페이지를 열고 시간을 적어 두세요

   위치: The live site

   느린 페이지를 직접 한 번 불러와서, 그 요청이 가장 최근 기록에 들어가게 하세요.

2. 소요 시간 보기

   위치: Settings, Logs, Requests

   그 시간에 이루어진 각 요청 옆의 밀리초를 보세요. 다른 경로는 수백 밀리초인데 한 경로만 몇 초 걸린다면 그곳이 원인이에요.

3. 범위 좁히기

   위치: Settings, Logs, Requests

   그 라우트의 경로를 검색해서 항상 느린지 가끔만 느린지, 그 옆에 **Warnings** 나 **Errors** 가 나타나는지 확인하세요.

4. 수정 요청하기

   위치: Studio

   어느 경로가 얼마나 느린지, 그 경로가 보여주는 페이지와 함께 스튜디오에 알려 주세요.

느린 부분이 보이지 않는다면 지연의 원인은 사이트 코드가 아니에요. 페이지, 사진, 파일은 있는 그대로 제공되니, 큰 사진이나 영상처럼 페이지가 담고 있는 것을 살펴보고, 느리게 느껴지는 부분을 스튜디오에서 설명해 주세요.

## 실제 예시: 저장되지 않게 된 예약 앱

주인이 알아챈 것 리즈의 반려견 미용실

> 아침 이후 새 예약이 들어오지 않았는데, 양식이 작동하지 않는다는 전화는 계속 걸려 왔어요.

**Requests** 에서 **Status** 를 **5xx** 로 설정하면, 9:12 이후의 `POST /api/bookings` 요청이 모두 500으로 응답한 것을 볼 수 있어요. 옆의 오류 줄에는 필수 항목이 빠졌다고 적혀 있었어요.

스튜디오에서 한 질문

> 오늘 아침부터 모든 예약이 /api/bookings에서 500 오류로 실패해요. 로그에는 반려동물 크기 필드가 없다고 나와요. 어제 폼에서 그 필드를 뺐거든요.

변경 사항이 게시됐고, **Requests** 의 다음 예약은 200으로 응답했어요.

## 다음 글 읽기

- [데이터와 자동화 **예약 작업** 예약 작업으로 정해진 시간에 사이트 작업을 실행해요. 일정 작성, 실행 결과 확인, 실패 해결, 플랜 한도까지 안내해요.](https://briks.dev/ko/docs/crons)
- [데이터와 자동화 **웹훅** 사이트 게시, 양식 전송, 레코드 변경 때 다른 도구로 서명된 메시지를 보내요. 페이로드, 서명, 재시도, 전송 내역을 설명해요.](https://briks.dev/ko/docs/webhooks)
- [사이트 기능 **폼** Briks 사이트에 양식을 추가하고, 미리보기에서 테스트하고, 스튜디오에서 문의를 확인하고, 웹훅으로 전달해요.](https://briks.dev/ko/docs/forms)
- [도움말 **문제 해결** Briks가 제대로 작동하지 않을 때 해결 방법: 로그인, 크레딧, 빌드와 변경, 도메인, 폼, 이메일, 챗봇, 데이터, 팀.](https://briks.dev/ko/docs/troubleshooting)

아직 해결되지 않았나요?

프로젝트 이름과 기대했던 내용을 적어 [hello@briks.dev](mailto:hello@briks.dev) 로 보내 주세요. 스크린샷이 있으면 도움이 돼요.