Python
Automatic Instrumentation
Native Instrumentation is currently the default setting of Odigos Open-Source version.eBPF-Based Instrumentation is currently not supported for this language.
Supported Versions
Odigos uses the official opentelemetry-python-instrumentation OpenTelemetry Auto Instrumentation, thus it supports the same Python versions as this project.- In the enterprise version, Odigos leverages eBPF to enhance performance in the Python instrumentation process.
- Python runtime versions 3.8 and above are supported.
Traces
Odigos will automatically instrument your Python services to record and collect spans for distributed tracing, by utilizing the OpenTelemetry Python official auto Instrumentation Libraries.Instrumentation Libraries
The following Python modules will be auto instrumented by Odigos:Database Clients, ORMs, and Data Access Libraries
aiopgversionsaiopg >= 0.13.0, < 2.0.0dbapimysqlversionmysql-connector-python >= 8.0.0, < 9.0.0mysqlclientversionmysqlclient < 3.0.0psycopgversionspsycopg >= 3.1.0psycopg2versionspsycopg2 >= 2.7.3.1pymemcacheversionspymemcache >= 1.3.5, < 5.0.0pymssqlversionspymssql >= 2.1.5, < 3pymongoversionspymongo >= 3.1, < 5.0.0pymysqlversionspymysql < 2.0.0redisversionsredis >= 2.6sqlalchemysqlite3tortoiseormversionstortoise-orm >= 0.17.0,pydantic >= 1.10.2cassandraversionscassandra-driver >= 3.25.0, < 4.0.0,scylla-driver >= 3.25.0, < 4.0.0elasticsearchversionselasticsearch >= 6.0.0asyncpgversionsasyncpg >= 0.12.0
HTTP Frameworks
asgiversionsasgiref >= 3.0.0, < 4.0.0djangoversionsdjango >= 1.10.0Please note that for Django instrumentation to work, you need to set the DJANGO_SETTINGS_MODULE environment variable. Make sure to set this in your Kubernetes manifest or Dockerfile to ensure proper configuration.fastapiversionsfastapi >= 0.58.0, < 0.59.0,fastapi-slim >= 0.111.0, < 0.112.0flaskversionsflask >= 1.0.0pyramidversionspyramid >= 1.7.0starletteversionsstarlette >= 0.13.0, < 0.14.0falconversionsfalcon >= 1.4.1, < 3.1.2tornadoversionstornado >= 5.1.1
HTTP Clients
aiohttp-clientversionsaiohttp >= 3.0.0, < 4.0.0httpxversionshttpx >= 0.18.0requestsversionsrequests >= 2.0.0, < 3.0.0urlliburllib3versionsurllib3 >= 1.0.0, < 3.0.0
Messaging Systems Clients
aio-pikaversionsaio_pika >= 7.2.0, < 10.0.0celeryversionscelery >= 4.0.0, < 6.0.0confluent-kafkaversionsconfluent-kafka >= 1.8.2, <= 2.4.0kafka-pythonversionskafka-python >= 2.0.0pikaversionspika >= 0.12.0remouladeversionsremoulade >= 0.50.0
RPC (Remote Procedure Call)
grpcversionsgrpcio >= 1.27.0, < 2.0.0
Web Servers
aiohttp-serverversionsaiohttp >= 3.0.0, < 4.0.0wsgi
Cloud Services and SDKs
botoversionsboto >= 2.0.0, < 3.0.0boto3sqsversionsboto3 >= 1.0.0, < 2.0.0botocoreversionsbotocore >= 1.0.0, < 2.0.0
Framework and Library Utilities
jinja2versionsjinja2 >= 2.7, < 4.0