Guía de operaciones de QPID

Edge para nube privada versión 4.54.00 se envía con Qpid Broker-J 10.0.1. En esta página se describen las consideraciones sobre la memoria y el disco para el apigee-qpidd componente de Edge para nube privada (con Broker basado en Java). Las siguientes secciones se aplican específicamente al caso de uso de Qpid de Apigee y explican cómo ajustar Qpid con los mecanismos de configuración de Apigee.

Qpid en Apigee

En Apigee, Qpid se usa en dos flujos de trabajo principales:

  • Analytics
  • Monetización

En ambos flujos de trabajo, el Message Processor genera mensajes, que se recopilan en lotes y se envían a Qpid. En Analytics, los mensajes los lee el servidor de Qpid; en Monetización, los lee el servidor de clasificación (parte del servidor de administración). Una vez que se leen, los mensajes por lotes se desempacan y se incorporan.

En las siguientes secciones, se describen los parámetros de configuración recomendados para la memoria y el disco con Qpid. Estos parámetros de configuración se basan en un tamaño de mensaje único de 2 KB para Analytics o Monetización. Con un tamaño de lote predeterminado de 50, cada mensaje en Qpid sería de aproximadamente 100 KB. Apigee permite que los proxies modifiquen y agreguen información adicional a un mensaje (Analytics o Monetización). En casos extremos, esto puede cambiar significativamente el tamaño de un solo mensaje y el mensaje por lotes general en Qpid. Si bien las recomendaciones generales sobre la memoria y el disco en las siguientes secciones son válidas incluso en esos casos, es posible que debas realizar ajustes adicionales en Qpid para garantizar operaciones sin problemas.

Memoria

Qpid Broker usa dos tipos de memoria: memoria fuera del montón y memoria del montón. Qpid almacena mensajes en memoria fuera del montón y usa la memoria del montón para sus propias tareas internas, mensajes directos a colas e intercambios, etc. En la mayoría de las circunstancias, Apigee recomienda que mantengas una proporción de 3:1 entre la memoria fuera del montón y la memoria del montón para Qpid Broker.

Los mensajes en la memoria fuera del montón persisten en el disco. Además, si el uso total de la memoria fuera del montón supera un cierto umbral, Qpid se configura para desbordar los mensajes al disco.

De forma predeterminada, Apigee calcula la memoria del montón y la memoria fuera del montón de Qpid Broker en función de la memoria disponible en el nodo. Las secuencias de comandos de Apigee tienen un límite flexible de 4 GB combinados para la memoria del montón y la memoria fuera del montón de Qpid Broker. Si deseas anular estos límites, puedes usar las dos configuraciones que se muestran a continuación para establecer tus propios valores para la memoria del montón y la memoria fuera del montón de Qpid.

  • Configuración para la memoria del montón: bin_run-qpidd_qpid.run.jvm.max_vm_heap=1024m
  • Configuración para la memoria fuera del montón: bin_run-qpidd_qpid.run.jvm.max_direct_memory_size=3072m

Consulta Cómo cambiar una configuración de Qpid para obtener información sobre cómo anular las configuraciones.

Para obtener más información, consulta la referencia de Apache Qpid para la memoria .

Disco

El directorio de datos de Qpid Broker es $APIGEE_ROOT/data/apigee-qpidd. Los registros de Qpid Broker se almacenan en $APIGEE_ROOT/var/log/apigee-qpidd.

El rendimiento del sistema de archivos que aloja el directorio de datos es clave para el rendimiento de Broker en su totalidad. Para obtener el mejor rendimiento, elige un dispositivo que tenga una latencia baja y que no usen otras aplicaciones.

Qpid Broker conserva sus mensajes en el directorio de datos. De forma predeterminada, Broker aceptará mensajes hasta que el sistema de archivos que aloja el directorio de datos esté lleno en un 80%. Puedes modificar este umbral anulando la configuración que se muestra en el siguiente ejemplo en cada nodo de Qpid.

bin_run-qpidd_qpid.store.filesystem.maxUsagePercent=60

En este ejemplo, Broker rechaza los mensajes nuevos cuando el sistema de archivos subyacente está lleno en un 60% .

Cómo cambiar una configuración de Qpid

Para cambiar una configuración de Qpid, haz lo siguiente:

  1. Crea o edita el siguiente archivo: 
    $APIGEE_ROOT/customer/application/qpidd.properties
  2. Agrega, quita o modifica la configuración según sea necesario. Por ejemplo, para cambiar la memoria máxima del montón de Qpid Broker a 6 GB, agrega la siguiente anulación de configuración en el archivo: 
    bin_run-qpidd_qpid.run.jvm.max_vm_heap=6144M
  3. Guarda los cambios y asegúrate de que el usuario apigee sea el propietario del archivo y pueda leerlo: 
    chown apigee:apigee $APIGEE_ROOT/customer/application/qpidd.properties
  4. Reinicia el proceso qpidd: 
    apigee-service apigee-qpidd restart