웹 서버 기록 — 누가 무엇을 달라고 했나
무엇인가
나눔OS 의 웹 서버(httpd)는 손님 장부를 씁니다. 요청 하나에 한 줄 — 언제, 어느 페이지, 무슨 대답, 몇 바이트. nginx·Apache 가 쓰는 장부 꼴 그대로라서 GoAccess·grep·awk 같은 흔한 도구가 읽습니다. 장부는 사이트를 돌보는 사람을 위한 것입니다: 「켜져 있나, 없는 주소는 뭔가, 어디가 느린가」. 지난 장은 하루 뒤 묶어 두고 14일이 지나면 버립니다.
지금 할 일: 서버판에서는 이미 켜져 있습니다. httpd stats 를 치면 지난 한 시간과 하루를 보여 줍니다.
어떻게 쓰나
켜고 끄고 바꾸기
keep=14— 며칠치 파일을 둘지ip=off— 연결한 주소 대신-를 적음(손님이 서버에 바로 닿는 곳용)max_mb=12— 하루치 파일이 이 크기에서 멈춤 ·max_total_mb=64— 모든 파일의 합 ·min_free_mb=32— 디스크 빈 곳이 이보다 적으면 기록을 멈춤- 바꾼 뒤에는 서버를 다시 켭니다(
service web restart, 또는httpd줄을 멈췄다 다시 시작).
기록 읽기
숫자 보기
httpd stats 는 지난 한 시간과 24시간의 요청 수, 대답 종류별(2xx·3xx·4xx·5xx) 수, 바이트, 4xx·5xx 수, 가장 많이 찾은 주소 열 개(물음표 뒤는 뺌), 첫 바이트가 나가기까지 걸린 시간(p50·p95, 「N ms 이하」)을 보여 줍니다.
점검
Zeus 의 「점검」(/doctor)에 「웹 서버(httpd)」 줄이 있습니다: 상태가 신선하고 서버 오류(5xx)가 하루 요청의 5% 아래면 건강, 기록이 멈췄거나(디스크 부족·하루치 파일 한도) 요청의 절반 넘게 4xx 면 주의, 상태가 안 바뀌거나(서버 멈춤) 5xx 가 5% 이상이면 흠입니다.
작동 원리
서버는 끝난 요청을 메모리의 작은 칸에 모았다가 몇 초마다(또는 칸이 거의 차면) 파일에 한꺼번에 씁니다 — 요청마다 디스크에 쓰지 않으니 기록 비용이 거의 없습니다. UTC 자정에는 그날 파일을 닫고, 지난 날 파일을 gzip 으로 묶고, 최근 14일보다 오래된 것을 지웁니다. 기록이 켜져 있으면 30초마다 숫자를 담은 작은 상태 파일(/tmp/httpd.status)도 씁니다(기록이 꺼져 있으면 상태 파일이 없어서 httpd stats 와 점검이 읽을 것이 없습니다). httpd stats 와 점검은 이 파일과 기록을 읽습니다.
기술 자세히
- 꼴: Apache/nginx 「combined」, 시각은 늘
+0000. 요청 줄·Referer·User-Agent 안의 따옴표·역슬래시·제어 문자는\xHH로 바꿉니다. - 주소 칸은 TCP 로 연결한 상대 주소 그대로입니다.
X-Forwarded-For·CF-Connecting-IP는 읽지도 쓰지도 않습니다. Cloudflare 뒤에서는 그 주소가 늘 Cloudflare 의 것이라 손님 주소가 남지 않습니다. - 칸 16 KiB, 요청 뒤 늦어도 5초 안에 씀 — Ctrl-C 로 죽이면 마지막 5초치가 빠질 수 있습니다. 자정 정리(하루치 gzip)는 잠깐 걸리고 서버는 계속 받습니다.
- 크기 한도: 하루 파일은
max_mb에서 멈춤(경고 한 줄, 다음 날 다시), 모든 파일의 합은max_total_mb아래(자정마다 오래된 날부터 지움), 빈 곳이min_free_mb아래면(커널/proc/storage로 잼) 경고 한 줄과 함께 멈추고 그 두 배가 비면 스스로 다시 씀. - 첫 바이트 시간은 「요청 머리 다 받음」부터 「첫 바이트 나감」까지, 13개 칸(1 ms … 5 s)에 10분 단위로 24시간치를 메모리에 셉니다 — p50·p95 는 칸 경계 값이고 서버를 다시 켜면 처음부터입니다.
- 개발자용:
user/cmds/httplog.h,tests/test_httplog.py,tests/httpd.py.
이 서버가 가져가는 것
- 남기는 것: 요청마다 시각, 요청 줄(방식·주소·물음표 뒤 포함), 대답 번호, 바이트 수, 어느 페이지에서 왔는지(Referer), 브라우저 이름(User-Agent). 서버에 연결한 주소도 남깁니다. nanumos.com 에서는 그 주소가 손님 것이 아니라 Cloudflare 의 것입니다 — 모든 방문이 Cloudflare 를 거치기 때문이고, 손님 본인의 주소는 읽지 않습니다. 손님이 서버에 바로 닿는 곳에서는 손님 주소가 남으니, 그런 곳은
ip=off로-만 적게 하세요. - 안 남기는 것: 프록시 뒤 손님 본인 주소(
X-Forwarded-For·CF-Connecting-IP), 쿠키, 요청 내용, 비밀번호, 파일 내용. - 얼마 동안: 14일(
keep=), 그 뒤 파일을 지웁니다.httpd stats의 숫자는 메모리에 24시간 있습니다.
자주 묻는 것
주소가 다 똑같아요. 서버가 Cloudflare 뒤에 있어서 그 주소가 Cloudflare 의 것이기 때문입니다. 일부러 그렇게 합니다 — 손님 주소가 장부에 안 남게.
**httpd stats 가 「메모리 숫자」라고 해요.** 그 시간대에 기록 줄이 없어서(기록 꺼짐이거나 막 켠 때) 서버가 켜진 뒤 센 숫자를 보여 주는 것입니다.
NanumOS 0.1.8349 · 2026-11-16