更新履歴¶
基本 SDK と SessionReplay は同じ NuGet バージョンでリリースされ、変更はそれぞれ別に記録されます。Native/vcpkg と Electron Adapter は、それぞれ独自のバージョン番号を使用します。Native のオプションの Replay Feature は、同じ port バージョンで提供されます。
Guance.Windows¶
0.1.0-alpha.11 (2026/10/19)¶
- WebView2 の Browser RUM に
sdk_pkg_infoを追加し、webを通じてページの Browser SDK バージョンを記録します。ホスト SDK のアイデンティティは変わりません。 - Browser RUM Bridge が Replay スイッチに依存する問題を修正しました。Replay をオフにした場合やオプションコンポーネントをインストールしていない場合でも、Browser RUM を正常に接続できます。
- 文字列フィールド内の改行が送信レコードを分割する可能性がある問題を修正し、SDK 自身のアップロードリクエストが Resource として重複収集されるのを回避しました。
GetUploadQueueDiagnosticsSnapshot()を追加し、RUM、Log の書き込み待ち数と Replay キューの状態を確認できるようにしました。
0.1.0-alpha.9 (2026/10/07)¶
- 基本パッケージから Replay 実装を削除し、既存の設定、録画制御、プライバシー API を維持します。既存の Replay アプリケーションをアップグレードする場合は、同じバージョンの
Guance.Windows.SessionReplayを追加する必要があります。 - クライアント
IsSessionReplayAvailableを追加し、オプションコンポーネントが実際に利用可能かどうかを判定します。コンポーネントの欠落、バージョンの不一致、読み込み失敗時には診断情報を出力し、通常の RUM、Log、Trace は引き続き動作します。WebView2 は、コンポーネントが実際に利用可能な場合のみrecords能力を宣言します。 - 基本パッケージと SessionReplay は同じバージョンでパッケージ化・リリースされます。Replay コンポーネントの機能については、以下の独立したバージョン情報を参照してください。
0.1.0-alpha.7 (2026/08/15)¶
- .NET RUM と Log Intake のリクエストはデフォルトで圧縮が有効になりました。
CompressIntakeRequests = falseで無効にできます。 - .NET と同梱の Native ランタイムの Deflate リクエストボディ形式を修正し、
Content-Encoding: deflateに準拠する zlib ラッピングに統一しました。
0.1.0-alpha.6 (2026/08/13)¶
- RUM アプリケーション ID ごとに分離された永続的な匿名ユーザー識別子を追加しました。未ログインユーザーはプロセス再起動後も識別子が保持され、RUM と Log データが自動的に関連付けられます。
- 同梱の Native ランタイムは、デフォルトでアプリのコールドスタートとホットスタートの Action を自動収集します。
- 同梱の Native ランタイムの RUM と Log Intake リクエストは、デフォルトで Deflate 圧縮を使用します。
- Session Replay が関連付けられた View ID を欠いたセグメントをアップロードする可能性がある問題を修正しました。
0.1.0-alpha.4 (2026/08/12)¶
GuanceConfig.DataModifierとGuanceConfig.LineDataModifierを追加し、キャッシュ前に RUM、Log、Resource データのタグとフィールドを変更できるようにしました。RumPrivacyConfig.CaptureHttpHeadersとRumPrivacyConfig.RedactedHeaderNamesを追加し、HTTP リクエストとレスポンスのヘッダーを必要に応じて収集し、機密ヘッダーをマスキングできるようにしました。GuanceConfig.DiagnosticListener、GuanceSdk.AddDiagnosticListener(...)、GuanceSdk.GetDiagnosticsSnapshot()を追加し、ローカルの設定と実行状態の調査に使用できるようにしました。GuanceClient.StartAction(..., bool needWait, ...)とGuanceSdk.StartAction(..., bool needWait, ...)が明示的な終了待機をサポートします。Action には、高頻度呼び出し保護、View 切り替え完了、最大 5 秒の継続時間制限が一律で追加されました。- Windows のクラッシュ、アプリの無応答、ネットワークエラーは、RUM のエラー分類とフィールド構造に統一されました。
- プライバシールールは、アプリケーションデータ修飾子の後に一律で適用されます。
0.1.0-alpha.2 (2026/08/09)¶
- 自動トレース伝播、アプリ起動トレース、Logging データレポート機能を追加しました。
- 共有のデスクトップ Sample 設定を追加し、公開 API の統合例を補足しました。
- WPF、WinForms、WinUI 3、Electron Sample 用の実験的な Session Replay 検証機能を追加しました。
- ソリューションレベルの NuGet パッケージング、Native ランタイムアセット、コンシューマー側の検証を強化しました。
- 有界キャッシュ、診断、プライバシー、アップロード設定の API を拡張しました。
0.1.0-alpha.1 (2026/08/09)¶
- 実験的な Guance Windows オブザーバビリティ SDK を初めてリリースしました。
- RUM、分散型トレーシング、ログ、アップロードスケジューリング、有界ファイルキャッシュのマネージド API を追加しました。
- Windows x86、x64、ARM64 の Native ランタイムアセットを提供します。
- WPF、WinForms、WinUI 3、WebView2、Electron との統合をサポートします。
- デフォルトでオフ、必要に応じて有効化できる実験的な Session Replay 機能を追加しました。
Guance.Windows.SessionReplay¶
0.1.0-alpha.11 (2026/10/19)¶
- 同じバージョンの
Guance.Windowsに厳密に依存し、基本 SDK と連携して Replay のエンコード待ちおよび永続化待ちキュー状態を確認します。
0.1.0-alpha.9 (2026/10/07)¶
- マネージド Replay の録画、エンコード、永続化、アップロード実装を担う独立したオプションの NuGet パッケージを初めてリリースしました。同じバージョンの
Guance.Windowsに厳密に依存します。 - 既存の設定、録画制御、プライバシー API は引き続き基本 SDK を通じて使用します。インストールしても Replay は自動的に有効にならず、設定と録画を明示的に有効にする必要があります。Replay は引き続き実験的な機能です。
- 基本 SDK のセッション関連付け、サンプリング、プライバシー設定を踏襲します。コンポーネントが利用できない場合は、基本 SDK が診断情報を出力し、通常の RUM、Log、Trace を継続します。
- このパッケージには Native Replay DLL は含まれません。C/C++ と Electron は、以下の Native/vcpkg バージョンが提供するオプションランタイムを使用します。
Guance.Windows.SessionReplay のソースコード更新履歴を表示
Guance.Windows.Native¶
0.1.0-alpha.11 (2026/10/19)¶
0.1.0-alpha.10で Replay コンポーネントを分割した後、Electron Bridge が転送する Browser Session Replay のフルスナップショットと増分レコードが拒否され、Replay セグメントをアップロードできなかった問題を修正しました。セッション識別子は引き続き Native Core が一元管理します。- Replay を使用する Electron Full Mode のアップグレード時は、同じバージョン、同じアーキテクチャの基本 Native ランタイムと Replay 補完コンポーネントを同時に更新する必要があります。Mixed Mode では、ホストの
guance-windows-native[replay]依存関係を更新する必要があります。Replay の修正自体に npm Adapter JavaScript や NuGet のマネージド Replay 実装の変更は不要です。 - npm Adapter
0.1.0-alpha.6と連携してsdk_pkg_infoを追加しました。ホストの RUM / Log はelectronを記録し、Browser RUM / Log はバージョンが利用可能な場合に追加でwebを記録します。Full Mode と Mixed Mode のルールは同じです。
0.1.0-alpha.10 (2026/10/07)¶
基本 Native SDK¶
- 基本 DLL から Replay 実装を削除し、既存の C 設定・制御インターフェースを維持します。RUM、Log、Trace のみを使用する場合は、基本 port をインストールするだけで十分です。
guance_rum_is_session_replay_available()を追加しました。コンポーネントの欠落または読み込み失敗時は Replay を無効にして診断し、通常の RUM、Log、Trace は引き続き動作します。
Session Replay Feature¶
- 同じ port の
replayFeature は、独立した Replay DLL をインストールします。基本 DLL は必要に応じて同じディレクトリ内のコンポーネントを読み込み、モジュールの ABI と SDK バージョンを検証します。 - Replay DLL は基本 DLL と同じバージョンとアーキテクチャを維持する必要があります。既存の Replay アプリケーションをアップグレードする場合は、この Feature を追加で選択する必要があります。インストール後も Replay を明示的に有効にする必要があります。
Electron Windows ランタイム¶
- 本バージョンでは、x64、x86、ARM64 向けに基本ランタイムと Replay 補完アーカイブをそれぞれ提供します。合計 6 つのアーカイブと対応する検証ファイルがあります。
- Full Mode と Mixed Mode の Bridge はどちらも、設定と実際のコンポーネントの利用可能性に基づいて Replay 能力を宣言します。コンポーネントが欠落している場合は
recordsを宣言しません。Mixed Mode の Replay コンポーネントは、ホストのreplayFeature によって提供されます。
0.1.0-alpha.7 (2026/08/15)¶
- Native RUM と Log Intake リクエストの Deflate 形式を修正し、
Content-Encoding: deflateに準拠する zlib ラッピングを使用するように変更しました。
0.1.0-alpha.6 (2026/08/13)¶
- Native RUM と Log Intake リクエストはデフォルトで Deflate 圧縮を使用し、
compress_intake_requestsスイッチとflush_interval_msの定期的な Flush 設定を追加しました。 - RUM アプリケーション ID ごとに分離された永続的な匿名ユーザー識別子を追加しました。プロセス再起動後も保持され、Native と Electron のテレメトリで再利用できます。
- Native と Electron の統合は、デフォルトでコールドスタートとホットスタートの Action を自動収集します。
enable_app_launch_trackingまたはenableAppLaunchで無効にできます。 - Session Replay は、関連付けられた View ID を欠いたセグメントをアップロードしなくなりました。
0.1.0-alpha.5 (2026/08/12)¶
- オプションの
electron-adaptervcpkg Feature を追加し、ハイブリッドモードアプリ向けに SDK が提供する Electron Main Process と Preload の公開エントリポイントをインストールできるようにしました。 - プロセス内 Electron Bridge Server C API を追加し、Browser のテレメトリデータをアプリが保持する Native SDK Handle に書き込めるようにしました。
- Electron Adapter のフルモードとハイブリッドモードに、Browser Log と実験的な Browser Session Replay の転送を追加しました。
electron-bridgevcpkg Feature は、Electron Adapter、Bridge EXE、対応する Native ランタイムを同時にインストールするようになりました。- Electron Session Replay の有効状態とプライバシーレベルは、Native Bridge の能力に統一されます。Native Replay がオフの場合は
records能力を宣言せず、Replay 入力を拒否します。
0.1.0-alpha.4 (2026/08/12)¶
guance_rum_start_action_ext(..., int need_wait)を追加し、明示的な終了が必要な Native RUM Action を作成できるようにしました。- Native Action には、高頻度呼び出し保護、View 切り替え完了、最大 5 秒の継続時間制限が一律で追加されました。
- Native のクラッシュとアプリの無応答イベントは、RUM のエラー分類とフィールド構造に統一されました。
guance_sdk_get_version()を追加し、Native ランタイムにコンパイルされたリリースバージョンを読み取れるようにしました。RUM、Log、Session Replay データはsdk_versionを通じてこのバージョンをレポートします。guance_sdk_write_electron_bridge_line(...)を追加し、検証済みの Browser RUM、起動、エラー、Log、Replay Bridge メッセージをアプリが保持する SDK Handle に書き込めるようにしました。guance_rum_add_launch_action_ext(...)を追加し、起動 Action を既存の Browser View に関連付けられるようにしました。- Electron Bridge のセッション識別子は Native Core が一元管理し、Browser 側からのセッション上書きは受け付けなくなりました。
- Electron のコールドスタート Action は、限定された時間内で最初のメイン Browser View を待機して関連付けます。View が表示されない場合は、タイムアウトによるフォールバック処理が行われます。
0.1.0-alpha.3 (2026/08/11)¶
guance_configure_data_modifiers(...)を追加し、キャッシュ前に Native RUM と Log データのタグとフィールドを変更できるようにしました。- オプションの HTTP リクエストとレスポンスヘッダー収集を追加し、機密ヘッダーのマスキングを設定できるようにしました。
- オプションの
electron-bridgevcpkg Feature を追加し、guance_windows_electron_bridge.exeとその Native ランタイム依存関係をインストールできるようにしました。 - URL と HTTP Header のプライバシールールは、アプリケーションデータ修飾子の後に一律で適用されます。
- Native Resource 完了イベントがリクエストとレスポンスのヘッダーを保持できるようになり、SDK 内でプライバシーフィルタリングが実行されます。
0.1.0-alpha.2 (2026/08/09)¶
- Native Crash と UI Hang のモニタリングを追加し、次回起動時にレポートを復元できるようにしました。
- WinHTTP Trace の自動伝播と Resource の自動収集機能を追加しました。
- Native Console 統合 Sample を追加し、公開 C/C++ SDK ヘッダーファイルを拡張しました。
- Native のパッケージング、CMake、Release Tag、vcpkg レジストリの検証を強化しました。
- Electron Native Bridge と実験的な Session Replay の診断機能を拡張しました。
0.1.0-alpha.1 (2026/08/07)¶
- 実験的な Windows x64 動的ライブラリを初めてリリースしました。
- RUM、分散型トレーシング、ログ、Native モニタリング、診断のための安定した C ABI インターフェースを提供します。
- インストール可能な
GuanceWindowsNativeCMake パッケージとGuance::WindowsNativeTarget を提供します。 - デフォルトの SQLite に依存しない有界ファイルキューを提供します。
- デフォルトでオフ、必要に応じて有効化できる実験的な Session Replay 機能を追加しました。
Guance.Windows.Native のソースコード更新履歴を表示
Electron Native Adapter¶
0.1.0-alpha.6 (2026/10/19)¶
- Windows の Full Mode と Mixed Mode は、
sdk_pkg_info.electron用に npm Adapter バージョンを Native Core に自動的に提供します。Browser RUM と Browser Log は、web用にページの SDK バージョンを保持します。 - Windows x64、x86、ARM64 のデフォルト Native Runtime が
vcpkg_0.1.0-alpha.11に更新されました。オプションの Replay 補完コンポーネントは同じバージョン、同じアーキテクチャを使用します。macOS のデフォルトは引き続き1.6.8-alpha.6です。
0.1.0-alpha.5 (2026/10/07)¶
@cloudcare/electron-native-adapterに Windows Replay 補完コンポーネントのインストールを追加しました。--with-replay、--replay-archive、および対応する postinstall 環境変数をサポートします。- インストーラーは、基本と Replay のマニフェストのバージョン、アーキテクチャ、ソース、ファイルハッシュを検証します。
stageWindowsRuntime()は、インストール済みの Replay DLL とreplay-manifest.jsonを ASAR の外にコピーします。 - 公開済みの npm パッケージの Windows デフォルト SDK は
vcpkg_0.1.0-alpha.8、macOS デフォルト SDK は1.6.8-alpha.6です。0.1.0-alpha.10以降のパッケージ分割バージョンを使用する場合、フルモードでは対応する Native SDK を明示的に選択し、一致する Replay 補完コンポーネントをインストールしてから設定を有効にする必要があります。 - ハイブリッドモードでは C++ ホストが Replay コンポーネントを提供し、Adapter は Bridge の実際の能力に基づいて録画データを転送するかどうかを決定します。コンポーネントが欠落している場合、通常の RUM は引き続き動作します。
Electron Native Adapter のソースコード更新履歴を表示
プレリリースバージョン
alpha、beta バージョンは、安定した互換性の保証対象外です。NuGet プロジェクトは検証済みのパッケージバージョンに固定してください。vcpkg プロジェクトは SDK レジストリのベースラインを固定し、ビルド時の暗黙的なアップグレードを避けてください。