서버 지표(/metrics) — 서버가 스스로 「지금 어떤지」를 지표 수집기에 알려 줍니다
이 기능은
나눔OS 서버판이 GET /metrics 에 스스로 답합니다. 지표 수집기가 읽는 글자 형식이고, 흔한 node_exporter 와 같은 이름을 씁니다. 서버에 아무것도 깔지 않고 기존 지표 수집기로 CPU·메모리·디스크·망·서비스·서버 점검 결과를 숫자로 볼 수 있습니다.
기초
기계 옆면에 달린 계기판 유리라고 생각하면 됩니다. 보도록 허락받은 사람만 계기(얼마나 바쁜지, 얼마나 찼는지, 어떤 서비스가 도는지)를 보고, 나머지는 유리가 있는 것조차 볼 수 없습니다. 지표 수집기는 15초마다 계기를 받아 적는 사람입니다. 지금 할 일: 서버에서 u metricsd --check 를 쳐 보세요. 어디서 듣고 누구를 받는지 알려 줍니다.
쓰는 법
- 수집기 설정 파일 에는
static_configs: - targets: ["서버:9100"]인 작업 하나. node_exporter 용으로 만든 화면(부하·메모리·파일 시스템·망·디스크 바이트)이 그대로 됩니다. enable=no로 끕니다. 80·443 포트는public_port=yes라고 적지 않으면 거절됩니다(적지 마세요).- 점검 「서버 지표(/metrics)」 줄과 숫자
nanumos_doctor_status(0 정상·1 주의·2 위험)가 같은 판정을 보여 줍니다.
작동 원리
지표 수집기가 물을 때 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