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

Apigee Edge 문서입니다.
Go to the Apigee X 문서로 이동합니다. info

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

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

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

시작하기 전에

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

이 섹션에서는 메시지 프로세서에서 힙 메모리 크기를 변경하는 방법을 설명합니다. 최소 및 최대 힙 메모리는 메시지 프로세서 구성요소의 bin_setenv_min_mem 및 bin_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_mem 및 bin_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 지원팀에 문의하세요.

다음 단계