Migration guides

Use these guides to update a project from an earlier version of Kanzi Monitor to Kanzi Monitor 1.9.2. Follow the section for the version you are coming from. All 1.9.x releases target the Kanzi 3.9 generation (3.9.4 through 3.9.15), so no Kanzi engine migration is involved.

Migrating from Kanzi Monitor 1.9.1 to 1.9.2

  • Windows / Visual Studio. The Windows package now bundles prebuilt Visual Studio 2019 (vs2019) support libraries only. Migration effort is required only for Windows integrations built with Visual Studio 2015/2017: either integrate with Visual Studio 2019 or newer (prebuilt libraries are included), or build the vs2017 libraries from the bundled source — run scripts\build_plugin.bat vs2017 <Debug|Release|Profiling> (Kanzi 3.9 ships the vs2017 SDK) and re-run CMake. Other platforms, and the console/tool workflows, are unaffected (KZMON-431).

  • Trace timestamps. Profiling trace files now use session-relative timestamps (the first event starts at 0) instead of absolute engine-clock values. The Perfetto trace viewer and the bundled tools treat the ts field as relative, so no action is needed. If you have a custom tool that reads Kanzi Monitor trace files and relies on ts being an absolute (since-boot or since-epoch) value, update it to treat ts as relative to the start of the capture. Trace ts and dur are also now emitted as fractional microseconds rather than integers, so a custom parser that assumes integer values should be updated to accept decimals (KZMON-265, KZMON-411).

  • Trace configuration key. The frame-duration trace-trigger key was corrected from the misspelled WritingOnFrameDurationTreshold to WritingOnFrameDurationThreshold. No action is required — the old spelling remains accepted as a deprecated alias — but update your kanzimonitor.cfg to the corrected key when convenient (KZMON-453).

  • Image orientation. Screenshot, framebuffer, texture, and render-pass previews are now flipped vertically by default so they match screen orientation (GPU readback is bottom-up). If you relied on the previous raw (bottom-up) output — for example a script that post-processes MCP PNGs — account for the new orientation, or in the Web UI uncheck Flip vertical (KZMON-448).

  • Android debug symbols (source builds). When you build the Android plugin from source, debug builds now minimize debugging information by default (-g1, line tables only), producing smaller .so files. No action is needed unless you debug native crashes with full symbols — pass -PminimizeDebug=false to the Gradle build to restore them. Prebuilt binaries in the delivered packages are unaffected (KZMON-452).

Migrating from Kanzi Monitor 1.9.0 to 1.9.2

Migrating from 1.9.0 is a superset of the 1.9.1 → 1.9.2 path: the 1.9.0 → 1.9.1 step required no project changes — the expanded Kanzi version support (3.9.4 through 3.9.15, extending the minimum from 3.9.8) is automatic — so apply all of the “Migrating from Kanzi Monitor 1.9.1 to 1.9.2” steps above.

See also

Release notes

Known issues