Guide d'utilisation du QPID

La version 4.53.00 d'Edge pour Private Cloud est fournie avec Qpid Broker-J 8.0.6. Cette page décrit les considérations relatives à la mémoire et au disque le composant apigee-qpidd d'Edge pour Private Cloud (avec l'agent basé sur Java). Les sections ci-dessous s'appliquent spécifiquement aux Cas d'utilisation de Qpid et expliquer comment régler Qpid à l'aide des mécanismes de configuration d'Apigee.

Qpid dans Apigee

Dans Apigee, Qpid est utilisé dans deux workflows principaux:

  • Analytics
  • Monétisation

Dans ces deux flux de travail, le processeur de messages génère des messages, qui sont collectées en lots et transférées à Qpid. Pour Analytics, les messages sont lus par Qpid-server ; pour la monétisation, elles sont lues par Rating Server (qui fait partie de management-server). Une fois lus, les messages groupés sont désassemblés et ingérés.

Les sections suivantes décrivent les configurations recommandées pour la mémoire et le disque avec Qpid Ces configurations sont basées sur une taille de message unique de 2 Ko pour Analytics ou la monétisation. Avec une taille de lot par défaut de 50, chaque message dans Qpid mesure environ 100 ko. Apigee permet aux proxys de modifier et d'ajouter des informations supplémentaires à un message (analyse ou monétisation). Dans des cas extrêmes, cela peut modifier considérablement la taille d'un seul message et du message groupé global dans Qpid. Bien que les recommandations générales concernant la mémoire et le disque dans les sections ci-dessous s'appliquent également dans ce cas, vous devrez peut-être effectuer des ajustements supplémentaires sur Qpid pour assurer un fonctionnement fluide.

Mémoire

Qpid Broker utilise deux types de mémoire : la mémoire hors tas et la mémoire de tas. Qpid stocke les messages dans hors tas de mémoire et l'utilise pour ses propres tâches internes, aux files d'attente et aux échanges, etc. Dans la plupart des cas, Apigee vous recommande de conserver Ratio de 3:1 entre la mémoire hors tas et le tas de mémoire pour Qpid Broker.

Les messages de la mémoire hors tas de mémoire sont conservés sur le disque. De plus, si l'utilisation totale la mémoire hors tas de mémoire dépasse un certain seuil, Qpid est configuré pour faire déborder les messages sur le disque.

Par défaut, Apigee calcule la mémoire du tas de mémoire et de la mémoire hors tas de Qpid Broker en fonction de la mémoire disponible sur le nœud. Les scripts d'Apigee ont une limite flexible de 4 Go combinés pour le tas de mémoire de Qpid Broker et la mémoire hors tas de mémoire. Si vous souhaitez contourner ces limites, vous pouvez utiliser les deux configurations ci-dessous pour définir vos propres valeurs pour le tas de mémoire de Qpid et la mémoire hors tas de mémoire.

  • Configuration de la mémoire de tas : bin_run-qpidd_qpid.run.jvm.max_vm_heap=1024m
  • Configuration de la mémoire hors tas : bin_run-qpidd_qpid.run.jvm.max_direct_memory_size=3072m

Pour savoir comment remplacer des configurations, consultez la section Modifier une configuration Qpid.

Pour en savoir plus, consultez <ph type="x-smartling-placeholder"></ph> Documentation de référence sur Apache Qpid pour la mémoire

Disque

Le répertoire de données du courtier Qpid est $APIGEE_ROOT/data/apigee-qpidd. Les journaux du courtier Qpid sont stockés dans $APIGEE_ROOT/var/log/apigee-qpidd.

Les performances du système de fichiers hébergeant le répertoire de données sont essentielles aux performances de Broker dans son ensemble. Pour des performances optimales, choisissez un appareil à faible latence qui n'est pas utilisé par d'autres applications.

Le broker Qpid conserve ses messages dans le répertoire de données. Par défaut, le Broker accepte les messages jusqu'à ce que le système de fichiers hébergeant le répertoire de données soit rempli à 80 %. Vous pouvez modifier ce seuil en remplaçant la configuration illustrée dans l'exemple ci-dessous sur chaque nœud Qpid.

bin_run-qpidd_qpid.store.filesystem.maxUsagePercent=60

Dans cet exemple, le Broker rejette les nouveaux messages lorsque le système de fichiers sous-jacent est rempli à 60 %.

Modifier une configuration Qpid

Pour modifier une configuration Qpid :

  1. Créez ou modifiez le fichier suivant : 
    $APIGEE_ROOT/customer/application/qpidd.properties
  2. Ajoutez, supprimez ou modifiez la configuration selon vos besoins. Par exemple, pour définir la mémoire maximale du segment de mémoire de Qpid Broker sur 6 Go, ajoutez la configuration suivante : dans le fichier: 
    bin_run-qpidd_qpid.run.jvm.max_vm_heap=6144M
  3. Enregistrez les modifications et assurez-vous que l'utilisateur apigee est propriétaire du fichier et qu'il peut le lire : 
    chown apigee:apigee $APIGEE_ROOT/customer/application/qpidd.properties
  4. Redémarrez le processus qpidd : 
    apigee-service apigee-qpidd restart