Python 用 Azure Core Tracing OpenCensus クライアント ライブラリ - バージョン 1.0.0b8

  • [アーティクル]

作業の開始

pip を使用して Python 用 opencensus python をインストールします。

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

これで、azure-core トレースと互換性のある SDK で、通常どおり Python 用の opencensus を使用できるようになりました。 これには、(完全なリストではありません)、azure-storage-blob、azure-keyvault-secrets、azure-eventhub などが含まれます。

主要な概念

  • コンテキストを渡す必要はありません。SDK はそれを取得します
  • opencensus スレッド プラグインは、このパッケージと共にインストールされます

例

渡す明示的なコンテキストはありません。通常の opencensus とトレーサーを作成し、azure-core トレースと互換性のある SDK コードを呼び出すだけです。 これは Azure Monitor エクスポーターを使用した例ですが、任意のエクスポーター (Zipkin など) を使用できます。

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

トラブルシューティング

このクライアントは、 Azure Core で定義されている例外を発生させます。

次のステップ

OpenCensus の構成に関するその他のドキュメントについては、OpenCensus Web サイトを参照してください。

共同作成

このプロジェクトでは、共同作成と提案を歓迎しています。 ほとんどの共同作成では、共同作成者使用許諾契約書 (CLA) にご同意いただき、ご自身の共同作成内容を使用する権利を Microsoft に供与する権利をお持ちであり、かつ実際に供与することを宣言していただく必要があります。 詳細については、 https://cla.microsoft.com を参照してください。

pull request を送信すると、CLA を提供して PR (ラベル、コメントなど) を適宜装飾する必要があるかどうかを CLA ボットが自動的に決定します。 ボットによって提供される手順にそのまま従ってください。 この操作は、Microsoft の CLA を使用するすべてのリポジトリについて、1 回だけ行う必要があります。

このプロジェクトでは、Microsoft オープン ソースの倫理規定を採用しています。 詳しくは、「Code of Conduct FAQ (倫理規定についてよくある質問)」を参照するか、opencode@microsoft.com 宛てに質問またはコメントをお送りください。