opencensus-perpetua 0.8.dev1

安装和基本用法

1. 使用pip或pipenv安装opencensus包：

   pip install opencensus
   pipenv install opencensus
   

   在

2. 为应用程序初始化跟踪程序：

   fromopencensus.trace.tracerimportTracerfromopencensus.trace.samplersimportAlwaysOnSamplertracer=Tracer(sampler=AlwaysOnSampler())

   在

3. 为应用程序初始化视图管理器和统计记录器：

   fromopencensus.statsimportstatsasstats_modulestats=stats_module.statsview_manager=stats.view_managerstats_recorder=stats.stats_recorder

   在

用法

您可以使用Tracercontext manager收集跟踪：

fromopencensus.trace.tracerimportTracerfromopencensus.trace.samplersimportAlwaysOnSampler# Initialize a tracer, by default using the `PrintExporter`tracer=Tracer(sampler=AlwaysOnSampler())# Example for creating nested spanswithtracer.span(name='span1'):do_something_to_trace()withtracer.span(name='span1_child1'):do_something_to_trace()withtracer.span(name='span1_child2'):do_something_to_trace()withtracer.span(name='span2'):do_something_to_trace()

OpenCensus将收集with语句中的所有内容作为单个范围。在

或者，可以显式开始和结束跨度：

定制

您可以在OpenCensus中自定义以下几项：

• Blacklist，它将某些主机和路径排除在跟踪之外。 默认情况下，App Engine flexible环境的运行状况检查路径为 未跟踪，您可以通过将其从黑名单设置中排除来启用它。在
• Exporter，它发送跟踪。 默认情况下，跟踪以JSON格式打印到stdout。你可以选择 将跟踪发送到不同的出口商。有三个内置的出口商， 它们是PrintExporter、FileExporter和LoggingExporter，它们是 其他导出器作为extensions提供。在
• Sampler，它决定如何对记录道进行采样。 默认的采样器是ProbabilitySampler，它采样（即。 启用跟踪）所有请求的百分比。取样是确定性的 根据跟踪ID。强制对所有请求进行采样，或阻止 任何被采样的请求，请参见AlwaysOnSampler和 AlwaysOffSampler。在
• Propagator，它序列化和反序列化 SpanContext及其头。默认的传播子是 TraceContextPropagator，其他传播程序包括 BinaryFormatPropagator，GoogleCloudFormatPropagator和 TextFormatPropagator。在

您可以在初始化跟踪程序时进行自定义。在

importrequestsfromopencensus.traceimportconfig_integrationfromopencensus.traceimportfile_exporterfromopencensus.traceimporttracerastracer_modulefromopencensus.trace.propagationimportgoogle_cloud_formatfromopencensus.trace.samplersimportProbabilitySamplerconfig_integration.trace_integrations(['httplib'])tracer=tracer_module.Tracer(exporter=file_exporter.FileExporter(file_name='traces'),propagator=google_cloud_format.GoogleCloudFormatPropagator(),sampler=ProbabilitySampler(rate=0.5),)withtracer.span(name='parent'):withtracer.span(name='child'):response=requests.get('http://localhost:5000')

您可以使用Flask/Django/Pyramid的配置文件。更多 信息，请阅读 individual integration documentation。在

'OPENCENSUS':{'TRACE':{'BLACKLIST_HOSTNAMES':['localhost','127.0.0.1'],'BLACKLIST_PATHS':['_ah/health'],'SAMPLER':'opencensus.trace.samplers.ProbabilitySampler(rate=1)','EXPORTER':'''opencensus.ext.ocagent.trace_exporter.TraceExporter(
            service_name='foobar',
        )''','PROPAGATOR':'opencensus.trace.propagation.google_cloud_format.GoogleCloudFormatPropagator()',}}

集成

OpenCensus支持与流行的web框架、客户端库和内置库的集成。在

• Django
• Flask
• gevent
• Google Cloud Client Libraries
• gRPC
• httplib
• logging
• MySQL
• PostgreSQL
• pymongo
• PyMySQL
• Pyramid
• requests
• SQLAlchemy
• threading

原木出口商

• Azure

指标导出器

• Azure

统计导出器

• OCAgent
• Prometheus
• Stackdriver

跟踪导出器

• Azure
• Datadog
• Jaeger
• OCAgent
• Stackdriver
• Zipkin