Vous consultez la documentation d'Apigee Edge.
Consultez la
documentation Apigee X. en savoir plus
Ce document explique comment activer le récupérateur de mémoire du premier volume (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 récupérateur de mémoire par défaut (série ou parallèle, selon la configuration du matériel et du système d'exploitation). Dans certaines circonstances et en fonction de vos besoins, vous pouvez modifier le type de récupération de mémoire utilisé sur le processeur de messages.
Le G1GC est le récupérateur de mémoire générationnel de type serveur à faible pause pour la VM Java HotSpot, qui améliore les performances globales du processeur de messages. Il est généralement conçu pour les applications comportant des ensembles de données de taille moyenne à grande, pour lesquels 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 de mémoire est importante (supérieure à 3 Go).
Il est généralement recommandé de définir un autre paramètre JVM UseStringDeduplication
en plus de G1GC. Ce paramètre optimise l'utilisation de la mémoire du tas de mémoire Java en faisant en sorte que les valeurs de chaîne dupliquées ou identiques partagent le même tableau de caractères.
Avant de commencer
- Si vous ne connaissez pas la récupération de mémoire ni les différents types de récupération de mémoire en Java, consultez la page Principes de base de la récupération de mémoire Java.
- Si vous ne connaissez pas G1GC, consultez la page Premiers pas avec le récupérateur de mémoire G1.
- Si vous ne savez pas comment configurer des propriétés pour Edge sur Private Cloud, consultez la section Comment 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
du 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 Comment configurer Edge.
Pour activer G1GC sur les processeurs de messages, procédez comme suit:
Localiser le jeton pour la propriété useG1GC
Les étapes suivantes décrivent comment localiser le jeton pour la propriété useG1GC:
- Recherchez la propriété
useG1GC
dans 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 pour la propriété
useG1GC
du 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 tags
{T}{/T}
est le nom du jeton que vous pouvez définir dans le fichier.properties
du processeur de messages. Ainsi, le jeton de la propriétéuseG1GC
est le suivant:conf_system_useG1GC
Activer G1GC sur les processeurs de messages
Les étapes suivantes décrivent comment activer G1GC sur les processeurs de messages Apigee:
-
Ouvrez le fichier
/opt/apigee/customer/application/message-processor.properties
dans un éditeur sur le processeur de messages. Si le fichier n'existe pas déjà, 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 disposez de plusieurs processeurs de messages, répétez ces étapes sur chacun d'eux.
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é
useG1GC
dans le répertoire/opt/apigee/edge-message-processor/conf
et vérifiez qu'elle a bien été définie avec la nouvelle valeur. Exemple :grep -ri "useG1GC" /opt/apigee/edge-message-processor/conf
-
Si le G1GC est correctement activé sur le processeur de messages, la commande précédente affiche la nouvelle valeur dans le fichier
system.properties
.L'exemple de résultat de la commande précédente, une fois que vous avez activé G1GC sur le processeur de messages, est le suivant:
/opt/apigee/edge-message-processor/conf/system.properties:useG1GC=true
Dans l'exemple de sortie, notez que la propriété
useG1GC
a été définie avec la nouvelle valeurtrue
danssystem.properties
. Cela indique que G1GC est correctement activé sur le processeur de messages. -
Si vous voyez toujours l'ancienne valeur pour la propriété
useG1GC
, vérifiez que vous avez correctement suivi toutes les étapes décrites dans la section Activer G1GC sur les processeurs de messages. Si vous avez manqué une étape, répétez toutes les étapes correctement. - Si vous ne parvenez toujours pas à activer le G1GC, contactez l'assistance Apigee Edge.
Étapes suivantes
Activer la déduplication de chaînes sur les processeurs de messages