Elastic
Start free trial Contact Sales
Loading

Elastic APM Real User Monitoring JavaScript Agent release notes

Review the changes, fixes, and more in each version of Elastic APM Real User Monitoring JavaScript Agent.

To check for security updates, go to Security announcements for the Elastic stack.

Release date: June 27, 2024

  • User interaction click transactions will report correct transaction names for IE11 #1511

Release date: December 27, 2023

Release date: September 27, 2023

  • Capture errors from objects thrown from the promise rejection events including the reason and custom properties: #1428

Release date: August 3, 2023

  • Add redirect span to the page-load transaction: #1400
  • Fetch API instrumentation now handles requests with URL objects. #1398

Release date: July 19, 2023

  • Support for Angular 16 is made available via @elastic/apm-rum-angular@3.0.0: #1380
  • Improve user-interaction transactions naming. Unsupported browsers: IE11 #1390
  • Add apmRequest and sendCredentials config to TypeScript typings: #1254 #1243
  • Fix warnings where performance entries are not supported: #1246

Release date: June 14, 2022

  • Introduce new config option sendCredentials. This allows the agent to send cookies to APM servers that are behind reverse proxies that need requests to be authenticated: #1238
  • Agent now warns users if they provide non-existent config options when initializing it: #1230
  • Capture the stacktrace of a SyntaxError triggered because of a malformed JavaScript code. Before this fix the agent was capturing an empty stacktrace: #1239

Release date: May 16, 2022

  • Span’s outcome is now set to Unknown when a Fetch/XHR request is aborted. The outcome can be found in the metadata information of the span details in APM UI: #1211
  • Allow users the ability to disable compression for the events sent to APM server. This is helpful for debugging purposes while inspecting via Devtools and also for generating HAR file. Please see our troubleshooting guide for more information: #1214
  • The instrumentation of fetch API consumes a response as a readable stream properly. Before this fix the related span was being ended on the start of the response rather than on the end of it: #1213
  • Agent now can listen to all click events on the page. Users can enable/disable click instrumentation via disableInstrumentation: ["click"]. eventtarget instrumentation flag will be deprecated in favor of click and will be removed in the future releases: #1219

Release date: April 20, 2022

  • Events are now beaconed when the user abandons or backgrounds the page, this makes sure the agent never miss an event. Before this change it was only sending them every interval configurable via flushInterval. Unsupported browsers: Firefox, IE11: #1146
Note

Transactions based on the supported technologies and custom managed transactions are the only ones taken into account.

  • rum-vue: Introduce script setup syntax support: #1194
  • Override reuse threshold when redefining a transaction. This will permit the agent not to miss data on slow network connections: #1196
  • Report Largest Contentful Paint (LCP) properly. Before this fix the agent was not giving the browser enough time to capture LCP entries that are post on-load: #1190

Release date: February 3, 2022

  • create user-interaction transactions based on the element on which the event occurred rather than the element on which the event handler has been attached. All web applications that rely on event delegation will benefit from this: #969

Release date: January 10, 2022

  • rum-core: update Cumulative layout shift(CLS) calculation following the new guidelines from Google: maximum session window with 1 second gap, capped at 5 seconds.: #1033
  • rum-angular: recover compatibility with Angular 9.0.x: #1115

Release date: December 7, 2021

  • Introduce new config option serverUrlPrefix to make the APM server URL configurable: #1078
  • Expose Transaction, Span, TransactionOptions and SpanOptions types definition: #1045 and #995
  • Set the values to empty string for deprecated span destination metrics: #1098
  • Check the existence of navigation timing data when compressing transaction marks: #1104

Release date: July 15, 2021

  • Validate apmRequest function is called for every request sent to the APM server when compression is enabled: #1055

Release date: July 13, 2021

  • Add support for apmRequest configuration that allows users to pass a custom function that can be used to modify the request sent to the APM server: #1018
  • Support for React 17 is made available via @elastic/apm-rum-react package: #1031
  • Support for Angular 12 is made available via @elastic/apm-rum-angular package: #1028
  • Update incorrect typings for adding labels to transaction and spans: #1017

Release date: April 19, 2021

  • First draft of session information is added for page-load Transactions (disabled by default): #634

Release date: April 2, 2021

  • Transaction marks for the APM server V3 spec was mapped to incorrect field which resulted in Kibana User Expererience App missing some of the core data. This only affects users who had set config apiVersion > 2: #1007

