Sie sehen die Dokumentation zu Apigee Edge.
Zur Apigee X-Dokumentation weitere Informationen
In diesem Dokument wird erläutert, wie Sie den G1GC (G1GC) (Gubage First) auf den Message Processorn von Apigee Edge aktivieren.
Der Message Processor von Apigee Edge wird auf Java Virtual Machine (JVM) ausgeführt und verwendet die standardmäßige Garbage Collector – seriell oder parallel, je nach Hardware- und Betriebssystemkonfiguration. Unter bestimmten Umständen und je nach Ihren Anforderungen können Sie den Speicherbereinigungstyp des Message Processor ändern.
Das G1GC ist die Server-ähnliche Speicherbereinigung mit niedriger Pause für die Java HotSpot-VM, die die Gesamtleistung des Message Processor verbessert. Sie ist in der Regel für Anwendungen mit mittelgroßen bis großen Datasets konzipiert, bei denen die Antwortzeit wichtiger als der Gesamtdurchsatz ist. Beispiel: Sie können G1GC verwenden, wenn die Heap-Größe groß ist (größer als 3 GB).
Generell wird empfohlen, neben G1GC einen weiteren JVM-Parameter UseStringDeduplication
festzulegen. Dieser Parameter optimiert die Java-Heap-Speichernutzung, indem doppelte oder identische Stringwerte dasselbe Zeichenarray verwenden.
Hinweis
- Wenn Sie mit der automatischen Speicherbereinigung und verschiedenen Typen von automatischen Speicherbereinigungsvorgängen in Java nicht vertraut sind, lesen Sie die Grundlagen der automatischen Speicherbereinigung für Java.
- Wenn Sie mit G1GC noch nicht vertraut sind, lesen Sie die Informationen unter Erste Schritte mit der G1 Garbage Collector.
- Wenn Sie mit dem Konfigurieren von Eigenschaften für Edge in der Private Cloud nicht vertraut sind, lesen Sie Edge konfigurieren.
G1GC auf den Message Processorn aktivieren
In diesem Abschnitt wird erläutert, wie Sie G1GC auf dem Edge Message Processor aktivieren. G1GC kann über die Eigenschaft useG1GC
auf der Message Processor-Komponente aktiviert werden. Diese Eigenschaft ist für Message Processors standardmäßig auf false
gesetzt. Verwenden Sie das Token gemäß der in Edge konfigurieren beschriebenen Syntax, um eine Eigenschaft im Message Processor zu konfigurieren.
Führen Sie die folgenden Schritte aus, um G1GC auf den Message Processors zu aktivieren:
Token für das Attribut „useG1GC“ suchen
In den folgenden Schritten wird beschrieben, wie Sie das Token für das Attribut „useG1GC“ finden:
- Suchen Sie im Nachrichtenprozessor-Quellverzeichnis
/opt/apigee/edge-message-processor/source
mit dem folgenden Befehl nach der EigenschaftuseG1GC
:grep -ri "useG1GC" /opt/apigee/edge-message-processor/source
-
Die Ausgabe dieses Befehls zeigt das Token für die Eigenschaft
useG1GC
von Message Processor so:/opt/apigee/edge-message-processor/source/conf/system.properties:useG1GC={T}conf_system_useG1GC{/T}
Dabei ist der String zwischen den
{T}{/T}
-Tags der Name des Tokens, das Sie in der Datei.properties
des Message Processor festlegen können. Daher lautet das Token für das AttributuseG1GC
so:conf_system_useG1GC
G1GC auf den Message Processorn aktivieren
In den folgenden Schritten wird beschrieben, wie Sie G1GC auf den Apigee Message Processorn aktivieren:
-
Öffnen Sie die Datei
/opt/apigee/customer/application/message-processor.properties
auf dem Message Processor-Computer in einem Editor. Wenn die Datei noch nicht vorhanden ist, erstellen Sie sie. Beispiel:vi /opt/apigee/customer/application/message-processor.properties
-
Fügen Sie dieser Datei die folgende Zeile hinzu:
conf_system_useG1GC=true
- Speichern Sie die Änderungen.
-
Achten Sie darauf, dass der Inhaber dieser Property-Datei der Nutzer
apigee
ist. Beispiel:chown apigee:apigee /opt/apigee/customer/application/message-processor.properties
-
Starten Sie den Message Processor mit dem folgenden Befehl neu:
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
- Wenn Sie mehr als einen Message Processor haben, wiederholen Sie diese Schritte auf allen Message Processorn.
G1GC-Konfiguration auf den Message Processorn prüfen
In diesem Abschnitt wird erläutert, wie Sie überprüfen können, ob die G1GC-Konfiguration auf den Message Processorn erfolgreich geändert wurde.
Obwohl Sie das Token conf_system_useG1GC
verwenden, um G1GC im Message Processor zu aktivieren, müssen Sie prüfen, ob das tatsächliche Attribut useG1GC
mit dem neuen Wert festgelegt wurde:
-
Suchen Sie im Verzeichnis
/opt/apigee/edge-message-processor/conf
nach der EigenschaftuseG1GC
und prüfen Sie, ob sie mit dem neuen Wert festgelegt wurde. Beispiel:grep -ri "useG1GC" /opt/apigee/edge-message-processor/conf
-
Wenn G1GC erfolgreich auf dem Message Processor aktiviert wurde, zeigt der vorherige Befehl den neuen Wert in der Datei
system.properties
an.Das Beispielergebnis des vorherigen Befehls sieht nach der Aktivierung von G1GC im Message Processor so aus:
/opt/apigee/edge-message-processor/conf/system.properties:useG1GC=true
In der Beispielausgabe wurde das Attribut
useG1GC
mit dem neuen Werttrue
insystem.properties
festgelegt. Dies zeigt an, dass G1GC erfolgreich auf dem Message Processor aktiviert wurde. -
Wenn noch der alte Wert für das Attribut
useG1GC
angezeigt wird, prüfen Sie, ob Sie alle unter G1GC auf den Message Processors aktivieren beschriebenen Schritte korrekt ausgeführt haben. Wenn Sie einen Schritt ausgelassen haben, wiederholen Sie alle Schritte korrekt. - Wenn Sie G1GC immer noch nicht aktivieren können, wenden Sie sich an den Apigee Edge-Support.