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á.

# Configurações do agente do Amazon MQ para ActiveMQ
<a name="amazon-mq-broker-configuration-parameters"></a>

 Uma configuração contém todas as definições do agente do ActiveMQ no formato XML (semelhante ao arquivo `activemq.xml` do ActiveMQ). Você pode criar uma configuração antes de criar qualquer agente. Em seguida, você pode aplicar a configuração a um ou mais agentes. 

**Importante**  
Fazer alterações em uma configuração *não* aplica as alterações ao agente imediatamente. Para aplicar as alterações, você deve aguardar a próxima janela de manutenção ou [reiniciar o agente](amazon-mq-rebooting-broker.md).  
Você só pode **excluir** uma configuração usando a API do `DeleteConfiguration`. Para obter mais informações, consulte [Configurações](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/configurations-configuration-id.html) na *Referência da API do Amazon MQ*.

## Atributos
<a name="configuration-attributes"></a>

A configuração de um agente tem vários atributos, por exemplo:
+ Um nome (`MyConfiguration`)
+ Um ID (`c-1234a5b6-78cd-901e-2fgh-3i45j6k178l9`)
+ Um Nome do Recurso da Amazon (ARN) (`arn:aws:mq:us-east-2:123456789012:configuration:c-1234a5b6-78cd-901e-2fgh-3i45j6k178l9`)

Para obter uma lista completa de atributos de configuração, consulte o seguinte na *Referência de API Amazon MQ REST*:
+ [ID da operação REST: Configuração](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/rest-api-configuration.html)
+ [ID da operação REST: Configurações](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/rest-api-configurations.html)

Para obter uma lista completa de atributos de revisão de configuração, consulte o seguinte:
+ [ID da operação REST: Revisão da configuração](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/rest-api-configuration-revision.html)
+ [ID da operação REST: Revisões de configuração](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/rest-api-configuration-revisions.html)

## Usar arquivos de configuração XML do Spring
<a name="working-with-spring-xml-configuration-files"></a>

