Dela via

Använda Service Bus Explorer för att köra dataåtgärder på Service Bus

Med Azure Service Bus kan avsändar- och mottagarklientprogram frikoppla sin affärslogik med hjälp av välbekant punkt-till-punkt-semantik (kö) och publiceringsprenumeration (ämnesprenumeration).

Kommentar

Den här artikeln belyser funktionerna i Azure Service Bus Explorer som ingår i Azure Portal.

Service Bus Explorer med öppen källkod som ägs av communityn är ett fristående program och skiljer sig från det här.

Åtgärder som körs på ett Azure Service Bus-namnområde är av två typer.

  • Hanteringsåtgärder – Skapa, uppdatera, ta bort Service Bus-namnrymd, köer, ämnen och prenumerationer.
  • Dataåtgärder – Skicka till och ta emot meddelanden från köer, ämnen och prenumerationer.

Viktigt!

  • Service Bus Explorer stöder inte hanteringsåtgärder och sessioner.
  • Vi rekommenderar att du inte använder Service Bus Explorer för större meddelanden, eftersom det kan leda till tidsgränser, beroende på meddelandestorleken, nätverksfördröjningen mellan klienten och Service Bus-tjänsten osv. I stället rekommenderar vi att du använder din egen klient för att arbeta med större meddelanden, där du kan ange dina egna tidsgränsvärden.
  • Om ditt Service Bus-namnområde bara kan nås via en privat slutpunkt måste du köra webbläsaren på en värd i det virtuella nätverket med den privata slutpunkten och även se till att det inte finns några nätverkssäkerhetsgatewayer på vägen.
  • Om en användare bara har åtkomst till entiteter och inte namnområdet kanske Service Bus Explorer inte fungerar som förväntat i scenarier som omfattar migrering till premiumnivån eller återställning av metadata.

Förutsättningar

Om du vill använda Service Bus Explorer-verktyget måste du utföra följande uppgifter:

Använda Service Bus Explorer

Om du vill använda Service Bus Explorer navigerar du till Service Bus-namnområdet där du vill utföra dataåtgärder.

  1. Om du vill köra åtgärder mot en kö väljer du Köer från navigeringsmenyn. Om du vill köra åtgärder mot ett ämne (och dess relaterade prenumerationer) väljer du Ämnen.

    Skärmbild av navigering på vänster sida, där entiteten kan väljas.

  2. När du har valt Köer eller Ämnen, väljer du specifikt den kö eller det ämne som du vill.

    Skärmbild av sidan Köer med en specifik kö markerad.

  3. Välj Service Bus Explorer på den vänstra navigeringsmenyn

    Skärmbild av kösidan där Service Bus Explorer kan väljas.

    Kommentar

    När du tittar på eller tar emot från en prenumeration väljer du först den specifika prenumerationen i rullgardinsmenyn. Skärmbild av listrutan för ämnesprenumerationer.

    Kommentar

    När du navigerar till Service Bus Explorer för en entitet i ett namnområde som har den offentliga åtkomsten inaktiverad visas följande meddelande även om du kommer åt det från en virtuell dator som finns i samma virtuella nätverk som den privata slutpunkten. Du kan ignorera det.

    "Namnområdet har inaktiverad åtkomst till offentligt nätverk. Dataåtgärder som Peek, Send eller Receive mot denna Service Bus-entit fungerar inte förrän du växlar till alla nätverk eller tillåterlistning av klient-IP i valda nätverk."

Granska ett meddelande

Med funktionen peek kan du använda Service Bus Explorer för att visa de 100 främsta meddelandena i en kö, prenumeration eller kö med obeställbara meddelanden.

  1. Om du vill granska meddelanden väljer du Visningsläge i listrutan Service Bus Explorer.

    Skärmbild av listrutan med Peek Mode markerat.

  2. Kontrollera metrikvärdena för att se om det finns aktiva meddelanden eller döda-brev-meddelanden att granska och välj antingen Kö/prenumeration eller DeadLetter-underkö.

    Skärmbild av flikar för kö och dead-letter subqueue där meddelandemått visas.

  3. Välj knappen Titta från start.

    Skärmbild som visar knappen Titta från början.

  4. När granskningsåtgärden är klar visas upp till 100 meddelanden i rutnätet enligt följande bild. Om du vill visa information om ett visst meddelande väljer du det från rutnätet. Du kan välja att visa brödtexten eller meddelandeegenskaperna.

    Skärmbild med översikt över kikade meddelanden och innehåll i meddelandetexten som visas för kikade meddelanden.

    Växla till fliken Meddelandeegenskaper i det nedre fönstret för att se metadata.

    Skärmbild med översikt över kikade meddelanden och meddelandeegenskaper som visas för kikade meddelanden.

    Kommentar

    Eftersom peek inte är en destruktiv åtgärd tas meddelandet inte bort från entiteten.

    Kommentar

    Av prestandaskäl hämtas inte meddelandetexten som standard när du tittar på meddelanden från en kö eller prenumeration som har sin maximala meddelandestorlek på över 1 MB. I stället kan du läsa in meddelandetexten för ett visst meddelande genom att klicka på knappen Läs in meddelandetext . Om meddelandetexten är över 1 MB trunkeras den inte innan den visas. Skärmbild med översikt över kikade meddelanden och knapp för att läsa in meddelandetexten som visas.

