G1GC auf den Nachrichtenprozessoren aktivieren

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

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:

  1. Token für das Attribut useG1GC suchen
  2. G1GC auf dem 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 mit dem folgenden Befehl im Quellverzeichnis des Message Processors /opt/apigee/edge-message-processor/source nach dem Attribut useG1GC:
    grep -ri "useG1GC" /opt/apigee/edge-message-processor/source
  2. Die Ausgabe dieses Befehls zeigt das Token für das Attribut useG1GC des 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 .properties Datei des Message Processors festlegen können. Das Token für das Attribut useG1GC lautet 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:

  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 Attributdatei 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 ü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:

  1. Suchen Sie im Verzeichnis /opt/apigee/edge-message-processor/conf nach dem Attribut useG1GC und prüfen Sie, ob es 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, zeigt der vorherige Befehl den neuen Wert in der system.properties Datei 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 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 das Attribut 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