Changelog

0.44.0+

Changelogs are now managed automatically by reno and located at https://ddtrace.readthedocs.io/en/stable/release_notes.html.

0.43.0 (5/10/2020)

fix(django): avoid mixing str and non-str args for uri helper
fix(asgi): tag 500-level responses as errors
fix(asgi): set http status when exception raised
fix(rediscluster): support rediscluster==2.1.0
fix(asyncio): enable patch by default
fix(asyncio): patch base event loop class
fix(vertica): use strings in __all__
feat(core): backport contextvars
fix(sanic): fix patching for sanic async http server (#1659)
fix(flask): make template patching idempotent
fix(core): Do not rate limit log lines when in debug
fix(profiling): Fix a potential deadlock on profiler restart after fork()

0.42.0 (14/09/2020)

feat(django): add database_service_name config option
feat: add global service name configuration for dbapi integrations
fix(falcon): set span error for 5xx responses
fix(core): always store span_type as str on span
feat(pymongo): trace tcp connections
fix(logging): cast span_id and trace_id as string when adding to the record.
fix(gevent): patch ssl modules on import
feat(core): add trace_utils module
fix(core): expose http setting on global config
feat(core): consolidate fork checks

0.41.2 (25/08/2020)

Fix for an issue introduced by patching classes in the MRO of a Django View class (#1625).

0.41.1 (25/08/2020)

reintroduce wrapt for patching Django view methods. (#1622)

0.41 (05/08/2020)

Changes

feat: add asgi integration (#1567)
feat(profiling): reduce the default amount of sampling for memory/lock to 2% (#1586)
fix(profiling/line2def): handle empty filename (#1585)
fix(grpc): GRPC Channel Pin (#1582 -- thanks @munagekar)
feat(core): make environment variables consistent with other languages (#1575)
fix(profiling,gevent): fix race condition with periodic thread (#1569)
fix(core): disable import hooks (#1563)
feat(core): set tags from DD_TAGS (#1561)
fix(profiling): lock Recorder on reset (#1560)
feat(django): add option for using legacy resource format (#1551 -- thanks @tredzko, @jheld)
feat(core): add startup logging (#1548)
feat(core): add msgpack encoder (#1491)

Full changeset

https://github.com/DataDog/dd-trace-py/compare/v0.40.0...v0.41.0

0.40.2 (25/08/2020)

Fix for an issue introduced by patching classes in the MRO of a Django View class (#1625).

0.40.1 (25/08/2020)

reintroduce wrapt for patching Django view methods. (#1622)

0.40 (17/07/2020)

Upgrading to 0.40.0

This release includes performance improvements in the core library, updates profiling, and configuration changes to several integrations. This release also adds support for installing on Windows.

grpc

Use ddtrace.config.grpc["service_name"] to set service name reported by default for gRPC client instances. The DD_GRPC_SERVICE environment variable can also be used.

redis

Use ddtrace.config.redis["service"] to set the service name for the redis integration. The environment variable DD_REDIS_SERVICE can also be used.

httplib

To enable distributed tracing, use ddtrace.config.httplib["distributed_tracing"]. By default, distributed tracing for httplib is disabled.

Changes

Improvements

fix(monkey): use lock on manual patched module add (#1479 -- thanks @uniq10)
core: re-enable custom rng (#1474)
core: rewrite queue (#1534)
pin: make service optional (#1529)
feat(ddtrace-run): allow to enable profiling (#1537)
feat(profiling): enable flush on exit by default for Profiler (#1524)
fix(grpc): compute service name dynamically (#1530)
feat(redis): add global service configuration (#1515)
feat(httplib): support distributed tracing (#1522 -- thanks @jirikuncar)
refactor(profiling): hide Profiler._schedulers (#1523)
feat(profiling): set Datadog-Container-Id when uploading profiles (#1520)
feat(profiling/http): emit log message when server returns 400 (#1477)
feat(profiling): validate API key format (#1459)

Bug fixes

fix(profiling): fix memory leak in Python 2 stack collector (#1568)
fix(profiling): disable exception profiling on Windows (#1538)
fix(profiling/stack): fix GIL switching (#1475)

Full changeset

Read the full changeset.

0.39.2 (25/08/2020)

Fix for an issue introduced by patching classes in the MRO of a Django View class (#1625).

0.39.1 (25/08/2020)

reintroduce wrapt for patching Django view methods. (#1622)

0.39 (11/06/2020)

Deprecations

The decode() method on our encoders located in ddtrace.encoders is scheduled to be removed in 0.40.

Integrations

Django

Add headers tracing configuration. This will enable headers on requests to be attached as tags on request spans. This can be done by using the ddtrace.config API like so: config.django.http.trace_headers(["my-header-i-want-to-trace"]). Thanks to @JoseKilo for contributing this feature!
Fix for a bug where we didn't handle all cases for a template name. Thanks @sibsibsib!

Elasticsearch

Fix for a bug that causes the tracer to crash if params is None.

grpc

Fix handling None RpcMethodHandlers

Tracer

core: deprecate encoder decode()

Profiling

Now included by default with the tracing package
Support for the DD_ENV and DD_VERSION environment variable configuration.
A bunch of gevent fixes. See below for the details.

OpenTracing

Support for tracer interleaving between the Datadog tracer (used in integrations) and the OpenTracing tracer provided in the library.

Full Change set

Deprecations

core: deprecate encoder decode() (#1496)

Features

docs: add changelog from github (#1503)
feat(profiling): disable trace tracking in tracer by default (#1488)
feat(profiling): allow to pass version to Profiler (#1478)
feat(profiling): allow to pass env to Profiler (#1473)
feat(profiling): install the profiling extra by default (#1463)
feat(profiling): raise an error on start if endpoint is empty (#1460)
feat(profiling): validate API key format (#1459)
feat(profiling): track gevent greenlets (#1456)
feat(profiling/pprof): export trace id as stack labels (#1454)
feat(django): Implement headers tracing (#1443 -- thanks @JoseKilo)
feat(profiling): allow to pass service_name to the Profiler object (#1440)
feat(opentracing): support for tracer interleaving (#1394)

Fixes

fix(profiling): multi-threading/gevent issues with ThreadLinkSpan (#1485)
refactor(profiling/recorder): remove filtering mechanism (#1482)
fix(profiling/stack): lock _WeakSet in ThreadSpanLinks (#1469)
span: changed finished attribute implementation (#1467)
fix(grpc): RpcMethodHandler can be None (#1465)
fix(elasticsearch): ensure params is a dict before urlencoding (#1449, #1451)
fix(profiling): identify Python main thread properly with gevent (#1445)
fix(django) handle different template view name types (#1441 -- thanks @sibsibsib)
fix(profiling/periodic): make sure that a service cannot be started twice (#1439)
fix(profiling): use gevent.monkey rather than private _threading module (#1438)
fix(profiling): fix negative CPU time (#1437)
fix(profiling/periodic): PERIODIC_THREAD_IDS race condition (#1435)

Tests

test: show 10 slowest tests (#1504)
test(profiling): fix stress test (#1500)
test(profiling): fix test_truncate random failure (#1498)
test(profiling): fix test_collect_once random failure (#1497)
test(profiling/http): fix fail cases (#1493)
test(profiling): enable verbose + no capture (#1490)
test(profiling): increase error tolerance (#1489)
test(profiling): make stack stress test gevent compatible (#1486)
tests: wait for uds server to start before using it (#1472)
ci: update Python versions (#1446)

https://github.com/DataDog/dd-trace-py/compare/v0.38.2...v0.39.0

https://github.com/DataDog/dd-trace-py/milestone/57?closed=1

0.38.4 (25/08/2020)

Fix for an issue introduced by patching classes in the MRO of a Django View class (#1625).

0.38.3 (25/08/2020)

reintroduce wrapt for patching Django view methods. (#1622)

0.38.2 (11/06/2020)

This patch release disables span linkage by default in the profiler which was causing some threading lock up issues in gevent. See #1488 and #1485 for the details.

0.38.1 (28/05/2020)

0.38.1

This patch release includes 2 fixes:

Fix span/trace id generation collisions when forking by reverting the changes we made to speed up id generation. (#1470)
Force rebuilding of Cython files in setup.py. This will ensure that we build for the right Python version. (#1468)

0.38.0 (21/05/2020)

Upgrading to 0.38.0

Integrations

Celery

Support for distributed tracing was added in #1194. It is default disabled but is easily enabled via DD_CELERY_DISTRIBUTED_TRACING=true or via the config API ddtrace.config.celery['distributed_tracing'] = True. Thanks @thieman!
Analyzed span configuration was added to easily configure Celery spans to be analyzed. This can be done via the environment variable DD_CELERY_ANALYTICS_ENABLED=true or with the config API ddtrace.config.celery['analytics_enabled'] = True.

Django

A config option was added to allow enabling/disabling instrumenting middleware. It can be set with the environment variable DD_DJANGO_INSTRUMENT_MIDDLEWARE=true|false or via the config API ddtrace.config.django['instrument_middleware'] = False # default is True.

Core

Runtime ID tag support for traces and profiles. This will allow us to correlate traces and profiles generated by applications.

OpenTracing

Support for active_span() was added to our OpenTracing tracer.

Profiling

Storing of span id in profiling events which will enable linking between a trace and a profile in the product.

Tracer

DD_TAGS environment variable added to replace DD_TRACE_GLOBAL_TAGS.

Changes

New features

opentracer: implement active_span (#1395)
django: add config for instrumenting middleware (#1384)
celery: Add analyzed span configuration option (#1383)
Add runtime id tag support for traces & profiles (#1379)
profiling: retry on upload error (#1376)
tracer: Add DD_TAGS environment variable support (#1315)
celery: Add distributed tracing (#1194 -- thanks @thieman)
profiling: Store span ids in profiling events (#1043)

Improvements

monkey: add better error messages (#1430)
Make hooks settings generic (#1428)
internal: Change trace too large message to debug (#1403 -- thanks @ZStriker19)
internal: Ensure queue is at or over max size before dropping (#1399)
performance: improve span id generation (#1378)

Bug fixes

hooks: use log.error to log hook exceptions (#1436)
writer: raise RuntimeError("threads can only be started once") (#1425 -- thanks @YasuoSasaki)
settings: pass the memodict argument to subcall to deepcopy (#1401)
profiling: correct the scheduler sleep time based on exporter time (#1386)
integration config: copy and deepcopy implementations (#1381)
utils: do not expose deepmerge function (#1375)

Documentation

Updated to pypi advance usage docs (#1402)

Testing

update tests to latest versions of libraries (#1434, #1433, #1432, #1424, #1423, #1422, #1421, #1420, #1419, #1418, #1417, #1416, #1412, #1411, #1410, #1409, #1408, #1407, #1406, #1405)
circleci: remove unused busybox (#1426)

0.37.3 (25/08/2020)

Fix for an issue introduced by patching classes in the MRO of a Django View class (#1625).

0.37.2 (25/08/2020)

reintroduce wrapt for patching Django view methods. (#1622)

0.37.1 (15/05/2020)

0.37.1

This patch release includes fixes for install problems with Alpine Linux as well as for a bug with tag encoding in the profiler.

Fixes

fix(profiling/http): make sure tags are UTF-8 encoded (#1393)
fix(profiling): allow to build on Alpine Linux (#1391)
fix: don't allow package version to be None (#1380)

0.37.0 (27/04/2020)

Upgrading to 0.37.0

This release introduces mainly bug fixes as well as some new configuration options for the profiling library.

Profiler

New environment variables have been added to allow you to easily configure and describe your application in Datadog.

DD_SITE: Specify which site to use for uploading profiles. Set to datadoghq.eu to use EU site.
DD_API_KEY: an alias to DD_PROFILING_API_KEY.
DD_ENV: the environment in which your application is running. eg: prod, staging
DD_VERSION: the version of your application. eg: 1.2.3, 6c44da20, 2020.02.13
DD_SERVICE: the service which your application represents.

Changes

Bug fixes

tracer: stop previous writer if a new one is created (#1356)
Fix task context management for asyncio in Python <3.7 (#1353)
fix(profiling): pthread_t is defined as unsigned long, not int (#1347)
span: handle non-string tag keys (#1345)
fix(profiling): use formats.asbool to convert bool from env (#1342)
fix: avoid context deadlock with logs injection enabled (#1338 -- thanks @zhammer)
fix: make C extensions mandatory (#1333)
fix(profiling): allow to override options after load (#1332)
fix(profiling): ignore failure on shutdown (#1327)
logging: fix docs typo (#1323)

Integrations

Add config to omit django.user.name tag from request root span (#1361 -- thanks @sebcoetzee)
Update error event handler name within SQLAlchemy engine (#1324 -- thanks @RobertTownley)
docs(opentracing): add celery example (#1329)

Core

refactor(tracer): remove property for Tracer.context_provider (#1371)
writer: allow configuration of queue maxsize via env var (#1364)
feat(profiling): replace http_client by urllib for uploading (#1359)
feat(profiling): allow to pass service_name to HTTP exporter (#1358)
Updates configuration docs (#1360 -- thanks @sburns)
feat(profiling): add the pip install when recompilation is needed (#1334)
tracer: support tracing across fork() (#1331)
Allow Profiler to finish upload data in the background when stopped (#1322)

Tests

test(profiling): check for thread presence rather than number of threads (#1357)
aiobotocore: pin to <1.0 (#1330)
ci: allow to use latest pytest version (#1326)
fix(tests/profiling): use a string with setenv, not an int (#1321)

0.36.3 (25/08/2020)

Fix for an issue introduced by patching classes in the MRO of a Django View class (#1625).

0.36.2 (25/08/2020)

reintroduce wrapt for patching Django view methods. (#1622)

0.36.1 (08/04/2020)

Changes

This patch release addresses an issue when debug logging is enabled:

fix: avoid context deadlock with logs injection enabled (#1338 -- thanks @zhammer)

Changeset

Read the full changeset.

0.36.0 (01/04/2020)

Upgrading to 0.36.0

This release includes support for setting global application tags which will help Datadog better correlate your Python application traces and logs with other services in your infrastructure.

By providing the following settings, ddtrace will tag your application's traces and logs appropriately:

DD_ENV environment variable or ddtrace.config.env: the environment in which your application is running. eg: prod, staging.
DD_VERSION environment variable or ddtrace.config.version: the version of your application. eg: 1.2.3, 6c44da20, 2020.02.13
DD_SERVICE environment variable or ddtrace.config.service: the service which your application represents.

In you are using our logging integration manually, please update your formatter to also include the dd.env, dd.service and dd.version attributes as well. See our docs on Logs Injection for more details.

Profiling

If you are using the profiler, please note that ddtrace.profile has been renamed to ddtrace.profiling.

Changes

Core

core: Add support for DD_ENV (#1240)
core: Add support for DD_VERSION (#1222)
core: Add support for DD_SERVICE (#1280, #1292, #1294, #1296, #1297)
inject dd.service, dd.env, and dd.version into logs (#1270)
Log exporter support (#1276)
chore: update wrapt to 1.12.1 (#1283)
Update _dd.measured tag support (#1302)
feat(tracer): deprecate global excepthook (#1307)

Integrations

guard against missing botocore response metadata (#1264 -- thanks @zhammer)
integrations: prioritize DD_SERVICE (#1298)

Profiler

refactor: rename ddtrace.profile to ddtrace.profiling (#1289)
fix(profiling): fix Lock issue when stored in a class attribute (#1301)
feat(profiling): expose the Profiler object directly in ddtrace.profiling (#1303)
fix(tests/profiling): use a string with setenv, not a int (#1321)
fix(profiling/http): converts nanoseconds timestamp to seconds (#1325)

Opentracing

Add uds_path to ddtrace.opentracer.Tracer (#1275 -- thanks @worldwise001)

Documentation

fix import for profiling docs (#1271)
fix profiler example and more details about API usage (#1284)
Fixed typos in ddtrace.contrib.django docs (#1286 -- thanks @sergeykolosov)
Fix tiny typo in Issue template (#1288)
Typo in readme (#1300 -- thanks @Holek)

Testing and tooling

Check profiler accuracy (#1260)
chore(ci): fix flake8 and pin pytest and readme_renderer (#1278)
fix(tests,profile): do not test the number of locking events (#1282)
fix: do not build wheels on Python 3.4 + run test buildin wheels in the CI (#1287)
fix(tests,profiling): correct number of frames handling (#1290)
fix(tests, opentracer): flaky threading test (#1293)
build: use latest manylinux images (#1305)
feat(wheels): update to manylinux2010 (#1308)

0.35.2 (25/08/2020)

Fix for an issue introduced by patching classes in the MRO of a Django View class (#1625).

0.35.1 (25/08/2020)

reintroduce wrapt for patching Django view methods. (#1622)

0.35.0 (13/03/2020)

Upgrading to 0.35.0

This release adds:

A Python profiler
New hook registry for patching on import
botocore support for RequestId
Support aiobotocore>=0.11.0
Support rediscluster==2.0.0
Documentation for uWSGI
Python 3.8 support

Changes

Core

internal: Add import patching and import hook registry (#981)
core: Add logs injection setting to Config (#1258)

Integrations

fix(aiobotocore): add support for aiobotocore>=0.11.0 (#1268)
botocore - support tag for AWS RequestId (#1248 -- thanks @someboredkiddo)
rediscluster: Add support for v2.0.0 (#1225)
Use DATADOG_SERVICE_NAME as default tornado name (#1257 -- thanks @zhammer)

Profiler

Import profiling library (#1203)

Documentation

Django is automatically instrumented now (#1269 -- thanks @awiddersheim)
docs: basic uWSGI section (#1251 -- thanks @MikeTarkington)
fix doc for migrate from ddtrace<=0.33.0 (#1236 -- thanks @martbln)

Testing and tooling

ci: use medium resource class (#1266)
fix(ci): use machine executor for deploy jobs (#1261, #1265)
ci: improve tooling for building and pushing wheels (#1256, #1254, #1253, #1252)
fix: local docs (#1250)
chore(ci): use system Python version for flake8 and black target #1245)
ci(tox): leverage tox factor to simplify setenv directives (#1244)
fix(ci): remove virtualenv<20 limitation (#1242)
refactor: use tox flavor to specify Celery usedevelop setting (#1238)
ci: make sure we install cython for deploy_dev (#1232)
ci: requires virtualenv < 20 (#1228)
fix(tests): do not use numeric value for errno (#1226)
fix(docs): s3 deploy requires rebuild of docs (#1223)
fix(tests): use encoder decode in tests (#1221)
fix(encoding): always return bytes when decoding (#1220)
fix(tox): do not skip install for docs (#1218)
add Python 3.8 support (#1098)

Changeset

Read the full changeset.

0.34.2 (25/08/2020)

Fix for an issue introduced by patching classes in the MRO of a Django View class (#1625).

0.34.1 (09/03/2020)

Changes

This patch release addresses issues with the new Django integration introduced in 0.34.0:

fix(django): handle disallowed hosts (#1235)
fix(django): patch staticmethods in views (#1246)
docs(django): enabling automatically and manually (#1249)

Changeset

Read the full changeset.

0.34.0 (21/02/2020)

Upgrading to 0.34.0

This release adds a new integration for Django. The goal of this effort was to make the Django integration more consistent with our other integrations, simplifying configuration and patching. See the Django documentation for details on how to get started with the integration. For existing Django applications, be sure to consult the migration section of the documentation.

While we are now vendoring psutil, msgpack will no longer be vendored and instead specified as a requirement.

Finally, improvements have been made to the testing and continuous integration.

Changes

Core

Unvendor msgpack (#1199, #1216, #1202)
Vendor psutil (#1160)
Update get_env to support any number of parts (#1208)
Set _dd.measured tag on integration spans (#1196)
Start writer thread as late as possible (#1193)
Refactor setup.py c-extension building (#1191)

Integrations

New Django Integration (#1161, #1197)

Testing and tooling

CircleCI updates (#1213, #1212, #1210, #1209)
Tox updates (#1214, #1207, #1206, #1205, #1204, #1201, #1200)
Black updates (#1190, #1188, #1187, #1185)
Fix botocore tests on py3.4 (#1189)

Changeset

Read the full changeset.

0.33.0 (23/01/2020)

Upgrading to 0.33.0

This release introduces setting numeric tags as metrics, addresses a regression in Python 3 performance, and introduces a dual license.

Changes

Core

Prefer random.getrandbits on Python 3+, fall back to urandom implementation on 2 (#1183 -- thanks @thieman)
Set numeric tags on Span.metrics instead of Span.meta (#1169, #1182)
Update default sampler to new DatadogSampler (#1172, #1166)
Safely deprecate ext type constants (#1165)

Tooling

Fix botocore tests (#1177)

Documentation

Add Dual License (#1181)
Improve tracer.trace docs (#1180 -- thanks @adamchainz)

0.32.1 (09/01/2020)

Changes

This patch release addresses an issue with installation:

use environment markers for install requirements (#1174 -- thanks @JBKahn, #1175)

Changeset

Read the full changeset.

0.32.2 (10/01/2020)

Changes

This patch release addresses an issue with installation:

add funcsigs backport to install (#1176)

Changeset

Read the full changeset.

0.32.0 (08/01/2020)

Upgrading to 0.32.0

This release adds support for dogpile.cache, fixes an issue with the bottle integration, addresses issues with CI, and makes several improvements to the core library.

Changes

Core

Deprecating app type (#1144, #1162)
Refactor span types (#1150)
Use debtcollector (#1152, #1147)
Change DatadogSampler defaults (#1151)
Initial black formatting (#1137, #1141)
Health metrics improvements (#1135, #1134, #1131)

Integrations

Add support for dogpile.cache (#1123 -- thanks @goodspark)

Bug fixes

Bottle: fix status code for error responses (#1158)

Tooling

Improve flake8 checks (#1132)
Pin multidict dependency for aiobotocore02 tests (#1145 -- thanks @codeboten)
Fixing sqlalchemy test failures (#1138 -- thanks @codeboten)
Remove unneeded tox dependencies (#1124)

0.31.0 (15/11/2019)

Upgrading to 0.31.0

This release addresses issues with the gRPC, Celery, Elasticsearch integrations. In addition, there are internal improvements to how timing for spans is being handled.

Changes

Integrations

celery: use strongrefs for celery signals (#1122) fixes #1011
elasticsearch: Add support for elasticsearch6 module (#1089)
grpc: improve handling exceptions (#1117, #1119) and use callbacks to avoid waits (#1097)
opentracing: fix for compatibility tags (#1096 -- thanks @marshallbrekka)

Core and Internal

core: replace time.time by monotonic clock (#1109)
core: rewrite agent writer on new process (#1106)
core: add support for dogstatsd unix socket (#1101)
core: always set rate limit metric (#1060)
internal: fix setting analytics sample rate of None (#1120)
internal: initial work on tracer health metrics (#1130, #1129, #1127, #1125)
internal: use args for LogRecord when logging (#1116 -- thanks @karolinepauls)
span: use ns time (#1113, #1112, #1105, #964)
tracer: allow to override agent URL with a env var (#1054)

Documentation

docs: add a GitHub issue template (#1118)
Remove extra import from tracer get_call_context code snippet (#1041)

Read the full changeset and the release milestone.

0.30.2 (21/10/2019)

Changes

This bug fix release introduces a fix for the agent writer that would cause traces to not be successfully flushed when the process forks.

Whenever we detect that we are in a new process (os.getpid() changes) we create a new queue to push finished traces into for flushing. In the previous version of the tracer (v0.29.x) we would also recreate the background thread that would read from this queue to ensure that we 1) had one background worker per-process and 2) had an updated reference to the new queue we created.

In the process of simplifying the code for the agent writer in v0.30.0 we kept the code to recreate the queue, but didn't fully replicate the behavior for recreating the background thread. This meant that whenever the process was forked the background thread would maintain a reference to the old queue object and therefore be unable to pull traces from the queue we were pushing them into causing traces to get stuck in memory in the new queue (since no one was pulling from it).

With these changes we are recreating the entire background worker whenever the process is forked. This will cause us to once again create a new queue and new background thread for flushing finished traces.

Core and Internal

core: rewrite agent writer on new process (#1106)
grpc: use callbacks to avoid waits (#1097)

Changeset

Read the full changeset.

0.30.1 (11/10/2019)

Changes

Core and Internal

writer: disable excepthook metric by default (#1095)
writer: send statistics less often and disable by default (#1094)

Changeset

Read the full changeset and the release milestone.

0.30.0 (11/10/2019)

Upgrading to 0.30.0

In addition to resolving several integration related issues, this release improves critical core components for tracing and runtime metrics.

Changes

Core and Internal

core: ensure we cast sample rate to a float (#1072)
core: add https support (#1055 -- thanks @raylu)
core: tag sampling decision (#1045)
internal: allow to ignore certain field when computing object size (#1087)
internal: enable rediscluster by default (#1084)
internal: remove unused slot (#1081)
internal: fix iteration on slot class if attribute is unset (#1080)
internal: add platform tags as default for runtime metrics (#1078)
internal: add rate limit effective sample rate (#1046)
runtime: add lang and tracer_version tags to runtime metrics (#1069)
runtime: flush writer stats to dogstatsd (#1068)
runtime: fix gc0 test (#1067)
runtime: batch statsd flushes (#1063)
runtime: add tracer env tag to runtime metrics (#1051)
tracer: fix configure(collect_metrics) argument (#1066)
tracer: count the number of unhandled exception via dogstatsd (#1077)
tracer: grab the env tag from the tags, not a special var (#1070)
tracer: expose finished attribute (#1058)
tracer: remove tracer property function (#1042)
writer: add memory size statistics to the queue (#1071)
writer: add statistics to Q (#1065)

Integrations

aiohttp: handle 5XX responses as errors (#1082)
bottle: handle 5XX responses as errors (#1083)
cassandra: handle batched bound statements in python3 (#1062 -- thanks @jdost)
consul: add instrumentation for consul (#1048 -- thanks @phil-dd)
consul: use consistent span name (#1053 -- thanks @phil-dd)
grpc: fix channel interceptors (#1050)
httplib: make docs consistent with implementation (#1049)
tornado: code snippet fix in documentation (#1047)

Changeset

Read the full changeset and the release milestone.

0.29.0 (05/09/2019)

Upgrading to 0.29.0

This release introduces a new contextvars-based context manager in Python 3.7 and adds support for Tornado 5 and 6 with Python 3.7. In addition, the release includes several updates for our Django integration.

Changes

Core

[internal] Add generic rate limiter (#1029) [internal] Add support for contextvars to tracer in py37 (#990) [internal] Vendor monotonic package (#1026) [dev] Update span test utils (#1028) [dev] Allow extra args to scripts/run-tox-scenario (#1027) [dev] Remove unused circle env vars for release (#1016)

Integrations

[tornado] minor documentation fix (#1038) [tornado] document overriding on_finish and log_exception (#1037) [tornado] Add support for Tornado 5 and 6 with Python 3.7 (#1034) [pymongo] Add support for PyMongo 3.9 (#1023) [django] enable distributed tracing by default (#1031) [django] Create test for empty middleware (#1022 -- thanks @ryanwilsonperkin) [django] Patch DBs in django app config (#1019 -- thanks @JBKahn) [django] Setup pytest-django (#995)

Read the full changeset and the release milestone.

0.28.0 (16/08/2019)

Upgrading to 0.28.0

This release introduces container tagging and adds support for gRPC server.

Changes

Integrations

[grpc] Add support for GRPC server (#960)
[django] Only set sample rate if rate is set (#1009)
[django] Update how we get the http.url (#1010)
[django] Improve Django docs (#1002 -- thanks @adamchainz)
[pylibmc] Fix client when tracer is disabled (#1004)

Core

[core] Parse and send container id with payloads to the agent (#1007)
[internal] Change log from exception to debug (#1013)
documentation bugfix (#1017)
Add back release:wheel (#1015)
[tests] Adding in helpful default packages (#1008)
[dev] Map .git into ddtest for setuptools_scm (#1006)
Use setuptools_scm to handle version numbers (#999)
Use Python 3 for test_build job (#994)
writer: fix deprecated log.warn use (#993 -- thanks @deterralba)
Upload wheels on release (#989)

Read the full changeset and the release milestone.

0.27.1 (25/07/2019)

Upgrading to 0.27.1

This patch release includes performance fix which is highly recommended for anyone currently using 0.27.0.

Changes

0.27 Performance Fix #1000

Read the full changeset

0.27.0 (12/07/2019)

Upgrading to 0.27.0

This release introduces improvements to the trace writer. In addition, the release fixes some issues with integrations.

Changes

Core

api: implement str (#980)
API: add Unix Domain Socket connection support (#975)
[core] Remove references to runtime-id (#971)
sampler: rewrite RateByServiceSampler without using Lock (#959)
Handle HTTP timeout in API writer (#955)
payload: raise PayloadFull on full payload (#941)

Integrations

[pymongo] Support newer msg requests (#985)
pymongo: Add missing 2013 opcode (#961)
Refs #983 - Make AIOTracedCursor an async generator (#984 -- thanks @ewjoachim)
Fix a typo in AIOTracedCursor docstring (#982 -- thanks @ewjoachim)
[sqlalchemy] Only set sample rate if configured (#978)

Documentation

LICENSE: Fix copyright holder notice (#977 -- thanks @underyx)

Read the full changeset and the release milestone.

0.26.0 (05/06/2019)

Upgrading to 0.26.0

This release introduces several core improvements and continues addressing pain points in our tooling and testing.

Changes

Core

Add a PeriodicWorker base class for periodic tasks (#934)
Fix runtime workers not flushing to Dogstatsd (#939)
api: simplify _put codepath (#956)
make psutil requirement more accurate (#949 -- thanks @chrono)
writer: log a message when a trace is dropped (#942)
span: use system random source to generate span id (#940)
[core] Add config to set hostname tag on trace root span (#938)

Integrations

Support keyword 'target' parameter when wrapping GRPC channels (#946 -- thanks @asnr)
Record HTTP status code correctly when using abort() with Bottle (#943 -- thanks @equake)
boto: add support for Python 3.5+ (#930)

Documentation

fix documentation for current_root_span (#950 -- thanks @chrono)

Tooling

Run flake8 with Python 3 (#957)
tox: fix ignore path for integrations (#954)
Remove mention of -dev branch in CircleCI (#931)

Testing

[tests] Add benchmarks (#952)
[tests] increase deviation for sampler by service test (#948)
[tests] Fix thread synchronization (#947)
[tests] fix brittle deviation test for tracer (#945)
[tests] fix threading synchronization to opentracer test (#944
[pyramid] Fix dotted name for autopatched config test (#932)
tests: always skip sdist, use develop mode (#928)

Read the full changeset and the release milestone.

0.25.0 (07/05/2019)

Upgrading to 0.25.0

This release includes several core improvements and addresses pain points in our testing/CI. The release also adds a new integration for Algolia Search.

Changes

Improvements

Type cast port number to avoid surprise unicode type (#892 -- thanks @tancnle)
Add support for Python 3.7 (#864)
[writer] Enhance Q implementation with a wait based one (#862)
[core] Add Span 'manual.keep' and 'manual.drop' tag support (#849)
[core] Vendor msgpack dependency (#848)
Fix http.url tag inconsistency (#899)
aiohttp: do not set query string in http.url tag (#923)
tornado: do not include query string in the http.url tag (#922)
bottle: fix query string embedded in URL (#921)
django: remove query string from http.url tag (#920)

Integrations

Implement algolia search (#894)

Tooling

[dev/tooling] Enforce single quote strings (#884)
[tests] Leverage tox environment listing to simplify CircleCI tox target list (#882)

Testing

tests/tornado: enhance test_concurrent_requests (#915)
doc: disable fixed sidebar (#906)
[opentracer] Refactor time usage (#902)
[opentracer] Fix flaky test based on sleep (#901)
[internal] Add and use RuntimeWorker.join() to remove race condition in testing (#887)

0.24.0 (15/04/2019)

Upgrading to 0.24.0

This release introduces a new feature (disabled by default), supports new versions of integrations and improves our testing and tooling.

Changes

Improvements

[core] Enable requests integration by default (#879)
[core] Fix logging with unset DATADOG_PATCH_MODULES (#872)
[core] Use DEBUG log level for RateSampler initialization (#861 -- thanks @bmurphey)
[core] Guard against when there is no current call context (#852)
[core] Collect run-time metrics (#819)

Integrations

[mysql] Remove mysql-connector 2.1 support (#866)
[aiobotocore] Add support for versions up to 0.10.0 (#865)

Tooling

[dev/tooling] Update flake8 to 3.7 branch (#856)
[dev/tooling] Add script to build wheels (#853)
[ci] Use tox.ini checksum to update cache (#850)

Testing

[tests] Use a macro to persist result to workspace in CircleCI (#880)
[tests] add psycopg2 2.8 support (#878)
[aiohttp] Fix race condition in testing (#877)
[docs] Remove confusing testing instructions from README (#874)
[tests] Add support for aiohttp up to 3.5 (#873)
Remove useless future imports (#871)
[testing] Remove nose usage (#870)
[tests] Add support for pytest4 (#869)
[tests] Add testing for Celery 4.3 (#868)
[tests] Enable integration tests in docker-compose environment (#863)
[tests] Do not test celery 4.2 with Kombu 4.4 (#858)
[tests] Fix ddtrace sitecustomize negative test (#857)
[tests] Use spotify cassandra image for tests (#855)
[tests] Fix requests gevent tests (#854)

0.23.0 (19/03/2019)

Upgrading to 0.23.0

With this release we are introducing a new configuration system across integrations to generate APM events for Trace Search & Analytics. The other core changes are the beginnings of a new approach to address issues with tracer loads and improve debugging.

Changes

Improvements

Trace search client configuration (#828)
[core] fix wrapt wrappers sources (#836)
[core] Add Payload class helper (#834)
[internal] Add rate limited logger (#822)

Bugs

Fix for broken celery tests (#839 -- thanks @JackWink)

Read the full changeset and the release milestone.

0.22.0 (01/03/2019)

Upgrading to 0.22.0

This release contains a few improvements for not marking a Celery task as an error if it is an expected and allowed exception, for propagating synthetics origin header, and to vendor our six and wrapt dependencies.

Changes

Improvements

[celery] Don't mark expected failures as errors (#820 -- thanks @sciyoshi)
[core] Propagate x-datadog-origin (#821)
[core] vendor wrapt and six dependencies (#755)

Read the full changeset and the release milestone.

0.21.1 (21/02/2019)

Upgrading to 0.21.1

This is a bug fix release that requires no changes to your code.

Included in this release is a fix for some database cursors where we would force Cursor.execute and Cursor.executemany to return a cursor instead of the originally intended output. This caused an issue specifically with MySQL libraries which tried to return the row count and we were returning a cursor instead.

Changes

Bugs

[core] Patch logging earlier for ddtrace-run (#832)
[dbapi2] Fix dbapi2 execute/executemany return value (#830 )
[core] Use case-insensitive comparison of header names during extract (#826 -- thanks @defanator)

Read the full changeset and the release milestone.

0.21.0 (19/02/2019)

Upgrading to 0.21.0

With this release we are moving distributed tracing settings to be enabled by default. This change means that you no longer need to explicitly enable distributed tracing for any integration.

Changes

Improvements

Enable distributed tracing by default (#818)
- aiohttp
- bottle
- flask
- molten
- pylons
- pyramid
- requests
- tornado
[testing] Ensure consistent use of override_config and override_env (#815)
[core] Break up ddtrace.settings into sub-modules (#814)
[tests] Simplify elasticsearch CI test commands (#813)
[core] Remove sending of service info (#811)
[core] Add import hook module (#769)

Read the full changeset and the release milestone.

0.20.4 (08/02/2019)

Upgrading to 0.20.4

This is a bug fix release, no code changes are required.

In this release we have fixed a bug that caused some configuration values to not get updated when set.

Changes

Bug fixes

[bug] Integration config keys not being updated (#816)

Read the full changeset and the release milestone.

0.20.3 (04/02/2019)

Upgrading to 0.20.3

This is a bug fix release that requires no changes.

This release includes a fix for context propagation with futures. Under the right conditions we could incorrectly share a trace context between multiple futures threads which result in multiple traces being joined together in one.

Changes

Bug fixes

[core] Allow futures to skip creating new context if one doesn't exist (#806)

Read the full changeset and the release milestone.

0.20.2 (29/01/2019)

Upgrading to 0.20.2

No changes are needed to upgrade to 0.20.2.

This big fix release includes changes to ensure we properly read the HTTP response body from the trace agent before we close the HTTP connection.

Changes

Bug fixes

[core] Call HTTPResponse.read() before HTTPConnection.close() (#800)

Improvements

[tests] limit grpcio version to >=1.8.0,<1.18.0 (#802)
[tools] Add confirmation to 'rake pypi:release' task (#791 )

Read the full changeset and the release milestone.

0.20.1 (17/01/2019)

Upgrading to 0.20.1

No changes are needed to upgrade

Changes

Bug fixes

[celery] Ensure celery.run span is closed when task is retried (#787)

Read the full changeset and the release milestone.

0.20.0 (09/01/2019)

Upgrading to 0.20.0

We have added support for logs injection to the tracer. If you are already using ddtrace-run, the integration can be enabled with setting the environment variable DD_LOGS_INJECTION=true. The default behavior once logs injection is enabled is to have trace information inserted into all log entries. If you prefer more customization, you can manually instrument and configure a log formatter with the tracer information.

Changes

New Integrations

[mako] Add Mako integration (#779 -- thanks @wklken)

Enhancements

[core] Tracer and logs integration (#777)

Read the full changeset and the release milestone.

0.19.0 (28/12/2018)

Upgrading to 0.19.0

With 0.19.0 we have decided to disable the tracing of dbapi2 fetchone()/fetchmany()/fetchall() methods by default.

This change effects all integrations which rely on the dbapi2 API, including psycopg2, mysql, mysqldb, pymysql, and sqlite3.

We have introduced this change to reduce the noise added to traces from having these methods (mostly fetchone()) traced by default.

With fetchone() enabled the traces received can get very large for large result sets, the resulting traces either become difficult to read or become too large causing issues when flushing to the trace agent, potentially causing traces to be dropped.

To re-enable the tracing of these methods you can either configure via the environment variable DD_DBAPI2_TRACE_FETCH_METHODS=true or manually via:

from ddtrace import config
config.dbapi2.trace_fetch_methods = True

Changes

Bugs

[dbapi2] disable fetchone/fetchmany/fetchall tracing by default (#780) [opentracing] Fixing context provider imports for scope manager (#771 -- thanks @Maximilien-R)

Enhancements

[tests] test python setup.py sdist and twine check on build (#782) [core] Add API to configure Trace Search (#781) [core] Enable priority sampling by default (#774)

Read the full changeset and the release milestone.

0.18.0 (12/12/2018)

New Integrations

[molten] Add molten support (#685)

Bug Fixes

[aws] Blacklist arguments stored as tags (#761)
[psycopg2] Fix composable query tracing (#736)

Improvements

[aiohttp] Add HTTP method to the root span resource (#652 -- thanks @k4nar)
[aws]Flatten span tag names (#768)
[opentracer] Set global tags (#764)
[core] add six and replace custom compat functions (#751)
[config] make IntegrationConfig an AttrDict (#742)
[tests] remove unused monkey.py test file (#760)
[tests] fix linting in test files (#752)
[psycopg2] fix linting issues (#749)
[tests] have most tests use pytest test runner (#748)
[tests] Provide default implementation of patch test methods (#747)
[tests] run flake8 on all test files (#745)
[tests] Add patch mixin and base test case (#721)
[tests] Add Subprocess TestCase (#720)

Read the full changeset and the release milestone.

0.17.1 (05/12/2018)

This release includes the removal of service sending, this should resolve many of the 400s that are being returned from the Agent resulting in an unfriendly ERROR message and giving the impression that the tracer is failing. (#757)

Improvements

[core] Make writing services a no-op (#735)
[tests] upgrade flake8 to 3.5.0 (#743)
remove flake8 ignores and fix issues (#744)

Read the full changeset and the release milestone.

0.17.0 (28/11/2018)

New features

[redis] add support for redis 3.0.0 (#716)
[core] Allow DD_AGENT_HOST and DD_TRACE_AGENT_PORT env variables (#708)
[core] Add global tracer tags (#702)
[core] Trace http headers (#647)

Improvements

[docs] add Flask configuration documentation (#734)
Add long_description to setup.py (#728)
[tests] pin version of redis-py-cluster for 'tox -e wait' (#725)
[requests] Add another split_by_domain test (#713)
[docs] Add kombu references (#711)
[ci] Use small circleci resource class for all jobs (#710)
[requests] patch Session.send instead of Session.request (#707)
[ci] reorganize CircleCI workflows (#705)
[elasticsearch] add support for elasticsearch{1,2,5} packages (#701)
[tests] add base test case classes and rewrite tracer tests (#689)
[dbapi] Trace db fetch and session methods (#664)

Bugfixes

[elasticsearch] add alias for default _perform_request (#737)
[tests] Pin pytest to 3.x.x and redis to 2.10.x for rediscluster (#727)
[django] Use a set instead of list for cache_backends to avoid duplicates (#726 -- thanks @wenbochang)
[tests] fix broken redis check (#722)
[docs] Fix broken flask link (#712)
[mongodb] Fix pymongo query metadata (#706)

Read the full changeset and the release milestone.

0.16.0 (13/11/2018)

New Integrations

[jinja2] Add jinja2 integration (#649 -- thanks @mgu)
[kombu] add Kombu integration (#515 -- thanks @tebriel)
[grpc] Add grpc client support. (#641)
[gevent] Support gevent 1.3 (#663)
[flask] rewrite Flask integration (#667)

Bug Fixes

[mysqldb] Fix mysqldb monkey patch (#623 -- thanks @benjamin-lim)
[requests] exclude basic auth from service name (#646 -- thanks @snopoke)

Improvements

[core] Add IntegrationConfig helper class (#684)
[core] add support for integration span hooks (#679)
[httplib, requests] Sanitize urls in span metadata (#688)
[tests] ensure we are running tests.contrib.test_utils (#678)
[celery] [bottle] Add span type information for celery and bottle. (#636)
[ci] Reorganize autopatch test calls (#670)
[core] initial support for partial flushes (#668)
[django] Remove query from django db span's tag sql.query (#659)
[tests] Make CI faster by disabling dist and install in autopatching tests (#654)
[core] Trace http headers (#647)
[django] Infer span resource name when internal error handler is used (#645)
[elasticsearch] Make constant organization consistent with other integrations (#628)

Read the full changeset and the release milestone.

0.15.0 (16/10/2018)

New integrations

Add rediscluster integration (#533, #637)
Add Vertica Integration (#634)

Bug fixes

[django] Fix minimum Django version for user.is_authenticated property (#626 -- thanks @browniebroke)

Improvements

[celery] Add retry reason metadata to spans (#630)
[core] Update config to allow configuration before patching (#650)
[core] Add Tracer API to retrieve the root Span (#625)
[core] Fixed HTTPConnection leaking (#542 -- thanks @mackeyja92)
[django] Allow Django cache to be seen as a different service. (#629)
[gevent] Patch modules on first import (#632)
[gevent] Add support for gevent.pool.Pool and gevent.pool.Group (#600)
[redis] Removed unused tag (#627)
[requests] Patch modules on first import (#632)
[tests] Add Span.span_type tests (#633)
[tests] Update the integrations libraries versions to the latest possible. (#607)
[tests] CircleCI run tests in the new alpine-based test runner (#638)
[tests] Add test cases for API._put (#640)
[tests] Skip flaky TestWorkers.test_worker_multiple_traces test case (#643)
[tests] Remove tests for not supported gevent 1.3 (#644)

Read the full changeset and the release milestone.

0.14.1 (25/09/2018)

Bug fixes

[opentracer] Activate span context on extract (#606, #608)
[opentracer] Fix "does not provide the extra opentracing" (#611, #616)

Improvements

[docs] Clarify debug mode (#610)
[docs] Fix docstring for Tracer.set_tags (#612 -- thanks @goodspark)
[docs] Add priority sampling to ddtrace-run usage (#621)
[circleci] Imrpve python docs deployment strategy (#615)
[tests] Refactor tox.ini file (#609)
[tests] Improve performance of tests execution (#605)

Read the full changeset and the release milestone.

0.14.0 (11/09/2018)

OpenTracing

In this release we are happy to introduce the beta for the long-awaited OpenTracing compatible API layer for ddtrace!

Support for opentracing>=2.0.0 is provided in this release. Namely, the following are supported:

start_span/start_active_span
inject and extract functionality
baggage, through set_baggage_item and get_baggage_item
compatible tags from the OpenTracing specification
scope manager support
seamless integration with the Datadog tracer when using ddtrace-run

For setup information and usage see our docs for the Datadog OpenTracing tracer.

CI Improvements

Also included in this release are some optimizations to our CI which should get things running a bit quicker.

Thanks @labbati!

Read the full changeset and the release milestone.

0.13.1 (04/09/2018)

Bug fixes

[core] remove the root logger configuration within the library (#556)

Read the full changeset and the release milestone.

0.13.0 (23/08/2018)

New integrations

pymemcache integration (#511)

Celery integration

Due to some limitations with our Celery integration, we changed our instrumentation to a signals based approach. We also started using import hooks to instrument Celery, so that enabling the instrumentation doesn't trigger a celery import.

Signals implementation: #530
Moving to import hooks: #534
Resolved issues: #357, #493, #495, #495, #510, #370

Breaking changes Using the signal based approach increase the stability of our instrumentation, but it limits what is currently traced. This is a list of changes that are considered breaking changes in the behavior and not in the API, so no changes are needed in your code unless you want a different behavior:

By default all tasks will be traced if they use the Celery signals API, so tasks invoked with methods like apply(), apply_async() and delay() will be traced but tasks invoked with run() will not be traced.
patch_task() is deprecated; if it's used, all tasks will be instrumented

Bug fixes

[core] check if bootstrap dir is in path before removal (#516 -- thanks @beezz!)
[core] have hostname default to DATADOG_TRACE_AGENT_HOSTNAME environment variable if available (#509, #524 -- thanks @hfern!)
[core] add WSGI-style http headers support to HTTP propagator (#456, #522)
[core] Enable buffering on getresponse (#464, #527)
[core] configure the root logger (#536)
[aiopg] set the app_type during initialization (#492, #507)
[boto] default to None if no region (#525, #526)
[flask] avoid double instrumentation when TraceMiddleware is used (#538)
[pymongo] fix multiple host kwargs (#535)
[tornado] make settings object accessible during configuration (#499, #498 -- thanks @kave!)

Improvements

[core/helpers] add a shortcut to retrieve Trace correlation identifiers (#488)

Read the full changeset and the release milestone.

0.12.1 (14/06/2018)

Bugfixes

[celery] add support for celery v1 tasks (old-style tasks) (#465, #423)
[celery] ddtrace-run broke third-party script support; now it handles correctly the argv params (#469, #423)
[celery] patch TaskRegistry to support old-style task with ddtrace-run (#484)
[django] update error handling if another middleware has handled the exception already (#418, #462)
[django] DatabaseWrapper loaded in right thread, after removing setting_changed signal from the DatadogSettings (#481, #435)
[django/celery] add shared_task decorator wrapper to trace properly Celery tasks (#486, #451)
[django/docs] notes about Debug Mode, and debugging (#476 -- thanks @ndkv!)
[gevent] pass sampling_priority field when Distributed Tracing is enabled (#457)
[mysqlb] add missing services info when they're flushed (#468, #428)
[psycopg2] properly patch the driver when quote_ident typing is used (#477, #474, #383)
[pylons] ensure the middleware code is Python 3 compatible to avoid crashes on import (#475, #472)
[requests] add missing services info when they're flushed (#471, #428)

Read the full changeset and the release milestone.

0.12.0 (03/05/2018)

New integrations

[boto] Botocore and boto instrumentation is enabled by default using patch_all() (#319)
[futures] provide context propagation for concurrent module (#429, docs)
[mysql] add pymysql support (#296, docs -- thanks @wklken)

Improvements

[core] introducing a low-level API to define configurations for each integration. This API is used only by the requests module and will be implemented in other integrations in newer releases (#445, #443, #450, #454, #441)
[celery] split the service name in celery-producer and celery-worker for better stats (#432)
[falcon] add distributed tracing (#437)
[requests] provide a default service name for the request Span (#433)
[requests] add split_by_domain config to split service name by domain (#434)
[tornado] better compatibility using futures instrumentation (#431)

Bugfixes

[core] ensure sitecustomize.py is imported when ddtrace-run wrapper is used (#458)
[flask] use ddtrace logger instead of Flask to avoid having a custom log filter (#447, #455)

Breaking changes

[celery] the name of the service is now split in two different services: celery-producer and celery-worker. After the upgrade, you'll stop sending data to what was the default service name (celery). You should check the new services instead because you'll see a drop. Previously reported traces in the celery service, are still available if you move back the time selector.

Read the full changeset and the release milestone.

0.11.1 (30/03/2018)

Improvements

[bottle] use the route argument in TracePlugin, to support Bottle 0.11.x (#439)

Bugfixes

[django] gunicorn gevent worker wasn't instrumenting database connections (#442)
[django] remove MIDDLEWARE_CLASSES deprecation warning from tests (#444)
[django] ensure only MIDDLEWARE or MIDDLEWARE_CLASSES are loaded with tracing middlewares (#446)

Read the full changeset and the release milestone.

0.11.0 (05/03/2018)

Security fixes

[dbapi] remove sql.query tag from SQL spans, so that the content is properly obfuscated in the Agent. This security fix is required to prevent wrong data collection of reported SQL queries. This issue impacts only MySQL integrations and NOT psycopg2 or sqlalchemy while using the PostgreSQL driver. (#421)

New integrations

[django] add support for Django 2.0 (#415 -- thanks @sciyoshi!)
[mysql] MySQL-python and mysqlclient packages are currently supported (#376 -- thanks @yoichi!)
[psycopg2] add support for version 2.4 (#424)
[pylons] Pylons >= 0.9.6 is officially supported (#416)

Bugfixes

[core] ddtrace-run script accepts DATADOG_PRIORITY_SAMPLING to enable Priority Sampling (#426)
[pylons] add distributed tracing via kwarg and environment variable (#425, docs)
[pylons] ddtrace-run script can patch a PylonsApp (#416)
[pylons] add tracing to Pylons render function (#420)

Read the full changeset and 0.11.0 milestone.

0.10.1 (05/02/2018)

Distributed Tracing Add distributed tracing using integration settings for the following libraries/frameworks:

bottle (#382)
requests (#372)
pyramid (#403)

Improvements

[core] provide constants to pick Priority Sampling values (#391)
[django] add support for Django Rest Framework (#389)
[tooling] add missing classifiers for pypi (#395 -- thanks @PCManticore)
[tornado] patch concurrent.futures if available, improving the way traces are built when propagation happens between threads (#362 -- thanks @codywilbourn)

Bugfixes

[httplib] don't overwrite return value (#380 -- thanks @yoichi)
[psycopg2] patch all imports of register_type (#393 -- thanks @stj)
[pyramid] keep request as part of render kwargs (#384 -- thanks @joual)
[pyramid] use pyramid HTTPExceptions as valid response types (#401, #386 -- thanks @TylerLubeck)
[requests] add unpatch and double-patch protection (#404)
[flask] don't override code of already handled errors (#390, #409)
[flask] allow mutability of resource field within request (#353, #410)

Read the full changeset.

0.10.0 (08/11/2017)

Distributed Sampling (beta)

New feature that propagates the sampling priority across services. This is useful to mark traces as "don’t keep the trace" or "must have" when distributed tracing is used. This new functionality requires at least the Datadog Agent 5.19+. Frameworks with out-of-the-box support are: Django, Flask, Tornado (#358, #325, #359, #364, #366, #365, #371, docs)

Improvements

[core] update the Context propagation API, that includes a new way to retrieve and set the current active Span context. (#339)
[core] implement Propagators API to simplify Distributed Tracing. You can use HTTPPropagator class to inject and extract the tracing context in HTTP headers (#363, #374 docs)
[celery] use service name from DATADOG_SERVICE_NAME env var, if defined (#347 -- thanks @miketheman)
[django] respect env Agent host and port if defined (#354 -- thanks @spesnova)

Bugfixes

[pylons] handle exception with non standard 'code' attribute (#350)
[pyramid] the application was not traced when the tween list was explicitly specified (#349)

Read the full changeset

0.9.2 (12/09/2017)

New features

[django] disable database or cache instrumentation via settings so that each Django component instrumentation can be disabled (#314, docs -- thanks @mcanaves)
[django] it's not required anymore to add the Django middleware because the Django app ensures that it is installed. You can safely remove ddtrace.contrib.django.TraceMiddleware for your middleware list after the upgrade. This is not mandatory but suggested (#314, #346)
[cassandra] trace execute_async() operations (#333)

Bugfixes

[mysql] prevent the Pin from attaching empty tags (#327)
[django] fixed the initialization order to prevent logs when the tracer is disabled (#334)
[sqlite3] add tests to ensure that services are properly sent (#337)
[pyramid] fixed Pyramid crash when 'include()' is used with relative import paths (#342)
[pylons] re-raise the exception with the original traceback in case of errors. Before Pylons exceptions were correctly handled but hidden by the tracing middleware. (#317)
[pyramid] disable autocommit in Pyramid patching, to avoid altering the Configurator behavior (#343)
[flask] fix Flask instrumentation that didn't close Jinja spans if an error was thrown (#344)

Integration coverage

officially support ElasticSearch 1.6+ (#341)

Documentation

fixed usage examples for patch_all() and patch() (#321 -- thanks @gomlgs)
added a section about updating the hostname and port (#335)

Read the full changeset.

0.9.1 (01/08/2017)

New features

[core] add a processing pipeline to the AsyncWorker, so that traces can be filtered easily. This change doesn't have any performance impact with existing installations, and is expected to work well with async frameworks / libraries (#303, docs)
[core] add language and library version metadata to keep track of them in the Datadog Agent. All values are sent via headers (#289)

Bugfixes

[aiobotocore] update async with context manager so that it returns the wrapper instead of the wrapped object (#307)
[boto, botocore] change the service metadata app for AWS with a more meaningful name (#315)

Documentation

improving documentation so that it's more explicit how a framework should be auto-instrumented (#305, #308)
add the list of auto-instrumented modules (#306)

Read the full changeset.

0.9.0 (05/07/2017)

New features

[core] add process ID in root spans metadata (#293)

Improvements

[falcon] extended support for Falcon 1.2; improved error handling (#295)
[gevent] create a new Context when a Greenlet is created so that the tracing context is automatically propagated with the right parenting (#287)
[asyncio] providing helpers and patch() method to automatically propagate the tracing context between different asyncio tasks (#260 #297, docs -- thanks @thehesiod)
[aiohttp] add experimental feature to continue a trace from request headers (#259, docs -- thanks @thehesiod)
[django] add DEFAULT_DATABASE_PREFIX setting to append a prefix to database service (#291, docs -- thanks @jairhenrique)

Bugfixes

[logging] use specific logger instead of the root one in monkey.py module (#281)
[django] ddtrace exception middleware catches exceptions even if a custom middleware returns a Response object (#278)
[pylons] handle correctly the http status code when it's wrongly formatted (#284)
[django] request resource handles the case where the View is a partial function (#292)
[flask] attach stack trace to Flask errors (#302)

New integrations

[httplib] add patching for httplib and http.lib(#137 -- thanks @brettlangdon)
[aio-libs] add aiobotocore support (#257, #298, docs -- thanks @thehesiod)
[aio-libs] add aiopg support (#258, docs -- thanks @thehesiod)

Read the full changeset.

0.8.5 (30/05/2017)

Bugfixes

[flask] add the http method to flask spans (#274)
[sqlite3] changed the app_type to db (#276)
[core] span.set_traceback()now sets the traceback even if there's no exception (#277)

Read the full changeset.

---

0.8.4 (19/05/2017)

Bugfixes

[flask] avoid using weak references when Flask is instrumented via Blinker. This resolves initialization issues when the traced_app = TraceMiddleware(app, ...) reference goes out of the scope or is garbage collected (#273)

0.8.3 (15/05/2017)

Improvements

[transport] add presampler header (X-Datadog-Trace-Count) so that the receiving agent has more information when dealing with sampling (#254)
[docs] updated our documentation (#264, #271)

Bugfixes

[core] patch loader raises PatchException that is handled in the patch_all() when the patch failed. This distinguishes: errors during patch, when an integration is not available and simply when the module is not installed (#262)
[mysql] distinguish MySQL-Python instrumentation so that only mysql-connector package is patched; this provides better feedback about what library is supported (#263, #266)
[sqlalchemy] provide a patch() method that uses the PIN object; this is not a breaking change, but the preferred way to instrument SQLAlchemy is through patch_all(sqlalchemy=True) or patch(sqlalchemy=True) (#261)
[pylons] catch BaseException since a SystemExit might've been raised; 500 errors are handled if a timeout occurs (#267, #270)
[pyramid] catch BaseException since a SystemExit might've been raised; 500 errors are handled if a timeout occurs (#269)

Read the full changeset

---

0.8.2 (28/04/2017)

Bugfixes

[django] handle tuple INSTALLED_APPS for Django < 1.9 (#253)

Read the full changeset

---

0.8.1 (30/05/2017)

Bugfixes

[core] fixed msgpack-python kwarg usage for versions earlier than 0.4.x (#245)
[pyramid] add request method to Pyramid trace span resource name (#249, thanks @johnpkennedy)

Read the full changeset.

---

0.8.0 (10/04/2017)

New integrations

Add support for Tornado web 4.0+. Currently this integration is ignored by autopatching, but can be enabled via patch_all(tornado=True) (#204, docs -- thanks @ross for reviewing and testing the implementation)

Bugfixes

[docs] Minor updates to our documentation (#239, #237, #242, #244 -- thanks @liubin @pahaz)
[boto] Boto2 and Botocore integrations have safety check to prevent double patching (#240)
[boto] Use frames directly without calling getouterframes(). This is a major improvement that reduces the impact of our tracing calls for Boto2 (#243 -- thanks @wackywendell)
[django] make func_name work with any callable and not only with functions (#195, #203 -- thanks @m0n5t3r)

Breaking change

[elasticsearch] when importing elasticsearch before executing patch_all(), no traces are created. This patch changed where the PIN object is attached, so you should update your instrumentation as described below (#238)

Migrate from 0.7.x to 0.8.0

[elasticsearch] the PIN object was previously attached to the elasticsearch module while now it uses elasticsearch.Transport. If you were using the Pin to override some tracing settings, you must update your code from:

Pin.override(client, service='elasticsearch-traces')

to:

Pin.override(client.transport, service='elasticsearch-traces')

Internals update

the Python traces logs and returns error when there is a communication issue with the APM Agent (#173)
the wrap() tracer decorator can be extended by Python integrations when the usual approach is not suitable for the given execution context (#221)

Read the full changeset.

---

0.7.0 (29/03/2017)

New integrations

Add support for boto (>=2.29.0) and botocore (>= 1.4.51) #209 . Currently these integrations are ignored by autopatching, but can be enabled via patch_all(boto=True, botocore=True)

New features

Add the ddtrace-run command-line entrypoint to provide tracing without explicit additions to code. More information here http://pypi.datadoghq.com/trace/docs/#get-started #169

Bugfixes

[dbapi] Ensure cursors play well with context managers #231
[django] Provide a unique datadog_django app label to avoid clashes with existing app configs #235
[pyramid] Ensure pyramid spans have method and route metadata consistent with other web frameworks #220 (thanks @johnpkennedy)

0.6.0 (09/03/2017)

New integrations

Add support for asynchronous Python. This is a major improvement that adds support for asyncio, aiohttp and gevent (#161, docs: asyncio - aiohttp - gevent)
Add Celery integration (#135, #196, docs)

New features

Add explicit support for Python 3.5, and 3.6 (#215, see supported versions)
print the list of unfinished spans if the debug_logging is activated; useful in synchronous environments to detect unfinished/unreported traces (#210)

Bugfixes

[mysql] mysql integration is patched when using patch() or patch_all() (#178)
[django] set global tracer tags from Django DATADOG_TRACE setting (#159)
[bottle] wrong tracer reference when set_service_info is invoked (#199)

Breaking changes

Default port 7777 has been replaced with the new 8126 available from Datadog Agent 5.11.0 and above (#212)
Removed the ThreadLocalSpanBuffer. It has been fully replaced by the Context propagation (#211)

Migrate from 0.5.x to 0.6.0

Datadog Agent 5.11.0 or above is required.
If you're using the ThreadLocalSpanBuffer manually, you need to use the Context class in your logic so that it is compliant with the Context propagation. Check the Advanced usage section.

Advanced usage This is a list of new features that may be used for manual instrumentation when you're using a library or a framework that is not currently supported:

Use Context propagation instead of a global buffer. This plays well with asynchronous programming where a context switching may happen while handling different logical execution flows (#172)
tracer.trace() handles automatically the Context propagation and remains the preferable API
Add tracer.get_call_context() to retrieve the current Context instance that is holding the entire trace for this logical execution (docs)
Add start_span as a way to manually create spans, while handling the Context propagation (docs)

Read the full changeset.

---

0.5.5 (15/02/2017)

Improvements

ElasticSearch integration takes care of the returning status code in case of a TransportError (#175)

Bugfixes

Pyramid integration handles properly the Span.error attribute if the response is a server error (#176)

Read the full changeset.

0.5.4 (14/02/2017)

Integrations

added the Pyramid web framework

Enhancements

tracer.set_tags() will add tags to all spans created by a tracer.
span.tracer() will return the tracer that created a given span

Bug Fixes

correctly set service types on the Mongo and Falcon integrations.
documentation fixes
send less data to the agent in the SQL and redis integrations.

Read the full changeset

0.5.3 (23/12/2016)

Bugfixes

[ElasticSearch] use ElasticSearch serializer so that the serialization works with dates, decimals and UUIDs #131
[Django] use an integer value for AGENT_PORT because Django recast strings as unicode strings, which invalidate the input for getaddrinfo() in Python 2.7 #140
[Tracer] downgrade high throughput log messages to debug so that it doesn't flood users logs #143

Compatibility

don't check if django.contrib.auth is installed through the django.apps module. This improves the best-effort support for Django < 1.7 #136

Read the full changeset

0.5.2 (14/12/2016)

0.5.2 is a bugfix release.

Bug Fixes

include bottle docs

Read the full changeset.

0.5.1 (13/12/2016)

0.5.1 is a bugfix release.

Bug Fixes

properly trace pymongo $in queries (See #125)
properly normalize bound and batch cassandra statements (see #126)
made the legacy cassandra tracing a no-op.

Read the full changeset.

0.5.0 (07/12/2016)

Major changes

addedmsgpack-python as a dependency
using Trace Agent API v0.3 that supports both JSON and Msgpack formats
provided JSONEncoder and MsgpackEncoder that are switched at runtime the API v0.3 is not reachable (404)
MsgpackEncoder is the current default encoder
MsgpackEncoder will not be used if the pure Python implementation is used

Documentation

added ElasticSearch docs

Read the full changeset

0.4.0 (26/11/2016)

0.4.0 is a "major" release of the dd-trace-py. Please test thoroughly on staging before rolling out to your production clusters.

Enhancements

automatically patch contrib libraries with from ddtrace import monkey; monkey.patch_all(). A few notes:
- The previous ways of patching still exist, but are deprecated and might be no-ops. They will be removed in a future version.
- When you add patch_all remove your old instrumentation code.
- Web frameworks still require middleware.
experimental support for (much faster) msgpack serialization. disabled by default. will be enabled in a future release.

Integrations

add integration for the [Bottle](web framework) web framework. (see #86)

Bug Fixes

correctly trace django without auth middleware (see #116)

Read the full changeset.

v0.3.16 (03/11/2016)

Bugfixes

Handle memory leaks when tracing happens in a forked process (Issue #84)
Fix error code in spans from the request library (thanks @brettlangdon)
Better handling of unicode tags (thanks @brettlangdon)
Allow easy configuration of host & port in the Django integration.

Enhancements

Cap the number of traces buffered in memory.
Higher trace submission throughput.
Preliminary work on gevent support. Not fully complete.

Read the full changeset

v0.3.15 (01/11/2016)

Integrations

add tracing for the requests library

Read the full changeset

0.3.14 (30/09/2016)

Integrations

[pylons] allow users to set resources inside handlers
[django] add support for the Django cache framework

Enhancements

add a trace sampler so that users can discard spans using a RateSampler (more info: http://pypi.datadoghq.com/trace/docs/#sampling)

Read the full changeset

v0.3.13 (21/09/2016)

New integrations

added pylibmc Memcached client integration
improved Django integration providing a Django app that instrument Django internals

Read the full changeset

v0.3.12 (14/09/2016)

change set

Added MySQL integration, using mysql.connector v2.1

v0.3.11 (31/08/2016)

Bugfixes

fixed an unpacking error for elasticsearch>=2.4
fixed the behavior of the tracer.wrap() method; now it works as expected

Documentation

better organization of libraries usage on docs
provided a benchmark script

Read the full changeset

v0.3.10 (22/08/2016)

change set

add flask_cache integration; supporting the 0.12 and 0.13 versions
catch 500 errors on pylons integration

v0.3.9 (12/08/2016)

change set

send service info from the sqlalchemy integration

v0.3.7 (12/08/2016)

change set

Released Falcon Integration
Minor bugfixes in Redis & Cassandra integration

v0.3.8 (12/08/2016)

change set

Added support for the most recent bugfix versions of pymongo 3.0, 3.1 and 3.2

Files

CHANGELOG.md

Latest commit

History

CHANGELOG.md

File metadata and controls

Changelog

0.44.0+

0.43.0 (5/10/2020)

0.42.0 (14/09/2020)

0.41.2 (25/08/2020)

0.41.1 (25/08/2020)

0.41 (05/08/2020)

Changes

Full changeset

0.40.2 (25/08/2020)

0.40.1 (25/08/2020)

0.40 (17/07/2020)

Upgrading to 0.40.0

grpc

redis

httplib

Changes

Improvements

Bug fixes

Full changeset

0.39.2 (25/08/2020)

0.39.1 (25/08/2020)

0.39 (11/06/2020)

Deprecations

Integrations

Django

Elasticsearch

grpc

Tracer

Profiling

OpenTracing

Full Change set

Deprecations

Features

Fixes

Tests

0.38.4 (25/08/2020)

0.38.3 (25/08/2020)

0.38.2 (11/06/2020)

0.38.1 (28/05/2020)

0.38.1

0.38.0 (21/05/2020)

Upgrading to 0.38.0

Integrations

Celery

Django

Core

OpenTracing

Profiling

Tracer

Changes

New features

Improvements

Bug fixes

Documentation

Testing

0.37.3 (25/08/2020)

0.37.2 (25/08/2020)

0.37.1 (15/05/2020)

0.37.1

Fixes

0.37.0 (27/04/2020)

Upgrading to 0.37.0

Profiler

Changes

Bug fixes

Integrations

Core

Tests

0.36.3 (25/08/2020)

0.36.2 (25/08/2020)

0.36.1 (08/04/2020)

Changes

Changeset