Granska ett meddelande med avancerade alternativ

Med funktionen granska med alternativ kan du använda Service Bus Explorer för att visa de viktigaste meddelandena i en kö, prenumeration eller kön med obeställbara meddelanden, ange antalet meddelanden som ska granskas och sekvensnumret för att starta granskningsåtgärden.

  1. Om du vill förhandsgranska meddelanden med avancerade alternativ väljer du Peek Mode i listrutan Service Bus Explorer.

    Skärmbild av listrutan med Peek Mode valt för titt med avancerade alternativ.

  2. Kontrollera metrikvärdena för att se om det finns aktiva meddelanden eller döda-brev-meddelanden att granska och välj antingen Kö/prenumeration eller DeadLetter-underkö.

    Skärmbild av kö och underköflikar för obeställbara meddelanden med meddelandemått som visas vid granskning med avancerade alternativ.

  3. Välj knappen Granska med alternativ . Ange det antal meddelanden som ska visas och sekvensnumret som du vill börja titta från och med och välj knappen Förhandsgranska.

    Skärmbild som anger knappen Granska med alternativ och en sida där alternativen kan anges.

  4. När granskningsåtgärden är klar visas meddelandena i rutnätet enligt följande bild. Om du vill visa information om ett visst meddelande väljer du det från rutnätet. Du kan välja att visa brödtexten eller meddelandeegenskaperna.

    Skärmbild med översikt över kikade meddelanden och innehåll i meddelandetexten som visas för en titt med avancerade alternativ.

    Växla till fliken Meddelandeegenskaper i det nedre fönstret för att se metadata.

    Skärmbild med översikt över förhandsgranskade meddelanden och meddelandeegenskaper som visas för förhandsgranska med avancerade alternativ.

    Kommentar

    Eftersom peek inte är en destruktiv åtgärd tas meddelandet inte bort från kön.

Ta emot ett meddelande

Funktionen ta emot i Service Bus Explorer tillåter att meddelanden tas emot från en kö eller prenumeration.

  1. Om du vill ta emot meddelanden väljer du Ta emot läge i listrutan Service Bus Explorer.

    Skärmbild av listrutan med mottagningsläget valt.

  2. Kontrollera metriken för att se om det finns aktiva meddelanden eller obeställbara meddelanden att ta emot och välj antingen Kö/Prenumeration eller Obeställbara Meddelanden.

    Skärmbild av underköflikar i kö och obeställbara bokstäver med meddelandemått som visas för mottagningsläge.

  3. Välj knappen Ta emot meddelanden och ange mottagningsläget, antalet meddelanden som ska ta emot och den maximala tiden att vänta på ett meddelande och välj Ta emot.

    Skärmbild som anger knappen Ta emot och en sida där alternativen kan anges.

    Viktigt!

    Läget ReceiveAndDelete är en destruktiv mottagning, dvs. meddelandet tas bort från kön när det visas i Service Bus Explorer-verktyget.

    Om du vill bläddra bland meddelanden utan att ta bort dem från kön kan du använda funktionen Peek eller använda PeekLock-mottagningsläget .

  4. När mottagningsåtgärden är klar visas meddelandena i rutnätet enligt följande bild. Om du vill visa information om ett visst meddelande väljer du det i rutnätet.

    Skärmbild med översikt över mottagna meddelanden och innehåll i meddelandetexten.

    Skärmbild med översikt över mottagna meddelanden och meddelandeegenskaper som visas.

    Kommentar

    Av prestandaskäl, när du tar emot meddelanden från en kö eller prenumeration som har sin maximala meddelandestorlek inställd på över 1 MB, tas endast ett meddelande emot i taget. Om meddelandetexten är över 1 MB trunkeras den innan den visas.

När ett meddelande har tagits emot i PeekLock-läge finns det olika åtgärder som du kan vidta för det.

Kommentar

Du kan bara vidta dessa åtgärder så länge du har ett lås på meddelandet.

