Compartir a través de


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 negocios con el uso de la conocida semántica de punto a punto (cola) y publicación-suscripción (tema-suscripción).

Nota

En este artículo se resalta la función de Azure Service Bus Explorer que forma parte de Azure Portal.

La herramienta Service Bus Explorer de código abierto propiedad de la comunidad es una aplicación independiente y es diferente de esta.

Las operaciones ejecutadas en un espacio de nombres de Azure Service Bus son de dos tipos.

  • Operaciones de administración: creación, actualización, eliminación de 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.

Importante

  • Service Bus Explorer no admite operaciones de administración y sesiones.
  • Aconsejamos no utilizar Service Bus Explorer para mensajes más grandes, ya que esto puede dar lugar a tiempos de espera, dependiendo del tamaño del mensaje, la latencia de la red entre el cliente y el servicio Service Bus, etc. En su lugar, le recomendamos que utilice su propio cliente para trabajar con mensajes más grandes, donde puede especificar sus propios valores de tiempo de espera.

Requisitos previos

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

Uso de Service Bus Explorer

Para usar Service Bus Explorer, vaya al espacio de nombres de Service Bus en el que quiera realizar las operaciones de datos.

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

    Captura de pantalla del panel de navegación izquierdo, donde se puede seleccionar la entidad.

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

    Captura de pantalla de la página Colas con una cola específica seleccionada.

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

    Captura de pantalla de la página de cola donde se puede seleccionar Service Bus Explorer.

    Nota

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

Consulta un mensaje

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

  1. Para ver los mensajes, seleccione el modo ver en el menú desplegable del Service Bus Explorer.

    Captura de pantalla de la lista desplegable con el modo Ver seleccionado.

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

    Captura de pantalla de las pestañas de la cola y de la subcola de mensajes fallidos en las que se muestran las métricas de mensaje.

  3. Seleccione el botón Ver el código sin salir desde inicio.

    Captura de pantalla que indica el botón Ver desde inicio.

  4. Una vez completada la operación de inspección, se mostrarán hasta 100 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. Puede elegir ver el cuerpo o las propiedades del mensaje.

    Captura de pantalla que muestra información general sobre los mensajes inspeccionados y el contenido del cuerpo del mensaje para los mensajes inspeccionados.

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

    Captura de pantalla que muestra información general sobre los mensajes inspeccionados y las propiedades de mensajes para los mensajes inspeccionados.

    Nota

    Dado que la inspección no es una operación destructiva, el mensaje no se quitará de la entidad.

    Nota

    Por razones de rendimiento, cuando se consultan mensajes de una cola o suscripción cuyo tamaño máximo de mensaje es superior a 1 MB, el cuerpo del mensaje no se recupera de manera predeterminada. En cambio, puede cargar el cuerpo del mensaje para un mensaje específico al hacer clic en el botón Cargar cuerpo del mensaje. Si el cuerpo del mensaje tiene más de 1 MB, se truncará antes de mostrarse. Captura de pantalla que muestra información general de mensajes inspeccionados y el botón para cargar el cuerpo del mensaje.

Ver un mensaje con opciones avanzadas

La funcionalidad de ver con opciones permite usar el Service Bus Explorer para ver los mensajes más importantes de una cola, suscripción o la cola de fallidos, que especifica el número de mensajes a ver, y el número de secuencia para iniciar la operación de inspección.

  1. Para ver los mensajes con opciones avanzadas, seleccione el modo ver el código sin salir en el menú desplegable del Service Bus Explorer.

    Captura de pantalla de la lista desplegable con el modo Ver seleccionado para ver con opciones avanzadas.

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

    Captura de pantalla de las pestañas de cola y de subcola de mensajes fallidos que muestran las métricas de mensaje para ver con opciones avanzadas.

  3. Seleccione el botón Ver con opciones. Proporcione el número de mensajes que se van a ver y el número de secuencia desde el que empezar a examinar y seleccione el botón Ver.

    Captura de pantalla que indica el botón Ver con opciones y una página donde se pueden establecer las opciones.

  4. Una vez completada la operación de inspecció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. Puede elegir ver el cuerpo o las propiedades del mensaje.

    Captura de pantalla que muestra información general sobre los mensajes inspeccionados y el contenido del cuerpo del mensaje para ver con las opciones avanzadas.

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

    Captura de pantalla que muestra información general sobre los mensajes inspeccionados y las propiedades del mensaje para ver con las opciones avanzadas.

    Nota

    Dado que 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.

    Captura de pantalla de la lista desplegable con el modo Recibir seleccionado.

  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.

    Captura de pantalla de las pestañas de la cola y de la subcola de mensajes fallidos en las que se muestran las métricas de mensaje para el modo de recepción.

  3. Seleccione el botón Recibir mensajes y especifique el modo de recepción, el número de mensajes a recibir y el tiempo máximo de espera de un mensaje y seleccione Recibir.

    Captura de pantalla que indica el botón Recibir y una página donde se pueden establecer las opciones.

    Importante

    Tenga en cuenta que 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.

    Captura de pantalla que muestra información general sobre los mensajes recibidos y el contenido del cuerpo del mensaje.

    Captura de pantalla que muestra información general sobre los mensajes recibidos y las propiedades del mensaje.

    Nota

    Por motivos de rendimiento, al recibir mensajes de una cola o suscripción que tenga el tamaño máximo de mensaje establecido en más de 1 MB, solo se recibirá un mensaje a la vez. Si el cuerpo del mensaje tiene más de 1 MB, se truncará antes de mostrarse.

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

