콘텐츠로 이동

릴리스 정보


기본 SDK와 SessionReplay는 동일한 NuGet 버전으로 배포되며, 각각 변경 사항이 기록됩니다. Native/vcpkg와 Electron Adapter는 각각 자체 버전 번호를 사용하며, Native의 선택적 Replay 기능은 동일한 port 버전으로 제공됩니다.

Guance.Windows

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

  1. WebView2의 Browser RUM에 sdk_pkg_info가 추가되어 web을 통해 페이지의 Browser SDK 버전을 기록하며, 호스트 SDK의 식별자는 그대로 유지됩니다.
  2. Browser RUM Bridge가 Replay 설정에 의존하던 문제를 수정했습니다. Replay가 꺼져 있거나 선택 구성 요소가 설치되지 않은 경우에도 Browser RUM을 정상적으로 연결할 수 있습니다.
  3. 문자열 필드의 줄바꿈이 업로드 레코드를 분할하는 문제를 수정하고, SDK 자체 업로드 요청이 Resource로 중복 수집되지 않도록 방지했습니다.
  4. RUM, Log 대기 쓰기 수와 Replay 큐 상태를 확인할 수 있는 GetUploadQueueDiagnosticsSnapshot()이 추가되었습니다.

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

  1. 기본 패키지에서 Replay 구현을 제거하고 기존 구성, 녹화 제어 및 개인정보 보호 API는 유지했습니다. 기존 Replay 사용 앱을 업그레이드할 때는 동일한 버전의 Guance.Windows.SessionReplay를 추가해야 합니다.
  2. 선택 구성 요소의 실제 사용 가능 여부를 확인하는 클라이언트 IsSessionReplayAvailable이 추가되었습니다. 구성 요소가 없거나, 버전이 일치하지 않거나, 로드에 실패하면 진단을 출력하고 일반 RUM, Log, Trace는 계속 작동합니다. WebView2는 구성 요소가 실제로 사용 가능한 경우에만 records 기능을 선언합니다.
  3. 기본 패키지와 SessionReplay는 동일한 버전으로 패키징 및 배포되며, Replay 구성 요소의 기능은 아래 별도 버전 정보에 설명되어 있습니다.

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. 연결된 View ID가 없는 세그먼트가 Session Replay에서 업로드될 수 있던 문제를 수정했습니다.

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

  1. GuanceConfig.DataModifier 및 GuanceConfig.LineDataModifier가 추가되어 캐시 전에 RUM, Log 및 Resource 데이터의 태그와 필드를 수정할 수 있습니다.
  2. RumPrivacyConfig.CaptureHttpHeaders 및 RumPrivacyConfig.RedactedHeaderNames가 추가되어 HTTP 요청·응답 헤더를 필요에 따라 수집하고 민감한 헤더를 마스킹할 수 있습니다.
  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. 실험적인 Guance 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.SessionReplay

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

  1. 동일한 버전의 Guance.Windows에 정확히 의존하며, 기본 SDK와 함께 Replay의 인코딩 대기 및 영속화 대기 큐 상태를 조회할 수 있습니다.

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

  1. 관리형 Replay의 녹화, 인코딩, 영속화 및 업로드 구현을 담당하는 독립적인 선택적 NuGet 패키지가 처음으로 출시되었습니다. 동일한 버전의 Guance.Windows에 정확히 의존합니다.
  2. 기존 구성, 녹화 제어 및 개인정보 보호 API는 계속 기본 SDK를 통해 사용합니다. 패키지를 설치해도 Replay가 자동으로 활성화되지는 않으며, 구성과 녹화를 명시적으로 켜야 합니다. Replay는 실험적 기능으로 유지됩니다.
  3. 기본 SDK의 Session 연결, 샘플링 및 개인정보 보호 구성을 그대로 사용합니다. 구성 요소를 사용할 수 없으면 기본 SDK가 진단을 출력하고 일반 RUM, Log, Trace는 계속 작동합니다.
  4. 이 패키지에는 Native Replay DLL이 포함되지 않습니다. C/C++ 및 Electron에서는 아래 Native/vcpkg 버전이 제공하는 선택적 런타임을 사용합니다.

