Uso de Service Bus Explorer para ejecutar operaciones de datos en Service Bus

Azure Service Bus permite que las aplicaciones cliente del remitente y del receptor desacoplen su lógica de empresa a través de la conocida semántica de punto a punto (cola) y publicación-suscripción (tema-suscripción).

Puede ejecutar dos tipos de operaciones en un espacio de nombres de Azure Service Bus.

• Operaciones de administración: creación, actualización y eliminación del espacio de nombres de Service Bus, colas, temas y suscripciones.
• Operaciones de datos: envío y recepción de mensajes de colas, temas y suscripciones.

Requisitos previos

Para usar la herramienta Service Bus Explorer, complete las siguientes tareas:

• Crear un espacio de nombres de Azure Service Bus

• Cree una cola para enviar y recibir mensajes o un tema con una suscripción para probar la funcionalidad. Para obtener información sobre cómo crear colas, temas y suscripciones, vea los artículos siguientes:

  • Inicio rápido: Creación de colas
  • Inicio rápido: Creación de temas

  Nota

  Para ejecutar operaciones de envío o recepción (incluida la inspección y purga) en el espacio de nombres o entidades, debe pertenecer a uno de estos roles.

  • Propietario de datos de Service Bus: permite operaciones de envío y recepción.
  • Remitente de datos de Service Bus: permite operaciones de envío.
  • Receptor de datos de Service Bus: permite operaciones de recepción.

Uso de Service Bus Explorer

Para usar service Bus Explorer, vaya al espacio de nombres de Service Bus donde desea realizar operaciones de datos.

1. Si desea ejecutar operaciones en una cola, seleccione Colas en el menú de navegación. Si desea ejecutar operaciones en un tema (y sus suscripciones relacionadas), seleccione Temas.

   

2. Después de elegir Colas o Temas, seleccione la cola o el tema específico.

   

3. Seleccione el Explorador de Service Bus en el menú de navegación izquierdo.

   

   Nota

   Al examinar o recibir de una suscripción, seleccione primero la Suscripción específica en el selector de lista desplegable.

   Nota

   Al navegar a Service Bus Explorer para una entidad en un espacio de nombres que tenga deshabilitado el acceso público, verá el siguiente mensaje incluso a la hora de acceder a ella desde una máquina virtual que se encuentra en la misma red virtual que el punto de conexión privado. Puedes ignorarlo.

   El espacio de nombres tiene el acceso a la red pública deshabilitado. Las operaciones de datos como Inspeccionar, Enviar o Recibir en esta entidad de Service Bus no funcionan hasta que cambie a todas las redes o permita que aparezca en su IP de cliente en las redes seleccionadas".

Consulta un mensaje

Mediante la función de inspeccionar, puede usar Service Bus Explorer para ver los 100 mensajes más importantes de una cola, suscripción o cola de mensajes fallidos.

1. Seleccione Modo de exploración en la lista desplegable Explorador de Service Bus para ver los mensajes.

   

2. Compruebe en las métricas si hay mensajes activos o mensajes fallidos que inspeccionar. Seleccione Cola / Suscripción o la subcola Mensajes fallidos.

   

3. Seleccione el botón Vista previa desde el inicio.

   

4. Cuando finalice la operación de vista previa, aparecerán hasta 100 mensajes en la cuadrícula. Para ver los detalles de un mensaje determinado, selecciónelo en la cuadrícula. Puede elegir ver el cuerpo o las propiedades del mensaje.

   

   Cambie a la pestaña Propiedades del mensaje del panel inferior para ver los metadatos.

   

   Nota

   Dado que peek no es una operación destructiva, el mensaje no se elimina de la entidad.

   Nota

   Por motivos de rendimiento, al inspeccionar los mensajes de una cola o suscripción con un tamaño máximo de mensaje superior a 1 MB, el cuerpo del mensaje no se recupera de forma predeterminada. En su lugar, puede cargar el cuerpo del mensaje para un mensaje específico seleccionando el botón Cargar cuerpo del mensaje . Si el cuerpo del mensaje tiene más de 1 MB, no se truncará antes de mostrarse.

