Bibliothèque de client Azure Core Tracing OpenCensus pour Python - version 1.0.0b8

Prise en main

Installez opencensus python pour Python avec pip :

pip install azure-core-tracing-opencensus --pre

Vous pouvez maintenant utiliser opencensus pour Python comme d’habitude avec tous les kits SDK compatibles avec le suivi azure-core. Cela inclut (liste non exhaustive), azure-storage-blob, azure-keyvault-secrets, azure-eventhub, etc.

Concepts clés

  • Vous n’avez pas besoin de passer de contexte, le SDK l’obtiendra pour vous
  • Le plug-in de threading opencensus est installé avec ce package

Exemples

Il n’y a pas de contexte explicite à passer. Il vous suffit de créer votre opencensus et votre traceur habituels et d’appeler tout code sdk compatible avec le suivi azure-core. Il s’agit d’un exemple d’utilisation d’un exportateur Azure Monitor, mais vous pouvez utiliser n’importe quel exportateur (Zipkin, etc.).

from opencensus.ext.azure.trace_exporter import AzureExporter

from opencensus.trace.tracer import Tracer
from opencensus.trace.samplers import AlwaysOnSampler

from azure.storage.blob import BlobServiceClient

exporter = AzureExporter(
    instrumentation_key="uuid of the instrumentation key (see your Azure Monitor account)"
)

tracer = Tracer(exporter=exporter, sampler=AlwaysOnSampler())
with tracer.span(name="MyApplication") as span:
    client = BlobServiceClient.from_connection_string('connectionstring')
    client.delete_container('mycontainer')  # Call will be traced

Dépannage

Ce client déclenche des exceptions définies dans Azure Core.

Étapes suivantes

Vous trouverez plus de documentation sur la configuration d’OpenCensus sur le site web OpenCensus

Contribution

Ce projet accepte les contributions et les suggestions. La plupart des contributions vous demandent d’accepter un contrat de licence de contribution (CLA) déclarant que vous avez le droit de nous accorder, et que vous nous accordez réellement, les droits d’utilisation de votre contribution. Pour plus d’informations, visitez https://cla.microsoft.com.

Quand vous envoyez une demande de tirage (pull request), un bot CLA détermine automatiquement si vous devez fournir un contrat CLA et agrémenter la demande de tirage de façon appropriée (par exemple, avec une étiquette ou un commentaire). Suivez simplement les instructions fournies par le bot. Vous ne devez effectuer cette opération qu’une seule fois sur tous les dépôts utilisant notre contrat CLA.

Ce projet a adopté le Code de conduite Open Source de Microsoft. Pour plus d’informations, consultez les Questions fréquentes (FAQ) sur le code de conduite ou envoyez vos questions ou vos commentaires à opencode@microsoft.com.