更新日志¶

Guance.Windows¶

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

1. .NET RUM 与 Log Intake 请求现在默认启用压缩，可通过 CompressIntakeRequests = false 关闭。
2. 修复 .NET 与随包 Native 运行时的 Deflate 请求体格式，统一使用符合 Content-Encoding: deflate 的 zlib 包装。

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

1. 新增按 RUM 应用 ID 隔离的持久化匿名用户标识，未登录用户在进程重启后仍保持一致，并自动关联 RUM 与 Log 数据。
2. 随包 Native 运行时默认自动采集应用冷启动和热启动 Action。
3. 随包 Native 运行时的 RUM 与 Log Intake 请求默认使用 Deflate 压缩。
4. 修复 Session Replay 可能上传缺少关联 View ID 分段的问题。

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

1. 新增 GuanceConfig.DataModifier 和 GuanceConfig.LineDataModifier，支持在缓存前修改 RUM、Log 与 Resource 数据的标签和字段。
2. 新增 RumPrivacyConfig.CaptureHttpHeaders 和 RumPrivacyConfig.RedactedHeaderNames，支持按需采集 HTTP 请求与响应 Header，并对敏感 Header 脱敏。
3. 新增 GuanceConfig.DiagnosticListener、GuanceSdk.AddDiagnosticListener(...) 和 GuanceSdk.GetDiagnosticsSnapshot()，用于本地配置与运行状态排查。
4. GuanceClient.StartAction(..., bool needWait, ...) 与 GuanceSdk.StartAction(..., bool needWait, ...) 支持显式等待完成；Action 统一增加高频调用保护、View 切换完成和最长 5 秒持续时间限制。
5. Windows 崩溃、应用无响应和网络错误统一使用 RUM 错误分类与字段结构。
6. 隐私规则统一在应用数据修改器之后执行。

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

1. 新增自动 Trace 传播、应用启动追踪和 Logging 数据上报能力。
2. 新增共享桌面端 Sample 配置，并补充公共 API 集成示例。
3. 新增 WPF、WinForms、WinUI 3 和 Electron Sample 的实验性 Session Replay 验证能力。
4. 加强解决方案级 NuGet 打包、Native 运行时资产和消费端验证。
5. 扩展有界缓存、诊断、隐私和上传配置 API。

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

1. 首次发布实验性观测云 Windows 可观测性 SDK。
2. 新增 RUM、分布式链路追踪、日志、上传调度和有界文件缓存的托管 API。
3. 提供 Windows x86、x64 和 ARM64 Native 运行时资产。
4. 支持 WPF、WinForms、WinUI 3、WebView2 和 Electron 集成。
5. 新增默认关闭、可按需启用的实验性 Session Replay 能力。

查看 Guance.Windows 源码更新日志

Guance.Windows.Native¶

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

1. 修复 Native RUM 与 Log Intake 请求的 Deflate 格式，改为使用符合 Content-Encoding: deflate 的 zlib 包装。

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

1. Native RUM 与 Log Intake 请求默认使用 Deflate 压缩，并新增 compress_intake_requests 开关和 flush_interval_ms 周期 Flush 配置。
2. 新增按 RUM 应用 ID 隔离的持久化匿名用户标识，在进程重启后保持一致，并供 Native 与 Electron 遥测复用。
3. Native 与 Electron 集成默认自动采集冷启动和热启动 Action；可通过 enable_app_launch_tracking 或 enableAppLaunch 关闭。
4. Session Replay 不再上传缺少关联 View ID 的分段。

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

1. 新增可选的 electron-adapter vcpkg Feature，为混合模式应用安装 SDK 提供的 Electron Main Process 与 Preload 公共入口。
2. 新增进程内 Electron Bridge Server C API，支持将 Browser 遥测数据写入由应用持有的 Native SDK Handle。
3. Electron Adapter 的全量模式和混合模式新增 Browser Log 与实验性 Browser Session Replay 转发。
4. electron-bridge vcpkg Feature 现在同时安装 Electron Adapter、Bridge EXE 和匹配的 Native 运行时。
5. Electron Session Replay 的启用状态与隐私级别统一以 Native Bridge 能力为准；Native Replay 关闭时不再声明 records 能力，并拒绝 Replay 输入。

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

1. 新增 guance_rum_start_action_ext(..., int need_wait)，支持创建需要显式结束的 Native RUM Action。
2. Native Action 统一增加高频调用保护、View 切换完成和最长 5 秒持续时间限制。
3. Native 崩溃和应用无响应事件统一使用 RUM 错误分类与字段结构。
4. 新增 guance_sdk_get_version()，支持读取编译进 Native 运行时的发布版本；RUM、Log 与 Session Replay 数据通过 sdk_version 上报该版本。
5. 新增 guance_sdk_write_electron_bridge_line(...)，支持将校验后的 Browser RUM、启动、错误、Log 与 Replay Bridge 消息写入由应用持有的 SDK Handle。
6. 新增 guance_rum_add_launch_action_ext(...)，支持将启动 Action 关联到已有的 Browser View。
7. Electron Bridge 统一由 Native Core 管理 Session 标识，不再接受 Browser 侧 Session 覆盖。
8. Electron 冷启动 Action 会在限定时间内等待并关联首个主 Browser View；未出现 View 时按超时回退处理。

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

1. 新增 guance_configure_data_modifiers(...)，支持在缓存前修改 Native RUM 与 Log 数据的标签和字段。
2. 新增可选的 HTTP 请求与响应 Header 采集，并支持配置敏感 Header 脱敏。
3. 新增可选的 electron-bridge vcpkg Feature，用于安装 guance_windows_electron_bridge.exe 及其 Native 运行时依赖。
4. URL 与 HTTP Header 隐私规则统一在应用数据修改器之后执行。
5. Native Resource 完成事件支持携带请求与响应 Header，并在 SDK 内执行隐私过滤。

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

1. 新增 Native Crash 和 UI Hang 监控，并支持在下次启动时恢复上报。
2. 新增 WinHTTP Trace 自动传播和 Resource 自动采集能力。
3. 新增 Native Console 集成 Sample，并扩展公共 C/C++ SDK 头文件。
4. 加强 Native 打包、CMake、Release Tag 和 vcpkg 注册表验证。
5. 扩展 Electron Native Bridge 和实验性 Session Replay 诊断能力。

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

1. 首次发布实验性 Windows x64 动态库。
2. 提供 RUM、分布式链路追踪、日志、Native 监控和诊断的稳定 C ABI 接口。
3. 提供可安装的 GuanceWindowsNative CMake 包和 Guance::WindowsNative Target。
4. 提供不依赖默认 SQLite 的有界文件队列。
5. 新增默认关闭、可按需启用的实验性 Session Replay 能力。

查看 Guance.Windows.Native 源码更新日志