Estás viendo la documentación de Apigee Edge.
Ir a la
documentación de Apigee X. info
En este documento, se explica cómo habilitar el recolector de elementos no utilizados Garbage First (G1GC) en los Message Processors de Apigee Edge.
El Message Processor de Apigee Edge se ejecuta en Java Virtual Machine (JVM) y usa el recolector de elementos no utilizados predeterminado : serial o paralelo, según las configuraciones de hardware y del sistema operativo. En determinadas circunstancias y según tus necesidades, es posible que desees cambiar el tipo de recolector de elementos no utilizados que se usa en el Message Processor.
El G1GC es el recolector de elementos no utilizados generacional de estilo de servidor de baja pausa para Java HotSpot VM, que mejora el rendimiento general del Message Processor. Por lo general, está diseñado 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, ya que hace 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 recolectores de elementos no utilizados en Java, lee Conceptos básicos de la recolección de elementos no utilizados de Java.
- Si no estás familiarizado con G1GC, lee Cómo comenzar a usar el recolector de elementos no utilizados G1.
- Si no estás familiarizado con la configuración de propiedades para Edge en la nube privada, lee Cómo configurar Edge.
Habilita G1GC en los Message Processors
En esta sección, se explica cómo habilitar G1GC en el Message Processor de Edge. G1GC se puede habilitar
a través de la propiedad useG1GC en el componente Message Processor. De forma predeterminada, esta
propiedad se establece en false en los Message Processors. Para configurar cualquier propiedad en el Message
Processor, usa el token según la sintaxis que se describe en
Cómo configurar Edge.
Para habilitar G1GC en los Message Processors, realiza los siguientes pasos:
Busca el token para la propiedad useG1GC
En los siguientes pasos, se describe cómo ubicar el token para la propiedad useG1GC:
- Busca la propiedad
useG1GCen el directorio del código fuente del Message Processor/opt/apigee/edge-message-processor/sourcecon el siguiente comando:grep -ri "useG1GC" /opt/apigee/edge-message-processor/source
-
El resultado de este comando muestra el token para la propiedad
useG1GCdel 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 cadena entre las etiquetas
{T}{/T}es el nombre del token que puedes establecer en el archivo.propertiesdel Message Processor. Por lo tanto, el token para la propiedaduseG1GCes el siguiente:conf_system_useG1GC
Habilita G1GC en los Message Processors
En los siguientes pasos, se describe cómo habilitar G1GC en los Message Processors de Apigee:
-
Abre el archivo
/opt/apigee/customer/application/message-processor.propertiesen la máquina del Message Processor en un editor. Si el archivo aún no existe, entonces 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 el 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 los Message Processors.
Verifica la configuración de G1GC en los Message Processors
En esta sección, se explica cómo verificar que la configuración de G1GC se haya modificado correctamente en los Message Processors.
Aunque uses el token conf_system_useG1GC para habilitar G1GC en el Message
Processor, debes verificar que la propiedad real useG1GC se haya establecido con
el valor nuevo de la siguiente manera:
-
Busca la propiedad
useG1GCen el directorio/opt/apigee/edge-message-processor/confy verifica que se haya establecido con el valor nuevo. Por ejemplo:grep -ri "useG1GC" /opt/apigee/edge-message-processor/conf
-
Si G1GC se habilita correctamente en el Message Processor, el comando anterior muestra
el valor nuevo en el
system.propertiesarchivo.El resultado de muestra del comando anterior, después de habilitar G1GC en el Message Processor, es el siguiente:
/opt/apigee/edge-message-processor/conf/system.properties:useG1GC=true
En el resultado de ejemplo, ten en cuenta que la propiedad
useG1GCse estableció con el valor nuevotrueensystem.properties. Esto indica que G1GC se habilitó correctamente en el Message Processor. -
Si aún ves el valor anterior de la propiedad
useG1GC, verifica que hayas seguido correctamente todos los pasos que se describen en Habilita G1GC en los Message Processors. Si omitiste algún paso, repite todos los pasos de nuevo correctamente. - Si aún no puedes habilitar G1GC, comunícate con el equipo de asistencia de Apigee Edge.
Próximos pasos
Habilita la deduplicación de cadenas en los Message Processors