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

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

이 문서에서는 Apigee Edge의 메시지 프로세서에서 문자열 중복 삭제를 사용 설정하는 방법을 설명합니다.

문자열 중복 삭제는 자바 애플리케이션에서 중복 문자열 객체가 차지하는 메모리를 절약하는 데 도움이 되는 자바 기능입니다. 중복되거나 동일한 문자열 값이 동일한 문자 배열을 공유하도록 하여 자바 힙 메모리에 있는 문자열 객체의 메모리 공간을 줄입니다.

Apigee Edge 메시지 프로세서는 자바 기반 구성요소입니다. 메시지 프로세서에서 문자열 중복 삭제를 사용하면 특히 API 프록시가 문자열을 많이 사용하는 경우 메모리 사용량을 줄여 API 프록시의 성능을 개선할 수 있습니다.

문자열 중복 삭제 기능은 자바 애플리케이션의 G1 가비지 컬렉터 (G1GC)에서만 사용할 수 있습니다. 메시지 프로세서에서 이 기능을 사용 설정하려면 이미 G1GC를 사용 설정하거나 메시지 프로세서에서 G1GC와 문자열 중복 삭제를 모두 사용 설정해야 합니다.

시작하기 전에

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

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

메시지 프로세서에서 문자열 중복 삭제를 사용 설정하려면 다음 단계를 따르세요.

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

useStringDeduplicate 속성의 토큰 찾기

다음 단계에서는 useStringDeremovals에 대한 토큰을 찾는 방법을 설명합니다.

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

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

    conf_system_useStringDeduplication

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

다음 단계에서는 Apigee 메시지 프로세서에서 문자열 중복 삭제를 사용 설정하는 방법을 설명합니다.

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

메시지 프로세서에서 문자열 중복 삭제 확인

이 섹션에서는 메시지 프로세서에서 문자열 중복 삭제가 사용 설정되어 있는지 확인하는 방법을 설명합니다.

conf_system_useStringDeduplication 토큰을 사용하여 메시지 프로세서에서 문자열 중복 삭제를 사용 설정하더라도 실제 속성 useStringDeduplication가 다음과 같이 새 값으로 설정되어 있는지 확인해야 합니다.

  1. /opt/apigee/edge-message-processor/conf 디렉터리에서 useStringDeduplication 속성을 검색하여 새 값으로 설정되었는지 확인합니다. 예: 
    grep -ri "useStringDeduplication" /opt/apigee/edge-message-processor/conf
  2. 메시지 프로세서에서 문자열 중복 삭제가 사용 설정되면 이전 명령어는 system.properties 파일에 새 값을 표시합니다.

    메시지 프로세서에서 문자열 중복 삭제를 사용 설정한 후 이전 명령의 샘플 결과는 다음과 같습니다. 

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

    예시 출력에서 속성 useStringDeduplication는 system.properties의 새 값 true로 설정되어 있습니다. 이는 메시지 프로세서에서 문자열 중복 삭제가 사용 설정되었음을 나타냅니다.

  3. useStringDeduplication 속성의 이전 값이 계속 표시되면 메시지 프로세서에서 문자열 중복 삭제 사용 설정에 설명된 모든 단계를 올바르게 수행했는지 확인합니다. 누락된 단계가 있으면 모든 단계를 다시 올바르게 반복합니다.
  4. 그래도 문자열 중복 삭제를 사용 설정할 수 없으면 Apigee 지원팀에 문의하세요.

다음 단계

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