Guía de operaciones de QPID

La versión 4.53.00 de Edge para la nube privada se envía con Qpid Broker-J 8.0.6. En esta página, se describen las consideraciones de memoria y disco para El componente apigee-qpidd de Edge para la nube privada (con un agente basado en Java) Las siguientes secciones se aplican específicamente a las APIs de Apigee, Caso de uso de Qpid y explicación de 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 procesador de mensajes genera mensajes, que se recopilan en lotes y se envían a Qpid. En el caso de Analytics, el servidor Qpid lee los mensajes. Para la monetización, el servidor de clasificación (parte del servidor de administración) los lee. Una vez leídos, los mensajes agrupados se desagrupan por lotes y se transfieren.

En las siguientes secciones, se describen las configuraciones recomendadas para la memoria y el disco con Qpid. Estas configuraciones 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 una un mensaje individual y el conjunto de mensajes en lote en Qpid. Si bien las recomendaciones generales sobre la memoria y el disco que se incluyen en las siguientes secciones son válidas incluso en esos casos, es posible que debas realizar ajustes adicionales en Qpid para garantizar que las operaciones se realicen sin problemas.

Memoria

El agente de Qpid usa dos tipos de memoria: la memoria fuera del montón y la memoria del montón. Qpid almacena mensajes en la memoria fuera del montón y usa la memoria del montón para sus propias tareas internas, mensajes directos a colas y intercambios, etcétera. En la mayoría de los casos, 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 infringe un cierto umbral, Qpid está configurado para desbordar mensajes en el disco.

De forma predeterminada, Apigee calcula la memoria del montón y fuera del montón del agente de Qpid 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 el 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 indican a continuación para establecer tus propios valores para el montón y la memoria fuera del montón de Qpid.

  • Configuración de la memoria del montón: bin_run-qpidd_qpid.run.jvm.max_vm_heap=1024m
  • Configuración de 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 del agente de Qpid 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 baja latencia y que que otras aplicaciones no usan.

El agente de Qpid conserva sus mensajes en el directorio de datos. De forma predeterminada, el agente aceptará mensajes hasta que el sistema de archivos que aloja el directorio de datos esté lleno al 80%. Para modificar este umbral, anula 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, el agente rechaza los mensajes nuevos cuando el sistema de archivos subyacente es del 60% completo.

Cómo cambiar una configuración de Qpid

Para cambiar una configuración de Qpid:

  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 de 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