Release date: March 17, 2021

  • Discard buffered longtasks spans from page load transactions getting added to subsequent route change and other auto auto-instrumented transactions resulting in incorrect start time for those transactions: #989

Release date: March 15, 2021

  • Support regular expression for detecting distributed tracing origins (distributedTracingOrigins): #943
  • Capture buffered longtask entries: #964
  • Expose agent configuration TypeScript definition: #979

Release date: February 2, 2021

  • Propagate sampling weight through tracestate header: #845
  • Add necessary scripts to load test APM server with RUM payload: #948
  • Handle null reason in promise rejection event: #940

Release date: November 6, 2020

  • Add transaction sampling rate precision which ensures transaction_sample_rate configuration option has a maximum precision of 4 decimal places: #927
  • Add outcome field to applicable transactions and spans that is used by the APM UI for displaying the error rate chart: #904

Release date: September 29, 2020

  • Longtasks are now aggregated under the experience field to make querying faster: #900
  • Check for a Webkit Navigation timing API bug is added to avoid having incorrect navigation marks: #903

Release date: September 17, 2020

  • Add new method signaturtes to the exported type definitions: #890
  • Improve the span creation time when there is an active transaction on page: #883
  • Frameworks should not be automatically instrumented when the apm is inactive : #885
  • Add default XHR timeout for compressed requests to APM server: #897
  • Measure First Input Delay metrics properly for page load transactions: #899

Release date: August 18, 2020

  • Provide an API to block all auto instrumented transactions created by the agent through transaction.block method. Users can also use the startSpan API to create blocking spans to control this behaviour: #866
  • Expose options to create blocking spans from the agent API via startSpan: #875
  • Capture Cumulative layout shift(CLS), Total blocking time(TBT) and First input delay(FID) as part of experience metrics under page-load transactions: #838
  • Track various XHR states like timeouts, errors and aborts and end all managed transactions correctly: #871
  • Fix inconsistencies in the XHR timings by removing the task scheduling logic: #871
  • Accept the user provided logLevel configuration when agent is not active: #861
  • Opentracing Tracer should return Noop on unsupported platforms: #872s

Release date: July 29, 2020

  • Agent now uses the new CompressionStream API available on modern browsers to gzip compress the payload sent to the APM server. This yields a huge reduction of around ~96% in the payload size for an example web application when compared with the v3 specification: #572

Release date: July 6, 2020

  • Introduced better grouping strategy for all managed transactions based on the current browser’s location by default instead of grouping all transactions under UNKNOWN category: #827
  • Capture XHR, Fetch calls as spans that happened before the agent script is downloaded using the browser’s Resource Timing API: #825
  • Populate span.destination.* context fields for Navigation Timing span that denotes the HTML downloading phase: #829
  • Use Page Visibility API to discard transactions if the page was backgrounded at any point during the lifetime of the transaction: #295
  • Add apiVersion config to TypeScript typings: #833

Release date: June 24, 2020

  • Added support for path array in <ApmRoute> React component that associates the transaction based on the mounted path: #702
  • Capture Total Blocking Time (TBT) only after all longtask entries are observed: #803
  • Do not capture page load transaction marks when the NavigationTiming data from the browsers are not trustable: #818

Release date: May 28, 2020

  • Agent now supports compressing events payload sent to the APM server via new configuration apiVersion. It yeilds a huge reduction of around ~45% in the payload size for average sized web pages: #768
  • Capture First Input Delay(FID) as Span for page-load transaction: #732
  • Capture Total Blocking Time(TBT) as Span for page-load transaction: #781
  • Refactor ServiceFactory class to use constant service names: #238
  • Allow setting labels before agent is initialized: #780
  • Use single instance of apm across all packages: #791
  • User defined types for managed transactions are considered of high precedence: #758
  • Add span subtype information in payload without camelcasing: #753
  • Treat truncated spans percentage as regular span in breakdown calculation: #776

Release date: April 15, 2020

  • Performance Observer is used to measure FirstContentfulPaint Metric: #731
  • Avoid full component re-rerender when query params are updated on current ApmRoute inside child components: #748

Release date: April 8, 2020

  • Route change transactions now includes the browsers next paint frame: #404
  • Support differential loading with Angular CLI: #607
  • Reduced the bundle size by modifying the random number generator algorithm: #705
  • Handle when errors are thrown in unsupported browsers: #707
  • Captured API calls are duplicated as spans in IE: #723

Release date: March 18, 2020

  • Monitor longtasks by default during active transaction: #601
  • Set sync field only for synchronous spans: #619