Attributs d'élément enfant Amazon MQ - Amazon MQ

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Attributs d'élément enfant Amazon MQ

Voici une explication détaillée des attributs d'élément enfant. Pour plus d'informations, consultez la section XMLConfiguration dans la documentation d'Apache ActiveMQ.

authorizationEntry

authorizationEntry est un enfant de la collection d'élément enfant authorizationEntries.

Attributs

admin|read|write

Les autorisations accordées à un groupe d'utilisateurs. Pour de plus amples informations, veuillez consulter Toujours configurer un plan d'autorisation.

Si vous spécifiez un plan d'autorisation qui n'inclut pas le groupe activemq-webconsole, vous ne pouvez pas utiliser la console web ActiveMQ car le groupe n'est pas autorisé à envoyer des messages à l'agent Amazon MQ ou à recevoir des messages de ce dernier.

Par défaut : null

Exemple de configuration

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

Le activemq-webconsole groupe dans ActiveMQ sur Amazon MQ possède des autorisations d'administrateur sur toutes les files d'attente et tous les sujets. Tous les utilisateurs de ce groupe auront un accès administrateur.

networkConnector

networkConnector est un enfant de la collection d'élément enfant networkConnectors.

Attributs

conduitSubscriptions

Indique si une connexion réseau dans un réseau d'agents traite plusieurs consommateurs abonnés à la même destination comme un seul consommateur. Par exemple, si conduitSubscriptions est défini comme true et que deux consommateurs se connectent à l'agent B et consomment à partir d'une destination, l'agent B combine les abonnements en un seul abonnement logique sur la connexion réseau de l'agent A, afin qu'une seule copie d'un message soit transférée de l'agent A à l'agent B.

Note

Définir conduitSubscriptions comme true peut réduire le trafic réseau redondant. Cependant, l'utilisation de cet attribut peut avoir des conséquences sur l'équilibrage de charge des messages entre les consommateurs et peut entraîner un comportement incorrect dans certains scénarios (par exemple, avec les sélecteurs de JMS messages ou avec les sujets durables).

Par défaut : true

duplex

Indique si la connexion dans le réseau d'agents est utilisée pour produire et consommer des messages. Par exemple, si l'agent A crée une connexion avec l'agent B en mode non duplex, les messages peuvent être uniquement transférés de l'agent A vers l'agent B. Toutefois, si l'agent A crée une connexion en duplex vers l'agent B, l'agent B peut alors transférer des messages vers l'agent A sans avoir à configurer de <networkConnector>.

Par défaut : false

name

Le nom du pont dans le réseau d'agents.

Par défaut : bridge

uri

Le point de terminaison de protocole de niveau filaire pour l'un des deux agents (ou pour plusieurs agents) dans un réseau d'agents.

Par défaut : null

nom d’utilisateur

Le nom d'utilisateur commun aux agents dans un réseau d'agents.

Par défaut : null

Exemples de configuration

Note

Lorsque vous utilisez un networkConnector pour définir un réseau d'agents, n'incluez pas le mot de passe pour l'utilisateur commun à vos agents.

Un réseau d'agents avec deux agents

Dans cette configuration, les deux agents sont connectés dans un réseau d'agents. Le nom du connecteur réseau estconnector_1_to_2, le nom d'utilisateur commun aux courtiers estmyCommonUser, la connexion estduplex, et le OpenWire point de terminaison URI est préfixé parstatic:, indique une one-to-one connexion entre les courtiers.

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

Pour de plus amples informations, veuillez consulter Configure Network Connectors for Your Broker.

Un réseau d'agents avec plusieurs agents

Dans cette configuration, plusieurs agents sont connectés dans un réseau d'agents. Le nom du connecteur réseau estconnector_1_to_2, le nom d'utilisateur commun aux courtiers estmyCommonUser, la connexion estduplex, et la liste des points de OpenWire terminaison séparés par des virgules URIs est préfixée parmasterslave:, indiquant une connexion de basculement entre les courtiers. Le basculement d'un agent à un autre n'est pas aléatoire et les tentatives de reconnexion continuent indéfiniment.

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

Nous vous recommandons d'utiliser le préfixe masterslave: pour le réseau d'agents. Le préfixe est identique à la syntaxe static:failover:()?randomize=false&maxReconnectAttempts=0 plus explicite.

Note

Cette XML configuration n'autorise pas les espaces.

kahaDB

kahaDB est un enfant de la collection d'élément enfant persistenceAdapter.

Attributs

concurrentStoreAndDispatchQueues

Indique s'il convient d'utiliser la répartition et le stockage simultanés pour les files d'attente. Pour de plus amples informations, veuillez consulter Désactiver Concurrent Store and Dispatch (Répartition et stockage simultanés) pour les files d'attente à consommateurs lents.

Par défaut : true

cleanupOnStop

Pris en charge dans

Apache ActiveMQ 15.16.x et versions ultérieures

Si elle est désactivée, le récupérateur de mémoire et le nettoyage n'ont pas lieu lorsque l'agent est arrêté, ce qui accélère le processus d'arrêt. La vitesse accrue est utile dans les cas avec des bases de données volumineuses ou des bases de données de planificateur.

Par défaut : true

journalDiskSyncIntervalle

Intervalle (ms) indiquant quand effectuer une synchronisation de disque si journalDiskSyncStrategy=periodic. Pour de plus amples informations, veuillez consulter la documentation Apache ActiveMQ KahadB.

Par défaut : 1000

journalDiskSyncStratégie

Pris en charge dans

Apache ActiveMQ 15.14.x et versions ultérieures

Configure la politique de synchronisation du disque. Pour de plus amples informations, veuillez consulter la documentation Apache ActiveMQ KahadB.

Par défaut : always

Note

La documentation ActiveMQ indique que la perte de données est limitée à la durée de journalDiskSyncInterval, qui a une valeur par défaut de 1 s. La perte de données peut être plus longue que l'intervalle, mais il est difficile d'être précis. Soyez prudent.

preallocationStrategy

Configure la façon dont l'agent va essayer de préallouer les fichiers journaux lorsqu'un nouveau fichier journal est nécessaire. Pour de plus amples informations, veuillez consulter la documentation Apache ActiveMQ KahadB.

Par défaut : sparse_file

Exemple de configuration

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

systemUsage

systemUsage est un enfant de la collection d'élément enfant systemUsage. Il contrôle la quantité maximale d'espace que l'agent utilisera avant de ralentir les producteurs. Pour de plus amples informations, veuillez consulter Producer Flow Control dans la documentation Apache ActiveMQ.

Élément enfant

memoryUsage

memoryUsage est un enfant de l'élément enfant systemUsage. Il gère l'utilisation de la mémoire. Utilisez memoryUsage pour conserver une trace de la quantité d'utilisation d'un élément afin que vous puissiez contrôler efficacement l'utilisation de l'ensemble de travail. Pour de plus amples informations, veuillez consulter le schéma dans la documentation ActiveMQ Apache.

Élément enfant

memoryUsage est un enfant de l'élément enfant memoryUsage.

Attribut
percentOfJvmTas

Entier compris entre 0 (inclus) et 70 (inclus).

Par défaut : 70

Attributs

sendFailIfNoSpace

Définit si une méthode send() doit échouer s'il n'y a pas d'espace libre. La valeur par défaut est false, ce qui bloque la méthode send() jusqu'à ce qu'il y ait de l'espace disponible. Pour de plus amples informations, veuillez consulter le schéma dans la documentation Apache Active MQ.

Par défaut : false

sendFailIfNoSpaceAfterTimeout

Par défaut : null

Exemple de configuration

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