MessageExtensions.ExtractActivity(Message, String) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
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)
S’applique à
Azure SDK for .NET