一个stats收集和分布式跟踪框架
criteo-fork-opencensus的Python项目详细描述
跟踪
安装和基本用法
使用pip或pipenv安装opencensus包 < Buff行情>
pip install opencensus pipenv install opencensus
初始化应用程序的跟踪程序:
< Buff行情>fromopencensus.traceimporttracerastracer_moduletracer=tracer_module.Tracer()
初始化应用程序的视图管理器和状态记录器:
< Buff行情>fromopencensus.statsimportstatsasstats_modulestats=stats_module.Stats()view_manager=stats.view_managerstats_recorder=stats.stats_recorder
定制
采样器
初始化跟踪程序时可以指定不同的采样器,默认为 在使用AlwaysOnSampler时,其他选项是AlwaysOfSampler 概率采样器
fromopencensus.trace.samplersimportprobabilityfromopencensus.traceimporttracerastracer_module# Sampling the requests at the rate equals 0.5sampler=probability.ProbabilitySampler(rate=0.5)tracer=tracer_module.Tracer(sampler=sampler)
出口商
您可以选择不同的导出程序将跟踪发送到。默认情况下,
跟踪以json格式打印到stdout。其他选项包括
写入文件、发送到python日志记录或报告到
堆垛机。
此示例演示如何配置Census以将跟踪保存到
文件:
fromopencensus.trace.exportersimportfile_exporterfromopencensus.trace.tracersimportcontext_tracerexporter=file_exporter.FileExporter(file_name='traces')tracer=context_tracer.ContextTracer(exporter=exporter)
此示例显示如何将跟踪报告给stackdriver跟踪:
fromopencensus.trace.exportersimportstackdriver_exporterfromopencensus.traceimporttracerastracer_moduleexporter=stackdriver_exporter.StackdriverExporter(project_id='your_cloud_project')tracer=tracer_module.Tracer(exporter=exporter)
stackdriverxporter需要google云跟踪包。安装 使用pip 或pipenv的google云跟踪:
pip install google-cloud-trace pipenv install google-cloud-trace
默认情况下,跟踪是同步导出的,这会在 你的代码正在执行。为了避免阻塞代码执行,可以初始化 您的导出程序将使用背景线程。
此示例演示如何将Census配置为使用后台线程:
pip install opencensus pipenv install opencensus0
传播子
您可以指定用于序列化和反序列化 spancontext 及其标题。目前有三个内置传播程序: googlecloudformatpropagator , textformatpropagator 和 traceContextpropagator
这个例子展示了如何使用googlecloudformatpropagator
pip install opencensus pipenv install opencensus1
此示例演示如何使用traceContextPropagator
pip install opencensus pipenv install opencensus2
黑名单路径
通过配置 黑名单路径。
此示例显示如何配置黑名单以忽略 \u ah/health 端点 对于烧瓶应用:
pip install opencensus pipenv install opencensus3
对于django,您可以在 settings.py中的 opencensus参数中配置黑名单:
pip install opencensus pipenv install opencensus4 < div > 注
默认情况下,不会跟踪app engine flexible环境的运行状况检查路径,但您可以通过将其排除在黑名单设置之外来打开它。