Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Replicación de datos entre regiones para Amazon MQ para ActiveMQ
<a name="crdr-for-active-mq"></a>

 Amazon MQ para ActiveMQ ofrece una característica de replicación de datos entre regiones (CRDR) que permite la replicación asíncrona de mensajes desde el agente primario de una región  de AWS principal al agente de réplicas de una región de réplicas. Al emitir una solicitud de conmutación por error a la API de Amazon MQ, el agente de réplicas actual se asciende al rol de agente principal y el agente principal actual se degrada al rol de réplicas. 

## Agentes principales y de réplicas para la replicación de datos entre regiones
<a name="crdr-primary-replica-brokers"></a>

 Puede crear agentes principales y de réplicas para la replicación asíncrona de datos desde el agente principal de una región de AWS primaria al agente de réplicas de una región de réplicas. La *región principal* consta de un par redundante de agentes activos o en espera denominado *agente principal*. La *región secundaria* consta de un par redundante de agentes activos o en espera denominado *agente de réplicas*. 

 En el siguiente diagrama se ilustra un agente de réplicas en una región secundaria que recibe datos replicados asíncronos del agente principal en la región principal. 

![\[Diagram showing primary and replica brokers in different AWS regions with replication traffic flow.\]](http://docs.aws.amazon.com/es_es/amazon-mq/latest/developer-guide/images/primary-replica-connection.png)


 Los agentes principales y de réplicas actúan como una solución de recuperación de datos entre regiones. Si el agente principal de la región principal falla, puede ascender a primario al agente de réplicas de la región secundaria iniciando una conmutación o conmutación por error. El antiguo agente principal se convierte entonces en el agente de réplicas y el antiguo agente de réplicas se asciende a agente principal. Para obtener instrucciones sobre la creación de un agente principal y de réplicas, consulte [Creación de un agente de replicación de datos entre regiones de Amazon MQ](create-replica-broker.md). 

**nota**  
Solo disponible para agentes activos o en espera.  
No disponible para colas duplicadas.

# Creación de un agente de replicación de datos entre regiones de Amazon MQ
<a name="create-replica-broker"></a>

 Con la replicación de datos entre regiones (CRDR), puede alternar entre agentes de mensajes de Amazon MQ para ActiveMQ en dos regiones de AWS según sea necesario. Puede designar un agente existente como agente principal y crear una réplica para este agente o crear un nuevo agente principal y de réplicas juntos. A continuación, puede ascender el agente de réplicas al rol de agente principal mediante la operación de la API `Promote` de Amazon MQ. Para obtener más información sobre los agentes principales y de réplicas, consulte [Agentes principales y de réplicas para la replicación de datos entre regiones](crdr-for-active-mq.md#crdr-primary-replica-brokers). 

 Las siguientes instrucciones describen cómo puede crear y configurar un agente de réplicas mediante la consola de administración de Amazon MQ. 

**Topics**
+ [Requisitos previos](#create-crdr-broker-prerequisites)
+ [Paso 1 (opcional): Crear un nuevo agente principal](#create-new-primary-broker)
+ [Create a replica of an existing broker](#create-new-replica-broker)

## Requisitos previos
<a name="create-crdr-broker-prerequisites"></a>

Para utilizar la característica de replicación de datos entre regiones, debe revisar y cumplir los siguientes requisitos previos:
+  **Versión**: la característica de replicación de datos entre regiones solo está disponible para agentes de Amazon MQ en la versión 5.17.6 y versiones más recientes. 
+  **Región**: la replicación de datos entre regiones se admite en las siguientes regiones: Este de EE. UU. (Ohio), Este de EE. UU. (Norte de Virginia), Oeste de EE. UU. (Oregón) y Oeste de EE. UU. (Norte de California). 
+  **Tipo de instancia**: la replicación de datos entre regiones solo está disponible para instancias de agente de tamaño `mq.m5.large` y superiores. 
+  **Tipo de implementación**: la replicación de datos entre regiones solo está disponible para agentes activos o en espera con implementación en zonas de disponibilidad múltiple. 
+  **Estado de agente**: solo puede crear un agente de réplicas para un agente principal con el estado de agente `Running`. 

## Paso 1 (opcional): Crear un nuevo agente principal
<a name="create-new-primary-broker"></a>

### Crear un nuevo agente principal
<a name="create-new-primary-broker-procedure"></a>

1. Inicie sesión en la [consola de Amazon MQ](https://console.aws.amazon.com/amazon-mq/).

1. En la página de agentes de la consola de Amazon MQ, elija **Crear agentes**.

1.  En la página **Select broker engine** (Seleccionar motor de agente), elija **Apache ActiveMQ**. 

1.  En la página **Select deployment and storage** (Seleccionar implementación y almacenamiento), sección **Deployment mode and storage type** (Modo de implementación y tipo de almacenamiento), haga lo siguiente: 

   1. En **Modo de implementación**, elija **Agente activo/en espera**. Un **Agente activo/en espera** se compone de dos agentes en dos zonas de disponibilidad diferentes configurados en un par redundante. Estos agentes se comunican de forma sincrónica con su aplicación y con Amazon EFS. Para obtener más información, consulte [Opciones de implementación de Amazon MQ para agentes de ActiveMQ](amazon-mq-broker-architecture.md). 

1.  Elija **Siguiente**. 

1. En la página **Configure settings** (Configurar ajustes), sección **Details** (Detalles), haga lo siguiente:

   1. Ingrese el **nombre del agente**.
**importante**  
 No agregue información de identificación personal (PII) ni ninguna otra información confidencial en los nombres de agente. Los nombres de agente y los nombres de usuario están disponibles para otros servicios de AWS, incluido CloudWatch Logs. Los nombres de agente no están diseñados para usarse con información privada o confidencial. 

   1. Elija el **tipo de instancias del agente** (por ejemplo, **mq.m5.large**). Para obtener más información, consulte [Amazon MQ para tipos de instancia de agentes de ActiveMQ](broker-instance-types.md).

1.  En la sección de acceso a la **consola web de ActiveMQ**, introduzca un **nombre de usuario** y una **contraseña**. Las siguientes restricciones se aplican a los nombres de usuario y las contraseñas de los agentes: 
   +  El nombre de usuario solo puede contener caracteres alfanuméricos, guiones, puntos, guiones bajos y tildes (- . \$1 \$1). 
   +  Esta contraseña debe tener 12 caracteres como mínimo, debe contener al menos 4 caracteres únicos y no puede incluir comas, dos puntos ni signos de igual (,:=). 
**importante**  
No agregue información de identificación personal (PII) ni ninguna otra información confidencial en los nombres de usuario de agente. Los nombres de usuario de agente están disponibles para otros servicios de AWS, incluido CloudWatch Logs. Los nombres de usuario de agente no están diseñados para usarse con información privada o confidencial.

La barra verde parpadeante en la parte superior de la página confirma que Amazon MQ está creando el agente de réplicas en la región de recuperación. También puede ver el rol de CRDR y el estado de RPO de sus agentes. Para desactivar las columnas Rol de CRDR y Estado de OPR, elija el icono de engranaje de la esquina superior derecha de la tabla **Agentes**. A continuación, en la página **Preferencias**, desactive Rol CRDR o Estado de RPO. 

## Paso 2: Crear una réplica de un agente existente
<a name="create-new-replica-broker"></a>

1. En la página Agentes de la consola de Amazon MQ, elija **Crear agente de réplicas**.

1. En la página **Elegir agente principal**, elija un agente existente para utilizarlo como agente principal de CRDR. A continuación, elija **Siguiente**.

1. En la página **Configurar agente de réplicas**, use el menú desplegable para elegir la región de réplicas.

1. En la sección **Usuario de la consola de ActiveMQ** para el agente de réplicas, proporcione un **Nombre de usuario** y una **Contraseña** para el usuario de la consola del agente de réplicas. Las siguientes restricciones se aplican a los nombres de usuario y las contraseñas de los agentes:
   +  El nombre de usuario solo puede contener caracteres alfanuméricos, guiones, puntos, guiones bajos y tildes (- . \$1 \$1). 
   +  Esta contraseña debe tener 12 caracteres como mínimo, debe contener al menos 4 caracteres únicos y no puede incluir comas, dos puntos ni signos de igual (,:=). 
**importante**  
No agregue información de identificación personal (PII) ni ninguna otra información confidencial en los nombres de usuario de agente. Los nombres de usuario de agente están disponibles para otros servicios de AWS, incluido CloudWatch Logs. Los nombres de usuario de agente no están diseñados para usarse con información privada o confidencial.

1. En la sección **Usuario de replicación de datos para puente de acceso entre agentes**, proporcione un **Nombre de usuario** y una **Contraseña** para el usuario que accederá tanto al agente principal como al agente de réplicas. Las siguientes restricciones se aplican a los nombres de usuario y las contraseñas de los agentes:
   +  El nombre de usuario solo puede contener caracteres alfanuméricos, guiones, puntos, guiones bajos y tildes (- . \$1 \$1). 
   +  Esta contraseña debe tener 12 caracteres como mínimo, debe contener al menos 4 caracteres únicos y no puede incluir comas, dos puntos ni signos de igual (,:=). 
**importante**  
No agregue información de identificación personal (PII) ni ninguna otra información confidencial en los nombres de usuario de agente. Los nombres de usuario de agente están disponibles para otros servicios de AWS, incluido CloudWatch Logs. Los nombres de usuario de agente no están diseñados para usarse con información privada o confidencial.

   Configure los ajustes adicionales. A continuación, elija **Siguiente**.

1. En la página **Revisar y crear**, revise los detalles del agente de réplicas. A continuación, elija **Crear agente de réplicas**.

1.  A continuación, reinicie el agente principal. Esto también reiniciará el agente de réplicas. Para obtener instrucciones sobre cómo reiniciar su agente, consulte [Reiniciar un agente de Amazon MQ](amazon-mq-rebooting-broker.md). 

Para obtener más información sobre la configuración de ajustes adicionales para su agente de ActiveMQ, consulte [Introducción: Creación y conexión con un agente de ActiveMQ](getting-started-activemq.md)

# Eliminación de un agente de replicación de datos entre regiones de Amazon MQ
<a name="delete-crdr-broker"></a>

 Para eliminar un agente de replicación de datos entre regiones (CRDR) principal o de réplicas, primero debe desvincular y, a continuación, reiniciar los agentes. En las instrucciones siguientes se muestra cómo puede desemparejar y reiniciar los agentes utilizando la consola de administración de AWS. 

1.  En la página **Agentes**, elija el agente CRDR que desee desemparejar y, a continuación, elija **Editar**. 

1.  En la página **Editar** del agente de la sección **Replicación de datos**, elija **Desemparejar agentes**. 

1.  Introduzca “confirm” en la ventana emergente para confirmar su elección. A continuación, elija **Desemparejar agentes**. 

1.  A continuación, reinicie el agente principal desemparejado. Esto también reiniciará el agente de réplicas. Para obtener instrucciones sobre cómo reiniciar su agente, consulte [Reiniciar un agente de Amazon MQ](amazon-mq-rebooting-broker.md). Una vez que se haya reiniciado el agente principal, ambos se desemparejarán y se pueden eliminar de forma individual. Para eliminar su agente, consulte [Eliminación de un agente de Amazon MQ](amazon-mq-deleting-broker.md). 

# Inicio de la transición o conmutación por error para ascender al agente de réplicas de Amazon MQ al rol de agente principal
<a name="initate-failover"></a>

 Puede iniciar una conmutación o una conmutación por error cuando desee ascender al agente de réplicas al rol de agente principal. Cuando asciende al agente de réplicas, el agente principal se degrada al rol de agente de réplicas. 

 Una **conmutación** prioriza la coherencia sobre la disponibilidad. Se garantiza que los agentes tengan un estado idéntico cuando finalice esta operación de conmutación por error. Con una conmutación, puede haber un período en el que ninguno de los agentes esté disponible para las conexiones de los clientes mientras se establece la coherencia entre agentes. Ambos agentes tendrán el mismo estado en el instante en que se ascienda la réplica. El éxito de la conversión depende del estado de ambas regiones y de que la red interregional funcione correctamente. 

 Una **conmutación por error** prioriza la disponibilidad sobre la coherencia. No se garantiza que los agentes tengan estados idénticos cuando finalice esta operación. Con una conmutación por error, se garantiza que el agente de réplicas esté disponible inmediatamente para atender el tráfico de clientes, sin esperar a que se sincronicen los datos de réplica ni a que el principal reciba la señal de apagado. La conmutación por error no depende del estado de la región principal original ni de la red interregional para funcionar. 

 En el siguiente diagrama se ilustra una conmutación en la que ninguno de los agentes acepta conexiones de clientes mientras se vacía la cola de replicación y se sincronizan los estados de los agentes. En este proceso, el cliente de la VPC del agente principal no puede producir más cambios de estado mientras se está produciendo una operación y el agente principal se está degradando a una réplica. Cuando la cola de replicación se vacía y los dos agentes alcanzan un estado idéntico, el cliente de la VPC del agente de réplicas no puede conectarse al agente de réplica hasta que se completa la operación de conmutación por error y el agente de réplicas se asciende a principal. 

![\[Diagram showing broker switchover process between us-east-1 and us-west-2 regions with replication traffic.\]](http://docs.aws.amazon.com/es_es/amazon-mq/latest/developer-guide/images/planned-failover-process.png)


 En el siguiente diagrama se ilustra el estado del agente una vez finalizado el proceso de conmutación. El agente de réplicas original se ascendió al rol de agente principal y está aceptando conexiones de clientes. El cliente puede producir y consumir datos del agente. 

![\[Diagram showing broker status after switchover, with primary broker in us-west-2 and replica in us-east-1.\]](http://docs.aws.amazon.com/es_es/amazon-mq/latest/developer-guide/images/finished-failover-process.png)


## Ascender el agente de réplicas mediante la consola
<a name="initate-failover-procedure"></a>

Para ascender el agente de réplicas mediante conmutación o conmutación por error, siga estos pasos en la consola de Amazon MQ.

**nota**  
 No puede iniciar la conmutación o la conmutación por error en un agente principal. 

1. Cambie a la región del agente de réplicas. En la tabla de agentes, seleccione el agente de réplicas existente que promocionará a principal. 

1.  En la **página de detalles del agente**, haga lo siguiente:

   1. Seleccione **Ascender réplica**.

   1. En la ventana emergente, elija *Conmutación* o *Conmutación por error*.

   1. Escriba “confirmar” en el cuadro de texto para confirmar su elección.

   1. Elija **Confirmar**.

 Tras iniciar la conmutación por error, el estado del agente cambia a *Conmutación por error en curso*. La barra de progreso azul de la parte superior de la página Agentes se vuelve verde cuando se completa la conmutación por error. 

**nota**  
 La configuración solo se replica en el momento en que se crea el agente de réplicas. Las actualizaciones posteriores no se replican. 

# Métricas de replicación de datos entre regiones en Amazon CloudWatch
<a name="crdr-metrics"></a>

 La característica de replicación de datos entre regiones de Amazon MQ para ActiveMQ ofrece métricas para mantener la fiabilidad, la disponibilidad y el rendimiento de sus agentes principales y de réplicas. Durante el proceso de replicación, un agente de réplicas de una región secundaria recibe datos replicados de forma asíncrona del agente primario de la región principal. Si el agente principal de la región principal falla, puede ascender a primario al agente de réplicas de la región secundaria iniciando una conmutación o conmutación por error. Para obtener instrucciones sobre la visualización de métricas en Amazon CloudWatch, consulte [Acceso a CloudWatch las métricas de Amazon MQ](amazon-mq-accessing-metrics.md). 

## Marcas temporales de CRDR
<a name="crdr-metrics-timestamps"></a>

 Las siguientes marcas temporales describen cómo se calculan las métricas encontradas en Amazon CloudWatch. Hay cinco marcas temporales en el proceso de replicación de datos: 
+ Tiempo de observación actual (TCO): el instante actual en el tiempo.
+ Hora de creación (TC): el instante en que un evento se creó en la cola de replicación por el agente principal. Disponible tanto en agentes principales como en réplicas.
+ Hora de entrega (TD): el instante en el que un evento se entregó correctamente al agente de réplicas. Solo disponible en agentes de réplicas.
+ Hora de procesamiento (TP): el instante en el que el agente de la réplica procesó correctamente un evento. Solo disponible en agentes de réplicas.
+ Hora de confirmación (TA): el instante en el que el agente principal ha reconocido correctamente un evento. Solo disponible en agentes principales. 

## Estimar el rendimiento de conmutación o conmutación por error con métricas CRDR CloudWatch
<a name="crdr-metrics-definitions"></a>

Amazon MQ habilita las métricas para el agente de forma predeterminada. Puede ver las métricas del agente accediendo a la consola de Amazon CloudWatch o mediante la API de CloudWatch. Las siguientes métricas son útiles para comprender el rendimiento de replicación y conmutación por error de sus agentes de CRDR:


| Métrica de CloudWatch de Amazon MQ | Motivo del uso de CRDR | 
| --- | --- | 
| TotalReplicationLag | El tiempo estimado entre TA y TC del último evento no reconocido en el agente principal. | 
| ReplicationLag | El tiempo estimado entre TP y TC del último evento no reconocido en el agente de réplicas. | 
| PrimaryWaitTime | El tiempo estimado entre TCO y TC del último evento procesado en el agente principal.  | 
| ReplicaWaitTime | El tiempo estimado entre TCO y TP del último evento procesado en el agente de réplicas. | 
| QueueSize | El número total de eventos no confirmados en la cola de replicación en el agente principal. | 

 `TotalReplicationLag` y `ReplicationLag` describen la replicación retardada entre los agentes principales y de réplicas. Las dos métricas también se pueden utilizar para estimar el tiempo que transcurrirá hasta que se complete la operación de conmutación o de conmutación por error en curso. 

 `PrimaryWaitTime` y `ReplicaWaitTime` pueden utilizarse para identificar cualquier problema en curso con el proceso de replicación. Si el valor de la métrica crece constantemente, esto puede indicar que el proceso de replicación está degradado o en pausa. La lentitud de la replicación puede deberse a problemas como la partición de la red, los arranques del agente y la larga recuperación.