Guide d'utilisation du QPID

Edge for Private Cloud version 4.52.02 est fourni avec Qpid Broker-J 8.0.6. Cette page décrit des 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 par lot sont retiré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 se basent sur une taille de message unique de 2 Ko pour Analytics ou Monétisation Avec un taille de lot par défaut de 50, chaque message dans Qpid aurait environ 100 Ko. Apigee permet aux proxys de modifier un message et d'y ajouter des informations (analyse ou monétisation). Dans des cas extrêmes, la taille d'une un seul message et le message global par lot dans Qpid. Bien que le modèle général les recommandations concernant la mémoire et le disque dans les sections ci-dessous sont valables même dans de tels cas, vous devrez peut-être apporter des ajustements supplémentaires à Qpid pour assurer le bon déroulement des opérations.

Mémoire

Qpid Broker utilise deux types de mémoire: la mémoire hors tas de mémoire et la mémoire du tas de mémoire. 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 pour la mémoire du segment de mémoire: bin_run-qpidd_qpid.run.jvm.max_vm_heap=1024m
  • Configuration pour la mémoire hors tas de mémoire: bin_run-qpidd_qpid.run.jvm.max_direct_memory_size=3072m

Voir Comment modifier une configuration Qpid pour sur la façon de remplacer les configurations.

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 de l'agent Qpid est $APIGEE_ROOT/data/apigee-qpidd. Les journaux de Qpid Broker 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 le courtier dans son ensemble. Pour des performances optimales, choisissez un appareil dont la latence est faible. qui ne sont pas utilisées par d'autres applications.

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

bin_run-qpidd_qpid.store.filesystem.maxUsagePercent=60

Dans cet exemple, l'agent rejette les nouveaux messages lorsque le système de fichiers sous-jacent est de 60 %. plein.

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 possède le fichier et peut le lire: 
    chown apigee:apigee $APIGEE_ROOT/customer/application/qpidd.properties
  4. Redémarrez le processus qpidd: 
    redémarrer apigee-service apigee-qpidd