Slutför ett meddelande

  1. I rutnätet väljer du de mottagna meddelanden som du vill slutföra.

  2. Välj knappen Slutför .

    Skärmbild som anger knappen Slutför.

    Viktigt!

    Att slutföra ett meddelande är ett destruktivt mottagande, dvs. meddelandet tas bort från kön när Slutfört har valts i Service Bus Explorer-verktyget.

Skjut upp ett meddelande

  1. I rutnätet väljer du ett eller flera mottagna meddelanden som du vill skjuta upp.

  2. Välj knappen Skjut upp .

    Skärmbild som anger knappen Skjut upp.

Överge lås

  1. I rutnätet väljer du ett eller flera mottagna meddelanden som du vill avbryta låset för.

  2. Välj knappen Avbryt lås .

    Skärmbild som anger knappen Avbryt lås.

När låset har avbrutits är meddelandet tillgängligt för mottagningsåtgärder igen.

Obeställbara bokstäver

  1. I rutnätet, markera ett eller flera mottagna meddelanden som du vill flytta till en dödbrevlåda.

  2. Välj knappen Död-brev.

    Skärmbild som visar knappen för odelbara meddelanden.

När ett meddelande har dödad brevlåda är det tillgängligt från underkön Dödad brevlåda.

Rensa meddelanden

Om du vill rensa meddelanden väljer du knappen Rensa meddelanden i Service Bus Explorer.

Skärmbild som anger knappen rensa meddelanden.

När du anger "rensning" för att bekräfta åtgärden rensas meddelanden från respektive Service Bus-entitet.

Skicka ett meddelande till en kö eller ett ämne

Om du vill skicka ett meddelande till en kö eller ett ämne väljer du knappen Skicka meddelanden i Service Bus Explorer.

  1. Välj innehållstyp som antingen Text/Oformaterad, Program/XML eller Program/Json.

  2. För Meddelandetext lägger du till meddelandeinnehållet. Kontrollera att den matchar innehållstypen som ställdes in tidigare.

  3. Ange egenskaper för Broker (valfritt). Dessa egenskaper omfattar korrelations-ID, meddelande-ID, ReplyTo, etikett/ämne, TTL (Time to Live) och schemalagd kötid (för schemalagda meddelanden).

  4. Ange anpassade egenskaper (valfritt). Dessa egenskaper kan vara alla användaregenskaper som anges mot en ordlistenyckel.

  5. Kontrollera Upprepa skicka för att skicka samma meddelande flera gånger. Om inget meddelande-ID har angetts fylls det automatiskt i med sekventiella värden.

  6. När meddelandet har skrivits väljer du knappen Skicka .

    Skärmbild som visar funktionen skapa meddelande.

  7. När sändningsåtgärden har slutförts sker någon av följande ändringar:

    • Om du skickar till en kö ökas mätetalet för aktiva meddelanden.
    • Om du skickar till ett ämne ökas räknaren för mått för aktiva meddelanden i de prenumerationer där meddelandet dirigerades till.

Skicka ett meddelande igen

När du har tittat på eller tagit emot ett meddelande kan du skicka det igen, vilket skickar en kopia av meddelandet till samma entitet, samtidigt som vi kan uppdatera dess innehåll och egenskaper. Originalet finns kvar och tas inte bort även när en ny borttagning kommer från deadletter-kön.

  1. I rutnätet väljer du ett eller flera meddelanden som du vill skicka igen.

  2. Välj knappen Skicka markerade meddelanden igen.

    Skärmbild som anger knappen Skicka om markerade meddelanden.

  3. Du kan också välja alla meddelanden som du vill uppdatera informationen för och göra önskade ändringar för.

  4. Välj knappen Skicka för att skicka meddelanden till entiteten.

    Skärmbild som visar funktionen skicka meddelanden igen.

    Kommentar

    • Åtgärden skickar en kopia av det ursprungliga meddelandet. Det tar inte bort det ursprungliga meddelandet som du skicka på nytt.
    • Om du skickar ett meddelande igen i en kö med obeställbara meddelanden för en prenumeration skickas en kopia av meddelandet till ämnet. Därför får alla prenumerationer en kopia av meddelandet.

Växla autentiseringstyp

När du arbetar med Service Bus Explorer är det möjligt att använda antingen åtkomstnyckel eller Microsoft Entra-ID-autentisering .

  1. Välj knappen Inställningar .

    Skärmbild som anger knappen Inställningar i Service Bus Explorer.

  2. Välj önskad autentiseringsmetod och välj knappen Spara .

    Skärmbild som anger knappen Inställningar och en sida som visar de olika autentiseringstyperna.

Nästa steg