Como ativar o G1GC nos processadores de mensagens

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

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:

  1. Localize o token para a propriedade useG1GC
  2. Ativar G1GC no processador de mensagens

Localizar o token para a propriedade useG1GC

As etapas a seguir descrevem como localizar o token da propriedade useG1GC:

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

  1. 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
    
  2. Adicione a seguinte linha a este arquivo:
    conf_system_useG1GC=true
    
  3. Salve as mudanças.
  4. Verifique se esse arquivo de propriedades pertence ao usuário apigee. Por exemplo:
    chown apigee:apigee /opt/apigee/customer/application/message-processor.properties
    
  5. Reinicie o processador de mensagens usando o seguinte comando:
    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
    
  6. 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:

  1. 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
    
  2. 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 valor true em system.properties. Isso indica que a G1GC foi ativada no processador de mensagens.

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