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

Você está vendo a documentação do Apigee Edge.
Acesse a documentação da Apigee X.
informações

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

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

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

Antes de começar

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

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

Para alterar o tamanho da memória de heap nos processadores de mensagens, execute as seguintes 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. Por exemplo:
    vi /opt/apigee/customer/application/message-processor.properties
    
  2. Adicione as seguintes linhas a este arquivo:
    bin_setenv_min_mem=minimum_heap_in_megabytes
    bin_setenv_max_mem=maximum_heap_in_megabytes
    

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

    bin_setenv_min_mem=1024m
    bin_setenv_max_mem=2048m
    
  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 o tamanho da memória heap nos processadores de mensagens

Esta seção explica como verificar se as alterações na memória heap foram modificadas com êxito nos processadores de mensagens.

Mesmo que você tenha usado as propriedades bin_setenv_min_mem e bin_setenv_max_mem para alterar o tamanho da memória de heap no processador de mensagens, é necessário verificar se os parâmetros reais da linha de comando Java -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 as memórias de heap mínima e máxima tiverem sido alteradas no processador de mensagens, o comando anterior mostrará o novo valor listado para -Xms e -Xmx.

    O resultado do exemplo do comando anterior, depois de alterar 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 de heap mínimo e máximo foram definidos.

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

E agora?