이제 Modern Web Guidance가 안정화되었습니다. 전문가가 검증한 웹 개발 권장사항으로 코딩 에이전트를 업그레이드하세요. 공지 확인하기

Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.

measureUserAgentSpecificMemory()로 웹페이지의 총 메모리 사용량을 모니터링합니다.

프로덕션에서 웹페이지의 메모리 사용량을 측정하여 회귀를 감지하는 방법을 알아보세요.

Brendan Kenny

Ulan Degenbaev

브라우저는 웹페이지의 메모리를 자동으로 관리합니다. 웹페이지에서 객체를 만들 때마다 브라우저는 객체를 저장하기 위해 '내부적으로' 메모리 청크를 할당합니다. 메모리는 유한 자원이므로 브라우저는 가비지 컬렉션을 실행하여 객체가 더 이상 필요하지 않은 시점을 감지하고 기본 메모리 청크를 확보합니다.

하지만 감지가 완벽하지는 않으며 앨런 튜링의 정지 문제는 완벽한 감지가 불가능한 작업임을 증명했습니다. 따라서 브라우저는 '객체가 필요함'이라는 개념을 '객체에 연결할 수 있음'이라는 개념으로 근사화합니다. 웹페이지가 변수와 다른 도달 가능한 객체의 필드를 통해 객체에 도달할 수 없는 경우 브라우저는 객체를 안전하게 회수할 수 있습니다. 이 두 개념의 차이로 인해 다음 예와 같이 메모리 누수가 발생합니다.

const object = {a: new Array(1000), b: new Array(2000)};
setInterval(() => console.log(object.a), 1000);

여기서 더 큰 배열 b는 더 이상 필요하지 않지만 콜백의 object.b를 통해 계속 연결할 수 있으므로 브라우저에서 회수하지 않습니다. 따라서 더 큰 배열의 메모리가 누출됩니다.

이 연구에서 볼 수 있듯이 웹에서는 메모리 누수가 흔히 발생합니다. 이벤트 리스너 등록 취소를 잊어버리거나, 실수로 iframe에서 객체를 캡처하거나, 워커를 닫지 않거나, 배열에 객체를 누적하는 등의 이유로 메모리 누수가 쉽게 발생할 수 있습니다. 웹페이지에 메모리 누수가 있으면 시간이 지남에 따라 메모리 사용량이 증가하고 웹페이지가 사용자에게 느리고 비대해 보입니다.

이 문제를 해결하는 첫 번째 단계는 측정하는 것입니다. 새로운 performance.measureUserAgentSpecificMemory() API를 사용하면 개발자가 프로덕션에서 웹페이지의 메모리 사용량을 측정하여 로컬 테스트를 통과하는 메모리 누수를 감지할 수 있습니다.

`performance.measureUserAgentSpecificMemory()`는 기존 `performance.memory` API와 어떻게 다른가요?

기존의 비표준 performance.memory API에 익숙하다면 새 API가 기존 API와 어떻게 다른지 궁금할 수 있습니다. 주요 차이점은 이전 API는 JavaScript 힙의 크기를 반환하는 반면 새 API는 웹페이지에서 사용하는 메모리를 추정한다는 것입니다. 이 차이는 Chrome이 여러 웹페이지(또는 동일한 웹페이지의 여러 인스턴스)와 동일한 힙을 공유할 때 중요합니다. 이 경우 이전 API의 결과가 임의로 해제될 수 있습니다. 이전 API는 '힙'과 같은 구현별 용어로 정의되므로 표준화할 수 없습니다.

또 다른 차이점은 새 API가 가비지 컬렉션 중에 메모리 측정을 실행한다는 것입니다. 이렇게 하면 결과의 노이즈가 줄어들지만 결과가 생성될 때까지 시간이 걸릴 수 있습니다. 다른 브라우저는 가비지 컬렉션에 의존하지 않고 새 API를 구현할 수 있습니다.

브라우저 호환성

Browser Support

Source

현재 이 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, 관련 창, 웹 작업자의 JavaScript 및 DOM 메모리가 포함됩니다.

breakdown 목록은 사용된 메모리에 관한 추가 정보를 제공합니다. 각 항목은 메모리의 일부를 설명하고 이를 URL로 식별되는 창, iframe, 작업자 집합에 할당합니다. types 필드에는 메모리와 연결된 구현별 메모리 유형이 나열됩니다.

모든 목록을 일반적인 방식으로 처리하고 특정 브라우저를 기반으로 가정을 하드코딩하지 않는 것이 중요합니다. 예를 들어 일부 브라우저는 빈 breakdown 또는 빈 attribution를 반환할 수 있습니다. 다른 브라우저는 attribution에 여러 항목을 반환하여 이러한 항목 중 어느 항목이 메모리를 소유하는지 구분할 수 없음을 나타낼 수 있습니다.

의견

웹 성능 커뮤니티 그룹과 Chrome팀은 performance.measureUserAgentSpecificMemory()에 관한 여러분의 의견과 경험을 듣고 싶습니다.

API 설계에 대해 알려주세요.

API가 예상대로 작동하지 않는 부분이 있나요? 아니면 아이디어를 구현하는 데 필요한 속성이 누락되어 있나요? performance.measureUserAgentSpecificMemory() GitHub 저장소에서 사양 문제를 제출하거나 기존 문제에 의견을 추가합니다.

구현 관련 문제 신고

Chrome 구현에서 버그를 발견하셨나요? 아니면 구현이 사양과 다른가요? new.crbug.com에서 버그를 신고합니다. 가능한 한 많은 세부정보를 포함하고 버그를 재현하는 간단한 안내를 제공하며 구성요소를 Blink>PerformanceAPIs로 설정해야 합니다.

후원하기

performance.measureUserAgentSpecificMemory()을 사용할 계획이신가요? 공개적인 지원은 Chrome팀이 기능의 우선순위를 정하는 데 도움이 되며 다른 브라우저 공급업체에 이러한 기능을 지원하는 것이 얼마나 중요한지 보여줍니다. @ChromiumDev에 트윗을 보내 어디에서 어떻게 사용하고 있는지 알려주세요.

유용한 링크

감사의 말씀

API 설계 검토를 도와준 도메닉 데니콜라, 요아브 바이스, 마티아스 바이넨스, Chrome의 코드 검토를 도와준 도미닉 인퓌르, 하네스 파이어, 켄타로 하라, 마이클 리파우츠에게 감사의 말씀을 전합니다. 또한 API를 크게 개선하는 데 도움이 되는 소중한 사용자 의견을 제공해 준 Per Parker, Philipp Weis, Olga Belomestnykh, Matthew Bolohan, Neil Mckay에게도 감사의 말을 전합니다.

measureUserAgentSpecificMemory()로 웹페이지의 총 메모리 사용량을 모니터링합니다. 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

performance.measureUserAgentSpecificMemory()는 기존 performance.memory API와 어떻게 다른가요?

추천 사용 사례