Włączanie G1GC w procesorach wiadomości

Przeglądasz dokumentację Apigee Edge.
Otwórz dokumentację Apigee X. Informacje

Ten dokument wyjaśnia, jak włączyć procesor do czyszczenia pamięci śmieci (G1GC) w procesorach wiadomości Apigee Edge.

Procesor wiadomości w Apigee Edge działa w maszynie wirtualnej Java (JVM) i używa domyślnego kolektora pamięci (Serbage Collector), który jest szeregowy lub równoległy w zależności od konfiguracji sprzętu i systemu operacyjnego. W pewnych okolicznościach i zależnie od swoich potrzeb możesz zmienić typ kosza na śmieci używany w procesorze wiadomości.

G1GC to generatywny kolektor czyszczenia pamięci dla maszyny wirtualnej Java HotSpot o niskiej wydajności, który działa w stylu serwera i zwiększa ogólną wydajność procesora wiadomości. Zwykle jest on przeznaczony dla aplikacji obejmujących średnie i duże zbiory danych, w których czas odpowiedzi jest ważniejszy niż ogólna przepustowość. Jeśli na przykład rozmiar sterty jest duży (ponad 3 GB), możesz rozważyć użycie G1GC.

Ogólnie zalecamy ustawienie innego parametru JVM UseStringDeduplicationwraz z G1GC. Ten parametr optymalizuje wykorzystanie pamięci sterty Java, ponieważ zduplikowane lub identyczne wartości ciągu znaków mają 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 wiadomości Edge. G1GC można włączyć za pomocą właściwości useG1GC w komponencie Message Processor. Domyślnie ta właściwość w procesorach wiadomości ma wartość false. Aby skonfigurować dowolną właściwość w procesorze wiadomości, użyj tokena zgodnie ze składnią opisaną w artykule Jak skonfigurować Edge.

Aby włączyć G1GC w procesorach wiadomości, wykonaj te czynności:

  1. Znajdowanie tokena na potrzeby właściwości useG1GC
  2. Włączanie G1GC w procesorze wiadomości

Zlokalizuj token na potrzeby właściwości useG1GC

Aby znaleźć token na potrzeby właściwości useG1GC, wykonaj te czynności:

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

    Gdzie ciąg znaków między tagami {T}{/T} to nazwa tokena, który możesz ustawić w pliku .properties procesora wiadomości. Dlatego token właściwości useG1GC wygląda tak: 

    conf_system_useG1GC

Włącz G1GC w procesorach wiadomości

Poniżej znajdziesz instrukcje włączania G1GC w procesorach wiadomości Apigee:

  1. Otwórz plik /opt/apigee/customer/application/message-processor.properties na komputerze procesora wiadomości w edytorze. Jeśli plik jeszcze nie istnieje, utwórz go. 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 ten plik właściwości należy do użytkownika apigee. Przykład: 
    chown apigee:apigee /opt/apigee/customer/application/message-processor.properties
  5. Ponownie uruchom procesor wiadomości, używając tego polecenia:
    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
  6. Jeśli masz więcej niż jeden procesor wiadomości, powtórz te kroki na wszystkich z nich.

Weryfikowanie konfiguracji G1GC w procesorach wiadomości

Ta sekcja wyjaśnia, jak sprawdzić, czy konfiguracja G1GC została pomyślnie zmodyfikowana w procesorach wiadomości.

Mimo że używasz tokena conf_system_useG1GC do włączania G1GC w procesorze wiadomości, musisz sprawdzić, czy właściwość useG1GC ma ustawioną nową wartość:

  1. Wyszukaj właściwość useG1GC w katalogu /opt/apigee/edge-message-processor/conf i sprawdź, czy została ustawiona nowa wartość. Przykład: 
    grep -ri "useG1GC" /opt/apigee/edge-message-processor/conf
  2. Jeśli usługa G1GC zostanie włączona w procesorze wiadomości, poprzednie polecenie wyświetli nową wartość w pliku system.properties.

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

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

    W przykładowych danych wyjściowych zwróć uwagę, że właściwość useG1GC została ustawiona w system.properties z nową wartością true. Oznacza to, że usługa G1GC została włączona w procesorze wiadomości.

  3. Jeśli nadal widzisz starą wartość właściwości useG1GC, sprawdź, czy zostały prawidłowo wykonane wszystkie czynności opisane w sekcji Włączanie G1GC w procesorach wiadomości. Jeśli pominięto jakiś krok, powtórz wszystkie kroki ponownie.
  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