Skip to content

Latest commit

 

History

History
317 lines (230 loc) · 14 KB

CHANGELOG.asciidoc

File metadata and controls

317 lines (230 loc) · 14 KB
Raw
Note
 Release notes are best read in our documentation at elastic.co

.NET Agent version 1.x

1.7.1

Features

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

Bug fixes

  • {pull}1052[#1052] Increased transaction duration due to stack trace capturing (issue: #1039)

  • {pull}1053[#1053] Warning with Synchronous operations are disallowed on ASP.NET Core during request body capturing (issue: #1044)

  • {pull}1042[#1042] SqlClient instrumentation on .NET 5 (issue: #1025)

  • {pull}1060[#1060] UseAllElasticApm with IHostBuilder missing auto instrumentation (issue: #1059)

1.7.0

Features

  • {pull}828[#828] Agent loading with zero code change on .NET Core (issue: #71)

  • {pull}969[#969] gRPC support (issue: #478)

  • {pull}974[#974] Add ability to configure Hostname (issue: #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: #967, #788, #473, #191, #788, #473, #191)

  • {pull}1000[#1000] Collecting metrics based on cGroup (issue: #937)

  • {pull}1002[#1002] ITransaction.SetService API to support multiple services in a single process (issue: #1001)

  • {pull}1003[#1003] Collecting cloud metadata (supporting AWS, Azure, GCP) (issue: #918)

  • {pull}973[#973] Transaction grouping on ASP.NET (issue: #201)

  • {pull}913[#913] Entity Framework 6 support on .NET Core (issue: #902)

Bug fixes

  • {pull}992[#992] On ASP.NET Core CurrentTransaction is null in some cases (issues: #934, #972)

  • {pull}971[#971] Avoid double initialization in HostBuilderExtensions

  • {pull}999[#999] Capture body with large file error (issue: #960)

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: (#1067)

1.6.1

Bug fixes

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

1.6.0

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]

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]

1.5.1

Bug fixes

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

1.5.0

Features

  • Auto instrumentation for SqlClient (documentation)

  • Introducing Filter API {pull}792[#792] (documentation)

  • Auto-detect culprit for exceptions {pull}740[#740]

  • New config settings: ExcludedNamespaces, ApplicationNamespaces (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]

Bug fixes

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

1.4.0

Features

  • Introducing ITransaction.EnsureParentId() to integrate with RUM in dynamically loaded HTML pages (including page loads in ASP.NET Core) {pull}771[#771]

  • New config setting: ApiKey {pull}733[#733]

Bug fixes

  • Memory issue in .NET Full Framework with default metrics turned on {pull}750[#750]

  • Parsing for Oracle connection strings {pull}749[#749]

  • StackOverflowException when using the Elastic.Apm.SerilogEnricher package and the log level is set to Verbose {pull}753[#753]

Breaking changes

  • We have some changes that are technically breaking changes. We made some helper classes internal that were never meant to be public. These are: Elastic.Apm.Helpers.AgentTimeInstant, Elastic.Apm.Helpers.ContractExtensions, Elastic.Apm.Helpers.ObjectExtensions, Elastic.Apm.Helpers.ToStringBuilder. None of these classes were documented or mentioned as part of the Public Agent API. We expect no usage of these classes outside the agent.

1.3.1

Bug fixes

  • Fix log spamming issues {pull}736[#736], {pull}738[#738]

  • Fix turning HTTP 415 responses in ASP.NET Core to HTTP 500 when request body capturing is active {pull}739[#739]

  • Fix disabling GC metrics collection in case no GC is triggered during the first "5*MetricsInterval" of the process {pull}745[#745]

1.3.0

Features

  • New GC metrics: clr.gc.count, clr.gc.gen[X]size, where [X]: heap generation {pull}697[#697]

  • Capturing SOAP action name as part of the transaction name {pull}683[#683]

  • New config options: ServiceNodeName, VerifyServerCert, DisableMetrics, UseElasticTraceparentHeader (docs)

  • Full W3C TraceContext support {pull}717[#717]

Bug fixes

  • Fix transaction name generation in ASP.NET Core 3.x {pull}647[#647]

  • Fix around HTTP request body sanitization {pull}712[#712]

1.2.0

Features

  • Entity framework support with Interceptor (docs)

  • Sanitization of HTTP headers and request body (docs)

  • Central configuration - 2 new configs: CAPTURE_BODY and TRANSACTION_MAX_SPANS. {pull}577[#577].

  • Support for global labels (docs)

  • Custom context (docs)

  • Dropping support for ASP.NET Core 2.0 (which is already end of life) (docs)

Bug fixes

  • De-dotting labels. {pull}583[#583].

  • Request body capturing TypeLoadException in ASP.NET Core 3.0. {pull}604[#604].

  • Metrics collection: filtering NaN and Infinity. {pull}589[#589].

1.1.2

Bug fixes

  • Capturing request body with ASP.NET Core erased the body in some scenarios {pull}539[#539].

  • Integration with Serilog caused missing logs and diagnostic traces with NullReferenceException {pull}544[#544], {pull}545[#545].

1.1.1

Features

Configure transaction max spans. {pull}472[#472]

Bug fixes

Fixing missing "Date Modified" field on the files from the 1.1.0 packages causing an error while executing dotnet pack or nuget pack on a project with Elastic APM Agent packages. {pull}527[#527]

1.1.0

Features

  • ASP.NET Support, documentation can be found here

  • Central configuration (Beta)

Bug fixes

  • Addressed some performance issues {pull}359[#359]

  • Improved error handling in ASP.NET Core {pull}512[#512]

  • Fix for mono {pull}164[#164]

1.0.1

Bug fixes

  • NullReferenceException on .NET Framework with outgoing HTTP calls created with HttpClient in case the response code is HTTP3xx {pull}450[#450]

  • Added missing net461 target to the Elastic.Apm package

  • Handling Labels with null {pull}429[#429]

Features

  • Reading request body in ASP.NET Core. Also introduced two new settings: CaptureBody and CaptureBodyContentTypes. By default this feature is turned off, this is an opt-in feature and can be turned on with the CaptureBody setting. {pull}402[#402]

1.0.0 GA

The 1. GA release of the Elastic APM .NET Agent. Stabilization of the 1.0.0-beta feature for production usage.

Features

  • Out of the box integration with ILoggerFactory and the logging infrastructure in ASP.NET Core {pull}249[#249]

  • Introduced StackTraceLimit and SpanFramesMinDurationInMilliseconds configs {pull}374[#374]

  • The Public Agent API now support Elastic.Apm.Agent.Tracer.CurrentSpan {pull}391[#391]

Bug fixes

  • Thread safety for some bookkeeping around spans {pull}394[#394]

  • Auto instrumentation automatically creates sub-spans in case a span is already active {pull}391[#391]

Breaking changes

We have some breaking changes in this release. We wanted to do these changes prior to our GA release and with this we hopefully avoid breaking changes in the upcoming versions.

  • For better naming we replaced the Elastic.Apm.All packages with Elastic.Apm.NetCoreAll {pull}371[#371]

  • Based on feedback we also renamed the UseElasticApm() method in the Elastic.Apm.NetCoreAll package to UseAllElasticApm - this method turns on every component of the Agent for ASP.NET Core. {pull}371[#371]

  • Our logger abstraction, specifically the IApmLogger interface changed: {pull}389[#389]

  • To follow the Elastic Common Schema (ECS), we renamed our Tags properties to Labels. {pull}416[#416]

.NET Agent version beta/preview

Beta1 release

Features

  • Distributed tracing support (based on W3C Trace Context)

  • Sampling

  • Metrics (Process and System CPU usage, Free and total Memory, Process working set and private bytes)

  • Capture Docker container id (linux containers only)

Improvements

  • ASP.NET Core: better transaction names based on routing, capture authenticated users

  • Public Agent API: create sub spans, serialize and deserialize traceparent

  • Stack traces contain fully qualified class names and real method names in case of async methods

Preview release 2

Features

  • SecretToken setting - with this you can use the agent with Elastic Cloud.

  • Intake V2 protocol to server communication - support for APM Server 7.x

  • Extended public agent API: support for setting custom HTTP and Database related fields.

  • Improved logging.

Packages can be found on nuget.org.

Preview release 1

Features

We shipped the following packages:

  • Elastic.Apm.All: This is a meta package that references every other Elastic APM .NET agent package. If you plan to monitor a typical ASP.NET Core application that depends on the Microsoft.AspNetCore.All package and uses Entity Framework Core then you should reference this package. In order to avoid adding unnecessary dependencies in applications that aren’t depending on the Microsoft.AspNetCore.All package we also shipped some other packages - those are all referenced by the Elastic.Apm.All package.

  • Elastic.Apm: This is the core of the agent, which we didn’t name “Core”, because someone already took that name :) This package also contains the Public Agent API and it is a .NET Standard 2.0 package. We also ship every tracing component that traces things that are part of .NET Standard 2.0 in this package, which includes the monitoring part for HttpClient. Elastic.Apm.AspNetCore: This package contains ASP.NET Core monitoring related code. The main difference between this package and the Elastic.Apm.All package is that this package does not reference the

  • Elastic.Apm.EntityFrameworkCore package, so if you have an ASP.NET Core application that does not use EF Core and you want to avoid adding additional unused references, you should use this package.

  • Elastic.Apm.EntityFrameworkCore: This package contains EF Core monitoring related code.