Activer la déduplication de chaînes sur les processeurs de messages

<ph type="x-smartling-placeholder"></ph> Vous consultez la documentation Apigee Edge.
Accédez à la page Documentation sur Apigee X. En savoir plus

<ph type="x-smartling-placeholder">

Ce document explique comment activer la déduplication de chaîne sur les processeurs de messages d'Apigee Edge.

La déduplication de chaînes est une fonctionnalité Java qui vous aide à économiser la mémoire occupée par une chaîne en double. des objets dans les applications Java. Elle réduit l'espace mémoire utilisé par les objets String dans le tas de mémoire Java. en faisant en sorte que les valeurs String dupliquées ou identiques partagent le même tableau de caractères.

Apigee Edge Message Processor est un composant Java. Utiliser la déduplication de chaînes dans un message Le processeur peut améliorer les performances de vos proxys d'API en réduisant l'utilisation de la mémoire, en particulier si les proxies d'API font un usage intensive des chaînes.

La fonctionnalité de déduplication de chaînes ne peut être utilisée qu'avec le récupérateur de mémoire G1 (G1GC) en Java applications. Si vous souhaitez activer cette fonctionnalité sur le processeur de messages, vous devez G1GC est déjà activé, ou activez à la fois G1GC et la déduplication des chaînes sur le message. Processeur.

Avant de commencer

Activer la déduplication de chaînes sur les processeurs de messages

Cette section explique comment activer la fonction de déduplication de chaînes dans le message Edge Processeurs. Vous pouvez activer la déduplication des chaînes via la propriété useStringDeduplication sur le composant de processeur de messages. Par défaut, est définie sur "false" sur les processeurs de messages. Pour configurer une propriété dans le message Sous-traitant, utilisez le jeton conformément à la syntaxe décrite dans Comment configurer Edge.

Pour activer la déduplication de chaînes sur les processeurs de messages, procédez comme suit:

  1. Localiser le jeton pour la propriété useStringDeduplication
  2. Activer useStringDeduplication sur le processeur de messages

Localiser le jeton pour la propriété useStringDeduplication

Les étapes suivantes décrivent comment localiser le jeton pour useStringDeduplication:

  1. Rechercher la propriété useStringDeduplication dans la source du processeur de messages /opt/apigee/edge-message-processor/source à l'aide de la commande suivante: 
    grep -ri "useStringDeduplication" /opt/apigee/edge-message-processor/source
  2. Le résultat de cette commande affiche le jeton de la propriété du processeur de messages. useStringDeduplication comme suit: 
    /opt/apigee/edge-message-processor/source/conf/system.properties:useStringDeduplication={T}conf_system_useStringDeduplication{/T}

    Où la chaîne entre les balises {T}{/T} correspond au nom du que vous pouvez définir dans le fichier .properties du processeur de messages. Ainsi, le jeton de la propriété useStringDeduplication se présente comme suit: 

    conf_system_useStringDeduplication

Activer la déduplication de chaînes sur les processeurs de messages

<ph type="x-smartling-placeholder">

Les étapes suivantes décrivent comment activer la déduplication de chaînes sur les processeurs de messages Apigee:

  1. Ouvrez le fichier /opt/apigee/customer/application/message-processor.properties sur la machine de traitement des messages dans un éditeur. Si le fichier n'existe pas encore, créez-le. Exemple : 
    vi /opt/apigee/customer/application/message-processor.properties
  2. Ajoutez la ligne suivante à ce fichier: 
    conf_system_useStringDeduplication=true
    <ph type="x-smartling-placeholder">
  3. Enregistrez les modifications.
  4. Assurez-vous que ce fichier de propriétés appartient à l'utilisateur apigee. Exemple : 
    chown apigee:apigee /opt/apigee/customer/application/message-processor.properties
  5. Redémarrez le processeur de messages à l'aide de la commande suivante: 
    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
  6. Si vous disposez de plusieurs processeurs de messages, répétez ces étapes sur chacun d'eux.

Vérifier la déduplication de chaînes sur les processeurs de messages

Cette section explique comment vérifier que la déduplication des chaînes a bien été activée sur les processeurs de messages.

Même si vous utilisez le jeton conf_system_useStringDeduplication pour activer des chaînes Déduplication sur le processeur de messages : vous devez vérifier que la propriété réelle useStringDeduplication a été défini avec la nouvelle valeur comme suit:

  1. Recherchez la propriété useStringDeduplication dans /opt/apigee/edge-message-processor/conf et vérifiez qu'il contient défini avec la nouvelle valeur. Exemple : 
    grep -ri "useStringDeduplication" /opt/apigee/edge-message-processor/conf
  2. Si la déduplication de chaînes est activée avec succès sur le processeur de messages, la méthode précédente affiche la nouvelle valeur dans le fichier system.properties.

    L'exemple de résultat de la commande précédente après l'activation de la déduplication de chaînes sur le Le processeur de messages se présente comme suit: 

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

    Dans l'exemple de résultat, notez que la propriété useStringDeduplication a été définie avec la nouvelle valeur true dans system.properties. Cela indique que la déduplication de chaînes est activée avec succès sur le processeur de messages.

  3. Si l'ancienne valeur de la propriété useStringDeduplication s'affiche toujours, alors vérifiez que vous avez suivi toutes les étapes décrites dans Activation de la déduplication de chaînes sur les processeurs de messages correctement. Si vous avez manqué une étape, répétez toutes les étapes correctement.
  4. Si vous ne parvenez toujours pas à activer la déduplication des chaînes, contactez Assistance Apigee :

Et ensuite ?

Activer G1GC sur les processeurs de messages