Vous consultez la documentation Apigee Edge.
Accédez à la
documentation**Apigee X**. info
Ce document explique comment activer le Garbage First Garbage Collector (G1GC) sur les processeurs de messages d'Apigee Edge.
Le processeur de messages d'Apigee Edge s'exécute sur une machine virtuelle Java (JVM) et utilise le Garbage Collector par défaut (sériel ou parallèle, selon les configurations matérielles et du système d'exploitation). Dans certaines circonstances et en fonction de vos besoins, vous pouvez modifier le type de Garbage Collector utilisé sur le processeur de messages.
Le G1GC est le Garbage Collector de génération de style serveur à faible pause pour Java HotSpot VM, qui améliore les performances globales du processeur de messages. Il est généralement conçu pour les applications avec des ensembles de données de taille moyenne à grande, dans lesquelles le temps de réponse est plus important que le débit global. Par exemple, vous pouvez envisager d'utiliser G1GC si la taille du tas est importante (supérieure à 3 Go).
Il est généralement recommandé de définir un autre paramètre JVM UseStringDeduplication avec G1GC. Ce paramètre optimise l'utilisation de la mémoire du tas Java en faisant en sorte que les valeurs de chaîne en double ou identiques
partagent le même tableau de caractères.
Avant de commencer
- Si vous ne connaissez pas bien le Garbage Collection et les différents types de Garbage Collectors en Java, consultez Principes de base du Garbage Collection Java.
- Si vous ne connaissez pas bien G1GC, consultez Premiers pas avec le Garbage Collector G1.
- Si vous ne savez pas comment configurer les propriétés d'Edge sur Private Cloud, consultez Configurer Edge.
Activer G1GC sur les processeurs de messages
Cette section explique comment activer G1GC sur le processeur de messages Edge. G1GC peut être activé
via la propriété useG1GC sur le composant Processeur de messages. Par défaut, cette
propriété est définie sur false sur les processeurs de messages. Pour configurer une propriété sur le processeur de messages, utilisez le jeton conformément à la syntaxe décrite dans Configurer Edge.
Pour activer G1GC sur les processeurs de messages, procédez comme suit :
Rechercher le jeton de la propriété useG1GC
Pour rechercher le jeton de la propriété useG1GC, procédez comme suit :
- Recherchez la propriété
useG1GCdans le répertoire source du processeur de messages/opt/apigee/edge-message-processor/sourceà l'aide de la commande suivante :grep -ri "useG1GC" /opt/apigee/edge-message-processor/source
-
Le résultat de cette commande affiche le jeton de la propriété
useG1GCdu processeur de messages comme suit :/opt/apigee/edge-message-processor/source/conf/system.properties:useG1GC={T}conf_system_useG1GC{/T}Où la chaîne entre les balises
{T}{/T}correspond au nom du jeton que vous pouvez définir dans le fichier.propertiesdu processeur de messages. Ainsi, le jeton de la propriétéuseG1GCest le suivant :conf_system_useG1GC
Activer G1GC sur les processeurs de messages
Pour activer G1GC sur les processeurs de messages Apigee, procédez comme suit :
-
Ouvrez le fichier
/opt/apigee/customer/application/message-processor.propertiessur la machine du processeur de messages dans un éditeur. Si le fichier n'existe pas déjà, alors créez-le. Exemple :vi /opt/apigee/customer/application/message-processor.properties
-
Ajoutez la ligne suivante à ce fichier :
conf_system_useG1GC=true
- Enregistrez les modifications.
-
Assurez-vous que ce fichier de propriétés appartient à l'utilisateur
apigee. Exemple :chown apigee:apigee /opt/apigee/customer/application/message-processor.properties
-
Redémarrez le processeur de messages à l'aide de la commande suivante :
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
- Si vous avez plusieurs processeurs de messages, répétez ces étapes sur tous les processeurs de messages.
Vérifier la configuration G1GC sur les processeurs de messages
Cette section explique comment vérifier que la configuration G1GC a bien été modifiée sur les processeurs de messages.
Même si vous utilisez le jeton conf_system_useG1GC pour activer G1GC sur le processeur de messages, vous devez vérifier que la propriété useG1GC a été définie avec la nouvelle valeur comme suit :
-
Recherchez la propriété
useG1GCdans le répertoire/opt/apigee/edge-message-processor/confet vérifiez qu'elle a été définie avec la nouvelle valeur. Exemple :grep -ri "useG1GC" /opt/apigee/edge-message-processor/conf
-
Si G1GC est activé sur le processeur de messages, la commande précédente affiche
la nouvelle valeur dans le fichier
system.properties.Voici un exemple de résultat de la commande précédente après avoir activé G1GC sur le processeur de messages :
/opt/apigee/edge-message-processor/conf/system.properties:useG1GC=true
Dans l'exemple de résultat, notez que la propriété
useG1GCa été définie avec la nouvelle valeurtruedanssystem.properties. Cela indique que G1GC est activé sur le processeur de messages. -
Si l'ancienne valeur de la propriété
useG1GCs'affiche toujours, vérifiez que vous avez correctement suivi toutes les étapes décrites dans Activer G1GC sur les processeurs de messages. Si vous avez manqué une étape, répétez-les toutes correctement. - Si vous ne parvenez toujours pas à activer G1GC, contactez l'assistance Apigee Edge.
Et ensuite ?
Activer la déduplication des chaînes sur les processeurs de messages