Sie sehen die Dokumentation zu Apigee Edge.
Zur Apigee X-Dokumentation weitere Informationen
In diesem Dokument wird erläutert, wie Sie die Stringdeduplizierung auf den Message Processorn von Apigee Edge aktivieren.
Die Stringdeduplizierung ist eine Java-Funktion, mit der Sie in Java-Anwendungen Arbeitsspeicher sparen können, die von doppelten Stringobjekten belegt sind. Es reduziert den Speicherbedarf von String-Objekten im Java-Heap-Speicher, da die doppelten oder identischen String-Werte dasselbe Zeichenarray verwenden.
Der Apigee Edge Message Processor ist eine Java-basierte Komponente. Die Verwendung der Stringdeduplizierung in einem Nachrichtenprozessor kann die Leistung Ihrer API-Proxys verbessern, da die Arbeitsspeichernutzung reduziert wird. Dies gilt insbesondere, wenn die API-Proxys die Strings stark nutzen.
Das Feature zur Stringdeduplizierung kann nur mit G1 Garbage Collector (G1GC) in Java-Anwendungen verwendet werden. Wenn Sie diese Funktion für den Message Processor aktivieren möchten, muss G1GC bereits aktiviert sein oder Sie müssen sowohl G1GC als auch die Stringdeduplizierung zusammen auf dem Message Processor aktivieren.
Hinweis
- Wenn Sie mit G1GC nicht vertraut sind, lesen Sie die Informationen unter Erste Schritte mit der G1 Garbage Collector.
- Wenn Sie mit der Stringdeduplizierung nicht vertraut sind, lesen Sie die Informationen unter Stringdeduplizierung von G1 Garbage Collector.
- Wenn Sie mit dem Aktivieren von G1GC auf Edge-Nachrichtenprozessoren nicht vertraut sind, lesen Sie G1GC auf den Nachrichtenprozessoren aktivieren.
- Wenn Sie mit dem Konfigurieren von Eigenschaften für Edge in der Private Cloud nicht vertraut sind, lesen Sie Edge konfigurieren.
Aktivieren der Deduplizierung von Strings auf Message Processorn
In diesem Abschnitt wird erläutert, wie Sie die Funktion „Stringdeduplizierung“ auf den Edge-Nachrichtenprozessoren aktivieren. Die Deduplizierung von Strings kann über die Eigenschaft useStringDeduplication
in der Message Processor-Komponente aktiviert werden. Diese Eigenschaft ist bei den 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 die String-Deduplizierung bei Message Processorn zu aktivieren:
- Token für die Property „useStringDeDuplizierung“ suchen
- useStringDeDuplizierung für Message Processor aktivieren
Token für die Eigenschaft useStringDeduplizierung suchen
In den folgenden Schritten wird beschrieben, wie Sie das Token für useStringDeduplizierung finden:
-
Suchen Sie im Nachrichtenprozessor-Quellverzeichnis
/opt/apigee/edge-message-processor/source
mit dem folgenden Befehl nach der EigenschaftuseStringDeduplication
:grep -ri "useStringDeduplication" /opt/apigee/edge-message-processor/source
-
Die Ausgabe dieses Befehls zeigt das Token für die Eigenschaft
useStringDeduplication
von Message Processor so:/opt/apigee/edge-message-processor/source/conf/system.properties:useStringDeduplication={T}conf_system_useStringDeduplication{/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 AttributuseStringDeduplication
so:conf_system_useStringDeduplication
Stringdeduplizierung auf Message Processorn aktivieren
In den folgenden Schritten wird beschrieben, wie Sie die Stringdeduplizierung auf Apigee-Nachrichtenprozessoren aktivieren:
-
Ö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
-
Fügen Sie dieser Datei die folgende Zeile hinzu:
conf_system_useStringDeduplication=true
- Speichern Sie die Änderungen.
-
Achten Sie darauf, dass der Inhaber dieser Property-Datei der Nutzer
apigee
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 Processorn.
Überprüfen der Stringdeduplizierung auf den Message Processorn
In diesem Abschnitt wird erläutert, wie Sie überprüfen können, ob die Stringdeduplizierung erfolgreich auf den Message Processorn aktiviert wurde.
Obwohl Sie das Token conf_system_useStringDeduplication
verwenden, um die Stringdeduplizierung im Message Processor zu aktivieren, müssen Sie prüfen, ob das tatsächliche Attribut useStringDeduplication
mit dem neuen Wert so festgelegt wurde:
-
Suchen Sie im Verzeichnis
/opt/apigee/edge-message-processor/conf
nach der EigenschaftuseStringDeduplication
und prüfen Sie, ob sie mit dem neuen Wert festgelegt wurde. Beispiel:grep -ri "useStringDeduplication" /opt/apigee/edge-message-processor/conf
-
Wenn die String-Deduplizierung 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, nachdem Sie die Stringdeduplizierung auf Message Processor aktiviert haben, sieht so aus:
/opt/apigee/edge-message-processor/conf/system.properties:useStringDeduplication=true
In der Beispielausgabe wurde das Attribut
useStringDeduplication
mit dem neuen Werttrue
insystem.properties
festgelegt. Dies zeigt an, dass die String-Deduplizierung erfolgreich auf dem Message Processor aktiviert wurde. -
Wenn noch der alte Wert für das Attribut
useStringDeduplication
angezeigt wird, prüfen Sie, ob Sie alle Schritte korrekt ausgeführt haben, die unter Stringdeduplizierung für Message Processors aktivieren beschrieben sind. Wenn Sie einen Schritt ausgelassen haben, wiederholen Sie alle Schritte korrekt. - Wenn Sie die Stringdeduplizierung immer noch nicht aktivieren können, wenden Sie sich an den Apigee-Support.