NanumOS

웹 서버 기록 — 누가 무엇을 달라고 했나

무엇인가

나눔OS 의 웹 서버(httpd)는 손님 장부를 씁니다. 요청 하나에 한 줄 — 언제, 어느 페이지, 무슨 대답, 몇 바이트. nginx·Apache 가 쓰는 장부 꼴 그대로라서 GoAccess·grep·awk 같은 흔한 도구가 읽습니다. 장부는 사이트를 돌보는 사람을 위한 것입니다: 「켜져 있나, 없는 주소는 뭔가, 어디가 느린가」. 지난 장은 하루 뒤 묶어 두고 14일이 지나면 버립니다.

지금 할 일: 서버판에서는 이미 켜져 있습니다. httpd stats 를 치면 지난 한 시간과 하루를 보여 줍니다.

어떻게 쓰나

켜고 끄고 바꾸기

기록 읽기

숫자 보기

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.

이 서버가 가져가는 것

자주 묻는 것

주소가 다 똑같아요. 서버가 Cloudflare 뒤에 있어서 그 주소가 Cloudflare 의 것이기 때문입니다. 일부러 그렇게 합니다 — 손님 주소가 장부에 안 남게.

**httpd stats 가 「메모리 숫자」라고 해요.** 그 시간대에 기록 줄이 없어서(기록 꺼짐이거나 막 켠 때) 서버가 켜진 뒤 센 숫자를 보여 주는 것입니다.

NanumOS 0.1.8349 · 2026-11-16