프로덕션 환경에서 웹페이지의 메모리 사용량을 측정하여 회귀를 감지하는 방법을 알아보세요.
브라우저는 웹페이지의 메모리를 자동으로 관리합니다. 웹페이지가 객체를 생성할 때마다 브라우저는 '내부'에서 메모리 청크를 할당하여 객체를 저장합니다. 메모리는 유한한 리소스이므로 브라우저는 가비지 컬렉션을 실행하여 객체가 더 이상 필요하지 않을 때 이를 감지하고 기본 메모리 청크를 해제합니다.
하지만 감지가 완벽한 것은 아니며, 완벽한 감지는 불가능한 작업이라는 것이 증명되었습니다. 따라서 브라우저는 '객체가 필요합니다'라는 개념으로 '객체에 도달할 수 있습니다'라는 개념을 사용합니다. 웹페이지가 해당 변수와 연결 가능한 다른 객체의 필드를 통해 객체에 도달할 수 없는 경우 브라우저가 해당 객체를 안전하게 회수할 수 있습니다. 다음 예와 같이 이 두 개념의 차이로 인해 메모리 누수가 발생합니다.
const object = {a: new Array(1000), b: new Array(2000)};
setInterval(() => console.log(object.a), 1000);
여기서 더 큰 배열 b은 더 이상 필요하지 않지만 콜백에서 object.b를 통해 여전히 연결할 수 있으므로 브라우저가 이 배열을 회수하지 않습니다. 따라서 더 큰 배열의 메모리가 누출됩니다.
메모리 누수는 웹에서 흔히 발생합니다. 이벤트 리스너를 등록 취소하는 것을 잊어버리거나, 실수로 iframe에서 객체를 캡처하거나, worker를 닫지 않거나, 배열에 객체를 누적하는 등의 방법으로 리스너를 도입하기 쉽습니다. 웹페이지에서 메모리 누수가 발생하면 시간이 지남에 따라 메모리 사용량이 증가하고 웹페이지는 느려지고 사용자에게 팽창처럼 보입니다.
이 문제를 해결하는 첫 번째 단계는 그것을 측정하는 것입니다. 개발자는 새로운 performance.measureUserAgentSpecificMemory() API를 사용하여 프로덕션 환경에서 웹페이지의 메모리 사용량을 측정하여 로컬 테스트를 통과하는 메모리 누수를 감지할 수 있습니다.
performance.measureUserAgentSpecificMemory()는 기존 performance.memory API와 어떻게 다른가요?
기존의 비표준 performance.memory API에 익숙하다면 새 API와 어떻게 다른지 궁금할 수 있습니다. 주요 차이점은 이전 API는 JavaScript 힙의 크기를 반환하는 반면 새 API는 웹페이지에서 사용되는 메모리를 추정한다는 것입니다. 이러한 차이는 Chrome이 여러 웹페이지 (또는 동일한 웹페이지의 여러 인스턴스)와 동일한 힙을 공유하는 경우 중요합니다. 이러한 경우 이전 API의 결과가 임의로 벗어날 수 있습니다. 이전 API는 '힙'과 같은 구현 관련 용어로 정의되므로 표준화하기란 쉽지 않습니다.
또 다른 차이점은 새 API가 가비지 컬렉션 중에 메모리를 측정한다는 것입니다. 이렇게 하면 결과의 노이즈가 줄어들지만 결과가 생성될 때까지 시간이 걸릴 수 있습니다. 다른 브라우저에서는 가비지 컬렉션에 의존하지 않고 새 API를 구현할 수도 있습니다.
추천 사용 사례
웹페이지의 메모리 사용량은 이벤트, 사용자 작업, 가비지 컬렉션의 시점에 따라 달라집니다. 이러한 이유로 메모리 측정 API는 프로덕션에서 메모리 사용량 데이터를 집계하는 데 사용됩니다. 개별 호출의 결과는 그다지 유용하지 않습니다. 사용 사례 예:
- 새로운 메모리 누수를 포착하기 위해 웹페이지의 새 버전 출시 중 회귀 감지
- 메모리 영향을 평가하고 메모리 누수를 감지하기 위해 새로운 기능의 A/B 테스트입니다.
- 메모리 사용량을 세션 기간과 연관시켜 메모리 누수가 있는지 확인합니다.
- 메모리 사용량과 사용자 측정항목의 상관관계를 파악하여 메모리 사용량의 전반적인 영향을 이해합니다.
브라우저 호환성
현재 이 API는 Chrome 89부터 Chromium 기반 브라우저에서만 지원됩니다. 브라우저는 메모리에서 객체를 나타내는 방법과 메모리 사용량을 추정하는 방법이 다르기 때문에 API의 결과는 구현에 따라 크게 달라집니다. 브라우저는 적절한 계산에 너무 많은 비용이 들거나 실행이 불가능한 경우 일부 메모리 영역을 계산에서 제외할 수 있습니다. 따라서 여러 브라우저에서 결과를 비교할 수 없습니다. 동일한 브라우저의 결과를 비교하는 것만 의미가 있습니다.
performance.measureUserAgentSpecificMemory() 사용
특성 감지
실행 환경이 교차 출처 정보 유출 방지를 위한 보안 요구사항을 충족하지 않으면 performance.measureUserAgentSpecificMemory 함수를 사용할 수 없거나 SecurityError와 함께 실패할 수 있습니다.
COOP+COEP 헤더를 설정하여 웹페이지에서 활성화할 수 있는 교차 출처 분리를 사용합니다.
지원은 런타임에 감지될 수 있습니다.
if (!window.crossOriginIsolated) {
console.log('performance.measureUserAgentSpecificMemory() is only available in cross-origin-isolated pages');
} else if (!performance.measureUserAgentSpecificMemory) {
console.log('performance.measureUserAgentSpecificMemory() is not available in this browser');
} else {
let result;
try {
result = await performance.measureUserAgentSpecificMemory();
} catch (error) {
if (error instanceof DOMException && error.name === 'SecurityError') {
console.log('The context is not secure.');
} else {
throw error;
}
}
console.log(result);
}
로컬 테스트
Chrome은 가비지 컬렉션 중에 메모리를 측정합니다. 즉, API가 결과 프로미스를 즉시 확인하지 않고 대신 다음 가비지 컬렉션을 기다립니다.
API를 호출하면 현재 20초로 설정되어 있는 제한 시간 후 가비지 컬렉션이 강제로 실행되지만 더 빨리 발생할 수도 있습니다. --enable-blink-features='ForceEagerMeasureMemory' 명령줄 플래그로 Chrome을 시작하면 제한 시간이 0으로 줄어들어 로컬 디버깅 및 테스트에 유용합니다.
예시
이 API의 권장 용도는 전체 웹페이지의 메모리 사용량을 샘플링하고 집계 및 분석을 위해 결과를 서버로 전송하는 전역 메모리 모니터를 정의하는 것입니다. 가장 간단한 방법은 주기적으로(예: M분마다) 샘플링하는 것입니다. 하지만 이 경우 샘플 간에 메모리 피크가 발생할 수 있으므로 데이터에 편향이 발생합니다.
다음 예는 푸아송 프로세스를 사용하여 편향되지 않은 메모리 측정을 수행하는 방법을 보여줍니다. 이 프로세스는 샘플이 어느 시점에서든 동등하게 발생할 가능성을 보장합니다(데모, 소스).
먼저 setTimeout()를 사용하여 무작위 간격으로 다음 메모리 측정을 예약하는 함수를 정의합니다.
function scheduleMeasurement() {
// Check measurement API is available.
if (!window.crossOriginIsolated) {
console.log('performance.measureUserAgentSpecificMemory() is only available in cross-origin-isolated pages');
console.log('See https://web.dev/coop-coep/ to learn more')
return;
}
if (!performance.measureUserAgentSpecificMemory) {
console.log('performance.measureUserAgentSpecificMemory() is not available in this browser');
return;
}
const interval = measurementInterval();
console.log(`Running next memory measurement in ${Math.round(interval / 1000)} seconds`);
setTimeout(performMeasurement, interval);
}
measurementInterval() 함수는 평균적으로 5분마다 하나의 측정값이 있도록 하는 임의의 간격(밀리초)을 계산합니다. 함수 뒤에 숨겨진 계산에 대해서는 지수 분포를 참조하세요.
function measurementInterval() {
const MEAN_INTERVAL_IN_MS = 5 * 60 * 1000;
return -Math.log(Math.random()) * MEAN_INTERVAL_IN_MS;
}
마지막으로 비동기 performMeasurement() 함수는 API를 호출하고 결과를 기록하고 다음 측정을 예약합니다.
async function performMeasurement() {
// 1. Invoke performance.measureUserAgentSpecificMemory().
let result;
try {
result = await performance.measureUserAgentSpecificMemory();
} catch (error) {
if (error instanceof DOMException && error.name === 'SecurityError') {
console.log('The context is not secure.');
return;
}
// Rethrow other errors.
throw error;
}
// 2. Record the result.
console.log('Memory usage:', result);
// 3. Schedule the next measurement.
scheduleMeasurement();
}
마지막으로 측정을 시작합니다.
// Start measurements.
scheduleMeasurement();
다음과 같은 결과가 표시될 수 있습니다.
// Console output:
{
bytes: 60_100_000,
breakdown: [
{
bytes: 40_000_000,
attribution: [{
url: 'https://example.com/',
scope: 'Window',
}],
types: ['JavaScript']
},
{
bytes: 20_000_000,
attribution: [{
url: 'https://example.com/iframe',
container: {
id: 'iframe-id-attribute',
src: '/iframe',
},
scope: 'Window',
}],
types: ['JavaScript']
},
{
bytes: 100_000,
attribution: [],
types: ['DOM']
},
],
}
총 메모리 사용량 추정치는 bytes 필드에 반환됩니다. 이 값은 구현에 따라 크게 달라지며 여러 브라우저에서 비교할 수 없습니다. 동일한 브라우저의 다른 버전 간에 변경될 수도 있습니다. 이 값에는 모든 iframe의 자바스크립트 및 DOM 메모리, 관련 창, 현재 프로세스의 웹 작업자가 포함됩니다.
breakdown 목록은 사용된 메모리에 관한 추가 정보를 제공합니다. 각 항목은 메모리의 일부를 설명하고 URL로 식별된 일련의 창, iframe 및 작업자가 메모리의 일부분에 해당하는 것으로 간주합니다. types 필드에는 메모리와 연결된 구현별 메모리 유형이 나열됩니다.
모든 목록을 일반적인 방식으로 처리하고 특정 브라우저를 기반으로 한 가정을 하드코딩하지 않는 것이 중요합니다. 예를 들어 일부 브라우저에서는 빈 breakdown 또는 빈 attribution을 반환할 수 있습니다. 다른 브라우저는 attribution에 여러 항목을 반환할 수 있습니다. 이는 이러한 항목 중 메모리를 소유하고 있는 항목을 구별할 수 없음을 나타냅니다.
의견
웹 성능 커뮤니티 그룹 및 Chrome팀은 performance.measureUserAgentSpecificMemory()에 관한 여러분의 의견과 경험을 공유해 주세요.
API 설계에 대해 알려주세요.
API에서 예상대로 작동하지 않는 부분이 있나요? 아니면 아이디어를 구현하는 데 필요한 누락된 속성이 있나요? performance.measureUserAgentSpecificMemory() GitHub 저장소에서 사양 문제를 제출하거나 기존 문제에 의견을 추가합니다.
구현 문제 신고
Chrome 구현에서 버그를 발견하셨나요? 아니면 구현이 사양과 다른가요? new.crbug.com에서 버그를 신고합니다. 최대한 많은 세부정보를 포함하고 버그 재현을 위한 간단한 안내를 제공하며 구성요소를 Blink>PerformanceAPIs로 설정해야 합니다.
Glitch는 쉽고 빠른 재현을 공유하는 데 효과적입니다.
지지 표시
performance.measureUserAgentSpecificMemory() 서비스를 사용할 계획이신가요? 공개 지원은 Chrome팀이 기능의 우선순위를 정하는 데 도움이 되고 다른 브라우저 공급업체에는 이러한 기능 지원이 얼마나 중요한지 보여줍니다. @ChromiumDev로 트윗을 보내서 어디에서 어떻게 사용하는지 알려주세요.
유용한 링크
감사의 말씀
Chrome에서 코드를 검토해 주신 Domenic Denicola, Yoav Weiss, Mathias Bynens, API 설계 리뷰를 위해 도움을 주신 도미니크 인퓨어, 한스 페이어, 켄타로 하라, 마이클 리파우츠에게 감사의 말씀을 전합니다. 또한 API를 대폭 개선한 소중한 사용자 의견을 제공해 주신 Per Parker, Philipp Weis, Olga Belomestnykh, Matthew Bolohan, Neil Mckay에게 감사드립니다.