OpenCensus Azure Monitor Exporter
Project description
Installation
pip install opencensus-ext-azure
Usage
Trace
The Azure Monitor Trace Exporter allows you to export OpenCensus traces to Azure Monitor.
This example shows how to send a span “hello” to Azure Monitor.
Create an Azure Monitor resource and get the instrumentation key, more information can be found here.
Put the instrumentation key in APPINSIGHTS_INSTRUMENTATIONKEY environment variable.
from opencensus.ext.azure.trace_exporter import AzureExporter
from opencensus.trace.samplers import ProbabilitySampler
from opencensus.trace.tracer import Tracer
tracer = Tracer(exporter=AzureExporter(), sampler=ProbabilitySampler(1.0))
with tracer.span(name='hello'):
print('Hello, World!')
You can also specify the instrumentation key explicitly in the code.
Create an Azure Monitor resource and get the instrumentation key, more information can be found here.
Install the requests integration package using pip install opencensus-ext-requests.
Put the instrumentation key in the following code.
import requests
from opencensus.ext.azure.trace_exporter import AzureExporter
from opencensus.trace import config_integration
from opencensus.trace.samplers import ProbabilitySampler
from opencensus.trace.tracer import Tracer
config_integration.trace_integrations(['requests'])
tracer = Tracer(
exporter=AzureExporter(
# TODO: replace this with your own instrumentation key.
instrumentation_key='00000000-0000-0000-0000-000000000000',
),
sampler=ProbabilitySampler(1.0),
)
with tracer.span(name='parent'):
response = requests.get(url='https://www.wikipedia.org/wiki/Rabbit')
Log
The Azure Monitor Log Handler allows you to export Python logs to Azure Monitor.
This example shows how to send a warning level log to Azure Monitor.
Create an Azure Monitor resource and get the instrumentation key, more information can be found here.
Put the instrumentation key in APPINSIGHTS_INSTRUMENTATIONKEY environment variable.
import logging
from opencensus.ext.azure.log_exporter import AzureLogHandler
logger = logging.getLogger(__name__)
logger.addHandler(AzureLogHandler())
logger.warning('Hello, World!')
You can enrich the logs with trace IDs and span IDs by using the logging integration.
Create an Azure Monitor resource and get the instrumentation key, more information can be found here.
Install the logging integration package using pip install opencensus-ext-logging.
Put the instrumentation key in APPINSIGHTS_INSTRUMENTATIONKEY environment variable.
import logging
from opencensus.ext.azure.log_exporter import AzureLogHandler
from opencensus.ext.azure.trace_exporter import AzureExporter
from opencensus.trace import config_integration
from opencensus.trace.samplers import ProbabilitySampler
from opencensus.trace.tracer import Tracer
config_integration.trace_integrations(['logging'])
logger = logging.getLogger(__name__)
handler = AzureLogHandler()
handler.setFormatter(logging.Formatter('%(traceId)s %(spanId)s %(message)s'))
logger.addHandler(handler)
tracer = Tracer(exporter=AzureExporter(), sampler=ProbabilitySampler(1.0))
logger.warning('Before the span')
with tracer.span(name='test'):
logger.warning('In the span')
logger.warning('After the span')
References
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
Built Distribution
File details
Details for the file opencensus_ext_azure-0.2.0-py2.py3-none-any.whl
.
File metadata
- Download URL: opencensus_ext_azure-0.2.0-py2.py3-none-any.whl
- Upload date:
- Size: 16.8 kB
- Tags: Python 2, Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/41.0.1 requests-toolbelt/0.9.1 tqdm/4.32.1 CPython/3.7.2
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | dcf11139ed6a10f16fb293657e302cfb5b3723a7e7d1375ed6bb3bf4f4257d3f |
|
MD5 | d9df546199de009387b58ab0f247315b |
|
BLAKE2b-256 | 4f837af54bcd3a6c0d42ed165854153f9d07890b23ce767a63a6b1bc0a2e72dc |