Ver un mensaje mediante opciones avanzadas

Al usar la función de inspeccionar con opciones, puede usar Service Bus Explorer para ver los mensajes más importantes de una cola, una suscripción o la cola de correo fallidos. Puede especificar el número de mensajes para visualizar y el número de secuencia para iniciar la operación de visualización.

1. Para previsualizar los mensajes mediante opciones avanzadas, seleccione Modo de previsualización en la lista desplegable del Explorador de Service Bus.

   

2. Compruebe en las métricas si hay mensajes activos o mensajes fallidos que inspeccionar. Seleccione Cola / Suscripción o la subcola Mensajes fallidos.

   

3. Seleccione el botón Ver con opciones. Escriba el número de mensajes que se van a inspeccionar y el número de secuencia a partir del cual se comienza a inspeccionar. Seleccione el botón Ver .

   

4. Cuando se completa la operación de inspección, los mensajes aparecen en la cuadrícula como se muestra en la siguiente imagen. Para ver los detalles de un mensaje determinado, selecciónelo en la cuadrícula. Puede elegir ver el cuerpo o las propiedades del mensaje.

   

   Cambie a la pestaña Propiedades del mensaje del panel inferior para ver los metadatos.

   

   Nota

   Como la inspección no es una operación destructiva, el mensaje no se quitará de la cola.

Recibir un mensaje

La función de recepción en el Service Bus Explorer permite recibir mensajes de una cola o suscripción.

1. Para recibir mensajes, seleccione Modo de recepción en la lista desplegable Service Bus Explorer.

   

2. Compruebe las métricas para ver si hay mensajes activos o mensajes fallidos que se van a recibir y seleccione Cola/Suscripción o Mensajes fallidos.

   

3. Seleccione el botón Recibir mensajes y especifique el modo De recepción, el número de mensajes que se van a recibir y el tiempo máximo para esperar un mensaje y seleccionar Recibir.

   

   Importante

   El modo ReceiveAndDelete es una recepción destructora; es decir, el mensaje se elimina de la cola cuando se muestra en la herramienta Service Bus Explorer.

   Para examinar los mensajes sin eliminarlos de la cola, considere la posibilidad de usar la función Ver, o de usar el modo de recepción PeekLock.

4. Una vez completada la operación de recepción, se mostrarán los mensajes en la cuadrícula, como se muestra en la siguiente imagen. Para ver los detalles de un mensaje determinado, selecciónelo en la cuadrícula.

   

   

   Nota

   Por motivos de rendimiento, al recibir mensajes de una cola o suscripción con su tamaño máximo de mensaje establecido en más de 1 MB, solo se recibe un mensaje a la vez. Si el cuerpo del mensaje es superior a 1 MB, la herramienta la trunca antes de mostrarla.

Una vez recibido un mensaje en modo PeekLock, hay varias acciones que podemos realizar en él.

Completar un mensaje

1. En la cuadrícula, seleccione los mensajes recibidos que desea completar.

2. Seleccione Completar.

   

   Importante

   Cuando se completa un mensaje, se realiza una recepción destructiva. El proceso quita el mensaje de la cola después de seleccionar Completar en la herramienta Explorador de Service Bus.

Aplazar un mensaje

1. En la cuadrícula, seleccione uno o varios mensajes recibidos que quiera aplazar.

2. Seleccione el botón Aplazar.

   

Cancelar bloqueo

1. En la cuadrícula, seleccione uno o varios mensajes recibidos para los que desea abandonar el bloqueo.

2. Seleccione Quitar bloqueo.

   

Una vez que se quita el bloqueo, el mensaje estará disponible para las operaciones de recepción de nuevo.

Cola de mensajes fallidos

1. En la cuadrícula, seleccione uno o varios mensajes recibidos que desee procesar como mensajes fallidos.

2. Seleccione el botón Mensajes fallidos.

   