Guance.Windows.SessionReplay 소스 릴리스 정보 보기

Guance.Windows.Native

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

  1. 0.1.0-alpha.10에서 Replay 구성 요소를 분리한 후 Electron Bridge가 전달하는 Browser Session Replay 전체 스냅샷 및 증분 레코드가 거부되어 Replay 세그먼트를 업로드할 수 없던 문제를 수정했습니다. Session 식별자는 계속 Native Core가 통합 관리합니다.
  2. Replay를 사용하는 Electron Full Mode를 업그레이드할 때는 동일한 버전·아키텍처의 기본 Native 런타임과 Replay 보충 구성 요소를 함께 업데이트해야 합니다. Mixed Mode에서는 호스트의 guance-windows-native[replay] 의존성을 업데이트해야 합니다. Replay 수정 자체에는 npm Adapter JavaScript 또는 NuGet 관리형 Replay 구현의 변경이 필요하지 않습니다.
  3. 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

  1. 기본 DLL에서 Replay 구현을 제거하고 기존 C 구성 및 제어 인터페이스는 유지했습니다. RUM, Log, Trace만 사용하는 경우 기본 port만 설치하면 됩니다.
  2. guance_rum_is_session_replay_available()가 추가되었습니다. 구성 요소가 없거나 로드할 수 없으면 Replay를 비활성화하고 진단을 출력하며, 일반 RUM, Log, Trace는 계속 작동합니다.

Session Replay 기능

  1. 동일한 port의 replay 기능이 독립적인 Replay DLL을 설치합니다. 기본 DLL은 필요에 따라 동일 디렉터리의 구성 요소를 로드하고 모듈 ABI 및 SDK 버전을 검증합니다.
  2. Replay DLL은 기본 DLL과 동일한 버전 및 아키텍처를 유지해야 합니다. 기존 Replay 사용 앱을 업그레이드할 때는 해당 기능을 추가로 선택해야 하며, 설치 후에도 Replay를 명시적으로 활성화해야 합니다.

