Elastic.Apm.SqlClient

This release includes two breaking changes that have minimal impact.

• We removed support for target frameworks which have gone into end-of-life support by Microsoft. The impact should be minimal, however as we continue to support netstandard2.0 and netstandard2.1 where applicable.
• We removed the collection of GC metrics over ETW on .NET Full Framework. The collection over ETW requires elevated privileges, especially in IIS deployments. This runs counter to best practices. Since these are currently not displayed in the APM UI, while technically breaking, the impact should be minimal. The GC metric collection on modern .NET platforms is not impacted.

===== Breaking changes

• {pull}2036[#2036] Remove ETW powered GC metrics on FullFramework
• {pull}2027[#2027] Remove unsupported TFM's

===== Bug fixes

• {pull}2041[#2041] Prevent sending activation_method in metadata for 8.7.0

[[release-notes-1.20.0]]

===== Features

• {pull}1981[#1981] Support for Azure Functions through new Elastic.Apm.Azure.Functions nuget package!
• {pull}1935[#1935] Support new Elasticsearch Client: Elastic.Clients.Elasticsearch
• {pull}1988[#1988] Suppport latest version of Microsoft.Data.SqlClient
• {pull}1968[#1988] Support latest version OracleManagedDataAccess
• {pull}1983[#1983] Loose MSVC redistributable as requirement for the profiler
• {pull}1976[#1983] Add support for sending agent activation method to the server

===== Bug fixes

• {pull}1999[#1999] NullReferenceException in span compression
• {pull}1970[#1970] Improve profiler logging by always enabling agent logging too.
• {pull}1972[#1972] Normalize OpenTelemetry Bridge config section to OpenTelemetryBridgeEnabled
• {pull}1926[#1926] Try to enable TLS 1.2 in all scenarios.
• {pull}1964[#1964] OTel bridge span's destination service may contain null resource
• {pull}1961[#1961] AppSettings ElasticApm:Enabled is not fully honored in ASP.NET Classic

[[release-notes-1.19.0]]

===== Features

• {pull}1867[#1867] Improve handling of multiple agent initialization.
• {pull}1877[#1877] Enable CloudMetadataProvider on Azure Functions.
• {pull}1892[#1892] CentralConfig: handle MaxAge header with less than 5 sec according to spec (issue: {issue}1831[#1831]).
• {pull}1897[#1897] Add basic agent logging preamble.
• {pull}1907[#1907] Publish docker image with agent (issue: {issue}1665[#1665]).
• {pull}1917[#1917] Add .NET 7 support (issue: {issue}1860[#1860]).
• {pull}1930[#1930] Improve SOAP action parsing.

===== Bug fixes

• {pull}1882[#1882] Fix transaction trace id not aligned when transaction is created from OTel bridge without parent (issue: {issue}1881[#1881]).
• {pull}1905[#1905] Avoid NRE during startup hook init (issue: {issue}1904[#1904]).
• {pull}1927[#1927] Avoid panic in file-logging setup (issue: {issue}1918[#1918]).
• {pull}1922[#1922] Use Span timing instead of cumulative SqlCommand statistics (issue: {issue}1869[#1869]).
• {pull}1933[#1933] Enable DOTNET_STARTUP_HOOKS for .NET 7 (issue: {issue}1900[#1900]).

[[release-notes-1.18.0]]

===== Features

• Profiler based agent is now GA
• {pull}1806[#1806] Capture request body in ASP.NET Full Framework (issue: {issue}379[#379]).
• {pull}1832[#1832] UseWindowsCredentials: new configuration to force the agent to use the credentials of the authenticated Windows user when events are sent to the APM Server (issue: {issue}1825[#1825]).

===== Bug fixes

• {pull}1800[#1800] Fix incorrect transaction name in ASP.NET Web Api (issue: {issue}1645[#1637]).
• {pull}1803[#1803] and {pull}1804[#1804] Fix potential NullReferenceException in TraceContinuationStrategy implementation (issue: {issue}1802[#1802]).
• {pull}1780[#1780] Fix container ID parsing in AWS ECS/Fargate environments (issue: {issue}1779[#1779]).
• {pull}1814[#1814] Use correct default value for ExitSpanMinDuration (issue: {issue}1789[#1789]).
• {pull}1811[#1811] Fixed crashes on some SOAP 1.2 requests when using GetBufferedInputStream (issue: {issue}1759[#1759]).
• {pull}1816[#1816] Group MetricSets in BreakdownMetricsProvider (issue: {issue}1678[#1678]).

[[release-notes-1.17.0]]

===== Features

• {pull}1739[#1739] Introduce the TraceContinuationStrategy config (issue: {issue}1637[#1637]).
• {pull}1749[#1749] Span Links with Azure ServiceBus (issue: {issue}1638[#1638]).
• {pull}1765[#1765] Improve db granularity (issue: {issue}1664[#1664]).
• {pull}1795[#1795] Add config option span_stack_trace_min_duration (issue: {issue}1529[#1529]).

===== Bug fixes

• {pull}1746[#1746] Fix default for the ApplicationNamespaces config.
• {pull}1755[#1755] Flow SynchronizationContext across public API calls (issue: {issue}1660[#1660]).
• {pull}1753[#1753] PayloadSender threading improvements (issue: {issue}1571[#1571]).
• {pull}1773[#1773] Include Accept header on APM server info call (caused errors when reading APM Server info) (issue: {issue}1624[#1624]).
• {pull}1781[#1781] Significantly improved the performance of database query parsing (issue: {issue}1763[#1763]).
• {pull}1787[#1787] Fix FillApmServerInfo : Invalid ElasticApm_ApiKey throws Exception (issue: {issue}1735[#1735]).

[[release-notes-1.16.1]]

===== Features

• {pull}1732[#1732] Improved logging around fetching central configuration (issue: {issue}1626[#1626]).

===== Bug fixes

• {pull}1710[#1710] Crash during assembly loading with the profiler based agent (issue: {issue}1705[#1705]).
• Handling RouteData with null in legacy ASP.NET Core 2.2 apps (issue: {issue}1729[#1729]).

[[release-notes-1.16.0]]

[float] ===== Features

• {pull}1726[#1726] Automatic capturing of incoming HTTP Requests on ASP.NET Core with the Profiler based agent (issue: {issue}1610[#1610]).

===== Bug fixes

• {pull}1725[#1725] By disabling system.cpu.total.norm.pct, the agent won't create any instance of the PerformanceCounter type (workaround for issue: {issue}1724[#1724])
• {pull}1723[#1723] Transaction names for incoming HTTP requests returning 404 but matching a valid route, will include the URL path instead of using unknown route (issue: {issue}1715[#1715]).

[[release-notes-1.15.0]]

[float] ===== Features

• {pull}1657[#1657] Improved database span names based on parsed SQL statements (issue: {issue}242[#242])

[float] ===== Bug fixes

• {pull}1670[#1670] Dedicated working loop thread for sending APM events (issue: {issue}1571[#1571])
• {pull}1677[#1677] Fixed span type for MongoDB - with this a MongoDB logo will show up on the service map
• {pull}1674[#1674] InvalidCastException in AspNetCoreDiagnosticListener
• {pull}1683[#1683] MVC: handling area:null when creating transaction name based on routing
• {pull}1685[#1685] Handle missing .Stop events in AspNetCoreDiagnosticListener (issue: {issue}1676[#1676])

[[release-notes-1.14.1]]

[float] ===== Bug fixes

• {pull}1634[#1634] Make sure events are sent after APM Server timeout (bug report: {pull}1630[#1630])
• {pull}1639[#1639] Error on composite span validation (bug report: {issue}1631[#1631]))
• {pull}1648[#1648] OpenTelemetry (Activity) bridge - APM Server version check

[[release-notes-1.14.0]]

[float] ===== Features

• {pull}1620[#1620] Span compression and dropping fast exit spans. New settings: ExitSpanMinDuration, SpanCompressionEnabled, SpanCompressionExactMatchMaxDuration, SpanCompressionSameKindMaxDuration (issues: {issue}1329[#1329] and {issue}1475[#1475])
• {pull}1611[#1611] NpgSql 6.x support (issue: {issue}1602[#1602])
• {pull}1589[#1589] Capture transaction name on errors (issue: {issue}1574[#1574])

[float] ===== Bug fixes

• {pull}1603[#1603] .NET 6 support with startup hook (issue: {issue}1590[#1590])

[float] ===== Breaking changes

• {pull}1586[#1586] Change unknown service.name to align with other agents. In the very rare cases when the agent is not able to autoamtically detect the name of a service, or it's not manually set, it'll use the default service name unknown-dotnet-service. In prior versions this was just unknown. (issue: {issue}1585[#1585])

[[release-notes-1.13.0]]

[float] ===== Features

• {pull}1498[#1498] OpenTelemetry Bridge - integration with System.Diagnostics.Activity - Beta (issue: {issue}1521[#1521])

[[release-notes-1.12.1]]

[float] ===== Bug fixes

• {pull}1564[#1564] Failed sending event error with missing span.context.destination.service.name required field on older APM Servers (issue: {issue}1563[#1563])

[[release-notes-1.12.0]]

[float] ===== Breaking changes

• {pull}1520[#1520] Auto-infer destination.service.resource and adapt public API (issues: {issue}1330[#1330])

boolean isExitSpan parameter introduced to Start* and Capture* public APIs to denote when a span is an exit span.

[float] ===== Features

• {pull}1511[#1511] Implement Dropped span statistics
• {pull}1515[#1515] Ignore duplicate Diagnostic listener subscriptions (issue: {issue}1119[#1119])
• {pull}1518[#1518] Implement User-Agent spec for .NET agent (issue: #1517)
• {pull}1525[#1525] Add message related properties to transactions and spans (issue: {issue}1512[#1512])
• {pull}1534[#1534] Add profiler auto instrumentation (issue: {issue}1522[#1522])
• {pull}1548[#1548] Add profiler auto instrumentation for RabbitMQ (issue: {issue}1223[#1223])
• {pull}1528[#1528] Platform detection: Handle .NET 6 (issue: {issue}1513[#1513])
• {pull}1492[#1492] Remove use of Socket.Encrypted to determine secure
• {pull}1520[#1520] Auto-infer destination.service.resource and adapt public API (issues: {issue}1330[#1330])
• {pull}1540[#1540] Stop recording transaction metrics (issue: {issue}1523[#1523])

[float] ===== Bug fixes

• {pull}1484[#1484] Capture spans for new Azure Storage SDKs (issue: {issue}1352[#1352])
• {pull}1509[#1509] Use Environment.MachineName to get HostName (issue: {issue}1504[#1504])
• {pull}1510[#1510] Check context is not null when sanitizing error request headers (issue: {issue}1503[#1503])
• {pull}1536[#1536] Improve Performance counter handling for metrics on Windows (issue: {issue}1505[#1505])
• {pull}1538[#1538] Collect .NET Framework GC metrics only when filtering supported (issue: {issue}1346[#1346])
• {pull}1557[#1557] Handle enabled/recording=false configuration when capturing errors

[[release-notes-1.11.1]]

[float] ===== Features

• {pull}1354[#1354] Serialize to writer directly
• {pull}1356[#1356] Better logging in PayloadSenderV2 on task cancellation
• {pull}1358[#1358] Propagate Trace context in exit spans (issues: {issue}1350[#1350], {issue}1344[#1344])
• {pull}1374[#1374] Get Command and Key for StackExchange.Redis spans (issue: {issue}1364[#1364])
• {pull}1474[#1474] Add CosmosDB integration to NetCoreAll
• {pull}1368[#1368] Use 10K limit for CaptureBody similar to the Java agent (issue: {issue}1359[#1359])

[float] ===== Bug fixes

• {pull}1362[#1362] Unset parentId if TraceContextIgnoreSampledFalse is active
• {pull}1367[#1367] Make sure BreakdownMetricsProvider prints 1K warning only once per collection (issue: {issue}1361[#1361])
• {pull}1471[#1471] Sanitize Central config request URI and headers in logs (issue: {issue}1376[#1376])
• {pull}1472[#1472] Honor Transaction.Outcome set by public API in auto instrumentation (issue: {issue}1349[#1349])
• {pull}1481[#1481] Use Kubernetes pod id determined from cgroup file

[[release-notes-1.11.0]]

[float] ===== Features

• {pull}1342[#1342] CosmosDb support (issue: {issue}1154[#1154])
• {pull}1271[#1271] Support "Time spent by span type" (aka Breakdown metrics) (issue: {issue}227[#227])
• {pull}1302[#1302] Prefer W3C traceparent over elastic-apm-traceparent
• {pull}1310[#1310] Add TraceContextIgnoreSampledFalse config setting
• {pull}1331[#1331] Create transactions for Azure Service Bus Processors (issue: {issue}1321[#1321])

[[release-notes-1.10.0]]

[float] ===== Features

• {pull}1225[#1225] Add instrumentation for Azure Service Bus (issue: {issue}1157[#1157])
• {pull}1247[#1247] Add Azure storage integration (issues: {issue}1156[#1156] and {issue}1155[#1155])
• {pull}1241[#1241] Internalize Newtonsoft.Json - no more dependency on Newtonsoft.Json
• {pull}1275[#1275] Internalize Ben.Demystifier - no more dependency on Ben.Demystifier (issue: {issue}1232[#1232])
• {pull}1215[#1215] Add MongoDb support (issue: {issue}1158[#1158])
• {pull}1277[#1277] Capture inner exceptions (issue: {issue}1267[#1267])
• {pull}1290[#1290] Add configured hostname (issue: {issue}1289[#1289])
• {pull}1288[#1288] Use TraceLogger as default logger in ASP.NET Full Framework (issue: {issue}1263[#1263])

[float] ===== Bug fixes

• {pull}1252[#1252] Fix issue around setting Recording to false (issue: {issue}1250[#1250])
• {pull}1259[#1259] ASP.NET: Move error capturing to Error event handler
• {pull}1305[#1305] Use Logger to log exception in AgentComponents initialization (issue: {issue}1254[#1254])
• {pull}1311[#1311] Fix NullReferenceException in Elastic.Apm.Extensions.Logging(issue: {issue}1309[#1309])

[float] ===== Breaking changes

• {pull}1306[#1306] Do not capture HTTP child spans for Elasticsearch (issue: {issue}1276[#1276])

[[release-notes-1.9.0]]

[float] ===== Features

• {pull}925[#925] Add GC time (issue: {issue}922[#922])
• {pull}1147[#1147] Propagate sample rate through tracestate (issue: {issue}1021[#1021])

[float] ===== Bug fixes

• {pull}1189[#1189] Get transaction name from Web API controller route template

[float] ===== Breaking changes

• {pull}1161[#1161] and {pull}1162[#1162] The agent tries to never throw any exception. Specifically instead of throwing InstanceAlreadyCreatedException, it will print an error log.

[[release-notes-1.8.1]]

[float] ===== Features

• {pull}1196[#1196] Add GC Heap Stats capturing for .NET 5.0 (issue: {issue}1195[#1195])

[float] ===== Bug fixes

• {pull}1192[#1192] Lazily access the agent in ElasticApmProfiler redis integration (issue: {issue}1190[#1190])
• {pull}1198[#1198] Add TargetFramework NET5.0 to Elastic.Apm.AspNetCore and related packages (issue: {issue}1194[#1194])

[[release-notes-1.8.0]]

[float] ===== Features

• {pull}1063[#1063] Add support for capturing redis commands from StackExchange.Redis (<<setup-stackexchange-redis,documentation>>) (issue: {issue}874[#874])
• {pull}1065[#1065] Introduce ServerUrl config - (ServerUrls is still working but will be removed in the future) (issue: {issue}1035[#1035])
• {pull}1048[#1048] Support for more k8s cgroup path patterns (issue: {issue}968[#968])
• {pull}1082[#1082] SanitizeFieldNames config became changeable though Kibana central configuration
• {pull}1083[#1083] Azure App Service cloud metadata collection
• {pull}1135[#1135] Capture error logs as APM errors from Microsoft.Extensions.Logging automatically and extend the Public API to capture custom logs as APM errors (issue: {issue}894[#894])
• {pull}1096[#1096] Support changing log level through Kibana central configuration and support "off" level (issue: {issue}970[#970])

[float] ===== Bug fixes

• {pull}1081[#1081] NullReferenceException with disabled agent on Transaction.Custom (issue: {issue}1080[#1080])
• {pull}1078[#1078] ASP.NET Core, enabled=false in appsettings.json does not disable public Agent API (issue: {issue}1077[#1077])
• {pull}1115[#1115] System.IO.IOException on ASP.NET Classic (issue: {issue}1113[#1113])
• {pull}1118[#1118] Memory issue with gRPC (issue: {issue}1116[#1116])
• {pull}1124[#1124] Ensuring ETW sessions are terminated on agent shutdown (issue: {issue}897[#897])
• {pull}1109[#1109] NullReferenceException with custom IConfigurationReader implementation in MetricsCollector
• {pull}1138[#1138] and {pull}1165[#1165] Fixes around zero code change agent setup with DOTNET_STARTUP_HOOKS
• {pull}1115[#1115] Access Request.InputStream only when SOAP header present (issue: {issue}1113[#1113])

[[release-notes-1.7.1]]

[float] ===== Features

• {pull}1057[#1057] Introduce GetLabel<T> method on IExecutionSegment (issue: {issue}1033[#1033])

[float] ===== Bug fixes

• {pull}1052[#1052] Increased transaction duration due to stack trace capturing (issue: {issue}1039[#1039])
• {pull}1053[#1053] Warning with Synchronous operations are disallowed on ASP.NET Core during request body capturing (issue: {issue}1044[#1044])
• {pull}1042[#1042] SqlClient instrumentation on .NET 5 (issue: {issue}1025[#1025])
• {pull}1060[#1060] UseAllElasticApm with IHostBuilder missing auto instrumentation (issue: {issue}1059[#1059])

[[release-notes-1.7.0]]

[float] ===== Features

• {pull}828[#828] Agent loading with zero code change on .NET Core (issue: {issue}71[#71])
• {pull}969[#969] gRPC support (issue: {issue}478[#478])
• {pull}974[#974] Add ability to configure Hostname (issue: {issue}932[#932])
• {pull}997[#997] Add Enabled and Recording configuration (issue: #122)
• {pull}912[#912] Add FullFrameworkConfigurationReaderType config to load custom configuration reader on ASP.NET
• {pull}978[#978] Capture User id and email on ASP.NET (issue: #540)
• {pull}982[#982] Support boolean and numeric labels in addition to string labels (issues: {issue}967[#967], {issue}788[#788], {issue}473[#473], {issue}192[#191], {issue}788[#788], {issue}473[#473], {issue}191[#191])
• {pull}1000[#1000] Collecting metrics based on cGroup (issue: {issue}937[#937])
• {pull}1002[#1002] ITransaction.SetService API to support multiple services in a single process (issue: {issue}1001[#1001])
• {pull}1003[#1003] Collecting cloud metadata (supporting AWS, Azure, GCP) (issue: {issue}918[#918])
• {pull}973[#973] Transaction grouping on ASP.NET (issue: {issue}[#201])
• {pull}913[#913] Entity Framework 6 support on .NET Core (issue: {issue}902[#902])

[float] ===== Bug fixes

• {pull}992[#992] On ASP.NET Core CurrentTransaction is null in some cases (issues: {issue}934[#934], {issue}972[#972])
• {pull}971[#971] Avoid double initialization in HostBuilderExtensions
• {pull}999[#999] Capture body with large file error (issue: {issue}960[#960])

[float] ===== Breaking changes

• Binary compatibility on IExecutionSegment.CaptureException and IExecutionSegment.CaptureError with libraries depending on previous version. If this happens you need to update Elastic.Apm to 1.7.0 in your projects (Issue: ({issue}1067)[#1067])

[[release-notes-1.6.1]]

[float] ===== Bug fixes

• Service map: missing connection between .NET services ({pull}909[#909])

[[release-notes-1.6.0]]

[float] ===== Features

• Elasticsearch client instrumentation {pull}329[#329]
• Introducing Elastic.Apm.Extensions.Hosting package with an extension method on IHostBuilder {pull}537[#537]
• Stack trace improvements: async call stack demystification ({pull}847[#847]) and showing frames from user code for outgoing HTTP calls ({pull}845[#845])
• Making fields on IError public {pull}847[#847]
• Service map improvements: {pull}893[#893]

[float] ===== Bug fixes

• Missing traces from the Kibana traces list due to setting Transaction.ParentId to an Activity {pull}888[#888]
• Exception around runtime detection {pull}859[#859]
• Missing outgoing HTTP calls in .NET Framework applications and causing memory issues {pull}896[#896]

[[release-notes-1.5.1]]

[float] ===== Bug fixes

• Memory issue in SqlEventListener {pull}851[#851]

[[release-notes-1.5.0]]

[float] ===== Features

• Auto instrumentation for SqlClient (<<setup-sqlclient,documentation>>)
• Introducing Filter API {pull}792[#792] (<<filter-api,documentation>>)
• Auto-detect culprit for exceptions {pull}740[#740]
• New config settings: ExcludedNamespaces, ApplicationNamespaces (<<config-all-options-summary,documentation>>)
• Keep Activity.Current.TraceId in sync with the Trace ID used by the agent {pull}800[#800]
• Report Kubernetes system metadata {pull}741[#741]

[float] ===== Bug fixes

• Database connection string parsing issue with Oracle {pull}795[#795]

[[release-notes-1.4.0]]