Después de enviar un mensaje a la cola de mensajes fallidos, puede acceder a este a través de la subcola Mensajes fallidos.

Purgar mensajes

Para purgar mensajes, seleccione el botón Purgar mensajes en el explorador de Service Bus.

Cuando se le solicite, escriba "purga" para confirmar la operación. El proceso purga los mensajes de la entidad de Service Bus correspondiente.

Enviar un mensaje a una cola o tema

Para enviar un mensaje a una cola o un tema, seleccione el botón Enviar mensajes en el Explorador de Service Bus.

1. Seleccione el tipo de contenido que va a ser Text/Plain, Application/Xml o Application/Json.

2. En Cuerpo del mensaje, agregue el contenido del mensaje. Asegúrese de que coincide con el tipo de contenido que estableció anteriormente.

3. Establezca las propiedades del Bróker (opcional). Estas propiedades incluyen Id. de correlación, Id. de mensaje, ReplyTo, Label/Subject, Time to Live (TTL) y Scheduled Enqueue Time (for Scheduled Messages).

4. Establezca las Propiedades personalizadas (opcional). Estas propiedades pueden ser cualesquiera propiedades de usuario establecidas en una clave de diccionario.

5. Marque Repetir envío para enviar el mismo mensaje varias veces. Si no establece un identificador de mensaje, el proceso lo rellena automáticamente con valores secuenciales.

6. Cuando haya terminado de redactar el mensaje, seleccione Enviar.

   

7. Cuando la operación de envío se completa correctamente, se produce uno de los siguientes cambios:

   • Si va a enviar a una cola, el proceso incrementa el número de métricas de Mensajes activos.
   • Si va a enviar a un tema, el proceso incrementa el número de métricas de Mensajes activos en las suscripciones donde se redirigió el mensaje.

Reenvío de un mensaje

Después de examinar o recibir un mensaje, usted puede reenviarlo. El reenvío envía una copia del mensaje a la misma entidad, permitiendo actualizar su contenido y propiedades. El mensaje original permanece y no se elimina aunque se vuelva a enviar desde la cola de mensajes fallidos.

1. En la cuadrícula, seleccione uno o varios mensajes que desee volver a enviar.

2. Seleccione el botón Reenviar mensajes seleccionados.

   

3. De manera opcional, seleccione cualquier mensaje para el que desee actualizar sus detalles y realice los cambios deseados.

4. Seleccione el botón Enviar para enviar los mensajes a la entidad.

   

   Nota

   • La operación de reenvío envía una copia del mensaje original. No elimina el mensaje original que tú vuelves a enviar.
   • Si vuelve a enviar un mensaje en una cola de mensajes fallidos de una suscripción, se envía una copia del mensaje al tema. Por lo tanto, todas las suscripciones recibirán una copia del mensaje.

Exportar mensajes

Puede exportar mensajes en la cuadrícula a una hoja de cálculo de Excel seleccionando el botón Exportar mensajes de la barra de herramientas.

Mostrar u ocultar el cuerpo del mensaje

Al seleccionar un mensaje en la cuadrícula, el cuerpo del mensaje aparece en el panel inferior de forma predeterminada. Para ocultar el cuerpo del mensaje, seleccione Ocultar cuerpo del mensaje en la barra de herramientas. A continuación, seleccione Echar un vistazo o Recibir para cargar los mensajes sin su contenido. Esta opción es útil cuando hay mensajes grandes en la entidad. No activa la pestaña del cuerpo del mensaje si ya está abierta en el panel inferior.

Cambiar el tipo de autenticación

Al trabajar con Service Bus Explorer, puede usar la clave de acceso o la autenticación de ID de Microsoft Entra.

1. Seleccione Configuración.

   

2. Elija el método de autenticación que desea usar y seleccione Guardar.

   

Pasos siguientes

• Obtenga más información sobre las colas y los temas de Service Bus.
• Obtenga más información sobre cómo crear Colas de Service Bus mediante Azure Portal.
• Obtenga más información sobre la creación de temas y suscripciones de Service Bus a través de Azure Portal.