Włączanie G1GC w procesorach wiadomości

Wyświetlasz dokumentację Apigee Edge.
Przejdź do dokumentacji Apigee X. info

Z tego dokumentu dowiesz się, jak włączyć moduł odśmiecania pamięci Garbage First (G1GC) na procesorach komunikatów 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 na procesorze komunikatów.

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. Zwykle jest on przeznaczony dla aplikacji z zestawami danych o średniej lub dużej wielkości, w których czas reakcji jest ważniejszy niż ogólna przepustowość. Na przykład: możesz rozważyć użycie 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 współdzielą tę samą tablicę znaków.

Zanim zaczniesz

Włączanie G1GC na procesorach komunikatów

W tej sekcji wyjaśniono, jak włączyć G1GC na 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 na procesorach komunikatów. Aby skonfigurować dowolną właściwość na procesorze wiadomości, użyj tokena zgodnie ze składnią opisaną w artykule Jak skonfigurować Edge.

Aby włączyć G1GC na procesorach komunikatów, wykonaj następujące kroki:

  1. Znajdź token dla właściwości useG1GC
  2. Włącz G1GC na 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 komunikatów 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 komunikatów. Token dla właściwości useG1GC jest więc taki: 

    conf_system_useG1GC

Włącz G1GC na procesorach komunikatów

Aby włączyć G1GC na procesorach komunikatów 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 na procesorach komunikatów

W tej sekcji dowiesz się, jak sprawdzić, czy konfiguracja G1GC została prawidłowo zmieniona na procesorach komunikatów.

Mimo że do włączenia G1GC na 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 na procesorze komunikatów, poprzednie polecenie pokaże nową wartość w pliku system.properties.

    Przykładowy wynik poprzedniego polecenia po włączeniu G1GC na 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 na 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 Włączanie G1GC na procesorach komunikatów. 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 na procesorach komunikatów