Skip to content

Changelog


The base SDK and SessionReplay are released under the same NuGet version, with changes recorded separately. Native/vcpkg and the Electron Adapter use their own version numbers; Native's optional Replay feature is delivered with the same port version.

Guance.Windows

0.1.0-alpha.11 (2026/10/19)

  1. Browser RUM in WebView2 now includes sdk_pkg_info, recording the page Browser SDK version via web; the host SDK identity remains unchanged.
  2. Fixed an issue where the Browser RUM Bridge depended on the Replay switch. Browser RUM can now be integrated normally even when Replay is disabled or optional components are not installed.
  3. Fixed an issue where newlines in string fields could split reported records, and prevented the SDK's own upload requests from being repeatedly collected as Resources.
  4. Added GetUploadQueueDiagnosticsSnapshot() to check the number of pending RUM and Log writes and the Replay queue status.

0.1.0-alpha.9 (2026/10/07)

  1. Removed the Replay implementation from the base package while retaining the existing configuration, recording control, and privacy APIs. Existing Replay applications must add the same version of Guance.Windows.SessionReplay when upgrading.
  2. Added a client-side IsSessionReplayAvailable to determine whether the optional component is actually available. When the component is missing, version-mismatched, or fails to load, diagnostics are output while regular RUM, Log, and Trace continue to work; WebView2 declares the records capability only when the component is actually available.
  3. The base package and SessionReplay are packaged and released under the same version. See the separate Version Information below for the Replay component's features.

0.1.0-alpha.7 (2026/08/15)

  1. .NET RUM and Log Intake requests now have compression enabled by default; it can be disabled with CompressIntakeRequests = false.
  2. Fixed the Deflate request body format in .NET and the bundled Native runtime, now using zlib wrapping that complies with Content-Encoding: deflate.

0.1.0-alpha.6 (2026/08/13)

  1. Added persistent anonymous user identifiers isolated by RUM application ID. Unauthenticated users remain consistent after process restarts, and RUM and Log data are automatically correlated.
  2. The bundled Native runtime now automatically collects cold start and warm start Actions by default.
  3. RUM and Log Intake requests in the bundled Native runtime use Deflate compression by default.
  4. Fixed an issue where Session Replay could upload segments lacking an associated View ID.

0.1.0-alpha.4 (2026/08/12)

  1. Added GuanceConfig.DataModifier and GuanceConfig.LineDataModifier to modify tags and fields of RUM, Log, and Resource data before caching.
  2. Added RumPrivacyConfig.CaptureHttpHeaders and RumPrivacyConfig.RedactedHeaderNames to collect HTTP request and response headers on demand and redact sensitive headers.
  3. Added GuanceConfig.DiagnosticListener, GuanceSdk.AddDiagnosticListener(...), and GuanceSdk.GetDiagnosticsSnapshot() for local configuration and runtime state troubleshooting.
  4. GuanceClient.StartAction(..., bool needWait, ...) and GuanceSdk.StartAction(..., bool needWait, ...) now support explicitly waiting for completion. Actions now uniformly include high-frequency call protection, View switch completion, and a maximum 5-second duration limit.
  5. Windows crashes, app unresponsiveness, and network errors now consistently use the RUM error classification and field structure.
  6. Privacy rules are now consistently applied after application data modifiers.

0.1.0-alpha.2 (2026/08/09)

  1. Added automatic Trace propagation, application startup tracking, and Logging data reporting capabilities.
  2. Added a shared desktop Sample configuration and additional public API integration examples.
  3. Added experimental Session Replay validation support for WPF, WinForms, WinUI 3, and Electron Samples.
  4. Strengthened solution-level NuGet packaging, Native runtime assets, and consumer-side validation.
  5. Extended bounded cache, diagnostics, privacy, and upload configuration APIs.

0.1.0-alpha.1 (2026/08/09)

  1. First release of the experimental Guance Windows observability SDK.
  2. Added managed APIs for RUM, distributed tracing, logs, upload scheduling, and bounded file caching.
  3. Provides Windows x86, x64, and ARM64 Native runtime assets.
  4. Supports WPF, WinForms, WinUI 3, WebView2, and Electron integration.
  5. Added experimental Session Replay capability, which is disabled by default and can be enabled on demand.

View the Guance.Windows source changelog

Guance.Windows.SessionReplay

