As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Atributos de elementos filho do Amazon MQ
A seguinte é uma explicação detalhada dos atributos de elementos filho. Para obter mais informações, consulte Configuração de XML
authorizationEntry
authorizationEntry é um filho do elemento do conjunto de filhos authorizationEntries.
Atributos
admin|read|write
As permissões concedidas a um grupo de usuários. Para obter mais informações, consulte Sempre configurar um mapa de autorização.
Se você especificar um mapa de autorização que não inclua o activemq-webconsole, você não poderá usar o Console da Web do ActiveMQ porque o grupo não estará autorizado a enviar mensagens ou receber mensagens do agente do Amazon MQ.
Padrão: null
Configuração de exemplo
<authorizationPlugin> <map> <authorizationMap> <authorizationEntries> <authorizationEntry admin="admins,activemq-webconsole" read="admins,users,activemq-webconsole" write="admins,activemq-webconsole" queue=">"/> <authorizationEntry admin="admins,activemq-webconsole" read="admins,users,activemq-webconsole" write="admins,activemq-webconsole" topic=">"/> </authorizationEntries> </authorizationMap> </map> </authorizationPlugin>
networkConnector
networkConnector é um filho do elemento do conjunto de filhos networkConnectors.
Atributos
conduitSubscriptions
Especifica se uma conexão de rede em uma rede de agentes trata vários consumidores que se inscreveram para o mesmo destino como um consumidor. Por exemplo, se conduitSubscriptions estiver definido como true e dois consumidores se conectarem ao agente B e consumirem a partir de um destino, o agente B combina as assinaturas em uma única assinatura lógica pela conexão de rede para o agente A, para que apenas uma única cópia de um agente de mensagem seja encaminhado do agente A para o B.
nota
Configurar conduitSubscriptions como true pode reduzir o tráfego de rede redundante. No entanto, usar esse atributo pode ter implicações para o balanceamento de carga de mensagens entre os consumidores e pode causar comportamento incorreto em determinados cenários (por exemplo, com seletores de mensagens JMS ou com tópicos duráveis).
Padrão: true
duplex
Especifica se a conexão na rede de agentes é usada para produzir e consumir mensagens. Por exemplo, se o agente A cria uma conexão para o agente B no modo não duplex, as mensagens podem ser encaminhadas apenas do agente A para o agente B. No entanto, se o agente A cria uma conexão duplex para o agente B, então, o agente B pode encaminhar mensagens para o agente A sem a necessidade de configurar um <networkConnector>.
Padrão: false
name
O nome da ponte na rede de agentes.
Padrão: bridge
uri
O endpoint do protocolo de nível de conexão para um dos dois agentes (ou para vários agentes) em uma rede de agentes.
Padrão: null
username
O nome de usuário comum aos agentes em uma rede de agentes.
Padrão: null
Exemplos de configuração
nota
Ao usar um networkConnector para definir uma rede de agentes, não inclua a senha de usuário comum para os agentes.
Uma rede de agentes com dois agentes
Nesta configuração, dois agentes são conectados em uma rede de agentes. O nome do conector de rede é connector_1_to_2, o nome do usuário comum para os agentes é myCommonUser, a conexão é duplex e o URI de endpoint do OpenWire é prefixado pelo static:, indicando uma conexão ponto a ponto entre os agentes.
<networkConnectors> <networkConnector name="connector_1_to_2" userName="myCommonUser" duplex="true" uri="static:(ssl://b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9-1.mq.us-east-2.amazonaws.com:61617)"/> </networkConnectors>
Para obter mais informações, consulte Configure Network Connectors for Your Broker.
Uma rede de agentes com vários agentes
Nesta configuração, vários agentes são conectados em uma rede de agentes. O nome do conector de rede é connector_1_to_2, o nome de usuário comum para os agentes é myCommonUser, a conexão é duplex, e a lista de URIs de endpoint do OpenWire separada por vírgulas é prefixada pelo masterslave:, indicando uma conexão de failover entre os agentes. O failover do agente para o agente não é aleatório e tentativas de reconexão continuam indefinidamente.
<networkConnectors> <networkConnector name="connector_1_to_2" userName="myCommonUser" duplex="true" uri="masterslave:(ssl://b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9-1.mq.us-east-2.amazonaws.com:61617, ssl://b-9876l5k4-32ji-109h-8gfe-7d65c4b132a1-2.mq.us-east-2.amazonaws.com:61617)"/> </networkConnectors>
nota
Recomendamos usar o prefixo masterslave: para as redes de agentes. O prefixo é idêntico à sintaxe mais explícita static:failover:()?randomize=false&maxReconnectAttempts=0.
nota
Essa configuração de XML não permite espaços.
kahaDB
kahaDB é um filho do elemento do conjunto de filhos persistenceAdapter.
Atributos
concurrentStoreAndDispatchQueues
Especifica se é necessário usar armazenamento e despacho simultâneos para filas. Para obter mais informações, consulte Desativar o armazenamento e a expedição simultâneos para filas com consumidores lentos.
Padrão: true
cleanupOnStop
Compatível com
Apache ActiveMQ 15.16.x e versão superior
Quando desativada, a coleta de resíduos e a limpeza não ocorrem quando o agente é interrompido, o que agiliza o processo de desligamento. O aumento da velocidade é útil em casos com grandes bancos de dados ou bancos de dados do programador.
Padrão: true
journalDiskSyncInterval
Intervalo (ms) para quando executar uma sincronização de disco se journalDiskSyncStrategy=periodic. Para obter mais informações, consulte a documentação do Apache ActiveMQ kahaDB
Padrão: 1000
journalDiskSyncStrategy
Compatível com
Apache ActiveMQ 15.14.x e versão superior
Configura a política de sincronização de disco. Para obter mais informações, consulte a documentação do Apache ActiveMQ kahaDB
Padrão: always
nota
A documentação do ActiveMQjournalDiskSyncInterval, que tem um padrão de 1s. A perda de dados pode ser maior do que o intervalo, mas é difícil ser preciso. Tenha cuidado.
preallocationStrategy
Configura como o agente tentará pré-alocar os arquivos do diário quando um novo arquivo do diário for necessário. Para obter mais informações, consulte a documentação do Apache ActiveMQ kahaDB
Padrão: sparse_file
Configuração de exemplo
<broker xmlns="http://activemq.apache.org/schema/core"> <persistenceAdapter> <kahaDB preallocationStrategy="zeros" concurrentStoreAndDispatchQueues="false" journalDiskSyncInterval="10000" journalDiskSyncStrategy="periodic"/> </persistenceAdapter> </broker>
systemUsage
systemUsage é um filho do elemento do conjunto de filhos systemUsage. Ele controla a quantidade máxima de espaço que o agente usará antes de desacelerar os produtores. Para obter mais informações, consulte Controle do fluxo do produtor
Elemento filho
memoryUsage
memoryUsage é um filho do elemento filho systemUsage. Ele gerencia o uso de memória. Use memoryUsage para acompanhar quanto de um elemento está sendo usado, para que você possa controlar o uso do conjunto de trabalho de forma produtiva. Para obter mais informações, consulte o esquema
Elemento filho
memoryUsage é um filho do elemento filho memoryUsage.
Atributo
percentOfJvmHeap
Número inteiro entre 0 (inclusive) e 70 (inclusive).
Padrão: 70
Atributos
sendFailIfNoSpace
Define se um método send() deverá falhar se não houver espaço livre. O valor padrão é false, o que bloqueia o método send() até haver espaço disponível. Para obter mais informações, consulte o esquema
Padrão: false
sendFailIfNoSpaceAfterTimeout
Padrão: null
Configuração de exemplo
<broker xmlns="http://activemq.apache.org/schema/core"> <systemUsage> <systemUsage sendFailIfNoSpace="true" sendFailIfNoSpaceAfterTimeout="2000"> <memoryUsage> <memoryUsage percentOfJvmHeap="60" /> </memoryUsage>> </systemUsage> </systemUsage> </broker> </persistenceAdapter>
