Recuperare i contatori di messaggi

Questo articolo illustra diversi modi per ottenere i conteggi dei messaggi per una coda o una sottoscrizione. Il conteggio dei messaggi attivi è utile per stabilire se una coda crea un backlog che richiede più risorse per essere elaborato rispetto a quelle attualmente distribuite.

Contatore	Descrizione
ActiveMessageCount	Numero di messaggi nella coda o nella sottoscrizione che si trovano nello stato attivo e pronti per il recapito.
ScheduledMessageCount	Numero di messaggi nello stato pianificato.
DeadLetterMessageCount	Numero di messaggi nella coda dei messaggi non recapitabili.
TransferMessageCount	Numero di messaggi in attesa di trasferimento in un'altra coda o argomento.
TransferDeadLetterMessageCount	Numero di messaggi che non sono stati trasferiti in un'altra coda o argomento e che sono stati spostati nella coda dei messaggi non recapitabili di trasferimento.

Se un'applicazione vuole ridimensionare le risorse in base alla lunghezza della coda, deve farlo in maniera limitata. L'acquisizione dei contatori di messaggi è un'operazione impegnativa all'interno del broker messaggi e, se viene eseguita frequentemente, influisce direttamente e negativamente sulle prestazioni dell'entità.

Nota

I messaggi inviati a un argomento bus di servizio vengono inoltrati alle sottoscrizioni per tale argomento. Pertanto, il conteggio dei messaggi attivi sull'argomento stesso è 0, in quanto tali messaggi sono stati inoltrati correttamente alla sottoscrizione. Ottenere il numero di messaggi nella sottoscrizione e verificare che sia maggiore di 0. Anche se vengono visualizzati messaggi nella sottoscrizione, vengono effettivamente archiviati in una risorsa di archiviazione di proprietà dell'argomento. Se si esaminano le sottoscrizioni, le sottoscrizioni avranno un numero di messaggi diverso da zero (che sommano fino a 323 MB di spazio per l'intera entità).

Con il portale di Azure

Passare allo spazio dei nomi e selezionare la coda. Nella pagina Panoramica della coda sono visualizzati i contatori dei messaggi.

Passare allo spazio dei nomi, selezionare l'argomento e quindi selezionare la sottoscrizione per l'argomento. Nella pagina Panoramica della coda sono visualizzati i contatori dei messaggi.

Utilizzare l'interfaccia della riga di comando di Azure

Usare il az servicebus queue show comando per ottenere i dettagli del conteggio dei messaggi per una coda, come illustrato nell'esempio seguente.

az servicebus queue show --resource-group myresourcegroup \
    --namespace-name mynamespace \
    --name myqueue \
    --query countDetails

Ecco un output di esempio:

ActiveMessageCount    DeadLetterMessageCount    ScheduledMessageCount    TransferMessageCount    TransferDeadLetterMessageCount
--------------------  ------------------------  -----------------------  ----------------------  --------------------------------
0                     0                         0                        0                       0

Usare il az servicebus topic subscription show comando per ottenere i dettagli del conteggio dei messaggi per una sottoscrizione, come illustrato nell'esempio seguente.

az servicebus topic subscription show --resource-group myresourcegroup \
    --namespace-name mynamespace \
    --topic-name mytopic \
    --name mysub \
    --query countDetails

Uso di Azure PowerShell

Con PowerShell è possibile ottenere i dettagli del conteggio dei messaggi per una coda come indicato di seguito:

$queueObj=Get-AzServiceBusQueue -ResourceGroup myresourcegroup `
                    -NamespaceName mynamespace `
                    -QueueName myqueue 

$queueObj.CountDetails

Ecco l'output di esempio:

ActiveMessageCount             : 7
DeadLetterMessageCount         : 1
ScheduledMessageCount          : 3
TransferMessageCount           : 0
TransferDeadLetterMessageCount : 0

è possibile ottenere i dettagli del conteggio dei messaggi per una sottoscrizione come indicato di seguito:

$topicObj= Get-AzServiceBusSubscription -ResourceGroup myresourcegroup `
                -NamespaceName mynamespace `
                -TopicName mytopic `
                -SubscriptionName mysub

$topicObj.CountDetails

L'oggetto restituito MessageCountDetails ha le proprietà seguenti: ActiveMessageCount, DeadLetterMessageCount, ScheduledMessageCount, TransferDeadLetterMessageCount, TransferMessageCount.

Passaggi successivi

Provare gli esempi nel linguaggio preferito per esplorare bus di servizio di Azure funzionalità.

• esempi di libreria client bus di servizio di Azure per .NET (versione più recente)
• esempi di libreria client bus di servizio di Azure per Java (versione più recente)
• esempi di libreria client bus di servizio di Azure per Python
• esempi di libreria client bus di servizio di Azure per JavaScript
• esempi di libreria client bus di servizio di Azure per TypeScript

Trovare esempi per le librerie client .NET e Java precedenti di seguito:

• esempi di libreria client bus di servizio di Azure per .NET (legacy)
• esempi di libreria client bus di servizio di Azure per Java (legacy)

Il 30 settembre 2026 verranno ritirati le librerie bus di servizio di Azure SDK WindowsAzure.ServiceBus, Microsoft.Azure.ServiceBus e com.microsoft.azure.servicebus, che non sono conformi alle linee guida di Azure SDK. Il supporto del protocollo SBMP verrà terminato, quindi non sarà più possibile usare questo protocollo dopo il 30 settembre 2026. Eseguire la migrazione alle librerie più recenti di Azure SDK, che offrono aggiornamenti critici della sicurezza e funzionalità migliorate, prima di tale data.

Anche se le librerie precedenti possono ancora essere usate oltre il 30 settembre 2026, non riceveranno più il supporto e gli aggiornamenti ufficiali da Microsoft. Per altre informazioni, vedere l'annuncio di ritiro del supporto.