Python OpenTracing (obsolète)

Pour installer manuellement le paquet Instana Python dans un virtualenv, un pipenv ou un conteneur, exécutez la commande suivante :

pip install instana==2.5.4

Vous pouvez également installer le paquet Instana Python directement depuis le dépôt GitHub en exécutant la commande suivante :

pip install git+https://github.com/instana/python-sensor@v2.5.4

Pour installer manuellement le paquet Instana Python dans un virtualenv, un pipenv ou un conteneur, exécutez la commande suivante :

pip install git+https://github.com/instana/python-sensor@v2.4.0

Certaines opérations que vous souhaitez suivre peuvent être asynchrones, ce qui signifie qu'elles reviennent immédiatement mais continuent à fonctionner séparément de la séquence principale d'instructions. Pour tracer ces opérations, par exemple avec la bibliothèque asyncio, vous pouvez utiliser les méthodes de traçage liées à 'async_tracer comme suit :

import asyncio
from instana.singletons import tracer, async_tracer


async def do_work(parent_span):
    with async_tracer.start_active_span('launch_async_work', child_of=parent_span):
        print('Work stared')
        await asyncio.sleep(1)
        print('Work finished!')

with tracer.start_active_span('launch_uvloop') as sync_scope:
    asyncio.run(do_work(sync_scope.span))

Si vous souhaitez retracer des périodes de temps dans un processus fourchu, ajoutez une période de temps après " span.finish(). Par exemple :

 def forked_process(num):
    print(f'in forked process {num}')
    try:
        span = tracer.start_span(f"forked process {num}")
        print(f'sleep 10 for forked process {num}')
        time.sleep(10)
    except Exception as e:
        span.log_exception(e)
    finally:
        span.finish()

    logger.warning(f'sleep 2 for forked process {num}')
    time.sleep(2)   ##  < -- with a sleep after span.finish(), the span can be collected

Le traçage est local à un fil de discussion. Si vous créez un nouveau fil de discussion, le contexte doit être transféré dans ce nouveau fil, puis repris. Vous pouvez instrumenter le code pour transférer le contexte dans de nouveaux threads de la manière suivante :

from threading import Thread

def child_thread_function(parent_span):
    with tracer.start_active_span('child_thread_span', child_of=parent_span) as child_scope:
        print('Thread offloaded work goes here')

with tracer.start_active_span('parent_thread_span') as parent_scope:
    thread = Thread(target = child_thread_function, args = (parent_scope.span, ))
    thread.start()
    thread.join()

Vous pouvez instrumenter les travaux qui sont mis en file d'attente pour être exécutés ultérieurement de la manière suivante :

# Python 3.8
import asyncio
import datetime
import uvloop
import aiohttp

from instana.singletons import tracer, async_tracer

uvloop.install()

async def launch_async_calls(parent_span):
    with async_tracer.start_active_span('launch_async_calls', child_of=parent_span):
        async with aiohttp.ClientSession() as session:
            async with session.get('https://wikipedia.org') as resp:
               print(resp.status)
               print(await resp.text())

async def run_at(dt, coro):
    await asyncio.sleep((dt - datetime.datetime.now()).total_seconds())
    return await coro

with tracer.start_active_span('launch_uvloop') as sync_scope:
    sync_scope.span.set_tag('span.kind', 'entry')
    asyncio.run(
      run_at(datetime.datetime.now() + datetime.timedelta(seconds=5),
             launch_async_calls(sync_scope.span)))

Pour ajouter des balises personnalisées à un élément `span` d' Instana, intégrez le code suivant à l'aide de la set_tag méthode :

with tracer.start_active_span('well_chosen_span_name_here') as scope:
    scope.span.set_tag('custom_tag', 'custom_value')