메시지 프로세서에서 G1GC 사용 설정

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

이 문서에서는 Apigee Edge의 메시지 프로세서에서 Garbage First Garbage Collector (G1GC)를 사용 설정하는 방법을 설명합니다.

Apigee Edge의 메시지 프로세서는 Java Virtual Machine(JVM)에서 실행되며 하드웨어 및 운영체제 구성에 따라 기본 Garbage Collector(직렬 또는 병렬)를 사용합니다. 특정 상황 및 요구사항에 따라 메시지 프로세서에서 사용되는 Garbage Collector 유형을 변경할 수 있습니다.

G1GC는 Java HotSpot VM의 일시중지 시간이 짧은 서버 스타일의 세대별 Garbage Collector로, 메시지 프로세서의 전반적인 성능을 개선합니다. 일반적으로 전체 처리량보다 응답 시간이 더 중요한 중대형 데이터 세트가 있는 애플리케이션을 위해 설계되었습니다. 예를 들어 힙 크기가 큰 경우 (3GB 초과) G1GC 사용을 고려할 수 있습니다.

일반적으로 G1GC와 함께 다른 JVM 매개변수 UseStringDeduplicationalong 을 설정하는 것이 좋습니다. 이 매개변수는 중복되거나 동일한 String 값이 동일한 문자 배열을 공유하도록 하여 Java 힙 메모리 사용량을 최적화합니다.

시작하기 전에

메시지 프로세서에서 G1GC 사용 설정

이 섹션에서는 Edge 메시지 프로세서에서 G1GC를 사용 설정하는 방법을 설명합니다. G1GC는 메시지 프로세서 구성요소의 useG1GC 속성을 통해 사용 설정할 수 있습니다. 기본적으로 이 속성은 false 메시지 프로세서에서 설정됩니다. 메시지 프로세서에서 속성을 구성하려면 Edge 구성 방법에 설명된 구문에 따라 토큰을 사용하세요.

메시지 프로세서에서 G1GC를 사용 설정하려면 다음 단계를 수행하세요.

  1. useG1GC 속성의 토큰 찾기
  2. 메시지 프로세서에서 G1GC 사용 설정

useG1GC 속성의 토큰 찾기

다음 단계에서는 useG1GC 속성의 토큰을 찾는 방법을 설명합니다.

  1. 다음 명령어를 사용하여 메시지 프로세서 소스 디렉터리 /opt/apigee/edge-message-processor/source에서 useG1GC 속성을 검색합니다. 
    grep -ri "useG1GC" /opt/apigee/edge-message-processor/source
  2. 이 명령어의 출력은 다음과 같이 메시지 프로세서 속성 useG1GC 의 토큰을 보여줍니다. 
    /opt/apigee/edge-message-processor/source/conf/system.properties:useG1GC={T}conf_system_useG1GC{/T}

    여기서 {T}{/T} 태그 사이의 문자열은 메시지 프로세서의 .properties 파일에서 설정할 수 있는 토큰의 이름입니다. 따라서 속성useG1GC의 토큰은 다음과 같습니다. 

    conf_system_useG1GC

메시지 프로세서에서 G1GC 사용 설정

다음 단계에서는 Apigee 메시지 프로세서에서 G1GC를 사용 설정하는 방법을 설명합니다.

  1. 편집기에서 메시지 프로세서 머신의 /opt/apigee/customer/application/message-processor.properties 파일 을 엽니다. 파일이 아직 없는 경우 파일을 만듭니다. 예를 들면 다음과 같습니다. 
    vi /opt/apigee/customer/application/message-processor.properties
  2. 이 파일에 다음 줄을 추가합니다. 
    conf_system_useG1GC=true
  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. 메시지 프로세서가 두 개 이상인 경우 모든 메시지 프로세서에서 이 단계를 반복합니다.

메시지 프로세서에서 G1GC 구성 확인

이 섹션에서는 메시지 프로세서에서 G1GC 구성이 성공적으로 수정되었는지 확인하는 방법을 설명합니다.

메시지 프로세서에서 G1GC를 사용 설정하기 위해 토큰 conf_system_useG1GC를 사용하더라도 실제 속성 useG1GC가 다음과 같이 새 값으로 설정되었는지 확인해야 합니다.

  1. /opt/apigee/edge-message-processor/conf 디렉터리에서 useG1GC 속성을 검색하고 새 값으로 설정되었는지 확인합니다. 예를 들면 다음과 같습니다. 
    grep -ri "useG1GC" /opt/apigee/edge-message-processor/conf
  2. 메시지 프로세서에서 G1GC가 성공적으로 사용 설정되면 이전 명령어는 새 값을 system.properties 파일에 표시합니다.

    메시지 프로세서에서 G1GC를 사용 설정한 후 이전 명령어의 샘플 결과는 다음과 같습니다. 

    /opt/apigee/edge-message-processor/conf/system.properties:useG1GC=true

    예시 출력에서 useG1GC 속성이 system.properties에서 새 값 true로 설정되었음을 확인합니다. 이는 메시지 프로세서에서 G1GC가 성공적으로 사용 설정되었음을 나타냅니다.

  3. useG1GC 속성의 이전 값이 계속 표시되면 메시지 프로세서에서 G1GC 사용 설정에 설명된 모든 단계를 올바르게 따랐는지 확인합니다. 단계를 누락한 경우 모든 단계를 다시 올바르게 반복합니다.
  4. 그래도 G1GC를 사용 설정할 수 없는 경우 Apigee Edge 지원팀에 문의하세요.

다음 단계

메시지 프로세서에서 문자열 중복 삭제 사용 설정