Nota:

Solo podemos realizar estas acciones siempre que tengamos un bloqueo en el mensaje.

Completar un mensaje

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

  2. Seleccione Completar.

    Captura de pantalla que indica el botón Completar.

    Importante

    Tenga en cuenta que completar un mensaje es una recepción destructiva, es decir, el mensaje se quita de la cola cuando se ha seleccionado Completar en la herramienta Service Bus Explorer.

Aplazar un mensaje

  1. En la cuadrícula, seleccione los mensajes recibidos que queremos Aplazar.

  2. Seleccione Aplazar.

    Captura de pantalla que indica el botón Aplazar.

Cancelar bloqueo

  1. En la cuadrícula, seleccione los mensajes recibidos para los que queremos quitar el bloqueo.

  2. Seleccione Quitar bloqueo.

    Captura de pantalla que indica el botón de abandono de bloqueo.

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

Mensajes con problemas de entrega

  1. En la cuadrícula, seleccione los mensajes recibidos que queremos que no se escriban.

  2. Seleccione el botón Mensajes fallidos.

    Captura de pantalla que indica el botón Mensajes fallidos.

Una vez que se haya escrito un mensaje fallido, estará disponible en la sub cola de mensajes fallidos.

Purgar mensajes

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

Captura de pantalla que indica el botón purgar mensajes.

Una vez que escriba "purga" para confirmar en la operación, los mensajes se purgarán de la entidad de Service Bus correspondiente.

Enviar un mensaje a una cola o tema

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

  1. Seleccione el Tipo de contenido en Texto/normal, Aplicación/Xml o Aplicación/Json.

  2. En Cuerpo del mensaje, agregue el contenido del mensaje. Asegúrese de que coincida con el tipo de contenido establecido anteriormente.

  3. Establezca las propiedades del agente (opcional), que incluyen el Id. de correlación, el Id. del mensaje, Responder a, Etiqueta/Asunto, Tiempo de vida (TTL) y Tiempo de espera programado (para los mensajes programados).

  4. Establezca las propiedades personalizadas (opcional), estas pueden ser cualquier propiedad del usuario establecida contra una clave de diccionario.

  5. Marque Repetir envío para enviar el mismo mensaje varias veces. Si no se estableció ningún id. de mensaje, se rellena automáticamente con valores secuenciales.

  6. Una vez que se haya redactado el mensaje, seleccione Enviar.

    Captura de pantalla que muestra la experiencia de redacción del mensaje.

  7. Cuando la operación de envío se completa correctamente, sucederá una de las siguientes cosas:

    • Si se envía a una cola, el contador de métricas de Mensajes activos se incrementará.
    • Si se envía a un tema, el contador de métricas de los Mensajes activos se incrementará en las suscripciones a las que se dirigió el mensaje.

Reenvío de un mensaje

Después de ver o recibir un mensaje, podemos reenviarlo, lo que enviará una copia del mensaje a la misma entidad, mientras nos permite actualizar su contenido y propiedades. El original permanecerá y no se eliminará ni siquiera cuando el reenviado procede de la cola de mensajes fallidos.

  1. En la cuadrícula, seleccionamos el o los mensajes que queremos reenviar.

  2. Seleccione el botón Reenviar mensajes seleccionados.

    Captura de pantalla que indica el botón Volver a enviar mensajes seleccionados.

  3. Opcionalmente, seleccione cualquier mensaje para el que queramos actualizar sus detalles y realice los cambios deseados.

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

    Captura de pantalla que muestra la experiencia de reenvío de mensajes.

    Nota

    • La operación de reenvío envía una copia del mensaje original. No quita el mensaje original que se vuelve 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.

Cambiar el tipo de autenticación

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

  1. Seleccione Configuración.

    Captura de pantalla que indica el botón Configuración en Service Bus Explorer.

  2. Seleccione el método de autenticación deseado y seleccione el botón Guardar.

    Captura de pantalla que indica el botón Configuración y una página que muestra los distintos tipos de autenticación.

Pasos siguientes