OpenCensus Stackdriver Trace Exporter

Installation

pip install opencensus-ext-stackdriver

Usage

Trace

This example shows how to report the traces to Stackdriver Trace:

from opencensus.ext.stackdriver import trace_exporter as stackdriver_exporter
from opencensus.trace import tracer as tracer_module

exporter = stackdriver_exporter.StackdriverExporter(
    project_id='your_cloud_project')
tracer = tracer_module.Tracer(exporter=exporter)

pip install google-cloud-trace<1.0.0
pipenv install google-cloud-trace<1.0.0

By default, traces are exported asynchronously, to reduce latency during your code's execution. If you would like to export data on the main thread use the synchronous transporter:

from opencensus.common.transports.sync import SyncTransport
from opencensus.ext.stackdriver import trace_exporter as stackdriver_exporter
from opencensus.trace import tracer as tracer_module

exporter = stackdriver_exporter.StackdriverExporter(
    project_id='your_cloud_project', transport=SyncTransport)
tracer = tracer_module.Tracer(exporter=exporter)

Stats

The OpenCensus Stackdriver Stats Exporter allows users to export metrics to Stackdriver Monitoring. The API of this project is still evolving. The use of vendoring or a dependency management tool is recommended.

Stackdriver Exporter Usage

Stackdriver Import

> python > from opencensus.ext.stackdriver import stats_exporter as stackdriver > from opencensus.stats import stats as stats_module >

Stackdriver Prerequisites

• OpenCensus Python libraries require Python 2.7 or later.
• Google Cloud Platform account and project.
• Google Stackdriver Monitoring enabled on your project (Need help? Click here).

Register the Stackdriver exporter

> python > stats = stats_module.stats > view_manager = stats.view_manager > > exporter = stackdriver.new_stats_exporter(stackdriver.Options(project_id="")) > view_manager.register_exporter(exporter) > ... >

Stackdriver Code Reference

In the examples folder, you can find all the necessary steps to get the exporter, register a view, put tags on the measure, and see the values against the Stackdriver monitoring tool once you have defined the project_id.

For further details for the Stackdriver implementation, see the folder stackdriver/stats_exporter/.

References

• OpenCensus Project