Estás consultando la documentación de Apigee Edge.
Consulta la
documentación de Apigee X. Información
En este documento, se explica cómo habilitar el recolector de elementos no utilizados primero (G1GC) en los procesadores de mensajes de Apigee Edge.
El Message Processor de Apigee Edge se ejecuta en una máquina virtual Java (JVM) y usa el recolector de elementos no utilizados predeterminado (serie o paralelo, según la configuración del hardware y del sistema operativo). En determinadas circunstancias y según tus necesidades, es posible que quieras cambiar el tipo de recolector de elementos no utilizados que se usa en Message Processor.
G1GC es el recolector de elementos no utilizados generacional de estilo servidor con pausa baja para la VM de Java HotSpot que mejora el rendimiento general del Message Processor. Por lo general, está diseñada para aplicaciones con conjuntos de datos de tamaño mediano a grande en los que el tiempo de respuesta es más importante que la capacidad de procesamiento general. Por ejemplo, puedes considerar usar G1GC si el tamaño del montón es grande (superior a 3 GB).
Por lo general, se recomienda configurar otro parámetro de JVM UseStringDeduplication
junto con G1GC. Este parámetro optimiza el uso de memoria del montón de Java al hacer que los valores de string duplicados o idénticos compartan el mismo array de caracteres.
Antes de comenzar
- Si no estás familiarizado con la recolección de elementos no utilizados y los diferentes tipos de estos en Java, lee Conceptos básicos de la recolección de elementos no utilizados de Java.
- Si no estás familiarizado con G1GC, consulta Cómo comenzar a usar el recolector de elementos no utilizados de G1.
- Si no estás familiarizado con la configuración de propiedades de Edge en la nube privada, consulta Cómo configurar Edge.
Habilita G1GC en los procesadores de mensajes
En esta sección, se explica cómo habilitar G1GC en Edge Message Processor. G1GC se puede habilitar a través de la propiedad useG1GC
en el componente de Message Processor. De forma predeterminada, esta propiedad se configura como false
en Message Processor. Para configurar cualquier propiedad en Message Processor, usa el token de acuerdo con la sintaxis descrita en
Cómo configurar Edge.
Para habilitar G1GC en Message Processors, sigue estos pasos:
Ubica el token para la propiedad useG1GC
En los siguientes pasos, se describe cómo ubicar el token para la propiedad useG1GC:
- Busca la propiedad
useG1GC
en el directorio fuente/opt/apigee/edge-message-processor/source
de Message Processor con el siguiente comando:grep -ri "useG1GC" /opt/apigee/edge-message-processor/source
-
El resultado de este comando muestra el token de la propiedad
useG1GC
de Message Processor de la siguiente manera:/opt/apigee/edge-message-processor/source/conf/system.properties:useG1GC={T}conf_system_useG1GC{/T}
En el ejemplo anterior, la string entre las etiquetas
{T}{/T}
es el nombre del token que puedes configurar en el archivo.properties
de Message Processor. Por lo tanto, el token para la propiedaduseG1GC
es el siguiente:conf_system_useG1GC
Habilita G1GC en Message Processor
En los siguientes pasos, se describe cómo habilitar G1GC en los procesadores de mensajes de Apigee:
-
Abre el archivo
/opt/apigee/customer/application/message-processor.properties
en la máquina de Message Processor en un editor. Si el archivo aún no existe, créalo. Por ejemplo:vi /opt/apigee/customer/application/message-processor.properties
-
Agrega la siguiente línea a este archivo:
conf_system_useG1GC=true
- Guarda los cambios.
-
Asegúrate de que este archivo de propiedades sea propiedad del usuario
apigee
. Por ejemplo:chown apigee:apigee /opt/apigee/customer/application/message-processor.properties
-
Reinicia Message Processor con el siguiente comando:
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
- Si tienes más de un Message Processor, repite estos pasos en todos ellos.
Cómo verificar la configuración de G1GC en los procesadores de mensajes
En esta sección, se explica cómo verificar que la configuración de G1GC se haya modificado correctamente en Message Processor.
Aunque uses el token conf_system_useG1GC
para habilitar G1GC en Message Processor, debes verificar que la propiedad real useG1GC
se haya establecido con el valor nuevo de la siguiente manera:
-
Busca la propiedad
useG1GC
en el directorio/opt/apigee/edge-message-processor/conf
y verifica que se haya configurado con el valor nuevo. Por ejemplo:grep -ri "useG1GC" /opt/apigee/edge-message-processor/conf
-
Si G1GC está habilitado de forma correcta en Message Processor, el comando anterior muestra el valor nuevo en el archivo
system.properties
.El resultado de muestra del comando anterior, después de habilitar G1GC en el procesador de mensajes, es el siguiente:
/opt/apigee/edge-message-processor/conf/system.properties:useG1GC=true
En el resultado de ejemplo, ten en cuenta que la propiedad
useG1GC
se configuró con el valor nuevotrue
ensystem.properties
. Esto indica que G1GC se habilitó correctamente en Message Processor. -
Si aún ves el valor anterior de la propiedad
useG1GC
, verifica si seguiste todos los pasos descritos en Habilita G1GC en los procesadores de mensajes de forma correcta. Si omitiste algún paso, repite todos los pasos de nuevo de forma correcta. - Si aún no puedes habilitar G1GC, comunícate con el equipo de asistencia de Apigee Edge.
Pasos siguientes
Habilita la anulación de duplicación de strings en procesadores de mensajes