Delen via

Service Bus Explorer gebruiken om gegevensbewerkingen uit te voeren op Service Bus

Met Azure Service Bus kunnen clienttoepassingen voor afzenders en ontvangers hun bedrijfslogica loskoppelen met behulp van vertrouwde punt-naar-punt -semantiek (wachtrij) en publiceren-abonneren (onderwerp-abonnement).

Notitie

In dit artikel wordt de functionaliteit van de Azure Service Bus Explorer belicht die deel uitmaakt van de Azure portal.

De open source Service Bus Explorer van de community is een zelfstandige toepassing en verschilt van deze toepassing.

Bewerkingen die worden uitgevoerd op een Azure Service Bus-naamruimte zijn van twee soorten.

  • Beheerbewerkingen : Service Bus-naamruimte, wachtrijen, onderwerpen en abonnementen maken, bijwerken, verwijderen.
  • Gegevensbewerkingen : berichten verzenden naar en ontvangen van wachtrijen, onderwerpen en abonnementen.

Belangrijk

  • Service Bus Explorer biedt geen ondersteuning voor beheerbewerkingen en -sessies.
  • We raden af om de Service Bus Explorer te gebruiken voor grotere berichten, omdat dit kan leiden tot time-outs, afhankelijk van de berichtgrootte, de netwerklatentie tussen de client en de Service Bus-service, enzovoort. In plaats daarvan raden we u aan uw eigen client te gebruiken om met grotere berichten te werken, waar u uw eigen time-outwaarden kunt opgeven.
  • Als uw Service Bus-naamruimte alleen toegankelijk is via een privé-eindpunt, moet u uw webbrowser uitvoeren op een host in het virtuele netwerk met het privé-eindpunt en er ook voor zorgen dat er geen netwerkbeveiligingsgateways (NSG's) zijn.
  • Als een gebruiker alleen toegang heeft tot entiteiten en niet de naamruimte, werkt Service Bus Explorer mogelijk niet zoals verwacht in scenario's met betrekking tot migratie naar de Premium-laag of herstel na noodgevallen van metagegevens.

Vereisten

Als u het hulpprogramma Service Bus Explorer wilt gebruiken, moet u de volgende taken uitvoeren:

Service Bus Explorer gebruiken

Als u Service Bus Explorer wilt gebruiken, gaat u naar de Service Bus-naamruimte waarop u gegevensbewerkingen wilt uitvoeren.

  1. Als u bewerkingen wilt uitvoeren voor een wachtrij, selecteert u Wachtrijen in het navigatiemenu. Als u bewerkingen wilt uitvoeren op een onderwerp (en de bijbehorende abonnementen), selecteert u Onderwerpen.

    Schermopname van navigatie aan de linkerkant, waar de entiteit kan worden geselecteerd.

  2. Nadat u Wachtrijen of onderwerpen hebt geselecteerd, selecteert u de specifieke wachtrij of het specifieke onderwerp.

    Schermopname van de pagina Wachtrijen met een specifieke wachtrij geselecteerd.

  3. Selecteer De Service Bus Explorer in het linkernavigatiemenu

    Schermopname van de wachtrijpagina waar Service Bus Explorer kan worden geselecteerd.

    Notitie

    Wanneer u een abonnement bekijkt of ontvangt, selecteert u eerst het specifieke abonnement in de vervolgkeuzelijstkiezer. Schermopname van vervolgkeuzelijst voor onderwerpabonnementen.

    Notitie

    Wanneer u naar Service Bus Explorer navigeert voor een entiteit in een naamruimte waarvoor de openbare toegang is uitgeschakeld, ziet u het volgende bericht, zelfs als u deze opent vanaf een virtuele machine die zich in hetzelfde virtuele netwerk bevindt als het privé-eindpunt. Deze kunt u negeren.

    "De naamruimte heeft openbare netwerktoegang uitgeschakeld. Gegevensbewerkingen zoals Peek, Send of Receive op basis van deze Service Bus-entiteit werken pas als u overschakelt naar alle netwerken of uw client-IP toevoegt aan de toegestane lijst in geselecteerde netwerken.

Een bericht bekijken

Met de peek-functionaliteit kunt u de Service Bus Explorer gebruiken om de bovenste 100 berichten in de wachtrij, het abonnement, of in de wachtrij met dode letters weer te geven.

  1. Als u berichten wilt bekijken, selecteert u de weergavemodus in de vervolgkeuzelijst Service Bus Explorer.

    Schermopname van een vervolgkeuzelijst met Peek Mode geselecteerd.

  2. Controleer de statistieken om te zien of er Active Messages of Dead-lettered Messages zijn om te bekijken en selecteer Queue / Subscription of DeadLetter-subqueue.

    Schermopname van de tabbladen voor de wachtrij en de dead-letter subqueue met weergegeven berichtmetriek.

  3. Selecteer de knop Korte weergave vanaf het startscherm .

    Schermopname die de knop 'Voorbeeld vanaf startknop' aangeeft.

  4. Zodra de weergavebewerking is voltooid, worden maximaal 100 berichten weergegeven in het raster, zoals wordt weergegeven in de volgende afbeelding. Als u de details van een bepaald bericht wilt weergeven, selecteert u het in het raster. U kunt ervoor kiezen om de hoofdtekst of de berichteigenschappen weer te geven.

    Schermopname met een overzicht van gekeken berichten en inhoud van de berichttekst die wordt weergegeven voor gekeken berichten.

    Ga naar het tabblad Berichteigenschappen in het onderste deelvenster om de metagegevens weer te geven.

    Schermopname met een overzicht van gekeken berichten en berichteigenschappen die worden weergegeven voor gekeken berichten.

    Notitie

    Omdat inkijk geen destructieve bewerking is, wordt het bericht niet uit de entiteit verwijderd.

    Notitie

    Om prestatieredenen wordt de berichttekst niet standaard opgehaald bij het bekijken van berichten uit een wachtrij of abonnement met de maximale berichtgrootte van meer dan 1 MB. In plaats daarvan kunt u de hoofdtekst van het bericht voor een specifiek bericht laden door te klikken op de knop Berichttekst laden. Als de hoofdtekst van het bericht meer dan 1 MB is, wordt deze niet afgekapt voordat deze wordt weergegeven. Schermopname met een overzicht van gekeken berichten en knop om de weergegeven berichttekst te laden.

Een bericht met geavanceerde opties bekijken

Met de korte weergave met opties kunt u de Service Bus Explorer gebruiken om de belangrijkste berichten in een wachtrij, abonnement of wachtrij met dode letters weer te geven, het aantal berichten op te geven dat u wilt bekijken en het volgnummer om de korte weergavebewerking te starten.

  1. Als u berichten met geavanceerde opties wilt bekijken, selecteert u De weergavemodus in de vervolgkeuzelijst Service Bus Explorer.

    Schermopname van de vervolgkeuzelijst met de kijkmodus geselecteerd voor een korte blik met geavanceerde opties.

  2. Controleer de statistieken om te zien of er Active Messages of Dead-lettered Messages zijn om te bekijken en selecteer Queue / Subscription of DeadLetter-subqueue.

    Schermopname van wachtrijen en dode-letter subwachtrij-tabbladen met berichtmetrieken die worden weergegeven voor een weergave met geavanceerde opties.

  3. Selecteer de knop Korte weergave met opties . Geef het aantal berichten op dat u wilt bekijken, het startvolgnummer waaruit u wilt gaan kijken, en selecteer de Knop Peek.

    Schermopname die de knop Weergeven met opties aangeeft en een pagina waar de opties kunnen worden ingesteld.

  4. Zodra de kijkoperatie is voltooid, worden de berichten weergegeven in het raster zoals te zien is in de volgende afbeelding. Als u de details van een bepaald bericht wilt weergeven, selecteert u het in het raster. U kunt ervoor kiezen om de hoofdtekst of de berichteigenschappen weer te geven.

    Schermopname met een overzicht van bekeken berichten en de inhoud van de berichttekst die wordt weergegeven bij een peek-weergave met geavanceerde opties.

    Ga naar het tabblad Berichteigenschappen in het onderste deelvenster om de metagegevens weer te geven.

    Schermopname met een overzicht van voorvertonen berichten en berichteigenschappen getoond voor voorvertonen met geavanceerde opties.

    Notitie

    Omdat een 'peek' geen destructieve handeling is, wordt het bericht niet uit de wachtrij verwijderd.

Een bericht ontvangen

De ontvangstfunctie in Service Bus Explorer staat het ontvangen van berichten uit een wachtrij of abonnement toe.

  1. Als u berichten wilt ontvangen, selecteert u De ontvangstmodus in de vervolgkeuzelijst Service Bus Explorer.

    Schermopname van vervolgkeuzelijst met Ontvangstmodus geselecteerd.

  2. Controleer de metrische gegevens om te zien of er actieve berichten of onbestelbare berichten moeten worden ontvangen en selecteer Wachtrij/Abonnement of DeadLetter.

    Schermopname van tabbladen wachtrij- en wachtrijen in de wachtrij, met metrische berichtgegevens die worden weergegeven voor de ontvangstmodus.

  3. Selecteer de knop Berichten ontvangen en geef de ontvangstmodus, het aantal te ontvangen berichten en de maximale tijd om te wachten op een bericht en selecteer Ontvangen.

    Schermopname die de knop Ontvangen aangeeft en een pagina waar de opties kunnen worden ingesteld.

    Belangrijk

    De ReceiveAndDelete-modus is een destructieve ontvangst, dat wil zeggen, het bericht wordt verwijderd uit de wachtrij wanneer het wordt weergegeven door het hulpprogramma Service Bus Explorer.

    Als u door berichten wilt bladeren zonder ze uit de wachtrij te verwijderen, kunt u de functie Peek gebruiken of de modus PeekLock-ontvangst gebruiken.

  4. Zodra de ontvangstbewerking is voltooid, worden de berichten weergegeven in het raster, zoals weergegeven in de volgende afbeelding. Als u de details van een bepaald bericht wilt weergeven, selecteert u het in het raster.

    Schermopname met een overzicht van ontvangen berichten en berichttekstinhoud weergegeven.

    Schermopname met een overzicht van ontvangen berichten en berichteigenschappen weergegeven.

    Notitie

    Om prestatieredenen wordt bij het ontvangen van berichten uit een wachtrij of abonnement met de maximale berichtgrootte van meer dan 1 MB slechts één bericht tegelijk ontvangen. Als de hoofdtekst van het bericht meer dan 1 MB is, wordt deze afgekapt voordat deze wordt weergegeven.

Nadat een bericht is ontvangen in de PeekLock-modus , zijn er verschillende acties die u erop kunt uitvoeren.

Notitie

U kunt deze acties alleen uitvoeren zolang u een vergrendeling op het bericht hebt.

Een bericht voltooien

  1. Selecteer in het raster de ontvangen berichten die u wilt voltooien.

  2. Druk op de knop Voltooien.

    Schermopname die de knop Voltooien aangeeft.

    Belangrijk

    Het voltooien van een bericht is een destructieve ontvangst, dat wil zeggen, het bericht wordt verwijderd uit de wachtrij wanneer Voltooid is geselecteerd in het hulpprogramma Service Bus Explorer.

Een bericht uitstellen

  1. Selecteer in het raster een of meer ontvangen berichten die u wilt uitstellen.

  2. Selecteer de knop Uitstellen.

    Schermopname die de knop Uitstellen aangeeft.

Vergrendeling annuleren

  1. Selecteer in het raster een of meer ontvangen berichten waarvoor u de vergrendeling wilt afbreken.

  2. Selecteer de Vergrendeling opgeven knop.

    Schermopname die de knop Vergrendeling annuleren aangeeft.

Nadat de vergrendeling is verlaten, is het bericht weer beschikbaar voor ontvangstbewerkingen.

Onbestelbare post

  1. Selecteer in het raster een of meer ontvangen berichten die u wilt markeren als dode letter.

  2. Selecteer de Dead-letter knop.

    Schermopname met aanduiding van de Dead-letter-knop.

Nadat een bericht naar de dode-letterwachtrij is verplaatst, is het beschikbaar in de subwachtrij Dead-letter.

Berichten verwijderen

Als u berichten wilt leegmaken, selecteert u de knop Berichten opschonen van Service Bus Explorer.

Schermopname die de knop berichten opschonen aangeeft.

Zodra u 'leegmaken' invoert om te bevestigen dat de bewerking wordt uitgevoerd, worden berichten verwijderd uit de respectieve Service Bus-entiteit.

Een bericht verzenden naar een wachtrij of onderwerp

Als u een bericht naar een wachtrij of een onderwerp wilt verzenden, selecteert u de knop Berichten verzenden van Service Bus Explorer.

  1. Selecteer het inhoudstype als tekst/tekst zonder opmaak, toepassing/xml of toepassing/Json.

  2. Voor hoofdtekst van het bericht voegt u de inhoud toe. Zorg ervoor dat deze overeenkomt met de inhoudstypeset die u eerder hebt ingesteld.

  3. Stel de Broker-eigenschappen in (optioneel). Deze eigenschappen omvatten Correlation ID, bericht-id, ReplyTo, label/onderwerp, Time to Live (TTL) en geplande enqueuetijd (voor geplande berichten).

  4. Stel de aangepaste eigenschappen in (optioneel). Deze eigenschappen kunnen alle gebruikerseigenschappen zijn ingesteld op basis van een woordenlijstsleutel.

  5. Schakel Verzenden herhalen in om hetzelfde bericht meerdere keren te verzenden. Als er geen bericht-id is ingesteld, wordt deze automatisch gevuld met opeenvolgende waarden.

  6. Zodra het bericht is samengesteld, selecteert u de knop Verzenden .

    Schermopname van de ervaring voor het opstellen van berichten.

  7. Wanneer de verzendbewerking is voltooid, vindt een van de volgende wijzigingen plaats:

    • Als u naar een wachtrij verzendt, worden de metrische gegevens van Active Messages verhoogd.
    • Als u naar een topic verzendt, wordt de metriekenteller van Active Messages verhoogd bij de abonnementen waar het bericht naartoe is gerouteerd.

Een bericht opnieuw verzenden

Nadat u een bericht hebt gekeken of ontvangen, kunt u het opnieuw verzenden, waardoor een kopie van het bericht naar dezelfde entiteit wordt verzonden, terwijl we de inhoud en eigenschappen van het bericht kunnen bijwerken. Het origineel blijft behouden en wordt niet verwijderd, zelfs niet wanneer het opnieuw wordt verzonden uit de wachtrij voor deadletters.

  1. Selecteer in het raster een of meer berichten die u opnieuw wilt verzenden.

  2. Selecteer de knop Geselecteerde berichten opnieuw verzenden.

    Schermopname die de knop Geselecteerde berichten opnieuw verzenden aangeeft.

  3. Selecteer desgewenst een bericht waarvoor u de details wilt bijwerken en breng de gewenste wijzigingen aan.

  4. Selecteer de knop Verzenden om de berichten naar de entiteit te verzenden.

    Schermopname van de ervaring voor het opnieuw verzenden van berichten.

    Notitie

    • Met de bewerking opnieuw verzenden wordt een kopie van het oorspronkelijke bericht verzonden. Het oorspronkelijke bericht dat u opnieuw verzendt, wordt niet verwijderd.
    • Als u een bericht opnieuw verzendt in een dead-letter queue van een abonnement, wordt er een kopie van het bericht naar het topic verzonden. Daarom ontvangen alle abonnementen een kopie van het bericht.

Verificatietype wisselen

Wanneer u met Service Bus Explorer werkt, is het mogelijk om toegangssleutel of Microsoft Entra ID-verificatie te gebruiken.

  1. Selecteer de knop Instellingen .

    Schermopname die de knop Instellingen in Service Bus Explorer aangeeft.

  2. Kies de gewenste verificatiemethode en selecteer de knop Opslaan .

    Schermopname van de knop Instellingen en een pagina met de verschillende verificatietypen.

Volgende stappen