1.4.0

Added

• gRPC: tag grpc.client.deadline (#2200)
• Implement telemetry, disable by default (#2153, #2233)

Changed

• Bump libdatadog dependency version (#2229)

Fixed

• Fix CI instrumentation configuration (#2219)

Read the full changeset and the release milestone.

1.3.0

Added

• Top-level span being tagged to avoid duplicate computation (#2138)

Changed

• ActiveSupport: Optionally disable tracing with Rails (@marcotc)
• Rack: Resource overwritten by nested application (#2180)
• Rake: Explicit task instrumentation to prevent memory bloat (#2174)
• Sidekiq and DelayedJob: Add spans to improve tracing (#2170)
• Drop Profiling support for Ruby 2.1 (#2140)
• Migrate libddprof dependency to libdatadog (#2061)

Fixed

• Fix OpenTracing propagation with TraceDigest (#2201)
• Fix SpanFilter dropping descendant spans (#2074)
• Redis: Fix Empty pipelined span being dropped (#757) (@sponomarev)
• Fix profiler not restarting on Process.daemon (#2150)
• Fix setting service from Rails configuration (#2118) (@agrobbin)
• Some document and development improvement (@marocchino) (@yukimurasawa)

Read the full changeset and the release milestone.

1.2.0

Added

• Add Postgres (pg gem) instrumentation (#2054) (@jennchenn)
• Add env var for debugging profiling native extension compilation issues (#2069)
• Teach Rest Client integration the :split_by_domain option (#2079) (@agrobbin)
• Allow passing request_queuing option to Rack through Rails tracer (#2082) (@KieranP)
• Add Utility to Collect Platform Information (#2097) (@jennchenn)
• Add convenient interface for getting and setting tags using [] and []= respectively (#2076) (@ioquatix)
• Add b3 metadata in grpc (#2110) (@henrich-m)

Changed

• Profiler now reports profiling data using the libddprof gem (#2059)
• Rename Kernel#at_fork_blocks monkey patch to Kernel#ddtrace_at_fork_blocks (#2070)
• Improved error message for enabling profiling when pkg-config system tool is not installed (#2134)

Fixed

• Prevent errors in action_controller integration when tracing is disabled (#2027) (@ahorner)
• Fix profiler not building on ruby-head (3.2) due to VM refactoring (#2066)
• Span and trace IDs should not be zero (#2113) (@albertvaka)
• Fix object_id usage as thread local key (#2096)
• Fix profiling not working on Heroku and AWS Elastic Beanstalk due to linking issues (#2125)

Read the full changeset and the release milestone.

1.1.0

Application Security Monitoring for Ruby has reached General Availability.

Information on how to enable security monitoring in your Ruby application can be found here. Further configuration is available here.

Added

• Application Security Monitoring
• Elasticsearch: v8.0 support (#1985)
• Sidekiq: Quantize args (#1972) (@dudo)
• Profiling: Add libddprof dependency to power the new Ruby profiler (#2028)
• Helper to easily enable core dumps (#2010)

Changed

• Support spaces in environment variable DD_TAGS (#2011)

Fixed

• Fix "circular require considered harmful" warnings (#1998)
• Logging: Change ddsource to a scalar value (#2022)
• Improve exception logging (#1992)

1.0.0

Upgrading

If you are using automatic instrumentation and mostly default configurations, you only need to update the version of ddtrace.

If you use custom instrumentation, additional configuration options, or have advanced usages, check out the upgrade guide for all upgrading details.

Highlights

This release brings semantic versioning to ddtrace.

There are countless improvements since v0.54.2. Many defaults that have been updated to facilitate the onboarding experience and clean up your configuration file.

For a comprehensive guide when upgrading from 0.x to 1.0, see: https://github.com/DataDog/dd-trace-rb/blob/master/docs/UpgradeGuide.md

A special thank you goes to our 136 contributors, most of them not members of Datadog! 🙇

Changes since v1.0.0.beta2

Added

• GraphQL 2.0 support (#1982)

Changed

• AppSec: Update libddwaf to 1.3.0 (#1981)

Fixed

• Rails log correlation (#1989) (@cwoodcox)
• Resource not inherited from lazily annotated spans (#1983)
• AppSec: Query address for libddwaf (#1990)

Refactored

• Docs: Add undocumented Rake option (#1980) (@ecdemis123)
• Improvements to test suite & CI (#1970, #1974, #1991)
• Improvements to documentation (#1984)

Read the full changeset and the release milestone.

1.0.0.beta2

For upgrading from 0.x to 1.0, see our upgrade guide: https://github.com/DataDog/dd-trace-rb/blob/master/docs/UpgradeGuide.md

Added

• Ruby 3.1 & 3.2 support (#1975, #1955)
• Trace tag API (#1959)

Changed

• Access to configuration settings is namespaced (#1922)
• AWS provides metrics by default (#1976) (@dudo)
• Update debase-ruby_core_source version (#1964)
• Profiling: Hide symbols/functions in native extension (#1968)
• Profiling: Renamed code_provenance.json to code-provenance.json (#1919)
• AppSec: Update libddwaf to v1.2.1 (#1942)
• AppSec: Update rulesets to v1.3.1 (#1965, #1961, #1937)
• AppSec: Avoid exception on missing ruleset file (#1948)
• AppSec: Env var consistency (#1938)

Fixed

• Rake instrumenting while disabled (#1940, #1945)
• Grape instrumenting while disabled (#1940, #1943)
• CI: require 'datadog/ci' not loading dependencies (#1911)
• CI: RSpec shared example file names (#1816) (@Drowze)
• General documentation improvements (#1958, #1933, #1927)
• Documentation fixes & improvements to 1.0 upgrade guide (#1956, #1973, #1939, #1914)

Removed

• OpenTelemetry extensions (Use OTLP instead) (#1917)

Refactored

• Agent settings resolver logic (#1930, #1931, #1932)

Read the full changeset and the release milestone.

1.0.0.beta1

See https://github.com/DataDog/dd-trace-rb/blob/v1.0.0.beta1/docs/UpgradeGuide.md.

Read the full changeset and the release milestone.

0.54.2

Changed

• Bump debase-ruby_core_source dependency version; also allow older versions to be used (#1798, #1829)
• Profiler: Reduce impact of reporting data in multi-process applications (#1807)
• Profiler: Update API used to report data to backend (#1820)

Fixed

• Gracefully handle installation on environments where Ruby JIT seems to be available but is actually broken (#1801)

Read the full changeset and the release milestone.

0.54.1

Fixed

• Skip building profiling native extension when Ruby has been compiled without JIT (#1774, #1776)

Read the full changeset and the release milestone.

0.54.0

Added

• MongoDB service name resolver when using multi cluster (#1423) (@skcc321)
• Service name override for ActiveJob in Rails configuration (#1703, #1770) (@hatstand)
• Profiler: Expose profile duration and start to the UI (#1709)
• Profiler: Gather CPU time without monkey patching Thread (#1735, #1740)
• Profiler: Link profiler samples to individual web requests (#1688)
• Profiler: Capture threads with empty backtrace (#1719)
• CI-App: Memoize environment tags to improve performance (#1762)
• CI-App: test.framework_version tag for rspec and cucumber (#1713)

Changed

• Set minimum version of dogstatsd-ruby 5 series to 5.3 (#1717)
• Use USER_KEEP/USER_REJECT for RuleSampler decisions (#1769)

Fixed

• "private method `ruby2_keywords' called" errors (#1712, #1714)
• Configuration warning when Agent port is a String (#1720)
• Ensure internal trace buffer respects its maximum size (#1715)
• Remove erroneous maximum resque version support (#1761)
• CI-App: Environment variables parsing precedence (#1745, #1763)
• CI-App: GitHub Metadata Extraction (#1771)
• Profiler: Missing thread id for natively created threads (#1718)
• Docs: Active Job integration example code (#1721) (@y-yagi)

Refactored

• Redis client patch to use prepend (#1743) (@justinhoward)

Read the full changeset and the release milestone.