0.1.0-alpha.11 (2026/10/19)

  1. Precisely depends on the same version of Guance.Windows, working with the base SDK to query the Replay queue status for pending encoding and persistence.

0.1.0-alpha.9 (2026/10/07)

  1. First release of a standalone optional NuGet package that contains the managed Replay recording, encoding, persistence, and upload implementation, with a precise dependency on the same version of Guance.Windows.
  2. The existing configuration, recording control, and privacy APIs continue to be used through the base SDK. Installation does not automatically enable Replay; you still need to explicitly enable the configuration and recording. Replay remains experimental.
  3. It continues to use the base SDK's Session correlation, sampling, and privacy configuration. When the component is unavailable, the base SDK outputs diagnostics and continues regular RUM, Log, and Trace.
  4. This package does not include the Native Replay DLL; C/C++ and Electron use the optional runtime provided by the Native/vcpkg versions below.

View the Guance.Windows.SessionReplay source changelog

Guance.Windows.Native

0.1.0-alpha.11 (2026/10/19)

  1. Fixed an issue introduced in 0.1.0-alpha.10 after splitting the Replay component: full snapshots and incremental records of Browser Session Replay forwarded by the Electron Bridge were rejected, causing Replay segments to fail to upload. Session identifiers continue to be managed uniformly by the Native Core.
  2. When upgrading Electron Full Mode with Replay, update the base Native runtime and the Replay supplemental component at the same version and architecture; Mixed Mode requires updating the host's guance-windows-native[replay] dependency. The Replay fix itself does not require changes to the npm Adapter JavaScript or the NuGet managed Replay implementation.
  3. Added sdk_pkg_info in conjunction with npm Adapter 0.1.0-alpha.6: host RUM/Log records electron, Browser RUM/Log additionally records web when the version is available, with the same rule in Full Mode and Mixed Mode.

0.1.0-alpha.10 (2026/10/07)

Base Native SDK

  1. The base DLL has removed the Replay implementation while retaining the existing C configuration and control interfaces. If you only use RUM, Log, and Trace, installing the base port is sufficient.
  2. Added guance_rum_is_session_replay_available(); when the component is missing or cannot be loaded, Replay is disabled with diagnostics while regular RUM, Log, and Trace continue to work.

Session Replay Feature

  1. The replay feature of the same port installs a separate Replay DLL. The base DLL loads the component from the same directory on demand and validates the module ABI and SDK version.
  2. The Replay DLL must keep the same version and architecture as the base DLL. Existing Replay applications need to select this feature when upgrading, and Replay must still be explicitly enabled after installation.

Electron Windows Runtime

  1. This version delivers base runtime and Replay supplemental archives for x64, x86, and ARM64 separately, six archives in total, along with corresponding checksum files.
  2. Both Full Mode and Mixed Mode Bridges declare Replay capability based on configuration and actual component availability; records is not declared when components are missing. In Mixed Mode, the Replay component is provided by the host's replay feature.

0.1.0-alpha.7 (2026/08/15)

  1. Fixed the Deflate format of Native RUM and Log Intake requests, now using zlib wrapping that complies with Content-Encoding: deflate.

0.1.0-alpha.6 (2026/08/13)

  1. Native RUM and Log Intake requests use Deflate compression by default, with new compress_intake_requests toggle and flush_interval_ms periodic flush configuration.
  2. Added persistent anonymous user identifiers isolated by RUM application ID, which remain consistent after process restarts and are reused by Native and Electron telemetry.
  3. Native and Electron integrations automatically collect cold start and warm start Actions by default; this can be disabled with enable_app_launch_tracking or enableAppLaunch.
  4. Session Replay no longer uploads segments lacking an associated View ID.

0.1.0-alpha.5 (2026/08/12)

  1. Added an optional electron-adapter vcpkg feature that installs the SDK-provided Electron Main Process and Preload public entry points for mixed-mode applications.
  2. Added an in-process Electron Bridge Server C API that writes Browser telemetry data to an app-held Native SDK handle.
  3. Added Browser Log and experimental Browser Session Replay forwarding in both Full Mode and Mixed Mode of the Electron Adapter.
  4. The electron-bridge vcpkg feature now installs the Electron Adapter, Bridge EXE, and matching Native runtime together.
  5. The enabled state and privacy level of Electron Session Replay are uniformly determined by the Native Bridge capability. When Native Replay is disabled, the records capability is no longer declared and Replay input is rejected.

