Sie lesen gerade die Dokumentation zu Apigee Edge.
Zur Dokumentation zu
Apigee X. info
In diesem Dokument wird erläutert, wie Sie den Garbage Collector Garbage First (G1GC) für die Message Processors von Apigee Edge aktivieren.
Der Message Processor von Apigee Edge wird auf einer Java Virtual Machine (JVM) ausgeführt und verwendet den Standard-Garbage Collector – seriell oder parallel, je nach Hardware- und Betriebssystemkonfigurationen. Unter bestimmten Umständen und je nach Ihren Anforderungen möchten Sie möglicherweise den Garbage Collector -Typ ändern, der auf dem Message Processor verwendet wird.
Der G1GC ist der generische Garbage Collector im Serverstil mit geringen Pausen für die Java HotSpot VM, der die Gesamtleistung des Message Processors verbessert. Er ist in der Regel für Anwendungen mit mittelgroßen bis großen Datensätzen konzipiert, bei denen die Reaktionszeit wichtiger ist als der Gesamtdurchsatz. Beispiel: Sie können G1GC verwenden, wenn die Heap-Größe groß ist (mehr als 3 GB).
Im Allgemeinen wird empfohlen, zusammen mit G1GC einen anderen JVM-Parameter UseStringDeduplication festzulegen. Dieser Parameter optimiert die Arbeitsspeichernutzung des Java-Heaps, indem er dafür sorgt, dass doppelte oder identische String-Werte dasselbe Zeichenarray verwenden.
Hinweis
- Wenn Sie mit der automatischen Speicherbereinigung und den verschiedenen Arten von Garbage Collectors in Java nicht vertraut sind, lesen Sie den Artikel Grundlagen der Java-Garbage Collection.
- Wenn Sie mit G1GC nicht vertraut sind, lesen Sie Erste Schritte mit dem G1-Garbage Collector.
- Wenn Sie mit dem Konfigurieren von Attributen für Edge in Private Cloud nicht vertraut sind, lesen Sie den Artikel Edge konfigurieren.
G1GC auf den Message Processors aktivieren
In diesem Abschnitt wird erläutert, wie Sie G1GC auf dem Edge Message Processor aktivieren. G1GC kann über das Attribut useG1GC in der Message Processor-Komponente aktiviert werden. Standardmäßig ist dieses
Attribut auf den Message Processors auf false gesetzt. Verwenden Sie zum Konfigurieren eines Attributs auf dem Message
Processor das Token gemäß der Syntax, die unter
Edge konfigurieren beschrieben ist.
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 mit dem folgenden Befehl im Quellverzeichnis des Message Processors
/opt/apigee/edge-message-processor/sourcenach dem AttributuseG1GC:grep -ri "useG1GC" /opt/apigee/edge-message-processor/source
-
Die Ausgabe dieses Befehls zeigt das Token für das Attribut
useG1GCdes Message Processors wie folgt:/opt/apigee/edge-message-processor/source/conf/system.properties:useG1GC={T}conf_system_useG1GC{/T}Dabei ist der String zwischen den Tags
{T}{/T}der Name des Tokens, das Sie in der.propertiesDatei des Message Processors festlegen können. Das Token für das AttributuseG1GClautet also:conf_system_useG1GC
G1GC auf den Message Processors aktivieren
In den folgenden Schritten wird beschrieben, wie Sie G1GC auf den Apigee Message Processors aktivieren:
-
Öffnen Sie die
/opt/apigee/customer/application/message-processor.propertiesDatei 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 Nutzer
apigeeEigentümer dieser Attributdatei 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 Processors.
G1GC-Konfiguration auf den Message Processors überprüfen
In diesem Abschnitt wird erläutert, wie Sie prüfen, ob die G1GC-Konfiguration auf den Message Processors erfolgreich geändert wurde.
Obwohl Sie das Token conf_system_useG1GC verwenden, um G1GC auf dem Message
Processor zu aktivieren, müssen Sie prüfen, ob das Attribut useG1GC mit dem
neuen Wert festgelegt wurde:
-
Suchen Sie im Verzeichnis
/opt/apigee/edge-message-processor/confnach dem AttributuseG1GCund prüfen Sie, ob es mit dem neuen Wert festgelegt wurde. Beispiel:grep -ri "useG1GC" /opt/apigee/edge-message-processor/conf
-
Wenn G1GC auf dem Message Processor erfolgreich aktiviert wurde, zeigt der vorherige Befehl
den neuen Wert in der
system.propertiesDatei an.Das Beispielergebnis des vorherigen Befehls, nachdem Sie G1GC auf dem Message Processor aktiviert haben, sieht so aus:
/opt/apigee/edge-message-processor/conf/system.properties:useG1GC=true
Beachten Sie in der Beispielausgabe, dass das Attribut
useG1GCinsystem.propertiesmit dem neuen Werttruefestgelegt wurde. Das bedeutet, dass G1GC auf dem Message Processor erfolgreich aktiviert wurde. -
Wenn Sie immer noch den alten Wert für das Attribut
useG1GCsehen, prüfen Sie, ob Sie alle Schritte unter G1GC auf den Message Processors aktivieren korrekt ausgeführt haben. Wenn Sie einen Schritt ausgelassen haben, wiederholen Sie alle Schritte noch einmal. - Wenn Sie G1GC immer noch nicht aktivieren können, wenden Sie sich an den Apigee Edge-Support.