NanumOS

서버 지표(/metrics) — 서버가 스스로 「지금 어떤지」를 지표 수집기에 알려 줍니다

이 기능은

나눔OS 서버판이 GET /metrics 에 스스로 답합니다. 지표 수집기가 읽는 글자 형식이고, 흔한 node_exporter 와 같은 이름을 씁니다. 서버에 아무것도 깔지 않고 기존 지표 수집기로 CPU·메모리·디스크·망·서비스·서버 점검 결과를 숫자로 볼 수 있습니다.

기초

기계 옆면에 달린 계기판 유리라고 생각하면 됩니다. 보도록 허락받은 사람만 계기(얼마나 바쁜지, 얼마나 찼는지, 어떤 서비스가 도는지)를 보고, 나머지는 유리가 있는 것조차 볼 수 없습니다. 지표 수집기는 15초마다 계기를 받아 적는 사람입니다. 지금 할 일: 서버에서 u metricsd --check 를 쳐 보세요. 어디서 듣고 누구를 받는지 알려 줍니다.

쓰는 법

작동 원리

지표 수집기가 물을 때 metricsd 가 커널이 이미 보여 주는 것(/proc/stat·/proc/meminfo·/proc/storage·/proc/metrics·서비스 목록)을 읽어 형식에 맞게 적어 답합니다. 허용 목록에 없는 상대는 한 바이트도 읽지 않고 끊습니다.

기술 자세히
  • 코드 user/cmds/metricsd.c·user/cmds/metrics_core.h, 커널 /proc/metrics(src/ramfs.c). 모든 지표·라벨·단위는 계약 docs/contracts/METRICS.md.
  • 설정 키: enable, listen(loopback·wire·주소), port(9100), allow(주소 또는 A.B.C.D/N, N 은 8 이상), public_port, httpd_port, httpd_path.
  • nanumos_httpd_* 는 httpd 의 상태 쪽을 기계 안에서 읽은 값이라 긁을 때마다 nanumos_httpd_requests_total 이 하나 늘어납니다.
  • promtool check metrics 와 진짜 지표 수집기로 tests/metrics_prom.py 가 잽니다.

이 앱이 가져가는 것

가져가는 것바깥에서는 아무것도 가져오지 않습니다. 이 기계 자신의 숫자만 읽습니다.
보내는 것허용 목록에 있는 주소가 물을 때만: 부하·메모리·디스크·망 바이트 수, 서비스 이름과 도는지 여부, OS 빌드 번호, 기계 이름과 커널 판. 파일 이름·사용자 이름·열쇠·다른 기계 주소·글 내용은 없습니다. 묻지 않으면 아무것도 보내지 않습니다.
끄는 법그 파일에 enable=no, 또는 service metrics stop 으로 멈춥니다. 데스크톱판은 아예 띄우지 않습니다.

자주 묻는 것

아무나 볼 수 있나요?

node_exporter 도 같이 깔아야 하나요?

아니요. 이름을 일부러 같게 해서 쓰던 수집기 규칙과 화면이 그대로 됩니다. node_exporter 에 있는 것 중 나눔OS 가 재지 않는 것(user·idle 말고 CPU 시간 종류, 실행 대기열)은 0 이거나 「실행 중인 프로그램 수」로 대신한다고 문서에 적혀 있습니다.

바쁜 서버인데 node_load1 이 낮아요

커널이 CPU 를 기다리는 프로그램 줄을 따로 세지 않아서, 「바쁜 CPU 수」로 잽니다.

NanumOS 0.1.8349 · 2026-11-16