Deduplizierung von Strings für Nachrichtenprozessoren aktivieren

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

In diesem Dokument wird erläutert, wie Sie die String-Deduplizierung auf den Message Processors von Apigee Edge aktivieren.

Die String-Deduplizierung ist ein Java-Feature, mit dem Sie Arbeitsspeicher sparen können, der von doppelten String Objekten in Java-Anwendungen belegt wird. Es reduziert den Speicherbedarf von String-Objekten im Java-Heap Speicher, indem die doppelten oder identischen String-Werte dasselbe Zeichenarray verwenden.

Der Apigee Edge Message Processor ist eine Java-basierte Komponente. Durch die Verwendung der String-Deduplizierung in einem Message Processor kann die Leistung Ihrer API-Proxys verbessert werden, da die Arbeitsspeichernutzung reduziert wird. Dies gilt insbesondere wenn die API-Proxys Strings intensiv nutzen.

Das Feature zur String-Deduplizierung kann nur mit dem G1 Garbage Collector (G1GC) in Java Anwendungen verwendet werden. Wenn Sie dieses Feature auf dem Message Processor aktivieren möchten, muss G1GC bereits aktiviert sein. Alternativ können Sie G1GC und die String-Deduplizierung zusammen auf dem Message Processor aktivieren.

Hinweis

String-Deduplizierung auf den Message Processors aktivieren

In diesem Abschnitt wird erläutert, wie Sie das Feature zur String-Deduplizierung auf den Edge Message Processors aktivieren. Die String-Deduplizierung kann über das Attribut useStringDeduplication in der Message Processor-Komponente aktiviert werden. Standardmäßig ist dieses Attribut auf den Message Processors auf „false“ gesetzt. Wenn Sie ein Attribut auf dem Message Processor konfigurieren möchten, verwenden Sie das Token gemäß der Syntax, die unter Edge konfigurieren beschrieben ist.

So aktivieren Sie die String-Deduplizierung auf den Message Processors:

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

Token für das Attribut „useStringDeduplication“ suchen

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

  1. Suchen Sie mit dem folgenden Befehl im Quellverzeichnis des Message Processor /opt/apigee/edge-message-processor/source nach dem Attribut useStringDeduplication: 
    grep -ri "useStringDeduplication" /opt/apigee/edge-message-processor/source
  2. Die Ausgabe dieses Befehls zeigt das Token für das Attribut useStringDeduplication des Message Processor so: 
    /opt/apigee/edge-message-processor/source/conf/system.properties:useStringDeduplication={T}conf_system_useStringDeduplication{/T}

    Der String zwischen den Tags {T}{/T} ist der Name des Tokens, das Sie in der Datei .properties des Message Processor festlegen können. Das Token für das Attribut useStringDeduplication ist also: 

    conf_system_useStringDeduplication

String-Deduplizierung auf den Message Processors aktivieren

So aktivieren Sie die String-Deduplizierung auf den Apigee Message Processors:

  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_useStringDeduplication=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.

String-Deduplizierung auf den Message Processors prüfen

In diesem Abschnitt wird erläutert, wie Sie prüfen, ob die String-Deduplizierung auf den Message Processors erfolgreich aktiviert wurde.

Obwohl Sie das Token conf_system_useStringDeduplication verwenden, um die String Deduplizierung auf dem Message Processor zu aktivieren, müssen Sie prüfen, ob das tatsächliche Attribut useStringDeduplication mit dem neuen Wert festgelegt wurde:

  1. Suchen Sie im Verzeichnis /opt/apigee/edge-message-processor/conf nach dem Attribut useStringDeduplication und prüfen Sie, ob es mit dem neuen Wert festgelegt wurde. Beispiel: 
    grep -ri "useStringDeduplication" /opt/apigee/edge-message-processor/conf
  2. Wenn die String-Deduplizierung 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 die String-Deduplizierung auf dem Message Processor aktiviert haben, sieht so aus: 

    /opt/apigee/edge-message-processor/conf/system.properties:useStringDeduplication=true

    In der Beispielausgabe sehen Sie, dass das Attribut useStringDeduplication in system.properties auf den neuen Wert true gesetzt wurde. Das bedeutet, dass die String-Deduplizierung auf dem Message Processor erfolgreich aktiviert wurde.

  3. Wenn Sie immer noch den alten Wert für das Attribut useStringDeduplication sehen, dann prüfen Sie, ob Sie alle Schritte unter String-Deduplizierung auf den Message Processors aktivieren korrekt ausgeführt haben. Wenn Sie einen Schritt ausgelassen haben, wiederholen Sie alle Schritte noch einmal.
  4. Wenn Sie die String-Deduplizierung immer noch nicht aktivieren können, wenden Sie sich an den Apigee-Support.

Wie geht es weiter?

G1GC auf den Message Processors aktivieren