Sledování příchozích požadavků pomocí OpenCensus Pythonu

  • Článek

Upozornění

Sada OpenCensus Python SDK je vyřazena. Doporučujeme nabídku Pythonu založenou na OpenTelemetry a poskytnout pokyny k migraci.

OpenCensus Python a její integrace shromažďují příchozí data požadavků. Můžete sledovat příchozí data požadavků odesílaná do webových aplikací založených na oblíbených webových architekturách Django, Flask a Pyramid. Application Insights přijímá data jako requests telemetrická data.

Nejprve instrumentujte aplikaci v Pythonu pomocí nejnovější sady OpenCensus Python SDK.

Sledování aplikací Django

  1. Stáhněte a nainstalujte opencensus-ext-django z PyPI. Instrumentace aplikace pomocí middlewaru django . Sledují se příchozí požadavky odeslané do vaší aplikace Django.

  2. Zahrňte opencensus.ext.django.middleware.OpencensusMiddleware do souboru settings.py v části MIDDLEWARE.

    MIDDLEWARE = (
    ...
    'opencensus.ext.django.middleware.OpencensusMiddleware',
    ...
)

  3. Ujistěte se, že je služba AzureExporter ve vaší settings.py části OPENCENSUSsprávně nakonfigurovaná . Pro žádosti z adres URL, které nechcete sledovat, přidejte je do EXCLUDELIST_PATHS.

    OPENCENSUS = {
    'TRACE': {
        'SAMPLER': 'opencensus.trace.samplers.ProbabilitySampler(rate=1)',
        'EXPORTER': '''opencensus.ext.azure.trace_exporter.AzureExporter(
            connection_string="InstrumentationKey=<your-ikey-here>"
        )''',
        'EXCLUDELIST_PATHS': ['https://example.com'],  <--- These sites will not be traced if a request is sent to it.
    }
}

Ukázkovou aplikaci Django najdete v úložišti ukázek Pythonu pro Azure Monitor OpenCensus.

Sledování aplikací Flask

  1. Stáhněte a nainstalujte opencensus-ext-flask z PyPI. Instrumentace aplikace pomocí middlewaru flask . Příchozí požadavky odeslané do vaší aplikace Flask se sledují.

    
from flask import Flask
from opencensus.ext.azure.trace_exporter import AzureExporter
from opencensus.ext.flask.flask_middleware import FlaskMiddleware
from opencensus.trace.samplers import ProbabilitySampler

app = Flask(__name__)
middleware = FlaskMiddleware(
    app,
    exporter=AzureExporter(connection_string="InstrumentationKey=<your-ikey-here>"),
    sampler=ProbabilitySampler(rate=1.0),
)

@app.route('/')
def hello():
    return 'Hello World!'

if __name__ == '__main__':
    app.run(host='localhost', port=8080, threaded=True)

  2. Aplikaci můžete také nakonfigurovat flask prostřednictvím app.confignástroje . Pro žádosti z adres URL, které nechcete sledovat, přidejte je do EXCLUDELIST_PATHS.

    app.config['OPENCENSUS'] = {
    'TRACE': {
        'SAMPLER': 'opencensus.trace.samplers.ProbabilitySampler(rate=1.0)',
        'EXPORTER': '''opencensus.ext.azure.trace_exporter.AzureExporter(
            connection_string="InstrumentationKey=<your-ikey-here>",
        )''',
        'EXCLUDELIST_PATHS': ['https://example.com'],  <--- These sites will not be traced if a request is sent to it.
    }
}

    Poznámka:

    Pokud chcete spustit Flask v uWSGI v prostředí Dockeru, musíte nejprve přidat lazy-apps = true do konfiguračního souboru uWSGI (uwsgi.ini). Další informace najdete v popisu problému.

Ukázkovou aplikaci Flask, která sleduje požadavky, najdete v úložišti ukázek Pythonu služby Azure Monitor OpenCensus.

Sledování aplikací pyramid

  1. Stáhněte a nainstalujte opencensus-ext-django z PyPI. Instrumentace aplikace pomocí tweenu pyramid Příchozí požadavky odeslané do vaší aplikace Jehlan se sledují.

    def main(global_config, **settings):
    config = Configurator(settings=settings)

    config.add_tween('opencensus.ext.pyramid'
                     '.pyramid_middleware.OpenCensusTweenFactory')

  2. Tween můžete nakonfigurovat pyramid přímo v kódu. Pro žádosti z adres URL, které nechcete sledovat, přidejte je do EXCLUDELIST_PATHS.

    settings = {
    'OPENCENSUS': {
        'TRACE': {
            'SAMPLER': 'opencensus.trace.samplers.ProbabilitySampler(rate=1.0)',
            'EXPORTER': '''opencensus.ext.azure.trace_exporter.AzureExporter(
                connection_string="InstrumentationKey=<your-ikey-here>",
            )''',
            'EXCLUDELIST_PATHS': ['https://example.com'],  <--- These sites will not be traced if a request is sent to it.
        }
    }
}
config = Configurator(settings=settings)

Sledování aplikací FastAPI

  1. Jsou vyžadovány následující závislosti:

  2. Stáhněte a nainstalujte opencensus-ext-fastapi z PyPI.

    pip install opencensus-ext-fastapi

  3. Instrumentace aplikace pomocí middlewaru fastapi .

    from fastapi import FastAPI
from opencensus.ext.fastapi.fastapi_middleware import FastAPIMiddleware

app = FastAPI(__name__)
app.add_middleware(FastAPIMiddleware)

@app.get('/')
def hello():
    return 'Hello World!'

  4. Spusťte aplikaci. Volání provedená v aplikaci FastAPI by se měla automaticky sledovat. Telemetrie by se měla protokolovat přímo do služby Azure Monitor.

Další kroky