Electron Windows 런타임

  1. 이 버전에서는 x64, x86, ARM64용 기본 런타임 및 Replay 보충 아카이브가 각각 제공되며, 총 6개의 아카이브와 해당 검증 파일이 포함됩니다.
  2. Full Mode와 Mixed Mode의 Bridge는 모두 구성 및 실제 구성 요소 사용 가능 여부에 따라 Replay 기능을 선언합니다. 구성 요소가 없으면 records를 선언하지 않습니다. Mixed Mode의 Replay 구성 요소는 호스트의 replay 기능이 제공합니다.

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. 하이브리드 모드 애플리케이션을 위해 SDK가 제공하는 Electron Main Process 및 Preload 공용 진입점을 설치하는 선택적 electron-adapter vcpkg 기능이 추가되었습니다.
  2. 프로세스 내 Electron Bridge Server C API가 추가되어 Browser 텔레메트리 데이터를 애플리케이션이 보유한 Native SDK Handle에 기록할 수 있습니다.
  3. Electron Adapter의 Full Mode 및 Mixed Mode에 Browser Log 및 실험적 Browser Session Replay 전달이 추가되었습니다.
  4. electron-bridge vcpkg 기능이 이제 Electron Adapter, Bridge EXE 및 일치하는 Native 런타임을 함께 설치합니다.
  5. Electron Session Replay의 활성화 상태와 개인정보 보호 수준은 Native Bridge 기능을 기준으로 통일됩니다. Native Replay가 꺼져 있으면 records 기능을 선언하지 않고 Replay 입력을 거부합니다.

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

  1. 명시적으로 종료해야 하는 Native RUM Action을 생성할 수 있는 guance_rum_start_action_ext(..., int need_wait)가 추가되었습니다.
  2. Native Action에 공통적으로 과도한 호출 방지, View 전환 완료 대기 및 최대 5초 지속 시간 제한이 적용됩니다.
  3. Native 크래시 및 애플리케이션 무응답 이벤트가 RUM 오류 분류 및 필드 구조로 통일되었습니다.
  4. Native 런타임에 컴파일된 릴리스 버전을 읽을 수 있는 guance_sdk_get_version()이 추가되었습니다. RUM, Log 및 Session Replay 데이터는 sdk_version을 통해 이 버전을 업로드합니다.
  5. 검증된 Browser RUM, 시작, 오류, Log 및 Replay Bridge 메시지를 애플리케이션이 보유한 SDK Handle에 기록할 수 있는 guance_sdk_write_electron_bridge_line(...)이 추가되었습니다.
  6. 시작 Action을 기존 Browser View에 연결할 수 있는 guance_rum_add_launch_action_ext(...)이 추가되었습니다.
  7. Electron Bridge는 Session 식별자를 Native Core가 통합 관리하며, Browser 측에서 Session을 덮어쓸 수 없습니다.
  8. Electron 콜드 스타트 Action은 제한된 시간 내에 첫 번째 기본 Browser View를 기다렸다가 연결합니다. View가 나타나지 않으면 타임아웃에 따라 폴백 처리됩니다.

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

  1. 캐시 전에 Native RUM 및 Log 데이터의 태그와 필드를 수정할 수 있는 guance_configure_data_modifiers(...)가 추가되었습니다.
  2. 선택적 HTTP 요청·응답 헤더 수집이 추가되었고, 민감한 헤더 마스킹을 구성할 수 있습니다.
  3. guance_windows_electron_bridge.exe 및 해당 Native 런타임 의존성을 설치하는 선택적 electron-bridge vcpkg 기능이 추가되었습니다.
  4. URL 및 HTTP 헤더 개인정보 보호 규칙은 애플리케이션 데이터 수정자 이후에 일괄 적용됩니다.
  5. Native Resource 완료 이벤트가 요청·응답 헤더를 포함할 수 있으며 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 태그 및 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 소스 릴리스 정보 보기

Electron Native Adapter

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

  1. Windows Full Mode와 Mixed Mode가 npm Adapter 버전을 자동으로 Native Core에 제공하여 sdk_pkg_info.electron에 사용합니다. Browser RUM 및 Browser Log는 페이지 SDK 버전을 유지하여 web에 사용합니다.
  2. 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)

  1. @cloudcare/electron-native-adapter에 Windows Replay 보충 구성 요소 설치가 추가되어 --with-replay, --replay-archive 및 해당 postinstall 환경 변수를 지원합니다.
  2. 설치 프로그램이 기본 및 Replay 매니페스트의 버전, 아키텍처, 출처, 파일 해시를 검증합니다. stageWindowsRuntime()은 설치된 Replay DLL과 replay-manifest.json을 ASAR 외부로 함께 복사합니다.
  3. 게시된 npm 패키지의 Windows 기본 SDK는 vcpkg_0.1.0-alpha.8, macOS 기본 SDK는 1.6.8-alpha.6입니다. 0.1.0-alpha.10 및 이후 분리 버전을 사용할 때 Full Mode에서는 해당 Native SDK를 명시적으로 선택하고 일치하는 Replay 보충 구성 요소를 설치한 후 구성을 활성화해야 합니다.
  4. Mixed Mode에서는 C++ 호스트가 Replay 구성 요소를 제공하며, Adapter는 Bridge의 실제 기능에 따라 녹화 데이터 전달 여부를 결정합니다. 구성 요소가 없어도 일반 RUM은 계속 작동합니다.

Electron Native Adapter 소스 릴리스 정보 보기

프리릴리스 버전

alpha, beta 버전은 안정적인 호환성을 보장하지 않습니다. NuGet 프로젝트는 검증된 패키지 버전을 고정하고, vcpkg 프로젝트는 SDK 레지스트리 기준을 고정하여 빌드 시 암시적 업그레이드가 발생하지 않도록 해야 합니다.

문서 평가

이 페이지가 도움이 되었나요?