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
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
.
Rubriques
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 ActiveMQjournalDiskSyncInterval
, 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
É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
É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
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>