Cómo habilitar G1GC en los Message Processor

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

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:

  1. Cómo ubicar el token para la propiedad useG1GC
  2. Habilita G1GC en Message Processor

Ubica el token para la propiedad useG1GC

En los siguientes pasos, se describe cómo ubicar el token para la propiedad useG1GC:

  1. 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
    
  2. 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 propiedad useG1GC 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:

  1. 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
    
  2. Agrega la siguiente línea a este archivo:
    conf_system_useG1GC=true
    
  3. Guarda los cambios.
  4. 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
    
  5. Reinicia Message Processor con el siguiente comando:
    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
    
  6. 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:

  1. 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
    
  2. 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 nuevo true en system.properties. Esto indica que G1GC se habilitó correctamente en Message Processor.

  3. 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.
  4. 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