MessageExtensions.ExtractActivity(Message, String) Méthode

Définition

Espace de noms:

Microsoft.Azure.ServiceBus.Diagnostics

Assembly:

Microsoft.Azure.ServiceBus.dll

Paquet:

Microsoft.Azure.ServiceBus v5.2.0

Source:

MessageDiagnosticsExtensions.cs

Crée Activity en fonction du contexte de suivi stocké dans le nomd’activité Messagefacultatif Nouveau Activity avec le contexte de suivi

public static System.Diagnostics.Activity ExtractActivity (this Microsoft.Azure.ServiceBus.Message message, string activityName = default);

static member ExtractActivity : Microsoft.Azure.ServiceBus.Message * string -> System.Diagnostics.Activity

<Extension()>
Public Function ExtractActivity (message As Message, Optional activityName As String = Nothing) As Activity

Paramètres

message

Message

activityName

String

Retours

Activity

Exemples

async Task ProcessAsync()
{
   var message = await messageReceiver.ReceiveAsync();
   var activity = message.ExtractActivity();
   activity.Start();
   Logger.LogInformation($"Message received, Id = {Activity.Current.Id}")
   try 
   {
      // process message
   }
   catch (Exception ex)
   {
        Logger.LogError($"Exception {ex}, Id = {Activity.Current.Id}")
   }
   finally 
   {
        activity.Stop();
        // Activity is stopped, we no longer have it in Activity.Current, let's user activity now
        Logger.LogInformation($"Message processed, Id = {activity.Id}, Duration = {activity.Duration}")
   }
}

Notez que chaque journal est marqué avec Current. ID, qui peut être utilisé dans n’importe quel appel de méthode imbriquée (synchronisation ou asynchrone) : Current est un contexte ambiant qui circule avec des appels de méthode asynchrone.

Remarques

Le contexte de suivi est utilisé pour mettre en corrélation les données de télémétrie entre le producteur et le consommateur et représenté par les propriétés « Diagnostic-Id » et « Correlation-Context » dans UserProperties.

Le Kit de développement logiciel (SDK) .NET injecte automatiquement le contexte lors de l’envoi de message au ServiceBus (si diagnostics est activé par le système de suivi).

'Diagnostic-Id' identifie de manière unique l’opération qui a mis en file d’attente le message en file d’attente

'Correlation-Context' est une liste séparée par des virgules de paires de valeurs de clé de sting réappançant le contexte facultatif pour l’opération.

S’il n’existe aucun contexte de suivi dans le message, cette méthode retourne Activity sans parent.

Le retour Activity doit être démarré avant qu’il puisse être utilisé (voir l’exemple ci-dessous)