Configuration de la taille du tas de mémoire sur les processeurs de messages

Vous consultez la documentation d'Apigee Edge.
Consultez la documentation Apigee X.
en savoir plus

Le processeur de messages d'Apigee Edge est un composant Java qui utilise une taille de mémoire de tas de mémoire par défaut de 512 Mo. Cependant, la taille de mémoire du tas de mémoire par défaut peut ne pas être suffisante pour tous les cas d'utilisation sur Apigee Edge. Vous devrez peut-être ajuster la taille de la mémoire du tas de mémoire de vos processeurs de messages en fonction de vos besoins en termes de trafic et de traitement, ou pour résoudre tout problème lié à la mémoire.

La taille de la mémoire du tas de mémoire d'une application Java est contrôlée via les paramètres de ligne de commande Java -Xms (taille minimale du tas de mémoire) et -Xmx (taille maximale du tas de mémoire). Sur les processeurs de messages Apigee Edge, ceux-ci sont contrôlés via les propriétés bin_setenv_min_mem et bin_setenv_max_mem. Pour en savoir plus sur ces propriétés, consultez la section Modifier les paramètres de mémoire Java.

Ce document explique comment configurer la taille de la mémoire du tas de mémoire sur les processeurs de messages d'Apigee Edge.

Avant de commencer

Modifier la taille de la mémoire de tas de mémoire sur les processeurs de messages

Cette section explique comment modifier la taille de la mémoire des segments de mémoire sur les processeurs de messages. La mémoire minimale et maximale du tas de mémoire peut être configurée via les propriétés bin_setenv_min_mem et bin_setenv_max_mem du composant "Processeur de messages".

Pour modifier la taille de la mémoire du tas de mémoire sur les processeurs de messages, procédez comme suit:

  1. Ouvrez le fichier /opt/apigee/customer/application/message-processor.properties sur le processeur de messages dans un éditeur. Si le fichier n'existe pas déjà, créez-le. Exemple :
    vi /opt/apigee/customer/application/message-processor.properties
    
  2. Ajoutez les lignes suivantes à ce fichier :
    bin_setenv_min_mem=minimum_heap_in_megabytes
    bin_setenv_max_mem=maximum_heap_in_megabytes
    

    Par exemple, si vous souhaitez modifier le tas de mémoire minimal et maximal sur le processeur de messages pour qu'il corresponde respectivement à 1 Go et 2 Go, ajoutez les lignes suivantes à ce fichier:

    bin_setenv_min_mem=1024m
    bin_setenv_max_mem=2048m
    
  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 taille de la mémoire du tas de mémoire sur les processeurs de messages

Cette section explique comment vérifier si les modifications apportées à la mémoire du tas de mémoire ont bien été modifiées sur les processeurs de messages.

Même si vous avez utilisé les propriétés bin_setenv_min_mem et bin_setenv_max_mem pour modifier la taille de la mémoire du tas de mémoire sur le processeur de messages, vous devez vérifier que les paramètres -Xms et -Xmx de la ligne de commande Java réels ont été définis avec les nouvelles valeurs, comme suit:

  1. Recherchez si les paramètres de ligne de commande -Xms et -Xmx ont été définis avec les nouvelles valeurs pour le processeur de messages à l'aide de la commande suivante :
    ps -ef | grep message-processor | egrep -o 'Xms[0-9a-z]+|Xmx[0-9a-z]+' | tr '\r' ' '
    
  2. Si la mémoire minimale et maximale du tas de mémoire a été modifiée sur le processeur de messages, la commande précédente affiche la nouvelle valeur indiquée pour -Xms et -Xmx.

    L'exemple de résultat de la commande précédente, une fois que vous avez modifié les segments de mémoire minimal et maximal sur le processeur de messages, est le suivant:

    Xms1024m
    Xmx2048m
    

    Dans l'exemple de sortie, notez que les nouvelles valeurs de tas de mémoire minimal et maximal ont été définies.

  3. Si les anciennes valeurs pour -Xms et -Xmx s'affichent toujours, vérifiez que vous avez correctement suivi toutes les étapes décrites dans Modifier la taille de la mémoire du tas de mémoire sur les processeurs de messages. Si vous avez manqué une étape, répétez-la correctement.
  4. Si vous ne parvenez toujours pas à modifier la mémoire des segments de mémoire, contactez l'assistance Apigee Edge.

Étapes suivantes