Como configurar o tamanho da memória de heap nos processadores de mensagens

Você está lendo a documentação do Apigee Edge.
Acesse a documentação da Apigee X. info

O processador de mensagens do Apigee Edge é um componente baseado em Java e usa um tamanho de memória de heap padrão de 512 MB. No entanto, o tamanho de memória de heap padrão pode não ser suficiente para todos os casos de uso no Apigee Edge. Talvez seja necessário ajustar o tamanho da memória de heap para os processadores de mensagens, dependendo de seus requisitos de tráfego e processamento ou para resolver problemas relacionados à memória.

O tamanho da memória de heap de um aplicativo Java é controlado pelos parâmetros de linha de comando Java -Xms (tamanho mínimo do heap) e -Xmx (tamanho máximo do heap). Nos processadores de mensagens do Apigee Edge, eles são controlados pelas propriedades bin_setenv_min_mem e bin_setenv_max_mem. Saiba mais sobre essas propriedades em Modificar as configurações de memória Java.

Este documento explica como configurar o tamanho da memória de heap nos processadores de mensagens do Apigee Edge.

Antes de começar

Como mudar o tamanho da memória de heap nos processadores de mensagens

Esta seção explica como mudar o tamanho da memória de heap nos processadores de mensagens. A memória de heap mínima e máxima pode ser configurada pelas propriedades bin_setenv_min_mem e bin_setenv_max_mem no componente do processador de mensagens.

Para mudar o tamanho da memória de heap nos processadores de mensagens, siga estas etapas:

  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. Exemplo: 
    vi /opt/apigee/customer/application/message-processor.properties
  2. Adicione as seguintes linhas a esse arquivo: 
    bin_setenv_min_mem=minimum_heap_in_megabytes
bin_setenv_max_mem=maximum_heap_in_megabytes

    Por exemplo, se você quiser mudar o heap mínimo e máximo no processador de mensagens para 1 GB e 2 GB, respectivamente, adicione as seguintes linhas a esse arquivo: 

    bin_setenv_min_mem=1024m
bin_setenv_max_mem=2048m
  3. Salve as alterações.
  4. Verifique se esse arquivo de propriedades pertence ao usuário apigee. 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 o tamanho da memória de heap nos processadores de mensagens

Esta seção explica como verificar se as mudanças na memória de heap foram modificadas com sucesso nos processadores de mensagens.

Mesmo que você tenha usado as propriedades bin_setenv_min_mem e bin_setenv_max_mem para mudar o tamanho da memória de heap no processador de mensagens, é necessário verificar se os parâmetros de linha de comando Java reais -Xms e -Xmx foram definidos com os novos valores da seguinte maneira:

  1. Pesquise para ver se os parâmetros de linha de comando -Xms e -Xmx foram definidos com os novos valores para o processador de mensagens usando o seguinte comando: 
    ps -ef | grep message-processor | egrep -o 'Xms[0-9a-z]+|Xmx[0-9a-z]+' | tr '\r' ' '
  2. Se a memória de heap mínima e máxima tiver sido alterada no processador de mensagens, o comando anterior mostrará o novo valor listado para -Xms e -Xmx.

    O resultado de amostra do comando anterior, depois de mudar o heap mínimo e máximo no processador de mensagens, é o seguinte: 

    Xms1024m
Xmx2048m

    No exemplo de saída, observe que os novos valores para heap mínimo e máximo foram definidos.

  3. Se você ainda vir os valores antigos para -Xms e -Xmx, verifique se você seguiu todas as etapas descritas em Como mudar o tamanho da memória de heap nos processadores de mensagens corretamente. Se você perdeu alguma etapa, repita todas as etapas corretamente.
  4. Se você ainda não conseguir mudar a memória de heap, entre em contato com o suporte do Apigee Edge.

E agora?