G1GC auf den Nachrichtenprozessoren aktivieren

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

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:

  1. Token für das Attribut „useG1GC“ suchen
  2. G1GC auf Message Processor aktivieren

Token für das Attribut „useG1GC“ suchen

In den folgenden Schritten wird beschrieben, wie Sie das Token für das Attribut „useG1GC“ finden:

  1. Suchen Sie im Nachrichtenprozessor-Quellverzeichnis /opt/apigee/edge-message-processor/source mit dem folgenden Befehl nach der Eigenschaft useG1GC:
    grep -ri "useG1GC" /opt/apigee/edge-message-processor/source
    
  2. 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 Attribut useG1GC 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:

  1. Ö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
    
  2. Fügen Sie dieser Datei die folgende Zeile hinzu:
    conf_system_useG1GC=true
    
  3. Speichern Sie die Änderungen.
  4. Achten Sie darauf, dass der Inhaber dieser Property-Datei der Nutzer apigee ist. Beispiel:
    chown apigee:apigee /opt/apigee/customer/application/message-processor.properties
    
  5. Starten Sie den Message Processor mit dem folgenden Befehl neu:
    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
    
  6. 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:

  1. Suchen Sie im Verzeichnis /opt/apigee/edge-message-processor/conf nach der Eigenschaft useG1GC und prüfen Sie, ob sie mit dem neuen Wert festgelegt wurde. Beispiel:
    grep -ri "useG1GC" /opt/apigee/edge-message-processor/conf
    
  2. 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 Wert true in system.properties festgelegt. Dies zeigt an, dass G1GC erfolgreich auf dem Message Processor aktiviert wurde.

  3. 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.
  4. Wenn Sie G1GC immer noch nicht aktivieren können, wenden Sie sich an den Apigee Edge-Support.

Wie geht es weiter?

Stringdeduplizierung bei Message Processorn aktivieren