refactor: 문서 사람처럼 작성하기

This commit is contained in:
donghyeon-ka
2026-09-22 16:24:58 +09:00
parent 1549e62b5e
commit f3bed70991
158 changed files with 4381 additions and 832 deletions
@@ -21,7 +21,7 @@ source:
# 게스트 page fault 증가는 workload 변화를 따라가는가
2026-09-21 `kc-lab-2`에서 anonymous 512 MiB를 `mmap()`한 뒤 4 KiB마다 한 번씩 touch하는 workload를 실행했다. 131,072 page를 처음 접근하는 동안 해당 Python process의 minor fault는 131,073 증가했고 major fault는 증가하지 않았다. 같은 구간의 guest 전체 `pgfault`는 131,177 증가했지만 `pgmajfault`, `pswpin`, `pswpout`은 0 증가였다. **workload가 새 page를 실제로 접근하자 정상 demand paging에 해당하는 minor fault가 함께 증가**하는 것을 확인했다.
2026-09-21 `kc-lab-2`에서 anonymous 512 MiB를 `mmap()`한 뒤 4 KiB마다 한 번씩 touch하는 workload를 실행했다. 131,072 page를 처음 접근하는 동안 해당 Python process의 minor fault는 131,073 증가했고 major fault는 증가하지 않았다. 같은 구간의 guest 전체 `pgfault`는 131,177 증가했지만 `pgmajfault`, `pswpin`, `pswpout`은 0 증가였다. workload가 새 page를 실제로 접근하자 정상 demand paging에 해당하는 minor fault가 함께 증가하는 것을 확인했다.
## 512MiB demand paging 결과
@@ -25,7 +25,7 @@ source:
# 호스트 major fault 와 스토리지 지연은 같은 시간축에서 함께 움직이는가
2026-09-21 단계형 host memory pressure 실험에서 major fault, swap 상태, NVMe `iostat`, guest OIDC latency를 같은 실행으로 기록했다. host major fault는 증가했지만 zswap이 swap-out을 압축 메모리에서 흡수해 NVMe 지연이 함께 상승하지 않았다. 따라서 **현재 압박 수준에서는 major fault 증가와 storage latency 상승의 동행이 관측되지 않았다.**
2026-09-21 단계형 host memory pressure 실험에서 major fault, swap 상태, NVMe `iostat`, guest OIDC latency를 같은 실행으로 기록했다. host major fault는 증가했지만 zswap이 swap-out을 압축 메모리에서 흡수해 NVMe 지연이 함께 상승하지 않았다. 따라서 현재 압박 수준에서는 major fault 증가와 storage latency 상승의 동행이 관측되지 않았다.
## host major fault와 storage를 같이 본 결과
@@ -2,7 +2,7 @@
id: a05fe2a6-eb7c-4bcc-a7da-58e729436468
kind: QUESTION
slug: host-memory-pressure-vs-guest-latency
title: 호스트 메모리 압박이 게스트 애플리케이션 지연을 실제로 밀어 올리는가
title: 호스트 메모리 압박이 게스트 애플리케이션 지연에 영향을 주는가
topic: memory-virtualization
topicName: 메모리 가상화
project: virtualization
@@ -27,9 +27,9 @@ source:
- final/document.md#62-memory-pressure와-storage-contention의-연결
---
# 호스트 메모리 압박이 게스트 애플리케이션 지연을 실제로 밀어 올리는가
# 호스트 메모리 압박이 게스트 애플리케이션 지연에 영향을 주는가
2026-09-21 host에서 anonymous memory를 256 MiB씩 늘려 최대 3.5 GiB를 추가 할당했고 `MemAvailable`을 약 512 MiB까지 낮춘 뒤 12초 유지했다. 이 구간에서 host swap 사용량과 major fault는 증가했지만, zswap이 swap-out을 압축 메모리에서 흡수해 NVMe storage pressure로 크게 이어지지 않았고 OIDC discovery 지연도 baseline보다 악화되지 않았다. 따라서 **현재 압박 수준에서는 host memory pressure가 guest application latency를 밀어 올리는 경로가 재현되지 않았다.**
2026-09-21 host에서 anonymous memory를 256 MiB씩 늘려 최대 3.5 GiB를 추가 할당했고 `MemAvailable`을 약 512 MiB까지 낮춘 뒤 12초 유지했다. 이 구간에서 host swap 사용량과 major fault는 증가했지만, zswap이 swap-out을 압축 메모리에서 흡수해 NVMe storage pressure로 크게 이어지지 않았고 OIDC discovery 지연도 baseline보다 악화되지 않았다. 현재 압박 수준에서는 host memory pressure와 함께 guest application latency가 증가하는 현상은 관측되지 않았다.
## 압박 전후 guest latency 결과
@@ -22,7 +22,7 @@ source:
# NUMA remote access 가 이 작업의 지연을 실제로 바꾸는가
2026-09-21 현재 `test-server`는 NUMA node가 하나뿐이다. CPU `0-7`과 QEMU memory가 모두 `node0`에 있으므로 이 host에서는 local 배치와 remote 배치를 만들어 비교하는 실험 자체가 성립하지 않는다. 따라서 이 질문은 **현재 환경에는 적용되지 않는 것으로 해소**한다.
2026-09-21 현재 `test-server`는 NUMA node가 하나뿐이다. CPU `0-7`과 QEMU memory가 모두 `node0`에 있으므로 이 host에서는 local 배치와 remote 배치를 만들어 비교하는 실험 자체가 성립하지 않는다. 이 호스트에서는 remote NUMA 배치를 만들 수 없으므로 local/remote NUMA에 따른 지연 차이를 비교할 수 없다.
## 이 호스트에서 실험이 성립하지 않는 이유
@@ -2,7 +2,7 @@
id: fa5b3782-9fcf-4113-8f51-a55c8023b2db
kind: QUESTION
slug: qemu-resident-memory-distribution
title: QEMU 프로세스가 실제로 붙잡고 있는 호스트 메모리는 얼마이고 어떻게 나뉘어 있는가
title: QEMU 프로세스의 호스트 메모리 사용량은 얼마인가
topic: memory-virtualization
topicName: 메모리 가상화
project: virtualization
@@ -20,7 +20,7 @@ source:
- final/document.md#42-configured-memory와-실제-physical-ram-사용량은-같지-않을-수-있다
---
# QEMU 프로세스가 실제로 붙잡고 있는 호스트 메모리는 얼마이고 어떻게 나뉘어 있는가
# QEMU 프로세스의 호스트 메모리 사용량은 얼마인가
2026-09-21 세 QEMU 프로세스의 `smaps_rollup`을 직접 읽었다. configured memory와 host RSS는 같지 않았고, resident memory의 대부분은 anonymous이며 큰 부분이 THP `AnonHugePages`로 backing돼 있었다. exact RSS는 workload와 시점에 따라 달라지는 관측값이다.
@@ -60,7 +60,7 @@ smaps_rollup 을 읽을 권한이 있다고 전제한다. 다른 사용자의
2026-09-21에는 세 QEMU 프로세스의 RSS를 실제로 읽었다. `kc-lab-1`은 약 3.73GiB, `kc-lab-2`는 약 2.91GiB, edge는 약 0.84GiB였다. 개념 설명에 쓰인 8GiB·16GiB 예시는 이 측정값과 구분한다.
설정한 메모리를 옆에 놓지 않으면 얼마나 벌어져 있는지 적을 수 없다. 그 값은 「이 호스트의 가상 머신들은 설정한 메모리와 지금 잡고 있는 메모리가 얼마나 다른가」가 받는다.
QEMU RSS는 VM에 설정한 메모리와 함께 기록해야 차이를 해석할 수 있다. configured/current memory와 RSS는 같은 시각에 측정하되 서로 다른 지표로 남긴다.
「Configured Memory와 실제 Physical RAM 사용량은 같지 않을 수 있다」에서는 게스트 사용량과 호스트 resident 를 다른 값으로 갈라 놓았기 때문에, resident 크기 하나로는 게스트가 그 메모리를 지금 쓰고 있는지 알 수 없다.
@@ -22,7 +22,7 @@ source:
# 지금 게스트와 호스트에서 swap 이 실제로 오가고 있는가
2026-09-21 짧은 관측 구간에서 worker guest 둘의 swap은 0이고, host에는 약 260 MiB의 swap 사용량이 남아 있었지만 `vmstat 1 5`의 `si/so`는 host와 worker 둘 모두 계속 0이었다. 따라서 **swap 사용량이 남아 있다는 사실과 현재 swap I/O가 진행 중이라는 사실은 다르다**는 것을 이 host에서 직접 확인했다.
2026-09-21 짧은 관측 구간에서 worker guest 둘의 swap은 0이고, host에는 약 260 MiB의 swap 사용량이 남아 있었지만 `vmstat 1 5`의 `si/so`는 host와 worker 둘 모두 계속 0이었다. 따라서 swap 사용량이 남아 있다는 사실과 현재 swap I/O가 진행 중이라는 사실은 다르다는 것을 이 host에서 직접 확인했다.
## host와 guest swap 관찰 결과
@@ -23,7 +23,7 @@ source:
# 이 가상 머신들에 virtio-balloon 이 붙어 있는가
2026-09-21 세 domain XML 모두 `<memballoon model='virtio'>`를 가지고 있고, worker guest 둘에서도 virtio-balloon driver에 `virtio5` 장치가 bind돼 있었다. 따라서 장치 구성 여부는 확인됐다. 다만 현재 `dommemstat actual`은 configured/current memory와 같아서 **장치가 존재한다는 사실만으로 지금 balloon이 메모리를 회수 중이라고 말할 수는 없다.**
2026-09-21 세 domain XML 모두 `<memballoon model='virtio'>`를 가지고 있고, worker guest 둘에서도 virtio-balloon driver에 `virtio5` 장치가 bind돼 있었다. 따라서 장치 구성 여부는 확인됐다. 다만 현재 `dommemstat actual`은 configured/current memory와 같아서 장치가 존재한다는 사실만으로 지금 balloon이 메모리를 회수 중이라고 말할 수는 없다.
## 세 VM의 balloon 장치 상태
@@ -41,7 +41,7 @@ source:
- 「자원 — 할당과 실사용은 다르다」에서는 virsh dommemstat 으로 k3s 게스트 두 대를 재서 아래 값을 받았다. k3s 만 떠 있고 Keycloak 은 올리기 전 상태다.
kc-lab-1 : 할당 5120MB · 실사용 353MB
kc-lab-2 : 할당 3120MB · 실사용 301MB
- 2026-09-10 historical snapshot에서는 `virt-install --memory 4096`으로 만든 `kc-lab-2`의 `dommemstat actual`이 3120MB였다. 당시 문서는 balloon 가능성을 추론했지만 원인을 검증하지 않았다. 2026-09-21 재검증에서는 actual이 4096MiB로 configured/current와 같았다.
- 2026-09-10 기록에서는 `virt-install --memory 4096`으로 만든 `kc-lab-2`의 `dommemstat actual`이 3120MB였다. 당시 문서는 balloon 가능성을 추론했지만 원인을 검증하지 않았다. 2026-09-21 재검증에서는 actual이 4096MiB로 configured/current와 같았다.
- 「자원 — 할당과 실사용은 다르다」에서는 dommemstat 의 actual 이 현재 할당이고 선언한 상한은 virsh dominfo 의 Max memory 에 있다고 적으면서, 이 실험대에서 그 두 값을 나란히 찍어 보지 않았다고 미측정으로 남겼다.
- 「단계 01 — 게스트 세 대」에 적은 게스트는 kc-lab-edge · kc-lab-1 · kc-lab-2 세 대이고, 「자원 — 할당과 실사용은 다르다」의 측정에 kc-lab-edge 는 들어 있지 않다.
- 이 호스트의 가상 머신 설정에서 balloon 관련 요소를 읽은 기록이 개념 문서에 없다.
@@ -81,7 +81,7 @@ Configured RAM과 Current RAM은 이후 memory pressure나 balloon 실험에서
이 질문에서 확인한 것은 configured/current와 실제 점유가 다르다는 사실까지다. 메모리 압박이 생겼을 때 reclaim·swap·guest latency가 어떻게 변하는지는 별도 pressure 실험에서 본다.
QEMU 프로세스 쪽 값은 여기서 닫지 않는다. virsh 가 보고하는 값과 프로세스가 실제로 잡고 있는 크기는 다른 관측이고, 그것은 「QEMU 프로세스가 실제로 붙잡고 있는 호스트 메모리는 얼마이고 어떻게 나뉘어 있는가」가 받는다.
`virsh`가 보고하는 configured/current memory와 QEMU 프로세스의 RSS는 서로 다른 값이다. 여기서는 VM 설정값과 guest-visible memory를 확인하고, QEMU RSS는 같은 시각에 별도 호스트 지표로 기록한다.
## 설정값과 live 값, guest-visible memory를 나란히 봤다
@@ -101,7 +101,7 @@ VM 하나로 표 모양을 먼저 정하는 방법은 가능하지만, VM별 값
호스트에 한 번 붙는 김에 ps 로 QEMU 프로세스의 크기까지 받아 적자는 방법이다. 실행 횟수는 줄어든다.
QEMU 쪽은 별도의 물음이 이미 받고 있고 그쪽은 anonymous 인지 huge page 인지까지 보기 때문에, 여기서 함께 읽으면 어느 물음의 기준으로 닫혔는지가 남지 않는다. 두 물음의 실행 시각을 맞추고 싶으면 같은 접속에서 순서대로 돌리고 각각의 기록에 남긴다.
QEMU RSS의 anonymous memory와 `AnonHugePages` 구성은 VM 설정값과 구분해 기록한다. 두 값을 비교하려면 같은 시각에 순서대로 측정해 시점 차이를 줄인다.
## 메모리를 바꾸면 설정값·현재값·guest 값을 다시 비교한다
@@ -21,7 +21,7 @@ source:
# 가상 머신 RAM 이 HugeTLB 로 명시적으로 backing 되어 있는가
2026-09-21 현재 세 VM은 **명시적 HugeTLB backing을 사용하지 않는다.** domain XML에 `memoryBacking/hugepages`가 없고 host는 `HugePages_Total=0`, `Hugetlb=0 kB`다. QEMU `smaps_rollup`의 큰 `AnonHugePages` 값은 THP이며 HugeTLB pool 사용의 증거가 아니다.
2026-09-21 현재 세 VM은 명시적 HugeTLB backing을 사용하지 않는다. domain XML에 `memoryBacking/hugepages`가 없고 host는 `HugePages_Total=0`, `Hugetlb=0 kB`다. QEMU `smaps_rollup`의 큰 `AnonHugePages` 값은 THP이며 HugeTLB pool 사용의 증거가 아니다.
## 현재 HugeTLB backing 상태