Włączanie G1GC w procesorach wiadomości

Wyświetlasz dokumentację Apigee Edge.
Otwórz dokumentację Apigee X. info

Z tego dokumentu dowiesz się, jak włączyć Garbage First Garbage Collector (G1GC) w procesorach wiadomości Apigee Edge.

Procesor wiadomości Apigee Edge działa na maszynie wirtualnej Java (JVM) i używa domyślnego modułu odśmiecania pamięci – szeregowego lub równoległego – w zależności od konfiguracji sprzętu i systemu operacyjnego. W pewnych okolicznościach i w zależności od potrzeb możesz zmienić typ modułu odśmiecania pamięci używanego w procesorze wiadomości.

G1GC to generacyjne odśmiecanie pamięci w stylu serwerowym, które minimalizuje przerwy w działaniu i jest przeznaczone dla maszyny wirtualnej Java HotSpot. Poprawia ono ogólną wydajność procesora komunikatów. Zazwyczaj jest on przeznaczony dla aplikacji z zestawami danych o średniej lub dużej wielkości, w których czas odpowiedzi jest ważniejszy niż ogólna przepustowość. Na przykład: możesz użyć G1GC, jeśli rozmiar sterty jest duży (ponad 3 GB).

Ogólnie zaleca się ustawienie innego parametru JVM UseStringDeduplication wraz z G1GC. Ten parametr optymalizuje wykorzystanie pamięci sterty Java, dzięki czemu duplikaty lub identyczne wartości String mogą współdzielić tę samą tablicę znaków.

Zanim zaczniesz

Włączanie G1GC w procesorach wiadomości

W tej sekcji wyjaśniono, jak włączyć G1GC w procesorze komunikatów Edge. G1GC można włączyć za pomocą właściwości useG1GC w komponencie procesora komunikatów. Domyślnie ta właściwość jest ustawiona na false w procesorach wiadomości. Aby skonfigurować dowolną właściwość w procesorze wiadomości, użyj tokena zgodnie ze składnią opisaną w artykule Konfigurowanie Edge.

Aby włączyć G1GC w procesorach wiadomości:

  1. Znajdź token dla właściwości useG1GC.
  2. Włącz G1GC w procesorze komunikatów.

Znajdź token dla właściwości useG1GC

Aby znaleźć token dla właściwości useG1GC:

  1. Wyszukaj właściwość useG1GC w katalogu źródłowym procesora komunikatów /opt/apigee/edge-message-processor/source za pomocą tego polecenia: 
    grep -ri "useG1GC" /opt/apigee/edge-message-processor/source
  2. Wynik tego polecenia pokazuje token dla właściwości procesora wiadomości useG1GC w ten sposób: 
    /opt/apigee/edge-message-processor/source/conf/system.properties:useG1GC={T}conf_system_useG1GC{/T}

    Ciąg znaków między tagami {T}{/T} to nazwa tokena, który możesz ustawić w pliku .properties procesora wiadomości. Token dla właściwości useG1GC jest więc taki: 

    conf_system_useG1GC

Włączanie G1GC w procesorach wiadomości

Aby włączyć G1GC w procesorach wiadomości Apigee:

  1. Otwórz plik /opt/apigee/customer/application/message-processor.properties na maszynie procesora komunikatów w edytorze. Jeśli plik nie istnieje, utwórz go. Na przykład: 
    vi /opt/apigee/customer/application/message-processor.properties
  2. Dodaj do tego pliku ten wiersz: 
    conf_system_useG1GC=true
  3. Zapisz zmiany.
  4. Upewnij się, że właścicielem tego pliku właściwości jest użytkownik apigee. Na przykład: 
    chown apigee:apigee /opt/apigee/customer/application/message-processor.properties
  5. Uruchom ponownie procesor komunikatów za pomocą tego polecenia: 
    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
  6. Jeśli masz więcej niż jeden procesor komunikatów, powtórz te czynności na wszystkich procesorach komunikatów.

Sprawdzanie konfiguracji G1GC w procesorach wiadomości

W tej sekcji dowiesz się, jak sprawdzić, czy konfiguracja G1GC została prawidłowo zmieniona w procesorach wiadomości.

Mimo że do włączenia G1GC w procesorze wiadomości używasz tokena conf_system_useG1GC, musisz sprawdzić, czy rzeczywista właściwość useG1GC została ustawiona na nową wartość w ten sposób:

  1. Wyszukaj właściwość useG1GC w katalogu /opt/apigee/edge-message-processor/conf i sprawdź, czy została ustawiona na nową wartość. Na przykład: 
    grep -ri "useG1GC" /opt/apigee/edge-message-processor/conf
  2. Jeśli G1GC zostanie prawidłowo włączony w procesorze komunikatów, poprzednie polecenie pokaże nową wartość w pliku system.properties.

    Przykładowy wynik poprzedniego polecenia po włączeniu G1GC w procesorze wiadomości: 

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

    W przykładowym wyniku zwróć uwagę, że właściwość useG1GC została ustawiona na nową wartość true w pliku system.properties. Oznacza to, że G1GC został prawidłowo włączony w procesorze komunikatów.

  3. Jeśli nadal widzisz starą wartość właściwości useG1GC, sprawdź, czy prawidłowo wykonano wszystkie czynności opisane w sekcji Włączanie G1GC w procesorach wiadomości. Jeśli pominiesz jakiś krok, powtórz wszystkie czynności.
  4. Jeśli nadal nie możesz włączyć G1GC, skontaktuj się z zespołem pomocy Apigee Edge.

Co dalej?

Włączanie deduplikacji ciągów znaków w procesorach wiadomości