G1GC auf den Nachrichtenprozessoren aktivieren

Sie lesen gerade die Apigee Edge -Dokumentation.
Zur Apigee X -Dokumentation. info

In diesem Dokument wird beschrieben, wie Sie den Garbage First Garbage Collector (G1GC) auf den 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 kann es sinnvoll sein, den auf dem Message Processor verwendeten Garbage Collector -Typ zu ändern.

Der G1GC ist der Low-Pause-Garbage Collector der nächsten Generation im Serverstil für die Java HotSpot VM, der die Gesamtleistung des Message Processors verbessert. Er wurde in der Regel für Anwendungen mit mittelgroßen bis großen Datensätzen entwickelt, bei denen die Reaktionszeit wichtiger ist als der Gesamtdurchsatz. Beispiel: Sie können G1GC verwenden, wenn die Heap-Größe groß ist (über 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

G1GC auf den Message Processors aktivieren

In diesem Abschnitt wird beschrieben, wie Sie G1GC auf dem Edge Message Processor aktivieren. G1GC kann über die Eigenschaft useG1GC in der Message Processor-Komponente aktiviert werden. Standardmäßig ist diese Eigenschaft auf false den Message Processors gesetzt. Verwenden Sie das Token gemäß der Syntax, die unter Edge konfigurieren beschrieben ist, um eine beliebige Eigenschaft auf dem Message Processor zu konfigurieren.

Führen Sie die folgenden Schritte aus, um G1GC auf den Message Processors zu aktivieren:

  1. Token für die Eigenschaft „useG1GC“ suchen
  2. G1GC auf dem Message Processor aktivieren

Token für die Eigenschaft „useG1GC“ suchen

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

  1. Suchen Sie mit dem folgenden Befehl im Quellverzeichnis des Message Processors /opt/apigee/edge-message-processor/source 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 des Message Processors wie folgt: 
    /opt/apigee/edge-message-processor/source/conf/system.properties:useG1GC={T}conf_system_useG1GC{/T}

    Die String zwischen den Tags {T}{/T} ist der Name des Tokens, das Sie in der Datei .properties des Message Processors festlegen können. Das Token für die Eigenschaft useG1GC lautet also wie folgt: 

    conf_system_useG1GC

G1GC auf den Message Processors aktivieren

In den folgenden Schritten wird beschrieben, wie Sie G1GC auf den Apigee Message Processors aktivieren:

  1. Öffnen Sie die /opt/apigee/customer/application/message-processor.properties Datei 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 Nutzer apigee Eigentümer dieser Eigenschaften-Datei 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 Processors.

G1GC-Konfiguration auf den Message Processors prüfen

In diesem Abschnitt wird beschrieben, 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 die tatsächliche Eigenschaft 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 auf dem Message Processor erfolgreich aktiviert wurde, wird mit dem vorherigen Befehl der neue Wert in der Datei system.properties angezeigt.

    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 die Eigenschaft useG1GC in system.properties mit dem neuen Wert true festgelegt wurde. Das bedeutet, dass G1GC auf dem Message Processor erfolgreich aktiviert wurde.

  3. Wenn Sie immer noch den alten Wert für die Eigenschaft useG1GC sehen, 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.
  4. Wenn Sie G1GC immer noch nicht aktivieren können, wenden Sie sich an den Apigee Edge-Support.

Wie geht es weiter?

String-Deduplizierung auf Message Processors aktivieren