IoT Platform:Gestión de grupos de consumidores

Funciones

Puede usar uno de los siguientes métodos para escuchar grupos de consumidores y obtener los mensajes reenviados:

• Configure AMQP server-side subscription: Use una suscripción del lado del servidor mediante Advanced Message Queuing Protocol (AMQP) para suscribirse a un tipo específico de mensajes enviados por todos los dispositivos de un producto. Los mensajes se reenvían a un grupo de consumidores determinado.

  Para más información sobre las diferencias entre las suscripciones del lado del servidor y el reenvío de datos, consulte Comparison of data forwarding solutions.

• Configure a data forwarding rule: Utilice la función de reenvío de datos para enviar mensajes desde un topic específico hacia un grupo de consumidores AMQP.

Notas de uso

Especifique un ID de grupo de consumidores para un cliente AMQP. Así, el cliente AMQP se conecta a IoT Platform y recibe mensajes. Para más información, consulte Connect an AMQP client.

Un grupo de consumidores admite hasta 64 clientes AMQP. Estos clientes comparten el ID del grupo de consumidores. Cuando un dispositivo envía un mensaje a IoT Platform, el servicio lo reenvía a un cliente aleatorio dentro del grupo.

Creación de un grupo de consumidores

1. Inicie sesión en la consola de IoT Platform.

2. En la página Overview, busque la instancia que desea gestionar y haga clic en su ID o nombre.

3. En el panel de navegación izquierdo, elija Server-side Subscription y haga clic en la pestaña Consumer Groups.

4. Haga clic en Create Consumer Group.

5. En el cuadro de diálogo Create Consumer Group, introduzca un nombre de grupo y haga clic en OK.

   El nombre del grupo de consumidores debe tener entre 4 y 30 caracteres. Puede contener letras, dígitos y guiones bajos (_). Cada carácter chino o japonés cuenta como dos caracteres.

Consulta y supervisión de grupos de consumidores

Consulte la tasa de consumo de mensajes y la cantidad de mensajes acumulados de un grupo de consumidores. Para supervisar el grupo, configure una regla de alerta en la consola de Cloud Monitor.

1. En la pestaña Consumer Groups, busque el grupo de consumidores que desea gestionar y haga clic en View en la columna Actions.

2. En la pestaña Consumer Group Status, consulte los valores de los parámetros Real-time Message Consumption Rate, Accumulated Message Consumption Rate, Accumulated Messages y Last Consumed At. También puede ver los clientes conectados.

   Si la cantidad de mensajes acumulados es mayor o igual a 1, haga clic en Clear a la derecha de Accumulated Messages para borrarlos.

   Nota

   Después de crear un grupo de consumidores, este acumula mensajes o no según si se ha habilitado previamente.

   • Si el grupo de consumidores nunca se ha habilitado, permanece en estado desconectado. Al enviarle mensajes, no se acumula ninguno.

   • Si el grupo de consumidores se habilitó y luego se deshabilitó, queda en estado desconectado. En este caso, los mensajes que le envíe sí se acumulan.

   La pestaña Consumer Group Status muestra las métricas Real-time Message Consumption Rate, Accumulated Message Consumption Rate, Accumulated Messages y Last Consumed At en su área de información básica. Debajo de estas métricas, la lista Online Clients incluye las columnas Client ID, Client IP/Port, Last Up Time, Per-Connection Real-time Consumption Rate y Per-Connection Accumulated Consumption Rate.

3. En la pestaña Consumer Group Status, haga clic en Alert Settings. En el panel Create Alert Rule, configure una regla de alerta para recibir notificaciones y supervisar la cantidad de mensajes acumulados junto con la tasa de consumo del grupo.

   Establezca el parámetro Product en IoT Platform-Server subscription. Configure los demás parámetros según sus necesidades empresariales. Para más información, consulte Configure alert rules.

4. En la página Consumer Group Details, haga clic en Consumption Logs. En la pestaña Consumption Logs, consulte los detalles de los registros de consumo.

Eliminación de un grupo de consumidores

Elimine un grupo de consumidores cuando lo requiera, excepto el grupo predeterminado. Una vez eliminado, todos los clientes del grupo dejan de recibir mensajes.

1. Desvincule la suscripción. Si el grupo de consumidores tiene una suscripción asociada, debe desvincularla antes de continuar. Omita este paso si el grupo no tiene suscripciones.

   1. En la pestaña Consumer Groups, busque el grupo de consumidores y haga clic en View en la columna Actions.

   2. En la pestaña Subscribed Products de la página Consumer Group Details, busque el producto que desea gestionar y haga clic en Unsubscribe en la columna Actions. En el mensaje que aparece, haga clic en OK.

      Nota

      Si una suscripción del lado del servidor está asociada a un único grupo de consumidores, la opción para cancelar la suscripción no estará disponible en la página Consumer Group Details. Modifique o elimine la suscripción desde la pestaña Subscriptions de la página Server-side Subscription.

2. En la pestaña Consumer Groups de la página Server-side Subscription, busque el grupo de consumidores que desea gestionar y haga clic en Delete en la columna Actions. En el mensaje que aparece, haga clic en OK.

Referencias

A continuación se presentan temas relacionados con la configuración de un ID de grupo de consumidores para un cliente AMQP y la recepción de mensajes:

• Connect an AMQP client

• Java SDK connection example

• Node.js SDK connection example

• Connect a client to IoT Platform by using the SDK for .NET

• Connect a client to IoT Platform by using the SDK for Python 2.7

• Example: Python 3 SDK connection

• PHP SDK connection example

• Go SDK connection example

Operaciones de API relacionadas