Os agentes do ActiveMQ são configurados usando arquivos [XML do Spring](https://docs.spring.io/spring/docs/current/spring-framework-reference/). É possível configurar vários aspectos do agente do ActiveMQ, como destinos pré-definidos, políticas de destino, políticas de autorização e plugins. O Amazon MQ controla alguns desses elementos de configuração, como transportes de rede e armazenamento. Outras opções de configuração, como a criação de redes de agentes, não são compatíveis atualmente.

O conjunto completo de opções de configuração compatíveis é especificado nos esquemas XML do Amazon MQ. Faça download de arquivos zip dos esquemas compatíveis usando os links a seguir.
+ [samples/amazon-mq-active-mq-5.19.1.xsd.zip](samples/amazon-mq-active-mq-5.19.1.xsd.zip) 
+ [samples/amazon-mq-active-mq-5.18.4.xsd.zip](samples/amazon-mq-active-mq-5.18.4.xsd.zip) 
+ [samples/amazon-mq-active-mq-5.17.6.xsd.zip](samples/amazon-mq-active-mq-5.17.6.xsd.zip) 
+ [samples/amazon-mq-active-mq-5.16.7.xsd.zip](samples/amazon-mq-active-mq-5.16.7.xsd.zip) 
+  [samples/amazon-mq-active-mq-5.15.16.xsd.zip](samples/amazon-mq-active-mq-5.15.16.xsd.zip) 

Esses esquemas podem ser usados para validar e limpar seus arquivos de configuração. O Amazon MQ também permite que você forneça configurações enviando arquivos XML. Ao carregar um arquivo XML, o Amazon MQ limpa e remove automaticamente parâmetros de configuração inválidos e proibidos de acordo com o esquema.

**nota**  
Para os atributos, é possível usar apenas valores estáticos. O Amazon MQ limpa elementos e atributos que contenham expressões, variáveis e referências de elementos do Spring da configuração que você fez.

# Criar uma configuração do agente do Amazon MQ para ActiveMQ
<a name="amazon-mq-creating-applying-configurations"></a>

Uma *configuração* contém todas as configurações do agente do ActiveMQ no formato XML (semelhante ao arquivo `activemq.xml` do ActiveMQ). Você pode criar uma configuração antes de criar qualquer agente. Em seguida, você pode aplicar a configuração a um ou mais agentes. As configurações podem ser aplicadas imediatamente ou durante uma *janela de manutenção*.

O exemplo a seguir mostra como criar e aplicar uma configuração de agente do Amazon MQ utilizando o Console de gerenciamento da AWS.

**Importante**  
Você só pode **excluir** uma configuração usando a API do `DeleteConfiguration`. Para obter mais informações, consulte [Configurações](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/configurations-configuration-id.html) na *Referência da API do Amazon MQ*.

## Criar uma configuração
<a name="creating-configuration-from-scratch-console"></a>

Para criar uma configuração do agente, primeiro crie a configuração.

1. Faça login no [console do Amazon MQ](https://console.aws.amazon.com/amazon-mq/).

1. Do lado esquerdo, expanda o painel de navegação e selecione **Configurations (Configurações)**.  
![\[Amazon MQ navigation panel showing Brokers and Configurations options.\]](http://docs.aws.amazon.com/pt_br/amazon-mq/latest/developer-guide/images/amazon-mq-tutorials-create-configuration.png)

1. Na página **Configurações**, selecione **Criar configuração**.

1. Na página **Criar configuração**, na seção **Detalhes**, digite o **Nome da configuração** (por exemple, `MyConfiguration`) e selecione uma versão do **Mecanismo do agente**.
**nota**  
Para saber mais sobre as versões do mecanismo ActiveMQ compatíveis com o Amazon MQ para ActiveMQ, consulte[Gerenciar as versões do mecanismo do Amazon MQ para ActiveMQ](activemq-version-management.md).

1. Escolha **Criar configuração**.

## Criar uma revisão de configuração
<a name="creating-new-configuration-revision-console"></a>

Depois de criar uma configuração do agente, você precisará editá-la usando uma revisão da configuração.

1. Na lista de configuração, escolha ***MyConfiguration***.
**nota**  
A primeira revisão de configuração será sempre criada para você quando o Amazon MQ criar a configuração.

   Na ***MyConfiguration***página, o tipo e a versão do broker engine que sua nova revisão de configuração usa (por exemplo, **Apache ActiveMQ** 5.15.16) são exibidos.

1. Na guia **Configuration details (Detalhes da configuração)**, são exibidos o número de revisão da configuração, a descrição e a configuração do agente no formato XML.
**nota**  
Editar a configuração atual irá criar uma nova revisão da configuração.  
![\[XML configuration snippet for ActiveMQ broker with explanatory comment.\]](http://docs.aws.amazon.com/pt_br/amazon-mq/latest/developer-guide/images/amazon-mq-tutorials-edit-configuration.png)

1. Selecione **Edit configuration (Editar configuração)** e faça as alterações na configuração XML.

1. Escolha **Salvar**.

   A caixa e diálogo **Save revision** (Salvar revisão) será exibida.

1. (Opcional) Tipo `A description of the changes in this revision`.

1. Escolha **Salvar**.

   A nova revisão da configuração é salva.
**Importante**  
O console do Amazon MQ limpa automaticamente parâmetros de configuração inválidos e proibidos de acordo com um esquema. Para obter mais informações e uma lista completa dos parâmetros XML permitidos, consulte [Configurações do agente do Amazon MQ para ActiveMQ](amazon-mq-broker-configuration-parameters.md).

## Aplicar uma revisão de configuração ao operador
<a name="apply-configuration-revision-creating-console"></a>

Depois de revisar a configuração, você pode aplicá-la ao agente.

1. Do lado esquerdo, expanda o painel de navegação e selecione **Brokers (Agentes)**.  
![\[Amazon MQ navigation panel showing Brokers and Configurations options.\]](http://docs.aws.amazon.com/pt_br/amazon-mq/latest/developer-guide/images/amazon-mq-tutorials-apply-configuration.png)

1. Na lista de corretores, selecione seu corretor (por exemplo **MyBroker**) e escolha **Editar**.

1. Na *MyBroker* página **Editar**, na seção **Configuração**, selecione uma **Configuração** e uma **Revisão** e, em seguida, escolha **Programar Modificações**.

1. Na seção **Schedule broker modifications (Programar modificações no operador)**, escolha se deseja aplicar as modificações **During the next scheduled maintenance window (Durante a próxima janela de manutenção programada)** ou **Immediately (Imediatamente)**.
**Importante**  
Os agentes de instância única ficarão offline durante a reinicialização. Para agentes de cluster, somente um nó fica inativo por vez enquanto o agente é reinicializado.

1. Escolha **Aplicar**.

   Sua revisão de configuração será aplicada ao agente no horário especificado.

# Editar uma revisão de configuração do Amazon MQ para o ActiveMQ
<a name="edit-current-configuration-console"></a>

Recomendamos que você edite uma revisão de configuração depois de aplicá-la ao agente. Use as instruções a seguir para editar uma revisão de configuração.

1. Faça login no [console do Amazon MQ](https://console.aws.amazon.com/amazon-mq/).

1. Na lista de corretores, selecione seu corretor (por exemplo **MyBroker**) e escolha **Editar**.

1. Na ***MyBroker***página, escolha **Editar**.

1. Na *MyBroker* página **Editar**, na seção **Configuração**, selecione uma **Configuração** e uma **Revisão** e escolha **Editar**.
**nota**  
A menos que você selecione uma configuração ao criar um agente, a primeira revisão de configuração será sempre criada para você quando o Amazon MQ criar o agente.

   Na ***MyBroker***página, o tipo e a versão do mecanismo do broker que a configuração usa (por exemplo, **Apache ActiveMQ** 5.15.8) são exibidos.

1. Na guia **Configuration details (Detalhes da configuração)**, são exibidos o número de revisão da configuração, a descrição e a configuração do agente no formato XML.
**nota**  
Editar a configuração atual irá criar uma nova revisão da configuração.  
![\[XML configuration snippet for ActiveMQ broker with explanatory comment.\]](http://docs.aws.amazon.com/pt_br/amazon-mq/latest/developer-guide/images/amazon-mq-tutorials-edit-configuration.png)

1. Selecione **Edit configuration (Editar configuração)** e faça as alterações na configuração XML.

1. Escolha **Salvar**.

   A caixa e diálogo **Save revision** (Salvar revisão) será exibida.

1. (Opcional) Tipo `A description of the changes in this revision`.

1. Escolha **Salvar**.

   A nova revisão da configuração é salva.
**Importante**  
O console do Amazon MQ limpa automaticamente parâmetros de configuração inválidos e proibidos de acordo com um esquema. Para obter mais informações e uma lista completa dos parâmetros XML permitidos, consulte [Configurações do agente do Amazon MQ para ActiveMQ](amazon-mq-broker-configuration-parameters.md).

# Elementos permitidos nas configurações do Amazon MQ
<a name="permitted-elements"></a>

Veja a seguir uma lista detalhada dos elementos permitidos nas configurações do Amazon MQ. Para obter mais informações, consulte [Configuração de XML](http://activemq.apache.org/xml-configuration.html) na documentação do Apache ActiveMQ.


| Elemento | 
| --- | 
| abortSlowAckConsumerStrategy [(atributos)](permitted-attributes.md#abortSlowAckConsumerStrategy.attributes) | 
| abortSlowConsumerStrategy [(atributos)](permitted-attributes.md#abortSlowConsumerStrategy.attributes) | 
| authorizationEntry [(atributos)](permitted-attributes.md#authorizationEntry.attributes) | 
| authorizationMap [(elementos de conjunto de filhos)](permitted-collections.md#authorizationMap.collections) | 
| authorizationPlugin [(elementos de conjunto de filhos)](permitted-collections.md#authorizationPlugin.collections) | 
| broker [(atributos](permitted-attributes.md#broker.attributes) \$1 [elementos de conjunto de filhos)](permitted-collections.md#broker.collections) | 
| cachedMessageGroupMapFactory [(atributos)](permitted-attributes.md#cachedMessageGroupMapFactory.attributes) | 
| compositeQueue [(atributos](permitted-attributes.md#compositeQueue.attributes) \$1 [elementos de conjunto de filhos)](permitted-collections.md#compositeQueue.collections) | 
| compositeTopic [(atributos](permitted-attributes.md#compositeTopic.attributes) \$1 [elementos de conjunto de filhos)](permitted-collections.md#compositeTopic.collections) | 
| constantPendingMessageLimitStrategy [(atributos)](permitted-attributes.md#constantPendingMessageLimitStrategy.attributes) | 
| discarding [(atributos)](permitted-attributes.md#discarding.attributes) | 
| discardingDLQBrokerPlugin [(atributos)](permitted-attributes.md#discardingDLQBrokerPlugin.attributes) | 
| fileCursor | 
| fileDurableSubscriberCursor | 
| fileQueueCursor | 
| filteredDestination [(atributos)](permitted-attributes.md#filteredDestination.attributes) | 
| fixedCountSubscriptionRecoveryPolicy [(atributos)](permitted-attributes.md#fixedCountSubscriptionRecoveryPolicy.attributes) | 
| fixedSizedSubscriptionRecoveryPolicy [(atributos)](permitted-attributes.md#fixedSizedSubscriptionRecoveryPolicy.attributes) | 
| forcePersistencyModeBrokerPlugin [(atributos)](permitted-attributes.md#forcePersistencyModeBrokerPlugin.attributes) | 
| individualDeadLetterStrategy [(atributos)](permitted-attributes.md#individualDeadLetterStrategy.attributes) | 
| lastImageSubscriptionRecoveryPolicy | 
| messageGroupHashBucketFactory [(atributos)](permitted-attributes.md#messageGroupHashBucketFactory.attributes) | 
| mirroredQueue [(atributos)](permitted-attributes.md#mirroredQueue.attributes) | 
| noSubscriptionRecoveryPolicy | 
| oldestMessageEvictionStrategy [(atributos)](permitted-attributes.md#oldestMessageEvictionStrategy.attributes) | 
| oldestMessageWithLowestPriorityEvictionStrategy [(atributos)](permitted-attributes.md#oldestMessageWithLowestPriorityEvictionStrategy.attributes) | 
| policyEntry [(atributos](permitted-attributes.md#policyEntry.attributes) \$1 [elementos de conjunto de filhos)](permitted-collections.md#policyEntry.collections) | 
| policyMap [(elementos de conjunto de filhos)](permitted-collections.md#policyMap.collections) | 
| prefetchRatePendingMessageLimitStrategy [(atributos)](permitted-attributes.md#prefetchRatePendingMessageLimitStrategy.attributes) | 
| priorityDispatchPolicy | 
| priorityNetworkDispatchPolicy | 
| queryBasedSubscriptionRecoveryPolicy [(atributos)](permitted-attributes.md#queryBasedSubscriptionRecoveryPolicy.attributes) | 
| queue [(atributos)](permitted-attributes.md#queue.attributes) | 
| redeliveryPlugin [(atributos](permitted-attributes.md#redeliveryPlugin.attributes) \$1 [elementos de conjunto de filhos)](permitted-collections.md#redeliveryPlugin.collections) | 
| redeliveryPolicy [(atributos)](permitted-attributes.md#redeliveryPolicy.attributes) | 
| redeliveryPolicyMap [(elementos de conjunto de filhos)](permitted-collections.md#redeliveryPolicyMap.collections) | 
| retainedMessageSubscriptionRecoveryPolicy [(elementos de conjunto de filhos)](permitted-collections.md#retainedMessageSubscriptionRecoveryPolicy.collections) | 
| roundRobinDispatchPolicy | 
| sharedDeadLetterStrategy [(atributos](permitted-attributes.md#sharedDeadLetterStrategy.attributes) \$1 [elementos de conjunto de filhos)](permitted-collections.md#sharedDeadLetterStrategy.collections) | 
| simpleDispatchPolicy | 
| simpleMessageGroupMapFactory | 
| statisticsBrokerPlugin | 
| storeCursor | 
| storeDurableSubscriberCursor [(atributos)](permitted-attributes.md#storeDurableSubscriberCursor.attributes) | 
| strictOrderDispatchPolicy | 
| tempDestinationAuthorizationEntry [(atributos)](permitted-attributes.md#tempDestinationAuthorizationEntry.attributes) | 
| tempQueue [(atributos)](permitted-attributes.md#tempQueue.attributes) | 
| tempTopic [(atributos)](permitted-attributes.md#tempTopic.attributes) | 
| timedSubscriptionRecoveryPolicy [(atributos)](permitted-attributes.md#timedSubscriptionRecoveryPolicy.attributes) | 
| timeStampingBrokerPlugin [(atributos)](permitted-attributes.md#timeStampingBrokerPlugin.attributes) | 
| topic [(atributos)](permitted-attributes.md#topic.attributes) | 
| transportConnector [(atributos)](permitted-attributes.md#transportConnector.attributes) | 
| uniquePropertyMessageEvictionStrategy [(atributos)](permitted-attributes.md#uniquePropertyMessageEvictionStrategy.attributes) | 
| virtualDestinationInterceptor [(elementos de conjunto de filhos)](permitted-collections.md#virtualDestinationInterceptor.collections) | 
| virtualTopic [(atributos)](permitted-attributes.md#virtualTopic.attributes) | 
| vmCursor | 
| vmDurableCursor | 
| vmQueueCursor | 

# Elementos e atributos permitidos nas configurações do Amazon MQ
<a name="permitted-attributes"></a>

A seguinte é uma lista detalhada dos elementos e de seus atributos permitidos nas configurações do Amazon MQ. Para obter mais informações, consulte [Configuração de XML](http://activemq.apache.org/xml-configuration.html) na documentação do Apache ActiveMQ.

Use as barras de rolagem para ver o restante da tabela.

[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/amazon-mq/latest/developer-guide/permitted-attributes.html)

## Atributos de elementos pai do Amazon MQ
<a name="parent-element-details"></a>

A seguinte é uma explicação detalhada dos atributos de elementos pai. Para obter mais informações, consulte [Configuração de XML](http://activemq.apache.org/xml-configuration.html) na documentação do Apache ActiveMQ.

**Topics**
+ [agente](#broker-element)

### agente
<a name="broker-element"></a>

`broker` é um elemento de coleção pai. 

#### Atributos
<a name="broker-attributes"></a>

##### networkConnectionStartAssíncrono
<a name="networkConnectionStartAsync"></a>

Para reduzir a latência da rede e permitir que outras redes para iniciar em tempo hábil, use a tag `<networkConnectionStartAsync>`. A tag instrui o agente a usar um executor para iniciar conexões de rede em paralelo, assíncrona para um agente iniciar.

**Padrão**: `false`

#### Exemplo de configuração
<a name="networkConnectorStartAsync"></a>

```
<broker networkConnectorStartAsync="false"/>
```

# Elementos, elementos de conjunto secundários e elementos secundários permitidos nas configurações do Amazon MQ
<a name="permitted-collections"></a>

A seguinte é uma lista detalhada dos elementos, elementos do conjunto de filhos e de seus elementos filho permitidos nas configurações do Amazon MQ. Para obter mais informações, consulte [Configuração de XML](http://activemq.apache.org/xml-configuration.html) na documentação do Apache ActiveMQ.

Use as barras de rolagem para ver o restante da tabela.

[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/amazon-mq/latest/developer-guide/permitted-collections.html)

# Atributos de elementos filho do Amazon MQ
<a name="child-element-details"></a>

A seguinte é uma explicação detalhada dos atributos de elementos filho. Para obter mais informações, consulte [Configuração de XML](http://activemq.apache.org/xml-configuration.html) na documentação do Apache ActiveMQ.

**Topics**
+ [authorizationEntry](#authorizationEntry)
+ [networkConnector](#networkConnector)
+ [kahaDB](#kahaDB)
+ [systemUsage](#systemUsage)

## authorizationEntry
<a name="authorizationEntry"></a>

`authorizationEntry` é um filho do elemento do conjunto de filhos `authorizationEntries`.

### Atributos
<a name="admin-read-write-attributes"></a>

#### admin\$1read\$1write
<a name="admin-read-write"></a>

As permissões concedidas a um grupo de usuários. Para obter mais informações, consulte [Sempre configurar um mapa de autorização](using-amazon-mq-securely.md#always-configure-authorization-map).

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`

### Exemplo de configuração
<a name="admin-read-write-example"></a>

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

**nota**  
 O grupo `activemq-webconsole` do ActiveMQ no Amazon MQ tem permissões de administrador em todas as filas e tópicos. Todos os usuários desse grupo terão acesso de administrador. 

## networkConnector
<a name="networkConnector"></a>

`networkConnector` é um filho do elemento do conjunto de filhos `networkConnectors`.

**Topics**
+ [Atributos](#networkConnector-attributes)
+ [Exemplos de configuração](#networkConnector-example)

### Atributos
<a name="networkConnector-attributes"></a>

#### conduitSubscriptions
<a name="conduitSubscriptions"></a>

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
<a name="duplex"></a>

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
<a name="name"></a>

O nome da ponte na rede de agentes.

**Padrão**: `bridge`

#### uri
<a name="uri"></a>

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
<a name="username"></a>

O nome de usuário comum aos agentes em uma rede de agentes.

**Padrão**: `null`

### Exemplos de configuração
<a name="networkConnector-example"></a>

**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
<a name="example-network-of-brokers-two-brokers"></a>

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 de usuário comum aos corretores é`myCommonUser`, a conexão é `duplex` e o URI do OpenWire endpoint é prefixado por`static:`, indicando uma one-to-one conexão entre os corretores.

```
<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 [Etapa 2: Configurar os conectores de rede para o seu agente](amazon-mq-creating-configuring-network-of-brokers.md#creating-configuring-network-of-brokers-configure-network-connectors).

#### Uma rede de agentes com vários agentes
<a name="example-network-of-brokers-multiple-brokers"></a>

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 aos corretores é`myCommonUser`, a conexão é`duplex`, e a lista de OpenWire endpoints separados por vírgulas URIs é prefixada por`masterslave:`, indicando uma conexão de failover entre os corretores. 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-west-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
<a name="kahaDB"></a>

`kahaDB` é um filho do elemento do conjunto de filhos `persistenceAdapter`.

### Atributos
<a name="kahaDB-attributes"></a>

#### concurrentStoreAndDispatchQueues
<a name="concurrentStoreAndDispatchQueues"></a>

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](best-practices-activemq.md#disable-concurrent-store-and-dispatch-queues-flag-slow-consumers).

**Padrão**: `true`

#### cleanupOnStop
<a name="cleanupOnStop"></a>

**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`

#### journalDiskSyncIntervalo
<a name="journalDiskSyncInterval"></a>

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](https://activemq.apache.org/kahadb).

**Padrão**: `1000`

#### journalDiskSyncEstratégia
<a name="journalDiskSyncStrategy"></a>

**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](https://activemq.apache.org/kahadb).

**Padrão**: `always`

**nota**  
A [documentação do ActiveMQ](https://activemq.apache.org/kahadb) afirma que a perda de dados é limitada à duração de `journalDiskSyncInterval`, 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
<a name="preallocationStrategy"></a>

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](https://activemq.apache.org/kahadb).

**Padrão**: `sparse_file`

### Exemplo de configuração
<a name="kahaDB-example"></a>

**Example**  

```
<broker xmlns="http://activemq.apache.org/schema/core">
                                <persistenceAdapter>
                                <kahaDB preallocationStrategy="zeros" concurrentStoreAndDispatchQueues="false" journalDiskSyncInterval="10000" journalDiskSyncStrategy="periodic"/>
                            </persistenceAdapter>
                            </broker>
```

## systemUsage
<a name="systemUsage"></a>

`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](http://activemq.apache.org/producer-flow-control.html) na documentação do Apache ActiveMQ. 

### Elemento filho
<a name="systemUsage-child"></a>

#### memoryUsage
<a name="memoryUsage"></a>

 `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](http://activemq.apache.org/schema/core/activemq-core-5.15.12-schema.html) na documentação do Apache ActiveMQ.

##### Elemento filho
<a name="memoryUsage-child"></a>

 `memoryUsage` é um filho do elemento filho `memoryUsage`. 

##### Atributo
<a name="memeoryUsage-attribute"></a>

##### percentOfJvmPilha
<a name="percentOfJvmHeap"></a>

Número inteiro entre 0 (inclusive) e 70 (inclusive).

*Padrão*: `70` 

### Atributos
<a name="systemUsage-attributes"></a>

#### sendFailIfNoSpace
<a name="sendFailIfNoSpace"></a>

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](http://activemq.apache.org/schema/core/activemq-core-5.15.12-schema.html) na documentação do Apache Active MQ.

**Padrão**: `false`

#### sendFailIfNoSpaceAfterTimeout
<a name="sendFailIfNoSpaceAfterTimeout"></a>

**Padrão**: `null`

#### Exemplo de configuração
<a name="systemUsage-example"></a>

**Example**  

```
<broker xmlns="http://activemq.apache.org/schema/core">
                                <systemUsage>
                                <systemUsage sendFailIfNoSpace="true" sendFailIfNoSpaceAfterTimeout="2000">
                                    <memoryUsage>
                                        <memoryUsage  percentOfJvmHeap="60" />
                                    </memoryUsage>>
                                </systemUsage>
                                </systemUsage>
                            </broker>
                            </persistenceAdapter>
```