메시지 프로세서에서 힙 메모리 크기 구성

현재 Apigee Edge 문서가 표시되고 있습니다.
Apigee X 문서로 이동
정보

Apigee Edge의 메시지 프로세서는 자바 기반 구성요소이며 기본 힙 메모리 크기인 512MB를 사용합니다. 하지만 기본 힙 메모리 크기가 Apigee Edge의 모든 사용 사례에 충분하지 않을 수 있습니다. 트래픽 및 처리 요구사항에 따라 또는 메모리 관련 문제를 해결하려면 메시지 프로세서의 힙 메모리 크기를 조정해야 할 수 있습니다.

자바 애플리케이션의 힙 메모리 크기는 자바 명령줄 매개변수 -Xms (최소 힙 크기) 및 -Xmx (최대 힙 크기)를 통해 제어됩니다. Apigee Edge 메시지 프로세서에서 bin_setenv_min_membin_setenv_max_mem 속성을 통해 제어됩니다. 이러한 속성에 관한 자세한 내용은 자바 메모리 설정 수정을 참고하세요.

이 문서에서는 Apigee Edge의 메시지 프로세서에서 힙 메모리 크기를 구성하는 방법을 설명합니다.

시작하기 전에

메시지 프로세서에서 힙 메모리 크기 변경

이 섹션에서는 메시지 프로세서에서 힙 메모리 크기를 변경하는 방법을 설명합니다. 메시지 프로세서 구성요소의 bin_setenv_min_membin_setenv_max_mem 속성을 통해 최소 및 최대 힙 메모리를 구성할 수 있습니다.

메시지 프로세서에서 힙 메모리 크기를 변경하려면 다음 단계를 수행합니다.

  1. 편집기의 메시지 프로세서 머신에서 /opt/apigee/customer/application/message-processor.properties 파일을 엽니다. 파일이 아직 없으면 새로 만듭니다. 예:
    vi /opt/apigee/customer/application/message-processor.properties
    
  2. 이 파일에 다음 줄을 추가합니다.
    bin_setenv_min_mem=minimum_heap_in_megabytes
    bin_setenv_max_mem=maximum_heap_in_megabytes
    

    예를 들어 메시지 프로세서의 최소 및 최대 힙을 각각 1GB와 2GB로 변경하려면 이 파일에 다음 줄을 추가합니다.

    bin_setenv_min_mem=1024m
    bin_setenv_max_mem=2048m
    
  3. 변경사항을 저장합니다.
  4. 이 속성 파일을 apigee 사용자가 소유하고 있는지 확인하세요. 예:
    chown apigee:apigee /opt/apigee/customer/application/message-processor.properties
    
  5. 다음 명령어를 사용하여 메시지 프로세서를 다시 시작합니다.
    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
    
  6. 메시지 프로세서가 두 개 이상인 경우 모든 메시지 프로세서에서 이 단계를 반복합니다.

메시지 프로세서에서 힙 메모리 크기 확인

이 섹션에서는 힙 메모리 변경사항이 메시지 프로세서에서 성공적으로 수정되었는지 확인하는 방법을 설명합니다.

bin_setenv_min_membin_setenv_max_mem 속성을 사용하여 메시지 프로세서의 힙 메모리 크기를 변경했더라도 실제 Java 명령줄 매개변수 -Xms-Xmx가 다음과 같은 새 값으로 설정되어 있는지 확인해야 합니다.

  1. 다음 명령어를 사용하여 명령줄 매개변수 -Xms-Xmx가 메시지 프로세서의 새 값으로 설정되어 있는지 검색합니다.
    ps -ef | grep message-processor | egrep -o 'Xms[0-9a-z]+|Xmx[0-9a-z]+' | tr '\r' ' '
    
  2. 메시지 프로세서에서 최소 및 최대 힙 메모리가 변경된 경우 이전 명령어는 -Xms-Xmx에 대해 나열된 새 값을 표시합니다.

    메시지 프로세서의 최소 및 최대 힙을 변경한 후 이전 명령어의 샘플 결과는 다음과 같습니다.

    Xms1024m
    Xmx2048m
    

    예시 출력에서 최소 및 최대 힙의 새 값이 설정되어 있는지 확인합니다.

  3. -Xms-Xmx의 이전 값이 계속 표시되면 메시지 프로세서에서 힙 메모리 크기 변경에 설명된 모든 단계를 올바르게 수행했는지 확인합니다. 누락된 단계가 있으면 모든 단계를 다시 올바르게 반복합니다.
  4. 그래도 힙 메모리를 변경할 수 없으면 Apigee Edge 지원팀에 문의하세요.

다음 단계