Você está vendo a documentação do Apigee Edge.
Acesse a
documentação da Apigee X. informações
Este documento explica como ativar o coletor de lixo primeiro (G1GC) nos processadores de mensagens do Apigee Edge.
O processador de mensagens do Apigee Edge é executado em Java Virtual Machine (JVM) e usa o coletor de lixo padrão (serial ou paralelo, dependendo das configurações de hardware e do sistema operacional). Sob determinadas circunstâncias e com base nas suas necessidades, você pode mudar o tipo de coletor de lixo usado no processador de mensagens.
O G1GC é o coletor de lixo geracional com pausa baixa e estilo de servidor para a VM Java HotSpot, que melhora o desempenho geral do processador de mensagens. Normalmente, ele é projetado para aplicativos com conjuntos de dados de médio a grande porte, em que o tempo de resposta é mais importante do que a capacidade geral. Por exemplo: você pode considerar o uso de G1GC se o tamanho do heap for grande (maior que 3 GB).
Geralmente, é recomendável definir outro parâmetro JVM UseStringDeduplication
com G1GC. Esse parâmetro otimiza o uso da memória de heap Java fazendo com que os valores de String duplicados ou idênticos compartilhem a mesma matriz de caracteres.
Antes de começar
- Se você não conhece a coleta de lixo e os diferentes tipos de coletores em Java, leia Noções básicas sobre coleta de lixo (link em inglês).
- Se você não conhece a G1GC, leia Introdução ao coletor de lixo G1.
- Se você não souber como configurar propriedades para o Edge na nuvem privada, leia Como configurar o Edge.
Como ativar o G1GC nos processadores de mensagens
Esta seção explica como ativar o G1GC no processador de mensagens de borda. A G1GC pode ser ativada pela propriedade useG1GC
no componente do processador de mensagens. Por padrão, essa propriedade é definida como false
nos processadores de mensagens. Para configurar qualquer propriedade no processador de mensagens, use o token de acordo com a sintaxe descrita em Como configurar o Edge.
Para ativar o G1GC nos processadores de mensagens, siga estas etapas:
Localizar o token para a propriedade useG1GC
As etapas a seguir descrevem como localizar o token da propriedade useG1GC:
- Procure a propriedade
useG1GC
no diretório de origem/opt/apigee/edge-message-processor/source
do processador de mensagens usando o seguinte comando:grep -ri "useG1GC" /opt/apigee/edge-message-processor/source
-
A saída desse comando mostra o token da propriedade
useG1GC
do processador de mensagens da seguinte maneira:/opt/apigee/edge-message-processor/source/conf/system.properties:useG1GC={T}conf_system_useG1GC{/T}
A string entre as tags
{T}{/T}
é o nome do token que você pode definir no arquivo.properties
do processador de mensagens. Assim, o token da propriedadeuseG1GC
é o seguinte:conf_system_useG1GC
Ativar G1GC nos processadores de mensagens
As etapas a seguir descrevem como ativar o G1GC nos processadores de mensagens da Apigee:
-
Abra o arquivo
/opt/apigee/customer/application/message-processor.properties
na máquina do processador de mensagens em um editor. Se o arquivo ainda não existir, crie-o. Por exemplo:vi /opt/apigee/customer/application/message-processor.properties
-
Adicione a seguinte linha a este arquivo:
conf_system_useG1GC=true
- Salve as mudanças.
-
Verifique se esse arquivo de propriedades pertence ao usuário
apigee
. Por exemplo:chown apigee:apigee /opt/apigee/customer/application/message-processor.properties
-
Reinicie o processador de mensagens usando o seguinte comando:
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
- Se você tiver mais de um processador de mensagens, repita essas etapas em todos eles.
Como verificar a configuração de G1GC nos processadores de mensagens
Esta seção explica como verificar se a configuração do G1GC foi modificada nos processadores de mensagens.
Mesmo que você use o token conf_system_useG1GC
para ativar o G1GC no processador de mensagens, será necessário verificar se a propriedade useG1GC
real foi definida com o novo valor da seguinte maneira:
-
Procure a propriedade
useG1GC
no diretório/opt/apigee/edge-message-processor/conf
e verifique se ela foi definida com o novo valor. Por exemplo:grep -ri "useG1GC" /opt/apigee/edge-message-processor/conf
-
Se a G1GC for ativada no processador de mensagens, o comando anterior mostrará
o novo valor no arquivo
system.properties
.O resultado do exemplo do comando anterior, depois de ativar a G1GC no processador de mensagens, é o seguinte:
/opt/apigee/edge-message-processor/conf/system.properties:useG1GC=true
No exemplo de saída, observe que a propriedade
useG1GC
foi definida com o novo valortrue
emsystem.properties
. Isso indica que a G1GC foi ativada no processador de mensagens. -
Se o valor antigo da propriedade
useG1GC
ainda aparecer, verifique se você seguiu todas as etapas descritas em Como ativar o G1GC nos processadores de mensagens corretamente. Se você tiver perdido alguma etapa, repita todas as etapas corretamente. - Se ainda não for possível ativar o G1GC, entre em contato com o suporte do Apigee Edge.
E agora?
Como ativar a eliminação de duplicação de strings em processadores de mensagens