0.1.0-alpha.4 (2026/08/12)

  1. Added guance_rum_start_action_ext(..., int need_wait) to create Native RUM Actions that require explicit completion.
  2. Native Actions now uniformly include high-frequency call protection, View switch completion, and a maximum 5-second duration limit.
  3. Native crash and app unresponsive events now consistently use the RUM error classification and field structure.
  4. Added guance_sdk_get_version() to read the release version compiled into the Native runtime; RUM, Log, and Session Replay data report this version via sdk_version.
  5. Added guance_sdk_write_electron_bridge_line(...) to write validated Browser RUM, launch, error, Log, and Replay Bridge messages to an app-held SDK handle.
  6. Added guance_rum_add_launch_action_ext(...) to associate a launch Action with an existing Browser View.
  7. The Electron Bridge now has Session identifiers managed uniformly by the Native Core and no longer accepts Browser-side Session overrides.
  8. The Electron cold start Action waits for and associates with the first primary Browser View within a limited time; if no View appears, it falls back on timeout.

0.1.0-alpha.3 (2026/08/11)

  1. Added guance_configure_data_modifiers(...) to modify tags and fields of Native RUM and Log data before caching.
  2. Added optional HTTP request and response header collection, with configurable redaction of sensitive headers.
  3. Added an optional electron-bridge vcpkg feature to install guance_windows_electron_bridge.exe and its Native runtime dependencies.
  4. URL and HTTP header privacy rules are now uniformly applied after application data modifiers.
  5. Native Resource completion events can carry request and response headers, with privacy filtering performed inside the SDK.

0.1.0-alpha.2 (2026/08/09)

  1. Added Native Crash and UI Hang monitoring, with support for resuming reporting at the next launch.
  2. Added automatic WinHTTP Trace propagation and Resource auto-collection capabilities.
  3. Added a Native Console integration Sample and expanded the public C/C++ SDK header files.
  4. Strengthened Native packaging, CMake, release tag, and vcpkg registry validation.
  5. Expanded Electron Native Bridge and experimental Session Replay diagnostics.

0.1.0-alpha.1 (2026/08/07)

  1. First release of the experimental Windows x64 dynamic library.
  2. Provides stable C ABI interfaces for RUM, distributed tracing, logging, Native monitoring, and diagnostics.
  3. Provides installable GuanceWindowsNative CMake package and Guance::WindowsNative target.
  4. Provides a bounded file queue that does not depend on the default SQLite.
  5. Added experimental Session Replay capability, which is disabled by default and can be enabled on demand.

View the Guance.Windows.Native source changelog

Electron Native Adapter

0.1.0-alpha.6 (2026/10/19)

  1. Windows Full Mode and Mixed Mode automatically provide the npm Adapter version to the Native Core for sdk_pkg_info.electron; Browser RUM and Browser Log keep the page SDK version for web.
  2. The default Native Runtime for Windows x64, x86, and ARM64 has been updated to vcpkg_0.1.0-alpha.11, and the optional Replay supplemental component uses the same version and architecture. The macOS default remains 1.6.8-alpha.6.

0.1.0-alpha.5 (2026/10/07)

  1. Added Windows Replay supplemental component installation to @cloudcare/electron-native-adapter, supporting --with-replay, --replay-archive, and corresponding postinstall environment variables.
  2. The installer validates the version, architecture, source, and file hashes of the base and Replay manifests; stageWindowsRuntime() also copies the installed Replay DLL and replay-manifest.json outside the ASAR.
  3. In the published npm package, the default SDKs are vcpkg_0.1.0-alpha.8 on Windows and 1.6.8-alpha.6 on macOS. When using 0.1.0-alpha.10 and later split-package versions, Full Mode requires explicitly selecting the corresponding Native SDK and installing the matching Replay supplemental component before enabling the configuration.
  4. In Mixed Mode, the C++ host provides the Replay component, and the Adapter decides whether to forward recorded data based on the Bridge's actual capability. When the component is missing, regular RUM continues to work.

View the Electron Native Adapter source changelog

Pre-release Versions

alpha and beta versions are not covered by stability or compatibility guarantees. NuGet projects should pin verified package versions; vcpkg projects should pin the SDK registry baseline to avoid implicit upgrades during builds.

Feedback

Is this page helpful?