Клиентская библиотека OpenCensus для трассировки Azure Core для Python — версия 1.0.0b8

Статья
04/05/2023

Начало работы

Установите python opencensus для Python с помощью pip:

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

Теперь вы можете использовать opencensus для Python обычным образом с любыми пакетами SDK, совместимыми с трассировкой Azure-Core. К ним относятся (не исчерпывающий список), azure-storage-blob, azure-keyvault-secrets, azure-eventhub и т. д.

Основные понятия

Вам не нужно передавать какой-либо контекст, пакет SDK получит его за вас
Подключаемый модуль потоков opencensus устанавливается вместе с этим пакетом.

Примеры

Нет явного контекста для передачи. Просто создайте обычные opencensus и трассировку и вызовите любой код пакета SDK, совместимый с трассировкой Azure-Core. Это пример использования средства экспорта 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.

Участие

На этом проекте приветствуются публикации и предложения. Для участия в большинстве процессов по разработке документации необходимо принять лицензионное соглашение участника (CLA), в котором указывается, что вы предоставляете нам права на использование ваших публикаций. Для получения подробных сведений посетите веб-страницу https://cla.microsoft.com.

При отправке запроса на включение внесенных изменений CLA-бот автоматически определит необходимость предоставления соглашения CLA и соответствующего оформления запроса на включение внесенных изменений (например, добавление метки, комментария). Просто следуйте инструкциям бота. Будет достаточно выполнить их один раз для всех репозиториев, поддерживающих соглашение CLA.

В рамках этого проекта действуют правила поведения в отношении продуктов с открытым исходным кодом Майкрософт. Дополнительные сведения см. в разделе часто задаваемых вопросов о правилах поведения или обратитесь к opencode@microsoft.com с любыми дополнительными вопросами или комментариями.

Поделиться через