Guia de operações do QPID

O Edge para nuvem privada versão 4.54.00 é fornecido com o Qpid Broker-J 10.0.1. Esta página descreve considerações de memória e disco para o apigee-qpidd componente do Edge para nuvem privada (com o Broker baseado em Java). As seções abaixo se aplicam especificamente ao caso de uso do Qpid da Apigee e explicam como ajustar o Qpid usando os mecanismos de configuração da Apigee.

Qpid na Apigee

Na Apigee, o Qpid é usado em dois fluxos de trabalho principais:

  • Analytics
  • Monetização

Em ambos os fluxos de trabalho, o processador de mensagens gera mensagens, que são coletadas em lotes e enviadas ao Qpid. Para o Analytics, as mensagens são lidas pelo servidor Qpid; para a monetização, elas são lidas pelo servidor de classificação (parte do servidor de gerenciamento). Depois de lidas, as mensagens em lote são descompactadas e ingeridas.

As seções a seguir descrevem as configurações recomendadas para memória e disco com Qpid. Essas configurações são baseadas em um único tamanho de mensagem de 2 KB para o Analytics ou a monetização. Com um tamanho de lote padrão de 50, cada mensagem no Qpid teria aproximadamente 100 KB. A Apigee permite que os proxies modifiquem e adicionem mais informações a uma mensagem (Analytics ou monetização). Em casos extremos, isso pode mudar significativamente o tamanho de uma única mensagem e a mensagem em lote geral no Qpid. Embora as recomendações gerais sobre memória e disco nas seções abaixo sejam válidas mesmo nesses casos, talvez seja necessário fazer outros ajustes no Qpid para garantir operações sem problemas.

Memória

O Qpid Broker usa dois tipos de memória: fora do heap e de heap. O Qpid armazena mensagens na memória fora do heap e usa a memória de heap para as próprias tarefas internas, mensagens diretas para filas e trocas etc. Na maioria das circunstâncias, a Apigee recomenda manter uma proporção de 3:1 entre a memória fora do heap e a memória de heap para o Qpid Broker.

As mensagens na memória fora do heap persistem no disco. Além disso, se a utilização total da memória fora do heap ultrapassar um determinado limite, o Qpid será configurado para transbordar mensagens para o disco.

Por padrão, a Apigee calcula a memória de heap e fora do heap do Qpid Broker com base na memória disponível no nó. Os scripts da Apigee têm um limite flexível de 4 GB combinados para a memória de heap e fora do heap do Qpid Broker. Se você quiser substituir esses limites, use as duas configurações abaixo para definir seus próprios valores para a memória de heap e fora do heap do Qpid.

  • Configuração para memória de heap: bin_run-qpidd_qpid.run.jvm.max_vm_heap=1024m
  • Configuração para memória fora do heap: bin_run-qpidd_qpid.run.jvm.max_direct_memory_size=3072m

Consulte Como mudar uma configuração do Qpid para informações sobre como substituir configurações.

Para mais informações, consulte a referência do Apache Qpid para memória.

Disco

O diretório de dados do Qpid Broker é $APIGEE_ROOT/data/apigee-qpidd. Os registros do Qpid Broker são armazenados em $APIGEE_ROOT/var/log/apigee-qpidd.

O desempenho do sistema de arquivos que hospeda o diretório de dados é fundamental para o desempenho do Broker como um todo. Para melhor desempenho, escolha um dispositivo com baixa latência e que não seja usado por outros aplicativos.

O Qpid Broker mantém as mensagens no diretório de dados. Por padrão, o Broker aceita mensagens até que o sistema de arquivos que hospeda o diretório de dados esteja 80% cheio. É possível modificar esse limite substituindo a configuração mostrada no exemplo abaixo em cada nó do Qpid.

bin_run-qpidd_qpid.store.filesystem.maxUsagePercent=60

Neste exemplo, o Broker rejeita novas mensagens quando o sistema de arquivos subjacente está 60% cheio.

Como mudar uma configuração do Qpid

Para mudar uma configuração do Qpid:

  1. Crie ou edite o seguinte arquivo:
    $APIGEE_ROOT/customer/application/qpidd.properties
  2. Adicione, remova ou modifique a configuração conforme necessário. Por exemplo, para mudar a memória máxima de heap do Qpid Broker para 6 GB, adicione a seguinte substituição de configuração no arquivo:
    bin_run-qpidd_qpid.run.jvm.max_vm_heap=6144M
  3. Salve as mudanças e verifique se o arquivo pertence e pode ser lido pelo usuário apigee:
    chown apigee:apigee $APIGEE_ROOT/customer/application/qpidd.properties
  4. Reinicie o processo qpidd:
    apigee-service apigee-qpidd restart